Update Installed Software operation
The Update Installed Software operation updates the details of an installed software.
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.
The default value for all elements is ignored.
Elements for the <items> XML element and adapter request for the Update Installed Software operation
The following figure displays the sample adapter request for the Update Installed Software operation.
Sample adapter request for the Update Installed Software operation
<hp-service-manager-request>
<entity>configurationitem</entity>
<entity-type>installed-software</entity-type>
<request>
<operation-name>update-installed-software</operation-name>
<parameters>
<update-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>
</update-installed-software-request>
</parameters>
</request>
</hp-service-manager-request>
The following figure displays an adapter response for the Update Installed Software operation.
Sample adapter response for the Update 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 updated.</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>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*