Retrofit Analysis Driver

This workflow identifies the code and data that should be synchronized between two development systems so that the correct changes may be migrated to a QA system. The workflow finds released tasks on the source system, and compares their changing objects on the source and target systems.

The analysis is performed for released tasks that were modified after a specified date. A change history for the objects is provided, showing the date and time when each object was modified on the source and target systems, and details for the associated tasks.

Prerequisites

The Retrofit Analysis Driver workflow uses Pipelines to identify the source and target development systems. Before running the workflow, you must create the following:

• RFC Destinations for the source and target development systems.

• A source Pipeline that has the source RFC Destination as its Analysis system.

• A target Pipeline that has the target RFC Destination as its Analysis system.

Note that each Pipeline requires a Usage System, but these are not used by the Retrofit Analysis Driver workflow.

Preparing the workflow

The Retrofit Analysis Driver workflow should be run in a separate workspace for each source and target system to be analyzed. To prepare the Retrofit Analysis Driver workflow, follow these steps.

1. Create a new workspace whose name reflects the system to be analyzed, for example Retrofit - <Source System> <Target System>.

2. Copy the Templates > Synchronization > Initialize Retrofit Task Store workflow to the Retrofit - <Source System> <Target System> workspace.

3. Select the Templates > Synchronization > Retrofit Analysis Driver template in the LiveCompare hierarchy and choose Copy to Workspace from the context menu.

4. Select Retrofit - <Source System> <Target System> as the target workspace, and click Copy. Several dependent templates will also be copied.

5. Run the Initialize Retrofit Task Store workflow in the RRIA - <Analysis System> workspace.

Select the Retrofit Analysis Driver workflow in the Retrofit - <Source System> <Target System> workspace, and configure the workflow as follows.

1. Set the Source Pipeline parameter to the Pipeline that has the source RFC Destination as its Analysis system.

2. Set the Target Pipeline parameter to the Pipeline that has the target RFC Destination as its Analysis system.

3. Set the From String parameter to the EmailFromAddress value stored in the Configuration - Email screen. You may need to check this setting with a LiveCompare Administrator.

4. Set the Email To String List parameter to a list of email recipients for the Retrofit Analysis report. Each email address should be stored a separate string entry.

Click to save the workflow.

Run the workflow

To run the Retrofit Analysis Driver workflow, click the toolbar button, choose Run Now from the diagram’s context menu, or select F5. The currently running workflow action is marked with an animated display. When the workflow execution has completed, select the Report URL dataset and choose View Details from the context menu to access the generated report.

Schedule the workflow

The Retrofit Analysis Driver workflow may be run using a schedule. To schedule the Retrofit Analysis Driver workflow, select it in the LiveCompare hierarchy and choose Schedule Run from the context menu.

Workflow results

The Retrofit Analysis Driver workflow generates the following reports:

Retrofit Analysis Dashboard

The Retrofit Analysis Driver workflow generates a Dashboard which includes the following charts:

• The Comparisons by Status column chart summarizes the comparison status of the released tasks. The In1 column refers to released tasks that are in the source system only.

• The Changes by Type pie chart summarizes the changing objects in the released tasks, grouped by their object type.

• The Source Changes by Owner column chart summarizes the released tasks on the source system, grouped by their owner.

• The Target Changes by Owner column chart summarizes the released tasks on the target system, grouped by their owner.

• Dashboard tiles display the date when the analysis was run, the source system’s RFC Destination and system ID, the target system’s RFC Destination and system ID, and the start date specified for the analysis.

The Dashboard’s Additional Resources section includes a link to the following Excel reports:

Retrofit Details

The Retrofit Details Excel report includes the following spreadsheets:

Dashboard

This spreadsheet includes the following charts:

• The Comparisons by Status column chart summarizes the comparison status of the released tasks. The In1 column refers to released tasks that are in the source system only.

• The Changes by Type pie chart summarizes the changing objects in the released tasks, grouped by their object type.

• The Source Changes by Owner column chart summarizes the released tasks on the source system, grouped by their owner.

• The Source Changes by Owner column chart summarizes the released tasks on the source system, grouped the owner of the associated task on the source system.

• The Target Changes by Owner column chart summarizes the released tasks on the target system, grouped the owner of the associated task on the source system.

• Dashboard tiles display the when the analysis was run, the start date for the analysis, the source system’s RFC Destination and system ID, and the target system’s RFC Destination and system ID.

Comparison

This spreadsheet lists the comparison details for the objects in the released tasks on the source and target systems. It has the following columns:

SOURCE_TASK

The most recent task that references a changing object on the source system.

SOURCE_TYPE

The type of the changing object. Click a cell in this column to display the change history for the selected object.

SOURCE_NAME

The name of the changing object. Click a link in this column to display comparison details for the selected object on the source and target systems. Click the cell’s background to display the change history for the selected object.

SOURCE_OWNER

The owner of the source task.

SOURCE_DATETIME

The date and time when the source task was last modified on the source system.

STATUS

The comparison status for the object on the source and target systems, either Same, Different or In1. In1 means that the object exists in the source system only.

TARGET_TASK

The most recent task that references a changing object on the source system.

TARGET_TYPE

The type of the changing object. Click a cell in this column to display the change history for the selected object.

TARGET_NAME

The name of the changing object. Click a cell in this column to display the change history for the selected object.

TARGET_OWNER

The owner of the target task.

TARGET_DATETIME

The date and time when the target task was last modified on the target system.

Change History

This spreadsheet includes each changing object’s change history on the source and target systems. It is grouped by object name, and then by each object’s modification date and time in descending order. The spreadsheet has the following columns:

SYSTEM

The name of the RFC Destination in which an object was modified.

DATETIME

The date and time when the object was modified.

REQUEST

The request associated with the change.

TASK

The task associated with the change.

TYPE

The type of the changed object.

TRANSPORT_TYPE

The type of the changed object stored in a transported task.

NAME

The name of the changed object.

OWNER

The owner of the task associated with the changed object.

RorI

This column is set to R if the task was released from the specified system; in this case, the first three letters of the task name match the system ID. It is set to I if the transport was imported into the specified system; in this case the first three letters of the task name don't match the system ID.

DESCRIPTION

The description for the task.