Create Items process for the BMC Remedy AR System adapter
The Create Items process creates one or more records in a specified schema within BMC Remedy Action Request (AR) System.
The following BMC Communities video (2:10) shows how to create a user in BMC Remedy ITSM by using the BMC Remedy AR System actor adapter.
https://www.youtube.com/watch?v=dhc-CS3nrCI&feature=youtu.be
The following table describes the input elements for the <items>
XML for the Create Items process:
Input elements for the Create Items process
Input | Description | Required |
---|---|---|
| Specifies the name of the adapter to be used for the process, as configured in Grid Manager | No |
| Specifies the XML document containing the elements required to insert a record into a BMC Remedy AR System schema Note Specify values for each field required by BMC Remedy AR System to create a complete record. | Yes |
| Indicates that all | No |
| Specifies the version of the BMC Remedy AR System application Valid values:
| Yes |
| Indicates the type of record to be created Note
| No |
| Contains the metadata required by the adapter to connect to the target | No |
The following figure shows a sample <items>
XML for the Create Items process:
<items>
XML for the Create Items process
<items>
<item>
<schema>Sample:Cities</schema>
<fields>
<values>
<field name="City">Delhi</field>
<field name="Airport Code">Del</field>
<field name="Diary Field">Enter data in Diary Field</field>
</values>
</fields>
</item>
</items>
The following table describes the output element for the Create Items process:
Output element for the Create Items process
Output | Description |
---|---|
| Specifies the XML document returned by the adapter request executed on the BMC Remedy AR System |
The following figure illustrates the output elements for the Create Items process when the <batch-process-items>
element is set to false:
Output elements for the Create Items process when <batch process items>
is false
<set-action-result>
<entry-id>000000000000179</entry-id>
</set-action-result>
The following figure illustrates the output elements for the Create Items process when the <batch process items>
element is set to true:
Output elements for the Create Items process when <batch process items>
is true
<set-action-result>
<entries>
<metadata>
<entry-count>2</entry-count>
</metadata>
<entry>
<entry-id>000000000000076</entry-id>
</entry>
<entry>
<entry-id>000000000000077</entry-id>
</entry>
</entries>
</set-action-result>
The following figure shows a sample <items>
XML for the Create Items process using the WorkOrderInterface_Create (Normal) form:
<items>
XML for the Create Items process using the WorkOrderInterface_Create (Normal) form
<items>
<item>
<schema>WOI:WorkOrderInterface_Create</schema>
<fields>
<values>
<field name="Work Order Type">2000</field>
<field name="Manager Support Organization">IT Support</field>
<field name="Manager Support Group Name">Backoffice Support</field>
<field name="Company">Global</field>
<field name="Request Manager Company">Calbro Services</field>
<field name="Customer Organization" />
<field name="Customer First Name">John</field>
<field name="Customer Last Name">Smith</field>
<field name="Last Name">Smith</field>
<field name="First Name">John</field>
<field name="Location Company">Calbro Services</field>
<field name="Summary">My_Workorder3</field>
<field name="Customer Company">My_company</field>
</values>
</fields>
</item>
</items>
The following figure illustrates the output elements for the Create Items process using the WorkOrderInterface_Create (Normal) form:
Output elements for the Create Items process using the WorkOrderInterface_Create (Normal) form
<set-action-result>
<entry-id>000000000000102</entry-id>
</set-action-result>
The WorkOrderInterface is a self-join form, and therefore you cannot execute the Create Items process using this form.
The following figure shows a sample <items>
XML for the Create Items process using the WorkOrderInterface (Self-Join) form:
<items>
XML for the Create Items process using the WorkOrderInterface (Self-Join) form
<items>
<item>
<schema>WOI:WorkOrderInterface</schema>
<fields>
<values>
<field name="Work Order Type">2000</field>
<field name="Company">My_company</field>
<field name="Customer Organization" />
<field name="Customer First Name">John</field>
<field name="Customer Last Name">Smith</field>
<field name="Last Name">Smith</field>
<field name="First Name">John</field>
<field name="Location Company">Calbro Services</field>
<field name="Customer Company">My_company</field>
<field name="Description">Test_company</field>
<field name="Work Order ID">WO0000000000214</field>
Work Order ID
</values>
</fields>
</item>
</items>
The following figure illustrates the output elements for the Create Items process using the WorkOrderInterface (Self-Join) form:
Output elements for the Create Items process using the WorkOrderInterface (Self-Join) form
<set-action-result>
<entry-id>000000000000102</entry-id>
</set-action-result>
Comments
Log in or register to comment.