RPD Merge

11/26/13
Merging and Importing Objects from Different Repositories by Using the Oracle BI 11g Administration Tool
Merging and Importing Objects from Different Repositories by Using the Oracle
BI 11g Administration Tool
This tutorial contains the following sections:
Purpose
Time to Complete
Overview
Scenario
Software Requirements
Prerequisites
Examining Merge Scenarios
Merging Objects from Different Repositories with a Common
Parent (Standard Three-Way Merge)
Merging Objects from Different Repositories Without a
Common Parent (Two-Way Merge)
Summary
Resources
Credits
Purpose
This tutorial illustrates how to merge and import objects from different repositories by using the Oracle Business Intelligence (BI)
11g Administration Tool (Administration Tool). The three-way merge technique is examined by using two scenarios: three-way
merge with a common parent (also called the standard three-way merge) and three-way merge with no common parent
(sometimes called the two-way merge).
Note: This tutorial is intended for learners who are familiar with the Administration Tool and have completed the Oracle by
Example (OBE) tutorial, "Creating a Repository Using Oracle Business Intelligence Administration Tool 11g." It is also
recommended that you complete the OBE, "Setting Up a Multiuser Development Environment by Using the Oracle BI 11g
Administration Tool" (located in the Business Intelligence section of the Oracle Learning Library) to understand how the merge
process occurs in a multiuser environment.
Time to Complete
Approximately 45 minutes
Overview
This tutorial provides step-by-step procedures for merging objects from different repositories by using the Administration Tool.
Scenario
In this tutorial, you initially review two different concepts for merging. You then practice these two concepts by performing a
standard three-way merge and a three-way merge with no common parent.
Software Requirements
Following is a list of software requirements:
Oracle BI EE 11.1.1.5 or later must be installed along with the Sample Application schema (BISAMPLE) that is available for use
with Oracle Business Intelligence 11g. If you haven't installed the Sample Applications (825), you can install both the Sample
Application schema and repository from here.
SampleAppLite.rpdmust be available on an accessible drive (local or network) as an alternate repository for merging. If
SampleAppLite.rpdis not available, you can unzip it from here and save it to
<ORACLE_INSTANCE>\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository(for
example,
c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository).
www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/bi/bi11115/import_merge/merging_importing_11g.htm?print=preview
1/47
11/26/13
SampleAppLiteis a lightweight version that ships with the Oracle BI EE Simple Install, while SampleAppis the full version
with many more examples and features.
A text editor, such as MS Notepad or MS WordPad must be installed.
Note: Oracle BI Release 11g (11.1.1.5) automatically appends a numeric suffix to each version of the .rpdfile. In this tutorial, the
repository is SampleApp_BI0009.rpd. Additionally, the SampleAppLiterepository file also follows this version naming
convention (for example, SampleAppLite_BI0001.rpd).
Prerequisites
Before starting this tutorial, you should:
Have some familiarity with the Oracle BI 11g Administration Tool
Have proper permissions for installing and configuring Oracle BI EE on your company's system
Note: Screen captures for this tutorial were taken in a Windows XP Professional environment; therefore, Start menu options and
colors may vary.
Examining Merge Scenarios

The Oracle BI Repository development process is conceptually identical to the classic Software Configuration Management (SCM)
three-way merge, in that changes are managed by merge and reconciliation in a multiuser development environment (MUDE). The
Oracle BI Repository is stored as an .rpdfile. Changes are managed by using the Administration Tool. Developers check out the
file and make changes locally. Then, these changes are reconciled and merged into the master repository. To read a more
detailed description and view an image of the merge process, click this link. Please note that this process is covered in detail in
the OBE,"Setting Up a Multiuser Development Environment by Using the Oracle BI 11g Administration Tool" (located in the
Business Intelligence section of the Oracle Learning Library).
However, as an administrator, you may want to manually merge the changes from multiple repositories or import objects from
different repositories outside of the MUDE. Oracle BI EE offers inherent support for the classic three-way merge inside and outside
the MUDE. The two main scenarios (outside of the MUDE) are discussed in this tutorial.
Describing Merge Types
Describing Merge Types

