Show TOC

Syntax of SymbolsLocate this document in the navigation structure

Use

Each symbol has a name that is used when the symbol is called. A call to a symbol is normally made in a line of text that also includes other text. Therefore it is necessary that symbols can be distinguished from normal text, and that the call is structured in such a way that it is possible to identify it as a call to a symbol.

  • Use the delimiter ampersand (&) both immediately before and after the symbol.

  • Do not use blank characters in the name of a symbol. Moreover, since the characters '+() are used for defining formatting options, you must not use any of these in a symbol name either.

  • Make sure that no SAPscript editor line break occurs between the symbol delimiters. If necessary, use a long line to avoid this (paragraph format = or /=).

  • Enclose additional formatting options in parentheses and insert them immediately after the symbol name. The code letters identifying these options must be given in capitals.

A string that does not satisfy all the above conditions is not interpreted as a symbol but is copied directly into the output text.

Example

Examples of valid symbols:

  • &symbol&

  • &MY_symbol&

  • &KNA1-NAME1&

  • &DATE&

  • &KNA1-UMSAT(I)&

Example

Examples of invalid symbols:

&mysymbol

No closing character

&my symbol&

Name contains a space

&mysymbol)&

Name contains invalid character

&symbol(Z&

Closing parentheses missing around option

&KNA1-UMSAT(i)&

Formatting option not in capitals

Note

The symbol names themselves are not case-sensitive, that is, SAPscript does not distinguish between capital and lower case letters in symbol names. These symbol names are identical: &mysymbol&, &Mysymbol& and &MYSYMBOL&

A symbol name can contain a maximum of 130 characters. However, only the first 32 characters are used for unique identification.