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:

Entrada del 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>

Entrada del 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.

Salida del método CreateUser

Salida del método CreateUserAsString

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.