Unsupported content

 

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

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

<adapter name>

Specifies the name of the adapter to be used for the process, as configured in Grid Manager

Default value: ARSadapter

No

<items>

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

<batch process items>

Indicates that all <item> elements in the XML document must be processed by the adapter in a batch mode

Default value: false

No

<version>

Specifies the version of the BMC Remedy AR System application

Valid values:

  • v7.0
  • v7.5
  • v7.6
  • v8.0
  • v8.1
  • v9.0
  • v9.1

Yes

<item type>

Indicates the type of record to be created

Note

<item type> is not currently being used by the Create Items process.

No

<connection parameters>

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

<adapter response>

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>

Was this page helpful? Yes No Submitting... Thank you

Comments