SOAP API Başvurusu › Web Hizmetleri Yöntemleri › controlProcess

controlProcess

Bir işlemi denetlemek üzere bir istek oluşturmak için bu yöntemi kullanın.

Örnek

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

SOAP İsteği

<?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>askıya al</tns:action>
<tns:auth>
<!--xsd:Choice Type-->
<tns:token>token__</tns:token>
<tns:user>Joe</tns:user>
<tns:password>benimparolam</tns:password>
<tns:auth>
</tns:controlProcess></SOAP-ENV:Body></SOAP-ENV:Envelope>

SOAP Yanıtı

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

Eylemler

Askıya Al

Tek bir işlem vakasını, bir web hizmetleri yöntemi aracılığıyla askıya alabilirsiniz.

Bir işlem vakasını askıya alamıyorsanız (örneğin zaten tamamlanmış veya durdurulmuştur), istekle ilgili ayrıntıları içeren bir hata iletisi döndürülür.

Tamamlanmış bir işlemi askıya almaya çalıştığınızda karşılaşacağınız hata örneği şudur:

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

Sürdür

Daha önce bir web hizmetleri yöntemi aracılığıyla askıya alınmış tek bir işlem vakasını sürdürebilirsiniz.

Bir işlem vakasını sürdüremiyorsanız, istekle ilgili ayrıntıları içeren bir hata iletisi döndürülür. Örneğin, işlem vakası zaten tamamlanmış, durdurulmuş olduğundan ya da o anda askıda olmadığından dolayı devam ettirilemez.

Tamamlanmış bir işlemi sürdürmeye çalıştığınızda karşılaşacağınız hata örneği şudur:

<Fault xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>The process with Process ID "208" is in completed state and therefore cannot be resumed.</faultstring>
</Fault>

Durdur

Tek bir işlem vakasını, bir web hizmetleri yöntemi aracılığıyla durdurabilirsiniz.

Bir işlem vakasını durduramıyorsanız (örneğin zaten tamamlanmış veya durdurulmuştur), istekle ilgili ayrıntıları içeren bir hata iletisi döndürülür.

Tamamlanmış bir işlemi durdurmaya çalıştığınızda karşılaşacağınız hata örneği şudur:

<Fault xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>The process with Process ID "486" is in completed  state and therefore cannot be Aborted.</faultstring>
</Fault>

Örnek 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", denetlenmesi gereken işlem vakasının ROID'sidir (askıya al/ sürdür/durdur). Çalışmakta olan bir işlemin "ROID"si, web hizmetleri aracılığıyla bir işlem yürütüldüğünde verilen yanıttır:

Örnek 2

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

Eylem değeri askıya al, sürdür veya durdurdur. Yalnızca bir yetkili kullanıcı bu eylemi gerçekleştirebilir; aksi takdirde, bir hata döndürülür.

Örnek 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>

Bir işlem üzerinde mevcut durumunda gerçekleştiremediğiniz bir işlemi gerçekleştirmeye çalışırsanız hata döndürülür. Örneğin, zaten tamamlanmış olan bir işlemi askıya almaya çalışmak.

Örnek 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>