Repository Documentation UtilityBalaraju Komuravalli

Sr. Quality Assurance Engineer

Andreas Stoeckicht

Intern

January 10, 2005

Utility Overview

The Repository Documentation Utility can be used to automatically capture information about the metadata in your repository into a Microsoft Excel spreadsheet. This utility makes use of the Informatica Metadata Exchange SDK interfaces to access the repository. It is available on the Microsoft Windows platform only.

Note: This utility is a free download available on the Informatica Developer Network. The download also comes with source code for the program. No technical support for this utility is provided by Informatica technical support.

The following features are available in Repository Documentation Utility:

Connection Usage Report

Repository Object Details Report

Connection Usage Report

This report provides a list of all connection objects in the repository with the following information:

Connection name

Connection type

Connection subtype

Connect string

User name

Code page name

Yes or No flag – To indicate if this connection is used as part of a source or target connection within a session

Repository Object Details Report

This report provides a list of all workflows in the repository along with their dependent object names including worklets, sessions, mappings, transformations, sources, and targets. The following information is written into the Excel spreadsheet for each workflow in the repository:

Folder name

Workflow name

Worklet name

Each session name in the workflow

Source and target connections used in a session

Mapping name associated with the session

Mapping comment

Sources used in the mapping along with source database type, source DBD name

Targets used in the mapping along with target database type

Transformations used in the mapping along with transformation type

Known Issues

If a source or target database type is overwritten at the session level to flat file, then they are not reflected in the report.

Source or Target associated connections are not displayed. Instead, the report displays all the source and target connections used in the session.

Installation and Configuration

Prerequisites

You need the following components installed before you can run the Repository Documentation Utility:

- Informatica Metadata Exchange SDK 7.x

- Informatica PowerCenter Repository Server 7.x

- Microsoft Excel

Installation

From the Repository Documentation Utility download package, run the setup program.

The Repository Documentation Utility runs on Windows 2000 with Service Pack 4 only.

Running the Repository Documentation Utility

1. From the Start>Programs menu select Repository Documentation Tool.

2. After you start the program, enter the connection information for the repository you want to browse.

3. Select the option to choose either the whole repository or a folder.

If you choose the whole repository, the Repository Documentation Utility will go through every folder of the selected repository and creates the documentation for the entire repository. If you choose the folder option, the utility displays a drop down box where you can choose a single folder.

4. Select continue and the utility creates the excel output in the utility installation directory.

If you choose the whole repository it takes longer for the Repository Documentation Utility to complete its task. View the progress bar at the bottom for progress.

Output/Documentation

When the utility completes running, you can find the output in the repositoryname.xls file in the RepositoryDoc Tool installation folder. This Excel file contains both connection usage report and repository object details report. If there are problems with some of the entries in the repository, the error messages will be written in the corresponding cell in the Excel sheet and it will be marked red.

Sample Output: