Screens, Fields and Mappings

In the Screen Editor edit the screen definitions: the identifiers, fields, transformations, screen groups, tables and map steps. The Screen Editor can be accessed after creating a new screen or by editing an existing one. Refer to Screens.


Screens/Screen Groups

Identifiers Tab

Lists the identifying elements that identify the screen. Refer to Identifiers, Adding or Deleting an Identifier and Editing a Screen Identifier.

Identify entire screen (ignore window definition)

Selecting this check box indicates that the application's window definitions are ignored during the identification of this screen. Once the screen is identified, the full screen is used. This check box is only enabled when the screen has a window.

Select this check box:

  • When the screen includes multiple windows and the window definition in this screen is ambiguous.

  • To override general application window identification definitions in a specific screen.

Note:
Changing the selection of this field will cause existing position-dependent definitions in the screen (such as identifiers, application fields and transformation regions) to be incorrect. It is therefore necessary to redefine identifiers, application fields and transformation regions when selecting/clearing the check box. By default this field is not selected.

List of Identifiers

Lists the existing identifiers. There are several columns in this table:

Icon Graphic indication of the type of identifier.
Type Textual indication of the type of identifier
Content Description of the identifier contents
Row The position within the screen
Column The position within the screen
Application Fields Tab

Lists the screen's mappings. Enables adding new mappings, such as single, multiple or dynamic mappings. Next to each mapping, an icon indicates whether the mapping is inherited from a screen group, whether the mapping has been defined locally for the current screen, or whether the mapping was originally inherited from a screen group but has been overridden locally to suit the current screen. When selecting an inherited mapping, it is not possible to change the mapping properties. When selecting a local mapping, all properties can be changed. When selecting an overridden mapping, all properties can be changed, except for the name.

Icon Legend
Icon Description

graphics/mapping_local.gif

The mapping has been defined locally for the current screen.

graphics/mapping_inherited.gif

The mapping is inherited from a screen group.

graphics/mapping_override.gif

The mapping was originally inherited from a screen group but has been overridden locally to suit the current screen.

graphics/mapping_remove_override.gif

Cancels overriding an inherited mapping.

The Override/Cancel Override hyperlink (enabled when not selecting a local mapping) overrides an inherited mapping, or cancels overriding an inherited mapping (using the inherited values).

The Add Field Mapping hyperlink enables adding a new field mapping.

The Delete Field Mapping hyperlink (enabled on when selecting a local mapping) removes the mapping.

VT Parameters within Field Mappings Tab
Override default parameters

Overrides VT screen parameters for specific mappings in the current screen. For example, when it is necessary to define that a field is a password type field. This means that characters are sent from ApplinX to the host, but only asterisks are retrieved from the host. In order to validate that the correct data has been received from the host, it needs to be indicated that this field's characters are hidden.

Automatic skip

When checked, indicates that the cursor skips automatically to the next input field upon reaching the end of the current field (happens when the field is completely filled with text).

Skip one position

When checked, indicates that the cursor skips automatically when the field is completely filled, but it skips only one position and not to the next field.

Always send this field

As ApplinX operations may not work in an efficient manner when working with these hosts (require cursor movements), ApplinX attempts to perform a minimal set of operations, thus preferring to send only fields that have different content than what was returned from the host. In very rare cases, the user keystrokes need to be sent even when they do not change the original content. In these instances Send all fields should be selected.

Override default unprotected field navigation

Indicates that the tab movement will be different from the default tab movement.

Next mapping

Defines the next mapping the tab will move to.

Index

For multiple mappings, moves to the Next mapping according to the index.

Host field behavior

This property indicates the behavior of a certain field (alignment of the text and cursor for a certain field, hidden for password field etc.). The ApplinX Server uses it in order to place sent text in the correct position in the field, and waits for the correct text in the correct position after sending it. The default value is blank (the text is sent in the place where the cursor is positioned, and the contents received from the host are not validated).

  • Left: Cursor and text are aligned to the left-most position of the field (default).

  • Right, zero fill: The cursor and text are aligned to the right. Leading zeros are prepended to the text.

  • Right, blank fill: The cursor and text are aligned to the right. Blanks are prepended to the text.

  • Right, cursor fixed to the right: The cursor stays fixed in the right-most position of the field as the user types in the field.

  • Right, cursor fixed to the right with offset: The cursor stays fixed to the right of the field, but with a certain offset from the rightmost position (usually the offset is 1). Offset text field: the number of host columns offset of the cursor position from the rightmost position of the field.

  • Left, cursor fixed to the left with offset: Similar to the above, but the cursor is fixed to the left of the field, with a certain offset to the left.

  • Right, cursor left: The cursor is aligned to the left while typing text in the field, but after leaving the field, the text is aligned to the right.

  • Hidden: Do not check - the text typed in the field does not appear exactly as typed after leaving the field (applies to password fields and to special format fields like currency fields).

  • Hidden, cursor moves: Text does not appear in the field after typed, but the cursor automatically skips to the next field if the field was completely filled.

Uppercase

Determines whether to override the host configuration (defined to send the data converted to uppercase).

Transformations Tab

Note:
This is not available when working with a SOA license.

Lists the transformations used in the screen. Next to each transformation, an icon indicates whether the transformation is inherited from a screen group, whether the transformation has been defined locally for the current screen, or whether the transformation was originally inherited from a screen group but has been disabled for the current screen. Refer to the relevant Transformation topics for further details.

Icon Legend
Icon Description

graphics/mapping_local.gif

The transformation has been defined locally for the current screen.

graphics/mapping_inherited.gif

The transformation is inherited from a screen group.

graphics/mapping_hide_inherited.gif

Disables the inherited transformation.

graphics/mapping_hide_local.gif

Disables the local transformation.

The Enable/Disable Transformation hyperlink allows you to determine whether to use the selected inherited transformation or not.

The Add Transformation Mapping icon enables associating an existing transformation with this screen.

The Delete Transformation Mapping hyperlink (enabled on when selecting a local transformation) removes the transformation from the list.

Screen Groups Tab

Enables associating screen groups from the list of available screen groups to the current screen (relevant for Screens only)

For more information, refer to Screen Group Tasks.

VT Parameters

VT parameters are defined per application. Sometimes it is necessary to override these parameters for a specific screen. This can be implemented by opening the relevant screen in the Editor view and in the VT parameters tab, changing the configuration. For details regarding each of these parameters refer to the VT Application parameters.

Parameters for Generating JSP Page from Screen

It is possible to generate a JSP page from a screen (refer also to Generating a JSP/ASPX Page from a Screen).

Location of Generated Files

graphics/generatepagescreen.png

Indicates the folder where the generated files will be placed.

Screen Contents

graphics/generatepagescreencontents.png

Screen region

Determines the generated area: either the entire screen or a rectangular area.

Screen fields

Determines whether to generate all the types of fields or only application fields and unprotected fields (and not generate protected and output fields). If you select to generate application fields and unprotected fields only, then determine whether to generate the input fields without labels or with the label that appears to the left of the input field or with the label that appears to the right of the input field (Include field labels left/right to the field).

Screen elements

Determine whether to generate the Host keys control and/or transformations.

Code Snippets

graphics/generatepagegcodesnip.png

In the Code Snippets tab define the elements you would like to generate code behind for: code transformations, ApplinX host windows, user exits - client side events (JavaScript) or user exits - server side events (Java). The code class contains methods which can be used as a basis for further development.