Approve Change operation
The Approve Change operation approves a change 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.
Elements for the <items> XML element and adapter request for the Approve Change operation
Element |
Definition |
Required |
---|---|---|
|
Specifies the name of the operation: |
Yes |
|
Contains the other elements in the request |
Yes |
|
Contains elements that uniquely identify a record |
Yes |
|
Specifies a unique record |
Yes |
|
Specifies the header information of the change record; is a structure-type element |
Yes |
|
Specifies the unique ID of a change record that is used as the key to identify the record |
No |
|
Specifies the category of the change record
|
No |
|
Specifies the status of a change
|
No |
|
Specifies the status of the approval for the change
|
No |
|
Specifies the name of the person who is requesting the change |
Conditional; required only if |
|
Specifies the name of the person to whom the change is assigned |
No |
|
Specifies the assignment group for the change |
Yes |
|
Specifies the coordinator of the change. |
No |
|
Specifies the phone number of the coordinator for the change |
No |
|
Specifies the planned start date of the change. |
No |
|
Specifies the planned end date for the change |
No |
|
Specifies the reason for the change |
No |
|
Specifies the current phase of the change
|
No |
|
Specifies the risk assessment for the change
|
No |
|
Specifies the priority of the change as specified by the user who created the ticket |
No |
|
Specifies the date when the change record was entered into the system |
No |
|
Specifies whether the change record is in an open state
|
No |
|
Specifies the time required to roll back the change, if necessary |
No |
|
Specifies the date on which the change request was closed |
No |
|
Specifies the foreign ID of the change |
No |
|
Specifies the type of the request for change (RFC) |
No |
|
Specifies the name of the company |
No |
|
Specifies the title or a brief description of the change |
No |
|
Specifies the subcategory for the specified category |
No |
|
Specifies the Service Level Agreement (SLA) ID associated with the change |
No |
|
Specifies an array of descriptions for the change; is a structure type element |
Yes |
|
Specifies a description for the change; is an array-type element |
No |
|
Specifies the justification for the change; is an array-type element |
No |
|
Specifies the method to use to roll back the change, if necessary |
No |
|
Specifies an array of descriptions for the change; is a structure-type element |
Yes |
|
Specifies the configuration item associated with the change |
No |
|
Specifies the location associated with the change |
No |
|
Specifies miscellaneous information about the change |
No |
|
Specifies miscellaneous information about the change |
No |
|
Specifies the outage start date and time associated with the change |
No |
|
Specifies the outage end date and time associated with the change |
No |
|
Specifies the scheduled outage start date and time associated with the change |
No |
|
Specifies the scheduled outage end date and time associated with the change |
No |
|
Specifies the actual outage start date and time associated with the change |
No |
|
Specifies the actual outage end date and time associated with the change |
No |
|
Specifies a miscellaneous array element for the change |
No |
|
Specifies a miscellaneous array element for the change |
No |
|
Specifies a miscellaneous array element for the change |
No |
|
Specifies the configuration items associated with the change record; is an array-type element |
No |
|
Specifies the description of the estimate obtained for the change |
No |
|
Specifies the estimated price for implementing the change |
No |
|
Specifies the actual cost of implementing the change |
No |
|
Specifies the actual price for implementing the change |
No |
|
Contains elements that specify the closure details and comments for the change record; is a structure-type element |
Yes |
|
Specifies the completion code for the change |
No |
|
Specifies the closure comments for the change; is an array-type element |
No |
|
Specifies the level of urgency for the change
|
No |
|
Specifies the initial assessment of the change
|
No |
|
Specifies the service to be used for the change |
No |
|
Specifies the requested end date for the change |
No |
The following figure displays a sample adapter request for the Approve Change operation.
Sample adapter request for the Approve Change operation
<hp-service-manager-request>
<entity>change</entity>
<entity-type />
<request>
<operation-name>approve-change</operation-name>
<parameters>
<approve-change-request>
<model>
<keys>
<change-number>
<value>C10005</value>
<type>String</type>
</change-number>
</keys>
<instance>
<header>
<type>Structure</type>
</header>
<description-structure>
<type>Structure</type>
</description-structure>
<middle> </middle>
<close>
<type>Structure</type>
</close>
</instance>
</model>
</approve-change-request>
</parameters>
</request>
</hp-service-manager-request>
The following figure displays an adapter response for the Approve Change operation.
Sample adapter response for Approve Change 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>
<change-number>
<value>C10005</value>
<type>String</type>
</change-number>
</keys>
<instance>
<header>
<type>Structure</type>
<change-number>
<value>C10005</value>
<type>String</type>
</change-number>
<category>
<value>Hardware</value>
<type>String</type>
</category>
<status>
<value>initial</value>
<type>String</type>
</status>
<approval-status>
<value>approved</value>
<type>String</type>
</approval-status>
<requested-by>
<value>BARROW, JESSE</value>
<type>String</type>
</requested-by>
<assignment-group>
<value>Hardware</value>
<type>String</type>
</assignment-group>
<coordinator>
<value>Change.Approver</value>
<type>String</type>
</coordinator>
<planned-start-date>
<value>2010.01.20 12:30:00</value>
<type>DateTime</type>
</planned-start-date>
<planned-end-date>
<value>2010.01.30 12:30:00</value>
<type>DateTime</type>
</planned-end-date>
<current-phase>
<value>Change Approval</value>
<type>String</type>
</current-phase>
<risk-assessment>
<value>5</value>
<type>String</type>
</risk-assessment>
<priority>
<value>3</value>
<type>String</type>
</priority>
<date-entered>
<value>2010.01.21 14:53:23</value>
<type>DateTime</type>
</date-entered>
<open>
<value>true</value>
<type>Boolean</type>
</open>
<backout-duration>
<value>PT0S</value>
<type>Duration</type>
</backout-duration>
<company>
<value>advantage</value>
<type>String</type>
</company>
<brief-description>
<value>Firmware upgrade</value>
<type>String</type>
</brief-description>
<subcategory>
<value>Configure Hardware</value>
<type>String</type>
</subcategory>
</header>
<description-structure>
<type>Structure</type>
<description>
<type>Array</type>
<description>
<element>
<value>Sleep-mode firmware upgrade</value>
<type>String</type>
</element>
</description>
</description>
</description-structure>
<middle>
<type>Structure</type>
<configuration-item>
<value>adv-nam-lapt-107</value>
<type>String</type>
</configuration-item>
<location>
<value>North America</value>
<type>String</type>
</location>
<assets>
<type>Array</type>
<assets>
<element>
<value>adv-nam-lapt-107</value>
<type>String</type>
</element>
</assets>
</assets>
</middle>
<close>
<type>Structure</type>
<completion-code>
<value>1</value>
<type>Decimal</type>
</completion-code>
</close>
<urgency>
<value>3</value>
<type>String</type>
</urgency>
<initial-assessment>
<value>4</value>
<type>String</type>
</initial-assessment>
<service>
<value>MyDevices</value>
<type>String</type>
</service>
<requested-date>
<value>2007.09.29 13:10:00</value>
<type>DateTime</type>
</requested-date>
<uniquequery>header,number="C10005"</uniquequery>
<recordid>C10005 - Firmware upgrade</recordid>
</instance>
</model>
<messages>
<element>
<value>Change C10005 Phase Change Approval Updated by Change.Approver.</value>
</element>
<element>
<value>Change C10005 Phase Change Approval Approved by Change Approver.</value>
</element>
<element>
<value>Change C10005 Phase Change Approval Approved by Change.Approver.</value>
</element>
<element>
<value>The Approval Status has been set to approved. No other groups are pending approval
</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>
Comments
Log in or register to comment.