Start of Content Area

Process documentation Structure TLINE of the Lines Table  Locate the document in its SAP Library structure

The lines table contains the lines of a text module. Its structure is determined by the structure TLINE. All text lines passed to SAPscript across the interfaces of function modules must have this line structure.

SAPscript has its own format for text lines, the ITF format. A text line in this format consists of two fields, the format field and the actual line contents. These two fields form the structure TLINE. The ITF format also determines the meaning and the typing of the control information allowed in the format and line fields.

You can use SAPscript to administer texts that have other formats that ITF. The information on the text format is stored in the text header. To pass texts with other formats to SAPscript via function modules, you must also use the structure TLINE. SAPscript, however, does not interpret the contents of the text lines but passes them on to the function modules, which call the interface to the external word processing program.

TDFORMAT: format field

The format column contains format keys that determine the output formatting of the text or start control statements. A format key determines the beginning of a new text paragraph and its formatting. All subsequent text lines, which contain blanks in this field, belong to the same paragraph. These lines are treated as texts with automatic line feed. The SAPscript editor formats these lines by fitting as many words as possible into one editor line, always considering blanks between words.

The formatting in the editor is independent of the formatting for output. Output formatting of a text is visible only when the text is actually printed or displayed on the screen. For output editing, the layout specifications of the paragraph format are evaluated. The possible format keys and their meanings are determined in styles or forms.

If you allocate a style or form to a text module, you can use the paragraph formats specified there for the text layout. Format keys which the user can define consist of one or two characters. The letters from A to Z and the numbers from 0 to 9 are allowed. The paragraph format must begin with a letter. If a format key is not part of the allocated style or form, the system uses the default paragraph of that style or form.

Some format keys are predefined by SAPscript. You can use them in all texts:

* default paragraph

For output formatting of the subsequent paragraph, the system uses the formatting specifications that correspond to the paragraph defined as default paragraph in the allocated style or form.

/ new line

For output formatting, the subsequent text appears on a new line. The formatting specifications of the last paragraph format apply.

/: command line

The system interprets the characters in the actual text line as control statements rather than text. Control statements are interpreted and executed when the test is formatted for output. The entire control statement must fit into one line; spreading it over subsequent lines is not allowed. The SAPscript editor does not format control statement lines.

/* comment line

When formatting a text for output, the system does not output this line.

= long line

This line is not subjected to line formatting in the SAPscript editor. The system appends the text in this line directly to the last character of the previous line. If you want some space in the output between the first and the second line, you must start the long line with at least one blank.

/= long line with line feed

This line is treated just as = (long line), but when formatting for output, the subsequent text appears in a new line.

( raw line

The SAPscript composer does not interpret the subsequent line when formatting the text for output. This means that any character formats, variables, tabs, mask characters, or hypertext links contained in this line are not evaluated and reach the output device unchanged. In addition, the text in this line is directly appended to the last character of the previous text line. If you want some space in the output between the first and the second line, you must start the raw line with at least one blank.

/( raw line with line feed

This line is treated just as ( (raw line), but when formatting for output, the subsequent text appears on a new line.

>x fix line

This line in input-disabled in the SAPscript editor. You cannot delete or split it. You can create a fix line only from within the program, for example, to allocate a fixed structure to a text, which the user cannot change. Replace the x with any number or any letter to distinguish, for example, between different subtitles.

If several fix lines with the same identifier appear in sequence, the SAPscript editor considers them as a unit. You cannot insert anything in-between in the editor. For output formatting, SAPscript interprets the first two characters of the line contents of a fix line as paragraph format. Either specify the desired paragraph format in these two characters or leave them blank.

TDLINE: text line

The field TDLINE contains the actual text. Depending on the format field of the line, the system interprets the line contents as

The control statement contained in a SAPscript text line must consist of readable characters. You cannot use hexadecimal codes, which cannot be displayed on the screen. If you do use hexadecimal codes, using SAPscript function modules may present unwanted results.

Beside the actual text, text lines can contain character formats and variables.

Character formats define the formatting of individual characters or character strings within a paragraph. They begin with the escape symbol <z> and end with the characters </>. If you leave out the end sequence, the system uses the character format until the end of the paragraph. You can nest character formats.

z is the name of the character format, which is defined either in the allocated style or form. Character formats defined by the user consist of one or two characters. Allowed are the letters from A to Z and the numbers from 0 to 9. The name must start with a letter. If a character format appears in the text that is defined neither in the style nor in the form, SAPscript ignores it.

Apart from the character formats the user can define, there are some formats predefined by SAPscript, which can be used in all texts:

<(>... <)> raw character

The characters in-between this character format are output unchanged. This allows you to pass certain character sequences and SAPscript variables to the output. This character format corresponds to the paragraph format 'raw line'.

<x> special character

Use this format to output a character that you cannot enter via the keyboard. Replace x with the number of the SAP character. All characters valid in the SAP system have a unique number. However, you can print or display this character only, if it is defined in the system character set and if the character set of the corresponding output device also contains it.

Variables (or symbols) are placeholders for values that you set at the moment of actually formatting the text for output. To recognize variables, they must have a certain structure: