Crear Usuarios

<< 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 EntityManagerSOA >

Crear Usuarios

Introducción

Este método se utiliza para crear usuarios en Bizagi (desde una aplicación externa).

Este método recibe un único parámetro de entrada el cual contiene los valores de los atributos del usuario.

 

En el método CreateUser, los XMLs de petición y de respuesta son de tipo XmlDocument nativo de .NET.

En el método CreateUserAsString 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 envía a Bizagi debe ser cumplir con este XSD:

 

<?xml version="1.0"?>

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

 <xs:element name="BizAgiWSParam">

         <xs:complexType>

                 <xs:sequence>

                         <xs:element name="Entities" maxOccurs="1">

                                 <xs:element name="WFUSER" minOccurs="1" maxOccurs="unbounded">

                                         <xs:element name="BasicInformation" minOccurs="0" maxOccurs="1">

                                                 <xs:complexType/>

                                         </xs:element>        

                                         <xs:element name="UserConfiguration" minOccurs="0" maxOccurs="1">

                                                 <xs:complexType/>

                                         </xs:element>

                                 </xs:element>

                         </xs:element>

                 </xs:sequence>

         </xs:complexType>

 </xs:element>

</xs:schema>

 

Parámetros de entrada

BizAgiWSParam: Es el nodo raíz del XML.

Entities: Es el subnodo raíz del XML.

WFUSER: Es el nodo raíz del usuario que se va a crear.

BasicInformation: Contiene la información básica del usuario que va a ser creado, los nodos requeridos son UserName, FullName, Domain, Organization y ContactEmail.

UserConfiguration: Contiene la información de la configuración del usuario que va a ser creado (como Roles, Area, Location, IdDelegate),

 

Ejemplo de Entrada

Con el siguiente ejemplo, se crearán dos usuarios:

 

note_pin

Asegúrese de enviar la imagen de perfil del usuario (parámetro Picture) codificado utilizando Base64. Usted puede codificarlo utilizando cualquiera de los codificadores gratis que se encuentra en línea o desarrollando uno desde cero.

 

Método CreateUser
<BizAgiWSParam>

<Entities>

<WFUSER>

 <BasicInformation>

         <FullName>Juliette Leroy</FullName>

         <UserName>juliettel</UserName>

         <Domain>agilityCorp</Domain>

         <ContactEmail>juliettel@agilityCorp.com</ContactEmail>

         <Organizations>

                 <Organization>1</Organization>

         </Organizations>

 </BasicInformation>

 <UserConfiguration></UserConfiguration>

</WFUSER>

<WFUSER>

 <BasicInformation>

         <FullName>Kirby Lovett</FullName>

         <UserName>klovett</UserName>

         <Domain>agilityCorp</Domain>

         <ContactEmail>klovett@agilityCorp.com</ContactEmail>

         <Password>Bizagi123</Password>

         <Picture>/9j/4AAQSkZJRgABAQEAYABgAAD/4QHGRXhpZgAATU0AKgAAA..</Picture>

         <Organizations>

                 <Organization>1</Organization>

         </Organizations>

 </BasicInformation>

 <UserConfiguration>        

         <Roles>

                 <idRole key="1"></idRole>

                 <idRole key="9998"></idRole>

         </Roles>

         <idArea key="1"></idArea>

         <idLocation key="1"></idLocation>

         <Positions>

                 <Position>1</Position>

         </Positions>

         <Enabled>1</Enabled>

         <EnabledForAssignation>0</EnabledForAssignation>

 </UserConfiguration>

</WFUSER>

</Entities>

</BizAgiWSParam>

 

Método CreateUserAsString

<entityInfo>

  <![CDATA[<BizAgiWSParam>

  <Entities>

  <WFUSER>

  <BasicInformation>

  <FullName>Juliette Leroy</FullName>

  <UserName>juliettel</UserName>

  <Domain>agilityCorp</Domain>

  <ContactEmail>juliettel@agilityCorp.com</ContactEmail>

  <Organizations>

  <Organization>1</Organization>

  </Organizations>

  </BasicInformation>

  <UserConfiguration></UserConfiguration>

  </WFUSER>

  <WFUSER>

  <BasicInformation>

  <FullName>Kirby Lovett</FullName>

  <UserName>klovett</UserName>

  <Domain>agilityCorp</Domain>

  <ContactEmail>klovett@agilityCorp.com</ContactEmail>

  <Password>Bizagi123</Password>

  <Picture>/9j/4AAQSkZJRgABAQEAYABgAAD/4QHGRXhpZgAATU0AKgAAA..</Picture>

  <Organizations>

  <Organization>1</Organization>

  </Organizations>

  </BasicInformation>

  <UserConfiguration>        

  <Roles>

  <idRole key="1"></idRole>

  <idRole key="9998"></idRole>

  </Roles>

  <idArea key="1"></idArea>

  <idLocation key="1"></idLocation>

  <Positions>

  <Position>1</Position>

  </Positions>

  <Enabled>1</Enabled>

  <EnabledForAssignation>0</EnabledForAssignation>

  </UserConfiguration>

  </WFUSER>

  </Entities>

  </BizAgiWSParam>]]>

</entityInfo>

 

Datos de salida

 

Esquema y Parámetros de salida

La estructura del XML que se retorna en Bizagi cumple con este XSD:

 

<?xml version="1.0"?>

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

 <xs:element name="Entities">

         <xs:complexType/>

 </xs:element>

</xs:schema>

 

Los elementos al interior de Entities, corresponden a la estructura (atributos y relaciones) de la Entidad, como se define en Bizagi.

 

Ejemplo de Salida

Con el siguiente ejemplo, se ilustra la respuesta que retorna la invocación de este método en Bizagi.

 

Método CreateUser

CreateUserAsString_01

 

Método CreateUserAsString

CreateUserAsString_02

 

Métodos Web relacionados

Para actualizar la información de un usuario, se recomienda utilizar el método saveEntityAsString, ya que este método puede actualizar información de la entidad WFUSER.

Para más información sobre esta opción, consulte el método saveEntity.