Reverse-engineer the Entities The Data Quality Process

17 Organizing and Documenting your Work 17-1 17 Organizing and Documenting your Work This chapter describes how to organize and document your work in Oracle Data Integrator. This chapter includes the following sections: ■ Section 17.1, Organizing Projects with Folders ■ Section 17.2, Organizing Models with Folders ■ Section 17.3, Using Cross-References ■ Section 17.4, Using Markers and Memos ■ Section 17.5, Handling Concurrent Changes ■ Section 17.6, Creating PDF Reports

17.1 Organizing Projects with Folders

Before you begin creating an integration project with Oracle Data Integrator, it is recommended to think about how the project will be organized. Rearranging your project afterwards may be dangerous. You might have to redo all the links and cross-references manually to reflect new locations. Within a project, interfaces, procedures and packages are organized into folders and sub-folders. It is recommended to maintain your project well organized by grouping related project components into folders and sub-folders according to criteria specific to the project. Folders simplify finding objects developed in the project and facilitate the maintenance tasks. Sub-folders can be created to an unlimited number of levels. Note that you can also use markers to organize your projects. Refer to Section 17.4, Using Markers and Memos for more information.

17.1.1 Creating a New Folder

To create a new folder:

1. In Designer Navigator expand the Projects accordion.

2. Select the project into which you want to add a folder.

3. Right-click and select New Folder.

4. In the Name field, enter a name for your folder.

5. Select Save from the File main menu.

The empty folder appears. 17-2 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator To create a sub-folder: 1. Create a new folder as described in Section 17.1.1, Creating a New Folder . 2. Drag and drop the new folder into the parent folder.

17.1.2 Arranging Project Folders

To arrange your project folders in the project hierarchy, drag and drop a folder into other folders or on the Project. Note that it is not possible to move a folder from one Project to another Project.

17.2 Organizing Models with Folders

A model folder groups related models according to criteria specific to the project. A model folder may also contain other model folders. Sub-folders can be created to an unlimited number of levels. Note that you can also use markers to organize your models. Refer to Section 17.4, Using Markers and Memos for more information.

17.2.1 Creating a New Model Folder

To create a model folder:

1. In Designer Navigator expand the Models accordion.

2. Click New Model Folder in the toolbar of the Models accordion.

3. In the Name field, enter a name for your folder.

4. Select Save from the File main menu.

The empty model folder appears.

17.2.2 Arranging Model Folders

To move a model into a folder:

1. In Designer Navigator expand the Models accordion.

2. Select the model, then drag and drop it on the icon of the destination model folder. The model moves from its current location to the selected model folder. Note the following when arranging model folders: ■ A model can only be in one folder at a time. ■ Model folders can be also moved into other model folders.

17.2.3 Creating and Organizing Sub-Models

A sub-model is an object that allows you to organize and classify the datastores of a model in a hierarchical structure. The root of the structure is the model. A sub-model groups functionally homogeneous datastores within a model. The datastores of a model can be inserted into a sub-model using drag and drop, or by automatic distribution. The classification is performed: