BASMéxico BPMManual Basico

Business
Process
Management
Bsico
Epicor 905.702a
Business Process Management Manual
Epicor 905.702a
CONTENIDO
Business process management (BPM) ............................................................................................................... 2

Elementos base de un BPM ............................................................................................................................ 2
BPM Setup ...................................................................................................................................................... 3
Instalacion de Servidor BPM....................................................................................................................... 3
Microsoft Message Queuing ...................................................................................................................... 3
Mantenimiento de Usuarios ....................................................................................................................... 3
Retenciones .................................................................................................................................................... 4
Mantenimiento de tipos de Retencion (Hold Type Maintenance) ............................................................. 5
Retenciones BPM ....................................................................................................................................... 6
Directivas ...................................................................................................................................................... 10
Directivas de metodos .............................................................................................................................. 10
Directivas de datos ....................................................................................................................................... 12
Directivas de los Metodos para los baq actualizables .................................................................................. 12
Creando una nueva directiva ........................................................................................................................ 13
Localizando el objeto de una directiva ..................................................................................................... 13
Creando la directiva .................................................................................................................................. 16
Condiciones .................................................................................................................................................. 18
Acciones........................................................................................................................................................ 23
Condiciones y acciones la lista completa ............................................................................................... 27
Suportando MANEJO DE multiples registros actualizados de forma combinada..................................... 50
Directiva de compatibilidad ...................................................................................................................... 51
Directivas Dependientes........................................................................................................................... 52
Caso de Estudio ............................................................................................................................................ 54
Caso 1: Hacer un campo requerido .................................................................................................... 54
Validando un campo desde otra tabla...................................................................................................... 62
Crear y usar un tipo de retencin ............................................................................................................. 71
Asignar datos Default para los registros de un baq actualizable.................................................................. 94
Publicando datos en un dashboard .......................................................................................................... 94
Obtener los Mtodos del BAQ Actualizable ............................................................................................. 96
Nueva directiva Post-Processing .............................................................................................................. 98
Probando la directiva ............................................................................................................................. 102
P g i n a 1 | 104
Epicor 905.702a
BUSINESS PROCESS MANAGEMENT (BPM)
El mdulo de BPM (Business Process Managment) es un conjunto de herramientas que se utilizan para
modificar y ampliar la funcionalidad de la aplicacin sin tocar el cdigo fuente. La parte central de un BPM es
la directiva. Una directiva es un conjunto de condiciones y acciones que pueden ser aplicadas a una
transaccin. Existen tres tipos de directivas disponibles:
Directivas del Mtodo (Method Directives) aplicada a los mtodos de los objetos de negocio.
Directivas de Datos (Data Directives) aplicada a las transacciones de las tablas en la base de datos.
Directivas de las Consultas Actualizables (Updatables BAQ Directives) aplicada a los mtodos que
permiten la actualizacin de las consultas de la actividad del negocio.
Utilizar las herramientas BPM para agregar o cambiar los procesos de la aplicacin cuando se ejecuta un
mtodo de los objetos del negocio, cuando una transaccin se aplica a una tabla o cuando la informacin es
recuperada o procesada a travs de una consulta de la actividad del negocio (Business Activity Query BAQ).
Se pueden crear directivas que primero se evalen antes de que los datos se procesen, si se cumplen las
condiciones, se llevan a cabo una o ms acciones.
Este documento primero explora los elementos base de un BPM y explica el proceso de configuracin del
mdulo BPM, en la segunda mitad se describen todas las herramientas con detalle incluyendo las
condiciones y acciones disponibles para las directivas. El documento concluye con una serie de casos de
estudio podemos utilizar este documento como una gua para desarrollar nuestros propios BPMs.
Adicionalmente explicamos la customizacin de los BPMs y sus utileras.
ELEMENTOS BASE DE UN BPM
A continuacin, se explican los elementos base:
Directivas de Mtodos (Method Directives) - las directivas de los mtodos inician acciones basadas
en BPMs y se aplican en determinadas llamadas dentro de los objetos de negocio. Un objeto de
negocio contiene el cdigo que corre en un proceso de negocio. Las acciones BPM pueden ser
condicionadas antes, despus o durante la ejecucin de un mtodo regular que corre dentro de un
proceso de negocio.
Directivas de Datos (Data Directives) inician acciones de un BPM basadas en actualizaciones o
inserciones de una tabla especfica. Una directiva puede ser ejecutada durante una transaccin de
datos, la cual puede afectar la informacin ingresada en la base de datos, o esta puede ejecutarse
posterior a que la transaccin sea ingresada a la tabla.
Directivas de los BAQ Actualizables (Updatable BAQ Directives) inician acciones de los BPMs
basadas en los mtodos que se llaman al actualizar un BAQ. Un BAQ actualizables es una consulta
customizada que se despliega en el cliente para actualizar informacin de tablas de Epicor; se
consideran procesos de negocio porque se ejecutan al momento de actualizar un BAQ. Estas pueden
ejecutarse antes, despus o durante la actualizacin de un BAQ.
P g i n a 2 | 104
Epicor 905.702a
Retenciones (Hold) se utilizan los BPMs de retencin que definen un evento de retencin externa
ligado a un proceso de negocio el cual se activa a travs de una accin del BPM. Las directivas del
BPM pueden ser creadas desde otro objeto del negocio y los mtodos pueden evaluar si existen
retenciones y ello puede modificar los procesos de negocio como se necesiten. Las retenciones de
BPM aumentan las retenciones estndar que se generan dentro de la aplicacin. Se pueden definir y
evaluar con condiciones propias dentro de los procesos de flujo de negocio.
Diseador de Formas de Datos (Data Form Designer) utilizar el diseador de formas de datos para
crear pantallas que se activen de forma automtica a travs de las directivas de procesos. Las
pantallas de captura de datos de un BPM o acciones que se detonan a travs de un botn existen se
pueden usar para controlar el flujo del proceso de BPM. La funcionalidad puede ser usada para cargar
una pantalla por ejemplo, nicamente para especificar un cliente para capturar datos especficos
que se requieren en una transaccin.
BPM SETUP
Esta seccin explica que se necesita para instalar y configurar BPM.
INSTALACION DE SERVIDOR BPM

