Content

Overview Track Changes (Change Log) Managing Change Logs View Check In Compare Changes Edit Change Request Transfer (Import/Export) Change Logs

  

 

Overview	Top

The Change Log entity is used to track all changes in the system (when Change Control is enabled). For every change, the Change Log records:

When making controlled changes, a Change Log event is automatically generated upon SDI Check Out (before any changes are made to the SDI). These Change Log events continue to capture any changes made while the SDI is checked out.

When an SDI is checked out, the following occurs:

As eligible Users make changes to the checked out SDI, those changes are tracked and associated with the Change Log until the SDI is checked back in. At Check In, a second SDI Snapshot is taken to capture the changes.

At any point during the change control process, you can use these Change Logs (SDI Snapshots) to visualize the original configuration (before any changes were made) and compare that to the current (while changes are in progress or changed) configuration.

Track Changes (Change Logs)	Top

To view the generated Change Logs, navigate to Lab Admin → Change Control → Change Logs. The Change Log List page displays.

The following information is shown on the Change Log List page:

Column	Description
Change Log ID	The automatically generated Change Log identifier.
Status	The status of the changes. Field Description Checked Out The SDI has been Checked Out but changes have not yet been made. Checked In Changes are complete and the SDI has been Checked In. CheckOut Aborted Undo Check Out has been performed and no changes were found. See Undo Check Out for more details. Deleted The SDI for which this Change Log was generated, has been deleted. When an SDI is deleted, and Change Logs exist for the SDI: • If the latest Change Log has a status of "Checked Out" the Change Log will be Checked In and the Change Log status will be changed to "Deleted". • If the latest Change Log has a status of "Checked In", the status is changed to "Deleted". NOTE:   Deleted Change Logs result in an empty SDI Snapshot. Renamed A Property Tree node was renamed. A Change Log is created for the existing node with the status "Renamed". CheckOut RolledBack Undo Check Out has been performed and some changes have been made. Any changes are rolled back. See Undo Check Out for more details.
Primary Change Log	If this Change Log is the result of a change to an associated SDI (independently managed SDI), the primary Change Log (SDI on which the independently managed SDI is referenced) is listed here.
	View Check In icon. This is displayed only after an item has been checked back in. Clicking the icon opens the SDI Viewer showing the SDI Snapshot of the data at the time of Check In. For information about visualizing SDI Snapshots see the Visualizing SDI Snapshots document. NOTE:   This is not necessarily the current state of the SDI. This is the state of the data at the time of this Check In.
	View Changes Icon. This opens the SDI Snapshot comparison view. • If the SDI is currently checked out, this shows the differences between the original (before changes) SDI Snapshot and the current configuration.  • If the SDI has been checked back in, this shows the differences between the original (before changes) SDI Snapshot, and the SDI Snapshot taken at Check In (after changes). Changes made since the original SDI Snapshot are highlighted. See Visualizing SDI Snapshots for more information.
	View Change History Icon. This opens the View Change History dialog.
Change Request	The Change Request with which this Change Log has been associated.
SDC	The SDC for which changes are being made (SDC of the SDI that was checked out).
Key	The concatenated key ids (including Property Trees) of the SDI that was checked out. When checking out a Property Tree the Key indicates whether a specific node (such as Sapphire Custom) or the full Property Tree (from the list page) has been checked out.
Checked In by	The User who checked in the SDI.
When	The date on which the SDI was checked back in. This is the date on which the final SDI Snapshot was taken. Display dates in a relative date format such as "2 days ago". See Date Format Policy for information about defining Relative Date Formats.
Checked Out To	The User or Department to whom the SDI was checked out.
When	The date on which the SDI was checked out.
Check In Comments	Comments associated with SDI Check In.
From Transfer	If the Change Log was generated as the result of an Import, the from transfer icon is displayed in the "From Transfer" column. Clicking the From Transfer icon opens the Edit Transferlog page where you can view details of the transfer. See CMT Transfer for more information about Importing a transfer package.

Managing Change Logs	Top

The following sections detail the operations available from the Change Log List page.  

"View" opens the Change Log.

Lets you Check In any Change Logs (you are checking in the associated SDIs) checked out to you. See Check Out/Check In for detailed information about checking in an SDI. 

Lets you compare the changes made between two Change Logs (change sessions). Only two Change Logs can be compared at a time, each must be for the same SDC.

When comparing Property Tree SDIs, both entries must be of the same mode. For example, you cannot compare a Change Log for a single node to a Change Log for the entire Property Tree.

Clicking "Compare Changes" opens the Snapshot Viewer. See Visualizing SDI Snapshots for detailed information about the Compare Changes SDI Snapshot.

Lets you easily manage the Change Logs (changes) associated with a given Change Request.

Choose to:

Select one or more Change Logs and click "Edit Change Request". The Select Change Request dialog displays.

Using the lookup, choose the preferred Change Request and click "OK". The Change Log is now associated with the new Change Request. Leaving the Change Request empty removes the Change Log from the Change Request (the Change Log is no longer associated with a Change Request).  

Transfer (Import/Export) Change Logs	Top

Using CMT Transfer, you can easily Export all changes made within a Check Out/Check In session (captured in the Change Log). Select one or more Change Log(s) and click "Export". This initiates the Export Wizard. See CMT Transfer → Export for more detailed information.