Está en la página 1de 105
Business Process Management Básico Epicor 905.702a
Business
Process
Management
Básico
Epicor 905.702a
Business Process Management – Manual Epicor 905.702a CONTENIDO

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 retención

71

Asignar datos Default para los registros de un baq actualizable

94

Publicando datos en un dashboard

94

Obtener los Métodos del BAQ Actualizable

96

Nueva directiva Post-Processing

98

Probando la directiva

102

P á g

i

n

a

1 | 104

Business Process Management – Manual Epicor 905.702a BUSINESS PROCESS MANAGEMENT (BPM)

Business Process Management – Manual Epicor 905.702a

BUSINESS PROCESS MANAGEMENT (BPM)

El módulo de BPM (Business Process Managment) es un conjunto de herramientas que se utilizan para modificar y ampliar la funcionalidad de la aplicación sin tocar el código 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 transacción. Existen tres tipos de directivas disponibles:

Directivas del Método (Method Directives) – aplicada a los métodos 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 métodos que permiten la actualización de las consultas de la actividad del negocio.

Utilizar las herramientas BPM para agregar o cambiar los procesos de la aplicación cuando se ejecuta un método de los objetos del negocio, cuando una transacción se aplica a una tabla o cuando la información es recuperada o procesada a través de una consulta de la actividad del negocio (Business Activity Query – BAQ). Se pueden crear directivas que primero se evalúen antes de que los datos se procesen, si se cumplen las condiciones, se llevan a cabo una o más acciones.

Este documento primero explora los elementos base de un BPM y explica el proceso de configuración del módulo 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 guía para desarrollar nuestros propios BPMs. Adicionalmente explicamos la customización de los BPMs y sus utilerías.

ELEMENTOS BASE DE UN BPM

A continuación, se explican los elementos base:

Directivas de Métodos (Method Directives) - las directivas de los métodos inician acciones basadas en BPMs y se aplican en determinadas llamadas dentro de los objetos de negocio. Un objeto de negocio contiene el código que corre en un proceso de negocio. Las acciones BPM pueden ser condicionadas antes, después o durante la ejecución de un método 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 específica. Una directiva puede ser ejecutada durante una transacción de datos, la cual puede afectar la información ingresada en la base de datos, o esta puede ejecutarse posterior a que la transacción sea ingresada a la tabla.

Directivas de los BAQ Actualizables (Updatable BAQ Directives) – inician acciones de los BPMs basadas en los métodos que se llaman al actualizar un BAQ. Un BAQ actualizables es una consulta customizada que se despliega en el cliente para actualizar información de tablas de Epicor; se consideran procesos de negocio porque se ejecutan al momento de actualizar un BAQ. Estas pueden ejecutarse antes, después o durante la actualización de un BAQ.

P á g

i

n

a

2 | 104

Business Process Management – Manual Epicor 905.702a • Retenciones (Hold) – se utilizan los BPMs

Business Process Management – Manual Epicor 905.702a

Retenciones (Hold) – se utilizan los BPMs de retención que definen un evento de retención externa ligado a un proceso de negocio el cual se activa a través de una acción del BPM. Las directivas del BPM pueden ser creadas desde otro objeto del negocio y los métodos pueden evaluar si existen retenciones y ello puede modificar los procesos de negocio como se necesiten. Las retenciones de BPM aumentan las retenciones estándar que se generan dentro de la aplicación. Se pueden definir y evaluar con condiciones propias dentro de los procesos de flujo de negocio.

Diseñador de Formas de Datos (Data Form Designer) – utilizar el diseñador de formas de datos para crear pantallas que se activen de forma automática a través de las directivas de procesos. Las pantallas de captura de datos de un BPM o acciones que se detonan a través de un botón 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 específicos que se requieren en una transacción.

BPM SETUP

Esta sección 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 código) y realizar depuraciones avanzadas de código o registro de la aplicación. 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 aplicación.

Para conocer como instalar el Servidor BPM y el MSMQ, revisa la Guía de Instalación de Epicor.

MANTENIMIENTO DE USUARIOS

Existen niveles de funcionalidad de BPM disponibles – un nivel básico y un nivel avanzado. Todos los usuarios tienen acceso a BPM y pueden usar el nivel básico 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 métodos y ejecutarlas desde los métodos base, estos usuarios pueden trabajar con Epicor o cualquier partner antes de modificar procesos base.

Se pueden dar accesos específicos para la funcionalidad avanzada a través del mantenimiento a usuarios. Esos accesos son asignados en la pestaña de seguridad.

P á g

i

n

a

3 | 104

Business Process Management – Manual Epicor 905.702a Ruta de Acceso desde el menú principal: System

Business Process Management – Manual Epicor 905.702a

Ruta de Acceso desde el menú principal: System Management -> Company Maintenance -> User

Para dar a un usuario específico los accesos al nivel avanzado de BPM:

1. Seleccionar un usuario especifico en la pestaña Detail.

2. Clic en la pestaña de Options.

3. En la sección Tools Options, seleccione la opción BPM Advanced User.

4. Dar clic en Save de la barra de herramientas Estándar.

Este usuario puede utilizar ahora las funciones avanzadas del BPM.

4 1 2 3
4
1
2
3

RETENCIONES

Una retención es una bandera activada en un registro; esto indica que el registro podría no ser procesado hasta que se revise y se apruebe. Una retención por sí misma no desarrolla cualquier acción. Para definir las acciones se deben crear directivas las cuales se definirán a través de manejador de registros que tiene que se colocadas en retención. Una retención se puede ligar a un registro de dos maneras:

Manualmente: se puede manualmente ligar una retención dentro de un campo que utiliza el programa BPM de retención. Se puede invocar el programa BPM de retención desde el menú de contexto. Este agrega un registro de retención. Para utilizar esta funcionalidad, primero se debe

P á g

i

n

a

4 | 104

Business Process Management – Manual Epicor 905.702a haber definido una retención desde el Mantenimiento de

Business Process Management – Manual Epicor 905.702a

haber definido una retención desde el Mantenimiento de Tipo de Retención (Hold Type Maintenance); este programa será explorado más adelante.

Automáticamente:

una retención también puede ser aplicada a un registro utilizando una

directiva de acción. Esta retención puede ser activada antes, durante o después del proceso de negocio. Normalmente se utiliza la retención para interrumpir un proceso de los objetos de negocio.

Esta retención 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 Método

o Mantenimiento de las Directivas de Datos. Esto se explicará con mayor detalle más adelante.

MANTENIMIENTO DE TIPOS DE RETENCION (HOLD TYPE MAINTENANCE)

Utilizar el mantenimiento de los tipos de retención para crear, mantener y borrar los tipos de retención. Utiliza este programa para definir todas las retenciones que se pueden utilizar dentro de la aplicación. Después de que se haya realizado la configuración de las retenciones que se necesitan en este programa, se pueden activan desde esta misma pantalla o a través de las acciones en las directivas.

Un tipo de retención es básicamente un estado a asignar a un registro, esto no previene que el registro sea procesado. Para que los tipos de retención actualmente sirvan para prevenir que los registros sean procesados, se necesita crear una directiva de método. En la sección de casos de estudio se explica cómo se implementará esta funcionalidad

También se puede utilizar este programa para revisar donde se encuentran las retenciones utilizadas, así como el registro histórico de cada tipo de retención.

¿CÓMO USAR EL MANTENIMIENTO DE TIPO DE RETENCIÓN?

En la ruta del Menú Principal:

Type

System Management -> Business Process Management -> Setup -> Hold

Para crear un Nuevo tipo de retención:

1. Clic en el botón New en la barra de herramientas Estándar.

2. Ingresa el Hold Type para la retención. Este valor es un nombre corto que nos permita identificar a través de los objetos de negocio el tipo de retención. En este ejemplo: Sales Order es ingresado como

el nombre del tipo de retención.

3. Clic en el botón Business Object para encontrar y seleccionar el objeto de negocio en el cual se desea

agregar la retención. En este ejemplo: se selecciona el objeto de negocio Sales Order.

4. Ingresar una Description para la retención que nos permita identificar su funcionalidad. Es un valor opcional, utilizado para este campo para agregar más detalles que nos ayuden a identificar la retención.

P á g

i

n

a

5 | 104

Business Process Management – Manual Epicor 905.702a 5. El campo History Length define cuantos registros

Business Process Management – Manual Epicor 905.702a

5. El campo History Length define cuantos registros deberán aparecer en la pestaña Hold Usage History. Cuando el registro alcanza este número, los viejos registros son automáticamente borrados.

6. Clic en el botón Save. Para guardar este tipo de retención y esté disponible para utilizarse.

7. La pestaña Hold Usage despliega las retenciones actuales de los registros que han sido seleccionados en registros específicos; utiliza esta pestaña para administrar los registros que actualmente están retenidos. Si se requiere, se puede seleccionar un registro en el clic y utilizar el botón de borrado para eliminar la retención de un registro.

8. La pestaña de Hold Usage History despliega los registros de cada momento en que una retención se ha utilizado – cuando fue agregado un registro, quien lo agrego, cuando se eliminó la retención y todo lo relacionado. El número máximo de registros que pueden aparecer en la pestaña de Hold Usage History esta pestaña está definida por el valor de largo de la historia del tipo de retención.

6 8 7 1 2 3 4 5
6
8
7
1
2
3
4
5

RETENCIONES BPM

Utilizar el programa de Retenciones BPM para ligar automáticamente una directiva de retención a un registro. También podemos eliminar una retención que se generó anteriormente.

¿CÓMO UTILIZAR LAS RETENCIONES BPM?

P á g

i

n

a

6 | 104

Para colocar una orden de venta en retención: Business Process Management – Manual Epicor 905.702a

Para colocar una orden de venta en retención:

Business Process Management – Manual Epicor 905.702a

1. Navega a Ingreso de Ordenes de Venta. En Menú Principal: Order Management -> Sales Management -> General Operations -> Sales Order Entry

2. Clic en el botón de Sales Order para encontrar y seleccionar la orden de venta que se quiere retener.