The two merge types discussed in this tutorial are presented below:
1 . Standard three-way merge (three-way merge with a common parent): This merge is useful when you have a
common parent repository and two derived repositories.
For example, you may have development and production repositories, both derived from a common parent
repository. You may want to import or merge the changes from the development repository into the production
repository. The three-way merge process, as indicated in the diagram to the right, depicts the Parent RPD, and
two derived RPDsRPD Aand RPD B. After the merge, a fourth merged repository file, Merged RPD, is created.
Note that modified or new objects are listed with an asterisk (*).
In RPD A, the object, Ob j1, is modified, and a new object, NewOb jX, is created. Similarly, a new object, NewOb jB,
is created in RPD B. When these two repositories are merged, the merged repository contains ob j1 (inherited
from the parent and modified in RPD A), and also the new objects (NewOb jX and NewOb jB ) from both
repositories.
2/47
11/26/13
2 . Three-way merge with no common parent: This is a special case for

merging, where you are merging objects from two different
repositories with no common parent.
For example, as an administrator, you may want to import objects,
such as subject areas or folders, from a different repository into your
current or working repository. In this particular case, the repositories
to be merged do not have a common parentthis scenario is
depicted in the diagram to the right.
Both repositories are treated differently. Conflicting object names are
duplicated while merging or importing. A suffix #nis appended
(where #nis a variable number). RPD Aand RPD Bare treated as
separate repositories and are compared to a blank repository
(representing no common parent). The merging process will not
overwrite Ob j1; instead, both copies of Ob j1 (Ob j1 and, Ob j1#1*)
from RPD Aand RPD Bare retained in the merged repository. Also
note that new objects from both repositories (NewOb jB* and
NewOb jX*) are created in the merged repository.
Merging Objects from Different Repositories with a Common Parent (Standard Three-Way
Merge)
In the scenario within this topic, you have a development (or current) repository in which you are working. A modified repository in
which the changes are made is also present. Both these repositories are derived from the same parent.
To compare these two repositories against the original repository and merge your changes to create a fourth merged repository
file, perform the following steps:
1 . Create copies with which to work. Navigate to
<ORACLE_INSTANCE>\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository(for example,
c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1\repository)
and select the SampleApp repository (for example, SampleApp_BI0009.rpd).
3/47
11/26/13
2 . Right-click and from the shortcut menu, select Copy.
3 . Click Edit > Paste three times, and then rename the three copied repositories as follows: original_SampleApp_BI0009.rpd,
modified_SampleApp_BI0009.rpd, and current_SampleApp_BI0009.rpd. Your repositoryfolder should look similar to
this:
4/47
11/26/13
4 . Open modified_SampleApp_BI0009.rpdin offline mode by using the Administration Tool. Click Start > All Programs > Oracle
Business Intelligence > BI Administration. The Administration Tool appears.
Note: When you first start the Administration Tool, a DOS window appears. Keep this window open while you work. You can
minimize the window to avoid accidentally closing it.
5/47
11/26/13
5 . Click File > Open > Offline.
6 . In the Open dialog box, select modified_SampleApp_BI0009.rpdand click Open.
6/47
11/26/13
7 . In the Open Offline dialog box, enter the administrator's Repository Password (this password should be Admin123) and click OK.
If you are unsure of this password, you can verify it with your local administrator.
The repository opens in offline mode.
8 . Change the view within the Administration Tool to gain more space. Click View, and then deselect Business Model and Mapping
Layer. Similarly deselect the Physical layer. Only the Presentation layer should be visible.
Your repository should look like this:
7/47
11/26/13
9 . Make your changes to the modified repository. Expand A- Sample Sales and Time, select T05 Per Name Year (to change the
display name), and then right-click and select Properties from the shortcut menu.
8/47
11/26/13
The Presentation Column - T05 Per Name Year Properties dialog box appears.
9/47
11/26/13
10 Deselect the Use Logical Column Name check box to enable the Name text box, and delete T05 Per Name. The Properties dialog
. box should look like this:
10/47
11/26/13
11 Click OK.
.
12 Similarly change T01 Per Name Week and T02 Per Name Month. The Presentation layer should look like this:
.
11/47
11/26/13
13 Save the repository. Click File > Save and when prompted to check for consistency, click No.
.
12/47
11/26/13
Note that in this tutorial, you are simulating a modified repository scenario. You should check global consistency in your real-time
production environment because it validates the consistency of the metadata repository. For example, if you click Yes in the above
case, the following warnings may appear in the Consistency Check Manager.
13/47
11/26/13
14 Click File > Close to close modified_SampleApp_BI0009.rpd.

.
15
. Open current_SampleApp_BI0009.rpdin offline mode. Click the Open Offline icon (
).
16 In the Open dialog box, select current_SampleApp_BI0009.rpdand click Open.

.
17 In the Open Offline dialog box, enter the administrator's Repository Password (Admin123) and click OK.
.
14/47
11/26/13
Review the A - Sample Sales node, specifically Time. Note that your changes are not reflected in this version of the repository.
18 Delete the following nodes:

.
B - Sample Quotas
C - Sample Headcount
E - Sample Essbase
F - Sample Essb Federated
15/47
11/26/13
H - Sample Olap
M - Datamining
O - Fusion Order Demo
U - Usage Tracking
Ctrl-click to select multiple nodes, and then right-click and select Delete from the shortcut menu. When prompted to confirm the
deletion, click Yes.
The repository should look like this:
Note that you can still expand the node, A - Sample Sales, to view the Presentation layer tables.
19 Now you have a current, working repository (current_SampleApp_BI0009.rpd) and a modified repository
. (modified_SampleApp_BI0009.rpd) that is derived from the same parent repository (original_SampleApp_BI0009.rpd).
Save the repository and do not check for consistency.
20 The next step is to merge the changes. Select File > Merge.
.
16/47
11/26/13
21 The Merge Repository Wizard - Select Input Files page appears. Click Select for Original Master Repository.
.
17/47
11/26/13
22 Select original_SampleApp_BI0009.rpd.
.
23 Click Open. The original repository name appears in the Original Master Repository text box.
.
18/47
11/26/13
24 Enter the original repository password (Admin123) in the Repository Password text box.
.
19/47
11/26/13
25 Click Select for Modified Repository.

.
26 Select modified_SampleApp_BI0009.rpd and click Open.

.
20/47
11/26/13
27 Enter the modified repository password (Admin123) in the Repository Password text box.
.
28 Click Select for "Save Merged Repository as."

.
21/47
11/26/13
The "Select repository file to save the merged result" dialog box appears.
29 Change the default name of the merge repository. Enter merged_SampleApp_BI0009.rpd in the "File name" text box, and then
. click Save.
22/47
11/26/13
The wizard should look like this:
23/47
11/26/13
30 Click Next. The Merge Repository Wizard - Define Merge Strategy page appears. This page allows you to make informed
. decisions about changed objects. You decide whether to include or exclude objects by choosing Current or Modified from the
Decision drop-down list.
31 Select the first row (Subject Area, C - Sample Headcount). The Differences pane refreshes with conflict details. Also notice that
. the repository panes area displays the original (original_SampleApp_BI0009), modified (modified_SampleApp_BI0009),
and current (current_SampleApp_BI0009) repositories.
24/47
11/26/13
32
. Click the ellipsis button (
) to the right of the Differences table to review the details of the objects that were modified.
25/47
11/26/13
33 Click Cancel.
.
34 At this point, you need to make a decision about how to proceed with the merge. In the Conflicts table at the top of the wizard, from
. the Decision drop-down list for each Subject Area object, select Current for each subject area node except U - Usage Tracking.
For this node, select Modified (A), indicating that you do not accept deletion of the Usage Tracking subject area.
26/47
11/26/13
Object relationships can be interconnected through their properties. If this is the case, By Property appears in the Decision dropdown list. The wizard page in the image below is such an example:
To learn more about Merge Strategy, refer to Oracle Fusion Middleware Metadata Repository Builders Guide for Oracle Business
Intelligence Enterprise Edition 11g Release 1.
35 Click Finish. The merged_SampleApp_BI0009.rpdrepository appears with your changes. Expand the A - Sample Sales subject
. area and the Time node. Review the changes to the Time node columns. The Usage Tracking subject area is still available,
27/47
11/26/13
because Modified (A)was chosen versus Current(where the subject area was deleted).
28/47
11/26/13
Merging Objects from Different Repositories Without a Common Parent (Two-Way Merge)
Although there are numerous scenarios for this technique, a simple scenario of importing new objects from two different
repositories is employed in this topic. Initially, you create a blank repository (this simulates that there isn't a parent), and then you
merge the objects from two different repositoriesSampleApp_BI0009.rpd and SampleApp Lite.rpd.
To merge these two repositories and to create a new merged repository file, perform the following steps:
1 . Create a blank repository in offline mode by using the Administration Tool. This is a one-time process.
Click Start > All Programs > Oracle Business Intelligence > BI Administration. The Administration Tool appears.
29/47
11/26/13
2 . Click File > New Repository.
The Create New Repository - Repository Information page appears.

30/47
11/26/13
31/47
11/26/13
3 . Enter Blank in the Name text box.
4 . Select No for the Import Metadata radio button.
32/47
11/26/13
5 . Enter Admin123 in the Repository Password and Retype Password text boxes, and then click Finish.
33/47
11/26/13
6 . The Blank.rpdrepository appears.
34/47
11/26/13
7 . Review SampleAppLite_BI0001.rpdin offline mode. Click File > Open > Offline.
8 . In the Open dialog box, select SampleAppLite_BI0001.rpd and click Open.
35/47
11/26/13
9 . In the Open Offline dialog box, enter the administrator's Repository Password (Admin123) and click OK.
10 Expand the Sample Sales Lite subject area and review the available objects.
.
Your repository should look like this:
36/47
11/26/13
11 Click File > Merge. The Merge Repository Wizard - Select Input Files page appears. Click Select for Original Master
. Repository.
37/47
11/26/13
12 Select Blank.rpd as the original repository.

.
13 Click Open.
.
38/47
11/26/13
14 Enter the Original Master Repository password (Admin123) in the Repository Password text box.
.
39/47
11/26/13
15 Click Select for Modified Repository.

.
40/47
11/26/13
16 Select SampleApp_BI0009.rpd and click Open.

.
41/47
11/26/13
17 Enter the Modified Repository password (Admin123) in the Repository Password text box.
.
18 Click Select for "Save Merged Repository as."

.
The "Select repository file to save the merged result" dialog box appears.
42/47
11/26/13
19 Change the default name of the merge repository. Enter SampleApp_BI0009_no_CP.rpd (where no_CPindicates
. that no common parent exists) in the File Name text box, and then click Save.
20 Click Next. The Merge Repository Wizard - Define Merge Strategy page appears. It should be intuitively obvious that
43/47
11/26/13
. you want to include the new subject areas because you are merging two totally different repositories. However, note
that there is an additional conflict for a variable, BI_EE_HOME. This variable must point to the correct "Oracle BI
Home" directory. For the example in this tutorial, the correct path is
<ORACLE_INSTANCE>\bifoundation\OracleBIServerComponent\coreappplication_obips1(for example,
c:\bi11g\instances\instance3\bifoundation\OracleBIServerComponent\coreappplication_obips1).
21 Select the first row (Subject Area, Sample Targets Lite), and then select Current from the Decision drop-down list.
.
44/47
11/26/13
22 Select the second row (Subject Area, Sample Sales Lite), and then select Current from the Decision drop-down
. list. The wizard page should look like this:
45/47
11/26/13
23 Select the third row (Variable, BI_EE_HOME), and then click the plus sign to expand the detail. The wizard page
. should look like this:
Before you make a decision about this conflict, you should investigate further.
24 Double-click BI_EE_HOME in the "Modified repository" pane. The "Static Repository Variable - BI_EE_HOME" dialog
. box appears. Notice that the Default Initializer location does not comply with the suggested path that is offered as an
example in the Description box. Make a note of the Description box path, so that you can compare it to the value in
the current repository.
Click Cancel.
25 Double-click BI_EE_HOME in the "Current repository" pane. The "Static Repository Variable - BI_EE_HOME" dialog
. box appears. Notice that the Default Initializer location complies with the suggested path in the previous step.
Click Cancel.
26 Select the Current radio button for the BI_EE_HOMEvariable. The wizard page should look like this:
.
27 Click Finish. The new SampleApp_BI0009_no_CP.rpdappears with all merged nodes.

.
28 Verify that the BI_EE_HOMEvariable was set properly. Click Manage > Variables.
.
29 In the Variable Manager dialog box, expand Repository > Variables, select Static, and then select BI_EE_HOME in
. the pane at the right.
46/47
11/26/13
30 Right-click and select Properties to display the "Static Repository Variable - BI_EE_HOME" properties dialog box.
. The Default Initializer value points to the current Oracle BI Home.
31 Click Cancel to close the "Static Repository Variable - BI_EE_HOME" properties dialog box, and then click Action >
. Close to close the Variable Manager dialog box.
Summary
This tutorial illustrated how to merge and import repositories by using the Oracle BI 11g Administration Tool.
In this tutorial, you should have learned how to:
Merge objects from different repositories into a common parent repository
Merge objects from different repositories and create a new repository
Resources
Oracle Business Intelligence Enterprise Edition Documentation
Oracle Business Intelligence Enterprise Edition Online Tutorials
Oracle University
Oracle Technology Network
Oracle Business Intelligence Discussion Forums
Credits
Lead Curriculum Developer: Lea Shaw
Copyright 2011, Oracle and/or its affiliates. All rights reserved
47/47

RPD Merge

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

RPD Merge

Încărcat de

Drepturi de autor:

Formate disponibile

11/26/13

Examining Merge Scenarios

Describing Merge Types

2 . Three-way merge with no common parent: This is a special case for

2 . Right-click and from the shortcut menu, select Copy.

5 . Click File > Open > Offline.

6 . In the Open dialog box, select modified_SampleApp_BI0009.rpdand click Open.

14 Click File > Close to close modified_SampleApp_BI0009.rpd.

16 In the Open dialog box, select current_SampleApp_BI0009.rpdand click Open.

18 Delete the following nodes:

25 Click Select for Modified Repository.

26 Select modified_SampleApp_BI0009.rpd and click Open.

28 Click Select for "Save Merged Repository as."

The wizard should look like this:

2 . Click File > New Repository.

The Create New Repository - Repository Information page appears.

3 . Enter Blank in the Name text box.

4 . Select No for the Import Metadata radio button.

6 . The Blank.rpdrepository appears.

8 . In the Open dialog box, select SampleAppLite_BI0001.rpd and click Open.

12 Select Blank.rpd as the original repository.

15 Click Select for Modified Repository.

16 Select SampleApp_BI0009.rpd and click Open.

18 Click Select for "Save Merged Repository as."

27 Click Finish. The new SampleApp_BI0009_no_CP.rpdappears with all merged nodes.

Copyright 2011, Oracle and/or its affiliates. All rights reserved

S-ar putea să vă placă și