ItemChangeAction

Description

The ItemChangeAction type holds the change history for an item. The ItemChangeAction type parameters are listed below.

Parameters

Name Type Description
action string The type of change action that was performed.
time dateTime The timestamp used when the change record was created.
user UserIdentifier The user who performed the transition.
realUser UserIdentifier The account of the user that was logged in as another user.
priorState StateIdentifier The state the item was in before the transition (if displayPriorValues was set to true and the state was changed).
newState StateIdentifier The state the item is in after the transition (if the state was changed).
priorOwner UserIdentifier The owner of the item before the transition (if displayPriorValues was set to true and the owner was changed).
newOwner UserIdentifier The owner of the item after the transition (if the owner was changed).
transition TransitionIdentifier The transition that was performed. Some change actions are not related to a specific transition. See Usage notes below.
change Change Contains the field that was changed, plus prior and new values.
extendedData ExtendedData Placeholder for future arguments.

Usage

The ItemChangeAction type is part of the response to the GetItemsChangeHistory call. ItemChangeAction holds the same information that you see in the details of the Change History for an item. You can use GetItemsChangeHistory to retrieve the data shown here.

Note the following:

XML

The following XML snippet shows the ItemChangeAction type in the return element of the GetItemsChangeHistory response.

<ae:GetItemsChangeHistoryResponse>
   <ae:return>
      <ae:item>
         <ae:displayName>BUG000173</ae:displayName>
         <ae:id>109</ae:id>
         <ae:uuid>c1e62a05-5dd1-46e7-9cdc-b91518893b23</ae:uuid>
         <ae:tableId>1000</ae:tableId>
         <ae:tableIdItemId>1000:109</ae:tableIdItemId>
         <ae:issueId>000173</ae:issueId>
      </ae:item>
      <ae:queryRange>
         <ae:startIndex>0</ae:startIndex>
         <ae:fetchSize>1</ae:fetchSize>
         <ae:totalCount>9</ae:totalCount>
      </ae:queryRange>
      <ae:changeAction>
         <ae:action>Updated</ae:action>
         <ae:time>2018-07-17T12:17:42-07:00</ae:time>
         <ae:user>
            <ae:displayName>Bill Admin</ae:displayName>
            <ae:id>27</ae:id>
            <ae:uuid>225b4498-ce4b-4332-8775-6ccca90bebb4</ae:uuid>
            <ae:loginId>bill</ae:loginId>
         </ae:user>
         <ae:realUser>
            <ae:displayName>Administrator</ae:displayName>
            <ae:id>8</ae:id>
            <ae:uuid>9f9146a3-a273-4411-8000-8396688b7554</ae:uuid>
            <ae:loginId>admin</ae:loginId>
         </ae:realUser>
         <ae:newState>
            <ae:displayName>Resolved</ae:displayName>
            <ae:id>7</ae:id>
            <ae:uuid>ea57582f-5c62-4bcd-b250-5e21cad308e3</ae:uuid>
            <ae:internalName/>
            <ae:isClosed>true</ae:isClosed>
         </ae:newState>
         <ae:newOwner>
            <ae:displayName/>
            <ae:id>0</ae:id>
            <ae:uuid/>
            <ae:loginId/>
         </ae:newOwner>
         <ae:transition>
            <ae:displayName>Pass</ae:displayName>
            <ae:id>14</ae:id>
            <ae:uuid>50f22008-6faa-41e9-af28-5b39d4adc968</ae:uuid>
            <ae:internalName/>
         </ae:transition>
         <ae:change>
            <ae:field>
               <ae:displayName>State</ae:displayName>
               <ae:id>82</ae:id>
               <ae:uuid>ebda959b-cbef-434b-ab68-83f8a8c03730</ae:uuid>
               <ae:dbName>STATE</ae:dbName>
            </ae:field>
            <ae:newvalue>Resolved</ae:newvalue>
         </ae:change>
         <ae:change>
            <ae:field>
               <ae:displayName>Owner</ae:displayName>
               <ae:id>86</ae:id>
               <ae:uuid>91548936-7979-49eb-9a03-1cb4545361d4</ae:uuid>
               <ae:dbName>OWNER</ae:dbName>
            </ae:field>
            <ae:newvalue>(None)</ae:newvalue>
         </ae:change>
         <ae:change>
            <ae:field>
               <ae:displayName>Active/Inactive</ae:displayName>
               <ae:id>80</ae:id>
               <ae:uuid>e90174d9-76fa-4ac2-b2bd-13944626c685</ae:uuid>
               <ae:dbName>ACTIVEINACTIVE</ae:dbName>
            </ae:field>
            <ae:newvalue>Inactive</ae:newvalue>
         </ae:change>
         <ae:change>
            <ae:field>
               <ae:displayName>Last Modified Date</ae:displayName>
               <ae:id>77</ae:id>
               <ae:uuid>a14f293b-fb49-4807-815d-cd02c284ab4d</ae:uuid>
               <ae:dbName>LASTMODIFIEDDATE</ae:dbName>
            </ae:field>
            <ae:newvalue>07/17/2018 12:17:42 PM</ae:newvalue>
         </ae:change>
         <ae:change>
            <ae:field>
               <ae:displayName>Close Date</ae:displayName>
               <ae:id>164</ae:id>
               <ae:uuid>68a285b6-92f7-46da-8c9c-7a376a5e83b2</ae:uuid>
               <ae:dbName>CLOSEDATE</ae:dbName>
            </ae:field>
            <ae:newvalue>07/17/2018 12:17:42 PM</ae:newvalue>
         </ae:change>
         <ae:change>
            <ae:field>
               <ae:displayName>Last State Change Date</ae:displayName>
               <ae:id>165</ae:id>
               <ae:uuid>f2ef8a18-61f8-4272-8353-2f2796223e33</ae:uuid>
               <ae:dbName>LASTSTATECHANGEDATE</ae:dbName>
            </ae:field>
            <ae:newvalue>07/17/2018 12:17:42 PM</ae:newvalue>
         </ae:change>
      </ae:changeAction>
   </ae:return>
</ae:GetItemsChangeHistoryResponse>