Find Incident operation for the CA Service Desk adapter

The Find Incident operation retrieves incident records from the CA Service Desk application.

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

Note

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

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

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

Sample adapter request for the Find Incident operation


<casd-request>
 <operation-name>find-incident</operation-name>
 <arguments>
   <target>
     <host>172.11.11.111</host>
     <user-name>username</user-name>
     <password>password</password>
     <port>8080</port>
     <protocol>http</protocol>
   </target>
   <incident-number>48</incident-number>
   <assignee>l1,f1 f2,m1</assignee>
   <group />
   <status>Open</status>
   <priority>None</priority>
   <is-active />
   <incident-area />
   <configuration-item />
   <reported-by>ServiceDesk</reported-by>
   <affected-end-user>Gupta,Shankar,Kumar</affected-end-user>
   <affected-end-user-id />
   <affected-end-user-location />
   <affected-end-user-organization />
   <problem />
   <change />
   <caused-by-change-order />
   <incident-priority />
   <impact>None</impact>
   <urgency />
   <severity />
   <earliest-open-date>10/28/2011 03:03 PM</earliest-open-date>
   <latest-open-date />
   <earliest-close-date />
   <latest-close-date />
   <parent />
   <earliest-resolve-date />
   <latest-resolve-date />
   <is-child />
   <root-cause />
   <sla-violation />
   <is-template />
   <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 Incident 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>cr:400003</Handle>
         <description></description>
         <is-active>YES</is-active>
         <configuration-item></configuration-item>
         <assignee>l1,f1 f2,m1</assignee>
         <call-back-date></call-back-date>
         <call-back-flag>0</call-back-flag>
         <incident-area></incident-area>
         <caused-by-change-order></caused-by-change-order>
         <change></change>
         <charge-back-id></charge-back-id>
         <close-date></close-date>
         <created-via>3554</created-via>
         <affected-end-user>Gupta,Shankar,Kumar</affected-end-user>
         <event-token></event-token>
         <group></group>
         <event-token></event-token>
         <extern-ref></extern-ref>
         <extern-token></extern-token>
         <id>400003</id>
         <impact>None</impact>
         <incident-priority>0</incident-priority>
         <reported-by>ServiceDesk,,</reported-by>
         <macro-predicted-violation>0</macro-predicted-violation>
         <open-date>10/28/2011 03:03 PM</open-date>
         <outage-end-time></outage-end-time>
         <outage-start-time></outage-start-time>
         <parent></parent>
         <persistent-id>cr:400003</persistent-id>
         <predicted-sla-violation>0</predicted-sla-violation>
         <priority>None</priority>
         <problem></problem>
         <incident-number>48</incident-number>
         <resolve-date></resolve-date>
         <root-cause></root-cause>
         <severity></severity>
         <sla-violation>0</sla-violation>
         <base-template></base-template>
         <status>Open</status>
         <string1></string1>
         <string2></string2>
         <string3></string3>
         <string4></string4>
         <string5></string5>
         <string6></string6>
         <summary></summary>
         <template-name></template-name>
         <support-lev></support-lev>
         <time-spent-sum>00:00:43</time-spent-sum>
         <type>Incident</type>
         <urgency></urgency>
       </item>
     </items>
   </response>
 </responses>
</casd-response>

 

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