Each time you save changes to any object, Author records who made the changes and when the changes were made. This information can be used to find objects, and provides you with a complete audit trail of changes.
Certain events also create history records. A history record works as a "snapshot" of an object. You can view the history compared to the current revision, to a previous revision, or any two revisions to each other. You can also revert to a previous revision provided the history record is available.
When history records are created
There are multiple events that determine when a history record is created:
-
System events which are triggered automatically on indirect actions that cause an object to be modified. These events include:
-
History Revert - saves a revision when an object reverts to a previous history
-
XML Import - saves a revision when an object is changed by setting properties using XML:
-
by localization update
-
by importing a translation job
-
by importing an XML file
-
-
Import from another Library - saves a revision when an object is changed by being overwritten during an import from another library
-
-
User events which are triggered by save points.
Note: Save points are optional and turned off by default.
Configuring history records
To use history records, you'll need to do the following:
Save points
Save points are a combination of a trigger and a save and prompt action. For example, a revision point is created so the user is prompted to make a comment describing their changes in the History Comments window each time they close an object.
You'll define the combination of trigger points and save and prompt actions based on how content changes in your library and the requirements you may have to revert the object to an earlier revision.
Save and prompt actions
Use these options to define when a save point is created and whether a comment is required (comments can be used to give a brief explanation of the changes made, or why the changes were made to the object).
Save Points tab |
Save and prompt action |
Description |
(none): |
|
|
Save without comments: |
|
|
Save with optional comments: |
|
|
Save with mandatory comments: |
|
|
Minimum length of comments: |
Sets the minimum number of characters that must be used when adding a comment for the save point. |
|
|
|
Triggers
You can set a save and prompt action against one or more of the trigger actions on the Save Points tab. A good practice is to have a minimum of the Object close (if changed) action set. Note, the Change of author option is affected by the setting applied to the Object close (if changed) action, refer to the the Change of author option for information.
|
|
Object close (if changed):
|
To trigger the prompt, the save and prompt action must be set to a minimum of Save without comments. Note the different behavior between Author and Contribute: In Author: In Contribute: |
|
Important considerations:
|
|
|
Change of release state: |
Creates a save point when an object's Release State is changed. |
Change of author: |
Note: The following behavior occurs if the Object close (if changed) action has been set to (none), but the Prompt for unsaved changes option has been selected. (However, if the Object close (if changed) action has been set to (none), and the Prompt for unsaved changes option is not selected, then the object will be closed, the changes will be abandoned, and the prompt will not be displayed.) Note the different behavior between Author and Contribute: In Author: In Contribute: |
|
Important considerations:
|
|
|
Change of template: |
Creates a save point when a user modifies an object by changing the template the object is based on. |
Publish (if changed): |
Saves a revision / save point when a user publishes an object and the last modified record doesn't have an XML history attached. |