Find Items process for the BMC Atrium CMDB adapter

The Find Items process retrieves CI and relationship instances from BMC Atrium CMDB.

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

Process inputs - Find 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 query BMC Atrium CMDB

Yes

<item type>

Specifies the type of record to be retrieved

Valid values: configurationitem, graphquery

Yes

Note

The Find Items process gives a parsing exception if the '<' and '<=' relational operators are used.


The following figure shows a sample <items> XML for the Find Items With Selected Attributes process.

<items> XML sample for the Find Items With Selected Attributes process

 <items>
  <item>
<parameters>
  <username>SOAP user name</username>
  <password>SOAP password</password>
  <login-info>
<user-id>BMC Atrium CMDB user ID</user-id>
<password>BMC Atrium CMDB password</password>
<lang>English</lang>
  </login-info>
<class-name-id>
  <namespace-name>BMC.CORE</namespace-name>
  <class-name>BMC_Account</class-name>
</class-name-id>
<query><![CDATA[AccountID = NULL]]></query>
<attributes>
  <items>Model</items>
  <items>AccountID</items>
  <items>OwnerName</items>
</attributes>
<first-retrieve>0</first-retrieve>
<max-retrieve>10</max-retrieve>
<sort-order>
  <items>
<attribute-name>SerialNumber</attribute-name>
<sort-order>ASCENDING</sort-order>
  </items>
</sort-order>
<a-dataset-id />
<a-get-mask>GET_MASK_NONE</a-get-mask>
</parameters>
  </item>
</items>


The following figure shows a sample <items> XML for the Find Items With All Attributes process.

<items> XML sample for the Find Items With All Attributes process

 <items>
  <item>
<parameters>
  <username>SOAP user name</username>
  <password>SOAP password</password>
  <login-info>
<user-id>BMC Atrium CMDB user ID</user-id>
<password>BMC Atrium CMDB password</password>
<lang>English</lang>
  </login-info>
<class-name-id>
  <namespace-name>BMC.CORE</namespace-name>
  <class-name>BMC_Account</class-name>
</class-name-id>
<query><![CDATA[AccountID = NULL]]></query>
<attributes/>
<first-retrieve>0</first-retrieve>
<max-retrieve>10</max-retrieve>
<sort-order>
  <items>
<attribute-name>SerialNumber</attribute-name>
<sort-order>ASCENDING</sort-order>
  </items>
</sort-order>
<a-dataset-id />
<a-get-mask>GET_MASK_NONE</a-get-mask>
</parameters>
  </item>
</items>


The following figure illustrates the adapter response for the Find Items process.

Adapter response for the Find Items process

 <bmc-atrium-cmdb-response>
  <item>
   <metadata>
<status>success or error</status>
<error> Present only with a staus of 'error'</error>
<item-count>2</item-count>
   </metadata>
   <parameters>
<instance-info>
 <value>
  <element>
    <instance-id>AG4445535442002zkKRgKhCFHglU0B</instance-id>
    <instance-attributes>
 <element>
   <name>Model</name>
   <value>
<string-value>Model value 1</string-value>
   </value>
 </element>
 <element>
   <name>Account ID</name>
   <value>
<string-value>Account ID 1</string-value>
    </value>
  </element>
 <element>
   <name>Owner Name</name>
   <value>
<string-value>Owner 1</string-value>
   </value>
 </element>
    </instance-attributes>
  </element>
  <element>
    <instance-id>AG444553544200MToKRgI2GGHgz00B</instance-id>
    <instance-attributes>
 <element>
   <name>Model</name>
   <value>
<string-value>Model value 2</string-value>
</value>
</element>
<element>
<name>Account ID</name>
<value>
 <string-value>Account ID 2</string-value>
 </value>
</element>
<element>
<name>Owner Name</name>
<value>
  <string-value>Owner 2</string-value>
</value>
</element>
    </instance-attributes>
  </element>
 </value>
</instance-info>
    <status>
<value />
    </status>
   </parameters>
  </item>
</bmc-atrium-cmdb-response>
Was this page helpful? Yes No Submitting... Thank you

Comments