Default language.

Reviewing the object definitions using the Difference Editor


When you double-click an object in the Differences List, the differences for the old base definition, the new base definition, and the overlay definition are displayed simultaneously. However, for each object, you have different options. You can use the Editor tab or the Properties tab for reconciling your customizations.

Understanding the filters

  • Manual reconciliations — By default, this filter is turned ON to display only the manual reconciliations list.
  • All Differences —  When you click the filter, it is turned OFF and displays all the changed objects including those objects that do not need to be reconciled.
  • No Differences for Manual Reconciliations — When the filter is turned ON and the list is still empty, it means that there are no differences to reconcile.

AR customization reconciliation actions

The following icons indicate the type of action that you can take to manage the reconciliation process.

Icon

Action

Description

filter.jpg

Only show changes to reconcile filter

View all the objects that are modified.

By default, this filter is turned on to display only the manual reconciliations list. When you click the filter, it toggles to display all the modified objects even those that do not need to be reconciled.

toggle.jpg

Swap Old Definition with New Definition

Exchange the old definition tab and the new definition tab to compare these with your Overlay definition.

first_diff.png

First Difference

Move and open the first difference in the Differences List.

Next diff.jpg

Next Difference

Open and compare the next difference in the Differences List.

Prev diff.jpg

Previous Difference

Open and compare the previous difference in the Differences List.

next field diff.jpg

Next Field Difference

Open and compare the next field difference in the Differences List .

prev field diff.jpg

Previous Field Difference

Open and compare the previous field difference in the Differences List .

move old.png

Move from Old

Move selected difference from the old definition to the overlay definition.

move new.png

Move from New

Move selected difference from the new definition to the overlay definition.

max-min.jpg

Maximize

Maximize to view only one definition at a time.

restore.jpg

Restore

View all three definitions again.

Delete_view_overlay.png

Delete view overlay

Delete the view overlay of the selected view.

Remove__from_view_overlay.png

Remove from view overlay

Remove a particular field from view overlay.

Remove_from_Granualr_overlay.png

Remove granular overlay

Click this button to switch the granular overlay to no overlay. This action removes the granularity and is available only for Fields.

Note: With Service pack 1 and later, Remove granular overlay option is available for all objects.

Highlighting objects to be reconciled

  • Highlighting Red — All objects are highlighted using this option. The highlighting indicates that the property is selected and you must reconcile it. When you double-click any property in the Differences List, the property in all three definitions are displayed as highlighted in red.  
  • Highlighting Blue — Forms, fields, table filed mapping, and view differences are highlighted using this option. All of these property changes are highlighted in blue to imply that they are changed but are not currently in focus.
  • Highlighting Yellow — Only workflow differences are highlighted using this option. All these property changes are highlighted in yellow to imply that these properties are changed but are not currently in focus.

Definitions reconciliation

When you double-click any object for reconciliation, this view is the default. For workflows, forms, menus, and application objects, you can reconcile your changes using this editor.

 Workflows execution options reconciliation

Workflows execution options reconciliation.png

Workflows execution options reconciliation (Service Pack 1 and later)

Workflows execution options reconciliation_sp1.png

Form permissions reconciliation

Form permissions reconciliation.png

Form permissions reconciliation (Service Pack 1 and later)

permission_sp1.png

Properties reconciliation

When you click the Properties tab, the property differences for all three definitions are displayed. For workflow, application, fields, and fields in view overlay, you can reconcile your properties using this editor.

You must right-click your property name to copy and paste your new or old definition to overlay definition. Alternatively, you can edit the value for the property inline.

copy property.jpg

Properties reconciliation editor

Properties reconciliation editor.png

Value reconciliation editor

If you want to modify the properties by comparing and adding the values manually, you can use the Value reconciliation editor. In this editor, you see all three versions of your property, and you can directly edit the value.

When you click Apply, your changes are applied to the object. To save changes for an entire object, you must save the object from the File menu.

Value reconciliation editor.png

View reconciliation

You can modify your view by comparing the old, new, and overlay reconciliation. Although, you cannot see all three views at one time, you can toggle between each view from the Reconciliation Editor tab.  

View reconciliation.png

 

Where to go from here

Next task

 

Up to process
 

When you have finished reconciling BMC Remedy AR customizations, return to the appropriate stage in the upgrade process:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*