Toda la información de producto en wiki.bizagi.com aplica para Bizagi BPM Suite 9.1.X.
Para las nuevas versiones de Bizagi BPM Suite (10.X y superior) visite la Guía de Usuario.
 

Lista de Funciones

De

<keywords content="keywords">setEvent, CHelper, suspendprocess, resumeprocess, newcase, getsubprocessid, abortprocess, getassignedworkitems, funciones, CMailer, sendEmail, trace</keywords>

Contenido

Funciones Bizagi Relacionadas a Eventos

setEvent

Esta función dispara la ejecución de un evento dentro del proceso.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id de Caso donde el evento a ser disparado es encontrado.

sEventName: Nombre de la tarea (evento) a ser disparado

htProperties: null

 

Ejemplo:  setEvent (Me, 7700, “DocumentReceived”, null);



setEvent

Esta función dispara la ejecución de un evento dentro del proceso.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id de Caso donde el evento a ser disparado es encontrado.

iEventTaskId: Id de la Tarea Evento.

htProperties: null

Example: setEvent (Me, 7700, 77, null);


Funciones Bizagi Relacionadas a Procesos

Las opciones que definen el comportamiento del proceso padre y sub-procesos para las funciones que suspenden o reactivan un proceso son las siguientes:

  • EProcessSuspendResumeOptions.OnlyProcess: Suspende o reactiva los procesos y sus sub-procesos.
  • EProcessSuspendResumeOptions.ProcessAndParentProcess: Suspende o reactiva los procesos y sus sub-procesos y al proceso padre y sus sub-procesos, que también puede ser definido como los "hermanos" del procesos que esta siendo suspendido o reactivado.
  • EProcessSuspendResumeOptions.NotProcessAndParentProcess: Suspende o reactiva el proceso padre y sus sub-procesos, específicamente, a los "hermanos" del procesos que esta siendo suspendido o reactivado, pero no el proceso a sí mismo.


CHelper.suspendProcess

Esta función suspende un proceso.

Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a suspender

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente.


Ejemplo:

CHelper.suspendProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess, 7);


CHelper.suspendProcess

Esta función suspende un proceso y notifica a los procesos, asignados actualmente y previamente, sobre la suspensión.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser suspendido

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente.

iTemplateId: Id de la Plantilla de Notificación.



Ejemplo:

CHelper.suspendProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess, 7);

 

CHelper.suspendProcess

Esta función suspende un proceso y notifica a los procesos actualmente y previamente asignados sobre la suspensión. El valor especificado para la plantilla y la entidad es usado para la notificación.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser suspendido

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente.

iTemplateId: Id de la plantilla de notificación.

sRootEntityName: Nombre de la entidad contextual usada para resolver la plantilla.

oSurrogateKey: Valor de la llave de la entidad contextual.


Ejemplo:

CHelper.suspendProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess, 7);


CHelper.resumeProcess

Esta función reactiva un proceso suspendido.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser reactivado.

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente.


Ejemplo:

CHelper.resumeProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess);


CHelper.resumeProcess

Esta función reactiva un proceso y notifica a los procesos asignados actualmente o previamente sobre la reactivación.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser reactivado.

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente..

iTemplateId: Id de la plantilla de notificación.


Ejemplo:

CHelper.resumeProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess, 7);


CHelper.resumeProcess

Esta función reactiva un proceso y notifica a los procesos asignados actualmente y previamente sobre la suspensión. El valor especificado para la plantilla, de la entidad, está especificado para la notificación.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser reactivado.

eSuspendResumeOptions: Este parámetro debe corresponder a uno de los valores de las opciones definidas previamente.

iTemplateId: Id de la plantilla de notificación.

sRootEntityName: Nombre de la entidad contextual usado para resolver la plantilla.

oSurrogateKey: Valor de la llave de la entidad contextual.


Ejemplo:

CHelper.resumeProcess(Me, 7700, EProcessSuspendResumeOptions.OnlyProcess, 7);



CHelper.NewCase

