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

controlInstance

Bir vakayı denetlemek üzere bir SOAP isteği oluşturmak için bu yöntemi kullanın. controlInstance yöntemi, ayrılmış modda tetiklenmeyen işlem veya başlatma isteği formları (ve tüm alt vakaları) için arşivlemeyi belirtir. İşlem veya başlatma isteği formu zaten arşivleme için işaretlenmişse, bu yöntem bir hata göndermez. controlInstance yöntemi, bir işlem veya başlatma isteği formu, belirtilen kimlik içinde bulunmadığında bir hata gönderir.

controlInstance yöntemini yürütmek için, aşağıdaki seçeneklerden birini kullanın:

• rootUUID: Bu seçenek, işlemin veya başlatma isteği formunun rootUUID'sini belirtir.
• instanceId: Bu seçenek, işlemin veya başlatma isteği formunun vaka kimliğini belirtir.
• tagId: Bu seçenek, işlemin veya başlatma isteği formunun tagid'sini belirtir.

Örnek

<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>arşiv</tns:action> 
</tns:controlInstance> 

SOAP İsteği

<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>benimparolam</tns:password>
        <tns:auth>
	<!--xsd:Choice Type-->
        <tns:instanceId>3186</tns:instanceId>
        <tns:action>arşiv</tns:action>
      </tns:controlInstance>
   </soapenv:Body>
</soapenv:Envelope>

<rootUUID> etiketi, işlemin/başlatma isteği formunun rootUUID'sini belirtir.

<instanceId> etiketi, işlemin/başlatma isteği formunun vaka kimliğini belirtir.

<tagId> etiketi, işlemin/başlatma isteği formunun tagid'sini belirtir.

<action> işlem/başlatma isteği formu vakası üzerinde gerçekleştirilecek eylemi belirtir. Şu anda, yalnızca arşiv desteklenmektedir.

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 archive action was successfully executed.</actionStatus>
      </controlProcessResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>