3. Selecciona BPM Holds.

No todos los menús 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 retención se puede colocar en este campo.

1 3 2
1
3
2

4. El programa de BPM Holds despliega, en la Vista de Árbol, selecciona el tipo de retención que se desea utilizar. En este ejemplo se selecciona la retención Sales Order.

5. Clic New en la barra de herramientas estándar.

6. La retención ha sido creada para este registro, los diferentes campos se llenarán de forma automática. El campo Business Object despliega el nombre del objeto de negocio utilizado para esta retención. En este ejemplo, despliega el objeto SalesOrder.

7. El Tipo de Retención despliega la retención que habíamos creado en el mantenimiento de Tipo de Retención. En este ejemplo, el registro despliega Sales Order.

P á g

i

n

a

7 | 104

Business Process Management – Manual Epicor 905.702a 13 6 5 7 4 8 9 10

Business Process Management – Manual Epicor 905.702a

13 6 5 7 4 8 9 10 11 12
13
6
5
7
4
8
9
10
11
12

8. El campo Description despliega una explicación opcional del tipo de retención.

9. El campo Creation date despliega la fecha en la que se anexo la retención al registro.

10. El campo Creation time despliega el tiempo en el cual se creó la retención.

11. El campo Creation by despliega el usuario que generó la retención.

12. El campo Comment nos permite ingresar información adicional de porque generamos la retención. Es el único campo que permite edición dentro de la pantalla y es porque es la razón por la cual se genera la retención.

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 retención. Colocar una retención en un registro no evita que este pueda ser procesado. La retención realmente es una nota agregada al registro. Está nos permite dar seguimiento a los diferentes registros que tienen un tipo de retención. Se puede ingresar a los registros para hacer los cambios necesarios.

Actualmente se utilizan los tipos de retención en registros específicos que han sido procesados, se necesita crear una directiva que haga esto. En la sección Casos de Estudio explicaremos como se realizará esta funcionalidad.

P á g

i

n

a

8 | 104

Para revisar una retención BPM: Business Process Management – Manual Epicor 905.702a 1. Navegar a

Para revisar una retención BPM:

Business Process Management – Manual Epicor 905.702a

1. Navegar a Hold Type Maintenance. En el Menú Principal: System Management -> Business Process Management -> Setup -> Hold Type.

2. Utilizar la pestaña detalle para encontrar y seleccionar el tipo de retención. En este ejemplo, seleccionamos el tipo de retención Sales Order.

3. Clic en la pestaña Hold Usage.

4. En el grid Hold Type Usage despliega todos los registros en los cuales el tipo de retención esta actualmente activo.

1
1

Utilizar esta información para hacer los cambios que se necesiten realizar. En esta sección se puede realizar cualquier cambio manualmente en cada registro listado en el grid.

P á g

i

n

a

9 | 104

Business Process Management – Manual Epicor 905.702a DIRECTIVAS

Business Process Management – Manual Epicor 905.702a

DIRECTIVAS

Una directiva se define como un conjunto de condiciones y acciones asociadas con una transacción de datos. Las directivas se detonan desde el método de un objeto de negocio, un método 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 aplicación son controladas por los objetos de negocio. Un objeto de negocio representa un tipo de datos administrado por la aplicación, puede ser: clientes, partes o órdenes de venta. Los objetos contienen métodos que desarrollan una tarea específica. Por ejemplo: el método Customer.Update valida y procesa los registros de clientes en la base de datos.

Las herramientas BPM pueden manipular los diversos métodos antes, durante y después de las transacciones en la base de datos. Se pueden crear directivas de métodos que primero evalúen los datos que se han de procesar y entonces las condiciones de las directivas generen una o más acciones basadas en estos datos – como pueden ser mensajes desplegados, validación de datos ingresados, invocación de otros procesos de negocio, entre otros.

Las directivas de métodos BPM trabajan interceptando comunicaciones entre el cliente o los servicios WEB y el servidor lógico de aplicaciones. Se pueden validar, manipular o crear flujos de trabajo basados en los datos pasados a través de la aplicación. Porque ellos están en la parte de la customización la cual puede cambiar la lógica del negocio sin modificar el código fuente original. Por esta razón, las actualizaciones al código original podrían no afectar las directivas existentes de BPM.

Cuando un método de objeto de negocios es llamado, todas las directivas asociadas con el método activo. Si las condiciones dentro de la directiva se cumplen, las acciones contenidas se ejecutan.

Mientras el método este activo, esas directivas se pueden ejecutar en tres puntos diferentes:

Pre-Processing: estas directivas se ejecutan antes de que el método base sea generado. Después que estas acciones terminan, los objetos de negocio ejecutan el método base.

Base Processing: estas directivas se ejecutan en lugar del proceso base. El proceso base no se ejecuta.

Post-Processing: estas directivas se ejecutan después de que el método 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 críticos en la aplicación. Se recomienda trabajar con un consultor de Epicor este tipo de directivas.

P á g

i

n

a

10 | 104

Business Process Management – Manual Epicor 905.702a Por ejemplo, se puede crear una directiva de

Business Process Management – Manual Epicor 905.702a

Por ejemplo, se puede crear una directiva de método para el método CUSTOMER.UPDATE que envié un mail al Gerente de Ventas cuando el límite de crédito del cliente es cambiado. Esta misma directiva puede ser también anexada a una retención del cliente y desplegar un mensaje que indique que el registro del cliente ha sido colocado en retención. Ambas acciones son generadas durante el proceso posterior, al proceso base.

En la siguiente gráfica presentamos como trabajan las directivas de los métodos dentro de la aplicación:

1. Un usuario detona una acción en el programa.

2. El programa llama un método del objeto de negocio que detona la acción.

3. Antes que el objeto de negocio ejecute este código del programa ABL, se debe ejecutar una directiva Pre-Processing.

4. Después que la directiva Pre-Processing, el programa ABL genera esta función. Si la directiva del proceso base tiene efecto, la directiva del Proceso base podrá corre con base en el código del programa ABL.

base podrá corre con base en el código del programa ABL. 5. Después el código del

5. Después el código 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 método dentro del Mantenimiento de las Directivas de Métodos.

Ruta del Menú Principal:

Directives.

System Management -> Business Process Management -> Setup -> Method

P á g

i

n

a

11 | 104

Business Process Management – Manual Epicor 905.702a DIRECTIVAS DE DATOS

Business Process Management – Manual Epicor 905.702a

DIRECTIVAS DE DATOS

Una directiva de datos es similar a una directiva de método, donde la diferencia radica en que una directiva de método se detona desde un método 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 información. Al momento de aplicar una directiva a una tabla específica, estas son usadas para controlar los datos que puedan afectar múltiples objetos de negocio.

Se pueden aplicar tanto condiciones y acciones a las directivas de métodos como a las directivas de datos, excepto en los casos en donde la condición o acción depende de la información disponible en el objeto de negocio que no está activo dentro de la misma. Dos tipos de directivas de datos están 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 múltiples registros – los registros que contienen los datos no se han salvado en la base de datos. La afectación a múltiples registros será explicada más adelante.

Standard: esta no afecta datos en la base de datos. Esta directiva se ejecuta después de que una transacción es grabada en la base de datos. Este tipo de directiva procesa múltiples registros. Esta directiva se ejecuta después de los métodos base y las directivas de métodos.

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 métodos para los BAQ Actualizables son similares a las directivas de métodos descritas anteriormente, excepto que estos métodos se aplican específicamente a los BAQ actualizables, consultas customizadas para crear un ingreso de datos. Cada BAQ Actualizable tiene los siguientes métodos:

GetList – recupera los datos específicos en la consulta.

GetNew – crea un nuevo registro para ser ingresado y registrado en la base de datos.

RunCustomAction – ejecuta una acción BPM customizada la cual se define tanto a través del BAQ y la funcionalidad BPM. Primero se define el ID de la acción customizada en el programa de diseño de los BAQ y entonces se define la acción que se utilizará en una o más 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 métodos 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

Business Process Management – Manual Epicor 905.702a Cuando se crea un BAQ actualizable, la aplicación

Business Process Management – Manual Epicor 905.702a

Cuando se crea un BAQ actualizable, la aplicación escribe una directiva de proceso base para el método de actualización. Esta directiva utiliza código ABL para actualizar la base de datos en base a las configuraciones definidas en el diseñador de BAQ. Se puede editar este código para customizar el proceso de actualización o se pueden agregar directivas: pre-processing, base processing y post-processing a los métodos asociados con el BAQ.

