Ver código fuente

<keywords content="keywords">
assignActivity, asignar activitidad, asignación de actividad, asignacion de actividad, assignActivityAsString, asignar una actividad, asignar una tarea, asignar tarea, asignación de tarea, assign activity string, SOA Layer, SOA, WorkflowEngineSOA, Workflow Engine SOA, workflow engine, workflowengine
</keywords>&nbsp; 

= assignActivity  =

Método del servicio web WorkflowEngineSOA utilizado para asignar (reasignar) una actividad a un usuario, desde una aplicación externa a Bizagi.<br>
Este artículo aplica también para el método '''assignActivityAsString'''. 

== Descripción  ==

Este método provee la posibilidad de asignar a un usuario Bizagi específico, una actividad por medio de la Capa SOA.<br>
La invocación de dicho método es útil para permitir que un caso en determinda actividad prosiga al ser asignado/reasignado a un usuario diferente al asignado actual. <br>
El método '''assignActivity''' recibe y retorna un "XmlDocument", mientras que '''assignActivityAsString''' recibe y retorna un String (texto), el cual contiene la información en formato XML. 

== Parámetros de Entrada  ==

A continuación se enseña el esquema del XML esperado por el método (puede copiarlo directamente de [[Esquemas_Workflow_Engine_Para_Servicios_Web#assignActivity.2C_assignActivityAsString|<u>aquí</u>]]). 

<br>
[[Image:ws_assignactivity_request.png|center|700px]] 
<br>

===== Parámetro 1 (XmlDocument o Tipo String)  =====

'''BizAgiWSParam''': Es el elemento "Nodo raíz". Es de carácter obligatorio.

'''CaseInfo''': Es el elemento de carácter obligatorio que especifica la información requerida para la asignación de una actividad.

'''AssignedByIdUser''': Es el elemento en donde se define el usuario en Bizagi que tiene actualmente asignada la actividad.<br>
Se recomienda que dicho usuario asignado actual sea especificado en este XML. Sin embargo y si este elemento no está presente, se puede optar por incluir el elemento "AssignedByUserName".<br>
Cuando ninguno de estos 2 elementos se especifica, la información por defecto para el usuario asignado actual se tomará como "domain\admon". 

'''AssignedByUserName''': Es el elemento en donde se define el usuario en Bizagi ( y su dominio) que tiene actualmente asignada la actividad.<br>
El formato y valor esperado para este elemento debe incluír el dominio antepuesto por una barra invertida ("backslash").Por ejemplo: "domain\admon".<br>
Se recomienda que dicho usuario asignado actual sea especificado en este XML. Sin embargo y si este elemento no está presente, se puede optar por incluir el elemento "AssignedByIdUser".<br>
Cuando ninguno de estos 2 elementos se especifica, la información por defecto para el usuario asignado actual se tomará como "domain\admon". 

'''IdCase''': Es el elemento en donde se define el caso específico para el cual se desea reasignar una actividad. <br>
Es obligatorio especificar información del caso. Si este elemento no está presente en el XML, entonces se debe optar por definir el elemento "CaseNumber". 

'''CaseNumber''': Es el elemento en donde se define el caso específico para el cual se desea reasignar una actividad. <br>
Es obligatorio especificar información del caso. Si este elemento no está presente en el XML, entonces se debe optar por definir el elemento "IdCase". 

'''IdTask''': Es el elemento en donde se define la tarea específica para la cual se desea reasignar un usuario. <br>
Es obligatorio especificar información de la tarea. Si este elemento no está presente en el XML (por ejemplo si se desconoce el id de la tarea), entonces se debe optar por definir el elemento "TaskName". 

'''TaskName''': Es el elemento en donde se define la tarea específica para la cual se desea reasignar un usuario. <br>
Es obligatorio especificar información de la tarea. Si este elemento no está presente en el XML (por ejemplo si se desconoce el nombre de la tarea), entonces se debe optar por definir el elemento "IdTask". 

'''IdWorkItem''': Es el elemento en donde se define la identificación del registro de "workitem". Esto es, la instancia de la actividad del caso específico.<br>
Su uso es opcional ya que esta definición especifica el caso y actividad a reasignar. Por lo tanto, su definición puede reemplazar la especificación incluída para el caso (IdCase o CaseNumber) y para la tarea (IdTask o TaskName).<br>
Por ejemplo si el IdWorkItem se incluye en el XML, ninguno de los elementos: IdCase, CaseNumber, IdTask o TaskName será necesario.

'''IdUser''': Es el elemento en donde se define el usuario de Bizagi el cual será reasignado a una tarea de un caso. <br>
Es obligatorio especificar información sobre el usuario. Si este elemento no está presente en el XML, entonces se debe optar por definir el elemento "UserName". 

'''UserName''': Es el elemento en donde se define el usuario de Bizagi ( y su dominio) el cual será reasignado a una tarea de un caso. <br>
El formato y valor esperado para este elemento debe incluír el dominio antepuesto por una barra invertida ("backslash").Por ejemplo: "domain\admon".<br>
Es obligatorio especificar información sobre el usuario. Si este elemento no está presente en el XML, entonces se debe optar por definir el elemento "IdUser". 


===== Ejemplo  =====

En el siguiente XML de ejemplo, el usuario '''domain\admon''' estaba a cargo (asignado) a la actividad '''EvaluateRequest''' ("EvaluarSolicitud").
<br>Mediante la invocación del método, esta actividad habrá sido delegada al usuario '''domain\edwardg''' de manera que ahora edwardg tiene la reasignación.

<br>
[[Image:ws_assignactivity_requestexample.png|center]] 
<br>

==  Parámetros de Salida  ==

A continuación se enseña el esquema definido para el XML de retorno (puede copiarlo desde [[Esquemas_Workflow_Engine_Para_Servicios_Web|<u>aquí</u>]]). 
<br>
[[Image:ws_assignactivity_response.png|center|700px]] 
<br>

La respuesta y su formato es diferente de acuerdo a si la ejecución del método es exitoso o no.<br>
Si los datos enviados son correctos y el método se ejecuta satisfactoriamente, entonces el mensaje retornado será: "Reassign succesfull" (es decir, el valor para el elemento '''BizAgiWSResponse''').
<br>
[[Image:ws_assignactivity_responseexampleOK.png|center]] 
<br>

De lo contrario, si los datos en la invocación no corresponden, la respuesta tendrá un detalle del error.
<br>
[[Image:ws_assignactivity_responseexampleERROR.png|center]] 
<br>

Para este escenario, los elementos en la respuesta son:

'''processes''':  Es el elemento "Nodo raíz". Contiene en XML la información de respuesta.

'''process''': Es el elemento que contiene mayor detalle del error en invocación.

'''processId''': Contiene el id del proceso. 

'''processRadNumber''': Contiene el valor alfanumérico que corresponde al número de creación del caso (radicación).

'''processError''': Contiene la descripción del error (código y mensaje) del intento de asignación de la actividad.

'''errorCode''': Contiene el código del error. 

'''errorMessage''': Contiene el mensaje del error. 


<br>
<br>

[[Capa_SOA|<u>Ver información sobre la Capa SOA</u>]]
<comments />