Otorgar acceso a Casos

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > Servicios web SOAP > Servicios web SOAP disponibles > Métodos Web de WorkflowEngineSOA >

Otorgar acceso a Casos

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.

 

Input

 

Input Schema

The following shows a sample XML structure of information to send to Bizagi:

 

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">

 

</xs:schema>

 

Input Parameters

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

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.

 

Método grantCaseAccess

<![CDATA[<BizAgiWSParam>

 <CaseAccess idCase='354'>

         <UserName>domain\dtaylor</UserName>

         <UserName>domain\efeller</UserName>

 </CaseAccess>

</BizAgiWSParam>]]>

 

Método grantCaseAccessAsString

<caseAccessXML>

 <![CDATA[<BizAgiWSParam>

         <CaseAccess idCase='354'>

                 <UserName>domain\dtaylor</UserName>

                 <UserName>domain\efeller</UserName>        

         </CaseAccess>

 </BizAgiWSParam>]]>

</caseAccessXML>

 

Output

 

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

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.

 

GrantCaseAccess_01

 

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.

 

GrantCaseAccess_03

 

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.