Find Telecommunication Device operation

The Find Telecommunication Device operation retrieves the details of a telecommunication 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 should be assumed to be a string.

Elements for the <items> XML element and adapter request for the Find Telecommunication Device operation

Element	Definition	Required
`<operation-name>`	Specifies the name of the operation: `retrieve-telecommunication-device`	Yes
`<model>`	Contains the other elements in the request	Yes
`<keys>`	Contains elements that uniquely identify a record If you do not specify the child elements of the `<keys>` element, the application tries to find the `<logical-name>` element in the `<instance>` element. You can specify the `<logical-name>` element in the `<keys>` element, in the `<instance>` element, or in both elements.	Yes
`<logical-name>`	Specifies a unique name for identifying a telecommunication device 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.	No
`<instance>`	Specifies a unique storage item 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 telecommunication device The `<file-device>` element can contain multiple child elements.	Yes
`<istatus>`	Specifies the status of the telecommunication device item Valid values: Planned/On order Received In Stock Reserved In use Maintenance Disposed/Retired Installed	No
`<assignment>`	Specifies the assignment group for the telecommunication device Valid value: Any string, or an existing record from the application	No
`<vendor>`	Specifies the name of the vendor for the telecommunication device Valid value: Any string, or an existing record from the application	No
`<serial-number>`	Specifies the serial number of the telecommunication device Valid value: Any string	No
`<location>`	Specifies the location of the telecommunication device Valid value: Any string, or an existing record from the application	No
`<configuration-item-type>`	Specifies the type of the configuration item Valid value: telecom	No
`<part-no>`	Specifies the part number related to the telecommunication device Valid value: Any string; or an existing record from the application	No
`<version>`	Specifies the version of the telecommunication device Valid value: Any string	No
`<model>`	Specifies the model of the telecommunication device item Valid value: Any string	No
`<updated-by>`	Specifies the name of the person who last updated the record Default value: The user who updated the record	No
`<subtype>`	Specifies the subtype for a selected type for a configuration item The list of valid values is customizable. You can add and delete `<subtype>` values. For example: Desk Phone Flush Wall Mount Headsets & Accessories NBX PBX Paging Solution Surface Mount	No
`<building>`	Specifies the building for the telecommunication device Valid value: Any string	No
`<floor>`	Specifies the floor related to the location Valid value: Any string	No
`<room>`	Specifies information about the room 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
`<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 telecommunication device Valid values: Development Test Production Failover None	No
`<owner>`	Specifies the department that owns the telecommunication device 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 telecommunication device Valid values: 1: Enterprise 2: Site / Dept 3: Multiple Users 4: User	No
`<title>`	Specifies the title for the telecommunication device Valid value: Any string	No
`<problem-priority>`	Specifies the priority of the telecommunication device Valid values: 1: Critical 2: High 3 - Average 4: Low	No
`<id>`	Specifies the ID of the telecommunication device Valid value: Any unique string	No
`<file-telecom>`	Contains child elements for describing the telecommunication device; is a structure-type element	Yes

The following figure displays a sample adapter request for the Find Telecommunication Device operation.

Sample adapter request for the Find Telecommunication Device operation


 <hp-service-manager-request>
    <entity>configurationitem</entity>
    <entity-type>telecommunication-device</entity-type>
    <request>
      <operation-name>retrieve-telecommunication-device</operation-name>
      <parameters>
        <retrieve-telecommunication-device-request>
          <model>
            <keys>
              <logical-name>
                <value>TD-010</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <istatus>
                  <value>Received</value>
                  <type>String</type>
                </istatus>
                <vendor>
                  <value>Compaq</value>
                  <type>String</type>
                </vendor>
                <model>
                  <value>2011</value>
                  <type>String</type>
                </model>
                <serial-no>
                  <value>Sr no</value>
                  <type>String</type>
                </serial-no>
                <location>
                  <value>Asia</value>
                  <type>String</type>
                </location>
                <configuration-item-type>
                  <value>telecom</value>
                  <type>String</type>
                </configuration-item-type>
                <id>
                  <value>CI10893</value>
                  <type>String</type>
                </id>
                <updated-by>
                  <value>falcon</value>
                  <type>String</type>
                </updated-by>
                <part-no>
                  <value>1007</value>
                  <type>String</type>
                </part-no>
                <version>
                  <value>V 1.1</value>
                  <type>String</type>
                </version>
                <subtype>
                  <value>Desk Phone</value>
                  <type>String</type>
                </subtype>
                <location-code>
                  <value>advantageasia</value>
                  <type>String</type>
                </location-code>
                <vendor-id>
                  <value>CPQ</value>
                  <type>String</type>
                </vendor-id>
                <floor>
                  <value>2</value>
                  <type>String</type>
                </floor>
                <room>
                  <value>Delta</value>
                  <type>String</type>
                </room>
                <problem-priority>
                  <value>1</value>
                  <type>String</type>
                </problem-priority>
                <assignment>
                  <value>Application</value>
                  <type>String</type>
                </assignment>
                <title>
                  <value>Title of the Furnishing</value>
                  <type>String</type>
                </title>
                <environment>
                  <value>Development</value>
                  <type>String</type>
                </environment>
                <owner>
                  <value>D-0001</value>
                  <type>String</type>
                </owner>
                <default-impact>
                  <value>1</value>
                  <type>Decimal</type>
                </default-impact>
              </file-device>
              <sysmodtime>
                <value>2010.02.03 11:48:32</value>
                <type>DateTime</type>
              </sysmodtime>
              <sysmodcount>
                <value>2</value>
                <type>Decimal</type>
              </sysmodcount>
              <sysmoduser>
                <value>falcon</value>
                <type>String</type>
              </sysmoduser>
              <file-telecom>
                <type>Structure</type>
              </file-telecom>
            </instance>
          </model>
        </retrieve-telecommunication-device-request>
      </parameters>
    </request>
  </hp-service-manager-request>

The following figure displays an adapter response for the Find Telecommunication Device operation.

Sample adapter response for the Find Telecommunication 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>TD-010</value>
                <type>String</type>
              </logical-name>
            </keys>
            <instance>
              <file-device>
                <type>Structure</type>
                <vendor>
                  <value>Compaq</value>
                  <type>String</type>
                </vendor>
                <model>
                  <value>2011</value>
                  <type>String</type>
                </model>
                <serial-no>
                  <value>Sr no</value>
                  <type>String</type>
                </serial-no>
                <location>
                  <value>Asia</value>
                  <type>String</type>
                </location>
                <group>
                  <value>grp</value>
                  <type>String</type>
                </group>
                <configuration-item-type>
                  <value>telecom</value>
                  <type>String</type>
                </configuration-item-type>
                <id>
                  <value>CI10893</value>
                  <type>String</type>
                </id>
                <updated-by>
                  <value>falcon</value>
                  <type>String</type>
                </updated-by>
                <description>
                  <value>description</value>
                  <type>String</type>
                </description>
                <part-no>
                  <value>1007</value>
                  <type>String</type>
                </part-no>
                <istatus>
                  <value>Received</value>
                  <type>String</type>
                </istatus>
                <version>
                  <value>V 1.1</value>
                  <type>String</type>
                </version>
                <subtype>
                  <value>Desk Phone</value>
                  <type>String</type>
                </subtype>
                <location-code>
                  <value>advantageasia</value>
                  <type>String</type>
                </location-code>
                <vendor-id>
                  <value>CPQ</value>
                  <type>String</type>
                </vendor-id>
                <building>
                  <value>building</value>
                  <type>String</type>
                </building>
                <floor>
                  <value>2</value>
                  <type>String</type>
                </floor>
                <room>
                  <value>Delta</value>
                  <type>String</type>
                </room>
                <sysmodtime>
                  <value>2010.02.10 17:49:12</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmodcount>
                  <value>2</value>
                  <type>Decimal</type>
                </sysmodcount>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <problem-priority>
                  <value>1</value>
                  <type>String</type>
                </problem-priority>
                <assignment>
                  <value>Application</value>
                  <type>String</type>
                </assignment>
                <location-comments>
                  <type>Array</type>
                  <location-comments>
                    <element>
                      <value>location comment1</value>
                      <type>String</type>
                    </element>
                    <element>
                      <value>location comment2</value>
                      <type>String</type>
                    </element>
                  </location-comments>
                </location-comments>
                <title>
                  <value>Title of the Furnishing</value>
                  <type>String</type>
                </title>
                <environment>
                  <value>Development</value>
                  <type>String</type>
                </environment>
                <owner>
                  <value>D-0001</value>
                  <type>String</type>
                </owner>
                <default-impact>
                  <value>1</value>
                  <type>Decimal</type>
                </default-impact>
              </file-device>
              <file-telecom>
                <type>Structure</type>
                <sysmodtime>
                  <value>2010.02.10 17:49:12</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <sysmodcount>
                  <value>1</value>
                  <type>Decimal</type>
                </sysmodcount>
              </file-telecom>
              <uniquequery>file.device,logical.name="TD-010"</uniquequery>
            </instance>
          </model>
          <status>SUCCESS</status>
          <message>Success</message>
          <schema-revision-date>2005.03.15 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>

Find Telecommunication Device operation

Comments