Introducción
Este método Web se utiliza para asignar usuarios privilegiados a caso en Bizagi (desde una aplicación externa).
Este método recibe una entrada sencilla, teniendo principalmente: cualquier número de Nombres de Usuario de los usuarios que serán agregados como usuarios privilegiados y el número de caso respectivo.
A través de este método, se agrega un usuario a una lista de usuarios privilegiados que tienen accesos a una instancia de Proceso (caso). Los valores enviados deben conocerse con anticipación y deben ser enviados desde un sistema externo
Para mayor información sobre otorgar acceso a caso, consulte Seguridad del Caso.
•Para el método grantCaseAccess, los XMLs de petición y de respuesta son de tipo XmlDocument nativo de .NET.
•Para el método grantCaseAccessAsString se maneja la misma estructura XML pero los parámetros son enviados como un tipo cadena de texto por medio de CDATA.
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="CaseAccessXML" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Parámetros de entrada
•BizAgiWSParam: Nodo raíz.
•CaseAccessXML: Incluya aquí la información (en estructura XML) de los casos donde quiere agregar usuarios a la lista de usuarios privilegiados con acceso a dichos casos.
Para más información sobre la estructura esperada de los elementos dentro de Entities, consulte cómo se representan el modelo de datos del Proceso en Esquema XML de Bizagi para el modelo de datos.
Ejemplo de entrada
Dentro del siguiente XML de ejemplo, los usuarios dtaylor y efeller serán agregados al caso 354. Para otorgar acceso al caso, este no puede estar cerrado y debe existir.
Entrada del método GrantCaseAccess
<![CDATA[<BizAgiWSParam>
<CaseAccess idCase='354'>
<UserName>domain\dtaylor</UserName>
<UserName>domain\efeller</UserName>
</CaseAccess>
</BizAgiWSParam>]]>
Entrada del método GrantCaseAccessAsString
<caseAccessXML>
<![CDATA[<BizAgiWSParam>
<CaseAccess idCase='354'>
<UserName>domain\dtaylor</UserName>
<UserName>domain\efeller</UserName>
</CaseAccess>
</BizAgiWSParam>]]>
</caseAccessXML>
Datos de salida
Output Schema
The following shows a sample XML structure of information returned by Bizagi:
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
</xs:schema>
Parámetros de salida
•ErrorMessage: Mensaje explicando por qué ocurrió el error. Es visible cuando el error es causado por información errada.
•CaseAccess: Casos procesados durante la invocación.
Ejemplo de salida
En el siguiente ejemplo, ilustraremos una respuesta retornada en estructura XML desde la capa SOA de Bizagi, en el cual podemos ver:
•El conjunto de usuarios ha sido agregado al caso 354.
•El usuario no pudo ser agregado. Dentro de la respuesta, se encuentra el detalle del error en ErrorMessage en el cual, el servicio informa que el caso 3294 no existe o está cerrado.
Métodos Web relacionados
SI desea revocar el acceso a un caso, utilice los métodos Web revokeCaseAccessAsString o revokeCaseAccess.
Para más información, consulte el artículo Revocar acceso a Casos.
Last Updated 1/28/2022 4:02:27 PM