Promotion History and the Restore Option
Overview
The Controller creates a Promotion History record each time a Bundle (or record) is promoted to a target Controller.
Accessing Promotion History Records
To access a Promotion History record on the target Controller:
Step 1 | From the Bundles & Promotion navigation pane, select Promotion History. The Promotion History list displays. |
|---|---|
Step 2 | Click anywhere in the row of a Bundle on the list, or click the icon next to the Bundle Name of a Bundle, to display Promotion History Details for that Bundle. |
Step 3 | To see a list of all records included in the promoted Bundle, click the Promotion History Items tab. |
Step 4 | You can restore records to the state they were in before the promotion. This applies only to records being updated by the promotion, not those being created by a promotion. See the field descriptions below for details. |
Promotion History Details Field Descriptions
The fields on the Promotion History Details are system-supplied and read-only.
Field Name | Description |
|---|---|
Details | This section contains detailed information about the promoted Bundle (or record). |
Bundle Name |
Name of this record. |
Source Node |
Machine name or URI of the machine where the source Universal Controller system is running. |
Promotion User |
User ID of the user who promoted the bundle or record(s). |
Can Restore | Specification for whether or not records in the bundle that already existed on the target server can be restored to their state prior to the promotion. Note Any promoted Bundle that includes Universal Template changes cannot be restored. The Promotion History for the promotion will be flagged as not restorable. The Universal Template changes will be listed as Promotion History Items with blank New Version, Previous Version, and Source Version fields. |
Metadata | This section contains Metadata information about this record. |
UUID | Universally Unique Identifier of this record. |
Updated By | Name of the user that last updated this record. |
Updated | Date and time that this record was last updated. |
Created By | Name of the user that created this record. |
Created | Date and time that this record was created. |
Buttons | This section identifies the buttons displayed above and below the Promotion History Details that let you perform various actions. |
Run Report |
Generates a one page summary of the contents of the bundle. |
Restore Unchanged | For records that already existed on the target server, you can restore them to their state prior to the promotion. The Restore Unchanged button restores only those records that have not been changed since the promotion updated the record. For records that were created on the target machine by the promotion, no changes will occur since no previous version exists. (See Can Restore.) |
Restore All | For records that already existed on the target server, you can restore them to their state prior to the promotion. The Restore All button restores all records that were updated by the promotion, including records that were modified since the promotion. For records that were created on the target machine by the promotion, no changes will occur since no previous version exists. (See Can Restore.) |
Delete |
Deletes the current record. |
Refresh | Refreshes any dynamic data displayed in the Details. |
Close | For pop-up view only; closes the pop-up view of this record. |
Tabs | This section identifies the tabs across the top of the Promotion History Details that provide access to additional information about the promotion. |
Promotion History Items |
Lists all the records promoted as part of this Bundle. Each record in the list provides the name and type of the record, the latest version number on the target, the previous version number on the target, and the source version number. |