Oracle^® Business Intelligence Server Administration Guide > Oracle BI Administration Tool Utilities and Expression Builder > Utilities and Wizards >

Generating Documentation of Repository Mappings

The Repository Documentation utility documents the mapping from the presentation columns to the corresponding logical and physical columns. The documentation also includes conditional expressions associated with the columns. The documentation can be saved in comma separated (CSV) or tab delimited (TXT) format.

The Repository Documentation utility allows you to extract Oracle BI metadata to a flat file so that it can be loaded into Excel and RDBMS. You can query the resulting file to answer questions such as "If I delete physical column X, what logical columns will be affected?" or "How many places in the business model refer to the physical table W_SRVREQ_F". Then you can establish dependency relationships among elements in the repository.

Excel only allows data sets of 1,000,000 rows. You might exceed this in a large repository. Therefore, you may wish to run the Repository Documentation utility on a subset of the repository by extracting relevant business models into a new project. For more information, see Setting up and Using the Oracle BI Multiuser Development Environment.

The Repository Documentation utility creates a comma-separated values file or a tab-separated values file that shows the connections between the presentation and physical layers in the current repository. This file can be imported into a repository as a physical layer.

NOTE:  This file excludes any information about repository variables and marketing objects.

To run the Repository Documentation utility

1. From the Tools menu, choose Utilities.
2. In the Utilities dialog box, select Repository Documentation, and then click Execute.
3. In the Save As dialog box, choose the directory where you want to save the file.
4. Type a name for the file.
5. Choose a type of file and an Encoding value and click Save.

   Current encoding options are ANSI, Unicode, and UTF-8.