De

<keywords content="keywords">performActivity, performactivity, performActivityAsString, performactivityasstring, perform Activity, avanzar actividad, Capa SOA, capa soa, WorkflowEngineSOA, workflowenginesoa, Workflow Engine SOA, workflow engine soa</keywords> 

performActivity

Método del Servicio Web WorkflowEngineSOA utilizado para avanzar una actividad desde una aplicación externa, haciendo posible la continuación de un caso. Este artículo aplica también para el método performActivityAsString.

Descripción

Este método permite continuar con un caso en Bizagi usando un XML como parámetro de entrada, y al mismo tiempo es posible almacenar información de negocio en la actividad que se está avanzando. El método performActivity recibe y retorna un XmlDocument mientras que performActivityAsString recibe y retorna un XML con formato string.

Parámetros de Entrada

A continuación se puede apreciar el esquema del XML esperado (para copiarlo haga click en el siguiente link):

Parámetro 1 (XmlDocument o Tipo String)

BizAgiWSParam: Nodo raíz, contiene toda la información necesaria para avanzar la actividad.

domain: Nombre del dominio al cual pertenece el usuario de Bizagi que aparecerá como aquel que avanzó la Actividad.

userName: Nombre del usuario que será registrado como el usuario que avanzó la actividad.

ActivityData: Contiene toda la información correspondiente a la actividad. Esta información es necesaria para encontrar dicha actividad.

idCase: Número de identificación del caso para la actividad que se desea avanzar. Es necesario incluir este elemento o el Número de Radicación (radNumber).

radNumber: Elemento alternativo al idCase. Es el número de creación (case number) del caso que contiene la actividad pediente que se desea avanzar.Cuando se usa el mismo número de creación en varios casos (por ejemplo, si un subproceso tiene el mismo número que el caso padre) se debe usar el número del caso (idCase) para distinguir a cual caso pertenece la actividad.

taskId: Número de identificación de la Actividad que se desea avanzar. Este elemento es necesario; si no se conoce el número, se debe incluir el nombre de la tarea (taskName).

taskName: Usado como elemento alternativo al id de la tarea (taskId). Es el nombre de la actividad pendiente que se desea avanzar.

Entities: Nodo que contiene los valores de las información de negocio que será asociada al caso.

Ejemplo

Con el siguiente XML el usuario domain\Raulp desea avanzar la tarea llamada Task3 para el caso número 9253. De igual forma, se actualizará la información del atributo BuroScore con el valor 27:

Parámetros de Salida

A continuación se muestra el esquema del XML de respuesta (también puede copiarse desde el siguiente link):

La respuesta incluye información básica del caso (y del proceso) que se acaba de avanzar. A continuación se encontrará la descripción de cada uno de los elementos que se encuentran en el XML de respuesta.

process: Este elemento incluye información del proceso.

processId: Número de identificación del caso (idCase).

processRadNumber: Valor Alfanumérico correspondiente al número de creación del caso.

savedMessage: Reservado para uso futuro.

Entities: Reservado para uso futuro.

processWorkflowClass: Este nodo contiene información del proceso (metadata), no información de un caso en particular.

workflowClassId: Número de identificación (o llave) del proceso.

workflowClassName: Nombre del proceso.

workflowClassDisplayName: Nombre a mostrar del proceso.

workflowClassDescription: Descripción del proceso.

workflowClassHelpText: Texto de ayuda del proceso.

workflowClassHelpURL: URL de ayuda del proceso.

workflowClassDisplayOrder: Orden en el cual aparecerán los procesos en Bizagi Studio.

workflowClassCreationDate: Fecha de creación del proceso.

workflowClassGlobalForm: Número de identificación de la forma global del proceso (cero en caso de no estar configurada).

workflowClassAllocationPrinciple: Reservada para uso futuro.

workflowClassProcessType: Tipo de proceso.

workflowClassDisplay: Indica si un proceso es o no visible.

workflowClassUseParentRadicationNumber: Indica si un caso del proceso utiliza su propio número de creación si usa el mismo número que el del proceso padre (en caso de ser un subproceso).

processError: Si el proceso de avanzar la actividad no fue exitoso, este elemento contendrá la información del error.

errorCode: Código del error, si no hubo error, este nodo estará vacío.

errorMessage: Mensaje del error presentado, si no hubo error este nodo estará vacío.

Path: XPath del elemento en el XML de entrada que genera el error . Visible cuando el error se presenta por información incorrecta.

Attrib: Nombre del atributo en Bizagi donde se intentó almacenar la información que generó el error. Este nodo es visible únicamente cuando el error es generado por información incorrecta.

Value: Valor que generó el error. Este nodo es visible únicamente cuando el error es generado por información incorrecta.

ErrorMessage: Mensaje explicatorio sobre el error. Visible si el error fue generado por información incorrecta.

CurrentWorkItems: Serie de actividades desponibles para el caso.

workItem: Actividad específica (instancia de la tarea) del proceso que se encuentra activo para el caso.

workItemId: Número de identificación o llave de la actividad.

workItemState: Estado en el que se encuentra la actividad.

workItemEntryDate: Fecha y hora en la cual se llega a la actividad por primera vez.

workItemDuration: Duración estimada, en minutos, para la actividad.

workItemEstimatedSolutionDate: Fecha estimada de solución del caso.

Task: Contiene información sobre la tarea asociada a la actividad.

taskId: Número de identificación o llave de la tarea.

taskName: Nombre de la tarea.

taskDisplayName: Nombre a mostrar de la tarea.

taskDescription: Texto descriptivo de la tarea.

taskHelpText: Texto de ayuda de la tarea.

taskEstimatedDuration: Duración estimada de la tarea, en minutos.

taskType: Tipo de tarea.

taskCost: Costo estimado de la tarea. Este valor, al igual que las fechas estimadas, es configurado y determinado por la persona que diseña el proceso.

taskPriority: Prioridad para el cumplimiento de la tarea.

Ejemplo

A continuación se presenta el XML de respuesta al ejemplo presentado anteriormente:

Dado que este método tiene el mismo efecto que hacer click en el botón siguiente en la interfaz del usuario, dentro del elemento CurrentWorkItems se encuentra información de la actividad (Task2) a la cual llega el caso 9253 luego que se avanza la actividad llamada Task3.

Artículos relacionados

• Como avanzar una actividad utilizando la Capa SOA

Ir a la capa SOA <comments />