Map Structured rules
|
Complete the Mapping tab to define the relationships between a set of properties and a single structured text value. GRP-247
When used with the Map Structured method, the system uses information
on this tab to assemble (From Clipboard
) or disassemble
(To Clipboard
) a structured text value. Information on this
tab does not determine the processing direction.
Field |
Description |
Settings | |
Character Encoding |
Select to control the character set used in the output structure when this rule is used in the From Clipboard direction to write to an output file. Select Character conversion from the internal character set of your Process Commander server to the encoding you specify in this field occurs only when you use this rule with the Connect-File method; this field is ignored by the Map-Structured method. Character conversion uses standard Java methods; in some cases two-byte characters may be converted to single-byte output characters. What Java method does the conversion? |
Justification |
Select For example, when you specify |
Default Pad Character |
Indicate whether data is to be padded
with spaces, or with another character, when this rule is used
in the When a map structured rule is used in the |
Specify Pad Character |
If you selected |
Map Format |
Identify the size and position of each field in the data structure. When you save the Map Structured form, the system validates that no fields are overlapping, and presents a warning if there are gaps (unmapped character positions) between fields. |
Offset |
Enter a character offset from the beginning of the structure for the first character position of this field. The first character of the structure starts at offset 0. |
Length |
Enter a length in characters. At runtime when this rule is
used in the |
Property |
Enter a property reference. To reference a property on the page corresponding to the Applies To key part, enter a period and the property reference. Use the notation pagename.propertyname to reference a property on another page, and include that page name on the Pages & Classes tab. Property references are not validated - Bug?
As a best practice, enter
only properties that have a character-oriented type, such as
You can also enter a string constant, by surrounding the text with double quote characters, or an expression. String constants and expressions are used to construct a string when the Map From Property to Clipboard direction is selected in the Map-Structured method. For more information about expressions, see About Expressions. |
Pad Character |
Leave blank to use the pad character
specified as the default, or type a character value to control
padding when this rule is used in the |
Justification |
Choose |