Change history helps you investigate saved changes to, for example, a Spot, task or customer. You can compare the old and new values in events and check when a change occurred and who was identified as making it. The history shows only changes that have been recorded in it and are displayed in the current view.
Find the item in the shared change history
As an administrator, open History → Changes from the browser's main menu. The Manager's History menu does not include the shared Changes page. This browser menu path is not available in the Android or iOS app menus.
- Select the Item type at the top of the page, for example Spot, Task or Customer. The default is Spot.
- Use the switch next to the item type to select In the system when looking for an item that still exists. For deletion events, select Removed.
- In the In the system list, enter the name or part of it in the search field below the Name column. Search for a task by its title. If necessary, change pages using the pagination controls at the bottom of the table.
- Open View changes in the Change history column of the relevant row.
The main list shows items, rather than all events within a particular period. In the In the system list, Changed time is the date when the item's current information was last updated. Latest shows a Create or Update entry; it does not identify the changed fields or who made the change. By default, items are ordered by their latest update.
If an item's creation and update times are the same, the row does not display a View changes link. The absence of the link alone does not mean that no history has been recorded for the item. Changing the item type or the In the system/Removed selection clears the table's search criteria.
Select a period and read an event
View changes opens a separate item history window. Check the item's name and item type in the window before interpreting the events.
- From the period menu at the top of the window, select 1 Month, 3 months or 6 months. The default is one month; the preset periods are calculated backwards from the current time.
- If you need a different period, select Filter by specific time range. You can then select the start and end dates in the Date range field. The search updates once both dates have been selected and includes the full start and end days. The calendar limits the end date to no more than six months from the selected start date. This allows you to investigate older history in batches as well.
- Events are displayed newest first by default. Check the Event, User and Date on the event row.
- Expand the event using the expand icon at the start of the row in the Event column. In the child rows, Changed field identifies the information that changed, Old value shows the value before the event and New value shows the value after it.
You can filter the loaded events using the filters below the column headings, for example by event, user, date, changed field or value. The Date column filter narrows down the history already retrieved: it does not extend the period selected at the top of the window. Changing the period clears the column filters.
If necessary, compare consecutive events and the item's current information. The New value in an individual event may no longer be the current value if the information has since changed. If the person who made the change cannot be identified from the recorded information, the row displays Unknown user. This alone does not mean that the system made the change.
What does the Removed selection show?
Removed shows administrators recorded deletion events for the selected item type. The name in the list is based on the information recorded in the deletion event, and Changed time is the time of that event. In this list, the Name search does not filter deletion events, so find the relevant row using the item type, name, date and pagination controls.
The Removed selection does not restore the item. It also does not mean the same thing as another item status, deactivation or archiving. An item appears in this list only if a deletion event displayed here has been recorded for it.
Choose the appropriate history for the information you are investigating
The shared item history does not show every field or every change to related information. For example, changes to a task's worker and resourcing rows are not included in this history. Changes that only affect the update timestamp and other events with no relevant content for this view may also be omitted.
- To investigate changes to the value of an individual Spot's data field, open Assets, devices, tools in the browser, open the Spot by clicking its name and select the history icon next to the relevant field. See the instructions for a Spot data field's value history. Reading the history requires permission to view the Spot.
- For fields added to or removed from a shared device card, use the device card's History tab. See the instructions for device card field change history.
- For changes to the structure of a task form, use the form's History tab. See the instructions for task form changes and restoring a field.
Change history and read events answer different questions: history shows recorded changes, while read events relate to reading tags. Integration errors are also investigated using the integration's own event log.
Verify the result before drawing a conclusion
If you cannot find the change you expected, check the item and item type, the In the system/Removed selection, the history period, the column filters and the other pages of the table. Use the data field's or form's own history if necessary. An empty result does not prove that no change was made: the change may fall outside the selected period or the scope of this view.
Viewing history does not change the item's information or restore a previous value. If information needs correcting, open the actual item for editing according to your permissions and save the correction. Then check the item's current information and any new history event.