Introducción
Este método se utiliza para abortar (cancelar) uno o más casos en Bizagi (desde una aplicación externa).
Este método recibe un único parámetro de entrada el cual contiene principalmente: el identificador del caso (puede ser más de un caso) y una razón detallada del motivo de porqué abortar esos casos, de la misma manera como se presenta esta opción desde las opciones administrativas del Portal de Trabajo.
Para más información acerca de esta opción en el Portal, consulte Portal de Trabajo de Bizagi.
•En el método abortCases, los XMLs de petición y de respuesta son de tipo XmlDocument nativo de .NET.
•En el método abortCasesAsString se maneja la misma estructura XML pero los parámetros son enviados como un tipo cadena de texto por medio de CDATA.
|
Todos los casos que tengan el mismo radNumber serán abortados. Si hay procesos y subprocesos, todos se abortarán. |
Datos de entrada
Esquema de entrada
La estructura del XML que se envia a Bizagi debe ser cumplir con este XSD:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="BizAgiWSParam">
<xs:complexType>
<xs:sequence>
<xs:element name="domain" type="xs:string" minOccurs="0"/>
<xs:element name="userName" type="xs:string" minOccurs="0"/>
<xs:element name="cases">
<xs:complexType>
<xs:sequence>
<xs:element name="case" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="radNumber" type="xs:unsignedShort"/>
<xs:element name="abortReason" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Parámetros de entrada
•BizAgiWSParam: Nodo raíz.
•domain: Contiene el nombre del dominio del usuario Bizagi que será registrado como el usuario que cancela el caso.
•userName: Contiene el nombre (usado en Bizagi) del usuario, que será registrado como el usuario que cancela el caso.
•cases: Este elemento se incluye para agrupar varios elemento case dependiendo del número de casos que se van a cancelar.
•case: Se incluye la información del caso que se va a cancelar.
•radNumber: Se refiere al número de creación del caso. Este parámetro es obligatorio cuando no se envía idCase.
•idCase: Se refiere al identificador del caso. Utilice este parámetro cuando el radNumber no esté disponible.
•abortReason: Contiene los motivos de la cancelación del caso.
Ejemplo de entrada
Con el siguiente ejemplo, se cancelarán dos casos por el domain\admon.
Sugerimos que use Cómo iniciar Procesos en Bizagi desde otras aplicaciones como una guía para invocar este servicio.
Entrada del método AbortCases
<BizAgiWSParam>
<domain>domain</domain>
<userName>admon</userName>
<cases>
<case>
<idCase>8951</idCase>
<abortReason>Invalid case</abortReason>
</case>
<case>
<radNumber>9001</radNumber>
<abortReason>Test case</abortReason>
</case>
</cases>
</BizAgiWSParam>
Entrada del método AbortCasesAsString
<info>
<![CDATA[<BizAgiWSParam>
<domain>domain</domain>
<userName>admon</userName>
<cases>
<case>
<idCase>1</idCase>
<abortReason>Invalid case</abortReason>
</case>
<case>
<radNumber>9001</radNumber>
<abortReason>Test case</abortReason>
</case>
</cases>
</BizAgiWSParam>]]>
</info>
Datos de salida
Esquema de salida
La estructura del XML que se retorna en Bizagi cumple con este XSD:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="unqualified" attributeFormDefault="qualified">
<xs:element name="Processes">
<xs:complexType>
<xs:sequence>
<xs:element name="Process" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="ProcessId" type="xs:integer"/>
<xs:element name="ProcessRadNumber" type="xs:string"/>
<xs:element name="ProcessCreationDate" type="xs:dateTime"/>
<xs:element name="ProcessSolutionDate" type="xs:dateTime"/>
<xs:element name="ProcessWorkflowClass">
<xs:complexType>
<xs:sequence>
<xs:element name="workflowClassId" type="xs:integer"/>
<xs:element name="workflowClassName" type="xs:string"/>
<xs:element name="workflowClassDisplayName" type="xs:string"/>
<xs:element name="workflowClassDescription" type="xs:string"/>
<xs:element name="workflowClassHelpText" type="xs:string"/>
<xs:element name="workflowClassHelpURL" type="xs:string"/>
<xs:element name="workflowClassDisplayOrder" type="xs:unsignedByte"/>
<xs:element name="workflowClassCreationDate" type="xs:dateTime"/>
<xs:element name="workflowClassGlobalForm" type="xs:integer"/>
<xs:element name="workflowClassAllocationPrinciple" type="xs:string"/>
<xs:element name="workflowClassProcessType" type="xs:string"/>
<xs:element name="workflowClassDisplay" type="xs:boolean"/>
<xs:element name="workflowClassUseParentRadicationNumber" type="xs:boolean"/>
<xs:element name="workflowClassSupportsScopes" type="xs:boolean"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ProcessError">
<xs:complexType>
<xs:sequence>
<xs:element name="errorCode" type="xs:integer"/>
<xs:element name="errorMessage" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Parámetros de salida
•processes: Nodo raíz.
•process: Este elemento se incluye para cada caso que se ha cancelado.
•processId: Número de identificación del caso (idCase).
•processRadNumber: Valor Alfanumérico que corresponde al número de creación del caso.
•processCreationDate: Fecha de creación del caso.
•processSolutionDate: Fecha de solución del caso.
•processWorkflowClass: Este nodo contiene información del proceso (metadata). No es información del 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: El orden en el cual aparece el proceso en la aplicación web.
•workflowClassCreationDate: Fecha de creación del proceso.
•workflowClassGlobalForm: Número de identificación de la forma global del proceso (cero si no está configurada).
•workflowClassAllocationPrinciple: Reservado para una funcionalidad posterior.
•workflowClassProcessType: Tipo de proceso.
•workflowClassDisplay: Indica si el proceso es visible o no.
•workflowClassUseParentRadicationNumber: Indica si un caso de este proceso utiliza su propio número de creación o si es el mismo número que el proceso padre (para subprocesos).
•processError: Si se presentó un error en el momento de cancelar un caso, este elemento mostrará información del error.
•errorCode: Código del error presentado, Si no hubo error, este nodo estará vacío.
•errorMessage: Mensaje del error presentado. Si no hubo error, este nodo estará vacío.
Ejemplo de salida
Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocación de este método en Bizagi.
Salida del método AbortCasesAsString
•Para el caso con identificador 8951, abortar el caso es una operación exitosa.
•Para el caso con identificador 9001, el cual fue abortado anteriormente, el mensaje de respuesta indica que la posibilidad de abortarlo no está disponible.
Salida del método AbortCasesAsString
•Para el caso con identificador 1, abortar el caso es una operación exitosa.
•Para el caso con identificador 9001, el cual no existe, el mensaje de respuesta indica que el caso no existe.
