Exposing Discoverer Worksheets in Applications

12-2 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition Most of the modeling relationships, including the hierarchical ones, are formed using name references between objects, not by the hierarchical structure of the XML. Note that the metadata objects in the XML file must appear in a particular order. You can view the set order in the XML schema document under the objectList_t element.

12.1.1 About Using the Oracle BI Server XML API to Merge and Append Objects

Do not use the Oracle BI Server XML API to attempt a full repository merge. The merge feature in the Administration Tool handles an extremely complex set of object comparisons and decisions, and it is not possible to account for and resolve these conflicts using the XML utilities. Because of this, using the XML API to perform a full merge is not supported. Attempting to do so might result in a corrupted repository. However, you can use the XML API to append objects from one repository to another repository, using the -B option with biserverxmlexec to specify a base repository path name. This approach works when you have two completely separate repositories with no shared objects between the two, including no shared variables or application roles. For example, if you have separate repositories for the Credit and Manufacturing departments, you can take objects from the Credit XML metadata and append them to the Manufacturing XML metadata, and then convert to a single RPD that contains both working models. Using this method, you are essentially adding one repository to another. Before attempting to perform an append operation, you should create a script to ensure that there are no common objects. Even when your repositories are separate, they might contain the same names for common objects, such as a current_date variable. It is also a good idea to equalize the upgrade IDs to ensure that there are no accidental clashes. Equalizing objects causes objects in two repositories that have the same name but different upgrade ids to be treated as the same object. See Equalizing Objects in Oracle Fusion Middleware Metadata Repository Builders Guide for Oracle Business Intelligence Enterprise Edition for more information.

12.2 Generating and Executing XML

Oracle Business Intelligence provides the following command-line tools to generate and execute XML: ■ biserverxmlgen generates XML from an existing RPD ■ biserverxmlexec lets you execute the XML in offline mode to create or modify a repository file ■ biserverxmlcli executes the XML against the Oracle BI Server Before running the XML utilities, you must first run bi-init.cmd or bi-init.sh on UNIX to launch a command prompt or shell window that is initialized to your Oracle instance. You can find this utility in: ORACLE_INSTANCEbifoundationOracleBIApplicationcoreapplicationsetup Then, run biserverxmlgen, biserverxmlexec, or biserverxmlcli from the resulting shell window with the desired options. Note that when you execute XML to update an existing repository with new content, objects are replaced in their entirety. For example, to change the name attribute of a