Delete Installed Software operation

The Delete Installed Software operation deletes the details of an installed software.

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 Installed Software operation

Element	Definition	Required
`<operation-name>`	Specifies the name of the operation: `delete-installed-software`	Yes
`<model>`	Contains the other elements in the request	Yes
`<keys>`	Contains elements that uniquely identify a record A combination of the `<application-name>`, `<license-number>`, and `<installed-on-c-i>` elements must be used as the key. If you do not specify the combination of the `<application-name>`, `<license-number>`, and `<installed-on-c-i>` elements in the `<keys>` element, the application tries to find the combination in the `<instance>` element. You can provide the values for the combination in the `<keys>` element, in the `<instance>` element, or in both elements.	Yes
`<instance>`	Specifies a unique 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
`<application-name`	Specifies the name of the installed application A combination of the `<application-name>`, `<license-number>`, and `<installed-on-c-i>` elements must be used as the key. Valid value: Any string	Yes
`<license-number>`	Specifies the license number of the installed software A combination of the `<application-name>`, `<license-number>`, and `<installed-on-c-i>` elements must be used as the key. Valid value: Any string	Conditional; required only when the combination of the `<application-name>` and `<installed-on-c-i>` elements cannot uniquely locate the installed software entry to be deleted
`<installed-on-c-i>`	Specifies the configuration item where the software is installed A combination of the `<application-name>`, `<license-number>`, and `<installed-on-c-i>` elements must be used as the key. Valid value: Any string	Yes
`<directory>`	Specifies the directory where the software is installed Valid value: Any string	No
`<description>`	Specifies a description of the installed software Valid value: Any string	No
`<version>`	Specifies the version of the installed software Valid value: Any string	No
`<installation-date>`	Specifies the date when the software was installed Valid value: Date and time in the YYYY.MM.DD HH:MM:SS format	No
`<installed-by>`	Specifies the name of the person who installed the software Valid value: Any string	No
`<suite-component>`	Specifies whether the installed software is a component of a suite Valid values: true, false	No
`<is-authorized>`	Specifies whether the software is an authorized software Valid values: true, false	No
`<status>`	Specifies the status of the software Valid value: Any string	No
`<serial-number>`	Specifies the serial number of the software Valid value: Any string	No

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

Sample adapter request for the Delete Installed Software operation


 <hp-service-manager-request>
    <entity>configurationitem</entity>
    <entity-type>installed-software</entity-type>
    <request>
      <operation-name>delete-installed-software</operation-name>
      <parameters>
        <delete-installed-software-request>
          <model>
            <keys>
              <license-number>
                <value>license number-01</value>
                <type>String</type>
              </license-number>
              <installed-on-c-i>
                <value>installed on c i-01</value>
                <type>String</type>
              </installed-on-c-i>
              <application-name>
                <value>application name-01</value>
                <type>String</type>
              </application-name>
            </keys>
            <instance>
              <application-name>
                <value>application name-01</value>
                <type>String</type>
              </application-name>
              <license-number>
                <value>license number-01</value>
                <type>String</type>
              </license-number>
              <installed-on-c-i>
                <value>installed on c i-01</value>
                <type>String</type>
              </installed-on-c-i>
              <directory>
                <value>directory-UPDATED</value>
                <type>String</type>
              </directory>
              <description>
                <value>description</value>
                <type>String</type>
              </description>
              <version>
                <value>version</value>
                <type>String</type>
              </version>
              <installation-date>
                <value>2008.11.01 08:00:00</value>
                <type>DateTime</type>
              </installation-date>
              <installed-by>
                <value>installed by</value>
                <type>String</type>
              </installed-by>
              <suite-component>
                <value>true</value>
                <type>Boolean</type>
              </suite-component>
              <is-authorized>
                <value>true</value>
                <type>Boolean</type>
              </is-authorized>
              <status>
                <value>status</value>
                <type>String</type>
              </status>
              <serial-number>
                <value>serial number</value>
                <type>String</type>
              </serial-number>
            </instance>
          </model>
        </delete-installed-software-request>
      </parameters>
    </request>
  </hp-service-manager-request>

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

Sample adapter response for the Delete Installed Software 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>
              <license-number>
                <value>license number-01</value>
                <type>String</type>
              </license-number>
              <installed-on-c-i>
                <value>installed on c i-01</value>
                <type>String</type>
              </installed-on-c-i>
              <application-name>
                <value>application name-01</value>
                <type>String</type>
              </application-name>
            </keys>
            <instance>
              <application-name>
                <value>application name-01</value>
                <type>String</type>
              </application-name>
              <license-number>
                <value>license number-01</value>
                <type>String</type>
              </license-number>
              <directory>
                <value>directory-UPDATED</value>
                <type>String</type>
              </directory>
              <description>
                <value>description</value>
                <type>String</type>
              </description>
              <version>
                <value>version</value>
                <type>String</type>
              </version>
              <installation-date>
                <value>2008.11.01 08:00:00</value>
                <type>DateTime</type>
              </installation-date>
              <installed-by>
                <value>installed by</value>
                <type>String</type>
              </installed-by>
              <installed-on-c-i>
                <value>installed on c i-01</value>
                <type>String</type>
              </installed-on-c-i>
              <suite-component>
                <value>true</value>
                <type>Boolean</type>
              </suite-component>
              <is-authorized>
                <value>true</value>
                <type>Boolean</type>
              </is-authorized>
              <status>
                <value>status</value>
                <type>String</type>
              </status>
              <serial-number>
                <value>serial number</value>
                <type>String</type>
              </serial-number>
              <uniquequery>license.number="license number-01" and logical.name="installed on c i-01" and application.name="application 
name-01"</uniquequery>
              <recordid>license number-01 - installed on c i-01 - application name-01</recordid>
            </instance>
          </model>
          <messages>
            <element>
              <value>pcsoftware record deleted.</value>
            </element>
          </messages>
          <status>SUCCESS</status>
          <message>Success</message>
          <schema-revision-date>2010.01.21 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 Installed Software operation

Comments