Using the artwork changelog

The changelog allows you to track recent edits made to your artwork entries. Learn how to use the changelog to effectively identify alterations.

When multiple team members collaborate on a project, keeping track of all the changes made to entries can be challenging. Occasionally, you may inadvertently modify data without recalling the specific changes made and may need to revert to a previous version of your artwork entry. In such cases, being able to review the modified data within an entry proves invaluable. The changelog provides a comprehensive editing history, aiding in identifying and correcting mistakes promptly.

Where to find the artwork changelog

On the artwork detail page, you find a history icon in the top right corner. Click the icon to open the changelog in an overlay.

Track recent edits made to your artwork entry

In the overlay, you'll find a list view, providing all pertinent details about the respective artwork. The information is organized in a customizable list format, allowing you to tailor your view to suit your preferences. Here's a breakdown of the available columns:

• Time & Date: Presents the timestamp of the relevant edit.
• Action: Indicates whether the edit was an Update of existing values, Insertion of new related entries, or Deletion of existing entries.
• Entity: Specifies the section of the artwork entry that was modified, such as preview media, artwork titles, or agents within events.
• Entity ID: Displays the ID of the affected entity.
• Before: Shows the state prior to the alteration.
• After: Shows the changes applied to the entity.
• Last updated by: Identifies the user responsible for the edit.

Use filters to look for specific edits

When seeking specific edits within the artwork entry, use the available filters for a more focused search. Here are the three filters at your disposal:

• Action: Narrow down results by filtering according to the type of action taken, whether it's an update or a new addition.
• Last updated by: Tailor your view by selecting a specific user from the dropdown menu, allowing you to isolate changes made by that user.
• Date & Time: Refine your search further by specifying the time frame in which edits have occurred. Simply input the date in the format: year-month-day (e.g., 2024-05-14) and confirm with enter. You can also filter the changelog for edits that happened within the same month by entering the year-month only.
• Sorting: You can apply various sorting options to organize the results in the list view. For instance, to sort the results by entity type, click on the "Entity" column. This will arrange the results based on their entity type.

How to read the changelog

The changelog records edits in rather technical terms. This may manifest, for instance, in changes not being formulated as complete sentences but recorded in the format of technical documentation. The field names may not match the labels shown in the user interface. For example, if the visibility of an entry is set to "public," the changelog displays this change as follows: "VisibilityFlag": true. 

To better understand how to read the changelog, let’s take a look at another example:

We’ve added an auction, a lot number, and an outcome to a provenance art event. In the changelog, these changes are reflected as follows:

The "Before" and "After" columns indicate what has been changed. First, we added an auction. In the "Before" column, "aucId":null shows that there was no auction linked before. In the "After" column, "aucId":23 shows the ID of the auction that has been added.

In the row above, we see the lot number we’ve added afterwards. The "Before" column indicates with "refNum":null that the lot number field was empty before. In the "After" column, we see that the lot number 17 has been added.

At the top, the changes to the Outcome field are shown. "provOutcome":null in the "Before" column indicates that the field was empty before. In the "After" column, "provOutcome":"Bought-in" shows that "Bought-in" was selected as the outcome.

Keep reading:

• Merging duplicate agent entries

Last updated: May 23, 2024