11-1

8Oracle Data IntegratorWorkflow Management: The Packages

11-2

Objectives

• Learn how ODI Packages are used to create a complete workflow.

• See how to create several different kinds of package steps.• Learn how to execute a package.

In this lesson, you will:

11-3

What Is a Package?

Package: An organized sequence of steps that makes up a workflow.

Each step performs a small task, and they are combined together to make the package.

11-4

How to Create a Package

1. Create and name a blank package

2. Create the steps that make up the package• Drag interfaces from the Projects view onto the Diagram tab

• Insert ODI tools from the toolbox

3. Arrange the steps in order• Define the first step

• Define the success path

• Set up error handling

11-5

The Package Diagram

Interface step (selected)

ODI tool step

Diagram

Toolbox for ODI tools

Toolbar

Properties of selected step

11-6

Package Diagram Toolbar

Hide/showfailure links

Next step on failure

Hide/show toolbox

Duplicate selection

Select

Edit selected step

Hide/show properties

Hide/showsuccess links

Next step onsuccess

Delete selection

Rearrange selection

Execute selected step

Execute package Print package

Page setup

Shows errors in the diagram

11-7

How to Create an Interface Step

1.Expand the project and folder containing the interface. Expand the Interfaces node.

2.Drag the interface to the package diagram. The new step appears.

3.Optionally, change the Step Name in the Properties panel.

11-8

Note – Interfaces Are Reusable

Interfaces can

be reused many

times in the

same package or

in different

packages.

11-9

Note – Interfaces Are Reusable

The interface is not

duplicated, but referenced

by the packages.

Changes made in the

interface will affect the

execution of all packages

using it.

Interfaces can be reused

many times in the same

package or in different

packages.

11-10

What Is an ODI Tool?

ODI tools – Macros that provide useful functions to handle files, send emails, use web services, etc.Tools can be used as steps in packages.

11-11

How to Create an ODI Tool Step

1. In the Toolbox, expand the group containing the tool you want to add.

2. Click the tool.

3. Click the diagram. A step named after

the tool appears.

4. Change the Step Name in the Properties panel.

5. Set the tool’s Properties.

6. Click Apply to save.

11-12

A Simple Package

Step on failure

Step on success

First step

• This package executes two interfaces then archives some files.

• If one of the three steps fails, an email is sent to the administrator.

• The first step must be defined• Right click > First Step

• After each step the flow splits in two directions:• Success: ok (return code

0)• Failure: ko (return code

not 0)

11-13

Note – Error Button

Packages that are

incorrectly

sequenced appear

with the Error

button highlighted

in the toolbar.

Click it to see the

details.

11-14

Executing a Package

1. Click the Execute button in the package window

2. Open Operator• The package is

executed as a session• Each package step is a step

• Tool steps appear with a single task

• Interface steps show each command as a separate task

11-15

Note – Atomic Testing

Test steps

individually first!

It is possible to

execute a single

step from the

diagram.