Syntax and Semantics For Input Mapping
The following table summarizes the syntax used to describe all cases of Internet input mapping.
|
Nonterminal |
Derivation |
|
name/value |
Field name [ length] [index] "=" value ["," name/value] |
|
field name |
{ " ~" |" _" | "-" } char { char | digit | " _" | " ~" | " -" } |
|
length |
":" numconst |
|
Index |
"[" numconst "]" |
|
value |
URL-encoded string |
|
numconst |
digit { digit } |
|
digit |
"0".. "9" |
|
char |
"A".. "Z" | "a".. "z" |
Please note that square brackets indicate an optional attribute.
The following table contains the corresponding semantics:
|
length |
Limits the number of characters taken from the value part and placed in the corresponding SAP screen field to numconst characters. Any additional characters are lost, except if the field is a multi-value field, corresponds to a step loop, and is filled in append mode (see "index" below). In this case any additional characters are automatically "word-wrapped" to the next step loop row. |
|
index |
If specified, this makes the field a multiple value field or a step loop. A numcons t defines the row to which the given value belongs. No numconst (that is, empty angle brackets) means that the value is added in append mode (that is, appended to the values already set). |
Below are some examples to clarify this:
firstName=Walt
sets the field named " firstName" on the screen to the value " Walt".
mail-text[12]=Best+regards
sets the step loop row 12 to the value " Best regards". Note that + is the URL-encoding for space.
mail-text[]="Walt+Whitman"
appends the text " Walt Whitman" to the end of the rows currently defined in the field " mail-text".
If this field already contains
mail-text[1] = "Hello Friend"
mail-text[2] = "Hope to see you soon"
mail-text[3] = "Best regards"
the result will be
mail-text[1] = "Hello Friend"
mail-text[2] = "Hope to see you soon"
mail-text[3] = "Best regards"
mail-text[4] = "Walt Whitman"
lastName:4=Whitman
sets the screen field " lastName" to the value " Whit"
mail-text:10[2]=Hope+to+see+you+soon
sets the step loop row number 2 to the value " Hope to see" and discards the "you soon" part. The line is truncated after the last space if the following word does not fit completely into the given boundaries. Due to the specified index, the "you soon" part is not wrapped to the next row as shown in the next example.
mail-text:10[]=Hope+to+see+you+soon
If mail-text currently contains mail-text[1]= "Hello!", this will result in:
mail-text[1] = "Hello! "
mail-text[2] = "Hope to see "
mail-text[3] = "you soon"
The automatic word wrapping takes places because of the unspecified index ("[ ]").
mail-text:10[]
=Hope+to+see+you+soon%d%a%d%aBest+regards%d%aWalt+Whitman
If mail-text currently contains mail-text[1]= "Hello! ", this will result in:
mail-text[1] = "Hello! "
mail-text[2] = "Hope to see "
mail-text[3] = "you soon"
mail-text[4] = ""
mail-text[5] = "Best "
mail-text[6] = "regards"
mail-text[7] = "Walt "
mail-text[8] = "Whitman"
The carriage return/new line sequence submitted by <textarea> controls has the same truncation/word wrap effect as reaching the length limitations on input.
firstName=Walt,LastName=Whitman
sets the field " firstName" to the value " Walt" and the field " lastName" to the value " Whitman".