Comparing and Merging Process Apps

This topic describes how to use the compare and merge feature. For high-level information and use cases, see Compare and Merge.

To compare two process apps:

  1. Open one of the process apps. This needs to be the process app that you want to merge items into, and is referred to as the "open process app."
  2. Select Compare from the Composer menu, and then select the process app that you want to compare to the open process app. This is referred to as the "comparison process app" and will be displayed on the right, while the open process app will be displayed on the left. To open this process app, do one of the following:
    • Choose With Local File to compare with a blueprint file stored on your computer. In the standard Windows dialog box that opens, locate the file (typically with an .msd extension), and then click Open.
    • Choose With Published Process App to compare with a process app stored in the repository: In the Select Published Process App Dialog Box, select the version of the published process app, and then click Open.
    • Choose With recently compared Local File to compare with the last process app you compared that is stored on your computer.
  3. The Compare Process Apps Mode opens. The comparison process starts, and a progress bar is displayed at the bottom of the window.
  4. After the comparison process finishes, the differences are highlighted in the colors shown in the Legend. A Comparison Report at the top of the editor uses a callout to textually summarize each change in both process apps.
  5. If you click an item in App Explorer in either the Comparison Report, the open process app, or the comparison process app, the item opens in the other two areas as well. The views are synchronized, so you can see the item side-by-side for easy comparison. If an item only exists on one side, an explanatory message is displayed on the other side.

To copy items:

  1. In the comparison process app, right-click the item you want to copy.
  2. Select Copy to Open Process App. This command is only available for items that can be copied (that is, items that do not exist in the open process app).
    Note: For performance reasons, the comparison is not fully updated automatically. A "comparison is out-of-date link warns you about this. Click the link or the Refresh button at the top right corner to update the comparison.
Note: The following limitations currently apply:

To dismiss an item:

To restore a dismissed item:

  1. Make sure the Show dismissed items check box is selected.
  2. Click the callout.

To restore all dismissed items:

To hide translated strings:

To hide unchanged items:

To export the comparison report:

  1. Click Export at the top right corner.
  2. Browse to the folder where you want to store the report, and then click OK.

Three files are placed in the folder. Open the HTML file named "report" to view the report.

To close the comparison:

To change the comparison colors:

  1. Click Composer Options on the Composer menu.
  2. Click the Comparison tab.
  3. Change the colors as described in Comparison Options.

To store, restore, or reset the layout of the three windows in comparison mode:

  1. Click Layout at the top right corner.
  2. Do one of the following:
    • Click Store Layout to store the current layout as a custom layout.
    • Click Restore Layout to arrange the windows using the stored custom layout.
    • Click Reset Layout to arrange the windows using the default layout.
    • Click Auto Restore if you want the windows to be arranged using the stored custom layout every time you enter comparison mode.

For more information about these options, see Compare Process Apps Mode.