You use the text type Include Text of the text node to refer to a SAPscript text that already exists in the system. To identify the text, you need the Text Name, the Text Object, the Text ID, and the Language. This allows you to easily use a text in several forms. In addition, you do not need to load the whole form description to maintain these texts.
This text type corresponds to the SAPscript statement INCLUDE. However, SAP Smart Forms does not allow any control statements in include texts. They are simply ignored when the form is processed.
To manage application-specific form texts, applications define their own text objects with subordinate text IDs in transaction SE75. Use text object TEXT with text ID ST to enter general standard texts. To maintain them, use the standard text editor (transaction SO10).
If there is no need for you to use old SAPscript texts, use text modules instead. They can be used across clients and are connected to the transport and translation systems.
When using an include text, you can use the SFSY-SUBRC system field to check at runtime whether the text could be found in the system.
Procedure
Create a text node in the navigation tree of the Form Builder.
Enter a unique name for the node and a node description (for example, letter).
On the General Attributes tab, choose Include Text as text type.
Since you use a text node exclusively to edit a text element, an included text, or a text module, the system only stores information on the selected type. When you change the text type, the system therefore asks for your confirmation.
In the Text Key box, identify the include text.
To identify individual text objects, use the search help in this field.
The search help for the Text Name field allows you to include the attributes of SAPscript texts in the search.
Use the Language field to specify the language of the text you want to include.
If necessary, format the include text in the Paragraph Formats box:
The style that is assigned to the text node contains the format for the standard paragraphs (' * '). If you specify a paragraph format in the Standard paragraph field, you override this format for all standard paragraphs in the include text with this paragraph format.
In the First Paragraph field, you can set a paragraph format for the first paragraph of the include text and thereby override the setting in the style. If the Standard paragraph field is empty, all standard paragraphs in the include text are also formatted with this paragraph format.
In the Begin list box, choose whether you want the text to start with a new paragraph or just in a new line. You can also choose to append the text directly to the end of the current paragraph.
Select the No Error if Text Does Not Exist checkbox if you want the form to be printed even if the include text you refer to does not exist in the system. Otherwise, processing is terminated and an error message appears.
If required, use the output options tab to maintain attributes for the style, box, and shading of the text.
Result
The system displays the node, including its name and description, in the tree structure. The corresponding text is only included when the form is processed.
You use the text type Text M odule of the text node to refer to an existing text module in the system. This allows you to easily use texts from one text module in several forms. In addition, it is not necessary to load the entire form description to maintain these texts.
You can use text modules in two ways:
Refer to the text module. The text then appears read-only in the PC editor and is included when you print the form.
Copy the text module. The system then copies the text of the module and automatically converts the text node into an editable text element.
Text modules can be used across clients and are connected to the transport and translation systems.
If you refer to a text module, you can use the SFSY-SUBRC system field to check at runtime, whether the text module was found in the system.
Prerequisites
The text module you want to include must exist in the system. To create a text module use the SAP Smart Forms initial screen.
Procedure
Create a text node in the navigation tree of the Form Builder.
Enter a unique name for the node and a description (for example, business terms).
On the General Attributes tab select the text type Text M odule.
Since you use the text node exclusively to edit a text element, an included text, or a text module, the system only stores information on the selected type. When you change the text type, the system therefore asks for your confirmation.
Enter the name of the text module in the Text N ame field. Or click on the black arrow and enter the name of a field to be evaluated dynamically. In addition, you can use the Language field to include the module in a particular language.
If you want to change the text of the text module for the current form, choose Copy. The Form Builder changes the text type to Text E lement and copies the text of the module into the PC Editor, where you can edit it. In this case, the original text module remains unchanged.
Use the checkbox Always C opy S tyle F rom T ext to determine that the style of the text module is of higher priority than that of the text node or any style inherited from a superior node. This is important if you specified the name of a field in step 4 (see F1 help).
Mark No Error, if Text does not Exist if you want the form to be printed even if the text module you refer to does not exist in the system. Otherwise, processing is terminated and an error message appears.
If required, use the Output options tab to maintain attributes for style, box and shading of the text.
Result
The system displays the node including name and description in the tree structure. It includes the relevant text itself in the moment the form is processed. If you refer to a text module, it appears in the PC Editor in read-only mode; if you copy it you can edit it.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.