History and undo (rollback)
Facet records every change to every document. The history page shows who changed what, and when. You can put a document back to an earlier version. You can also bring back a document that someone deleted.
1. Open the history page
Section titled “1. Open the history page”Open the document. The details block lists the created and updated times. Select the History link in it. The link shows the current version, for example v42.
The history page opens. Its heading shows the document name and the number of recorded changes. Select Back to document to return.
2. Read a change entry
Section titled “2. Read a change entry”The timeline lists every change, newest first. Each row shows:
| Part | What it shows |
|---|---|
| Action | Create, update, delete, or snapshot |
| Document | The changed document. A change to a child document carries its own badge. |
| Summary | Short text that describes the change. |
| Actor | The account or system that made the change. |
| When | The time, relative to now. |
Select a row. The detail pane shows four lines:
-
What — the action, the document, and its version at that change, for example v3.
-
Who — the actor, with a chip that names the cause. Examples: via Assistant, via Rollback. A plain edit shows the channel; a browser session shows as facet.
-
When — the full date and time in your timezone, plus the relative time.
-
Ref — the change id with a copy button, and the number of field changes.
Below the header, Facet lists the fields that changed. Most rows show the new value. A removed field shows a removed note. A value your role cannot see shows a Value hidden chip.
3. Put the document back to an earlier version
Section titled “3. Put the document back to an earlier version”- Select the change that holds the content you want.
- Select Revert to this version. The dialog names the document and the change.
- Select Roll back.
Facet sets the document back to the content and details of that change. A new snapshot entry appears at the top of the timeline.
4. Restore a deleted document
Section titled “4. Restore a deleted document”If you have a link to the history page of the deleted document, open it.
- Select the delete entry. The hint Revert restores the document. shows.
- Select Revert to this version, then Roll back.
On the global audit log, an administrator selects the delete row and selects Restore document.
Facet puts the document back with the content it had before the delete. Facet also brings back the child documents that the delete removed.
5. Undo a whole action (administrators)
Section titled “5. Undo a whole action (administrators)”Open the global audit log in the Configure area. It lists every change in every domain. Each row shows the action, the document, the actor, the channel, and the time.
Select a row. When one action changed several documents, the panel shows One action — N changes across M documents, with a Roll back the whole action control.
Select it, then confirm with Roll back action. Every document in the action returns to its state before the action. Documents that the action created are deleted.
The global audit log needs permission to read every domain. The undo also needs update rights on each document in the action. If one document fails the check, Facet changes nothing.
Example
Section titled “Example”Select a change, and the page address updates. Send the address to a colleague. The colleague opens the same change:
/crm/Company/01JCATPMKP4N82GVG2J7K4MHZZ/history?mutation=01HRR7X9QK3V5T2W8Y4Z6A0BCDTroubleshooting
Section titled “Troubleshooting”The revert control is missing
Section titled “The revert control is missing”The selected change is the newest one. A revert would change nothing. Select an earlier change.
Your role may lack update permission on the doctype. Facet shows the reason under the control.
Facet refuses the rollback
Section titled “Facet refuses the rollback”The selected change is older than the retention window. The error names the window. Ask your administrator to widen the window, or work with the current content.
An entry shows Value hidden
Section titled “An entry shows Value hidden”Your role cannot see that field. The log still lists the change, but not the value. See How Facet checks permissions.
A shared link does not open the change
Section titled “A shared link does not open the change”The page loads older pages by itself. If it cannot find the change, it says so. The change may be older than the retention window, or the link is wrong.
Related
Section titled “Related”- The mutation log — what Facet records for every change.
- Viewing and editing a document — where you open a document.
- Roles, levels, and authority — the rights behind the revert control.
- How Facet checks permissions — why some values show as hidden.
- Govern access — set roles and retention windows as an administrator.