Esta función crea un nuevo caso para el tipo especificado y devuelve la entidad de la aplicación del nuevo caso.


Parámetros de Entrada:

Me: Contexto de la Actividad

idWFClass: Id de la Clase del flujo a ser creado.


Ejemplo: var appEnt = CHelper.NewCase(Me, 7);



CHelper.NewCase

Esta función crea un nuevo caso del tipo especificado. El creado del caso corresponde al usuario especificado. Esta función también devuelve la entidad de la aplicación del nuevo caso.


Parámetros de Entrada:

to idUser: Id del usuario creador del caso.

idWFClass: Id de la Clase del flujo a ser creado..


Ejemplo: var appEnt = CHelper.NewCase(70, 7);



CHelper.NewCase

Esta función permite crear un nuevo caso basándose en información incluida en el parámetro de entrada (string XML). En este parámetro, es posible incluir información sobre el usuario creador del caso así como información de negocio. Por ejemplo, si se va a crear un caso de Actualización De Datos, los datos de nombre de cliente y otros podrían incluirse en el parámetro (string xml) de entrada.

Esta función también retorna un string con la información acerca del estado del caso como actividades, eventos activos así como errores durante la creación del mismo.

Los esquemas de los parámetros de entrada y salida de esta función pueden encontrarse en este link.



Parámetros de entrada:

Xml string : Es posible crear el string con el formato XML en la misma expresión que crea el caso, como en el siguiente ejemplo :


image:CreateCases-1.jpg




CHelper.getSubProcessesId

Esta función devuelve un conjunto con los id's de los sub-procesos del caso actual.


Parámetros de Entrada:

Me: Contexto de la Entidad


Ejemplo:

var alSubProcs = CHelper.getSubProcessesId(Me); for (var idSubProc in alSubProcs) {       CHelper.abortProcess(Me, idSubProc, EProcessAbortOptions.OnlyProcess); }



CHelper.getSubProcessesId

Esta función devuelve un conjunto con los id's de los sub-procesos del caso actual, que pertenecen a la clase de flujo especificado.


Parámetros de Entrada:

Me: Contexto de la organización

sWfClassName: Nombre de la clase del flujo de trabajo de los sub-procesos a ser obtenidos.


Ejemplo:

var alSubProcs = CHelper.getSubProcessesId(Me, "Credit"); for (var idSubProc in alSubProcs) {       CHelper.abortProcess(Me, idSubProc, EProcessAbortOptions.OnlyProcess); }



CHelper.getSubProcessesId

Esta función devuelve un conjunto con los id's de los sub-procesos del caso actual, que pertenecen a la clase de flujo especificado.


Parámetros de Entrada:

Me: Contexto de la Entidad

iWfClassId: Nombre de la clase del flujo de trabajo de los sub-procesos a ser obtenidos.


Ejemplo:

var alSubProcs = CHelper.getSubProcessesId(Me, 747); for (var idSubProc in alSubProcs) {       CHelper.abortProcess(Me, idSubProc, EProcessAbortOptions.OnlyProcess); }



CHelper.abortProcess

Anula el caso especificado. La anulación de un caso consiste en cerrar el caso con un estado abortado.


Parámetros de Entrada:

Me: Contexto de la Actividad

iCaseId: Id del caso a ser anulado.

eAbortOptions: Este parámetro corresponde a uno de las siguientes opciones:


  • EProcessAbortOptions.OnlyProcess: Anula los procesos y sus-procesos.
  • EProcessAbortOptions.ProcessAndParentProcess: Anula los procesos y sus sub-procesos y al proceso padre y sus sub-procesos, específicamente, a los "hermanos" del proceso abortado.
  • EProcessAbortOptions.NotProcessAndParentProcess: Anula al proceso padre y sus sub-procesos, específicamente, a los "hermanos" del proceso abortado, pero no el proceso a sí mismo.


Ejemplo:

CHelper.abortProcess(Me, 740, EProcessAbortOptions.OnlyProcess);



CHelper.abortProcess

Esta función aborta el caso especificado. La anulación de un caso consiste en cerrar el caso con un estado abortado.


