Find Change operation for the CA Service Desk adapter


The Find Change operation retrieves change records from the CA Service Desk application.

The following table describes the <items> XML elements for the Find Change operation.

Note

Use the <items> element when you call an adapter from an out-of-the-box process in TrueSight Orchestration Development Studio. Use the adapter request XML when you create a custom process by using the Call Adapter activity in TrueSight Orchestration Development Studio.

Elements for the <items> XML element and adapter request for the Find Change operation

The following figure illustrates a sample adapter request for the Find Change operation:

Sample adapter request for the Find Change operation


<casd-request>
 <operation-name>find-change</operation-name>
 <arguments>
   <target>
     <soap-url>https://machine.domain.com:8443/axis/services/USD_R11_WebService?wsdl</soap-url>
     <host>172.11.11.111</host>
     <user-name>username</user-name>
     <password>password</password>
     <port>8443</port>
     <protocol>https</protocol>
     <use-ssl-certificate>true</use-ssl-certificate>
     <allow-unsigned-certificate>true</allow-unsigned-certificate>
     <install-certificate>true</install-certificate>
     <passphrase>changeit</passphrase>
   </target>
   <change-number>330</change-number>
   <assignee>ServiceDesk</assignee>
   <created-by>ServiceDesk</created-by>
   <group>g1</group>
   <closure-code>Successful</closure-code>
   <priority>3</priority>
   <risk/>
   <is-active>true</is-active>
   <affected-end-user>System_AM_User</affected-end-user>
   <requestor>ServiceDesk</requestor>
   <status>open</status>
   <category>Add.Telco.Handset</category>
   <is-template/>
   <cab-approval>yes</cab-approval>
   <cab>Test Group</cab>
   <impact>1-Entire Organization</impact>
   <summary>Test summary</summary>
   <description>Test description</description>
   <business-case>b2</business-case>
   <backout-plan>bp</backout-plan>
   <business-justification>bj</business-justification>
   <is-child/>
   <parent-change>96</parent-change>
   <implementation-plan/>
   <root-cause>A</root-cause>
   <sla-violation/>
   <earliest-schedule-start-date/>
   <latest-schedule-start-date/>
   <earliest-schedule-end-date/>
   <latest-schedule-end-date/>
   <earliest-need-by-date/>
   <latest-need-by-date/>
   <earliest-open-date/>
   <latest-open-date/>
   <earliest-close-date/>
   <latest-close-date/>
   <earliest-resolve-date/>
   <latest-resolve-date/>
   <earliest-estimated-completion-date/>
   <latest-estimated-completion-date/>
   <earliest-actual-completion-date/>
   <latest-actual-completion-date/>
   <least-estimated-cost/>
   <greatest-estimated-cost/>
   <least-actual-cost/>
   <greatest-actual-cost/>
   <least-actual-duration/>
   <greatest-actual-duration/>
   <least-estimated-duration/>
   <greatest-estimated-duration/>
   <number-of-records>-1</number-of-records>
   <additional-search-arguments/>
 </arguments>
</casd-request>

The following figure illustrates the adapter response for the sample request:

Sample adapter response for the Find Change operation


<casd-response>
 <metadata>
   <status>success</status>
   <response-count>1</response-count>
 </metadata>
 <responses>
   <response>
     <metadata>
       <status>success</status>
       <count>1</count>
     </metadata>
     <items>
       <item>
         <Handle>chg:400238</Handle>
         <description>Test description</description>
         <actions></actions>
         <is-active>YES</is-active>
         <actual-completion-date>11/08/2011 02:27 PM</actual-completion-date>
         <actual-implementation-start-date>11/30/2011 02:31 PM</actual-implementation-start-date>
         <actual-implementation-end-date>11/30/2011 02:31 PM</actual-implementation-end-date>
         <actual-cost>2000</actual-cost>
         <actual-duration>10:40:00</actual-duration>
         <affected-end-user>System_AM_User,,</affected-end-user>
         <assignee>ServiceDesk,,</assignee>
         <backout-plan>bp</backout-plan>
         <business-case>b2</business-case>
         <call-back-date></call-back-date>
         <call-back-flag>0</call-back-flag>
         <category>Add.Telco.Handset</category>
         <change-number>330</change-number>
         <close-date></close-date>
         <closure-code>Successful</closure-code>
         <implementation-plan></implementation-plan>
         <estimated-completion-date>11/05/2011 02:26 PM</estimated-completion-date>
         <estimated-cost>1000</estimated-cost>
         <estimated-duration>02:30:50</estimated-duration>
         <group>g1</group>
         <id>400238</id>
         <impact>1-Entire Organization</impact>
         <business-justification>bj</business-justification>
         <last-modified-by>ServiceDesk,,</last-modified-by>
         <created-by>ServiceDesk,,</created-by>
         <modified-date>11/23/2011 04:38 PM</modified-date>
         <need-by-date>11/08/2012 11:32 AM</need-by-date>
         <open-date>11/23/2011 04:38 PM</open-date>
         <organization>org2</organization>
         <parent-change>96</parent-change>
         <priority>3</priority>
         <predicted-sla-violation>0</predicted-sla-violation>
         <product></product>
         <project>Test1</project>
         <requestor>ServiceDesk,,</requestor>
         <resolve-date></resolve-date>
         <risk></risk>
         <root-cause>A</root-cause>
         <schedule-start-date>11/03/2011 02:25 PM</schedule-start-date>
         <schedule-end-date>11/04/2011 12:55 AM</schedule-end-date>
         <schedule-duration>10:30:00</schedule-duration>
         <service-date></service-date>
         <service-num></service-num>
         <sla-violation>0</sla-violation>
         <start-date></start-date>
         <status>Open</status>
         <summary>Test summary</summary>
         <template-name></template-name>
         <cab>Test Group</cab>
         <cab-approval>YES</cab-approval>
         <string1></string1>
         <string2></string2>
         <string3></string3>
         <string4></string4>
         <string5></string5>
         <string6></string6>
         <type-of-contact></type-of-contact>
       </item>
     </items>
   </response>
 </responses>
</casd-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*