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:

Changes related to various types of attachments (notes, links) are not related to a specific transition, so an empty transition parameter returned.
A change list can return empty if you filter out specific fields or entire field sections (see ChangeHistoryResponseOptions) or if you do not have privileges to view specific sections that changed fields belong to.

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>