Referencia a la API SOAP › Métodos de servicios Web › controlInstance

controlInstance

Utilice este método para crear una solicitud de SOAP para controlar una instancia. El método controlInstance especifica el archivado del proceso o de los formularios de solicitud de inicio (y todas sus instancias hijo) que no se activan en el modo separado. Este método no envía un fallo si un proceso o un formulario de solicitud de inicio ya están marcados para su archivado. El método controlInstance envía un fallo cuando no se encuentra un proceso o formulario de solicitud de inicio con el ID especificado.

Para ejecutar un método controlInstance, utilice una de las opciones siguientes:

• rootUUID: esta opción especifica el UUID de raíz del proceso o del formulario de solicitud de inicio.
• instanceId: esta opción especifica el ID de instancia del proceso o del formulario de solicitud de inicio.
• tagID: esta opción especifica el ID de etiqueta del formulario de solicitud de inicio o proceso.

Ejemplo

<tns:controlInstance xmlns:tns="http://www.ca.com/itpam"> 
  <tns:auth> 
<!--xsd:Choice Type--> 
<tns:token>token__</tns:token> 
<tns:user>user__</tns:user> 
<tns:password>password__</tns:password> 
  </tns:auth> 
  <!--xsd:Choice Type--> 
  <tns:instanceId>instanceId__</tns:instanceId> 
  <tns:action>archive</tns:action> 
</tns:controlInstance> 

Solicitud de SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:itp="http://www.ca.com/itpam">
   <soapenv:Header/>
   <soapenv:Body>
      <tns:controlInstance>
        <tns:auth>
	<!--xsd:Choice Type-->
	<tns:token>token__</tns:token>
         <tns:user>Joe</tns:user>
         <tns:password>thisismypassword</tns:password>
        <tns:auth>
	<!--xsd:Choice Type-->
        <tns:instanceId>3186</tns:instanceId>
        <tns:action>archive</tns:action>
      </tns:controlInstance>
   </soapenv:Body>
</soapenv:Envelope>

<rootUUID> especifica el rootUUID del formulario de solicitud de proceso/inicio.

<instanceId> especifica el ID de instancia del formulario de solicitud de proceso/inicio.

<tagId> especifica el tagid del formulario de solicitud de proceso/inicio.

<action> especifica la acción que debe realizarse en la instancia del formulario de solicitud de proceso/inicio. Actualmente solo se permite el archivado.

Respuesta de SOAP

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <controlProcessResponse xmlns="http://www.ca.com/itpam">
         <actionStatus>The archive action was successfully executed.</actionStatus>
      </controlProcessResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>