Reconciling overlaid objects by using the Recon application


Object reconciliation is necessary for maintaining consistency in objects and improving operational efficiency.

The Recon application provides an easy method to manually reconcile objects.


Before you begin

Make sure that you have the reconciliation report ready. For information about obtaining the reconciliation report, see Analyzing-the-manual-reconciliation-effort-by-using-the-reconciliation-report.


To reconcile the overlaid objects

Open Developer Studio and make sure to perform the following tasks in the Best Practice Customization Mode.

The following infographic shows a high-level overview of tasks that you need to perform:

22-01-04-Task-Overview.png

Task 1: Review the reconciliation report

22-01-04-Task-Overview1.png

  1. In AR System Navigator, expand Recon Application.
  2. Select Objects to Reconcile.
    The following report shows a list of forms that need reconciliation:
    22-01-04-Auto-Recon-Report.png

Task 2: Reconcile new fields

22-01-04-Task-Overview2.png

  1. (Optional) Right-click a form in the list and select Reconcile.
    A list of fields that need reconciliation is displayed. For newly added fields, only the list of new fields is displayed.
    The following screenshot shows newly added fields:
    22-01-04-New-Fields.png
  2. (Optional) Double-click a field to see the display properties.
    The following screenshot shows the display properties for a character field.
    22-01-04-Manual-Recon.png
    For a new field, the Old Definition and New Definition columns show no data.
  3. Open the form where new fields are added.
  4. From the Form menu, select Add/Remove Fields in View.
    The Add/Remove Fields in View dialog box as shown in the following screenshot is displayed:
    22-01-04-Add-Remove-Field.png
  5. From the Fields not in View list, select the new fields you want to add.
  6. Use the arrow keys to move the fields.
  7. Click OK.

Task 3: Reconcile customizations (Manual reconciliation)

22-01-04-Task-Overview3.png

  1. Right-click a form in the list and select Reconcile.
    A list of fields that need reconciliation is displayed. For conflicting changes, existing and modified display properties of a field are displayed.
    The following screenshot shows fields with conflicting changes:
    22-01-04-Custom-Fields-Recon.png
  2. Double-click a field to see the display properties.
    The following screenshot shows the display properties for a customized new field.
    22-01-04-customized-field-properties.png
  3. To obtain the new value in your environment, click Move from New.
  4. To move to the next change, click Next Diff.
  5. Click Save.

The overlaid objects are reconciled.


Reconciliation process logs

The reconciliation process logs are captured in the devstudio_workspace.log file, located in the <Dev_Studio_Workspace>/.metadata/ folder. Review the logs to troubleshoot any issues that might occur while reconciling the customized form views.

The following screenshot shows the Error Log tab:

22-01-04-Error-log.png



 

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