Un servidor BPM es un componente opcional utilizado para soportar Acciones .NET (C# u otro cdigo) y
realizar depuraciones avanzadas de cdigo o registro de la aplicacin. No es necesario tener instalado un
servidor BPM para utilizar la funcionalidad BPM, se utilizar este componente para acceder a la herramienta
completa de BPM.
El Servidor BPM es compatible con Windows Server 2008 y Windows Server 2008 R2.
MICROSOFT MESSAGE QUEUING

El servidor Microsoft debe tener Microsoft Message Queuing (MSMQ) instalado. Este es requerido para que
los mensajes BPM puedan ser colocados en fila y entonces se puedan distribuir en la aplicacin.
Para conocer como instalar el Servidor BPM y el MSMQ, revisa la Gua de Instalacin de Epicor.
MANTENIMIENTO DE USUARIOS
Existen niveles de funcionalidad de BPM disponibles un nivel bsico y un nivel avanzado. Todos los usuarios
tienen acceso a BPM y pueden usar el nivel bsico de BPM para crear retenciones y directivas que contengan
acciones pre-construidas. Los usuarios con nivel avanzado pueden crear acciones customizadas (desarrolladas
por ellos). Estos usuarios pueden crear directivas de mtodos y ejecutarlas desde los mtodos base, estos
usuarios pueden trabajar con Epicor o cualquier partner antes de modificar procesos base.
Se pueden dar accesos especficos para la funcionalidad avanzada a travs del mantenimiento a usuarios. Esos
accesos son asignados en la pestaa de seguridad.
P g i n a 3 | 104
Epicor 905.702a
Ruta de Acceso desde el men principal: System Management -> Company Maintenance -> User
Para dar a un usuario especfico los accesos al nivel avanzado de BPM:
1. Seleccionar un usuario especifico en la pestaa Detail.

2. Clic en la pestaa de Options.
3. En la seccin Tools Options, seleccione la opcin BPM Advanced User.
4. Dar clic en Save de la barra de herramientas Estndar.
Este usuario puede utilizar ahora las funciones avanzadas del BPM.
4
1
2
RETENCIONES
Una retencin es una bandera activada en un registro; esto indica que el registro podra no ser procesado
hasta que se revise y se apruebe. Una retencin por s misma no desarrolla cualquier accin. Para definir las
acciones se deben crear directivas las cuales se definirn a travs de manejador de registros que tiene que se
colocadas en retencin. Una retencin se puede ligar a un registro de dos maneras:
Manualmente: se puede manualmente ligar una retencin dentro de un campo que utiliza el
programa BPM de retencin. Se puede invocar el programa BPM de retencin desde el men de
contexto. Este agrega un registro de retencin. Para utilizar esta funcionalidad, primero se debe
P g i n a 4 | 104
Epicor 905.702a
haber definido una retencin desde el Mantenimiento de Tipo de Retencin (Hold Type
Maintenance); este programa ser explorado ms adelante.
Automticamente: una retencin tambin puede ser aplicada a un registro utilizando una
directiva de accin. Esta retencin puede ser activada antes, durante o despus del proceso de
negocio. Normalmente se utiliza la retencin para interrumpir un proceso de los objetos de negocio.
Esta retencin puede entonces ser la causa de que se detonen acciones customizadas que se
definieron en el proceso. Se pueden programar desde el Mantenimiento de las Directivas de Mtodo
o Mantenimiento de las Directivas de Datos. Esto se explicar con mayor detalle ms adelante.
MANTENIMIENTO DE TIPOS DE RETENCION (HOLD TYPE MAINTENANCE)
Utilizar el mantenimiento de los tipos de retencin para crear, mantener y borrar los tipos de retencin. Utiliza
este programa para definir todas las retenciones que se pueden utilizar dentro de la aplicacin. Despus de
que se haya realizado la configuracin de las retenciones que se necesitan en este programa, se pueden
activan desde esta misma pantalla o a travs de las acciones en las directivas.
Un tipo de retencin es bsicamente un estado a asignar a un registro, esto no previene que el registro
sea procesado. Para que los tipos de retencin actualmente sirvan para prevenir que los registros sean
procesados, se necesita crear una directiva de mtodo. En la seccin de casos de estudio se explica cmo
se implementar esta funcionalidad
Tambin se puede utilizar este programa para revisar donde se encuentran las retenciones utilizadas, as como
el registro histrico de cada tipo de retencin.
CMO USAR EL MANTENIMIENTO DE TIPO DE RETENCIN?
En la ruta del Men Principal: System Management -> Business Process Management -> Setup -> Hold
Type
Para crear un Nuevo tipo de retencin:
1. Clic en el botn New en la barra de herramientas Estndar.

2. Ingresa el Hold Type para la retencin. Este valor es un nombre corto que nos permita identificar a
travs de los objetos de negocio el tipo de retencin. En este ejemplo: Sales Order es ingresado como
el nombre del tipo de retencin.
3. Clic en el botn Business Object para encontrar y seleccionar el objeto de negocio en el cual se desea
agregar la retencin. En este ejemplo: se selecciona el objeto de negocio Sales Order.
4. Ingresar una Description para la retencin que nos permita identificar su funcionalidad. Es un valor
opcional, utilizado para este campo para agregar ms detalles que nos ayuden a identificar la
retencin.
P g i n a 5 | 104
Epicor 905.702a
5. El campo History Length define cuantos registros debern aparecer en la pestaa Hold Usage History.
Cuando el registro alcanza este nmero, los viejos registros son automticamente borrados.
6. Clic en el botn Save. Para guardar este tipo de retencin y est disponible para utilizarse.
7. La pestaa Hold Usage despliega las retenciones actuales de los registros que han sido seleccionados
en registros especficos; utiliza esta pestaa para administrar los registros que actualmente estn
retenidos. Si se requiere, se puede seleccionar un registro en el clic y utilizar el botn de borrado
para eliminar la retencin de un registro.
8. La pestaa de Hold Usage History despliega los registros de cada momento en que una retencin se
ha utilizado cuando fue agregado un registro, quien lo agrego, cuando se elimin la retencin y
todo lo relacionado. El nmero mximo de registros que pueden aparecer en la pestaa de Hold
Usage History esta pestaa est definida por el valor de largo de la historia del tipo de retencin.
6 8
7
4 5
RETENCIONES BPM
Utilizar el programa de Retenciones BPM para ligar automticamente una directiva de retencin a un registro.
Tambin podemos eliminar una retencin que se gener anteriormente.
CMO UTILIZAR LAS RETENCIONES BPM?
P g i n a 6 | 104
Epicor 905.702a
Para colocar una orden de venta en retencin:
1. Navega a Ingreso de Ordenes de Venta. En Men Principal: Order Management -> Sales
Management -> General Operations -> Sales Order Entry
2. Clic en el botn de Sales Order para encontrar y seleccionar la orden de venta que se quiere retener.
3. Selecciona BPM Holds.
No todos los mens de contexto tienen retenciones BPM. El campo debe ser un valor principal
para el objeto de negocio. En este ejemplo, el campo Sales Order es el principal campo utilizado
por el proceso de negocio, para ello la retencin se puede colocar en este campo.
1
3
4. El programa de BPM Holds despliega, en la Vista de rbol, selecciona el tipo de retencin que se
desea utilizar. En este ejemplo se selecciona la retencin Sales Order.
5. Clic New en la barra de herramientas estndar.
6. La retencin ha sido creada para este registro, los diferentes campos se llenarn de forma
automtica. El campo Business Object despliega el nombre del objeto de negocio utilizado para esta
retencin. En este ejemplo, despliega el objeto SalesOrder.
7. El Tipo de Retencin despliega la retencin que habamos creado en el mantenimiento de Tipo de
Retencin. En este ejemplo, el registro despliega Sales Order.
P g i n a 7 | 104
Epicor 905.702a
13
5
7
4
8
10
11
12
8. El campo Description despliega una explicacin opcional del tipo de retencin.

9. El campo Creation date despliega la fecha en la que se anexo la retencin al registro.
10. El campo Creation time despliega el tiempo en el cual se cre la retencin.
11. El campo Creation by despliega el usuario que gener la retencin.
12. El campo Comment nos permite ingresar informacin adicional de porque generamos la retencin.
Es el nico campo que permite edicin dentro de la pantalla y es porque es la razn por la cual se
genera la retencin.
13. Al finalizar se graba el registro. Save
REVISANDO LAS RETENCIONES BPM
Se pueden revisar todos los registros para los cuales se ha generado una retencin. Colocar una retencin en
un registro no evita que este pueda ser procesado. La retencin realmente es una nota agregada al registro.
Est nos permite dar seguimiento a los diferentes registros que tienen un tipo de retencin. Se puede ingresar
a los registros para hacer los cambios necesarios.
Actualmente se utilizan los tipos de retencin en registros especficos que han sido procesados, se necesita
crear una directiva que haga esto. En la seccin Casos de Estudio explicaremos como se realizar esta
funcionalidad.
P g i n a 8 | 104
Epicor 905.702a
Para revisar una retencin BPM:
1. Navegar a Hold Type Maintenance. En el Men Principal: System Management -> Business Process
Management -> Setup -> Hold Type.
2. Utilizar la pestaa detalle para encontrar y seleccionar el tipo de retencin. En este ejemplo,
seleccionamos el tipo de retencin Sales Order.
3. Clic en la pestaa Hold Usage.
4. En el grid Hold Type Usage despliega todos los registros en los cuales el tipo de retencin esta
actualmente activo.
Utilizar esta informacin para hacer los cambios que se necesiten realizar. En esta seccin se puede realizar
cualquier cambio manualmente en cada registro listado en el grid.
P g i n a 9 | 104
Epicor 905.702a
DIRECTIVAS
Una directiva se define como un conjunto de condiciones y acciones asociadas con una transaccin de datos.
Las directivas se detonan desde el mtodo de un objeto de negocio, un mtodo usado por BAQ actualizable o
por cambios en los datos de una tabla en la base de datos.
DIRECTIVAS DE METODOS
Todas las transacciones de datos en la aplicacin son controladas por los objetos de negocio. Un objeto de
negocio representa un tipo de datos administrado por la aplicacin, puede ser: clientes, partes o rdenes de
venta. Los objetos contienen mtodos que desarrollan una tarea especfica. Por ejemplo: el mtodo
Customer.Update valida y procesa los registros de clientes en la base de datos.
Las herramientas BPM pueden manipular los diversos mtodos antes, durante y despus de las transacciones
en la base de datos. Se pueden crear directivas de mtodos que primero evalen los datos que se han de
procesar y entonces las condiciones de las directivas generen una o ms acciones basadas en estos datos
como pueden ser mensajes desplegados, validacin de datos ingresados, invocacin de otros procesos de
negocio, entre otros.
Las directivas de mtodos BPM trabajan interceptando comunicaciones entre el cliente o los servicios WEB y
el servidor lgico de aplicaciones. Se pueden validar, manipular o crear flujos de trabajo basados en los datos
pasados a travs de la aplicacin. Porque ellos estn en la parte de la customizacin la cual puede cambiar la
lgica del negocio sin modificar el cdigo fuente original. Por esta razn, las actualizaciones al cdigo original
podran no afectar las directivas existentes de BPM.
Cuando un mtodo de objeto de negocios es llamado, todas las directivas asociadas con el mtodo activo. Si
las condiciones dentro de la directiva se cumplen, las acciones contenidas se ejecutan.
Mientras el mtodo este activo, esas directivas se pueden ejecutar en tres puntos diferentes:
Pre-Processing: estas directivas se ejecutan antes de que el mtodo base sea generado. Despus
que estas acciones terminan, los objetos de negocio ejecutan el mtodo base.
Base Processing: estas directivas se ejecutan en lugar del proceso base. El proceso base no se ejecuta.
Post-Processing: estas directivas se ejecutan despus de que el mtodo base termina.
Unicamente los usuarios avanzados de BPM pueden crear directivas Base Processing, el usuario debe estar
definida como BPM Advanced User. De cualquier manera, Epicor recomienda que no se generen directivas
de este tipo. Ya que si se realiza un cambio a las directivas Base de manera incorrecta se pueden generar
errores crticos en la aplicacin. Se recomienda trabajar con un consultor de Epicor este tipo de directivas.
P g i n a 10 | 104
Epicor 905.702a
Por ejemplo, se puede crear una directiva de mtodo para el mtodo CUSTOMER.UPDATE que envi un mail
al Gerente de Ventas cuando el lmite de crdito del cliente es cambiado. Esta misma directiva puede ser
tambin anexada a una retencin del cliente y desplegar un mensaje que indique que el registro del cliente
ha sido colocado en retencin. Ambas acciones son generadas durante el proceso posterior, al proceso base.
En la siguiente grfica presentamos como trabajan las directivas de los mtodos dentro de la aplicacin:
1. Un usuario detona una accin en el programa.

2. El programa llama un mtodo del objeto de negocio que detona la accin.
3. Antes que el objeto de negocio ejecute este cdigo del programa ABL, se debe ejecutar una directiva
Pre-Processing.
4. Despus que la directiva Pre-Processing, el programa ABL genera esta funcin. Si la directiva del
proceso base tiene efecto, la directiva del Proceso base podr corre con base en el cdigo del
programa ABL.
5. Despus el cdigo del programa ABL se ejecuta, una directiva Post-Processing puede ejecutarse.
6. Los regresos de los datos son regresados desde el programa en base a las acciones que se ejecutan
por las directivas y el programa ABL.
Se puede crear una directiva de mtodo dentro del Mantenimiento de las Directivas de Mtodos.
Ruta del Men Principal: System Management -> Business Process Management -> Setup -> Method
Directives.
P g i n a 11 | 104
Epicor 905.702a
DIRECTIVAS DE DATOS
Una directiva de datos es similar a una directiva de mtodo, donde la diferencia radica en que una directiva
de mtodo se detona desde un mtodo de objeto de negocio y una directiva de datos es ligada a una tabla en
la base de datos y es detonada por un evento en la base de datos, como puede ser: agregar, borrar o actualizar
informacin. Al momento de aplicar una directiva a una tabla especfica, estas son usadas para controlar los
datos que puedan afectar mltiples objetos de negocio.
Se pueden aplicar tanto condiciones y acciones a las directivas de mtodos como a las directivas de datos,
excepto en los casos en donde la condicin o accin depende de la informacin disponible en el objeto de
negocio que no est activo dentro de la misma. Dos tipos de directivas de datos estn disponibles:
In-Transaction: afecta a los datos mientras son salvados en la base de datos. Este tipo de directiva
puede nica procesar un registro a la vez; no puede procesar mltiples registros los registros que
contienen los datos no se han salvado en la base de datos. La afectacin a mltiples registros ser
explicada ms adelante.
Standard: esta no afecta datos en la base de datos. Esta directiva se ejecuta despus de que
una transaccin es grabada en la base de datos. Este tipo de directiva procesa mltiples registros.
Esta directiva se ejecuta despus de los mtodos base y las directivas de mtodos.
Se puede crear una directiva de datos dentro del Mantenimiento de las Directivas de Datos.
Ruta del Men Principal: System Management -> Business Process Management -> Setup -> Data
Directives
DIRECTIVAS DE LOS METODOS PARA LOS BAQ ACTUALIZABLES
Las directivas de los mtodos para los BAQ Actualizables son similares a las directivas de mtodos descritas
anteriormente, excepto que estos mtodos se aplican especficamente a los BAQ actualizables, consultas
customizadas para crear un ingreso de datos. Cada BAQ Actualizable tiene los siguientes mtodos:
GetList recupera los datos especficos en la consulta.

GetNew crea un nuevo registro para ser ingresado y registrado en la base de datos.
RunCustomAction ejecuta una accin BPM customizada la cual se define tanto a travs del BAQ y
la funcionalidad BPM. Primero se define el ID de la accin customizada en el programa de diseo de
los BAQ y entonces se define la accin que se utilizar en una o ms directivas dentro del programa
de directivas para un BAQ Actualizable.
Update al generarse actualizaciones en la base de datos, actualizar los datos incluye los cambios
en los registros y el agregar registros.
Las mismas seguridades para las directivas de los mtodos son aplicables a las directivas de los BAQ
actualizables. Se debe primero tener atributos de un BPM Advanced User para crear o modifcar
directivas de procesos base
P g i n a 12 | 104
Epicor 905.702a
Cuando se crea un BAQ actualizable, la aplicacin escribe una directiva de proceso base para el mtodo
de actualizacin. Esta directiva utiliza cdigo ABL para actualizar la base de datos en base a las
configuraciones definidas en el diseador de BAQ. Se puede editar este cdigo para customizar el proceso
de actualizacin o se pueden agregar directivas: pre-processing, base processing y post-processing a los
mtodos asociados con el BAQ.
SE pueden desarrollar Directivas de Mtodos para BAQ Actualizables en dos formas: clic en el botn de
Define Custom Actions de Actualizar > en la pestaa de propiedades generales dentro del programa de
diseo de BAQ o a travs del men principal.
Men Principal: System Managment -> Business Process Management -> Setup -> Updatable BAQ
Directives
ACCIONES CUSTOMIZADAS
Para crear acciones customizadas en los BAQ actualizables debemos ingresar al programa de Diseo de los
BAQ para definir el cdigo de accin (ID ACTION) y las etiquetas. Las acciones customizadas pueden ser
agregadas al men de acciones de un dashboard que utiliza este BAQ.
En las directivas de mtodo de los BAQ Actualizables, se pueden crear directivas: pre-processing, base
processing o post-processing para ejecutar el mtodo RunCustomAction. Utiliza la sentencia: the specified
argument is equal to the specified expression para identificar cual accin se va a ejecutar. La primera variable
specified puede ser considerada como actionID, el segundo specified puede ser empleado para la action
llamada por el usuario y que fue especificada en el BAQ. Esto nos permite crear directivas de accin que
permiten desarrollar las acciones customizadas.
CREANDO UNA NUEVA DIRECTIVA
Este ejemplo presenta como se crea una directiva de mtodo, pero el proceso es el mismo para todos los tipos
de directivas. En la seccin de casos de estudio veremos la creacin de ms directivas.
LOCALIZANDO EL OBJETO DE UNA DIRECTIVA
Las directivas son creadas para mtodos de objetos de negocio, tablas o mtodos de BAQ actualizables, el
primer paso es localizar el objeto en la directiva en la cual vamos a trabajar. Para localizar el objeto:
1. Navega a el programa Method Directives. Ruta en el Men Principal: System Management >
Business Process Management > Setup > Method Directives.
2. Clic en el botn Method Code. Para crear una directiva de datos clic en el botn Table o ingresar el
nombre de la tabla. Para crear una directiva de mtodo para un BAQ actualizable, dar clic en el botn
BAQ ID o ingresar el BAQ ID.
P g i n a 13 | 104
Epicor 905.702a
3. El programa Method Search se despliega. Utiliza este programa para localizar un mtodo especfico
dentro de un objeto de negocio. Por ejemplo: si se desea crear una directiva de mtodo para
CurrExRate.Update. Debemos, en el campo Starting At, ingresar U
4. Seleciconar la opcin Search by Business Object. Este indica que la bsqueda se realizar sobre un
objeto especfico.
5. Ahora selecciona el Business Object para el que se requiere hacer la bsqueda. En este ejemplo, se
seleccionar el objeto de negocio CurrExRate.
6. Identifica que tambin se puede seleccionar Search by Directives. Esta opcin es utilizada para
encontrar y seleccionar directivas de mtodo existentes.
7. Cuando se selecicona la opcin Search by Directives, el listado de Directive Group se activa. Se
pueden asignar directivas a grupo y entonces se buscan por grupo especifico. Para aprender como
asignar directivas a grupos, revisar la seccin de Pre-Processing que se encuentra ms adelante.
8. Se pueden tambin seleccionar Search outdated Directives Selecciona esta opcin para localizar
cualquier directiva de mtodos que sea incompatible con la versin actual. Para conocer con mayor
detalle la Compatibilidad de las Directivas, revisa este tema con ms detalle en la seccin
Compatibilidad de Directivas.
9. Clic en Search
P g i n a 14 | 104
Epicor 905.702a
10. El grid Search Results despliega todos los mtodos para el objeto de negocio que inicien con U. En
este ejemplo, se marca la opcin Update.
11. Clic en OK.
12. En la pestaa de Detail ahora se despliega la principal informacin del mtodo seleccionado.
13. El campo de Method Code despliega el mtodo del objeto de negocio que se ha seleccionado. Se
pueden agregar y editar directivas para este mtodo. En el ejemplo se selecciona el mtodo
CurrExRate.Update.
14. Si es necesario ingresar una Method Description.
P g i n a 15 | 104
Epicor 905.702a
15. La lista Transaction Scope define como la aplicacin manejar los errores. Las opciones disponibles
son:
Business Method and Directives: aplicacin da una reversa o cancela, todos los cambios
realizados en una accin antes de que se genere el error para evitar discrepancias en la
informacin.
Business Method: la aplicacin no da reversa a los cambios realizados por la accin.
16. La opcin Support multiple dirty rows indica que el mtodo seleccionado enviar una actualizacin
a los diferentes registros actualizados en el proceso de la base de datos. Cuando un mtodo puede
manejar mltiples registros en una sola vez hacia la base de datos, este mtodo se refiere a que esta
siendo habilitada la actualizacin masiva de varios registros. Se pueden manejar diferentes acciones
una vez que esta opcin se ha seleccionado. Ms adelante se revisa con detalle esta opcin.
17. Clic en el botn Advanced para crear acciones customizadas para las directivas de este mtodo, esto
activa el programa Method Advanced Options. Este programa despliega la firma del mtodo actual,
se puede utilizar para crear acciones customizadas. Tambin se puede crear un .NET assembly, Epicor
Service Connect Workflow, o un Progress procedure con esta funcionalidad. Para aprender como se
utilizarn estas herramientas lee la seccin de Acciones Customizadas.
Para utilizar esta funcionalidad, la cuenta del usuario debe ser definida como BPM Advanced User. Leer
previamente la seccin de configuracin de BPM para conocer cmo se dan estos atributos a un usuario.
a lis
18. Al finalizar esta definicin en la directiva de mtodo damos clic en el botn Save de la barra estndar
de herramientas.
CREANDO LA DIRECTIVA
Ahora se est to para agregar directivas a este objeto. Se pueden una o ms directivas en cada mtodo, tabla
o mtodo de BAQ actualizable.
Este ejemplo presenta como se crean una directiva que se ejecute antes que el mtodo CurrExRate.Update,
este tipo es llamado Directiva Pre-Processing. Para crear la directiva:
1. Clic en la flecha hacia abajo junto al botn New selecciona New Pre-Processing.
2. La pestaa Pre-Processing > Detail se activa.
3. Ingresa el Nombre de la Directiva para utilizar en el momento de identificar la directiva. Se puede

ingresar un nombre descriptivo que contenga caracteres especiales y espacios en blanco.
4. Si se necesita, selecciona el Group dentro del que se registrar la directiva. Se puede seleccionar un
grupo existente o ingresar un nuevo grupo. Un valor opcional que nos permite organizar las
bsquedas y exportacin de la directiva.
P g i n a 16 | 104
Epicor 905.702a
5. El campo Order nos permite indicar la secuencia en que se llevar a cabo la directiva del mtodo. El
programa automticamente ingresa un valor en este campo el cual se incrementa de 10. A la primera
directiva se le agregan 10 y as se incrementa sucesivamente. Si es necesario el valor se puede editar.
6. El campo Owner Company despliega la compaa en la cual se cre la directiva.
7. El check box Enabled indica que la directiva est activa y que la aplicacin automticamente
compilar el cdigo para que se ejecute la directiva seleccionada.
Se pueden exportar directivas para utilizarse en otros sistemas. Para hacer esto es necesario manejar
un grupo. Para aprender como exportar directivas lee la seccin Export Directives en parte de utileras
de los BPMs.
8. El check box Company Independent indica si est activo que funcionar para todas las compaas,
dentro de la aplicacin. Si no est activo significa, que solo se ejecutar en la Compaa Propietaria.
9. El check box Compatible indica que esta directiva trabaja con la versin actual de los mtodos de
negocio. Si la aplicacin valida el mtodo y descubre que no compatible con el mtodo del negocio,
este check box de-seleccionado. Para conocer con mayor detalle la aplicacin checa la seccin
Compatibilidad de Directivas que viene ms adelante.
10. Cuando se selecciona el check box Prevent Endless Loops, se restringe como van a ejecutarse las
directivas, buscando evitar que las directivas caigan en loops interminables. Lo recomendable es
seleccionar esta opcin.
11. El campo Reenter Max indica el nmero mximo de ciclos que se ejecutaran antes un mensaje de
error.
Por ejemplo, para poder crear una directiva que llama un flujo de trabajo desde Epicor Service
Connect, el cual puede iniciar desde una directiva activa. Este introduce una terminacin del ciclo en
el sistema. Como estas directivas corren, siempre, la aplicacin checa los ciclos que se van a ejecutar
un nmero de veces determinado en el campo Reenter Max. Cuando se cumple el nmero de ciclos
programados, un mensaje de error se despliega y la directiva se detiene.
12. Clic en el botn Conditions para encontrar y seleccionar la condicin a utilizarse en la directiva del
mtodo. Este abre la ventana de las condiciones, en esta ventana se seleccionar la condicin a
utilizar con la directiva. Cuando se definan los parmetros que se cumplan en la condicin, esto
relacionado con la accin relacionada. Para aprender ms sobre las condiciones, leer la seccin de
condiciones.
13. Clic en el botn Actions para encontrar y seleccionar las acciones que se quieren realizar en base a
la condicin. Se abrir la ventana, en la cual se seleccionarn la o las acciones a ejecutar al cumplirse
la condicin configurada. Para aprender ms acerca de las acciones revisar la seccin de Acciones.
P g i n a 17 | 104
Epicor 905.702a
14. Al termino dar clic en el botn Save de la barra de herramientas estndar.
CONDICIONES
Las condiciones son enunciados en los que se definen los parmetros que se deben cumplir para activar una
directiva. Si el cambio de datos permite que se cumpla un enunciado, las acciones ligadas a esas condiciones
se ejecutaran. Cada directiva tantas condiciones como se puedan necesitar.
Si se ingresan mltiples condiciones, utilizar operadores lgicos (y and, o or) para definir las relaciones
entre las instrucciones actuales y las instrucciones previas. Podemos utilizar parntesis para agrupar
condiciones en las instrucciones de manera lgica.
La aplicacin evala las declaraciones que se encuentren en la condicin en el orden en que deben aparecer
y de acuerdo a como sern agrupados. Para este ejemplo, se requiere una condicin que se active cuando el
usuario deje en blanco el nmero de telfono en un nuevo registro.
En el Men Principal: System Management > Business Process Management > Setup > Data Directives
Para crear y definir las instrucciones de la condicin:
1. Despues de crear una nueva directiva para el registro, dar clic en el botn Conditions.
P g i n a 18 | 104
Epicor 905.702a
2. La ventana de Conditions despliega.

3. Clic en el botn New en la barra de herramientas.
4. Selecciona el User Text para ingresar la condicin requerida. En este ejemplo se debe seleccionar el
texto the specified field of the changed row is equal to the specified expression.
5. Identifica que algunas palabras que se ingresan en recuadro de texto tienen hiperlink. Para acceder
a ellos debes dar clic en esos links para definir los valores utilizados para la condicin. Para este
ejemplo: da clic en el primer specified del link de la condicin.
6. Dependiendo de la condicin, se despliega una pantalla diferente. En este ejemplo, la pantalla nos
va a desplegar Select Table Field(s). Se usar esta tabla para definir el campo especifico a utilizar en
la condicin.
Todos los valores de la condicin, como se especifican: selecciona un conjunto de renglones, selecciona un
grupo, entre otros, son descritos en la siguiente seccin Condiciones y Acciones La lista completa de cada
condicin tambin se encuentra como un punto dentro de la ayuda de la aplicacin.
7. Selecciona la Tabla que contiene el campo que se necesita. Para una directiva del mtodo, todas las
tablas que actualizan en el mtodo actual aparecen en la lista. Para cada directiva de datos se puede
seleccionar nicamente una tabla asociada por cada directiva. En este ejemplo, seleccionaremos la
tabla ttCustomer.
El prefijo tt indica que la tabla es temporal, es decir, una tabla intermedia que se utiliza para validar los
datos antes de que se salven fsicamente en la base de datos. Para conocer ms acerca de las tablas
temporales, leer Condiciones y Acciones.
P g i n a 19 | 104
Epicor 905.702a
8. El grid de Fields despliega los campos contenidos en la tabla. En este ejemplo, la condicin se va a
ligar al Phone Num; se selecciona de la lista dando clic en el checkbox.
9. Damos clic en OK.
10. Regresamos a la pantalla de condiciones, identifica que en el 1er specified se cambia por el nombre
del campo seleccionado. En este ejemplo ira: Customer.PhoneNum.
11. Ahora damos clic en el segundo link specified.
12. La ventana de Specify an expression despliega.

13. En el campo Editor, se puede ingresar una expresin que podr evaluarse para monitorear datos. En
este ejemplo, se desea definir una condicin que indique al usuario que se est dejando el blanco el
campo de PhoneNumber. Para hacer esto ingresamos dobles comillas para indicar que la condicin
se activa cuando est en blanco.
La ventana para especificar una expresin se puede utilizar para construir una expresin ms
compleja que incluya datos de la transaccin actual combinada con operadores lgicos y funciones
de conversin. Se puede validar la expresin usando el botn Check Syntax
P g i n a 20 | 104
Epicor 905.702a
15. Al regresar a la pantalla de condiciones, notamos que la instruccin despliega: The

Customer.PhoneNum field of the changed row is equal to the expression. Esto significa que
cuando el usuario intente grabar un registro de cliente sin ingresar el nmero de telfono la condicin
se activar.
16. Los otros campos en la ventana nos pueden ayudar a administrar las instrucciones de la condicin. El
campo Error Text valida la instruccin ingresada si este campo est en blanco significa que la
instruccin es correcta. En otro caso, desplegara un valor que nos indique que la instruccin de la
condicin es incorrecta.
17. Si se tienen 2 o ms instrucciones, utiliza la lista de Operator para seleccionar el operador lgico que
se usar para enlazar las 2 instrucciones. Las opciones disponibles:
And: las condiciones se deben cumplir para que se active.
P g i n a 21 | 104
Epicor 905.702a
Or: se cumple la direccin si se cumple una instruccin u otra.

18. Si se necesita agrupar instrucciones en las condiciones, utiliza el campo Prefix para ingresar los
parntesis que nos permitirn agrupar instrucciones.
19. El campo Postfix tambin se utiliza para definir el cierre de los parntesis que nos permitirn cerrar
la agrupacin de instrucciones. Para agrupar 2 instrucciones, se ingresa el parntesis abierto en el
campo Prefix de la 1 instruccin y se cierra en el Postfix en la 2 instruccin.
Se pueden ingresar ms de un parntesis en el prefix y en el postfix. Se pueden crear las instrucciones

necesarias en las condiciones.
20. Para cambiar el orden en cual tu condicin se va a ejecutar, selecciona la condicin y da clic en el
botn Up o Dowm. Para que la instruccin quede en el orden requerido.
21. Si se desea eliminar una instruccin, selecciona el registro que se quiere eliminar y da clic en el botn
Delete.
22. Clic en el botn Advanced para ver el cdigo fuente para BPM Progress; este punto es el cdigo que
correra en la instruccin actual. Siempre y cuando tu tengas derechos de BPM Advanced User que
pueden usarse en esta funcin para extender manualmente o reemplazar este cdigo.
23. La ventana de Source Code despliega.

24. Editar el cdigo de la condicin que se ingrese en el campo Code.
25. Al terminar dar clic en OK.
P g i n a 22 | 104
Epicor 905.702a
26. Regresamos a la pantalla de condiciones. Al terminar la definicin de tus condiciones, dar clic en OK.
27. Cuando regresamos a la pantalla de directivas de datos, la condicin se despliega en el campo

Conditions.
ACCIONES
Las acciones son operaciones que ejecuta una directiva cuando las condiciones se cumplen al momento de
efectuar un cambio en los datos. Para crear y definir acciones se utilizan instrucciones similares a las utilizadas
en las condiciones se pueden seleccionar y definir en la seccin de ingreso de acciones, para que cuando se
cumplan las condiciones determinadas se ejecuten las acciones.
Para este ejemplo, se requiere que la accin despliegue un mensaje de error cuando el usuario deja en blanco
el campo de Nmero de Telfono en un ingreso de cliente. Para crear y definir las acciones:
P g i n a 23 | 104
Epicor 905.702a
1. Clic en el botn Actions.
2. Nos abrir la pantalla de Actions (Acciones).

3. Clic en el botn Nuevo de la Barra de Herramientas.
4. Selecciona el campo de User Text para ingresar la accin que se desea aplicar. En este ejemplo, se
seleccionar raise exception base don the designed template como accin.
5. Algunas de las palabras ingresadas en la instruccin de la accin son de tipo hyperlink. En los campos
de tipo hyperlink debemos definir valores especficos. Para este ejemplo: dar clic en designed para
ingresar el mensaje que deber desplegar la accin.
Todas las acciones son descritas en la siguiente seccin: Condiciones y Acciones La lista completa de cada
uno de ellos, adicionalmente la podemos encontrar en la ayuda en lnea.
P g i n a 24 | 104
Epicor 905.702a
6. En la venta del Templete (Formato) de Design Exception.

7. Ingresa el Name (Nombre) del formato. En este ejemplo, se ingresa RequiredPhoneNum.
8. Ahora ingresa el Text (Texto) que queremos despliegue el mensaje de error al cumplirse la condicin.
Para este ejemplo, se ingresa: Antes de guardar el nuevo cliente, se debe ingresar el nmero
telefnico.
9. Clic OK.
10. Regresa a la pantalla de Actions. Identifica que el campo User Text: raise execption based on the
RequiredPhoneNum template. Esto significa que si se cumple la condicin se desplegar el mensaje
de error ingresado en esta accin.
11. El campo Error Text nos indica los posibles errores en la sintaxis de la accin ingresada en el campo
User Text , si est en blanco significa que es correcta, cualquier valor que despliegue este campo
significar el error.
12. Para cambiar el orden en que se lleven a cabo las acciones, dar clic en Up o Down. La accin que
aparezca en el inicio de la lista ser la primera que se ejecute y en ese orden se llevarn a cabo una
a una.
13. En el campo Terminate On Error nos indica que la accin saldr en automtico si al momento de
ejecutarse genera un error. Para activar esta funcin, clic en este campo y seleccionar (exit on error).
14. Si se desea eliminar una accin, selecciona la accin y da clic en el botn Delete.
15. Dar clic en el botn Advanced para ver el cdigo fuente del proceso en BPM Progress, este elemento
es el proceso que se ejecuta en la accin seleccionada. Se requiere tener permisos de BPM Advanced
User, para usar esta funcionalidad y modificar el cdigo manualmente.
P g i n a 25 | 104
Epicor 905.702a
16. La ventana de Source Code.

17. Editar el cdigo de la accin que se necesita dentro del campo Code.
18. Al terminar damos clic en el botn OK.
19. Regresamos a la ventana de Acciones. Cuando puedes definir las acciones y dar clic en OK.
20. Regresamos a la ventana de Data Directives. La nueva accin se despliega en el campo de Actions.
P g i n a 26 | 104
Epicor 905.702a
CONDICIONES Y ACCIONES LA LISTA COMPLETA
Esta seccin explora todas las condiciones pre-construidas condiciones y acciones disponibles dentro de la
funcionalidad de BPM. Utilizar esta seccin para crear las directivas que usted necesita.
Tambin se pueden crear BPM condiciones y acciones, se identifican las tablas con el prefijo tt. El prefijo
tt es una abreviacin de tabla temporal; este valor se usa dentro del cdigo ABL. Cuando se utiliza una tabla
tt en su nombre, se est trabajando con una tabla temporal que se relaciona con la base de datos .NET que
se pasan entre el servidor y el cliente hasta convertirse en la misma tabla pero fsica dentro de la base de
datos.
Cuando se modifica una columna en una tabla tt a travs del pre-procesos o in-transaction de la directiva,
se pueden modificar los datos antes de que se ingresen a la tabla.
Cuando se modifica una tabla tt a travs del proceso post-process o Standard en las directivas de datos, se
pueden modificar los datos que regresan del servidor al cliente. Debemos tener cuidado con la integridad de
la informacin entre el registro en las tablas del servidor y del cliente. Cambiando los datos nicamente en el
conjunto de datos a nivel cliente que subsecuentemente se debern escribir en la base de datos, debemos
tener cuidado de no causar un Record has been modified by Another User. Esto ocurre porque el registro
original del cliente no es igual al registro en la base de datos.
P g i n a 27 | 104
Epicor 905.702a
CONDICIONES
Esta seccin contiene la lista de las condiciones pre-construidas que se pueden seleccionar. Algunas de las
condiciones slo estn disponibles en determinadas directivas. Por ejemplo, la condicin: the Sepcified field
has been changed from any to any no est disponible en la directiva de mtodo post-process porque no se
necesita el campo original y el que cambio si el registro ya se registr en la base de datos, esta comparativa
siempre se requiere antes de que se ejecute el proceso. Las condiciones disponibles son:
The specified argument is equal to the specified expression Est condicin se utiliza para evaluar
los parmetros del BPM, una tabla temporal o el contenido de las variables call context (que son
variables en el proceso). Tambin podemos utilizar para evaluar las acciones customizadas dentro
del BAQ. Si se ejecutan dentro del BPM.
Tipo de Directivas
Mtodo Dato Actualizable BAQ

Ninguno Todos
Ninguno
Variables
Specified (argument) Clic en este link para que nos despliega el programa para seleccionar
el argumento. Utilizar este programa para seleccionar cual parmetro
se quiere evaluar contra otras variables en la misma condicin.
Is equal to Clic para que nos despliegue el programa para seleccionar el tipo de
comparacin. Utilizar este programa para seleccionar una opcin de
comparacin a evaluar contra el argumento. Esta comparacin debe
darnos como resultado TRUE para que se ejecute la accin.
Specified (expression) Clic en este link para que nos abra el programa para especificar una
expresin. Utilizar este programa para armar una expresin que se
pueda comparar contra el parmetro. La expresin contener: valores
literales, datos desde la transaccin actual y funciones que puedan
realizar clculos o conversin de datos. Si se est evaluando una
condicin dentro de una accin customizada en un BAQ debemos
ingresar el ID de la accin entre dobles comillas . Dar clic en el botn
de checa sintaxis para verificar que la expresin sea correcta.
Number of rows in the designed query is not less than 1 Utilizar esta condicin para crear un query
que se active con datos conocidos, una comparacin especfica (is more than, not less than, and so
on). Si esta comparacin se cumple con un TRUE, la accin se ejecutar.
El query debe ser una cadena completa, no agregue ningn retorno pesado (combinado) o ligero
que pueda devolver mltiples datos. No agregue al final del query comparativos de datos.
P g i n a 28 | 104
Epicor 905.702a
Tipo de Directivas

Todos Todos
Todos
Variables
Designed Clic en el link para que abra el programa para

componer el query. Utilizar este programa para
escribir un query compatible con ABL y BAQ.
Este query evaluara el nmero de renglones
devuelto comparado con el valor que se
seleccione ms tarde en la instruccin. Si
agregamos tablas estndar, las etapas del query
pueden ejecutar valores en tablas temporales
(tt) para analizar valores entre bases de datos.
Is not less than Clic en el link para abrir el programa que nos
permite seleccionar la comparacin utilizada
para evaluar el nmero de renglones en el
query seleccionado. Si la comparacin se evala
a TRUE, la accin se ejecutar.
1 Clic en este link para que despliegue el valor de
renglones a generar. Utilizar este programar
para ingresar un valor numrico que evala el
nmero de renglones que se regresan en el
query.
The specified field has been changed from any to any. Utilizar esta condicin para monitorear el
valor especfico contenido en la transaccin actual. Si el valor de est campo cambia a otro valor que
se ha definido en esta condicin se detonar la accin correspondiente.
Para esta condicin, se deben especificar 2 valores. El primer valor del campo se compara con el
segundo valor. Si esta comparacin regresa TRUE, la aplicacin ejecutar la accin definida.
Todas las tablas contiene una columna llamada RowMod que esta al final del registro. La aplicacin fija
el RowMod como: Add(A), Update (U), o Delete (D) para definir la accin que se presenta en el registro.
Normalmente el valor del RowMod es un conjunto para los mtodos Update(U). Si se ve la referencia
cambiada se refiere a un valor RowMod establecido como A o U. Algunos mtodos no establecen un
valor RowMod, por lo que las condiciones que requieren que el RowMod contenga un valor que no
puede ser usado. Sin embargo, en algunas filas estn permitidas para que posiblemente deje el valor
Row Mod vaco.
P g i n a 29 | 104
Epicor 905.702a
Tipo de Directivas

Todos Pre-Processing
Pre-Processing
Base Processing
Base Processing
Variables
Specified Clic en el link para abrir el programa que nos

permita seleccionar el campo de la tabla.
Utilizar este programa para seleccin un campo
que se parte de la condicin BPM. Se puede
seleccionar un campo estndar o un campo
definido por el usuario desde cualquier tabla
temporal (tt table) incluidas en los parmetros
del mtodo. Esta aplicacin compara el valor
del campo original contra el nuevo valor del
campo que se especfica.
Any Clic en este link para que se abra el programa
para especificar un Valor. Utilizarlo para
ingresar el valor que se desea sea evaluado.
Any Clic en este link para abrir el programa para
especificar el valor a comprar. Utilizarlo para
ingresar el valor que se desea ser evaluado.
The method is called by specified user Utilizar est condicin para determinar que usuario puede
ejecutar o no la accin definida. Dependiendo de lo que se defina para esta condicin (Yes o No), la
accin de la directiva se ejecutar. Esta condicin puede ser usada para probar directivas que se
quieren activar para un usuario especfico.
Tipo de Directivas

Todos Todos
Todos
Variables
Is called Clic en este link para ejecutar el programa de

seleccionar opcin. Este programa despliega el
is called o is not called. Selecciona la opcin
requerida, estas opciones determinan quien
puede generar la accin y quien no.
Specified user Clic este link para abrir el programa que nos
indicar el usuario que puede ejecutar la accin.
P g i n a 30 | 104
Epicor 905.702a
The user called the method belongs to specified group Utilizar esta condicin para determinar si
el usuario actual pertenece o no a un grupo especfico. La aplicacin compara el usuario quien inicia
la transaccin en el grupo. La accin de la directiva se ejecuta dependiendo de que se cumpla la
condicin (YES-SI o NO)
Tipo de Directivas

Todos Todos
Todos
Variables
Belong Clic en este link para ejecutar el programa de

seleccionar la opcin. Este programa despliega
el belongs o does not belong. Selecciona esta
opcin si se necesita determinar si un grupo es
miembro de un grupo o no para ejecutar una
accin determinada.
Specified group Clic este link para abrir el programa que nos
indicar el grupo de usuarios que puede
ejecutar la accin.
The hold of the specified type is attached to the business object Utilizar la condicin para indicar
que el Sistema podra verificar que un tipo de retencin fue anexada al objeto actual o relacionado
con el objeto. Si el tipo de retencin est presente en los objetos de negocio seleccionados cuando
el mtodo se ejecuta, la aplicacin ejecutar las acciones indicadas.
Tipo de Directivas

Ninguno Ninguno
Todos
Variables
Specified type is attached to the business Clic en el link para que se abra el programa
object Select Business Object. Nos desplegar los
objetos que estn relacionados con el mtodo
actual utilizando una vista de rbol. La interface
nos desplegar todos los objetos que estn
ligados, o que se pueden ligar al objeto actual.
Tambin puedes especificar el tipo de retencin para esta condicin que se necesita verificar en el objeto del
negocio. Los tipos de retencin deben ser creados para especificar un objeto de negocio. Antes de que se
P g i n a 31 | 104
Epicor 905.702a
seleccione un evento a travs de este programa. Para ms informacin, lee la seccin de Tipo de retencin
que est ms adelante en este manual.
Time is in the specified time frame. Utilzar esta condicin para indicar un marco de tiempo
especfico en el cual ser monitoreada esta condicin. Si la transaccin de datos es ejecutada durante
este marco de tiempo, la aplicacin ejecutar las acciones de la directiva.
Tipo de Directivas

Todos Todos
Todos
Variables
specified Clic en este link, para abrir el programa Specify

a Time Frame. Usar este programa para definir
un marco de tiempo como parte de la condicin
de esta instruccin. Se puede especificar ese
marco de tiempo las siguientes opciones:
Una fecha inicio y fecha final.
Que ocurra en un intervalo de tiempo.
Un rango de horas durante el da.
The specified field of the changed row is equal to the specified expression - est declaracin de
condicin monitorea un campo especfico dentro de una transaccin de datos. El BPM compara el
valor del campo contra el valor que especficas al final de la sentencia. Si est comparacin se cumple,
la aplicacin ejecuta la directiva de la accin.
Tipo de Directivas

Todos Pre-processing
Pre-processing
Base processing Base processing
Variables
Specified (field) Clic en este link para abrir el programa Select

table. Utilizar este programa para especificar un
campo estndar o un campo definido por el
usuario que es parte de la sentencia. Para las
directivas de mtodo, se pueden seleccionar un
campo desde una tabla temporal (tt tabla)
incluida en los parmetros del mtodo actual.
Para las directivas de datos, se puede
seleccionar un campo estndar o un campo
P g i n a 32 | 104
Epicor 905.702a
definido por el usuario que este dentro de la

tabla temporal asociada con la directiva.
the changed row Clic en este link para abrir el programa Select a
Row Set. Utilizar este programa para especificar
cul es el conjunto de renglones que se
afectarn cuando esta regla se active como
son added row agregar un rengln, the
deleted row borrar un rengln, the update
row actualizar un rengln entre otros.
is equal to Clic en este link para abrir el programa Select a
Comparison. Utilizar este programa para
seleccionar una opcin de comparacin
utilizada para comparar el campo seleccionado
contra el valor definido ms adelante en la
sentencia de la condicin
specified (expression) Clic en este link para abrir el programa Specify
an Expression. Utilizar este programa para
componer una expresin que se evale en la
comparacin. La expresin puede contener un
valor literal, datos desde la transaccin y
funciones que pueden generar clculos o
conversiones de datos. Clic en el botn Check
Syntax para verificar que la sintaxis de la
expresin sea correcta.
There is at least one update row in the specified table - Est condicin compara el valor de un
campo includo en el conjunto de renglones de una tabla especifica. Si esta comparacin devuelve
TRUE- Verdadero, se ejecutar la accin de la aplicacin.
Tipo de Directivas

Todos Pre-Processing
Pre-Processing
Base Processing Base Processing
Variables
updated Clic este link para abrir el programa Select a

el conjunto de renglones se afectar cuando se
active la regla de actividades como son the
added row rengln agregado, the deleted row
borrado de rengln, the updated row
rengln actualizado entre otros.
specified Clic en este link para abrir el programa Select
Table. Utilizar este programa para especificar
una tabla la cual se podra monitorear a travs
de la sentencia de la condicin. Utilizar este
P g i n a 33 | 104
Epicor 905.702a
programa para seleccionar una tabla ligada a la

transaccin actual.
Value of the specified field of the designed query changed from any to another Utilizar esta
condicin para que el campo de un query especfico que este fuera de la transaccin actual. Si el valor
del campo cambia a otro valor que se define, la condicin activa las acciones de la directiva.
Tipo de Directivas

Todos Ninguno
Ninguno
Variables
specific Clic este link para que abra el programa Select

un campo estndar o definido por el usuario en
esta parte de la sentencia.
designed Clic en este link para que se abra el programa
Compose Query. Utilizar este programa para
escribir un query compatible con ABL y/o un
BAQ (Business Activity Qurey) como parte de
una sentencia de la condicin o de la accin del
BPM. Se pueden agregar tablas estndar que se
deben ligar con las tablas temporales con el
objetivo de filtrar informacin.
any and another Clic en este link para abrir el programa Specify
a Value. Utilizar este programa para ingresar
valores a evaluar. Para esta sentencia de la
condicin, se pueden especificar 2 valores para
el campo. El primer valor es comparado contra
el segundo valor. Si la comparacin regresa
TRUE VERDADERO, la aplicacin ejecuta la
directiva de la accin.
The specified call context field is equal to the specified expression Utilizar esta condicin para
monitorear el valor de una variable de contexto en la transaccin actual, como pueden ser
CurrentCompany or CurrentUserId. La aplicacin compara este argumento contra una expresin que
se especfique. Si la comparacin devuelve TRUE Verdadero, la aplicacin ejecuta las acciones de la
directiva.
Tipo de Directivas

Todos Todos
Todos
P g i n a 34 | 104
Epicor 905.702a
Variables
Specified call context Clic en este link para abrir el programa Select
Table Field(s). Utilizar este programa para
especificar un campo de context para una de las
2 tablas llamadas de context. Estas tablas estn
disponibles para cada mtodo de negocio, y
puedes aprovecharlas para almacenar datos
personalizado tanto en el cliente como en el
servidor. La aplicacin compara el valor del
campo con un valor que se especifique. Para
ms informacin revise los temas de llamadas
de contexto dentro de la ayuda de la aplicacin
is equal to Clic en este link para abrir el programa de Select
a Comparision. Utilizar este programa para
seleccin una opcin de comparacin que se
usan para validar el nmero de renglones del
query seleccionado. Si esta comparacin evalua
TRUE-Verdadero, las directivas de accin se
ejecutarn.
specified Clic este link para abrir el programa Specify an
Expression. Utilizar este programa para
componer una expresin que se evaluada
durante la comparacin. Esta expresin puede
contener valores literales, datos desde la
transaccin actual, y funciones que pueden
ejecutar clculos y tipos de datos para la
conversin. Clic en el botn Check Syntax para
verificar la sintaxis de la expresin.
Method changed the specific field of the designed query from any to another value Cuando esta
condicin es utilizada, la aplicacin verificar que el campo que es resultado del conjunto de los
resultados del query ha cambiado desde un valor a otro valor. Si esta condicin se cumple la
condicin se evala TRUE -Verdadero, la aplicacin ejecuta las directivas de la accin.
Tipo de Directivas

Ninguno Ninguno
Post-Processing
Variables
specific Clic este link para que abra el programa Select

un campo estndar o definido por el usuario en
esta parte de la sentencia.
designed Clic en este link para que se abra el programa
Compose Query. Utilizar este programa para
P g i n a 35 | 104
Epicor 905.702a
escribir un query compatible con ABL y/o un

BAQ (Business Activity Qurey) como parte de
una sentencia de la condicin o de la accin del
BPM. Se pueden agregar tablas estndar que se
deben ligar con las tablas temporales con el
objetivo de filtrar informacin.
any and another Clic en este link para abrir el programa Specify
a Value. Utilizar este programa para ingresar
valores a evaluar. Para esta sentencia de la
condicin, se pueden especificar 2 valores para
el campo. El primer valor es comparado contra
el segundo valor. Si la comparacin regresa
TRUE VERDADERO, la aplicacin ejecuta la
directiva de la accin.
This directiva has been enabled from the specified directive - Utilizar esta condicin para
seleccionar un pre-proceso o proceso base de la directive que puedan ejecutarse con xito para que
la directiva de post-proceso se ejecute.
Tipo de Directivas

Ninguno Post-Processing
Post-Processing
Variables
specified Clic en este link para abrir el programa Select a

Primary Direct to Depend Upon. Utilizar este
programa para seleccionar la directiva de pre-
processing o post-processing que se utilice en
esta condicin.
The specified public data tag exists on the changed row of the specified table - Utilizar esta
condicin para identificar cuando la etiqueta de un dato ser colocada en un registro. Se pueden
aplicar etiquetas a los registros a travs de la aplicacin. Un uso comn de las etiquetas de datos
puede ser un grupo de registros relacionados para buscarse en una directiva BPM que puedan
ejecutarse cuando los registros sean modificados. Revisar el captulo de Busquedas para ms
informacin acerca de las etiquetas de datos.
Tipo de Directivas

Todos Ninguno
Todos
P g i n a 36 | 104
Epicor 905.702a
Variables
The specified (data tag) Clic en este link para abrir el programa Specify
a Value. Utilizar este programa para ingresar un
texto de libre formato que se iguale con la
etiqueta de datos para cual se quiere ejecutar la
directiva.
public Clic este link para seleccionar tres valores:
public, current user y public or current user.
Seleccionar public para limitar los registros de la
directiva que se asignado etiquetas pblicas
para especificar un nombre. Seleccionar el
usuario actual para limitar los registros de la
directiva donde el usuario trate de modificar los
registros que se agreguen a datos privados.
Utilizar el public or current user si se desea que
una directiva se ejecute para las etiquetas de
datos donde se indique si es pblico o privado,
instado o limitado a una directiva de uno a otro.
exists Clic en este link para seleccionar 2 de los valores
disponibles: exists or doesnt exists .
Seleccionar exists para limitar las idrectiva alos
registros que tengan aplicada la etiqueta,
seleccionar doesnt exists para limitar la
directiva a los registros que no tienen aplicada
la etiqueta correspondiente.
the changed row Clic en este link para abrir el programa Select
cul rengln ser afectado cuando la regla se
active cuando se added row agregue un
rengln, the deleted row borre un rengln,
the updated row se borre un rengln entr
otros.
specified (table) Clic este link para abrir el programa Select
una tabla como parte de la sentencia de la
condicin. Para una directiva de mtodo,
utilizar este programa para seleccionar un
campo estndar o definido por el usuario de
una tabla temporal (tt tabla) incluida en los
parmetros del mtodo actual. Para una
directiva de datos, debemos asegurarnos para
seleccionar la tabla actual, esta tabla contiene
los datos que deseamos monitorear.
ACCIONES
Esta seccin contiene la lista de las acciones pre-construidas; que puedes utilizar para crear sentencias
complejas para una causa especifica que ocurran dentro de la aplicacin. Las disponibles acciones:
P g i n a 37 | 104
Epicor 905.702a
Send email asynchronously based on the designed template with rule utilizer esta accin para
enviar automticamente un correo a los recipientes seleccionados.
Tipo de Directivas

Standard Todos
Todos
Variables
asynchronously Clic en este link para que el conjunto de

variables en un email se enva sncronamente o
asncronamente. Esto indica como la aplicacin
generar el mensaje generado por esta accin.
Las opciones disponibles son:
Sincronamente el email se enviar
en cuanto se ejecute la accin.
Asincronamente el email se colocar
en un fila y se ejecutar en base a la
programacin definida a travs del
programa del Proceso de la Accin del
BPM, para aprender ms acerca de
este programa, leer el BPM Proceso de
la Accin.
designed Clic este link para abrir el programa Design
Email Template. Utilizar este programa para
construir un mensaje de email que se gener
cuando la accin del BPM se ejecute.
Tambin se puede insertar un campo y variables

de la tabla en el mensaje. Se puede disear un
simple Query que obtenga los valores desde los
campos. Se puede utilizar el programa de
Design Simple Query para utilizar la
funcionalidad. Para ejecutar este programa dar
clic con el botn derecho en el campo de texto
para seleccionar otro campo de query o tabla.
with rule Clic en este link para abrir el programa
Execution Rule. Si la transaccin de datos
soporta mltiples renglones, se puede utilizar
este programa para seleccionar como se
desarrolle la accin. Leer la seccin de soporte
a mltiples renglones. Esta variable no es visible
si el mtodo de datos de la transaccin no
soporta mltiples renglones.
P g i n a 38 | 104
Epicor 905.702a
Call the specified Epicor Service Connect Workflow asynchronously with rule utilizer esta accin
para enviar una llamada a Epicor Service Connect. La informacin en esta llamada es distribuida a
travs del Flujo de Trabajo de Service Connect que se seleccione.
Tipo de Directivas

Standard Todos
Todos
Variables
specified Clic en este link para abrir el programa Logon to

Service Connect. Utilizar este programa para
ingresar las credenciales de ingreso para el
servidor donde est instalado Epicor Service
Connect.
Despus de que se ingresen correctamente las

credenciales, el programa Select Workflow.
Utilizar este programa para seleccionar el
workflow que se quiere utilizar.
Para aprender ms acerca de Epicor Service

Connect, revisa la documentacin del Epicor
Service Connect y la Gua del Usuario
asynchronusly Clic en este link para ejecutar el workflow
asncronamente o sncronamente.
Sincronamente la llamada se hace
inmediatamente cuando se ejecuta la
accin.
Asincronamente la llamada es
colocada en una fila y se ejecuta de
acuerdo a la programacin definida en
el proceso de BPM Action Process.
with rule Clic en este link abre el programa Execution
Rule. Si las transacciones de datos soportan
multiples registros, se puede utilizar este
programa para seleccionar como se
despliegarn los renglones.
Create specific task with rule utilizar esta accin para automaticamente generar una tarea a los
usuarios seleccionados.
Tipo de Directivas

Standard Todos
Todos
P g i n a 39 | 104
Epicor 905.702a
Variables
specific Clic en este link para abrir el programa Create

task template. Utilizar este programa para
definir una tarea que es creada cuando la
aplicacin ejecuta esta accin.
Tambin se pueden insertar argumentos dentro

del formato de la tarea actual. Los conjuntos de
valores de la aplicacin para el formato de la
tarea se sustituyen por los valores provistos por
el mtodo del objeto de negocio o de la tabla
ligada a la directiva. Para utilizar esta
funcionalidad da clic dentro del tab
comentarios que existe dentro de los
comentarios en el formato de la tarea. Entonces
dar clic con el botn derecho dentro del campo
de comentarios y seleccionar los parmetros
que aparecen en el sub-men. Selecciona el
argumento que se necesita. El tipo de
argumento debe ser apropiado para el
argumento que es utilizado, si esto no ocurre se
genera un error.
Se pueden tambin ingresar variables al

formato de la tarea. Para hacer esto se puede
disear un Simple Query que obtenga
informacin de los campos que se definan. Para
utilizar un Design Simple Query para acceder a
esta funcionalidad, primero dar clic en los
Commentarios que estn dentro del programa
Create Task Template. Dar clic con el botn
derecho dentro del campo comentarios.
with rule Clic en este link abre el programa Execution
Rule. Si las transacciones de datos soportan
multiples registros, se puede utilizar este
programa para seleccionar como se
despliegarn los renglones.
Synchronously invoke .NET method dont queue record nothing with rule Utilizar esta accin para
que se pueda seleccionar .NET.
Tipo de Directivas

Standard Todos
Todos
P g i n a 40 | 104
Epicor 905.702a
Variables
Synchronously Clic en este link para seleccionar si ser

asncrono o sncrono:
Sncrono la llamada se ejecutar
durante la accin.
Asncrono la llamada es colocada en
una fila de procesos que se ejecutar
conforme se defina la programacin
de la tarea. Para aprender ms acerca
de este programa leer BPM Action
Process.
method Clic en este link para que se abra el programa
.NET Action Proxy Builder. Utilizar este
programa para anexar una llamada para el
mtodo .NET y especificar como se deber
ejecutar. El mtodo .NET es una accin de
programacin que extiende la funcionalidad de
nuestra aplicacin.
dont queue Para las acciones asncronas se puede
configurar que la accin se someta a una fila de
proceso. Leer el tema de Asncrona Accin en la
seccin de Epicor ICE Tools User Guide para
entender la configuracin. Clic en este link para
seleccionar:
Dont queue automticamente se
configura asncronamente.
Queue at BPM Server disponible
para ejecucin asncrona.
Queue at Progress disponible para la
ejecucin asncrona.
Queue at both BPM server and
Progress - disponible para ejecucin
asncrona.
record nothing Indica que cualquiera que sea la accin
ejecutada sobre el registro en el cdigo
customizado. Ver el grabado y ejecucin de las
llamadas en la ayuda del sistema. Clic en el link
que nos permita seleccionar:
Record nothing no se almacena la
accin.
Record call Solo se registra la accin
de la llamada.
Record return se registra solo la
accin que regresa datos.
Record call, return registra tanto el
llamado como el resultado de la
llamada.
Execution Rule. Si las transacciones de datos
soportan mltiples renglones, se puede utilizar
P g i n a 41 | 104
Epicor 905.702a
este programa para seleccionar como se van a

operar las acciones sobre los renglones.
Synchronously execute ABL code record nothing with rule utilizar esta accin para anexar un
proceso ABL (.p o .r) a un mtodo. Cuando esta accin se ejecuta, el proceso del programa se ejecuta.
Tipo de Directivas

Todos Todos
Todos
Variables
Synchronously Clic en este link para seleccionar si ser

asncrono o sncrono:
Sncrono la llamada se ejecutar
durante la accin.
Asncrono la llamada es colocada en
una fila de procesos que se ejecutar
conforme se defina la programacin
de la tarea. Para aprender ms acerca
de este programa leer BPM Action
Process.
code Clic en este link para que se abra el programa
ABL Action. Utilizar este programa para anexar
un proceso ABL para una directiva de mtodo.
Se puede agregar el proceso de 2 maneras:
escribiendo el cdigo del proceso dentro del
programa o llamando un proceso desde un
archivo que ha sido desarrollado desde el
servidor de aplicaciones.
record nothing Indica que cualquiera que sea la accin
ejecutada sobre el registro en el cdigo
customizado. Ver el grabado y ejecucin de las
llamadas en la ayuda del sistema. Clic en el link
que nos permita seleccionar:
Record nothing no se almacena la
accin.
Record call Solo se registra la accin
de la llamada.
Record return se registra solo la
accin que regresa datos.
Record call, return registra tanto el
llamado como el resultado de la
llamada.
Execution Rule. Si las transacciones de datos
soportan mltiples renglones, se puede utilizar
P g i n a 42 | 104
Epicor 905.702a
este programa para seleccionar como se van a

operar las acciones sobre los renglones.
Show informational message based on the designed template with rule utilizar esta accin para
desplegar un mensaje informativo con el formato definido por nosotros. Despus de que los usuarios
lean el mensaje y den clic en OK, el mtodo contina procesando. Los mensajes informativos de BPM
son transmitidos a los clientes Epicor Mobile Access, Epicor Web Access, Web Services y Service
Connect.
Tipo de Directivas

Ninguno Pre-Processing
Pre-Processing
Post-Processing
Post-Processing
Variables
designed Clic en este link para abrir el programa Design

Informational Message Template. Utilizar este
programa para ingresar un mensaje que
contenga informacin que los usuarios tengan
que ver. Basado en la condicin(es) definidas
para la directiva actual, el mensaje se debe
desplegar. Se puede seleccionar uno de los
siguientes Severity: Informativo, Alerta, Error y
Conflicto de Actualizacin. Se puede tambin
seleccionar si el mensaje de BPM despliega
como un mensaje individual o como un grid.
Raise exception base don the designed template with rule - utilizar esta accin para desplegar un
mensaje de excepcin que cuando se cumpla condicin, se active esta accin, se detendra el proceso
hasta que el usuario lo revise y de clic en la pantalla de excepcin. Estos mensajes son transmitidos
a los clientes Epicor Mobile Access, Epicor Web Access, Web Services y Service Connect.
P g i n a 43 | 104
Epicor 905.702a
Tipo de Directivas

In-Transaction Pre-Processing
Pre-Processing
Post-Processing
Post-Processing
Variables
Designed Clic en este link para abrir el programa Design

Exception Message Template. Utilizar este
programa para ingresar un mensaje que
contenga informacin que los usuarios tengan
que ver. Basado en la condicin(es) definidas
para la directiva actual, el mensaje se debe
desplegar.
Dentro del mensaje, se puede incluir valores de
un querie relacionado con tablas o campos. Se
puede disear un Simple Query que obtenga
informacin de los campos. Para utilizar un
Simple Query dar clic en el programa Design
Simple Query para definir esas variables. Para
habilitarlo dar clic con el botn derecho en el
campo de Text Field y seleccionar Field Query o
Table Query en el men de contexto.
Adicionalmente se puede seleccionar uno de los
siguientes Severity: Informativo, Alerta, Error y
Conflicto de Actualizacin. Se puede tambin
seleccionar si el mensaje de BPM despliega
como un mensaje individual o como un grid.
Attach hold of the specified type with rule utilizar est accin para agregar una retencin a un
registro especfico.
Tipo de Directivas

Standard Ningno
Todos
P g i n a 44 | 104
Epicor 905.702a
Variables
specified Clic en este link para abrir el programa Hold

attachment. Utilizar este programa para
especificar que retencin se va anexar a un
registro cuando la aplicacin ejecuta la accin.
Se puede seleccionar desde cualquiera de los
tipos de retenciones definidas para el objeto de
negocio. Tambin se pueden agregar
comentarios adicionales.
Despus de que la retencin se ha colocado en

un registro, cualquier directiva subsecuente
puede checar para la presencia de esta
retencin y la ejecucin de varias acciones
cuando el usuario intenta ejecutar un mtodo
que afecta el registro.
Los tipos de retencin son creados en Hold

Type Maintenance. Para aprender ms de este
tema leer la seccin de mantenimiento a los
tipos de retencin.

Remove hold of the specified type with rule - utilizar esta accin para remover una retencin desde
un registro especfico.
Tipo de Directivas

Standard Ningno
Todos
Variables
specified Clic en este link para abrir el programa Hold

Removal. Utilizar este programa para
especificar la retencin que se va a eliminar
cuando la aplicacin ejecute esta accin.
P g i n a 45 | 104
Epicor 905.702a
Se puede seleccionar cualquier tipo de

retencin definida para los objetos de negocio.
Los tipos de retencin son creados en Hold
Type Maintenance.

Set the specified field of the changed row to the specific espression with rule utilizar esta accin
para cambiar un campo seleccionado a un valor determinado.
Tipo de Directivas

Ninguno Todos
Todos
Variables
specified Clic en este link para que abra el programa

Select Table Field(s). Utilizar este programa
para especificar un campo estndar o un campo
definido por el usuario el cual se cambiar a
travs de esta accin. Utilizar este programa
para seleccionar el campo desde una tabla
temporal (tt tabla) incluyendo los parmetros
del mtodo actual.
The changed row Clic en el link para abrir el programa Select Row
Set. Utilizar este programa para especificar este
conjunto que renglones que ser afectado
cuando esta regla se active tales como: added
row agregar rengln, deleted row borrado
rengln, updated row actualizar el rengln
entre otros.
specific Clic en este link para abrir el programa Sepecify
componer una expresin que se evaluar en la
comparacin. La expresin puede contener
valores de literales, de datos desde la
transaccin y de funciones que pueden ejecutar
clculos y conversiones de datos. Clic en el
botn de Check Syntax para verificar la sintaxis
de la expresin.
P g i n a 46 | 104
Epicor 905.702a

Enable dependent post-process directives - Utilizar esta accin en directivas de procesos post-
processing ligadas a esta directive. Utilizar esta accin cuando se desee ejecutar una accin despus
de que el registro es validado exitosamente y actualizado desde la tabla temporal tt o tablas fsicas.
No se deben seleccionar variables para esta accin. Se pueden ligar esta directiva a una post-
processing desde una pre o base processing utilizando la condicin this directive has been enabled
from the specified directive. Se puede seleccionar la directiva que contenga esta accin a travs una
variable especfica.
Utilizar esta accin para probar las condiciones en una directiva pre-processing o base processing y
que se ejecute en automtico una post-processing basada en esas condiciones. Par ms informacin,
revisar la seccin previa de Condiciones. Para ms informacin en directivas dependientes, leer la
seccin de Directivas Dependientes ms adelantes en este documento.
Tipo de Directivas

Ninguno Pre-Processing
Pre-Processing
Base Processing
Base Processing
Set the specified field of BPM Data to the specified expression utilizar este conjunto de valores de
un campo en una tabla BPM. Esta tabla se usa con el objetivo de almacenar datos de usuarios a travs
de tablas de CallContext. Se puede checar el valor de campo en una condicin para futuras directivas
o valores pasados a travs de la aplicacin del cliente. Para ms informacin revisa los tpicos del
CallContext dentro de la ayuda de la aplicacin.
Tipo de Directivas

Todos Todos
Todos
Variables
Specified (call context) Clic en este link para abrir el programa Select
Table Field (s). Utilizar este programa para
P g i n a 47 | 104
Epicor 905.702a
especificar un campo de llamada de contexto

que es parte de la accin BPM.
specified Clic en este link para abrir el programa Specify

componer una expresin que se utiliza como
una variable de contexto. La expresin puede
contener valores literales, datos de la
transaccin actual, funciones que pueden
generar clculos y conversiones de datos. Clic
en el botn de Check Syntax para verificar la
sintaxis de la expresin.
Attach the specified public data tag to the changed row of the specified table with rule Utilizar
esta accin para anexar una etiqueta de datos a un registro. Se pueden aplicar etiquetas de datos a
los registros a travs de la aplicacin. Un uso comn para las etiquetas de datos es agrupar registros
para bsquedas o para directivas BPM que se puedan ejecutar cuando exista un cambio en los
registros. Revisar el captulo de bsquedas para ms informacin acerca de las etiquetas de datos.
Tipo de Directivas

Todos Ningno
Todos
Variables
directiva.
public Clic este link para seleccionar tres valores:
Seleccionar public para agregar los registros de
la directiva que se asignado etiquetas pblicas
P g i n a 48 | 104
Epicor 905.702a

otros.
Remove the specified public data tag to the changed row of the specified table with rule Utilizar
esta accin para remover una etiqueta de datos a un registro. Se pueden aplicar etiquetas de datos
a los registros a travs de la aplicacin. Un uso comn para las etiquetas de datos es agrupar registros
para bsquedas o para directivas BPM que se puedan ejecutar cuando exista un cambio en los
registros. Revisar el captulo de bsquedas para ms informacin acerca de las etiquetas de datos.
Tipo de Directivas

Todos Ningno
Todos
Variables
directiva.
Public Clic este link para seleccionar tres valores:
Seleccionar public para remover los registros de
la directiva que se asignado etiquetas pblicas
P g i n a 49 | 104
Epicor 905.702a

otros.
SUPORTANDO MANEJO DE MULTIPLES REGISTROS ACTUALIZADOS DE FORMA COMBINADA
Un registro actualizado de forma combinada es un registro que se est modificando, pero no ha sido grabado
en la base de datos. Por ejemplo, cuando el usuario modifica un rengln, como el ingreso de un tipo de cambio
para una moneda, entonces se mueve a otro rengln (otro tipo de cambio), se modifica este, y entonces se
graba en 2 registros al mismo tiempo, esos dos renglones son llamados REGISTROS ACTUALIZADOS DE
FORMA COMBINADA
Algunos mtodos nicamente permiten procesar registros de uno a la vez, en ese caso no se soporta este tipo
de actualizaciones a los registros. Sin embargo, algunos mtodos pueden enviar actualizaciones a mltiples
registros al mismo tiempo como un conjunto de registros son actualizados en el servidor.
Cuando mltiples registros son enviados a un servidor en el mismo tiempo, se puede especificar una directiva
que tome accin en un conjunto de registros de manera especfica. Esas acciones estn disponibles tanto para
directivas de mtodo como para directivas de datos:
P g i n a 50 | 104
Epicor 905.702a
Una vez en todas las filas coincidentes (once passing all matching rows) - La accin se ejecuta una
vez que se mueve a travs de los datos dentro del conjunto de registros actualizados de forma
combinada.
Una vez que se cumple la condicin en todos los renglones existentes (once passing all existing
rows) - La accin se ejecuta una vez que se mueve a travs de los datos dentro del conjunto de
registros actualizados de forma combinada, y que comprueba todas las filas dentro del conjunto de
registros actualizados de forma combinada.
Para cada coincidencia (for each matching) - La accin se ejecuta por tantas veces como el nmero
de registros que coinciden con los criterios de seleccin en la zona de actualizacin de forma
combinada. Conjunto de registros para cada registro que se ejecuta individualmente.
Para cada uno existente (for each existing): la accin se ejecuta tantas veces como el nmero de
registro dentro del conjunto de registros actualizados de forma combinada (el nmero total de
registros). Cada registro se procesa individualmente.
DIRECTIVA DE COMPATIBILIDAD
Cada directiva debe ser compatible con la versin actual de la aplicacin Cuando una nueva versin es
instalada, el mdulo de BPM ejecuta rutinas que aseguren que las directivas podran estar trabajando como
se espera.
Para aprender ms acerca de las reglas especficas en el mdulo BPM utiliza una prueba de compatibilidad,
leer el tema de Compatibilidad de Directivas dentro de la ayuda de la aplicacin.
Una directiva debe ser seleccionado por compatibilidad a travs de tres situaciones:
Importar Directivas si la directiva es importada dentro de la aplicacin, el proceso de importacin

valida la compatibilidad de la directiva. Si no es compatible, un mensaje de error se despliega. Para
ms informacin acerca de este proceso leer la seccin de Importar Directivas en el Captulo: Utilerias
de BPM.
Service Packs - Cada vez que un service pack se instala, utilizar el programa de Herramientas de
Administracin para ejecutar la tarea del programa de conversin Validate BPM customizations of
business methods. Se puede hacer dando clic en el botn Run Conversion Program y entonces
seleccionar este programa desde la ventana del dialogo de conversin. Este programa analiza la firma
de cada mtodo para verificar si trabaja correctamente dentro de la directiva de mtodo actual,
directivas de datos y tabla de la base de datos. Si se detecta un problema de compatiblidadad, el
checkbox no estar activo en la pgina de detalle.
Patches cada vez que se instala un patch en su aplicacin, se necesita que manualmente ser
verifique la compatibilidad de todas las directivas. Para hacer que esto se ejecute a travs de la opcin
Validate Method desde el men de Actions.
P g i n a 51 | 104
Epicor 905.702a
CMO UTILIZAR EL PROGRAMA DE VALIDACIN DEL MTODO?
La ruta de acceso en el men principal es: System Management -> Business Process Management -> Setup -
> Method Directives
Para ejecutar el programa de Validacin de Mtodo:
1. Desde el men Actions, seleccionar Validate Method.
Si una de las directivas no es compatible, la palabra fuera de compatibilidad se despliega en la pgina de

detalle. Este valor es un estado asignado a la directiva.
Para corregir directivas incompatibles, se necesita ingresar a las directivas de mtodo o a las directivas de BAQ
Actualizable y revisar los mtodos o estructura de una tabla.
Para ayudar a localizar esas directivas, la bsqueda de mtodo y la bsqueda de la tabla se configuran para
nicamente buscar directivas no compatibles.
DIRECTIVAS DEPENDIENTES
Se pueden establecer relaciones entre las directivas creadas para los mismos mtodos de los objetos de
negocio. Esas relaciones son dependientes; si una directiva se ejecuta correctamente, la aplicacin se ejecuta
desde otra directiva. Esta primera directiva es llamada la Directiva Primaria, y viene desde la condicin de la
segunda, o depende de otra directiva. La directiva dependiente se aplica solamente a las directivas de
mtodos y no a las directivas de datos.
P g i n a 52 | 104
Epicor 905.702a
Utilizar directivas dependientes ayuda a prevenir errores. El apalancamiento de esta funcin cuando no se
puede actualizar un registro se enva un mail de confirmacin hasta estar seguro de que la transaccin se
complet exitosamente. Si una accin se ejecuta antes de una transaccin esto puede provocar un error en
los datos pero la accin se ejecuta de todas maneras. Por ejemplo: un email de confirmacin puede ser
enviado indicando que la transaccin se complet con xito, cuando realmente eso no ocurri. Si la condicin
para el mail, sin embargo, esta no es una directiva dependiente, para conocer de manera segura fue ejecutada
antes de que el mail se ejecutar.
Para hacer esto primero debemos crear una directiva primaria y entonces se generar una directiva
dependiente. Ambas directivas son creadas en el mismo mtodo.
DIRECTIVA PRIMARIA
La directiva primaria debe estar en un pre-processing o una directiva base processing. Despus de que se
defina la condicin para la directiva, se va a la ventana de acciones:
1. Clic en el botn nuevo de la barra de herramientas.

2. Clic en el campo User Text seleccionando en la lista enable dependent post process directives
como sentencia de la accin.
Esta accin indica que el resultado de la directiva primaria terminada con xito o terminada con error- se
pasa a otra directiva a travs del mismo mtodo.
DIRECTIVA DEPENDIENTE
Esta directiva debe ser una directiva post-processing. Para crear una directiva dependiente, se activa la
ventana de Condicones y se realiza lo siguiente:
1. Clic en el botn Nuevo en la barra de herramientas.

2. Clic en el campo User Text y seleccionando la sentencia this directive has been enabled from the
specified directive
P g i n a 53 | 104
Epicor 905.702a
3. Clic en el link specified para seleccionar el mtodo pre-processing o base processing. En este
ejemplo, the Condition Test to Remove Hold se seleccion.
Esta sentencia de la condicin indica que la aplicacin ejecuta las directivas de accin dependiente cuando
tanto la directiva se ejecuta exitosamente y las otras condiciones son dependientes.
CASO DE ESTUDIO
Esta seccin del documento explora algunos casos de estudio paso a paso. Cada caso de estudio explora un
diferente aspecto de la funcionalidad que se pueden generar dentro del mdulo BPM.
CASO 1: HACER UN CAMPO REQUERIDO
Se puede hacer que un campo sea mandatorio o requerido, a travs de las directivas de datos. Utilizando una
directiva que hace el campo requerido en el servidor, para que la aplicacin realiza de manera automtica el
cambio.
En este ejemplo, se puede hacer que el campo de Nmero de Telfono sea requerido para todos los registros
del cliente.
CREAR UNA DIRECTIVA DE DATOS
Ruta del Men Principal: System Management -> Business Process Management -> Setup -> Data Directives
Para crear la directive de datos:
1. Dar clic en el botn tabla.
2. En la ventana de Table Search despliega.

3. En el campo Starting At, se ingresa Customer.
4. Seleccionar la opcin Search by Table.
5. Clic Search.
P g i n a 54 | 104
Epicor 905.702a
6. En el grid Search Results, select Customer.

7. Clic en OK.
8. La tabla Customer dentro del campo Table.

9. Clic Save en la barra de herramientas.
P g i n a 55 | 104
Epicor 905.702a
CREAR UNA DIRECTIVA IN-TRANSACTION Y CONDICION
Para crear un directiva pre-processing que valida que el nmero telefnico:
1. Clic en la flecha Down Arrow en el botn Nuevo; selecciona New In-Transaction Directive. La
directiva debe estar in-transaction para que la transaccin puede detenerse antes de que el
registro se actualice sin que el nmero telefnico se ingrese incorrectamente.
2. La hoja In-Transaction > Detail despliega.

3. Ingresar el nombre de la directiva. Para este ejemplo, se ingresa Check Required Phone Number.
4. Dar Clic en el botn Conditions.
P g i n a 56 | 104
Epicor 905.702a
5. La ventana de Conditions despliega.

6. Clic en el botn Nuevo de la barra de herramientas.
7. Desde el campo User Text, selecciona the specified field of the changed row is equal to the
specified expression.
8. Identifica el texto en el campo del Error Text. Este indica que la condicin no est configurada
correctamente. Se selecciona con el puntero del mouse sobre ese campo, para que se despliegue por
completo el mensaje de error.
9. Dentro de la sentencia de la condicin, clic en el primer specified link.
10. En la ventana de Select Table Field (s) se despliega.
11. Desde la lista de Tablas, seleccionamos ttCustomer (tabla temporal).
12. Seleccionamos el checkbox para el campo PhoneNum.
14. Regresamos a la ventana de Condiciones. Donde se depliega el valor Customer.PhoneNum.
P g i n a 57 | 104
Epicor 905.702a
15. Clic en el segundo specified link.
16. La ventana para Specify an expression despliega.

17. Ingresar comillas dobles () en el campo Editor, que representan valore en blanco.
18. Dar clic en OK.
P g i n a 58 | 104
Epicor 905.702a
19. Regresamos a la ventana de Condiciones. Noten que la sentencia de la condicin despliega the
Customer.PhoneNum field of the changed row is equal to the expression
20. Tambin vean que el campo Error Text esta en blanco; esto significa que la condicin es correcta.
21. Clic OK.
CREAR LA ACCIN
Para definir la accin que haga el campo Phone Number requerido:
1. Clic en el botn de acciones.
P g i n a 59 | 104
Epicor 905.702a
2. La ventana de acciones despliega.

3. Dar clic en el botn New de la barra de herramientas.
4. Clic en la lista de User Text y seleccionar raise exception base don the designed template.
5. Dentro de la sentencia de accin dar clic en el link designed.
6. La venta de Design Exception Template despliega la siguiente informacin.

7. Ingresar el Nombre del mensaje de excepcin.
8. Ingresar el Texto a desplegar cuando se cumpla la accin. En este ejemplo, se puede ingresar Before
yo can sabe this customer record, you must enter a phone number.
9. Clic OK.
10. Al regresar a la ventana Acciones. Notando que se despliega raise exception base don the
RequiredPhoneNum template. Esto indica la accin que se ejecuta cuando la condicin se activa.
11. Clic en OK.
P g i n a 60 | 104
Epicor 905.702a
VALIDANDO LA DIRECTIVA
La directiva del mtodo est habilitada si esta activa. Para validar esta directiva:
La ruta del Men Principal: Sales Management > Order Management > Setup > Customer
1. Crear un Nuevo cliente. Dar clic en Nuevo en la barra de herramientas estndar, en el campo
Customer field, ingresar un Customer ID. En este ejemplo, ingresar DALCO.
2. Ingresar el nombre del cliente y seleccionar el Type.
3. Dejar el cmapo Phone en blanco.
4. Dar clic en Save.
5. El mensaje de error creado se despliega.

6. Dar clic en OK.
P g i n a 61 | 104
Epicor 905.702a
El mensaje de error est trabajando correctamente. Ahora los usuarios no pueden grabar un registro de
cliente nuevo hasta que ellos hayan ingresado el valor dentro del campo telfono.
VALIDANDO UN CAMPO DESDE OTRA TABLA
Se puede crear una directiva de mtodo que valide un campo contenido en una tabla diferente desde un
mtodo referenciado dentro del objeto de negocio. Durante este ejemplo, se va a crear una directiva de
mtodo que va permitir que un registro de proveedor se grabe nicamente si el valor Estado est ligado al
campo de la compaa; este valor se encuentra registrado dentro de una tabla definida por el usuario.
UTILIZACIN DE UNA TABLA DEFINIDA POR EL USUARIO
P g i n a 62 | 104
Epicor 905.702a
Para el siguiente ejemplo, primero se debe agregar una tabla definida por el usuario que los cdigos de Estado
y que estn ligados a la compaa actual dentro de la compaa. Para integrar una tabla definida por el usuario:
1. En el Campo Suplier State se liga a la tabla UD01.Key1 (Datasource.Datafield)

2. El campo Description es ligado a la tabla UD01.Key2 (DataSource.Datafield)
3. El campo Company es ligado a la tabla UD01.Company (DataSource.DataField)
Para que se aprenda a customizar e implementar tablas definidas por el usuario, revisar el tema Tablas
Definidas por el Usuario en el manual Epicor ICE User Experiencie and Customization Guide.
RECUPREANDO EL MTODO DEL OBJETO DE NEGOCIO
Cuando se tiene una tabla definida por el usuario y se ingresan los registros del estado, se est listo para crear
la directiva de mtodo que se referencie a este dato. Para crear esta directiva en el Mtodo Vendor.Update:
En el Men Principal: System Management -> Business Process Management -> Setup -> Method Directives
1. Clic en el botn Mtodo Code.
P g i n a 63 | 104
Epicor 905.702a
2. En el campo Starting At, ingresa U

3. Clic en el drop-down Business Object y selecciona Vendor
4. Clic Search
5. Desde la lista Search Results, selecciona la upcin Update.
6. Clic OK.
CREAR LA DIRECTIVA Y DEFINIR LA CONDICIN
1. Dar clic en Flechita hacia abajo que esta junto al botn New ; selecciona Pre-Processing.
P g i n a 64 | 104
Epicor 905.702a
2. Ingresa un Nombre para la Directiva (Directive Name). En este ejemplo ingresa Validate Suplier
State.
3. Clic en el botn de Condiciones (Conditions).
4. En la ventana Conditions se abre.

5. Clic en el botn New de la barra de herramientas.
6. Desde el campo User Text, selecciona number of rows in the designed query is not less than 1.
7. Clic en el link designed.
8. Se abrir la ventana Compose Query.
P g i n a 65 | 104
Epicor 905.702a
9. Ingresa el Nombre del Query (Query Name) para el desarrollo del query. En este ejemplo el nombre
ser ValidateState (importante, identificar que no tiene espacios ni caracteres Especiales y que es un
nombre corto, debemos considerar que es un nombre como el de un BAQ).
10. Ahora ingresamos el siguiente query:
for each ttVendor where(ttVendor.RowMod = U or ttVendor.RowMod = A),each UD01

whereUD01.Company =ttVendor.Company and UD01.key1 = ttVendor.State no-lock
La instruccin de consulta debe ser una Cadena, por lo que no agregue ningn retorno duro o
suave Entre las diversas partes de la frase. Tambin, No coloque una fecha al final dela
declaracin.
11. Para validar tu sintaxis, dar clic en el botn Check query.

12. Al terminar de ingresar el query, dar clic en el botn OK.
Este query esta escribo en una sintaxis valida de ABL. Para soportar un registro bloqueado, el
entorno de la aplicacin mantiene una copia del registro original y del registro actualizado. Estos
registros se envan cuando el mtodo UPDATE se ejecuta. Para identificar el registro Actualizado o
Agregado, es necesario que en el query se especifique el registro objetivo a travs de la columna
RowMod. Los valores validos de este campo son: A = Agregado, U= Actualizado y D= Borrado
13. La ventana
P g i n a 66 | 104
Epicor 905.702a
de Condiciones (Conditions) despliega ahora number of rows in the ValidateState query is not less
than 1
14. Ahora damos clic en el link is not less than.
15. Se abre la ventana Select a Comparison.

16. Seleccionar la opcin is less than.
17. Clic en OK.
P g i n a 67 | 104
Epicor 905.702a
18. La instruccin de la condicin ahora despliega the number of rows in the ValidateState query is
less than 1.
19. Clc OK.
CREAR LA ACCIN
Para crear la accin que ocurre cuando la condicin se cumple:
1. Clic en el botn Acciones (Actions)
P g i n a 68 | 104
Epicor 905.702a
2. Se abre la ventana Acciones (Actions).

3. Clic en el botn Nuevo para crear una nueva accin.
4. Desde el campo User Text, selecciona raise exception base don the designed template
5. Clic en el link designed
6. La ventana Design Exception Template se abre.

7. Ingresar el Nombre de la Excepcin (Name). En este ejemplo, se ingresar ValidateState.
8. Ahora ingresar el Mensaje que deseamos se despliegue. En este ejemplo ingresar Before you can
save this supplier record, complete the address by entering a Valid State or Province
9. Clic OK.
10. Regresamos a la venta acciones y ahora la sentencia despliega raise the exception base don the
ValidateState template.
11. Clic OK.
P g i n a 69 | 104
Epicor 905.702a
GRABANDO LA DIRECTIVA
Para completar la directiva del mtodo.
1. Verificar las Condiciones (Conditions) y las Acciones (Actions), verificando que desplieguen el texto
correcto.
2. Selecciona el check box Enabled.
3. Clic Save en la barra de herramientas estndar.
VALIDANDO LA DIRECTIVA
El mtodo de la directiva est habilitado, entonces est activa. Para validar la directiva del mtodo.
Men Principal: Material Management> Purchase Management > Setup > Supplier
1. Clic en el drop-down History para seleccionar Proveedor.

2. Navegar a la pestaa Supplier > Address.
3. En el campo State/Prov, ingresar un estado invalido. En este ejemplo, ingresar MH.
4. Clic Save.
P g i n a 70 | 104
Epicor 905.702a
5. El mensaje de error de la excepcin que hemos creado se desplegar.
Para corregir este error el usuario necesita ingresar un Estado o Provincia que sea correcto.
CREAR Y USAR UN TIPO DE RETENCIN
Para car una directiva de mtodo que agregue una retencin a los registros que cumplan con las sentencias
de las condiciones establecidas. Entonces debemos crear otra directiva de mtodo que valide si est retenido.
Si una retencin est presente la directiva del mtodo desarrolla ciertas acciones.
Tpicamente podemos utilizar esta funcionalidad para interceptar un mtodo antes de que se procese (a travs
de la directiva pre-processing) para evitar que el mtodo se ejecute en el proceso normal. Este tipo de
directivas de mtodo se llaman inhibitorias.
En este ejemplo, se va a crear una retencin en el Empleado de la Tienda. Esta retencin es utilizada con un
check box customizado dentro de la forma del Mantenimiento del empleado. Si el check box es seleccionado,
el empleado de la tienda no estar habilitado sin la aprobacin del supervisor.
CREAR UN TIPO DE RETENCIN

Para crear un nuevo tipo de retencin:
1. Navegar al Mantenimiento de Tipo de Retencin. El Men Principal: System Management>Business

Process Management > Setup > Hold Type
2. Ingresar un Tipo de Retencin. En este ejemplo se ingresa la retencin Supervisor Hold.
3. Clic en el botn Business Object para encontrar y seleccionar el objeto de negocio EmpBasic.
P g i n a 71 | 104
Epicor 905.702a
4. Ingresar una Descripcin (Description). En este ejemplo se va a ingresar Supervisor Hold.

5. Clic en el icono Grabar (Save) de la barra de herramientas.
CREAR UNA RETENCIN EN LA DIRECTIVA DE MTODO

Para crear una directiva de mtodo que llamar el nuevo tipo de retencin:
1. Para abrir el programa Method Directives. En el Men Principal: System Management > Business
Process Management > Setup > Method Directives
2. Clic en el botn de Mtodo Code para encontrar y seleccionar el mtodo EmpBasic.Update.
3. Clic Grabar (Save) en la barra de herramientas.
P g i n a 72 | 104
Epicor 905.702a
DIRECTIVA PRE-PROCESSING CREANDO UNA CONDICIN DE RETENCIN

Para crear una directiva pre-processing llama un tipo de retencin:
1. Clic en el icono de la flecha hacia abajo que est junto al botn Nuevo (New); selecciona New Pre-
Processing.
2. Ingresar el Directive Name. En este ejemplo, se puede ingresar Test to set Supervisor Hold.
3. Clic en el botn Condiciones (Conditions)
4. Abre la ventana Condiciones (Conditions).

5. Clic en el icono Nuevo (New) en la barra de herramientas.
6. Clic en el campo User Text seleccionar the specified field has been changed from any to any.
7. Clic en el link specified.
8. Se abre la ventana Select Table Field(s).

9. Clic en la lista drop-down de Table seleccionar ttEmpBasic.
P g i n a 73 | 104
Epicor 905.702a
Observa que las tablas que aparecen en la lista de seleccin tienen el prefijo tt. Esto indica que la tabla es
una tabla temporal. Esta tabla almacena los datos antes de que se escriban en la tabla fsica. Esto es para
asegurar que los datos sean vlidos antes de grabarse en la base de datos.
10. Selecciona el checbox junto a el campo CheckBox01. Este check box es el campo se utilizar para que
el Supervisor se retenga dentro de la pantalla de Mantenimiento a Empleados.
11. Clic en OK.
12. Al regresar a la venta de Condiciones, observa que la sentencia ahora se despliega: the
ttEmpBasic.CheckBox01 field has been changed from any to any.
13. Clic en el segundo link any.
14. Se abre la pantalla de Specify Value.

15. Ingresa un Valor en este ejemplo, se va ingresar True.
16. Clic Ok.
P g i n a 74 | 104
Epicor 905.702a
17. Al regresar a la ventana Condiciones.

18. Observa que la sentencia ahora despliega the ttEmpBasic.CheckBox01 field has been changed from
any to True.
19. Clic OK.
DIRECTIVA PRE-PROCESSING CREAR UNA ACCIN DE RETENCIN

Para agregar una accin que despliegue una directiva Post-Processing:
1. Clic en el botn Acciones (Actions).
P g i n a 75 | 104
Epicor 905.702a
2. Se abrir la ventana Acciones (Actions)

3. Clic en el botn Guardar(Save) de la barra de herramientas.
4. Clic en el campo User Text para seleccionar enable dependent post process directives.
5. Clic OK.
6. Al regresar a la ventana Method Directives.

8. Clic en el botn Save de la barra de herramientas estndar.
DIRECTIVA POST-PROCESSING CONFIGURAR LA RETENCIN PARA EL SUPERVISOR.

Para crear la accin que active esta condicin:
1. Clic en el icono de la flecha hacia abajo junto al icono Nuevo New; selecciona New Post Processing.
2. Ingresar un Nombre de la Directiva (Directive Name). Para este ejemplo ingresa Place Shop Employee
on Supervisor Hold.
3. Clic en el botn Condiciones (Conditions).
P g i n a 76 | 104
Epicor 905.702a
4. Abre la ventana Condiciones (Conditions).

5. Clic en el botn Nuevo (New) de la barra de herramientas.
6. Clic en el campo User Text para seleccionar this directive has been enabled from the specified
directive.
8. Al abrir la pantalla Select a primary directive to depend on.

9. Seleccionar el radio button Pre.
10. Clic en lista drop-down para seleccionar la Directive Test to set Supervisor Hold.
11. Clic OK.
P g i n a 77 | 104
Epicor 905.702a
12. Al regresar a la ventana de Condiciones (Conditions).

13. La sentencia de condiciones ahora despliega: this directive has been enabled from the Test to set
Supervidor Hold directive.
14. Clic OK.
DIRECTIVE POST-PROCESSING ACCIN DE LA RETENCIN AL SUPERVISOR

Para crear una accin para el nuevo tipo de retencin Retencin del Supervisor:
1. Clic en el botn de la Accin (Action).
P g i n a 78 | 104
Epicor 905.702a
2. Al abrir la ventana de Acciones (Actions).

3. Clic en el botn Nuevo (New) de la barra de herramientas estndar.
4. Clic en el campo User Text para seleccionar attach hold of the specified type.
6. Al abrir la venta Hold Attachment.

7. Clic en la lista Hold Type para seleccionar Supervisor Hold.
8. Clic OK.
9. Al regresar a la ventana Acciones.

10. Observa que ahora la accin despliega attach hold of the Supervisor Hold Type.
11. Clic Ok.
12. Al regresar a la ventana Method Directives.

14. Dar clic en el botn Grabar(Save) de la barra de herramientas estndar.
P g i n a 79 | 104
Epicor 905.702a
BLOQUEAR LA DIRECTIVA DE LA ACTIVIDAD DEL EMPLEADO
Para crear un mtodo que bloque el inicio de actividades de un empleado en una retencin de Supervisor:
1. Clic en el botn Clear de la barra de herramientas estndar.

2. Clic en el botn Method Code para encontrar y seleccionar el mtodo Labor.StartActivity.
3. Clic en el botn Guardar (Save).
DIRECTIVA PARA BLOQUEAR LA ACTIVIDAD DEL EMPLEADO AGREGAR CONDICIN

Para crear una directiva Pre-Processing que cheque el estado de la directiva de retencin del Supervisor:
1. Clic en el icono Flecha hacia abajo junto al botn Nuevo (New) seleccion New Pre-Processing.
2. Ingresar el Nombre de la Directiva (Directive Name). Para este ejemplo, se ingresar Block Start
Activity of Held Employee.
3. Clic en el botn Conditions.
P g i n a 80 | 104
Epicor 905.702a
4. Al abrir la ventana Condiciones (Conditions), despliega la siguiente informacin.

6. Clic en el campo User Text para seleccionar the hold of specified type is attached to the business
object.
7. Clic en el link specified type is attached to the business object.
8. En la ventan Select Business Objects.

9. En la vista de rbol, se expande: Labor> Objects, linked with the object labor > va LaborHed nodos
y selecciona EmpBasic.
10. Clic en la lista Hold Type, para seleccionar el tipo de retencin que tu creaste. En este ejemplo
selecciona Supervisor Hold.
11. Clic Ok.
P g i n a 81 | 104
Epicor 905.702a
12. Al regresar a la ventana Condiciones (Conditions).

13. Observa que el campo User Text despliega The hold of the Supervisor Hold type is attached to
the EmpBasic.
14. Clic Ok.
BLOQUEA DIRECTIVA DE LA ACTIVIDAD DEL EMPLEADO AGREGAR ACCIN

Para completar esta directiva del mtodo, se necesita agregar una accin que alerte al empleado de la tienda,
para que la retencin no permita que el empleado pueda tener actividad.

3. Clic en el campo User Text para seleccionar raise exception base don the designed template.
4. Clic en el link designed.
P g i n a 82 | 104
Epicor 905.702a
5. Al abrir la ventana Design Exception para ingresar el templete.

6. Ingresar el nombre de la excepcin. Para este ejemplo: ingresar Block Start Activity.
7. Ahora ingresar el mensaje de la excepcin. Para este ejemplo ingresar Please see your supervisor
to start this activity.
8. Clic OK.
9. Al regresar a la ventana de Acciones (Actions).

10. Observa que la accin ahora dice raise exception base don the Block Start Activity template.
11. Clic OK.
12. Al regresar a la venta Method Directives.

13. Selecciona el checkbox Enabled.
14. Clic en el botn Guardar (Save) de la barra de herramientas estndar.
P g i n a 83 | 104
Epicor 905.702a
CHECAR LA DIRECTIVA DE RETENCIN

Para crear una que cheque si la retencin del supervisor en el empleado de la tienda puede ser removida:
1. Clic en el botn Method Code para encontrar y seleccionar el mtodo EmpBasic.Update.

2. Clic en el icono flecha hacia abajo junto al icono Nuevo (New), seleccionar New Pre-Processing.
3. Ingresar el Directive Name. Para este ejemplo, ingresar la Condition Test to Remove Supervisor Hold.

6. Clic en el campo User Text para seleccionar the specified field of the changed row is equal to the
specified expression.
7. Clic en el primer link specified.
P g i n a 84 | 104
Epicor 905.702a
8. Se abre la ventana Select Table Field(s)

9. Desde la lista Table selecciona la opcin ttEmpBasic.
10. Clic el checkbox junto al campo CheckBox01.
11. Clic OK.
12. Al regresar al a ventana de Condiciones (Conditions).

13. Dar clic en el segundo link specified.
P g i n a 85 | 104
Epicor 905.702a
14. Se abre la ventana de Specify an expression.

15. Ingresar una expresin. En este ejemplo se ingresar False.
16. Clic OK.
17. Regresamos a la ventana de Condiciones.

18. Observa que ahora en el campo User Text es: the EmpBasic.CheckBox01 field of the changed row
is equal to the False expression.
19. Clic OK.
P g i n a 86 | 104
Epicor 905.702a
CHECAR DIRECTIVA DE RETENCION ACCIN

Para terminar, est directiva pre-processing, se necesita crear una accin que habilite el post-processing.
1. Dar clic en el botn Acciones (Actions).
2. Se abre la ventana de Acciones (Actions).

3. Dar clic en el botn Nuevo (New) de la barra de herramientas.
4. En el campo User Text para seleccionar enable dependent post process directives
5. Clic OK.
6. Regresamos al a ventana de Method Directives.

7. Seleccionamos el check box Enabled.
8. Damos clic en el botn Save de la barra de herramientas.
P g i n a 87 | 104
Epicor 905.702a
DIRECTIVA PARA REMOVER LA RETENCIN DEL SUPERVISOR

Para completar las directivas, se debe crear una directiva post-processing que remueva la retencin del
supervisor. El empleado de la tienda puede ejecutar una actividad seleccionada en el MES.
1. Clic en el icono Flecha hacia abajo junto al botn Nuevo (New); seleccionar New Post-Processing.
2. Ingresar el Nombre de la Directiva (Directive Name). Para este ejemplo se va ingresar Remove
Supervisor Hold.
P g i n a 88 | 104
Epicor 905.702a
4. Se abre la ventana Condiciones (Conditions).

6. Clic en el campo User Text para seleccionar this directive has been enabled from the specified
directive.
8. La pantalla Select a primary directive to depend on.

9. Seleccionamos el radio-botn: Pre.
10. Clic en la lista de Directive drop-down para seleccionar Conditions Test to Remove Supervisor Hold.
Esta opcin es la directiva pre-processing que se acaba de crear.
11. Clic OK.
12. Regresamos a la ventana Condiciones(Conditions).

13. Ahora el campo User Text despliega this directive has been enabled from the Condition Test to
Remove Supervisor Hold directive.
14. Clic OK.
P g i n a 89 | 104
Epicor 905.702a
DIRECTIVA PARA REMOVER LA RETENCIN DEL SUPERVISOR AGREGAR ACCIN

Para completar esta directiva se debe agregar la accin que remueve la retencin del supervisor.
2. Se abre la ventana Acciones (Actions).

3. Clic en el botn Nuevo (New).
4. Clic en el campo User Text para seleccionar remove holds of the specified type.
5. Clic en el link spefied.
6. Se abre la ventana Hold Removal.

7. Clic en la lista Hold Type para seleccionar: Supervisor Hold.
8. aClic OK.
P g i n a 90 | 104
Epicor 905.702a
9. Regresamos a la ventana Acciones (Actions).

10. Observa que el campo User Text ahora despliega remove holds of the Supervisor Hold type.
11. Clic OK.
12. Regresamos a la ventana Method Directives.

13. Seleccionar el check box Enabled.
14. Clic en Save de la barra de herramientas estndar.
P g i n a 91 | 104
Epicor 905.702a
PROBAR LAS DIRECTIVAS

Verificar el nuevo BPM de retencin y como se espera que trabaje.
Antes de probar estas directivas, se necesita customizar la pantalla Employee Maintenance. Se debe agregar
el check box Supervisor Hold.
1. Active el Developer Mode y abra la pantalla Employee Maintenance, La ruta del Men Principal:
Production Manangement > Job Management > Setup > Employee.
2. Clic en la opcin del men Tools > Customization para abrir la pantalla Customization Tools Dialog.
3. Agregar un nuevo check box en la forma Employee Maintenance.
4. Utilizar la propiedad EpiBinding para ligar el check box al campo CheckBox01.
5. Agregar la Etiqueta para desplegar el texto: Supervisor Hold.
6. Grabar la customizacin y salir Employee Maintenance.
Para aprender como customizar las pantallas forma, revisa el manual Epicor ICE User Experiencie
and Customization Guide. Para ms informacin acerca de como agregar un campo a una forma,
revisa el captulo Basic Customization. Para aprender como agregar una customizacin a una forma
desde el Men Principal, revisar el Captulo Customization Utilities.
7. Ahora abrimos la pantalla Employee Maintenance en modo ejecucin.

8. Clic en el botn ID para encontrar y seleccionar un empleado en el ejemplo, seleccionaremos Lisa V.
Ford.
9. Seleccionamos el checkbox Supervisor Hold. Este check box es el campo que customizamos
previamente.
10. Se graba el registro, dando clic en el botn Save de la barra de herramientas estndar.
P g i n a 92 | 104
Epicor 905.702a
11. Ahora abrimos el MES Menu.

12. Ingresamos el empleado de tienda que modificamos, empleado 104 Lisa V. Ford.
13. Clic en el botn Start Production Activity.
P g i n a 93 | 104
Epicor 905.702a
14. Se despliega el mensaje de excepcin. El usuario no puede generar ninguna actividad hasta que el
Supervisor Autorice su registro (limpiar el check box en el registro del empleado.
ASIGNAR DATOS DEFAULT PARA LOS REGISTROS DE UN BAQ ACTUALIZABLE
Las siguientes tareas se construyeron dentro de un BAQ Actualizable y los ejemplos de dashboards se cubren
en el manual de Epicor Ice Tools User Guide. El BAQ que vamos a utilizar es EPIC03-UpdateCustContacts y el
dashboard es Customer Contact Update (estos existen en el ambiente de DEMO de Epicor 905). Se pueden
revisar los ejemplos generados en el Captulo 4: Business Activity Queries y en el Captulo 7: Dashboards,
podemos nosotros recrear el BAQ Actualizable y el dashboard descrito en esos captulos para completar los
pasos detallados en esta seccin.
PUBLICANDO DATOS EN UN DASHBOARD
P g i n a 94 | 104
Epicor 905.702a
En este ejemplo, se quiere llenar la informacin de los contactos como es la direccin con la informacin del
cliente cuando el usuario crea un nuevo contacto dentro del dashboard Customer Contact Dashboard. La
primera parte del proceso es publicar la informacin de la direccin del cliente desde el Customer Contact
Update Dashboard.
1. En el Dashboard Tree View seleccionar zCustomer01:Customer Tracker Query.

2. Desde el men Edit, seleccionar Propiedades.
3. Se abre el programa de Dashboard Query Properties.

4. Seleccioanr la hoja Publish.
5. En la lista de Publish Columns, selecciona los check boxes que estn junto de las siguientes columnas:
Customer.Address1
Customer.City
Customer.State
Customer.Country
Customer.Zip
6. En el grid Call Context Subscriber dar clic en Nuevo (New).
7. Desde el Publish Column selecciona Customer.Address1.
8. En el BPMDataColumn, selecciona Character01.
9. Agregar las columnas remanentes de la direccin, desde el grid Call Context Subscriber utilizando la
siguiente informacin.
Customer.City = Character02
Customer.State = Character03
Customer.Country = Character04
P g i n a 95 | 104
Epicor 905.702a
Customer.Zip = Character05
10. Clic OK para Grabar.
OBTENER LOS MTODOS DEL BAQ ACTUALIZABLE

Para localizar los mtodos utilizados por un BAQ Actualizable:
1. Abre el programa desde la ruta del Men Principal: System Management > Business Process
Management > Updatable BAQ Method Directives.
2. Clic en el botn BAQ ID para encontrar y seleccionar el BAQ ID. Se puede ingresar tambin la directiva
del BAQ ID.
P g i n a 96 | 104
Epicor 905.702a
3. Si se da clic en el botn BAQ ID, le programa Updatable BAQ Search se abre. Utilizar este programa
para localizar el BAQ donde se quiere aplicar una directiva. En este ejemplo, para crear una directiva
para el EPIC03-UpdateCustContactsBAQ, ingresar EPIC03-U en el campo Starting At para desplegar
los resultados.
4. Clic en el botn Search.
5. En el grid Search Results se despliegan todas las tablas que coinciden con el criterio de bsqueda. En
este ejemplo, se van a seleccionar las 4 opciones para EPIC03-UpdateCustContacts.
6. Clic OK.
7. El Tree View despliega los mtodos para el BAQ Actualizable.

8. En la pestaa de detalle despliega la principal informacin en el mtodo del BAQ seleccionado.
Se puede revisar el cdigo ABL utilizado por el BAQ para actualizar la base de datos, seleccionando el
mtodo Update en el Tree View, navegando a el Base Processing Tab y revisarn el execute ABL /* Update
Procedure */ action.
P g i n a 97 | 104
Epicor 905.702a
NUEVA DIRECTIVA POST-PROCESSING

Ahora podemos agregar una directiva al BAQ Actualizable. En este ejemplo, la directiva podra llenar la
direccin default para los contactos cuando el usuario cree un nuevo contacto utilizando el dashboard Update
Customer Contact Dashboard. Estas directivas utilizan la informacin publicada desde el dashboard al ser
asignados los valores en el nuevo registro agregado.
Para crear una nueva directiva:
1. En el Tree View de las directivas del Mtodo del BAQ Actualizable, seleccionar EPIC03-
UpdateCustContacts.GetNew.
2. Clic en el icono Flecha hacia abajo junto al botn Nuevo, seleccionar New Post-Processing.
3. Ingresar el Nombre de la Directiva para que se pueda identificar. En este ejemplo, ingresa Auto
Populate Contact Address.
P g i n a 98 | 104
Epicor 905.702a
5. Se va directamente al botn de Acciones (Actions) porque se desea que en cada registro nuevo se
detone automticamente la accin.
7. Clic en el campo User Text de la lista set the sepecified field of the changed row to the changed
row to the specific expression with rule.
9. La ventana Select Table Field(s) despliega la siguiente informacin.

10. Clic en la lista drop-down de Table para seleccionar ttResults.
11. En grid Fields , selecciona el check box junto a CustCnt_Address1
12. Clic OK.
P g i n a 99 | 104
Epicor 905.702a

14. En el campo User Text ahora presenta set the Results.CustCnt_Address1 field of the changed row
to the specific expression with rule
15. Clic en el link the changed row.
16. La ventana Select a Row Set.

17. Selecciona the added row
18. Clic OK.

20. El campo User Text ahora presenta set the Results.CustCnt_Address1 field of the added row to
the specific expression with rule.
21. Clic en el link specific.
P g i n a 100 | 104
Epicor 905.702a
22. La caja de dialogo de Specify an expression.

23. En la vista Tree View Available variables, expande el nodo ttCallContextBmpData.
24. Dar doble-clic en el campo Character01. El editor de campos despliega
ttCallContextBpmData.Character01.
25. Clic OK.
26. Al regresar a la ventana Acciones (Actions).

27. En el campo User Text ahora aparece set the Results.CustCnt_Address1 field of the added row to
the ttCallContextBpmData expression with the rule. Ahora la accin esta configurada para que
cada que se agregue un Nuevo renglon en el valor publicado desde el dashboard el campo
Character01 tome la direccin del cliente que es el Address1
P g i n a 101 | 104
Epicor 905.702a
28. Continua ahora agregarndo en User Text los campos remanentes publicados desde el dashboards.
29. Clic OK.
30. Regresamos a la ventana de Updatable BAQ Method Directives.

31. Las acciones creadas se despliegan en el campo Acciones (Actions).
32. Seleccionamos el check box Enabled.
33. Clic en el botn Save de la barra de herramientas estndar.
PROBANDO LA DIRECTIVA
Para probar la directiva:
P g i n a 102 | 104
Epicor 905.702a
1. Abrir el programa de Dashboards para Customer Contact Update. En el men principal: Executive
Analysis > Business Activity Management > General Operations > Dashboard.
2. Desde el menu Tools, selecciona Deploy Dashboard. El ID del Dashboard es CustContactUpdate.
3. La pantalla de Deploy Dashboard despliega.

4. Clic en el botn Test Application.
P g i n a 103 | 104
Epicor 905.702a
5. El dashboard despliega.
6. Dar clic en el botn Refresh en la barra de herramientas estndar para recuperar los datos del cliente.
7. En el grid del Customer Tracker Query, seleccionar un registro del cliente.
8. En el grid del Customer Contacts, clic en un rengln. El botn Nuevo (New) en la barra de
herramientas esta disponible.
9. Dar clic en el botn Nuevo (New).
10. Un nuevo registro es agregado a el grid Customer Contacts. La informacin de la direccin se agrega
en base a la direccin del cliente.
P g i n a 104 | 104

BASMéxico BPMManual Basico

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

BASMéxico BPMManual Basico

Uploaded by

Copyright:

Available Formats

Business

Business process management (BPM) ............................................................................................................... 2

BUSINESS PROCESS MANAGEMENT (BPM)

ELEMENTOS BASE DE UN BPM

A continuacin, se explican los elementos base:

Esta seccin explica que se necesita para instalar y configurar BPM.

INSTALACION DE SERVIDOR BPM

MICROSOFT MESSAGE QUEUING

Para dar a un usuario especfico los accesos al nivel avanzado de BPM:

1. Seleccionar un usuario especifico en la pestaa Detail.

MANTENIMIENTO DE TIPOS DE RETENCION (HOLD TYPE MAINTENANCE)

CMO USAR EL MANTENIMIENTO DE TIPO DE RETENCIN?

Para crear un Nuevo tipo de retencin:

1. Clic en el botn New en la barra de herramientas Estndar.

CMO UTILIZAR LAS RETENCIONES BPM?

Para colocar una orden de venta en retencin:

8. El campo Description despliega una explicacin opcional del tipo de retencin.

REVISANDO LAS RETENCIONES BPM

Para revisar una retencin BPM:

1. Un usuario detona una accin en el programa.

DIRECTIVAS DE LOS METODOS PARA LOS BAQ ACTUALIZABLES

GetList recupera los datos especficos en la consulta.

CREANDO UNA NUEVA DIRECTIVA

LOCALIZANDO EL OBJETO DE UNA DIRECTIVA

2. La pestaa Pre-Processing > Detail se activa.

3. Ingresa el Nombre de la Directiva para utilizar en el momento de identificar la directiva. Se puede

6. El campo Owner Company despliega la compaa en la cual se cre la directiva.

14. Al termino dar clic en el botn Save de la barra de herramientas estndar.

Para crear y definir las instrucciones de la condicin:

2. La ventana de Conditions despliega.

12. La ventana de Specify an expression despliega.

14. Damos clic en OK.

15. Al regresar a la pantalla de condiciones, notamos que la instruccin despliega: The

Or: se cumple la direccin si se cumple una instruccin u otra.

Se pueden ingresar ms de un parntesis en el prefix y en el postfix. Se pueden crear las instrucciones

23. La ventana de Source Code despliega.

27. Cuando regresamos a la pantalla de directivas de datos, la condicin se despliega en el campo

1. Clic en el botn Actions.

2. Nos abrir la pantalla de Actions (Acciones).

6. En la venta del Templete (Formato) de Design Exception.

16. La ventana de Source Code.

CONDICIONES Y ACCIONES LA LISTA COMPLETA

Mtodo Dato Actualizable BAQ

Mtodo Dato Actualizable BAQ

Designed Clic en el link para que abra el programa para

Mtodo Dato Actualizable BAQ

Specified Clic en el link para abrir el programa que nos

Mtodo Dato Actualizable BAQ

Is called Clic en este link para ejecutar el programa de

Mtodo Dato Actualizable BAQ

Belong Clic en este link para ejecutar el programa de

Mtodo Dato Actualizable BAQ

Mtodo Dato Actualizable BAQ

specified Clic en este link, para abrir el programa Specify

Mtodo Dato Actualizable BAQ

Specified (field) Clic en este link para abrir el programa Select

definido por el usuario que este dentro de la

Mtodo Dato Actualizable BAQ

updated Clic este link para abrir el programa Select a

programa para seleccionar una tabla ligada a la

Mtodo Dato Actualizable BAQ

specific Clic este link para que abra el programa Select

Mtodo Dato Actualizable BAQ