Merging catalogs

Two catalogs can be merged. The merge operation occurs when you save a report to another directory in which a catalog of the same name already exists.

Specifying the checking level

When merging catalogs, JReport Designer will check for differences between the two catalogs. You can specify the checking level to suit your requirements.

To specify the checking level:

  1. Click File > Options. The Options dialog displays.
  2. In the Catalog category, select the required level in the Merge Catalog box. Options are:
  3. Click OK in the Options dialog to accept the settings.

When you merge the two catalogs, resources that have the same mapping names in the two catalogs may conflict with each other (have different property values). JReport Designer will check the differences for you according to the level specified.

Merging catalogs

With the checking level specified, you can then start to merge catalogs.

  1. Open a report in the catalog that you want to merge with another catalog.
  2. Click File > Save To on the menu bar. The Save To dialog appears.
  3. Choose a directory where a catalog of the same name exists, and then save the report. If you specified the checking level as Identify All Differences or Identify Critical Differences, the Merge dialog will be displayed for dealing with conflicting resources. See the dialog.
  4. Highlight one conflicting resource in the resources to be merged box, and then select the operations:
  5. Click the Differences button and the Properties Differences dialog appears. See the dialog.

    The properties values of the conflicting resource from the two catalogs will be displayed in this dialog with any differences highlighted. Click the Previous / Next button in the dialog, and it will go to the previous/next conflicting resource. Click Close to close the dialog.

  6. Click the Target Relation button in the Merge dialog.

    The name of the resource and its parent node in the target catalog will then be displayed in the Target Relation dialog.

    For example, sometimes a resource is marked in the Merge dialog, but in the Properties Differences dialog, no difference is shown between the two resources. In this case you can use this button to check whether the parent nodes of the two resources are different.

  7. Click Close to close the Target Relation dialog box and return to the Merge dialog.
  8. Click the Merge button when you finish. JReport Designer will save the report according to the changes that you have made.
  9. Publish the catalog and the reports and test to ensure all the reports are working properly.

Notes: