Transformations

What is an ApplinX Transformation?

Using ApplinX Predefined Transformations

Creating a Transformation

Transforming a Repeating Characters Pattern to a Line

Text Pattern Transformations

Input Field Transformations

Input Field with Values Transformations

Date and Menu Transformations

Mapping a Transformation to a Screen/Screen Group

Overriding an Inherited Transformation


What is an ApplinX Transformation?

An ApplinX transformation contains the definitions required for transforming a certain pattern in the host screen into a Web element. For example, a line pattern in the host screen may be transformed into an HTML Web line.

A transformation can be applied to a Screen Group or to a Screen. Transformations minimize the need to write custom Web code in order to modify the appearance and behavior of ApplinX Web pages.

Refer to Code Transformations for more information regarding the concept of Instant Transformations.

ApplinX Transformations provide many options for transforming host patterns into Web elements. However, it may be the case that it will not be possible to define certain required transformations using the Transformations wizards, as their flexibility is limited. In such cases, it is possible to complement the wizard-defined Transformation entities with code-defined Transformation classes. For more information, see Instant Pages Customization, Code Transformations.

Refer to the Instant demo application and to the self-training files included in the ApplinX installation to see examples of transformations.

Using ApplinX Predefined Transformations

ApplinX predefined built-in transformations provide you a basic kit of commonly used transformations. You can import the predefined transformation entities to help start building up your own transformation library. Once you have imported the transformations, you can use them as-is or customize them to suit your exact needs.

Start of instruction setTo use ApplinX predefined built-in transformations

  • Right-click on the Repository node of the selected application and choose Import Predefined Transformations.

Creating a Transformation

Start of instruction setTo create a transformation:

  1. Select the relevant application or the Root node of the application.

  2. In the ApplinX Explorer tool bar, click on the arrow to the right of the Create new entity icon and select New Transformation. The New Transformation wizard is displayed.

  3. Enter a name for the transformation, a suitable description and determine the folder where the transformation is to be located. Click Next.

  4. In the Transformation Outline screen select the initial host pattern and the replacing element. screen. The available Host Pattern Elements:

    • Repeating Characters - a repeating sequence of text.

    • Text - a textual pattern.

    • Input field - an unprotected (input) field.

    • Input field with values - an unprotected (input) field followed by a list of its possible values that appears on the same row.

    • Date input field - an unprotected (input) field that contains date data.

    • Menu - a structured list of options. Each option is preceded by the option code that is placed in a selection input field.

    The host pattern elements can be transformed to one of the following application components. The list of application components which appears on the right frame of the Layout screen changes according to the selected host pattern element:

    • Line - a horizontal line.

    • Text - textual string.

    • Hyperlinks - a hyperlink. When relating to menus, each link represents a menu option and its corresponding option code.

    • Image - an image loaded from a file.

    • Button - a button performing an action when clicked.

    • Text field - an input field.

    • Combo box - a drop down list with single selection.

    • Radio buttons - a list of single-selection buttons.

    • Check box - a selected / unselected input element.

    • Calendar - a trigger element (image, button or link) that opens a Calendar window.

    • Hide - Does not create an alternative component.

  5. Click Finish. You have now created a new transformation entity in the repository.

For details regarding creating a specific transformation, refer to:

Transforming a Repeating Characters Pattern to a Line

Transforming a Text Pattern to Text

Transforming a Text Pattern to Hyperlink

Transforming a Text Pattern to an Image

Transforming a Text Pattern to a Button

Transforming an Input Field to a Text Field

Transforming an Input Field to a Combo Box

Transforming an Input Field to Radio Buttons

Transforming an Input Field to a Check Box

Transforming an Input Field with Values to a Combo Box

Transforming an Input Field with Values to Radio Buttons

Transforming a Date Input Field to a Calendar

Transforming a Menu to Hyperlinks

Transforming a Repeating Characters Pattern to a Line

This transformation is used to replace repeating characters with a line. It can also be used when you need to remove repeating patterns from text without adding a line (for example, removing unnecessary hyphens or stars, without adding a line). This is done by setting the line element's length to 0.

Refer to:

