Rational Developer for System z

Extract action

An Extract action reads text from a specified field or from a specified rectangular area of the application screen.

If you create an Extract action during flow recording then the host editor also creates at the same time from the information in the Extract action one or more mappings that describe how the operation specified in the Extract action is to be performed (see Overview of creating an action). The host editor also prompts you for the name of a variable to be used in the mapping. (The variable is used to store the text that the Extract action reads from the application screen.)

In contrast, if you create the Extract action during screen operations recording or in the screen operations editor, then the mapping or mappings are not created. To create the necessary mapping or mappings you must start a flow recording and play back the screen interaction containing the new Extract action when you have navigated to the appropriate application screen (see Overview of creating an action). The host editor then prompts you for a variable to be used in the mapping.

Extracting text from a field: An Extract action that extracts the text contained in a single field of the application screen has the following properties:
Table 1. Properties of an Extract action that extracts text from a single field
Property: Description:
Field Required string. This property specifies the fully qualified name of the field from which the characters are to be extracted. The fully qualified name consists of:
  • The screen name (for example, OperatorIn_1)
  • Followed by the letters "ns"
  • Followed by a colon (:)
  • Followed by the field name (for example, Field251).
Example: OperatorIn_1ns:Field251

Using point-and-click to modify a Field property.

Name Optional string. This property specifies the custom name of the field, if you have provided a custom name (such as CustomerBalance).
Extracting text from a rectangular area: An Extract action that extracts text from a rectangular area of the application screen has the following properties:
Table 2. Properties of an Extract action that extracts text from a rectangular area
Property: Description:
End Column Required string. Column in which the lower right corner of the rectangular area is located.
End Row Required string. Row in which the lower right corner of the rectangular area is located.
Name Required string. This property automatically specifies a custom name for the rectangular area. The name consists of the word Area followed by the dimensions of the area (for example, Area:L1:R80:T1:B24).
Start Column Required string. Column in which the upper left corner of the rectangular area is located.
Start Row Required string. Row in which the upper left corner of the rectangular area is located.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)