The device card's History shows saved additions and removals of data fields. You can use it to find out, for example, when a new field was added to a shared device card or when a field was removed. The history covers the device card's structure, not the values entered for individual Spots.
Viewing the history requires admin permissions. A Manager user's permission to view or edit the device card is not sufficient to retrieve this history.
Open the device card's history
- In the browser menu, open Assets and content → Folder tree → Device cards.
- Find the correct device card. You can use the search field below the Name column heading in the list.
- Open the device card by clicking its name.
- Select the History tab in the form that opens.
In the mobile apps, View Device Card opens the data fields for an individual Spot. Use the browser to view the shared device card's field history described in these instructions.
Read and filter events
The newest events are shown first by default. The table's Created at column shows the date and time of the event. Event indicates whether the field was Added or Removed. Attribute shows the field's name, and Made by shows the recorded identifier of the person who made the change: for changes made in the browser, this is the user's email address.
The filters are below the table's column headings. Filter events using the date range in the Created at column, select Added or Removed in the Event filter, or enter search text in the search field in the Attribute or Made by column. Clear any filters you no longer need when you want to see other events as well.
The attribute's name is retrieved from its current details. It is not a copy of the name saved at the time of the event. If the attribute has been renamed, older events also display its current name. If the attribute can no longer be found, the column displays Deleted device card field. This text indicates that the name information is missing; the event type is still shown in the Event column. A removed field may therefore also display its usual attribute name if the attribute still exists.
What does the history show, and what does it leave out?
The history includes saved field additions and removals. It does not show changes to the device card's name, description or field order, or unsaved changes in the form. Simply adding or removing a field in the form does not yet create an event in this history.
The history is a view for reviewing changes: it cannot be used to restore a removed field or its previous values. Saved field changes to a device card in use are applied in the background to the Spots in the folders that use it, and to the folders' extra information fields if the card is used for them. Removing a field also deletes saved values associated with it. Adding the field back does not restore these values. For instructions on making changes, see Creating a device card and arranging fields.
Check the result or a missing event
If you cannot find an event you expected to see, first check the device card's name and clear the history filters. If you have just changed fields, make sure you selected Save on the Device card tab and received the Device card updated notification. Open the card again, check the saved field structure, and then open History. Changes to the name, description or field order are not supposed to create an addition or removal event.
A history row confirms an event saved to the device card's structure. On its own, it does not confirm that the background update has already finished for all Spots and folders. If necessary, also check the fields of the Spot or folder affected by the change.
Looking for a change to a value on an individual Spot?
If you want to investigate a change to a serial number, for example, view the value history of the data field on that Spot. It shows the old and new values for that specific Spot. Adding a field to a device card and changing a field's value on a Spot are different events. For instructions on opening and filtering the history, see Spot contact details and data field history.