SE pueden desarrollar Directivas de Métodos para BAQ Actualizables en dos formas: clic en el botón de Define Custom Actions de Actualizar > en la pestaña de propiedades generales dentro del programa de diseño de BAQ o a través 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 Diseño de los BAQ para definir el código de acción (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 método de los BAQ Actualizables, se pueden crear directivas: pre-processing, base processing o post-processing para ejecutar el método RunCustomAction. Utiliza la sentencia: “the specified argument is equal to the specified expression” para identificar cual acción 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 acción que permiten desarrollar las acciones customizadas.

CREANDO UNA NUEVA DIRECTIVA

Este ejemplo presenta como se crea una directiva de método, pero el proceso es el mismo para todos los tipos de directivas. En la sección de casos de estudio veremos la creación de más directivas.

LOCALIZANDO EL OBJETO DE UNA DIRECTIVA

Las directivas son creadas para métodos de objetos de negocio, tablas o métodos 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 botón Method Code. Para crear una directiva de datos clic en el botón Table o ingresar el nombre de la tabla. Para crear una directiva de método para un BAQ actualizable, dar clic en el botón BAQ ID o ingresar el BAQ ID.

P á g

i

n

a

13 | 104

Business Process Management – Manual Epicor 905.702a 3. El programa Method Search se despliega. Utiliza

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a 3. El programa Method Search se despliega. Utiliza este

3. El programa Method Search se despliega. Utiliza este programa para localizar un método específico dentro de un objeto de negocio. Por ejemplo: si se desea crear una directiva de método para CurrExRate.Update. Debemos, en el campo Starting At, ingresar “U”

4. Seleciconar la opción Search by Business Object. Este indica que la búsqueda se realizará sobre un objeto específico.

5. Ahora selecciona el Business Object para el que se requiere hacer la búsqueda. En este ejemplo, se seleccionará el objeto de negocio CurrExRate.

6. Identifica que también se puede seleccionar Search by Directives. Esta opción es utilizada para encontrar y seleccionar directivas de método existentes.

7. Cuando se selecicona la opción 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 sección de Pre-Processing que se encuentra más adelante.

8. Se pueden también seleccionar Search outdated Directives Selecciona esta opción para localizar cualquier directiva de métodos que sea incompatible con la versión actual. Para conocer con mayor detalle la Compatibilidad de las Directivas, revisa este tema con más detalle en la sección Compatibilidad de Directivas.

9. Clic en Search

P á g

i

n

a

14 | 104

Business Process Management – Manual Epicor 905.702a 10. El grid Search Results despliega todos los

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a 10. El grid Search Results despliega todos los métodos

10. El grid Search Results despliega todos los métodos para el objeto de negocio que inicien con “U”. En este ejemplo, se marca la opción Update.

11. Clic en OK.

12. En la pestaña de Detail ahora se despliega la principal información del método seleccionado.

13. El campo de Method Code despliega el método del objeto de negocio que se ha seleccionado. Se pueden agregar y editar directivas para este método. En el ejemplo se selecciona el método CurrExRate.Update.

14. Si es necesario ingresar una Method Description.

se selecciona el método CurrExRate.Update. 14. Si es necesario ingresar una Method Description. P á g

P á g

i

n

a

15 | 104

Business Process Management – Manual Epicor 905.702a 15. La lista Transaction Scope define como la

Business Process Management – Manual Epicor 905.702a

15. La lista Transaction Scope define como la aplicación manejará los errores. Las opciones disponibles son:

Business Method and Directives: aplicación da una reversa o cancela, todos los cambios realizados en una acción antes de que se genere el error para evitar discrepancias en la información.

Business Method:

la aplicación no da reversa a los cambios realizados por la acción.

16. La opción Support multiple dirty rows indica que el método seleccionado enviará una actualización

a los diferentes registros actualizados en el proceso de la base de datos. Cuando un método puede

manejar múltiples registros en una sola vez hacia la base de datos, este método se refiere a que esta siendo habilitada la actualización masiva de varios registros. Se pueden manejar diferentes acciones una vez que esta opción se ha seleccionado. Más adelante se revisa con detalle esta opción.

17. Clic en el botón Advanced para crear acciones customizadas para las directivas de este método, esto activa el programa Method Advanced Options. Este programa despliega la firma del método actual, se puede utilizar para crear acciones customizadas. También se puede crear un .NET assembly, Epicor Service Connect Workflow, o un Progress procedure con esta funcionalidad. Para aprender como se

utilizarán estas ´herramientas lee la sección de Acciones Customizadas.

Para utilizar esta funcionalidad, la cuenta del usuario debe ser definida como BPM Advanced User. Leer previamente la sección de configuración de BPM para conocer cómo se dan estos atributos a un usuario.

a lis

18.

Al

finalizar esta definición en la directiva de método damos clic en el botón Save de la barra estándar

de herramientas.

CREANDO LA DIRECTIVA

Ahora se está to para agregar directivas a este objeto. Se pueden una o más directivas en cada método, tabla o método de BAQ actualizable.

Este ejemplo presenta como se crean una directiva que se ejecute antes que el método CurrExRate.Update, este tipo es llamado Directiva Pre-Processing. Para crear la directiva:

1.

Clic en la flecha hacia abajo junto al botón New selecciona New Pre-Processing.

2.

La pestaña 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 búsquedas y exportación de la directiva.

P á g

i

n

a

16 | 104

Business Process Management – Manual Epicor 905.702a 5. El campo Order nos permite indicar la

Business Process Management – Manual Epicor 905.702a

5. El campo Order nos permite indicar la secuencia en que se llevará a cabo la directiva del método. El programa automáticamente 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 compañía en la cual se creó la directiva.

7. El check box Enabled indica que la directiva está activa y que la aplicación automáticamente compilará el código 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 sección Export Directives en parte de utilerías de los BPMs.

8. El check box Company Independent indica si está activo que funcionará para todas las compañías, dentro de la aplicación. Si no está activo significa, que solo se ejecutará en la Compañía Propietaria.

9. El check box Compatible indica que esta directiva trabaja con la versión actual de los métodos de negocio. Si la aplicación valida el método y descubre que no compatible con el método del negocio, este check box de-seleccionado. Para conocer con mayor detalle la aplicación checa la sección Compatibilidad de Directivas que viene más 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 opción.

11. El campo Reenter Max indica el número máximo 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 terminación del ciclo en el sistema. Como estas directivas corren, siempre, la aplicación checa los ciclos que se van a ejecutar un número de veces determinado en el campo Reenter Max. Cuando se cumple el número de ciclos programados, un mensaje de error se despliega y la directiva se detiene.

12. Clic en el botón Conditions para encontrar y seleccionar la condición a utilizarse en la directiva del método. Este abre la ventana de las condiciones, en esta ventana se seleccionará la condición a utilizar con la directiva. Cuando se definan los parámetros que se cumplan en la condición, esto relacionado con la acción relacionada. Para aprender más sobre las condiciones, leer la sección de condiciones.

13. Clic en el botón Actions para encontrar y seleccionar las acciones que se quieren realizar en base a la condición. Se abrirá la ventana, en la cual se seleccionarán la o las acciones a ejecutar al cumplirse la condición configurada. Para aprender más acerca de las acciones revisar la sección de Acciones.

P á g

i

n

a

17 | 104

Business Process Management – Manual Epicor 905.702a 14. Al termino dar clic en el botón

Business Process Management – Manual Epicor 905.702a

14. Al termino dar clic en el botón Save de la barra de herramientas estándar.

en el botón Save de la barra de herramientas estándar. CONDICIONES Las condiciones son enunciados en

CONDICIONES

Las condiciones son enunciados en los que se definen los parámetros 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 múltiples condiciones, utilizar operadores lógicos (y – and, o – or) para definir las relaciones entre las instrucciones actuales y las instrucciones previas. Podemos utilizar paréntesis para agrupar condiciones en las instrucciones de manera lógica.

La aplicación evalúa las declaraciones que se encuentren en la condición en el orden en que deben aparecer y de acuerdo a como serán agrupados. Para este ejemplo, se requiere una condición que se active cuando el usuario deje en blanco el número de teléfono en un nuevo registro.

En el Menú Principal: System Management > Business Process Management > Setup > Data Directives

Para crear y definir las instrucciones de la condición:

1. Despues de crear una nueva directiva para el registro, dar clic en el botón Conditions.

1. Despues de crear una nueva directiva para el registro, dar clic en el botón Conditions.

P á g

i

n

a

18 | 104

Business Process Management – Manual Epicor 905.702a 2. La ventana de Conditions despliega. 3. Clic

Business Process Management – Manual Epicor 905.702a

2. La ventana de Conditions despliega.

3. Clic en el botón New en la barra de herramientas.

4. Selecciona el User Text para ingresar la condición requerida. En este ejemplo se debe seleccionar el texto “the specified field of the changed row is equal to the specified expression”.

of the changed row is equal to the specified expression”. 5. Identifica que algunas palabras que

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 condición. Para este

ejemplo: da clic en el primer “specified” del link de la condición.

6. Dependiendo de la condición, 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 condición.

Todos los valores de la condición, como se especifican: selecciona un conjunto de renglones, selecciona un grupo, entre otros, son descritos en la siguiente sección Condiciones y Acciones – La lista completa de cada condición también se encuentra como un punto dentro de la ayuda de la aplicación.

7. Selecciona la Tabla que contiene el campo que se necesita. Para una directiva del método, todas las tablas que actualizan en el método 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 físicamente en la base de datos. Para conocer más acerca de las tablas temporales, leer Condiciones y Acciones.

P á g

i

n

a

19 | 104

Business Process Management – Manual Epicor 905.702a 8. El grid de Fields despliega los campos

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a 8. El grid de Fields despliega los campos contenidos

8. El grid de Fields despliega los campos contenidos en la tabla. En este ejemplo, la condición 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”.

11. Ahora damos clic en el segundo link “specified” . 12. La ventana de Specify an

12. La ventana de Specify an expression despliega.

13. En el campo Editor, se puede ingresar una expresión que podrá evaluarse para monitorear datos. En este ejemplo, se desea definir una condición que indique al usuario que se está dejando el blanco el campo de PhoneNumber. Para hacer esto ingresamos “” dobles comillas para indicar que la condición se activa cuando está en blanco.

La ventana para especificar una expresión se puede utilizar para construir una expresión más compleja que incluya datos de la transacción actual combinada con operadores lógicos y funciones de conversión. Se puede validar la expresión usando el botón Check Syntax

P á g

i

n

a

20 | 104

14. Damos clic en OK. Business Process Management – Manual Epicor 905.702a 15. Al regresar

14. Damos clic en OK.

Business Process Management – Manual Epicor 905.702a

OK. Business Process Management – Manual Epicor 905.702a 15. Al regresar a la pantalla de condiciones,

15. Al regresar a la pantalla de condiciones, notamos que la instrucción 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 número de teléfono la condición se activará.

16. Los otros campos en la ventana nos pueden ayudar a administrar las instrucciones de la condición. El campo Error Text valida la instrucción ingresada si este campo está en blanco significa que la instrucción es correcta. En otro caso, desplegaría un valor que nos indique que la instrucción de la condición es incorrecta.

17. Si se tienen 2 o más instrucciones, utiliza la lista de Operator para seleccionar el operador lógico 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

Business Process Management – Manual Epicor 905.702a • Or: se cumple la dirección si se

Business Process Management – Manual Epicor 905.702a

Or:

se cumple la dirección si se cumple una instrucción u otra.

18. Si se necesita agrupar instrucciones en las condiciones, utiliza el campo Prefix para ingresar los paréntesis que nos permitirán agrupar instrucciones.

19. El campo Postfix también se utiliza para definir el cierre de los paréntesis que nos permitirán cerrar la agrupación de instrucciones. Para agrupar 2 instrucciones, se ingresa el paréntesis abierto en el

campo Prefix de la 1ª instrucción y se cierra en el Postfix en la 2ª instrucción.

Se pueden ingresar más de un paréntesis en el prefix y en el postfix. Se pueden crear las instrucciones necesarias en las condiciones.

20. Para cambiar el orden en cual tu condición se va a ejecutar, selecciona la condición y da clic en el botón Up o Dowm. Para que la instrucción quede en el orden requerido.

21. Si se desea eliminar una instrucción, selecciona el registro que se quiere eliminar y da clic en el botón Delete.

22. Clic en el botón Advanced para ver el código fuente para BPM Progress; este punto es el código que correra en la instrucción actual. Siempre y cuando tu tengas derechos de BPM Advanced User que pueden usarse en esta función para extender manualmente o reemplazar este código.

para extender manualmente o reemplazar este código. 23. La ventana de Source Code despliega. 24. Editar

23. La ventana de Source Code despliega.

24. Editar el código de la condición que se ingrese en el campo Code.

25. Al terminar dar clic en OK.

el código de la condición que se ingrese en el campo Code. 25. Al terminar dar

P á g

i

n

a

22 | 104

Business Process Management – Manual Epicor 905.702a 26. Regresamos a la pantalla de condiciones. Al

Business Process Management – Manual Epicor 905.702a

26. Regresamos a la pantalla de condiciones. Al terminar la definición de tus condiciones, dar clic en OK.

terminar la definición de tus condiciones, dar clic en OK. 27. Cuando regresamos a la pantalla

27. Cuando regresamos a la pantalla de directivas de datos, la condición se despliega en el campo Conditions.

datos, la condición se despliega en el campo Conditions. ACCIONES Las acciones son operaciones que ejecuta

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 sección de ingreso de acciones, para que cuando se cumplan las condiciones determinadas se ejecuten las acciones.

Para este ejemplo, se requiere que la acción despliegue un mensaje de error cuando el usuario deja en blanco el campo de Número de Teléfono en un ingreso de cliente. Para crear y definir las acciones:

P á g

i

n

a

23 | 104

Business Process Management – Manual Epicor 905.702a 1. Clic en el botón Actions. 2. Nos

Business Process Management – Manual Epicor 905.702a

1.
1.

Clic en el botón Actions.

– Manual Epicor 905.702a 1. Clic en el botón Actions. 2. Nos abrirá la pantalla de

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

3. Clic en el botón Nuevo de la Barra de Herramientas.

4. Selecciona el campo de User Text para ingresar la acción que se desea aplicar. En este ejemplo, se seleccionará “raise exception base don the designed template” como acción.

5. Algunas de las palabras ingresadas en la instrucción de la acción son de tipo hyperlink. En los campos de tipo hyperlink debemos definir valores específicos. Para este ejemplo: dar clic en “designed” para ingresar el mensaje que deberá desplegar la acción.

Todas las acciones son descritas en la siguiente sección: Condiciones y Acciones – La lista completa de cada uno de ellos, adicionalmente la podemos encontrar en la ayuda en línea.

La lista completa de cada uno de ellos, adicionalmente la podemos encontrar en la ayuda en

P á g

i

n

a

24 | 104

Business Process Management – Manual Epicor 905.702a 6. En la venta del Templete (Formato) de

Business Process Management – Manual 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 condición. Para este ejemplo, se ingresa: “Antes de guardar el nuevo cliente, se debe ingresar el número telefónico”.

9. Clic OK.

se debe ingresar el número telefónico”. 9. Clic OK. 10. Regresa a la pantalla de Actions

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 condición se desplegará el mensaje de error ingresado en esta acción.

11. El campo Error Text nos indica los posibles errores en la sintaxis de la acción 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 acción que aparezca en el inicio de la lista será la primera que se ejecute y en ese orden se llevarán a cabo una a una.

13. En el campo Terminate On Error nos indica que la acción saldrá en automático si al momento de ejecutarse genera un error. Para activar esta función, clic en este campo y seleccionar (exit on error).

14. Si se desea eliminar una acción, selecciona la acción y da clic en el botón Delete.

15. Dar clic en el botón Advanced para ver el código fuente del proceso en BPM Progress, este elemento es el proceso que se ejecuta en la acción seleccionada. Se requiere tener permisos de BPM Advanced User, para usar esta funcionalidad y modificar el código manualmente.

P á g

i

n

a

25 | 104

Business Process Management – Manual Epicor 905.702a 16. La ventana de Source Code . 17.

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a 16. La ventana de Source Code . 17. Editar

16. La ventana de Source Code.

17. Editar el código de la acción que se necesita dentro del campo Code.

18. Al terminar damos clic en el botón OK.

campo Code. 18. Al terminar damos clic en el botón OK. 19. Regresamos a la ventana

19. Regresamos a la ventana de Acciones. Cuando puedes definir las acciones y dar clic en OK.

Cuando puedes definir las acciones y dar clic en OK . 20. Regresamos a la ventana

20. Regresamos a la ventana de Data Directives. La nueva acción se despliega en el campo de Actions.

P á g

i

n

a

26 | 104

Business Process Management – Manual Epicor 905.702a CONDICIONES Y ACCIONES – LA LISTA COMPLETA Esta

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a CONDICIONES Y ACCIONES – LA LISTA COMPLETA Esta sección

CONDICIONES Y ACCIONES – LA LISTA COMPLETA

Esta sección explora todas las condiciones pre-construidas condiciones y acciones disponibles dentro de la funcionalidad de BPM. Utilizar esta sección para crear las directivas que usted necesita.

También se pueden crear BPM condiciones y acciones, se identifican las tablas con el prefijo “tt”. El prefijo “tt” es una abreviación de tabla temporal; este valor se usa dentro del código 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 física dentro de la base de datos.

Cuando se modifica una columna en una tabla “tt” a través 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 través 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 información 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 deberán 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

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a

CONDICIONES

Esta sección contiene la lista de las condiciones pre-construidas que se pueden seleccionar. Algunas de las condiciones sólo están disponibles en determinadas directivas. Por ejemplo, la condición: “the Sepcified field has been changed from any to any” no está disponible en la directiva de método 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á condición se utiliza para evaluar los parámetros del BPM, una tabla temporal o el contenido de las variables call context (que son variables en el proceso). También podemos utilizar para evaluar las acciones customizadas dentro del BAQ. Si se ejecutan dentro del BPM.

Tipo de Directivas

Método

Ninguno

Dato

Ninguno

Actualizable BAQ

Todos

Variables

Specified (argument)

Clic en este link para que nos despliega el programa para seleccionar el argumento. Utilizar este programa para seleccionar cual parámetro se quiere evaluar contra otras variables en la misma condición.

Is equal to

Clic para que nos despliegue el programa para seleccionar el tipo de comparación. Utilizar este programa para seleccionar una opción de comparación a evaluar contra el argumento. Esta comparación debe darnos como resultado TRUE para que se ejecute la acción.

Specified (expression)

Clic en este link para que nos abra el programa para especificar una expresión. Utilizar este programa para armar una expresión que se pueda comparar contra el parámetro. La expresión contener: valores literales, datos desde la transacción actual y funciones que puedan realizar cálculos o conversión de datos. Si se está evaluando una condición dentro de una acción customizada en un BAQ debemos ingresar el ID de la acción entre dobles comillas “”. Dar clic en el botón de checa sintaxis para verificar que la expresión sea correcta.

Number of rows in the designed query is not less than 1 – Utilizar esta condición para crear un query que se active con datos conocidos, una comparación específica (is more than, not less than, and so on). Si esta comparación se cumple con un TRUE, la acción se ejecutará.

El query debe ser una cadena completa, no agregue ningún retorno pesado (combinado) o ligero que pueda devolver múltiples datos. No agregue al final del query comparativos de datos.

P á g

i

n

a

28 | 104

Tipo de Directivas Business Process Management – Manual Epicor 905.702a Método Todos Dato Todos

Tipo de Directivas

Business Process Management – Manual Epicor 905.702a

Método

Todos

Dato

Todos

Actualizable BAQ

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 número de renglones devuelto comparado con el valor que se seleccione más tarde en la instrucción. Si agregamos tablas estándar, 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 comparación utilizada para evaluar el número de renglones en el query seleccionado. Si la comparación se evalúa a TRUE, la acción se ejecutará.

1

Clic en este link para que despliegue el valor de renglones a generar. Utilizar este programar para ingresar un valor numérico que evalúa el número de renglones que se regresan en el query.

The specified field has been changed from any to any. – Utilizar esta condición para monitorear el valor específico contenido en la transacción actual. Si el valor de esté campo cambia a otro valor que se ha definido en esta condición se detonará la acción correspondiente.

Para esta condición, se deben especificar 2 valores. El primer valor del campo se compara con el segundo valor. Si esta comparación regresa TRUE, la aplicación ejecutará la acción definida.

Todas las tablas contiene una columna llamada RowMod que esta al final del registro. La aplicación fija el RowMod como: Add(A), Update (U), o Delete (D) para definir la acción que se presenta en el registro. Normalmente el valor del RowMod es un conjunto para los métodos Update(U). Si se ve la referencia cambiada se refiere a un valor RowMod establecido como A o U. Algunos métodos 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 están permitidas para que posiblemente deje el valor Row Mod vacío.

P á g

i

n

a

29 | 104

Tipo de Directivas Business Process Management – Manual Epicor 905.702a   Método Dato Actualizable BAQ

Tipo de Directivas

Business Process Management – Manual Epicor 905.702a

 

Método

Dato

Actualizable BAQ

Pre-Processing

Base Processing

Todos

Pre-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 selección un campo que se parte de la condición BPM. Se puede seleccionar un campo estándar o un campo definido por el usuario desde cualquier tabla temporal (tt table) incluidas en los parámetros del método. Esta aplicación compara el valor del campo original contra el nuevo valor del campo que se específica.

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á condición para determinar que usuario puede ejecutar o no la acción definida. Dependiendo de lo que se defina para esta condición (Yes o No), la acción de la directiva se ejecutará. Esta condición puede ser usada para probar directivas que se quieren activar para un usuario específico.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Todos

Variables

Is called

Clic en este link para ejecutar el programa de seleccionar opción. Este programa despliega el is called o is not called. Selecciona la opción requerida, estas opciones determinan quien puede generar la acción y quien no.

Specified user

Clic este link para abrir el programa que nos indicará el usuario que puede ejecutar la acción.

P á g

i

n

a

30 | 104

Business Process Management – Manual Epicor 905.702a • The user called the method belongs to

Business Process Management – Manual Epicor 905.702a

The user called the method belongs to specified group – Utilizar esta condición para determinar si el usuario actual pertenece o no a un grupo específico. La aplicación compara el usuario quien inicia la transacción en el grupo. La acción de la directiva se ejecuta dependiendo de que se cumpla la condición (YES-SI o NO)

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Todos

Variables

Belong

Clic en este link para ejecutar el programa de seleccionar la opción. Este programa despliega el belongs o does not belong. Selecciona esta opción si se necesita determinar si un grupo es miembro de un grupo o no para ejecutar una acción determinada.

Specified group

Clic este link para abrir el programa que nos indicará el grupo de usuarios que puede ejecutar la acción.

The hold of the specified type is attached to the business object – Utilizar la condición para indicar que el Sistema podría verificar que un tipo de retención fue anexada al objeto actual o relacionado con el objeto. Si el tipo de retención está presente en los objetos de negocio seleccionados cuando el método se ejecuta, la aplicación ejecutará las acciones indicadas.

Tipo de Directivas

Método

Todos

Dato

Ninguno

Actualizable BAQ

Ninguno

Variables

Specified type is attached to the business object

Clic en el link para que se abra el programa Select Business Object. Nos desplegará los objetos que están relacionados con el método actual utilizando una vista de árbol. La interface nos desplegará todos los objetos que están ligados, o que se pueden ligar al objeto actual.

También puedes especificar el tipo de retención para esta condición que se necesita verificar en el objeto del negocio. Los tipos de retención deben ser creados para especificar un objeto de negocio. Antes de que se

P á g

i

n

a

31 | 104

Business Process Management – Manual Epicor 905.702a seleccione un evento a través de este programa.

Business Process Management – Manual Epicor 905.702a

seleccione un evento a través de este programa. Para más información, lee la sección de Tipo de retención que está más adelante en este manual.

Time is in the specified time frame. – Utilzar esta condición para indicar un marco de tiempo específico en el cual será monitoreada esta condición. Si la transacción de datos es ejecutada durante este marco de tiempo, la aplicación ejecutará las acciones de la directiva.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

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 condición de esta instrucción. 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 día.

The specified field of the changed row is equal to the specified expression -

está declaración de

condición monitorea un campo específico dentro de una transacción de datos. El BPM compara el valor del campo contra el valor que específicas al final de la sentencia. Si está comparación se cumple, la aplicación ejecuta la directiva de la acción.

Tipo de Directivas

Método

Dato

Actualizable BAQ

Tipo de Directivas Método Dato Actualizable BAQ Pre-processing Base processing Todos Pre-processing

Pre-processing

Base processing

Todos

Pre-processing

Base processing

Variables

Specified (field)

Clic en este link para abrir el programa Select table. Utilizar este programa para especificar un campo estándar o un campo definido por el usuario que es parte de la sentencia. Para las directivas de método, se pueden seleccionar un campo desde una tabla temporal (tt tabla) incluida en los parámetros del método actual. Para las directivas de datos, se puede seleccionar un campo estándar o un campo

P á g

i

n

a

32 | 104

Business Process Management – Manual Epicor 905.702a   definido por el usuario que este dentro

Business Process Management – Manual 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 cuál es el conjunto de renglones que se afectarán cuando esta regla se active – como son added row – agregar un renglón, the deleted row – borrar un renglón, the update row – actualizar un renglón entre otros.

is equal to

Clic en este link para abrir el programa Select a Comparison. Utilizar este programa para seleccionar una opción de comparación utilizada para comparar el campo seleccionado contra el valor definido más adelante en la sentencia de la condición

specified (expression)

Clic en este link para abrir el programa Specify an Expression. Utilizar este programa para componer una expresión que se evalúe en la comparación. La expresión puede contener un valor literal, datos desde la transacción y funciones que pueden generar cálculos o conversiones de datos. Clic en el botón Check Syntax para verificar que la sintaxis de la expresión sea correcta.

There is at least one update row in the specified table -

Está condición compara el valor de un

campo incluído en el conjunto de renglones de una tabla especifica. Si esta comparación devuelve

TRUE- Verdadero, se ejecutará la acción de la aplicación.

Tipo de Directivas

 

Método

Dato

Actualizable BAQ

Pre-Processing

Base Processing

Todos

Pre-Processing

Base Processing

 

Variables

updated

Clic este link para abrir el programa Select a Row Set. Utilizar este programa para especificar el conjunto de renglones se afectará cuando se active la regla de actividades – como son the added row – renglón agregado, the deleted row – borrado de renglón, the updated row – renglón actualizado entre otros.

specified

Clic en este link para abrir el programa Select Table. Utilizar este programa para especificar una tabla la cual se podría monitorear a través de la sentencia de la condición. Utilizar este

P á g

i

n

a

33 | 104

Business Process Management – Manual Epicor 905.702a programa para seleccionar una tabla ligada a la

Business Process Management – Manual Epicor 905.702a

programa para seleccionar una tabla ligada a la transacción actual.

programa para seleccionar una tabla ligada a la transacción actual.

Value of the specified field of the designed query changed from any to another – Utilizar esta condición para que el campo de un query específico que este fuera de la transacción actual. Si el valor del campo cambia a otro valor que se define, la condición activa las acciones de la directiva.

Tipo de Directivas

Método

Ninguno

Dato

Todos

Actualizable BAQ

Ninguno

Variables

specific

Clic este link para que abra el programa Select Table. Utilizar este programa para especificar un campo estándar 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 condición o de la acción del BPM. Se pueden agregar tablas estándar que se deben ligar con las tablas temporales con el objetivo de filtrar información.

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 condición, se pueden especificar 2 valores para el campo. El primer valor es comparado contra el segundo valor. Si la comparación regresa TRUE – VERDADERO, la aplicación ejecuta la directiva de la acción.

The specified call context field is equal to the specified expression – Utilizar esta condición para monitorear el valor de una variable de contexto en la transacción actual, como pueden ser CurrentCompany or CurrentUserId. La aplicación compara este argumento contra una expresión que se específique. Si la comparación devuelve TRUE – Verdadero, la aplicación ejecuta las acciones de la directiva.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Todos

P á g

i

n

a

34 | 104

Variables Business Process Management – Manual Epicor 905.702a Specified call context Clic en este link

Variables

Business Process Management – Manual Epicor 905.702a

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 están disponibles para cada método de negocio, y puedes aprovecharlas para almacenar datos personalizado tanto en el cliente como en el servidor. La aplicación compara el valor del campo con un valor que se especifique. Para más información revise los temas de llamadas de contexto dentro de la ayuda de la aplicación

is equal to

Clic en este link para abrir el programa de Select a Comparision. Utilizar este programa para selección una opción de comparación que se usan para validar el número de renglones del query seleccionado. Si esta comparación evalua TRUE-Verdadero, las directivas de acción se ejecutarán.

specified

Clic este link para abrir el programa Specify an Expression. Utilizar este programa para componer una expresión que se evaluada durante la comparación. Esta expresión puede contener valores literales, datos desde la transacción actual, y funciones que pueden ejecutar cálculos y tipos de datos para la conversión. Clic en el botón Check Syntax para verificar la sintaxis de la expresión.

Method changed the specific field of the designed query from any to another value – Cuando esta condición es utilizada, la aplicación verificar que el campo que es resultado del conjunto de los resultados del query ha cambiado desde un valor a otro valor. Si esta condición se cumple la condición se evalúa TRUE -Verdadero, la aplicación ejecuta las directivas de la acción.

Tipo de Directivas

 

Método

Dato

Actualizable BAQ

Post-Processing

Ninguno

Ninguno

 

Variables

specific

Clic este link para que abra el programa Select Table. Utilizar este programa para especificar un campo estándar 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

Business Process Management – Manual Epicor 905.702a   escribir un query compatible con ABL y/o

Business Process Management – Manual Epicor 905.702a

 

escribir un query compatible con ABL y/o un BAQ (Business Activity Qurey) como parte de una sentencia de la condición o de la acción del BPM. Se pueden agregar tablas estándar que se deben ligar con las tablas temporales con el objetivo de filtrar información.

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 condición, se pueden especificar 2 valores para el campo. El primer valor es comparado contra el segundo valor. Si la comparación regresa TRUE – VERDADERO, la aplicación ejecuta la directiva de la acción.

This directiva has been enabled from the specified directive -

Utilizar esta condición 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

Método

Post-Processing

Dato

Ninguno

Actualizable BAQ

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 condición.

The specified public data tag exists on the changed row of the specified table -

Utilizar esta

condición para identificar cuando la etiqueta de un dato será colocada en un registro. Se pueden aplicar etiquetas a los registros a través de la aplicación. Un uso común 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 capítulo de Busquedas para más información acerca de las etiquetas de datos.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Ninguno

P á g

i

n

a

36 | 104

Variables Business Process Management – Manual Epicor 905.702a The specified (data tag) Clic en este

Variables

Business Process Management – Manual Epicor 905.702a

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 públicas 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 público 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 doesn’t exists . Seleccionar exists para limitar las idrectiva alos registros que tengan aplicada la etiqueta, seleccionar doesn’t 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 Row Set. Utilizar este programa para especificar cuál renglón será afectado cuando la regla se active – cuando se added row – agregue un renglón, the deleted row – borre un renglón, the updated row – se borre un renglón entr otros.

specified (table)

Clic este link para abrir el programa Select Table. Utilizar este programa para especificar una tabla como parte de la sentencia de la condición. Para una directiva de método, utilizar este programa para seleccionar un campo estándar o definido por el usuario de una tabla temporal (tt tabla) incluida en los parámetros del método actual. Para una directiva de datos, debemos asegurarnos para seleccionar la tabla actual, esta tabla contiene los datos que deseamos monitorear.

ACCIONES

Esta sección contiene la lista de las acciones pre-construidas; que puedes utilizar para crear sentencias complejas para una causa especifica que ocurran dentro de la aplicación. Las disponibles acciones:

P á g

i

n

a

37 | 104

Business Process Management – Manual Epicor 905.702a • Send email asynchronously based on the designed

Business Process Management – Manual Epicor 905.702a

Send email asynchronously based on the designed template with rule – utilizer esta acción para enviar automáticamente un correo a los recipientes seleccionados.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

Todos

Variables

asynchronously

Clic en este link para que el conjunto de variables en un email se envía síncronamente o asíncronamente. Esto indica como la aplicación generará el mensaje generado por esta acción. Las opciones disponibles son:

Sincronamente – el email se enviará en cuanto se ejecute la acción.

Asincronamente – el email se colocará en un fila y se ejecutará en base a la programación definida a través del programa del Proceso de la Acción del BPM, para aprender más acerca de este programa, leer el BPM Proceso de la Acción.

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 acción del BPM se ejecute.

También se puede insertar un campo y variables de la tabla en el mensaje. Se puede diseñar 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 botón 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 transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

P á g

i

n

a

38 | 104

Business Process Management – Manual Epicor 905.702a • Call the specified Epicor Service Connect Workflow

Business Process Management – Manual Epicor 905.702a

Call the specified Epicor Service Connect Workflow asynchronously with rule – utilizer esta acción para enviar una llamada a Epicor Service Connect. La información en esta llamada es distribuida a través del Flujo de Trabajo de Service Connect que se seleccione.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

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.

Después de que se ingresen correctamente las credenciales, el programa Select Workflow. Utilizar este programa para seleccionar el workflow que se quiere utilizar.

Para aprender más acerca de Epicor Service Connect, revisa la documentación del Epicor Service Connect y la Guía del Usuario

asynchronusly

Clic en este link para ejecutar el workflow asíncronamente o síncronamente.

Sincronamente – la llamada se hace inmediatamente cuando se ejecuta la acción.

Asincronamente – la llamada es colocada en una fila y se ejecuta de acuerdo a la programación 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 despliegarán los renglones.

Create specific task with rule – utilizar esta acción para automaticamente generar una tarea a los usuarios seleccionados.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

Todos

P á g

i

n

a

39 | 104

Variables Business Process Management – Manual Epicor 905.702a specific Clic en este link para abrir

Variables

Business Process Management – Manual Epicor 905.702a

specific

Clic en este link para abrir el programa Create task template. Utilizar este programa para definir una tarea que es creada cuando la aplicación ejecuta esta acción.

También se pueden insertar argumentos dentro del formato de la tarea actual. Los conjuntos de valores de la aplicación para el formato de la tarea se sustituyen por los valores provistos por el método 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 botón derecho dentro del campo de comentarios y seleccionar los parámetros 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 también ingresar variables al formato de la tarea. Para hacer esto se puede diseñar un Simple Query que obtenga información de los campos que se definan. Para utilizar un Design Simple Query para acceder a esta funcionalidad, primero dar clic en los Commentarios que están dentro del programa Create Task Template. Dar clic con el botón 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 despliegarán los renglones.

Synchronously invoke .NET method don’t queue record nothing with rule – Utilizar esta acción para que se pueda seleccionar .NET.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

Todos

P á g

i

n

a

40 | 104

Business Process Management – Manual Epicor 905.702a Variables Synchronously Clic en este link para seleccionar

Business Process Management – Manual Epicor 905.702a

Variables

Synchronously

Clic en este link para seleccionar si será asíncrono o síncrono:

Síncrono – la llamada se ejecutará durante la acción.

Asíncrono – la llamada es colocada en una fila de procesos que se ejecutará conforme se defina la programación de la tarea. Para aprender más 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 método .NET y especificar como se deberá ejecutar. El método .NET es una acción de programación que extiende la funcionalidad de nuestra aplicación.

don’t queue

Para las acciones asíncronas se puede configurar que la acción se someta a una fila de proceso. Leer el tema de Asíncrona Acción en la sección de Epicor ICE Tools – User Guide para entender la configuración. Clic en este link para seleccionar:

Don’t queue – automáticamente se configura asíncronamente.

Queue at BPM Server – disponible para ejecución asíncrona.

Queue at Progress – disponible para la ejecución asíncrona.

Queue at both BPM server and Progress - disponible para ejecución asíncrona.

record nothing

Indica que cualquiera que sea la acción ejecutada sobre el registro en el código customizado. Ver el grabado y ejecución de las llamadas en la ayuda del sistema. Clic en el link que nos permita seleccionar:

Record nothing – no se almacena la acción.

Record call – Solo se registra la acción de la llamada.

Record return – se registra solo la acción que regresa datos.

Record call, return – registra tanto el llamado como el resultado de la llamada.

with rule

Clic en este link para abrir el programa Execution Rule. Si las transacciones de datos soportan múltiples renglones, se puede utilizar

P á g

i

n

a

41 | 104

Business Process Management – Manual Epicor 905.702a este programa para seleccionar como se van a

Business Process Management – Manual Epicor 905.702a

este programa para seleccionar como se van a operar las acciones sobre los renglones.

como se van a operar las acciones sobre los renglones. • Synchronously execute ABL code… record

Synchronously execute ABL code… record nothing with rule utilizar esta acción para anexar un proceso ABL (.p o .r) a un método. Cuando esta acción se ejecuta, el proceso del programa se ejecuta.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Todos

Variables

Synchronously

Clic en este link para seleccionar si será asíncrono o síncrono:

Síncrono – la llamada se ejecutará durante la acción.

Asíncrono – la llamada es colocada en una fila de procesos que se ejecutará conforme se defina la programación de la tarea. Para aprender más 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 método. Se puede agregar el proceso de 2 maneras:

escribiendo el código 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 acción ejecutada sobre el registro en el código customizado. Ver el grabado y ejecución de las llamadas en la ayuda del sistema. Clic en el link que nos permita seleccionar:

Record nothing – no se almacena la acción.

Record call – Solo se registra la acción de la llamada.

Record return – se registra solo la acción que regresa datos.

Record call, return – registra tanto el llamado como el resultado de la llamada.

with rule

Clic en este link para abrir el programa Execution Rule. Si las transacciones de datos soportan múltiples renglones, se puede utilizar

P á g

i

n

a

42 | 104

Business Process Management – Manual Epicor 905.702a este programa para seleccionar como se van a

Business Process Management – Manual Epicor 905.702a

este programa para seleccionar como se van a operar las acciones sobre los renglones.

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 acción para desplegar un mensaje informativo con el formato definido por nosotros. Después de que los usuarios lean el mensaje y den clic en OK, el método continúa 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

Método

Dato

Actualizable BAQ

Tipo de Directivas Método Dato Actualizable BAQ Pre-Processing Post-Processing Ninguno

Pre-Processing

Post-Processing

Ninguno

Pre-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 información que los usuarios tengan que ver. Basado en la condición(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 Actualización. Se puede también seleccionar si el mensaje de BPM despliega como un mensaje individual o como un grid.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Raise exception base don the designed template with rule - utilizar esta acción para desplegar un mensaje de excepción que cuando se cumpla condición, se active esta acción, se detendría el proceso hasta que el usuario lo revise y de clic en la pantalla de excepción. 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

Tipo de Directivas Business Process Management – Manual Epicor 905.702a Método Dato Actualizable BAQ

Tipo de Directivas

Business Process Management – Manual Epicor 905.702a

Método

Dato

Actualizable BAQ

Pre-Processing

Post-Processing

In-Transaction

Pre-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 información que los usuarios tengan que ver. Basado en la condición(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 diseñar un Simple Query que obtenga información 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 botón 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 Actualización. Se puede también seleccionar si el mensaje de BPM despliega como un mensaje individual o como un grid.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Attach hold of the specified type with rule – utilizar está acción para agregar una retención a un registro específico.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

Ningúno

P á g

i

n

a

44 | 104

Variables Business Process Management – Manual Epicor 905.702a specified Clic en este link para abrir

Variables

Business Process Management – Manual Epicor 905.702a

specified

Clic en este link para abrir el programa Hold attachment. Utilizar este programa para especificar que retención se va anexar a un registro cuando la aplicación ejecuta la acción. Se puede seleccionar desde cualquiera de los tipos de retenciones definidas para el objeto de negocio. También se pueden agregar comentarios adicionales.

Después de que la retención se ha colocado en un registro, cualquier directiva subsecuente puede checar para la presencia de esta retención y la ejecución de varias acciones cuando el usuario intenta ejecutar un método que afecta el registro.

Los tipos de retención son creados en Hold Type Maintenance. Para aprender más de este tema leer la sección de mantenimiento a los tipos de retención.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Remove hold of the specified type with rule - utilizar esta acción para remover una retención desde un registro específico.

Tipo de Directivas

Método

Todos

Dato

Standard

Actualizable BAQ

Ningúno

Variables

specified

Clic en este link para abrir el programa Hold Removal. Utilizar este programa para especificar la retención que se va a eliminar cuando la aplicación ejecute esta acción.

P á g

i

n

a

45 | 104

Business Process Management – Manual Epicor 905.702a   Se puede seleccionar cualquier tipo de retención

Business Process Management – Manual Epicor 905.702a

 

Se puede seleccionar cualquier tipo de retención definida para los objetos de negocio. Los tipos de retención son creados en Hold Type Maintenance.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Set the specified field of the changed row to the specific espression with rule utilizar esta acción para cambiar un campo seleccionado a un valor determinado.

Tipo de Directivas

Método

Todos

Dato

Ninguno

Actualizable BAQ

Todos

Variables

specified

Clic en este link para que abra el programa Select Table Field(s). Utilizar este programa para especificar un campo estándar o un campo definido por el usuario el cual se cambiará a través de esta acción. Utilizar este programa para seleccionar el campo desde una tabla temporal (tt tabla) incluyendo los parámetros del método 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 renglón, deleted row – borrado renglón, updated row – actualizar el renglón entre otros.

specific

Clic en este link para abrir el programa Sepecify an Expression. Utilizar este programa para componer una expresión que se evaluará en la comparación. La expresión puede contener valores de literales, de datos desde la transacción y de funciones que pueden ejecutar cálculos y conversiones de datos. Clic en el botón de Check Syntax para verificar la sintaxis de la expresión.

P á g

i

n

a

46 | 104

Business Process Management – Manual Epicor 905.702a with rule Clic en este link para abrir

Business Process Management – Manual Epicor 905.702a

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Enable dependent post-process directives - Utilizar esta acción en directivas de procesos post- processing ligadas a esta directive. Utilizar esta acción cuando se desee ejecutar una acción después de que el registro es validado exitosamente y actualizado desde la tabla temporal “tt” o tablas físicas.

No se deben seleccionar variables para esta acción. Se pueden ligar esta directiva a una post- processing desde una pre o base processing utilizando la condición “this directive has been enabled from the specified directive”. Se puede seleccionar la directiva que contenga esta acción a través una variable específica.

Utilizar esta acción para probar las condiciones en una directiva pre-processing o base processing y que se ejecute en automático una post-processing basada en esas condiciones. Par más información, revisar la sección previa de Condiciones. Para más información en directivas dependientes, leer la sección de Directivas Dependientes más adelantes en este documento.

Tipo de Directivas

Método

Dato

Actualizable BAQ

Pre-Processing

Base Processing

Ninguno

Pre-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 través de tablas de CallContext. Se puede checar el valor de campo en una condición para futuras directivas o valores pasados a través de la aplicación del cliente. Para más información revisa los tópicos del CallContext dentro de la ayuda de la aplicación.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

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

Business Process Management – Manual Epicor 905.702a   especificar un campo de llamada de contexto

Business Process Management – Manual Epicor 905.702a

 

especificar un campo de llamada de contexto que es parte de la acción BPM.

specified

Clic en este link para abrir el programa Specify an Expression. Utilizar este programa para componer una expresión que se utiliza como una variable de contexto. La expresión puede contener valores literales, datos de la transacción actual, funciones que pueden generar cálculos y conversiones de datos. Clic en el botón de Check Syntax para verificar la sintaxis de la expresión.

Attach the specified public data tag to the changed row of the specified table with rule Utilizar esta acción para anexar una etiqueta de datos a un registro. Se pueden aplicar etiquetas de datos a los registros a través de la aplicación. Un uso común para las etiquetas de datos es agrupar registros para búsquedas o para directivas BPM que se puedan ejecutar cuando exista un cambio en los registros. Revisar el capítulo de búsquedas para más información acerca de las etiquetas de datos.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Ningúno

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 agregar los registros de la directiva que se asignado etiquetas públicas 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 público o privado, instado o limitado a una directiva de uno a otro.

the changed row

Clic en este link para abrir el programa Select Row Set. Utilizar este programa para especificar cuál renglón será afectado cuando la regla se active – cuando se added row – agregue un renglón, the deleted row – borre un renglón,

P á g

i

n

a

48 | 104

Business Process Management – Manual Epicor 905.702a   the updated row – se borre un

Business Process Management – Manual Epicor 905.702a

 

the updated row – se borre un renglón entr otros.

specified (table)

Clic este link para abrir el programa Select Table. Utilizar este programa para especificar una tabla como parte de la sentencia de la condición. Para una directiva de método, utilizar este programa para seleccionar un campo estándar o definido por el usuario de una tabla temporal (tt tabla) incluida en los parámetros del método actual. Para una directiva de datos, debemos asegurarnos para seleccionar la tabla actual, esta tabla contiene los datos que deseamos monitorear.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

Remove the specified public data tag to the changed row of the specified table with rule Utilizar esta acción para remover una etiqueta de datos a un registro. Se pueden aplicar etiquetas de datos a los registros a través de la aplicación. Un uso común para las etiquetas de datos es agrupar registros para búsquedas o para directivas BPM que se puedan ejecutar cuando exista un cambio en los registros. Revisar el capítulo de búsquedas para más información acerca de las etiquetas de datos.

Tipo de Directivas

Método

Todos

Dato

Todos

Actualizable BAQ

Ningúno

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 remover los registros de la directiva que se asignado etiquetas públicas para especificar un nombre. Seleccionar el usuario actual para limitar los registros de la

P á g

i

n

a

49 | 104

Business Process Management – Manual Epicor 905.702a   directiva donde el usuario trate de modificar

Business Process Management – Manual Epicor 905.702a

 

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 público o privado, instado o limitado a una directiva de uno a otro.

the changed row

Clic en este link para abrir el programa Select Row Set. Utilizar este programa para especificar cuál renglón será afectado cuando la regla se active – cuando se added row – agregue un renglón, the deleted row – borre un renglón, the updated row – se borre un renglón entr otros.

specified (table)

Clic este link para abrir el programa Select Table. Utilizar este programa para especificar una tabla como parte de la sentencia de la condición. Para una directiva de método, utilizar este programa para seleccionar un campo estándar o definido por el usuario de una tabla temporal (tt tabla) incluida en los parámetros del método actual. Para una directiva de datos, debemos asegurarnos para seleccionar la tabla actual, esta tabla contiene los datos que deseamos monitorear.

with rule

Clic en este link para abrir el programa Execution Rule. Si la transacción de datos soporta múltiples renglones, se puede utilizar este programa para seleccionar como se desarrolle la acción. Leer la sección de soporte a múltiples renglones. Esta variable no es visible si el método de datos de la transacción no soporta múltiples renglones.

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 renglón, como el ingreso de un tipo de cambio para una moneda, entonces se mueve a otro renglón (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 métodos ú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 métodos pueden enviar actualizaciones a múltiples registros al mismo tiempo como un conjunto de registros son actualizados en el servidor.

Cuando múltiples registros son enviados a un servidor en el mismo tiempo, se puede especificar una directiva que tome acción en un conjunto de registros de manera específica. Esas acciones están disponibles tanto para directivas de método como para directivas de datos:

P á g

i

n

a

50 | 104

Business Process Management – Manual Epicor 905.702a • Una vez en todas las filas coincidentes

Business Process Management – Manual Epicor 905.702a

Una vez en todas las filas coincidentes (once passing all matching rows) - La acción se ejecuta una vez que se mueve a través de los datos dentro del conjunto de registros actualizados de forma combinada.

Una vez que se cumple la condición en todos los renglones existentes (once passing all existing rows) - La acción se ejecuta una vez que se mueve a través 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 acción se ejecuta por tantas veces como el número de registros que coinciden con los criterios de selección en la zona de actualización de forma combinada. Conjunto de registros para cada registro que se ejecuta individualmente.

Para cada uno existente (for each existing): la acción se ejecuta tantas veces como el número de registro dentro del conjunto de registros actualizados de forma combinada (el número total de registros). Cada registro se procesa individualmente.

DIRECTIVA DE COMPATIBILIDAD

Cada directiva debe ser compatible con la versión actual de la aplicación Cuando una nueva versión es instalada, el módulo de BPM ejecuta rutinas que aseguren que las directivas podrían estar trabajando como se espera.

Para aprender más acerca de las reglas específicas en el módulo BPM utiliza una prueba de compatibilidad, leer el tema de Compatibilidad de Directivas dentro de la ayuda de la aplicación.

Una directiva debe ser seleccionado por compatibilidad a través de tres situaciones:

Importar Directivas – si la directiva es importada dentro de la aplicación, el proceso de importación valida la compatibilidad de la directiva. Si no es compatible, un mensaje de error se despliega. Para más información acerca de este proceso leer la sección de Importar Directivas en el Capítulo: Utilerias de BPM.

Service Packs - Cada vez que un service pack se instala, utilizar el programa de Herramientas de Administración para ejecutar la tarea del programa de conversión “Validate BPM customizations of business methods”. Se puede hacer dando clic en el botón Run Conversion Program y entonces seleccionar este programa desde la ventana del dialogo de conversión. Este programa analiza la firma de cada método para verificar si trabaja correctamente dentro de la directiva de método 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 página de detalle.

Patches – cada vez que se instala un patch en su aplicación, se necesita que manualmente ser verifique la compatibilidad de todas las directivas. Para hacer que esto se ejecute a través de la opción Validate Method desde el menú de Actions.

P á g

i

n

a

51 | 104

Business Process Management – Manual Epicor 905.702a ¿CÓMO UTILIZAR EL PROGRAMA DE VALIDACIÓN DEL MÉTODO?

Business Process Management – Manual Epicor 905.702a

¿CÓMO UTILIZAR EL PROGRAMA DE VALIDACIÓN DEL MÉTODO?

La ruta de acceso en el menú principal es: System Management -> Business Process Management -> Setup - > Method Directives

Para ejecutar el programa de Validación de Método:

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 página de detalle. Este valor es un estado asignado a la directiva.

de detalle. Este valor es un estado asignado a la directiva. Para corregir directivas incompatibles, se

Para corregir directivas incompatibles, se necesita ingresar a las directivas de método o a las directivas de BAQ Actualizable y revisar los métodos o estructura de una tabla.

Para ayudar a localizar esas directivas, la búsqueda de método y la búsqueda de la tabla se configuran para únicamente buscar directivas no compatibles.

DIRECTIVAS DEPENDIENTES

Se pueden establecer relaciones entre las directivas creadas para los mismos métodos de los objetos de negocio. Esas relaciones son dependientes; si una directiva se ejecuta correctamente, la aplicación se ejecuta desde otra directiva. Esta primera directiva es llamada la Directiva Primaria, y viene desde la condición de la segunda, o depende de otra directiva. La directiva dependiente se aplica solamente a las directivas de métodos y no a las directivas de datos.

P á g

i

n

a

52 | 104

Business Process Management – Manual Epicor 905.702a Utilizar directivas dependientes ayuda a prevenir errores. El

Business Process Management – Manual Epicor 905.702a

Utilizar directivas dependientes ayuda a prevenir errores. El apalancamiento de esta función cuando no se puede actualizar un registro se envía un mail de confirmación hasta estar seguro de que la transacción se completó exitosamente. Si una acción se ejecuta antes de una transacción esto puede provocar un error en los datos – pero la acción se ejecuta de todas maneras. Por ejemplo: un email de confirmación puede ser enviado indicando que la transacción se completó con éxito, cuando realmente eso no ocurrió. Si la condición 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 método.

DIRECTIVA PRIMARIA

La directiva primaria debe estar en un pre-processing o una directiva base processing. Después de que se defina la condición para la directiva, se va a la ventana de acciones:

1. Clic en el botón 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 acción.

post process directives” como sentencia de la acción. Esta acción indica que el resultado de la

Esta acción indica que el resultado de la directiva primaria – terminada con éxito o terminada con error- se pasa a otra directiva a través del mismo método.

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 botón 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

Business Process Management – Manual Epicor 905.702a 3. Clic en el link “specified” para seleccionar

Business Process Management – Manual Epicor 905.702a

3. Clic en el link “specified” para seleccionar el método pre-processing o base processing. En este ejemplo, the Condition Test to Remove Hold se seleccionó.

Esta sentencia de la condición indica que la aplicación ejecuta las directivas de acción dependiente cuando tanto la directiva se ejecuta exitosamente y las otras condiciones son dependientes.

CASO DE ESTUDIO

Esta sección 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 módulo BPM.

CASO 1:

HACER UN CAMPO REQUERIDO

Se puede hacer que un campo sea mandatorio o requerido, a través de las directivas de datos. Utilizando una directiva que hace el campo requerido en el servidor, para que la aplicación realiza de manera automática el cambio.

En este ejemplo, se puede hacer que el campo de Número de Teléfono 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 botón tabla.

crear la directive de datos: 1. Dar clic en el botón tabla. 2. En la ventana

2. En la ventana de Table Search despliega.

3. En el campo Starting At, se ingresa Customer.

4. Seleccionar la opción Search by Table.

5. Clic Search.

P á g

i

n

a

54 | 104

6. En el grid Search Results , select Customer. 7. Clic en OK. Business Process

6. En el grid Search Results, select Customer.

7. Clic en OK.

Business Process Management – Manual Epicor 905.702a

OK. Business Process Management – Manual Epicor 905.702a 8. La tabla Customer dentro del campo Table.

8. La tabla Customer dentro del campo Table.

9. Clic Save en la barra de herramientas.

905.702a 8. La tabla Customer dentro del campo Table. 9. Clic Save en la barra de

P á g

i

n

a

55 | 104

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a

CREAR UNA DIRECTIVA IN-TRANSACTION Y CONDICION

Para crear un directiva pre-processing que valida que el número telefónico:

1. Clic en la flecha Down Arrow en el botón Nuevo; selecciona New In-Transaction Directive. La directiva debe estar “in-transaction” para que la transacción puede detenerse antes de que el registro se actualice sin que el número telefónico se ingrese incorrectamente.

sin que el número telefónico se ingrese incorrectamente. 2. La hoja In-Transaction > Detail despliega. 3.

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 botón Conditions.

Para este ejemplo, se ingresa Check Required Phone Number. 4. Dar Clic en el botón Conditions.

P á g

i

n

a

56 | 104

5. La ventana de Conditions despliega. 6. Clic en el botón Nuevo de la barra

5. La ventana de Conditions despliega.

6. Clic en el botón Nuevo de la barra de herramientas.

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a 7. Desde el campo User Text , selecciona “the

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 condición 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 condición, 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.

13. Damos clic en OK.

el checkbox para el campo PhoneNum . 13. Damos clic en OK. 14. Regresamos a la

14. Regresamos a la ventana de Condiciones. Donde se depliega el valor “Customer.PhoneNum”.

P á g

i

n

a

57 | 104

15. Clic en el segundo “specified” link. Business Process Management – Manual Epicor 905.702a 16.

15. Clic en el segundo “specified” link.

Business Process Management – Manual Epicor 905.702a

link. Business Process Management – Manual Epicor 905.702a 16. La ventana para Specify an expression despliega.

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.

dobles (“”) en el campo Editor , que representan valore en blanco. 18. Dar clic en

P á g

i

n

a

58 | 104

Business Process Management – Manual Epicor 905.702a 19. Regresamos a la ventana de Condiciones. Noten

Business Process Management – Manual Epicor 905.702a

19. Regresamos a la ventana de Condiciones. Noten que la sentencia de la condición despliega “the Customer.PhoneNum field of the changed row is equal to “” the expression”

20. También vean que el campo Error Text esta en blanco; esto significa que la condición es correcta.

21. Clic OK.

esto significa que la condición es correcta. 21. Clic OK . CREAR LA ACCIÓN Para definir

CREAR LA ACCIÓN

Para definir la acción que haga el campo Phone Number requerido:

1. Clic en el botón de acciones.

Para definir la acción que haga el campo Phone Number requerido: 1. Clic en el botón

P á g

i

n

a

59 | 104

Business Process Management – Manual Epicor 905.702a 2. La ventana de acciones despliega. 3. Dar

Business Process Management – Manual Epicor 905.702a

2. La ventana de acciones despliega.

3. Dar clic en el botón 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 acción dar clic en el link “designed”.

sentencia de acción dar clic en el link “designed” . 6. La venta de Design Exception

6. La venta de Design Exception Template despliega la siguiente información.

7. Ingresar el Nombre del mensaje de excepción.

8. Ingresar el Texto a desplegar cuando se cumpla la acción. En este ejemplo, se puede ingresar “Before yo can sabe this customer record, you must enter a phone number”.

9. Clic OK.

record, you must enter a phone number”. 9. Clic OK. 10. Al regresar a la ventana

10. Al regresar a la ventana Acciones. Notando que se despliega “raise exception base don the RequiredPhoneNum template”. Esto indica la acción que se ejecuta cuando la condición se activa.

11. Clic en OK.

P á g

i

n

a

60 | 104

Business Process Management – Manual Epicor 905.702a VALIDANDO LA DIRECTIVA La directiva del método está

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a VALIDANDO LA DIRECTIVA La directiva del método está habilitada

VALIDANDO LA DIRECTIVA

La directiva del método 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 estándar, 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.

3. Dejar el cmapo Phone en blanco. 4. Dar clic en Save . 5. El mensaje

5. El mensaje de error creado se despliega.

6. Dar clic en OK.

P á g

i

n

a

61 | 104

Business Process Management – Manual Epicor 905.702a El mensaje de error está trabajando correctamente. Ahora

Business Process Management – Manual Epicor 905.702a

Business Process Management – Manual Epicor 905.702a El mensaje de error está trabajando correctamente. Ahora los

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 teléfono.

VALIDANDO UN CAMPO DESDE OTRA TABLA

Se puede crear una directiva de método que valide un campo contenido en una tabla diferente desde un método referenciado dentro del objeto de negocio. Durante este ejemplo, se va a crear una directiva de método que va permitir que un registro de proveedor se grabe únicamente si el valor Estado está ligado al campo de la compañía; este valor se encuentra registrado dentro de una tabla definida por el usuario.

UTILIZACIÓN DE UNA TABLA DEFINIDA POR EL USUARIO

P á g

i

n

a

62 | 104

Business Process Management – Manual Epicor 905.702a Para el siguiente ejemplo, primero se debe agregar

Business Process Management – Manual Epicor 905.702a

Para el siguiente ejemplo, primero se debe agregar una tabla definida por el usuario que los códigos de Estado y que estén ligados a la compañía actual dentro de la compañía. 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.

manual Epicor ICE User Experiencie and Customization Guide. RECUPREANDO EL MÉTODO DEL OBJETO DE NEGOCIO Cuando

RECUPREANDO EL MÉTODO 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 método que se referencie a este dato. Para crear esta directiva en el Método Vendor.Update:

En el Menú Principal: System Management -> Business Process Management -> Setup -> Method Directives

1. Clic en el botón Método Code.

Process Management -> Setup -> Method Directives 1. Clic en el botón Método Code. P á

P á g

i

n

a

63 | 104

Business Process Management – Manual Epicor 905.702a 2. En el campo Starting At , ingresa

Business Process Management – Manual 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 upción Update.

6. Clic OK.

Results , selecciona la upción Update . 6. Clic OK . CREAR LA DIRECTIVA Y DEFINIR

CREAR LA DIRECTIVA Y DEFINIR LA CONDICIÓN

1. Dar clic en Flechita hacia abajo que esta junto al botón New ; selecciona Pre-Processing.

1. Dar clic en Flechita hacia abajo que esta junto al botón New ; selecciona Pre-Processing

P á g

i

n

a

64 | 104

Business Process Management – Manual Epicor 905.702a 2. Ingresa un Nombre para la Directiva (Directive

Business Process Management – Manual Epicor 905.702a

2. Ingresa un Nombre para la Directiva (Directive Name). En este ejemplo ingresa Validate Suplier State.

3. Clic en el botón de Condiciones (Conditions).

State. 3. Clic en el botón de Condiciones (Conditions). 4. En la ventana Conditions se abre.

4. En la ventana Conditions se abre.

5. Clic en el botón 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”.

is not less than 1”. 7. Clic en el link “designed” . 8. Se abrirá la

8. Se abrirá la ventana Compose Query.

P á g

i

n

a

65 | 104

Business Process Management – Manual Epicor 905.702a 9. Ingresa el Nombre del Query (Query Name)

Business Process Management – Manual 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 instrucción de consulta debe ser una Cadena, por lo que no agregue ningún retorno duro o suave Entre las diversas partes de la frase. También, No coloque una fecha al final dela declaración.