Logic block compare tool

Use the Logic Block Compare tool to view two logic blocks and see the differences between them. Access the Logic Block Compare tool from the Logic Builder.

You can compare different logic blocks, the same logic block in different lifecycles, or different versions of the same logic block.

The diagram below represents the layout of the compare tool:

Diagram of the Logic Block Compare tool, a dialog with two side-by-side panes: the compared logic block on the left and the active logic block on the right, with change indicators marked on the actions that differ between them.
1

Compare logic block—The logic block you select in the dialog window displays on the left. This logic block is always read-only. 


2

Active logic block—The logic block you opened in the Logic Builder displays on the right. You can modify this logic block in the Merge tool.

3
Description of change—Indicated on the actions, both with text and color. The types of differences identified include Added, Removed, Moved, Modified/Moved & Modified.

Differences between logic blocks

The compare tool shows the differences between logic block actions. Actions in logic blocks are uniquely identified in several ways, such as:

  • Logic action ID—The type of action. For example, Fetch Records, Add, or Call a Logic Block. 
  • Globally Unique Identifier (GUID)—Unique identifier which is automatically generated when a new action is created. If you copy a logic block the GUIDs remain the same. However, if you copy an action within a logic block, a new GUID is generated.
  • Action Number—Where the action is in the Logic Builder.

The table below describes the types of differences between logic blocks, and how the change is described in the compare tool: 

Difference between logic blocksDescription of Change
GUID exists in the Compare logic block but not in the Active logic blockAdded
GUID exists in the Active logic block but not in the Compare logic blockRemoved
GUID exists in both logic blocks and has a different action numberMoved
GUID exists in both logic blocks, has a different action number, and the action has been modifiedModified/Moved & Modified
GUID exists in both logic blocks, has the same action number, and the action has been modifiedModified

How to use the Compare tool

To use the compare tool, you must select the Compare button in the Logic Builder and then enter the logic block you want to compare to, the lifecycle it is in, and the version.

When you click on an action in either logic block, the corresponding action is highlighted and selected in the other logic block.

When an action is selected, view the Action Editor page for details of the action. For example, you can select a Set Values action, and then open the Action Editor page to see exactly what values are set by the action. 

If you want to merge actions between the logic blocks you're comparing, select the Merge button to open the Logic Block Merge Tool.

Learn more in the Branch and merge topic.

Branch and merge

Create logic block branches to enable concurrent development of the same logic block. Merge logic block branches to update the original logic block. 

Select the Branch row action in the Logic Block Builder application to create s a branch of the source logic block in your current lifecycle. You can have multiple branches of the same logic block in different lifecycles. Use the Merge row action in the Logic Block Builder application to merge your logic block branch with the source logic block. Each logic block branch has a ParentID, which connects it to the source logic block. This value is created automatically, and is used in the Merge row action.

To manually merge your branches, use the Logic Block Merge tool which is accessible in the compare tool of the Logic Builder.

Merge row action

Use the Merge row action to merge your changes with the original logic block. Changes are moved into the logic block automatically if there are no conflicts.

An example of a conflict is if you and someone else create branches of the same logic block, make different changes to the same action, and then the other person merges their branch in before you do. When you tried to merge your logic block would receive an error because the changes you made to the action are different than the changes already merged. 

If there are conflicts, you must use the Logic Block Merge tool which is accessed through the Logic Block Compare tool. When you open the Logic Block Merge tool, you can see the differences between the actions, and merge in the right change.

Logic Block Merge tool

Use the Logic Block Merge tool to manually merge actions from one logic block to another. You'll need to manually merge when there is a conflict between actions. 

Select the Merge button to access the Merge tool from the Logic Block Compare tool. You can learn more about the Compare tool in the Logic block compare tool topic.

While the Merge tool is open, you can edit details of the Active logic block, but the Compare logic block is read-only. Different options are available for different types of actions.Depending on the type of change made to an action between logic blocks, you have different options for each action. These options include:

  • Compare logic block
    • Add Action—Moves action from Compare logic block to Active logic block
    • Keep Change—Persists the change in the Compare logic block and does not apply it to the Active logic block
  • Active logic block
    • Keep change—Persists the change in the Active logic block
    • Merge changes—Opens the Actions Editor page for both logic actions
    • Move—Moves the action up or down in sequence to match the location in the Compare logic block
    • Remove action—Deletes the action from the Active logic block
    • Take modification—Persists change from Compare logic block to the Active logic block

After you merge changes, you must save your logic block to apply the changes.