Update Computer operation

The Update Computer operation updates a computer record.

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. The default values of all elements are ignored.

Elements for the <items> XML element and adapter request for the Update Computer operation

Element	Definition	Required
`<operation-name>`	Specifies the name of the operation: `update-computer`	Yes
`<model>`	Contains the other elements in the request	Yes
`<keys>`	Contains elements that uniquely identify a record	Yes
`<logical-name>`	Specifies the unique name for identifying a computer 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 computer 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 computer The `<file-device>` element can contain multiple child elements.	Yes
`<istatus>`	Specifies the status of the computer item Valid values: Planned/On order Received In Stock Reserved In use Maintenance Disposed/Retired Installed	No
`<assignment>`	Specifies the assignment group for the computer item Valid value: Any string, or an existing record from the application	No
`<vendor>`	Specifies the name of the vendor for the computer item Valid value: Any string, or an existing record from the application	No
`<serial-number>`	Specifies the serial number Valid value: Any string	No
`<location>`	Specifies the location of the computer item Valid value: Any string, or an existing record from the application	No
`<configuration-item-type>`	Specifies the type of the configuration item Note: The `<configuration-item-type>` field is optional in the WebService API but is required to filter the records of computer items. If you do not specify the value for `<configuration-item-type>`, then the records will be searched for all configuration items, such as furnishing, device, and computer. Therefore, BMC recommends that you provide a value for the `<configuration-item-type>` element. Valid value: computer	No
`<part-no>`	Specifies the part number related to the computer item Valid value: Any string, or an existing record from the application	No
`<version>`	Specifies the version of the computer item Valid value: Any string	No
`<model>`	Specifies the model of the computer Valid value: Any string	No
`<updated-by>`	Specifies the person who last updated the record Default value: The name of the person who updated the record	No
`<subtype>`	Specifies the subtype for a selected type of configuration item The list of valid values is customizable. You can add and delete `<subtype>` values. For example: Artwork Armoire Bookcase Chair Computer Desk Desk Collection File Cabinet Meeting Table	No
`<building>`	Specifies the building for the computer item 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
`<file-computer>`	Contains child elements for describing the computer item; is a structure-type element	Yes
`<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 computer item Valid values: Development Test Production Failover None	No
`<owner>`	Specifies the department that owns the computer 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 computer item Valid values: 1: Enterprise 2: Site / Dept 3: Multiple Users 4: User	No
`<title>`	Specifies the title of the computer item Valid value: Any string	No
`<problem-priority>`	Specifies the priority of the computer item Valid values: 1: Critical 2: High 3 - Average 4: Low	No
`<id>`	Specifies the ID of the computer item Valid value: Any unique string	No

The following figure displays the sample adapter request for the Update Computer operation.

Sample adapter request for the Update Computer operation


 <hp-service-manager-request>
    <entity>configurationitem</entity>
    <entity-type>computer</entity-type>
    <request>
      <operation-name>update-computer</operation-name>
      <parameters>
        <update-computer-request>
          <model>
            <keys>
              <logical-name>
                <value>Computer1</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>computer</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>Computer Desk</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-computer>
                <type>Structure</type>
              </file-computer>
            </instance>
          </model>
        </update-computer-request>
      </parameters>
    </request>
  </hp-service-manager-request>

The following figure displays an adapter response for the Update Computer operation.

Sample adapter response for the Update Computer 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>Computer1</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>
                <configuration-item-type>
                  <value>computer</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>
                <istatus>
                  <value>Received</value>
                  <type>String</type>
                </istatus>
                <version>
                  <value>V 1.1</value>
                  <type>String</type>
                </version>
                <subtype>
                  <value>Computer Desk</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>
                <sysmodtime>
                  <value>2010.02.04 19:27:54</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmodcount>
                  <value>1</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>
                <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-computer>
                <type>Structure</type>
                <sysmodtime>
                  <value>2010.02.04 19:27:54</value>
                  <type>DateTime</type>
                </sysmodtime>
                <sysmoduser>
                  <value>falcon</value>
                  <type>String</type>
                </sysmoduser>
                <sysmodcount>
                  <value>1</value>
                  <type>Decimal</type>
                </sysmodcount>
              </file-computer>
              <uniquequery>file.device,logical.name="Computer1"</uniquequery>
            </instance>
          </model>
          <messages>
            <element>
              <value>joincomputer record updated.</value>
            </element>
          </messages>
          <status>SUCCESS</status>
          <message>Success</message>
          <schema-revision-date>2005.03.15 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>

Update Computer operation

Comments