Skip to main content

View an item's history

Every item records what happened to it. The History tab shows that record and, for versioned items, lets you work with versions.

Prerequisites​

  • The See History item permission on the item. Versions that aren't approved additionally need the See Unapproved permission.
  • Changing approved versions requires the Administer permission; rolling a diagram back requires Modify.

Steps​

Read the timeline​

  1. Open the item and select the History tab, then expand Timeline.
  2. The timeline lists the item's events newest first — creation, name and property changes, check-ins and new versions, relationship changes, and cycle events — each with a timestamp and the user who acted.
  3. On a version entry, click View to open the item as it was in that version. A diagram that's checked out also lists its Working Draft. Click View to see someone else's draft, or Open to continue your own.
  4. On a diagram, click Compare on an entry to compare that version with another. In the dialog that opens, pick the other version. See Compare diagram versions.
  5. Use the search box to filter entries by any text, including check-in comments. On items that check in and out, the Show Versions Only checkbox reduces the timeline to version changes.
  6. Download as Excel exports the complete history as an .xlsx file (filters aren't applied to the download).

Work with approved versions​

On items that support approval cycles, the History tab also has an Approved Versions section listing current and past approved versions with their effective dates. With the Administer permission you can change the current approved version, revoke an approval's effective status, or schedule a version to become effective later — see Cycles. A repository policy can require a comment for each of these changes — see Setting repository policies.

Roll a diagram back​

On web diagrams, you can return to an earlier version. Rolling back removes nothing. It creates a new version with the old content.

  1. On the entry of the version you want back, click the circular replay-arrow icon, tooltip Save as New Version. The icon appears on every version except the latest.
  2. Under Create New Version, pick the version number. The Comments box already says which version you're rolling back to. Change it if you want.
  3. Click Create.