Siebel Analytics Server Administration Guide > Setting Up and Working with a Repository >

Merging Repositories

This section is for organizations that are using the Siebel Analytics applications repository (SiebelAnalytics.rpd). It explains how to use the Merge Repository feature of the Administration Tool to merge your customizations of prior releases of the repository with a new version received from Siebel Systems. The Merge Repository feature can also be used by customers to upgrade their custom repositories.

The merge process involves three versions of Siebel Analytics Repository. The terms used in the following descriptions are the terms used in the Administration Tool user interface.

During the merge process, you can compare the original repository with the modified repository, and the original repository with the current repository. The Merge Repository feature allows you to decide on an object-by-object basis whether you want to merge your customizations with the current repository.

To merge versions of Siebel Analytics Repository

  1. Rename the original repository (the repository you received with the previous version of Siebel Analytics) SiebelAnalytics.Prev.rpd.
  2. Rename the modified repository SiebelAnalyticsCustom.rpd.
  3. Rename the current repository SiebelAnalytics.Current.rpd.
  4. In the Administration Tool, open SiebelAnalytics.Current.rpd in offline mode.
  5. Select File > Merge from the toolbar.

    6. The Select Original Repository dialog box appears.

  6. Select SiebelAnalytics.Prev.rpd.
  7. Enter the password and click OK.

    8. The Merge Repositories dialog box displays the changes between SiebelAnalytics.Prev.rpd and SiebelAnalytics.Current.rpd.

    Values in the Change column indicate the following:

    Value
    Description
    Created
    Object was created in the current repository and does not exist in the original repository.
    Modified
    Object exists in the original repository but has been modified in the current repository.
    Deleted
    Object exists in the original repository but has been deleted from the current repository.

    The buttons on the right side of the Merge Repositories dialog box provide the following functionality:

    Button
    Functionality
    Select
    Allows you to select a repository to compare with the current repository.
    View 1
    Opens deleted objects in read-only mode.
    Edit 2
    Opens created objects for editing.
    UDML 1
    Displays the Universal Data Modeling Language (UDML) information for objects in the original repository.
    UDML 2
    Displays the UDML information for objects in the current repository.
    Diff
    Displays the differences between the current repository and the original repository.
    Save
    Saves a list of the differences between the current repository and the original repository.
    Mark
    Marks the object you select. Boxes appear around created and modified objects. To remove marks, enable the Turn Off Compare Mode.

  8. In the Modified Repository field, select SiebelAnalyticsCustom.rpd.

    9. The Merge Repositories dialog box appears.

    Click for full size image

    The names of the original and modified repositories appear at the top. The Select buttons to the right of the names allow you to select another repository.

    The text box below the repository names allows you to select one of the following options:

  9. Select the option How to merge SiebelAnalyticsCustom.rpd into SiebelAnalytics.Current.rpd from the drop-down list.

    10. The grid displays the repository changes. The Description column states the change between the original repository and the current repository, and between the original repository and the modified repository. The Decision column provides options for the action you can take regarding the change. The following table shows the possible repository changes and the corresponding decision options.

    Description
    Decision Options
    Object(s) added to <current>
    • Keep changes made in <current> (default)
    • Remove objects created in <current>
    Object(s) added to <modified>
    • Add these objects (default)
    • Don't add these objects
    Object(s) deleted from <current>
    • Keep changes made in <current> (default)
    • Add back objects not deleted in <modified>
    Object(s) deleted from <modified>
    • Add these objects (default)
    • Don't add these objects
    Object(s) modified in <modified>
    • Make changes modified in <modified> (default)
    • Don't modify this object
    Object(s) modified in <current>
    • Keep changes made in <current> (default)
    Object(s) deleted from both <current> and <modified>
    • Keep changes made in both repositories (default)
    Object(s) modified in both repositories; there are differences
    • Keep changes made in <current>
    • Make changes made in <modified>
    Object(s) modified in both repositories; there are no differences
    • Keep changes made in both repositories (default)
    Object(s) deleted from <current>; some also from <modified>
    • Keep changes made in <current>
    • Add back objects not deleted in <modified>
    Object(s) deleted from <modified>; some also from <current>
    • Keep changes made in <current>
    • Remove objects deleted in <modified>

    The read-only text box below the grid provides detailed information about the repository change for the object you select in the grid.

  10. In the Decision field, select the action you want to take regarding the repository change, or accept the default action.

    11. You can use the Find and Find Again buttons to locate specific objects by name.

  11. To locate subsequent rows with empty Decision fields, click the Decision header cell.

    12. When all rows have a value in the Decision field, the Merge button is enabled.

  12. Click Merge.

    13. A message will alert you when the merge is complete.

  13. Save the current repository.

 Siebel Analytics Server Administration Guide 
 Published: 23 June 2003