Find Handheld Device operation
The Find Handheld Device operation retrieves the details of a hand-held device.
The following table describes the elements of the <items> XML element and the adapter request. If not specified, the valid value for an element is assumed to be a string.
Elements for the <items> XML element and adapter request for the Find Handheld Device operation
The following figure displays a sample adapter request for the Find Handheld Device operation.
Sample adapter request for the Find Handheld Device operation
<hp-service-manager-request>
<entity>configurationitem</entity>
<entity-type>handheld-device</entity-type>
<request>
<operation-name>retrieve-hand-held-device</operation-name>
<parameters>
<retrieve-hand-held-device-request>
<model>
<keys>
<logical-name>
<value>HandHeld-001</value>
<type>String</type>
</logical-name>
</keys>
<instance>
<file-device>
<type>Structure</type>
<vendor>
<value>Intel</value>
<type>String</type>
</vendor>
<serial-no>
<value>Sr. No. 8</value>
<type>String</type>
</serial-no>
<location>
<value>MyLocation25</value>
<type>String</type>
</location>
<configuration-item-type>
<value>handhelds</value>
<type>String</type>
</configuration-item-type>
<id>
<value>CI10924</value>
<type>String</type>
</id>
<updated-by>
<value>falcon</value>
<type>String</type>
</updated-by>
<part-no>
<value>part no 55</value>
<type>String</type>
</part-no>
<istatus>
<value>Maintenance</value>
<type>String</type>
</istatus>
<version>
<value>Ver 2.2</value>
<type>String</type>
</version>
<subtype>
<value>PDA</value>
<type>String</type>
</subtype>
<location-code>
<value>Location Code</value>
<type>String</type>
</location-code>
<building>
<value>Building DEL1</value>
<type>String</type>
</building>
<floor>
<value>Lower Ground</value>
<type>String</type>
</floor>
<room>
<value>Room</value>
<type>String</type>
</room>
<sysmodtime>
<value>2010.02.10 12:26:15</value>
<type>DateTime</type>
</sysmodtime>
<sysmodcount>
<value>0</value>
<type>Decimal</type>
</sysmodcount>
<sysmoduser>
<value>falcon</value>
<type>String</type>
</sysmoduser>
<assignment>
<value>Hardware</value>
<type>String</type>
</assignment>
<title>
<value>Title for the Hand Held device</value>
<type>String</type>
</title>
<environment>
<value>Test</value>
<type>String</type>
</environment>
</file-device>
<file-handhelds>
<type>Structure</type>
</file-handhelds>
</instance>
</model>
</retrieve-hand-held-device-request>
</parameters>
</request>
</hp-service-manager-request>
The following figure displays an adapter response for the Find Handheld Device operation.
Sample adapter response for the Find Handheld Device 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>HandHeld-001</value>
<type>String</type>
</logical-name>
</keys>
<instance>
<file-device>
<type>Structure</type>
<vendor>
<value>Intel</value>
<type>String</type>
</vendor>
<serial-no>
<value>Sr. No. 8</value>
<type>String</type>
</serial-no>
<location>
<value>MyLocation25</value>
<type>String</type>
</location>
<configuration-item-type>
<value>handhelds</value>
<type>String</type>
</configuration-item-type>
<id>
<value>CI10924</value>
<type>String</type>
</id>
<updated-by>
<value>falcon</value>
<type>String</type>
</updated-by>
<part-no>
<value>part no 55</value>
<type>String</type>
</part-no>
<istatus>
<value>Maintenance</value>
<type>String</type>
</istatus>
<version>
<value>Ver 2.2</value>
<type>String</type>
</version>
<subtype>
<value>PDA</value>
<type>String</type>
</subtype>
<location-code>
<value>Location Code</value>
<type>String</type>
</location-code>
<building>
<value>Building1</value>
<type>String</type>
</building>
<floor>
<value>Lower Ground</value>
<type>String</type>
</floor>
<room>
<value>Room</value>
<type>String</type>
</room>
<sysmodtime>
<value>2010.02.16 12:44:23</value>
<type>DateTime</type>
</sysmodtime>
<sysmodcount>
<value>3</value>
<type>Decimal</type>
</sysmodcount>
<sysmoduser>
<value>falcon</value>
<type>String</type>
</sysmoduser>
<assignment>
<value>Hardware</value>
<type>String</type>
</assignment>
<title>
<value>Title for the Hand Held device</value>
<type>String</type>
</title>
<environment>
<value>Test</value>
<type>String</type>
</environment>
</file-device>
<file-handhelds>
<type>Structure</type>
<sysmodtime>
<value>2010.02.16 12:42:20</value>
<type>DateTime</type>
</sysmodtime>
<sysmoduser>
<value>falcon</value>
<type>String</type>
</sysmoduser>
<sysmodcount>
<value>2</value>
<type>Decimal</type>
</sysmodcount>
</file-handhelds>
<uniquequery>file.device,logical.name="HandHeld-001"</uniquequery>
</instance>
</model>
<status>SUCCESS</status>
<message>Success</message>
<schema-revision-date>2010.02.04 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*