Rational Developer for System z

Creating an Insert action

This topic describes how to create an Insert action during a flow recording using the Select Variable window.

To create an Insert action:

  1. Navigate to the application screen for which you want to create an Insert action.
  2. On the toolbar of the host editor click Insert Data into Screen Insert. (Alternatively you can click the drop-down arrow and then click Create a Single Insert Action.)

  3. If you have not selected a variable message file and a variable message then the host editor opens the No Variable Message File window and prompts you to select or create a message file and a message for the flow (see Specifying a variable message later on during flow recording). Make your selections and click OK.

  4. The Select Variable window opens.
    Tip: The window does not open if you have selected the check box Do not prompt for variables when generating variable mappings in the Service Flow Project preferences (see Setting overall preferences for service flow projects). The variable is created automatically.
    The Select Variable window displays a list of all the variables in the variable message of the current flow (the flow being recorded) that can be used with the new Insert action. To be used with an Insert action a variable must be a String variable.
    Note: The list includes any String variable that you have used previously in the current flow as an Insert variable, a simple Extract variable, or a loop variable, together with any String variables that you have not used.
    1. From the list of variables displayed in the window select the variable that you want to use with the Insert action.

      You can create a new variable by clicking Add new variable and typing a variable name. The window creates a new String variable and adds it to the list of available variables.

    2. Click OK.

  5. Selecting a field:
    In the session area of the host editor, move the mouse pointer icon to the field in which you want the Insert action to insert text.
    Note: Whenever the mouse pointer icon passes over a field that allows text input, the host editor highlights the field with a red underline that is turned up at the ends (see Figure 1).
    Figure 1. Highlighting a field for an Insert action
    Insert
  6. Click the field to select it as the field to be used with the Insert action.

The window creates the Insert action.

Note: If you are doing a flow recording, then after you finish the recording and save the updated flow you can see the mapping for the Insert action in the appropriate mapping routine inside the mapping file for the flow.


Feedback