In the General tab, fill in the Step Name field. Select Declare Variable in the Step From the File menu, click Save.

Working with Packages 10-9

10.3.2 Deleting a Step

To delete a step:

1. In the Package toolbar tab, select the Free Choice tool.

2. Select the step to delete in the diagram.

3. Right-click and then select Delete Step.

4. Click OK.

The step disappears from the diagram.

10.3.3 Duplicating a Step

To duplicate a step:

1. In the Package toolbar tab, select the Free Choice tool.

2. Select the step to duplicate in the diagram.

3. Right-click and then select Duplicate Step.

A copy of the step appears in the diagram.

10.3.4 Running a Step

To run a step:

1. In the Package toolbar tab, select the Free Choice tool.

2. Select the step to run in the diagram.

3. Right-click and then select Execute Step.

4. In the Execution window, select the execution parameters:

■ Select the Context into which the step must be executed. ■ Select the Logical Agent that will run the step. 5. Click OK. 6. The Session Started Window appears. 7. Click OK. You can review the step execution in the Operator Navigator.

10.3.5 Editing a Step’s Linked Object

The steps linked object is the interface, procedure, variable, and so forth from which the step is created. You can edit this object from the Package diagram. To edit a steps linked object:

1. In the Package toolbar tab, select the Free Choice tool.

2. Select the step to edit in the diagram.

3. Right-click and then select Edit Linked Object.

The Editor for the linked object opens. Note: It is not possible to undo a delete operation in the Package diagram. 10-10 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator

10.3.6 Arranging the Steps Layout

The steps can be rearranged in the diagram in order to make it more readable. To arrange the steps in the diagram:

1. From the Package toolbar menu, select the Free Choice tool.

2. Select the more steps you wish to arrange:

■ Keep the CTRL key pressed and select each step ■ Drag the cursor on the diagram with the left mouse button pressed.

3. To arrange the selected steps, you may either:

■ Drag them to arrange their position into the diagram ■ Right-click, then select a Vertical Alignment or Horizontal Alignment option from the context menu. It is also possible to use the Reorganize button from the toolbar to automatically reorganize the steps.

10.4 Defining the Sequence of Steps

Once the steps are created, you must reorder them into a data processing chain. This chain has the following rules: ■ It starts with a unique step defined as the First Step. ■ Each step has two termination states: Success or Failure. ■ A step in failure or success can be followed by another step, or by the end of the Package. ■ In case of failure, it is possible to define a number of retries. A Package has one entry point, the First Step, but several possible termination steps. Failure Conditions The table below details the conditions that lead a step to a Failure state. In other situations, the steps ends in a Success state. Step Type Failure conditions Flow ■ Error in an interface command. ■ Maximum number or percentage of errors allowed reached. Procedure Error in a procedure command. Refresh Variable Error while running the refresh query. Set Variable Error when setting the variable invalid value. Evaluate Variable The condition defined in the step is not matched. Declare Variable This step has no failure condition and always succeeds. Oracle Data Integrator Tool Oracle Data Integrator Tool return code is different from zero. If this tool is an OS Command, a failure case is a command return code different from zero. Journalize Datastore, Model or Sub-Model Error in a journalizing command. Check Datastore, Model or Sub-Model Error in the check process.