Delete Items process for the BMC Atrium CMDB adapter

The Delete Items process deletes CI or relationship instances within BMC Atrium CMDB.

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

Process inputs - Delete Items process

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 delete a record from BMC Atrium CMDB Records can be deleted based on an instance ID, instance name, or reconciliation identity.

Yes

<item type>

Specifies the type of record to be deleted

Valid value: configurationitem

Yes

The following figure shows a sample <items> XML for the Delete Items By Instance ID process.

<items> XML sample for the Delete Items By Instance ID process

 <items>
 <delete-criteria>InstanceId</delete-criteria>
  <item>
  <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>
  <instance-id>OI-9BAA6AF05C404E2DAF680027433193E5</instance-id>
  <a-dataset-id>BMC.ASSET</a-dataset-id>
  <delete-option>UNCONDITIONALLY</delete-option>
</parameters>
  </item>
<items>


The following figure illustrates the adapter response for the Delete Items By Instance ID process.

Adapter response for the Delete Items By Instance ID process

 <bmc-atrium-cmdb-response>
  <item>
    <metadata>
      <status>success</status>
    </metadata>
    <parameters>
      <output/>
    </parameters>
  </item>
</bmc-atrium-cmdb-response>


The following figure shows sample <items> XML for the Delete Items By Instance Name process.

<items> XML sample for the Delete Items By Instance Name process

 <items>
 <delete-criteria>InstanceName</delete-criteria>
  <item>
  <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>
  <instance-name>Test_Instance_Name</instance-name>
  <a-dataset-id>BMC.ASSET</a-dataset-id>
  <delete-option>UNCONDITIONALLY</delete-option>
</parameters>
  </item>
<items>

The following figure illustrates the adapter response for the Delete Items By Instance Name process.

Adapter response for the Delete Items By Instance Name process

 <bmc-atrium-cmdb-response>
  <item>
    <instance-id>InsatanceId9610</instance-id>
    <metadata>
      <status>success</status>
    </metadata>
    <parameters>
      <output/>
    </parameters>
  </item>
</bmc-atrium-cmdb-response>


The following figure shows a sample <items> XML for the Delete Items By Reconciliation Identity (ID) process.

<items> XML sample for the Delete Items By Reconciliation Identity process

 <items>
 <delete-criteria>ReconciliationIdentity</delete-criteria>
  <item>
  <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>
  <reconciliation-identity>OI-
9BAA6AF05C404E2DAF680027433193E5</reconciliation-identity>
  <a-dataset-id>BMC.ASSET</a-dataset-id>
  <delete-option>UNCONDITIONALLY</delete-option>
</parameters>
  </item>
<items>


The following figure illustrates the adapter response for the Delete Items By Reconciliation ID process.

Adapter response for the Delete Items By Reconciliation ID process

 <bmc-atrium-cmdb-response>
  <item>
    <instance-id>InsatanceId9610</instance-id>
    <metadata>
      <status>success</status>
    </metadata>
    <parameters>
      <output/>
    </parameters>
  </item>
</bmc-atrium-cmdb-response>
Was this page helpful? Yes No Submitting... Thank you

Comments