Start of instruction setTo transform a Repeating Characters Pattern to a line:

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern.

  2. In the Transform Repeating Characters tab in the Editor, describe the pattern that is to be searched for in the original host application. Select whether to locate a Repeating characters pattern or a more complex (Advanced) pattern.

    When selecting a Repeating characters pattern, enter the Repeated characters and the minimum times that this string is repeated (Minimum subsequent occurrences). Select the Contains title check box if text may appear between the repeated string. The Preview area will display a preview of the pattern definition.

    When selecting Advanced pattern, either type in the pattern or use the Capture from Screen feature to directly take a pattern from the host screen. Select the search method to use when searching for this text:

    • Contains text: Searches for the given text anyway in the defined region (default).

    • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

    • Contains word: Searches for the given text as word(s) within the defined region.

    • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    Note:

    When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

    When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

    graphics/trrc1.png

  3. In the To Line tab in the Editor:

    graphics/trrc2.png

    1. Select the Delete original element check box to delete the host pattern that was located.

    2. Define the length, position and format of the line:

      • Enter the length of the line. By default the length is the length of the original pattern, represented by a variable - $(line.length). Refer to Transformation Variables and their Attributes for further details about setting variables.

      • Define the position of the line. By default the position is the original position of the repeating character pattern. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(line.row) and $(line.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

      • Define the format of the line. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the line element.

    3. If the original host component includes a title (and you selected Contains title in the previous screen), define the line element's title text, position and format:

      • Enter the title text. By default the title name is the original title text and is represented by a variable - $(title).

      • Define the position of the title. By default the position is the original position of the line. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(title.row) and $(title.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

      • Define the format of the title. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the line element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming a Text Pattern to Text

This transformation can not only be used to replace text with other text, but also to format a certain text (for example - remove unwanted characters), leaving the textual data as is, or to move text from one position to another. The latter two usages are implemented by leaving the new text as the default (in the To Text tab in the Editor, in the Text field, the default value is $(text)), preserving the original textual data, and then performing other manipulations such as changing the position, removing unwanted characters or applying a certain style.

Refer to:

Start of instruction setTo transform a host text pattern to text

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trtexttext1.png

  2. In the Transform Text Tab in the Editor, enter the text pattern that is to be searched for in the host. Either type in the pattern or use the Capture from Screen feature to directly take a pattern from the host screen. Select the search method to use when searching for this text:

    • Contains text: Searches for the given text anyway in the defined region (default).

    • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

    • Contains word: Searches for the given text as word(s) within the defined region.

    • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    Note:

    When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

    When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

  3. In the To Text Tab in the Editor:

    graphics/trtexttext2.png

    1. Enter the new text. By default the text is the original text and is represented by a variable - $(text). Refer to Transformation Variables and their Attributes for further details about setting variables.

    2. Define the position of the text. By default the position is the original position of the text. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming a Text Pattern to Hyperlink

This transformation enables you to transfer a text pattern to a hyperlink. Note that the hyperlink element is a textual element. If you'd like to create a link with an image, refer to Transforming a Text Pattern to an Image and select an action that will be performed when the image is clicked (implementing the link behavior).

Refer to:

Start of instruction setTo transform a text pattern to a hyperlink

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trtexthpr1.png

  2. In the Transform Text Tab in the Editor, enter the text pattern that is to be searched for in the host. Either type in the pattern or use the Capture from Screen feature to directly take a pattern from the host screen. Select the search method to use when searching for this text:

    • Contains text: Searches for the given text anyway in the defined region (default).

    • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

    • Contains word: Searches for the given text as word(s) within the defined region.

    • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    Note:

    When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

    When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

  3. In the To Hyperlink Tab in the Editor:

    graphics/trtexthpr2.png

    1. Enter the new text. By default the text is the original text and is represented by a variable - $(text). Refer to Transformation Variables and their Attributes for further details about setting variables.

    2. Define the position of the text. By default the position is the original position of the text. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the hyperlink. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element.

    4. In the Trigger Action section define the action that is going to be performed once the hyperlink is clicked. It is possible to:

      • Send a host key - Select or enter the host key to be sent.

      • Execute a path - Browse to locate the folder where the path is saved. Select the path from the drop-down list.

      • Go to URL - Type in the relevant URL.

      • Enter a User defined action - Type in customized code to perform a customized action.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming a Text Pattern to an Image

This transformation enables you to transfer a text pattern to an image.

Refer to:

Start of instruction setTo transform a text pattern to an image

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trtextimg1.png

  2. In the Transform Text Tab in the Editor, enter the text pattern that is to be searched for in the host. Either type in the pattern or use the Capture from Screen feature to directly take a pattern from the host screen. Select the search method to use when searching for this text:

    • Contains text: Searches for the given text anyway in the defined region (default).

    • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

    • Contains word: Searches for the given text as word(s) within the defined region.

    • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    Note:

    When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

    When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

  3. In the To Image Tab in the Editor:

    graphics/trtextimg2.png

    1. Enter the text label for the image. By default the text is the original text and is represented by a variable - $(text). Refer to Transformation Variables and their Attributes for further details about setting variables.

    2. Define the position of the text. By default the position is the original position of the text. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

    4. Enter the image file name. It is possible to include references to variables, for example $(text).gif, and in this way use dynamic image names. Often, the image path is used in the Web application which is normally on a different machine and therefore it is recommended to write the relative path. Note that the default image, points to an image that exists in the framework's built-in Web applications.

    5. Define the position of the image. By default the position is Before text. It is also possible to select After text or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    6. Define the format of the image. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the image element.

    7. In the Trigger Action section define the action that is going to be performed once the image is clicked. It is possible to:

      • Send a host key - Select or enter the host key to be sent.

      • Execute a path - Browse to locate the folder where the path is saved. Select the path from the drop-down list.

      • Go to URL - Type in the relevant URL.

      • Enter a User defined action - Type in customized code to perform a customized action.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming a Text Pattern to a Button

This transformation enables you to transfer a text pattern to a button.

Refer to:

Start of instruction setTo transform a text pattern to a button

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trtextbtn1.png

  2. In the Transform Text Tab in the Editor, enter the text pattern that is to be searched for in the host. Either type in the pattern or use the Capture from Screen feature to directly take a pattern from the host screen. Select the search method to use when searching for this text:

    • Contains text: Searches for the given text anyway in the defined region (default).

    • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

    • Contains word: Searches for the given text as word(s) within the defined region.

    • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    Note:

    When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

    When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

  3. In the To Button Tab in the Editor:

    graphics/trtextbtn2.png

    1. Enter the text that will be displayed near to the button. By default the text is the original text and is represented by a variable - $(text). Refer to Transformation Variables and their Attributes for further details about setting variables.

    2. Define the position of the text. By default the position is the original position of the text. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

    4. Enter the text that will appear on the button.

    5. Define the position of the button. By default the position is Before text. It is also possible to select After text or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(text.row) and $(text.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    6. Define the format of the button. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text.

    7. In the Trigger Action section define the action that is going to be performed once the image is clicked. It is possible to:

      • Send a host key - Select or enter the host key to be sent.

      • Execute a path - Browse to locate the folder where the path is saved. Select the path from the drop-down list.

      • Go to URL - Type in the relevant URL.

      • Enter a User defined action - Type in customized code to perform a customized action.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field to a Text Field

This transformation enables you to transfer an input field to a text field.

Refer to:

Start of instruction setTo transform an input field to a text field

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trinputtext1.png

  2. In the Transform Input FieldTab in the Editor identify the input field according to accompanying text and/or the length of the input field.

      • Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

        • Contains text: Searches for the given text anyway in the defined region (default).

        • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

        • Contains word: Searches for the given text as word(s) within the defined region.

        • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

        Note:

        When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

        When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

      • Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    1. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Text FieldTab in the Editor define the label of the text field (text, position and format), as well as the position and the format of the text field:

    graphics/trinputtext2.png

    1. Enter the label text. By default the text is the original text and is represented by a variable - $(text).

    2. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the label. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

    4. Define the position of the text field. By default the position is the original position of the input field. Select the User defined radio button to define the row and column (by default these values are the row and column of the original pattern: $(input.row) and $(input.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    5. Define the format of the text field. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field to a Combo Box

This transformation enables you to transfer an input field to a combo box.

Refer to:

Start of instruction setTo transform an input field to a combo box

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trinputcmbo1.png

  2. In the Transform Input FieldTab in the Editor identify the input field according to accompanying text and/or the length of the input field.

      • Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

        • Contains text: Searches for the given text anyway in the defined region (default).

        • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

        • Contains word: Searches for the given text as word(s) within the defined region.

        • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

        Note:

        When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

        When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

      • Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    1. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Combo BoxTab in the Editor define the combo box values and label definitions:

    graphics/trinputcmbo2.png

    1. Define the list of values for the combo box. Click the Add Parameter to add rows. Click on the cell in the Original Value column and either type in the original value or use the Capture from Screen feature to directly take the value from the host screen. Click on the cell in the Display Values column and either type in the value to be displayed or use the Capture from Screen feature to directly take the value from the host screen. Use the Move Up and Move Down arrows to determine the order of appearance of the display values.

      Define the format of the combo box: Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    2. Enter the text that will appear before the combo box. By default the text is the original text and is represented by a variable - $(text).

    3. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(text.row) and $(text.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    4. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field to Radio Buttons

This transformation enables you to transfer an input field to a radio buttons.

Refer to:

Start of instruction setTo transform an input field to radio buttons

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trinputrdo1.png

  2. In the Transform Input FieldTab in the Editor identify the input field according to accompanying text and/or the length of the input field.

      • Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

        • Contains text: Searches for the given text anyway in the defined region (default).

        • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

        • Contains word: Searches for the given text as word(s) within the defined region.

        • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

        Note:

        When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

        When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

      • Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    1. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Radio ButtonsTab in the Editor define the radio button values and label definitions:

    graphics/trinputrdo2.png

    1. Define the list of values for the radio buttons. Click the Add Parameter to add rows. Click on the cell in the Original Value column and either type in the original value or use the Capture from Screen feature to directly take the value from the host screen. Click on the cell in the Display Values column and either type in the value to be displayed or use the Capture from Screen feature to directly take the value from the host screen. Use the Move Up and Move Down arrows to determine the order of appearance of the display values.

      Define the format of the radio buttons: Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    2. Enter the text that will appear before the radio buttons. By default the text is the original text and is represented by a variable - $(text).

    3. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(text.row) and $(text.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    4. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field to a Check Box

This transformation enables you to transfer an input field to a check box.

Refer to:

Start of instruction setTo transform an input field to a check box

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trinputchck1.png

  2. In the Transform Input FieldTab in the Editor identify the input field according to accompanying text and/or the length of the input field.

      • Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

        • Contains text: Searches for the given text anyway in the defined region (default).

        • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

        • Contains word: Searches for the given text as word(s) within the defined region.

        • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

        Note:

        When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

        When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

      • Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    1. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Check BoxTab in the Editor define the check box values when selected and when not selected, the position and format of the check box as well as the text, the position and the format of the text label appearing close to the check box.

    graphics/trinputchck2.png

    1. Define the values that will be sent to the host when the check box is selected, and when the check box is not selected.

    2. Define the position of the field: By default the position is the original position of the input field. Select the User defined radio button to define the row and column (by default these values are the row and column of the input, to allow relative position calculations: $(input.row) and $(input.column)). Select From bottom to define the row and column number relative to the bottom of the screen.

    3. Define the format of the check box. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    4. Enter the text that will appear before the check box. By default the text is the original text and is represented by a variable - $(text).

    5. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(text.row) and $(text.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    6. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field with Values to a Combo Box

This transformation enables you to transfer an input field with a value to a check box. .

Refer to:

Start of instruction setTo transform an input field with values to a combo box

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

  2. In the Transform Input Field with ValuesTab in the Editor define the pattern of the input field as well as whether to identify the input field according to accompanying text and/or the length of the input field:

    graphics/trinputvaluecmb1.png

    1. Define the input field - the possible prefix, separator and suffix, indicate whether each value is preceded by text, the possible delimiter characters and the minimum number of values in the list of values.

    2. Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

      • Contains text: Searches for the given text anyway in the defined region (default).

      • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

      • Contains word: Searches for the given text as word(s) within the defined region.

      • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

      Note:

      When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

      When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

    3. Define the position of the text. By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    4. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Combo BoxTab in the Editor define the Combo box display value, the format of the combo box, as well as the label, the position and the format of the text label appearing close to the combo box:

    graphics/trinputvaluecmb2.png

    1. Define the values that will be displayed. By default the display value is $(action): $(display).

      For example, if the pattern was (A=Apple, B=Banana, C=Coconut), the combo box value list will be:

      A: Apple

      B: Banana

      C: Coconut

      Changing the Display value field to $(display) ($(action)) will result in the following value list:

      Apple (A)

      Banana (B)

      Coconut (C)

      Changing the Display value field to $(display) will result in the following value list:

      Apple

      Banana

      Coconut

      In all the above examples, the actual value sent to the host is the value represented by $(action). For example, when Apple is selected, A will be sent to the host.

    2. Define the format of the check box. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    3. Enter the text that will appear before the combo box. By default the text is the original text and is represented by a variable - $(text).

    4. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(text.row) and $(text.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    5. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming an Input Field with Values to Radio Buttons

This transformation enables you to transfer an input field with a value to radio buttons.

Refer to:

Start of instruction setTo transform an input field with values to radio buttons

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

  2. In the Transform Input Field with ValuesTab in the Editor define the pattern of the input field as well as whether to identify the input field according to accompanying text and/or the length of the input field:

    graphics/trinputvaluerdo1.png

    1. Define the input field - the possible prefix, separator and suffix, indicate whether each value is preceded by text, the possible delimiter characters and the minimum number of values in the list of values.

    2. Accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

      • Contains text: Searches for the given text anyway in the defined region (default).

      • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

      • Contains word: Searches for the given text as word(s) within the defined region.

      • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

      Note:

      When selecting a different option, after defining a regular expression search definition, the value of the previous regular expression definition will be lost.

      When a screen image is displayed in the Session view, the pattern definition will be marked in the screen image.

    3. Define the position of the text. By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(input.row) and $(input.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    4. Input field's length - select this check box to identify the input field according to the input field's length. The Length field will become enabled. Type in the length of the input field.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To Radio ButtonsTab in the Editor define the radio buttons' display value, the format of the radio buttons, as well as the label, the position and the format of the text label appearing close to the radio buttons:

    graphics/trinputvaluerdo2.png

    1. Define the values that will be displayed. By default the display value is $(action): $(display).

      For example, if the pattern was (A=Apple, B=Banana, C=Coconut), the combo box value list will be:

      A: Apple

      B: Banana

      C: Coconut

      Changing the Display value field to $(display) ($(action)) will result in the following value list:

      Apple (A)

      Banana (B)

      Coconut (C)

      Changing the Display value field to $(display) will result in the following value list:

      Apple

      Banana

      Coconut

      In all the above examples, the actual value sent to the host is the value represented by $(action). For example, when Apple is selected, A will be sent to the host.

    2. Define the format of the check box. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    3. Enter the text that will appear before the radio buttons. By default the text is the original text and is represented by a variable - $(text).

    4. Define the position of the text: By default the position is Before input. It is also possible to select After input or User defined. Select the User defined radio button to define the row and column (by default these values are the row and column of the input to allow relative position calculations: $(text.row) and $(text.column)). Refer to Transformation Variables and their Attributes for further details about setting variables. Select From bottom to define the row and column number relative to the bottom of the screen.

    5. Define the format of the text. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the text element. Select the Left trim and/or Right trim check boxes to trim spaces from the right and left of the title. When necessary, enter the characters to be removed (when typing in more than one character, the contents of the field are related to as individual characters and not as a string of characters) and select Prefix or Suffix to determine the place of these characters.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Transforming a Date Input Field to a Calendar

This transformation enables you to transfer a date input field to a calendar component.

Note:
The Calendar component language is determined according to the operating system. When ApplinX identifies that the Operating System is English, French, German, Spanish or Portuguese, the Calendar component is displayed in the identified language. Other operating systems are displayed in English.

Refer to:

Start of instruction setTo transform a Date Input Field to a Calendar

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

    graphics/trdate1.png

  2. In the Transform DateTab in the Editor determine whether to identify the date input field according to accompanying text and define the date format:

    1. Identify the input field by the accompanying text - select this check box to identify the input field according to accompanying text. The text field will become enabled. Either type in the text or use the Capture from Screen feature to directly take text from the host screen. Select the search method to use when searching for this text:

      • Contains text: Searches for the given text anyway in the defined region (default).

      • Exact phrase: Searches for the given text within the defined region. The text must be preceded and followed by at least two white space characters.

      • Contains word: Searches for the given text as word(s) within the defined region.

      • Regular expression: Searches for the given pattern within the defined region. Refer to Regular Expression Syntax.

    2. Define the date format - define whether the date in the host is in a single input field, in two input fields or in three input fields. Select the date pattern from the drop-down list of available patterns or type a different date pattern. Refer to Date and Time Patterns for further information regarding date formats.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To CalendarTab in the Editor determine whether the calendar will be represented by an image, a button or a hyperlink. After determining the representation, define the relevant image file/text and format that will appear:

    graphics/trdate2.png

    1. Click on the arrow of the Calendar Launcher drop-down list and select Button, Link or Image. When selecting Button or Link, enter the text that will appear on the button/link. When selecting image, select the image file or type in its path (it is possible to include references to variables, for example $(text).gif, and in this way use dynamic image names). Often, the image path is used in the Web application which is normally on a different machine and therefore it is recommended to write the relative path. Note that the default image, points to an image that exists in the framework's built-in Web applications.

    2. Define the format of the element. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen. Note that the calendar component is not displayed in the HTML preview.

Transforming a Menu to Hyperlinks

This transformation enables you to transfer a menu to hyperlinks.

Refer to:

Start of instruction setTo transform a menu to hyperlinks

  1. Create a new transformation as detailed in Creating a Transformation and select the relevant type of pattern .

  2. In the Transform MenuTab in the Editor define the identifying parameters of the menu:

    1. Type in the string that appears before the leading token. The leading token is one or more characters that appear in front of the menu item description. These characters are often used by the host, to identify the menu item value. The leading token may be for example a number such as 1, 2, 3, or a letter such as a, b, c. Defining the string that appears in front of the leading token, helps identifying the menu pattern. By default the value of this field is two spaces. Refer to Host Pattern Elements for an example of this pattern.

    2. Define the maximum number of characters that the leading token may be.

    3. Define one or more possible delimiters. A specific menu will be identified only if it has exactly one type of delimiter, but the same transformation definition can match several different types of menus.

    4. Type in the string that appears after the menu item. By default the value of this field is two spaces.

    5. Select the minimum number of items required in order to identify the menu pattern.

    6. Define where to search for the field where the menu item is selected: in the current cursor position, the first unprotected field, the last unprotected field, the previous unprotected field, the next protected field or in a user defined position.

    Note:
    You can view and check the pattern definition by looking at the screen image displayed.

  3. In the To HyperlinksTab in the Editor define the text that is going to be displayed: define the values that are going to be displayed, the format of the hyperlinks, and determine whether the field where the menu item is selected will be shown or hidden.

    1. Define the values that will be displayed. By default the display value is $(action): $(display). Refer to Transformation Variables and their Attributes for further details about setting variables.

      For example, if the pattern was:

      1. Inventory Management

      2. Inventory Purchasing

      3. Sales Order Processing

      The display will be:

      1: Inventory Management

      2: Inventory Purchasing

      3: Sales Order Purchasing

    2. Define the format of the element. Enter a name of a style class (pre-defined in the Framework) that will be used to determine the format of the element.

    3. Select whether to hide the field where the menu item is selected or to show it.

  4. Save the transformation.

  5. Map the transformation to a screen or screen group.

  6. Test the transformation: Select a screen/screen group and click on the Entity menu. Select Open HTML Preview. When there is an existing Web application, test the transformation by refreshing the relevant screen.

Mapping a Transformation to a Screen/Screen Group

Mapping transformations to screens or screen groups enables applying the same transformation to multiple screens or screen groups, and when necessary to different screen regions. Transformations are mapped to screens/screen groups in the Screen/Screen Group dialog box, Transformations tab. When deciding to use a transformation it is necessary to define a region in which to search for the original host pattern. The region can be an entire screen, a rectangle in a screen, a number of specific consequent rows or specific application fields.

Start of instruction setTo map a transformation to a screen/screen group

  1. Open the relevant screen or screen group and display the Transformations tab.

  2. Either click on a transformation that is in the list of transformations, or click Add Transformation, to add an additional transformation to this screen/screen group and select a transformation from the drop down list.

  3. Select a Region type:

    • Select Anywhere on screen to search the entire screen for the host pattern.

    • Select Row range to search within specific consequent rows. Define the first and last row or use the Capture from Screen feature to select these rows. Select From bottom to define that the row numbers in the Start Row and End Row fields are calculated from the bottom of the screen.

    • Select Rectangle to search for the host pattern within a defined rectangle. Define the beginning of the rectangle by its Row and Column and then define the end of the rectangle by its Row and Column (it is also possible to use the capture from Screen feature to identify a range (rectangle)).

    • Select Application field to search for a specific application field and then select the field. It is possible to select a number of fields.

Overriding an Inherited Transformation

Transformations can be mapped to screens or to screen groups. Screens associated with a particular screen group will inherit from the screen group the field mappings and transformations mapped to that screen group. Sometimes, not all the transformations defined in the screen group are relevant to a particular screen and then it is necessary to override the inherited transformation and not use it. Another situation where you may need to override an inherited transformation is when you would like to apply the transformation to a different screen region than the screen region defined in the inherited transformation. In such a case, override the transformation (as detailed below), and then remap the transformation by adding it to the screen with the suitably defined screen region.

Start of instruction setTo override an inherited transformation

  1. Access the relevant screen by either double-clicking on the screen in the repository or navigating to the relevant screen in the session view and clicking Open screen in the right-click pop-up menu.

  2. Select the Transformations tab.

  3. Focus on the relevant transformation.

  4. Click on the Disable Transformation hyperlink.

    Note:
    Redefine that this transformation is to be used in the screen by clicking on the Enable Inherited Transformation hyperlink.