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

controlProcess

Utilice este método para crear una solicitud para controlar un proceso.

Ejemplo

<tns:controlProcess xmlns:tns="http://www.ca.com/itpam"> 
  <tns:ProcessID>ProcessID__</tns:ProcessID> 
  <tns:action>action__</tns:action> 
  <tns:auth> 
<!--xsd:Choice Type--> 
<tns:token>token__</tns:token> 
<tns:user>user__</tns:user> 
<tns:password>password__</tns:password> 
  </tns:auth> 
</tns:controlProcess> 

Solicitud de SOAP

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<tns:controlProcess xmlns:tns="http://www.ca.com/itpam">
<tns:ProcessID>47</tns:ProcessID>
<tns:action>suspend</tns:action>
<tns:auth>
<!--xsd:Choice Type-->
<tns:token>token__</tns:token>
<tns:user>Joe</tns:user>
<tns:password>thisismypassword</tns:password>
<tns:auth>
</tns:controlProcess></SOAP-ENV:Body></SOAP-ENV:Envelope>

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 suspend action for Process ID "47" was queued.</actionStatus>
</controlProcessResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Acciones

Suspender

Se puede suspender una sola instancia de proceso mediante un método de servicios Web.

Si no se puede suspender una instancia de un proceso (por ejemplo, ya se ha completado o anulado), aparece un mensaje de error con detalles sobre la solicitud.

A continuación se muestra un ejemplo de un error cuando se intenta suspender un proceso completado:

<Fault xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>El proceso con el ID de proceso "208" se encuentra en estado completado y, por lo tanto, no se puede suspender.</faultstring>
</Fault>

Reanudar

Se puede reanudar una sola instancia de proceso que se haya suspendido previamente mediante un método de servicios Web.

Si no se puede reanudar una instancia de un proceso, aparece un mensaje de error con detalles sobre la solicitud. Por ejemplo, una instancia de proceso no se puede reanudar cuando se ha completado, anulado o no está suspendida.

A continuación se muestra un ejemplo de un error cuando se intenta reanudar un proceso completado:

<Fault xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>El proceso con el ID de proceso "208" se encuentra en estado completado y, por lo tanto, no se puede reanudar.</faultstring>
</Fault>

Anular

Se puede anular una sola instancia de proceso mediante un método de servicios Web.

Si no se puede anular una instancia de un proceso (por ejemplo, ya se ha completado o anulado), aparece un mensaje de error con detalles sobre la solicitud.

A continuación se muestra un ejemplo de un error cuando se intenta anular un proceso completado:

<Fault xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>El proceso con el ID de proceso "486" se encuentra en estado completado y, por lo tanto, no se puede anular.</faultstring>
</Fault>

Ejemplo 1

<tns:controlProcess xmlns:tns="http://www.ca.com/itpam">
        <tns:ProcessID>ProcessID </tns:ProcessID>
        <tns:action>action</tns:action>
          <tns:auth>
	   <!--xsd:Choice Type-->
	   <tns:token>token__</tns:token>
           <tns:user>Joe</tns:user>
           <tns:password>thisismypassword</tns:password>
          <tns:auth></tns:controlProcess>

"ProcessedID" es el ROID de la instancia del proceso que se debe controlar (suspender/ reanudar/ anular). El "ROID" de un proceso en ejecución se encuentra en la respuesta al ejecutar un proceso a través de servicios Web.

Ejemplo 2

<tns:ExecuteC2OFlowResponse xmlns:tns="http://www.ca.com/itpam">
        <tns:ExecuteC2OFlowResult>
        <tns:ROID>567</tns:ROID>
        ...
        ...
        </tns:ExecuteC2OFlowResult>
</tns:ExecuteC2OFlowResponse>

El valor para la acción es suspender, reanudar o anular. Solamente un usuario autorizado puede realizar esta acción; de lo contrario, se devuelve un error.

Ejemplo 3

<SOAP-ENV:Fault xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
        <faultcode>SOAP-ENV:Server</faultcode>
       <faultstring>Invalid user/password or token.</faultstring>
</SOAP-ENV:Fault>

Se devuelve un error si se intenta realizar una operación que no se puede en un proceso en su estado actual. Por ejemplo, si se intenta suspender un proceso que ya se ha completado.

Ejemplo 4

<SOAP-ENV:Fault xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
        <faultcode>SOAP-ENV:Server</faultcode>
        <faultstring>Process with Process Id "576" is in completed state therefore cannot be suspended.</faultstring>
</SOAP-ENV:Fault>