In the Steps toolbar, select Add Step and the Quick Step option corresponding to

14-14 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator The value of the variables are passed to the Load Plan on startup as startup parameters. At a step level, you can overwrite the variable value by setting it or forcing a refresh for this step and its child steps. You can use variables in Run Scenario steps - the value of the variable are passed as startup parameters to the scenario - or in CaseWhenElse steps for conditional branching. This section contains the following topics: ■ Declaring Load Plan Variables ■ Setting Variable Values in a Step

14.2.3.1 Declaring Load Plan Variables

To declare a Load Plan variable:

1. Open the Load Plan editor and go to the Variables tab.

2. From the Load Plan Editor toolbar, select Add Variable. The Lookup Variable

dialog is displayed.

3. In the Lookup Variable dialog, select the variable to add your Load Plan.

4. The variable appears in the Variables tab of the Load Plan Editor and in the

Property Inspector of each step.

14.2.3.2 Setting Variable Values in a Step

Variables in a step inherit their value from the value from the parent step and ultimately from the value specified for the variables when starting the Load Plan. For each step, except for Else and When steps, you can also overwrite the variable value, and change the value used for this step and its child steps. To override variable values at step level:

1. Open the Load Plan editor and go to the Steps tab.

2. In the Steps Hierarchy table, select the step for which you want to overwrite the variable value. 3. In the Property Inspector, go to the Variables section. The variables that are defined for this Load Plan are listed in this Variables table. You can modify the following variable parameters: Select Overwrite, if you want to specify a variable value for this step and all its children. Once you have chosen to overwrite the variable value, you can either: – Set a new variable value in the Value field. – Select Refresh to refresh this variable prior to executing the step. The Refresh option can be selected only for variables with a Select Query defined for refreshing the variable value. Note: At startup, Load Plans do not take into account the default value of a variable, or the historizedlatest value of a variable in the execution context. The value of the variable is either the one specified when starting the Load Plan, or the value setrefreshed within the Load Plan. Working with Load Plans 14-15

14.2.4 Handling Load Plan Exceptions and Restartability

Load Plans provide two features for handling error cases in the execution flows: Exceptions and Restartability. Exceptions An Exception Step contains a hierarchy of steps that is defined on the Exceptions tab of the Load Plan editor. You can associate a given exception step to one or more steps in the Load Plan. When a step in the Load Plan errors out, the associated exception step is executed automatically. Exceptions can be optionally raised to the parent step of the failing step. Raising an exception fails the parent step, which can consequently execute its exception step. Restartability When a Load Plan Run is restarted after a failure, the failed Load Plan steps are restarted depending on the Restart Type parameter. For example, you can define whether a parallel step should restart all its child steps or only those that have failed. This section contains the following topics: ■ Defining Exceptions Flows ■ Using Exception Handling ■ Defining the Restart Behavior

14.2.4.1 Defining Exceptions Flows

Exception steps are created and defined on the Exceptions tab of the Load Plan Editor. This tab contains a list of Exception Steps. Each Exception Step consists in a hierarchy of Load Plan steps. The Exceptions tab is similar to the Steps tab in the Load Plan editor. The main differences are: ■ There is no root step for the Exception Step hierarchy. Each exception step is a separate root step. ■ The Serial, Parallel, Run Scenario, and Case steps have the same properties as on the Steps tab but do not have an Exception Handling properties group. An exception step that errors out cannot raise another exception step. An Exception step can be created either by using the Add Step Wizard or with the Quick Step tool by selecting the Add Step Exception Step in the Load Plan Editor toolbar. By default, the Exception step is created with the Step name: Exception. You can modify this name in the Steps Hierarchy table or in the Property Inspector. To create an Exception step with the Add Step Wizard:

1. Open the Load Plan Editor and go to the Exceptions tab.

2. In the Load Plan Editor toolbar, select Add Step Add Step Wizard.

3. In the Add Step Wizard, select Exception from the Step Type list.

Note: Only values that are valid for the current selection are displayed for the Step Type.