Merging Proposed Changes
Once the Reviewers are done with their process, as the Content Author, you will have access to a Get Changes link when hovering over the task in the Content Fusion Tasks Manager view. Clicking this link opens a built-in Get Changes merge tool that allows you to automatically merge all the proposed changes back into Oxygen XML Editor/Author.
In most instances, you will simply click the Apply button at the bottom of the merge tool to automatically integrate all the proposed changes and when the files are opened in Oxygen XML Editor/Author, you will see the changes. As long as you kept the Force Change Tracking On option selected in Oxygen Content Fusion, you will have the ability to accept or reject the changes. If you happen to encounter a conflict, you will need to select a Merge Action from the drop-down menu for that particular file.
If you need to resolve conflicts or make some manual changes to the merge process, refer to the next section for more in-depth information on using the built-in Get Changes merge tool.
Get Changes Merge Tool
When you click the Get Changes link on a task, a built-in merge tool is displayed that allows you to automatically integrate the changes and you also have access to numerous actions to manually adjust the merge.
The merge tool includes the following information, features, and actions:
- Number of Changes and Conflicts
- The first thing you see in top-left corner of the tool is the grand total of all the changes made by others, changes made by you, and the number of conflicts.
- Filter Buttons
-
In the top-right corner you can use the toggle buttons to filter the list of modifications:
- Show all files
- Use this button to show all modified and unmodified files, as well as conflicts.
- Show only files with incoming and local changes
- Filters the list to show all files that have been modified, including conflicts.
- Show only files with incoming changes
- Filters the list to only show the files that were modified by others.
- Show only files with local changes
- Filters the list to only show the files that were modified by you.
- Show only conflicting files
- Filters the list to only show files that contain conflicts.
- List of Files Panel
-
This panel shows the list of files in the compared file sets based upon the filter button that is selected. This panel includes the following sortable columns:
- Name - The file names.
- Status - An icon that represents the file status. Red icons indicate some sort of conflict. Gray icons indicate modifications made by you. Blue icons indicate modifications made by others.
- Description - A description of the file status.
- Merge Action - This column provides a drop-down menu for each file that allows you to choose some merge actions depending upon its status. A default action is always set to automatically merge the changes made by others with your changes. If there is a conflict, the default is <Select action> and you are required to make a selection. Click this column to access the drop-down menu where you can make a selection. The same actions are available in the contextual menu.
You can click a file to open it in the file comparison panel (the file from your file set is shown in the left panel while the file from the file set with changes made by others is shown in the right panel). For image files, the comparison panel shows a preview of the image. For other binary files, a preview is not available and you will just see its status.
- File Comparison Panels
-
If you click a file in the top panel, the file is opened in this file comparison section. The file from your file set is shown in the left panel and the file from the other file set is shown in the right panel. This panel includes a variety of toolbar actions, depending on whether the merge tool is in Text or Author mode. To determine whether the files are initially opened in the merge tool's Text or Author mode, it detects the Initial Edit Mode in the Document Type Association configuration and the mode the files were last opened in Oxygen XML Editor/Author.
- Displaying Differences in the File Comparison Panels
-
Colored marks on the right-side vertical stripe help you to quickly identify the locations of the differences. The differences are also highlighted in several colors in the comparison panes, depending on the type of change, and dynamic lines connect the compared fragments in the middle section between the two panes. The default colors and their shades mean the following:
- Pink - Identifies modifications on either side.
- Gray - Identifies an addition of a node in the left side (your outgoing changes).
- Blue - Identifies an addition of a node in the right side (incoming changes).
- Lighter Shade - Identifies blocks of changes that can be merged in their entirety.
- Darker Shade - Identifies specific changes within the blocks that can be merged more precisely.
- Direct Editing Actions in the File Comparison Panels
-
In addition to selecting merge actions from the drop-down menus in the Merge Action column in the top panel, you can also edit the files directly in the left pane (your local changes). The two editors are constantly synchronized and the differences are refreshed when you save the modified document (Save button or Ctrl+S) or when you click the Perform File Differencing button.
A variety of actions are available in the contextual menu in both editing panes. The tool also includes some inline actions to help you merge, copy, or remove changes. When you select a change, the following inline action widgets are available, depending on the type of change:- Append right change to left
- Copies the content of the selected change from the right side and appends it on the left side.
- Copy change from right to left
- Replaces the content of a change in the left side with the content of the change in the right side.
- Remove change
- Removes the change from the left side.
Any time you save manual changes (Save button or Ctrl+S), the selection in the Merge Action column in the top panel automatically changes to Use merged and a copy of the original file is kept so that you can revert to the original file if necessary. To discard your manual changes and revert to your original changes, select a different action in the Merge Action drop-down menu.
- Text Mode
- The Text button below the comparison panels allows you to switch to a Text mode that displays the files as source code.
- Author Mode
- The Author button below the comparison panels allows you to
switch to an Author mode that displays the files in a visual
mode similar to the Author editing mode in Oxygen XML
Editor/Author. This visual mode is available when the compared files are
detected as being XML and it includes unique features such as a Tags Display Mode drop-down
button on the toolbar that allows you to select the amount of tags to display
in this visual mode. This mode also presents differences that were made using the
Track Changes feature (although the Track
Changes feature is not available in the merge tool).Note: This mode is not available if the Enable file comparison in Author mode option is not selected in the preferences page.
- Open Merged Files
- If you select this option, all the files that will be modified by the merge operation will be opened in the editor after the operation is finished.
- Applying Changes
-
When you click the Apply button, all the merge actions you have selected and the changes you have made will be processed.
If there are unresolved conflicts (conflicts where no merge action is selected in the Merge Action drop-down menu), a dialog box will be displayed that allows you to choose how to solve the conflicts. You can choose between the following:- Keep your changes - If you select this option and then click Apply, your local changes will be preserved for the unresolved conflicts.
- Overwrite your changes - If you select this option and then click Apply, your local changes will be overwritten with the changes made by others, for the unresolved conflicts.
- Cancel - You can click the Cancel button to go back to the merge tool to resolve the conflicts individually.
- Canceling Changes
- If you click the Cancel button at the bottom of the merge tool, any manual changes you made in the merge tool will be lost.