Batch Update Items operation


The Batch Update Items operation updates a field in the BMC Remedy Action Request (AR) System datastore with a new value for each item in the XML document.

The following table describes the input elements for the Batch Update Items operation:

Input elements for the Batch Update Items operation

Element

Description

Required

<adapter name>

Specifies the name of the adapter in the adapter configuration that is used to execute the operation

Default value: ARSAdapter

No

<items>

Specifies the XML document containing the elements required to update a record for the specified fields in the BMC Remedy AR System schema

Warning

Note

You must specify values for each field required by BMC Remedy AR System to update a complete record.


Yes

Warning

Action name

Before running the operation, ensure that you specify the value of the Action field in the Call Adapter Activity to update.

The following figure shows an XML sample of the input elements for the Batch Update Items operation:

XML sample of the input elements for the Batch Update Items operation

<items>
     <item>
       <schema>Alert Events</schema>
       <entry-id>xxxx</entry-id>
       <updated-field>Request</updated-field>
       <updated-field-value>Test Request 1</updated-field-value>
     </item>
     <item>
       <schema>Alert Events</schema>
       <entry-id>xxxx</entry-id>
       <updated-field>Request</updated-field>
       <updated-field-value>Test Request 2</updated-field-value>
     </item>
     <item>
       <schema>Alert Events</schema>
       <entry-id>xxxx</entry-id>
       <updated-field>Request</updated-field>
       <updated-field-value>Test Request 3</updated-field-value>
     </item>
</items>

The following table describes the output element for the Batch Update Items operation:

Output element for the Batch Update Items operation

Output

Description

<adapter response>

Specifies the XML document returned by the adapter request executed on BMC Remedy AR System

The following figure illustrates an XML sample of the output elements for the Batch Update Items operation:

XML sample of the output elements for the Batch Update Items operation

<update-action-result>
 <entries>
   <entry>
     <entry-id>xxxx</entry-id>
     <entry-count>1</entry-count>
   </entry>
   <entry>
     <entry-id>xxxx</entry-id>
     <entry-count>1</entry-count>
   </entry>
   <entry>
     <entry-id>xxxx</entry-id>
     <entry-count>1</entry-count>
   </entry>
</update-action-result>

 

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

TrueSight Orchestration Content 21.02