Parámetros de Entrada:

Me: Contexto de la Actividad.

iCaseId: Id del caso a ser abortado.

eAbortOptions: Este parámetro debe corresponder a uno de las siguientes opciones


  • EProcessAbortOptions.OnlyProcess: Anula los procesos y sus sub-procesos.
  • EProcessAbortOptions.ProcessAndParentProcess: Anula a los procesos y sus sub-procesos y al proceso padre y sus sub-procesos, específicamente, a los "hermanos" del proceso abortado, pero no el proceso a sí mismo.
  • EProcessAbortOptions.NotProcessAndParentProcess: Anula al proceso padre y sus sub-procesos, específicamente, a los "hermanos" del proceso abortado.
  • sAbortReason: Razón por la cual el proceso es anulado


Ejemplo:

CHelper.abortProcess(Me, 740, EProcessAbortOptions.OnlyProcess, "Este caso es el resultado de una falla del sistema externo");



CHelper.getAssignedWorkItems

Esta función devuelve un conjunto con ítems de trabajo del caso especificado, que son asignados para el usuario especificado.


Parámetros de Entrada:

Me: Contexto de la Actividad.

iCaseId: Id del Caso.

iCurrAssigneeId: Id del Usuario.

bIncludeSubProcs: Determina si las actividades encontradas dentro de los sub-procesos del caso son incluidos en los resultados.


Ejemplo:

var alWorkItems = CHelper.getAssignedWorkItems(Me, 7447, 157, true); for (var workItem in alWorkItems) {     trace("test-001", workItem.Name); }



Funciones de Bizagi Relacionadas a Notificaciones


CMailer.sendEmail

Esta función envía una notificación usando la plantilla especificada.


Parámetros de Entrada:

sMail: Dirección de correo electrónico del destinatario.

iTemplateId: Id de la plantilla del mensaje.

sEntityName: Entidad contextual para la resolución de la plantilla.

iEntityKey: Valor de la Llave de la entidad contextual.


Ejemplo:

var Mail = <idRequest.idApplicant.email>; CMailer.sendEmail(Mail, 19, "Recoger", Me.Case.Id);


Nota: El caso previo de la función CMailer.sendEmail corresponde a la llamada usada por los procesos sin alcances (Bizagi 8.x). Para procesos con alcance (Bizagi 9.x), la llamada debe ser reemplazada de la siguiente manera:




CMailer.sendEmail

Esta función envía una notificación usando la plantilla especificada.


Parámetros de Entrada:

sMail: Dirección de correo electrónico del destinatario.

iTemplateId: Id de la plantilla del mensaje.

xPath: Ruta (xPath) desde la entidad de contexto de la regla, que llama la función, a la entidad de contexto de la plantilla. Si ambos contextos son iguales, luego este parámetro corresponde a una cadena vacía.

Me: Contexto de la Actividad.


Ejemplo:var Mail = <idRequest.idApplicant.email>; CMailer.sendEmail(Mail, 19, "idSRequest", Me);


 


Trace: CHelper.trace


Trace es una función Bizagi que le permite al usuario determinar el valor de una variable o atributo usado en una regla en un punto específico del tiempo. Esta función esta incluida en las reglas de negocio y genera un archivo .txt con el nombre y el valor de la variable o atributo indicado en la función.


La función recibe dos parámetros de tipo String:

CHelper.trace(“Nombre del Archivo”, “Atributos o Variables”);

 

Ejemplo: Si usted quisiera saber el valor del atributo idClient y de la variable NoLoansRequested en un momento dado:

CHelper.trace(“RuleX”, “idClient “ + <idRequest.idClient> + “No Loans “ + NoLoansRequested); 

 

La ubicación en el Servidor de Aplicaciones del archivo que es generado con la función Trace es::


Image:Bulletazul.gif C:\Bizagi\Express\Projects\"Nombre del Proyecto"\Trace

NotA:NO USE LA EXPRESIÓN trace("FileName","Attribute"). Siempre use CHelper.trace("FileName","Attribute")

<comments />