Field Tag

Children: none

Used By: MapField, getMapField, mappedGet, mappedSet, mappedRowGet, mappedRowSet

Description

The Field tag is used to describe individual fields inside a FieldMap tag. The Field tag has no children, so it should be terminated with a forward slash at the end of the tag.

The name attribute is the named used in the mappedGet, mappedSet, mappedRowGet and mappedRowSet methods of the HostScreen object. This is not fully qualified with the map name, but is instead controlled with the activeMapName property of HostScreen.

Attributes

Name	Type	Description
name	required	Name of the field, used in the mappedGet, mappedSet, mappedRowGet and mappedRowSet methods of the HostScreen object
row	required	Row where field exists on screen, starting with 1. Note-- for a FieldMap that is describing a multirow area of a screen, enter the topmost row of the multirow area. This becomes the base point for the mappedRowGet and mappedRowSet methods. If a multi-row area has more than one physical row per logical field set, if defining a field on the second or nth row, still define the topmost row for that field in the set.
column	required	Column where the field exists on the screen
length	required	Length that the field inhabits--try to set the maximum length of the field, not simply the size of the data viewed in a sample.
adjust	optional	default="left" Use adjust to define whether any padding characters (blank or defined PAD character) should be assumed to be to the right or left of the text. When adjust="left", pad characters are to the right and when adjust="right" pad characters are to the left.
action	optional	default="read" values: "read", "write", "readwrite" action is provided as a reference for if a field is protected or not (unprotected=entry). And the assumed use of the field in the map. The functions mappedSet, mappedGet, mappedRowSet and mappedRowGet ignore this setting, but other methods that act on whole maps may use it in the future.