Delete Furnishing operation

The Delete Furnishing operation deletes a furnishing 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 Furnishing operation

Element

Definition

Required

<operation-name>

Specifies the name of the operation: delete-furnishing

Yes

<model>

Contains the other elements in the request

Yes

<keys>

Contains elements that uniquely identify a record

Yes

<logical-name>

Specifies a unique name for identifying a furnishing 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 furnishing 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 furnishing item

The <file-device> element can contain multiple child elements.

Yes

<vendor>

Specifies the name of the vendor for the furnishing item

Valid value: Any string, or an existing record from the application

No

<serial-no>

Specifies the serial number of the furnishing item

Valid value: Any string

No

<location>

Specifies the location of the furnishing item

Valid value: Any string, or an existing record from the application

No

<configuration-item-type>

Specifies the type of the configuration item

Valid value: furnishing

No

<part-no>

Specifies the part number of the furnishing item

Valid value: Any string, or an existing record from the application

No

<version>

Specifies the version of the furnishing item

Valid value: Any string

No

<model>

Specifies the model of the furnishing item

Valid value: Any string

No

<updated-by>

Specifies the person who last updated the record

This field is maintained by the HP Service Manager application.

Valid value: Any string

Default value: The user who updated the record

No

<subtype>

Specifies the subtype for a selected type for a configuration item

No

<building>

Specifies the building for the furnishing item

Valid value: Any string

No

<floor>

Specifies the floor for the furnishing item

Valid value: Any string

No

<room>

Specifies the room for the furnishing item

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

<assignment>

Specifies the assignment group for the furnishing item

Valid value: Any string

No

<file-furnishing>

Contains child elements for describing the furnishing item; is a structure-type element

Yes

<width>

Specifies the width of the furnishing item in inches

Valid value: Any decimal

No

<depth>

Specifies the depth of the furnishing item in inches

Valid value: Any decimal

No

<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 furnishing item

Valid values:

  • Development
  • Test
  • Production
  • Failover
  • None

No

<owner>

Specifies the department that owns the furnishing 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 furnishing item

Valid values:

  • 1: Enterprise
  • 2: Site / Dept
  • 3: Multiple Users
  • 4: User

No

<title>

Specifies the title of the furnishing item

Valid value: Any string

No

<problem-priority>

Specifies the priority of the furnishing item

Valid values:

  • 1: Critical
  • 2: High
  • 3 - Average
  • 4: Low

No

<istatus>

Specifies the status of the furnishing item

Valid values:

  • Planned/On order
  • Received
  • In Stock
  • Reserved
  • In use
  • Maintenance
  • Disposed/Retired
  • Installed

No

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

Sample adapter request for the Delete Furnishing operation


 <hp-service-manager-request>
    <entity>configurationitem</entity>
    <entity-type>furnishing</entity-type>
    <request>
      <operation-name>delete-furnishing</operation-name>
      <parameters>
        <delete-furnishing-request>
          <model>
            <keys>
              <logical-name>
                <value>FUR-0023</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <configuration-item-type>
                  <value>furnishings</value>
                  <type>String</type>
                </configuration-item-type>
                <assignment>
                  <value>Application</value>
                  <type>String</type>
                </assignment>
                <istatus>
                  <value>In use</value>
                  <type>String</type>
                </istatus>
              </file-device>
              <file-furnishings>
                <type>Structure</type>
              </file-furnishings>
            </instance>
          </model>
        </delete-furnishing-request>
      </parameters>
    </request>
  </hp-service-manager-request>


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

Sample adapter response for the Delete Furnishing 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>FUR-0023</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <configuration-item-type>
                  <value>furnishings</value>
                  <type>String</type>
                </configuration-item-type>
                <updated-by>
                  <value>falcon</value>
                  <type>String</type>
                </updated-by>
                <istatus>
                  <value>In use</value>
                  <type>String</type>
                </istatus>
                <sysmodtime>
                  <value>2010.02.08 11:42:50</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmodcount>
                  <value>0</value>
                  <type>Decimal</type>
                </sysmodcount>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <assignment>
                  <value>Application</value>
                  <type>String</type>
                </assignment>
              </file-device>
              <file-furnishings>
                <type>Structure</type>
                <sysmodtime>
                  <value>2010.02.08 11:42:51</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <sysmodcount>
                  <value>0</value>
                  <type>Decimal</type>
                </sysmodcount>
              </file-furnishings>
              <uniquequery>file.device,logical.name="FUR-0023"</uniquequery>
            </instance>
          </model>
          <messages>
            <element>
              <value>joinfurnishings record deleted.</value>
            </element>
          </messages>
          <status>SUCCESS</status>
          <message>Success</message>
          <schema-revision-date>2010.02.08 00:00:00</schema-revision-date>
          <schema-revision-level>1</schema-revision-level>
          <return-code>0</return-code>
        </parameters>
      </item>
    </response>
  </responses>
</hp-service-manager-response>
Was this page helpful? Yes No Submitting... Thank you

Comments