Delete Computer operation

The Delete Computer operation deletes a computer record.

Delete wrappers can delete only a single record. If information provided in the request refers to zero or more than one record, then no record is deleted. The entry to be deleted is first located by executing a logical AND operation using the elements provided in request. The located entry is then deleted.

The following table describes the elements of the <items> XML element and the adapter request. If not specified, the valid value for an element should be assumed to be a string.

Elements for the <items> XML element and adapter request for the Delete Computer operation

Element	Definition	Required
`<operation-name>`	Specifies the name of the operation: `delete-computer`	Yes
`<model>`	Contains the other elements in the request	Yes
`<keys>`	Contains elements that uniquely identify a record	Yes
`<logical-name>`	Specifies the unique name for identifying a computer item Valid value: Any unique string Note: The `<logical-name>` element must be used as the key and must be the child element of the `<keys>` element.	Yes
`<instance>`	Specifies a unique computer record The children of the `<instance>` element describe the fields of the record. The only two higher-level elements are `<keys>` and `<instance>`. All other elements are child elements of the `<instance>` element.	Yes
`<file-device>`	Specifies the attributes for a computer The `<file-device>` element can contain multiple child elements.	Yes
`<istatus>`	Specifies the status of the computer Valid values: Planned/On order Received In Stock Reserved In use Maintenance Disposed/Retired Installed	No
`<assignment>`	Specifies the assignment group for the computer Valid value: Any string, or an existing record from the application	No
`<vendor>`	Specifies the vendor name for the computer Valid value: Any string, or an existing record from the application	No
`<serial-number>`	Specifies the serial number of the computer Valid value: Any string	No
`<location>`	Specifies the location of the computer Valid value: Any string, or an existing record from the application	No
`<configuration-item-type>`	Specifies the type of the configuration item Valid value: computer Note: The `<configuration-item-type>` element is optional in the WebService API but is required to filter the records of computer items. If you do not specify the value for `<configuration-item-type>`, then the records will be searched for all configuration items, such as furnishing, device, and computer. Therefore, BMC recommends that you provide a value for the `<configuration-item-type>` element.	No
`<part-no>`	Specifies the part number of the computer Valid value: Any string, or an existing record from the application	No
`<version>`	Specifies the version of the computer Valid value: Any string	No
`<model>`	Specifies the model of the computer Valid value: Any string	No
`<updated-by>`	Specifies the person who last updated the record Default value: The name of the person who updated the record	No
`<subtype>`	Specifies the subtype for a selected type of configuration item The list of valid values is customizable. You can add and delete `<subtype>` values. For example: Artwork Armoire Bookcase Chair Computer Desk Desk Collection File Cabinet Meeting Table	No
`<building>`	Specifies the building for the computer Valid value: Any string	No
`<floor>`	Specifies the floor of the computer Valid value: Any string	No
`<room>`	Specifies the room of the computer Valid value: Any string	No
`<system-down>`	Specifies whether the system is down Valid values: true: Indicates that the system is down false (default): Indicates that the system is up	No
`<asset-tag>`	Specifies the asset for the record Valid value: Any string	No
`<company>`	Specifies the name of the company Valid value: Any string	No
`<file-computer>`	Contains child elements for describing the computer item; is a structure-type element	Yes
`<sysmodtime>`	Specifies the system time when the record was last modified Valid value: Any input in date and time format Default value: The date and time when the record is created	No
`<sysmoduser>`	Specifies the user name that last modified the record Valid value: Any string Default value: The current user of the service	No
`<sysmodcount>`	Specifies the number of times the record was modified Valid value: Any integer Default value: 0	No
`<environment>`	Specifies the environment of the computer Valid values: Development Test Production Failover None	No
`<owner>`	Specifies the department that owns the computer item Valid value: Any valid department in the HP Service Manager application The list can be customized by using the HP Service Manager application.	No
`<default-impact>`	Specifies the default impact of the computer Valid values: 1: Enterprise 2: Site / Dept 3: Multiple Users 4: User	No
`<title>`	Specifies the title of the computer Valid value: Any string	No
`<problem-priority>`	Specifies the priority of the computer Valid values: 1: Critical 2: High 3 - Average 4: Low	No
`<id>`	Specifies the ID of the computer Valid value: Any unique string	No

The following figure displays the sample adapter request for the Delete Computer operation.

Sample adapter request for the Delete Computer operation


 <hp-service-manager-request>
    <entity>configurationitem</entity>
    <entity-type>computer</entity-type>
    <request>
      <operation-name>delete-computer</operation-name>
      <parameters>
        <delete-computer-request>
          <model>
            <keys>
              <logical-name>
                <value>Computer1</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <configuration-item-type>
                  <value>computer</value>
                  <type>String</type>
                </configuration-item-type>
              </file-device>
              <file-computer>
                <type>Structure</type>
              </file-computer>
            </instance>
          </model>
        </delete-computer-request>
      </parameters>
    </request>
  </hp-service-manager-request>

The following figure displays an adapter response for the Delete Computer operation.

Sample adapter response for the Delete Computer operation


<hp-service-manager-response>
  <metadata>
    <count>1</count>
  </metadata>
  <responses>
    <response>
      <metadata>
        <count>1</count>
      </metadata>
      <item>
        <metadata>
          <status>success</status>
        </metadata>
        <parameters>
          <model>
            <keys>
              <logical-name>
                <value>Computer1</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <model>
                  <value>RA-2001</value>
                  <type>String</type>
                </model>
                <location>
                  <value>location</value>
                  <type>String</type>
                </location>
                <configuration-item-type>
                  <value>computer</value>
                  <type>String</type>
                </configuration-item-type>
                <updated-by>
                  <value>falcon</value>
                  <type>String</type>
                </updated-by>
                <part-no>
                  <value>1003</value>
                  <type>String</type>
                </part-no>
                <istatus>
                  <value>In Stock</value>
                  <type>String</type>
                </istatus>
                <floor>
                  <value>floor</value>
                  <type>String</type>
                </floor>
                <sysmodtime>
                  <value>2010.02.05 12:31:07</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmodcount>
                  <value>2</value>
                  <type>Decimal</type>
                </sysmodcount>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <assignment>
                  <value>Application</value>
                  <type>String</type>
                </assignment>
              </file-device>
              <file-computer>
                <type>Structure</type>
                <sysmodtime>
                  <value>2010.02.05 12:31:07</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <sysmodcount>
                  <value>1</value>
                  <type>Decimal</type>
                </sysmodcount>
              </file-computer>
              <uniquequery>file.device,logical.name="Computer1"</uniquequery>
            </instance>
          </model>
          <messages>
            <element>
              <value>joincomputer record deleted.</value>
            </element>
          </messages>
          <status>SUCCESS</status>
          <message>Success</message>
          <schema-revision-date>2005.03.15 00:00:00</schema-revision-date>
          <schema-revision-level>0</schema-revision-level>
          <return-code>0</return-code>
        </parameters>
      </item>
    </response>
  </responses>
</hp-service-manager-response>

Delete Computer operation

Comments