Create Items process for the BMC Atrium CMDB adapter

The Create Items process creates CI or relationship instances within BMC Atrium CMDB.

The following table describes the process input elements for the Create Items process.

Process inputs - Create Items

Process input

Description

Required?

<adapter name>

Specifies the name of the adapter used for the process, configured in Grid Manager
Default value: BMCAtriumCMDBActorAdapter

No

<version>

Specifies the version of BMC Atrium CMDB system

Valid values: v2.0, v7.5, v7.6, v8.0, v8.1

NEW IN 20.17.01 v9.0, v9.1

Yes

<items>

Specifies the XML document containing the elements required to create a CI or Relationship instance in BMC Atrium CMDB See the following figure for a sample XML document for a CI instance. See the following figure for sample XML documents for a Relationship instance.
You must provide all the required attributes to create a record.

Yes

<item type>

Specifies the type of record to be created

Valid value: configurationitem

Yes

The following figure shows a sample <items> XML for the Create Items For CI Instance process.

<items> XML sample for the Create Items For CI Instance process

 <items>
  <class-type>CI</class-type>
  <item>
<parameters>
  <username></username>
  <password></password>
  <login-info>
<user-id>Demo</user-id>
<password>Demo</password>
<lang>English</lang>
  </login-info>
  <class-name-id>
<namespace-name>BMC.CORE</namespace-name>
<class-name>BMC_Person</class-name>
  </class-name-id>
  <attributes>
<items>
  <name>Email</name>
  <value>
<string-value>test@test.com</string-value>
  </value>
</items>
<items>
  <name>PersonDepartment</name>
  <value>
  <string-value>department</string-value>
  </value>
</items>
<items>
  <name>FirstName</name>
  <value>
  <string-value>test</string-value>
  </value>
</items>
<items>
  <name>LastName</name>
  <value>
  <string-value>test</string-value>
  </value>
</items>
<items>
  <name>Name</name>
  <value>
  <string-value>TestClassInstance</string-value>
  </value>
</items>
</attributes>
<a-dataset-id>BMC.ASSET</a-dataset-id>
</parameters>
  </item>
</items>


The following figure shows a sample <items> XML for the Create Items For Relationship Instance process.

<items> XML sample for the Create Items For Relationship Instance process

<items>
<class-type>Relationship</class-type>
<item>
 <parameters>
  <login-info>
   <user-id>Demo</user-id>
   <password>Demo</password>
   <lang>English</lang>
  </login-info>
  <class-type>relationship</class-type>
  <class-name-id>
   <namespace-name>BMC.CORE</namespace-name>
   <class-name>BMC_Component</class-name>
  </class-name-id>
  <role1Name>Source</role1Name>
  <instance1Id>InsatanceId8610</instance1Id>
  <class1Id>BMC_DOCUMENT</class1Id>
  <role2Name>Destination</role2Name>
  <instance2Id>InsatanceId9610</instance2Id>
  <class2Id>BMC_DOCUMENT</class2Id>
  <a-dataset-id>BMC.SAMPLE</a-dataset-id>
  <attributes>
   <items>
    <name>AttributeDataSourceList</name>
    <value>
     <string-value>AttributeDataSourceList1</string-value>
    </value>
   </items>
   <items>
    <name>ShortDescription</name>
    <value>
      <string-value>na</string-value>
    </value>
   </items>
   <items>
    <name>InstanceId</name>
    <value>
      <string-value>RelationInstance1</string-value>
    </value>
   </items>
   <items>
    <name>AccountID</name>
    <value>
      <string-value>AccountID1</string-value>
    </value>
   </items>
   <items>
    <name>AssignedTo</name>
    <value>
      <string-value>AssignedTo1</string-value>
    </value>
    </items>
   <items>
    <name>CMDBWriteSecurity</name>
    <value>
      <string-value>1;</string-value>
    </value>
   </items>
   <items>
    <name>Status</name>
    <value>
      <enum-value>1</enum-value>
    </value>
   </items>
   <items>
    <name>CMDBRowLevelSecurity</name>
    <value>
      <string-value>1;</string-value>
    </value>
   </items>
   <items>
    <name>Name</name>
    <value>
      <string-value>DocumentRelationone</string-value>
    </value>
   </items>
   <items>
    <name>ReconciliationIdentity</name>
    <value>
      <string-value>R1</string-value>
    </value>
   </items>
   <items>
    <name>Submitter</name>
    <value>
      <string-value>Demo</string-value>
    </value>
   </items>
  </attributes>
  </parameters>
 </item>
</items>
 


The following figure illustrates the adapter response for the Create Items For CI Instance process.

Adapter response for the Create Items For CI Instanceprocess

 <bmc-atrium-cmdb-response>
  <item>
<metadata>
  <status>success or error</status>
  <error>Present only with status of 'error'</error>
</metadata>
<parameters>
  <instance-id>OI-AA1663B72DCF47E4B48B7B83699C3D37</instance-id>
  <status>
<value />
  </status>
</parameters>
  </item>
</bmc-atrium-cmdb-response>
Was this page helpful? Yes No Submitting... Thank you

Comments