Modeler provides change tracking so that you can record an audit trail of changes made to a Model. Change tracking is achieved through Change Note dictionary items and the Changes tabs that appear on the property pages of all item and diagram types.

In addition to creating an audit trail, change tracking provides a mechanism for reviewing and accepting changes made by a particular user or changes relating to a particular Change Note. This is achieved by using a sandbox for each change.

By default, change tracking is disabled in a new model. You enable change tracking through the Model's property pages in Modeler - on the Change Tracking tab, select the Enable Change Tracking check box. You require Owner access permissions to the model to enable or disable change tracking.

After enabling change tracking in a model, you cannot make any changes in the model until you make a Change Note active. You can make a Change Note active by right-clicking the Change Note, and then clicking Set Active. Alternatively, you can select an active Change Note through the Change Tracking tab, which shows the active Change Note in the drop-down list. Each user's active Change Note is stored in the registry of their computer so that each user of a model can have a different active Change Note.

When change tracking is enabled, a change to an item in the Model results in the change being recorded in the Changes tab of the active Change Note and the in Changes tab of the item that was changed. For example:

We change the name of Class1 to My Name.

The change is recorded against the Class. The change records which user did the change, when the change was made, a description of the change, and which Change Note was active.

The same change is recorded against the active Change Note as well. The change records who did the change, when the change was made, what the change was, and which items were affected by the change.

We can navigate to the affected items through the Results pane - we select the change entry on the Change Note's property pages, the Results pane lists the affected items.

After all changes relating to a Change Note have been made, you can close the Change Note - on the Options tab of the Change Note's Property Pages, select the Closed check box.

To use change tracking in a model you require a Modeler license and a Change Tracking license.

If you want to create or delete a Change Note, you require owner access permissions to the model.

If you want only specific users to use a Change Note, set the access permissions of the owning Package accordingly. If change tracking is enabled and you do not have write access to the active Change Note, you cannot make changes to the model.

You can view all items affected by a Change Note by expanding the Change Note in the Relationships pane.

If you delete a Change Note, all its change entries are deleted from the change history of affected items. If a Change Note has any changes listed, you can delete the Change Note only if you have Owner access permissions to the Model. You require Model owner access permissions to delete a Change Note.

Changes to Change Notes are not recorded as changes to the Model.

The change history appears on the Changes tab of an item's Property Pages.

The change entries are created by Modeler and cannot be changed after being created. You cannot delete a change entry.

A Change entry displays the following information about a change:

You can generate a textual report of all a Change Note's changes by right-clicking the Change Note, pointing to Report, and then clicking Details. The report is generated to the Output pane.

By default, the Change History provides a detailed listing of changes. You can view a summary of the change history through the View Change Summary button that appears on the Changes tab of Property Pages.

For a Change Note, the change summary displays an entry for each item affected by the Change Note. No descriptions are provided.

For an item, the change summary displays an entry for each Change Note that has been active when a change has been made to that item. No descriptions are provided.

The following changes are logged in the change history:

The following changes are not logged:

For guidelines to working with change tracking, see Guidelines for working with change tracking.