Find more freelance jobs
6.11 Including Other Texts: INCLUDE
To include the contents of another text into the current text, use the INCLUDE control
command. SAPscript still treats the text to be included as a separate text. The text is copied
over only at the point at which the output is formatted.
Thus the use of the INCLUDE command always ensures that the most current version of a text
is included into the output, since the text is not read and inserted until the output is formatted.
/: INCLUDE name [OBJECT o] [ID i] [LANGUAGE l] [PARAGRAPH p]
You must specify the name of the text to be inserted. It can be up to 70 characters long. If the
name of the text contains spaces, then you must enclose it in quotes as a literal value. You can,
alternatively, specify the name via a symbol. All remaining parameters in the INCLUDE
command are optional. If an optional parameter is not specified, then SAPscript uses default
values as applicable for the calling environment.
/: INCLUDE MYTEXT
The text MYTEXT is included in the language of the calling text.
/: INCLUDE MYTEXT LANGUAGE 'E' PARAGRAPH 'A1'
The text with the name MYTEXT and the language E is included, regardless of the
language of the calling text. The paragraph format A1 will be used as the standard
paragraph type for this call. Optional parameters: · LANGUAGE If this parameter is not specified, then the language of the calling text or the form language
are used for the text to be included. If the language is specified, then the text will be fetched
in this language, regardless of the language of the calling text.
· PARAGRAPH The text to be included is formatted using the style allocated. The PARAGRAPH parameter
can be used to redefine the standard paragraph for this style for the current call. All *-
paragraphs in the included text will then be formatted using the paragraph specified here.
· NEW-PARAGRAPH The first line of the text to be included will be given this format indicator, as long as it is not
a comment or command line. If the optional PARAGRAPH parameter (see above) is not
specified, then all *-paragraphs of the included text will also be formatted using the
paragraph specified in the NEW-PARAGRAPH command.
· OBJECT In order to completely specify a text, information about the text object is also required.
There are a number of restrictions and other rules that depend on the object type of the
calling text: · Any kind of text can be included in a form. If no object is specified, then TEXT
will be used (standard texts). · In the case of a document text (DOKU object), you can include only document
texts. This object type is also assumed if no object is specified in this
environment. · Only hypertexts and document texts can be included in a hypertext (DSYS
object). If the OBJECT parameter is missing, then DSYS is used as the default
value. · In the other kinds of text you can include only standard texts (TEXT object),
document texts or hypertexts. If there is no specification, then the default object
is TEXT. · ID The text ID is a part of the text key, which permits further text objects within a given object.
If no ID is specified, then the default include ID is used from the TTXID table for the calling
text. If there is no entry in this table, then the text ID of the calling text is used. The following consistency check is applied both to the ID and the object: · All text IDs are allowed in a form. · In document texts, only document texts may be included that have text IDs TX (general
texts) or UO (authorization objects) and also other document texts with the same text ID
as the calling document text.
Previous Page|Next Page