This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Connecting transformation steps or job entries in Atrium Integrator Spoon

The following topics are available:

In Atrium Integrator Spoon, a hop connects one transformation step or job entry with another.

A transformation hop defines the direction of the data flow. 

Transformation hop


A job hop defines the job execution order and the condition on which the next job entry is to be executed. 

Job hop

To create a hop

You can create a hop between steps in a transformation or between jobs.

  1. In Atrium Integrator Spoon, open the job or transformation to which you want to add a hop.
  2. Select the first step.
  3. Perform one of the following actions:
    • Press the Shift key and draw a line to the second step.
    • Press the Ctrl key and select the second step, and then press the right mouse button and select New hop.

The steps are connected by a hop. The hop arrow indicates the direction of the data flow.

You can change the direction of the data flow by reversing the direction of the hop.

To flip a hop

Right-click a hop and select Flip direction.
The direction of the hop is reversed.

You can disable a hop for testing purposes.

To disable a hop

Right-click on a hop and select Disable hop.

Note

The Disable hop command appears only when you right-click on an active hop.

The hop is disabled and its color changes to gray.

To delete a hop

Right-click a hop and select Delete hop.

The hop is deleted.

Specifying the condition on which a job entry is executed

You can specify the condition on which the next job entry is to be executed by specifying an evaluation mode for the hop that goes to that job entry.

To specify the evaluation mode

  1. Right-click a job hop and select Evaluation.
  2. Select one of the following commands:
    • Unconditional specifies that the next job entry must be executed regardless of the result of the originating job entry. An unconditional job hop uses the
    • Follow when result is true specifies that the next job entry is to be executed when the result of the originating job entry is true. This job hop uses the
    • Follow when result is false specifies that the next job entry is to be executed when the result of the originating job entry is false. This job hop uses the
    • Transformation hops are displayed in a variety of colors based on the properties and state of the hop, as described in the following table.

Transformation hop colors

Transformation hops are displayed in a variety of colors based on the properties and state of the hop, as described in the following table.

Hop line colors

Hop color

Description

Black

The hop has a defined target step.

Gray

The hop is disabled.

Green

If multiple hops are leaving a step, rows of data are evenly distributed to all target steps.

Red

If multiple hops are leaving a step, all rows of data are copied to all target steps.

Yellow

Provides information about the step and distributes rows.

Magenta

Provides information about the step and copies rows.

Red dot line

The hop carries rows that caused errors in source steps.

Was this page helpful? Yes No Submitting... Thank you

Comments