Prozess

Das Referieren von Texten geschieht programmgesteuert, d.h. eine Textreferenz kann nur über den SAPscript-Funktionsbaustein REFER_TEXT aufgebaut werden, der in einem Anwendungsprogramm aufgerufen wird. Ein Text, der einen anderen Textbaustein referiert, kann selbst keine weiteren Textzeilen enthalten. Die Referenz wird dadurch hergestellt, daß im Textheader der referierte Text in den Feldern TDREFOBJ, TDREFNAME und TDREFID abgelegt wird. Die Sprache des referierten Textes wird gleichgesetzt mit der Sprache des Textes, der die Referenz enthält.

Bei einer Textreferenz wird nur der Textheader gespeichert. Die Textzeilen werden beim Lesen des Textes aus dem Referenztext dazugelesen. Die Referenz kann auch über mehrere Stufen gehen. Dies bedeutet, daß ein referierter Text einen anderen Text referieren kann. In diesem Fall wird beim Lesen die gesamte Referenzkette abgearbeitet und die Textzeilen des am Ende dieser Kette stehenden Textes verwendet.

Beim Referieren von Texten gibt es keine Beschränkungen hinsichtlich des Textobjekts, der Text-Id und des Textnamens. Das Anwendungsprogramm, welches die Referenz aufbaut, muß dafür Sorge tragen, daß die richtigen Texte referiert werden. SAPscript führt keine Berechtigungsprüfungen durch.

Wie beim Inkludieren von Texten wird beim Drucken bzw. Anzeigen des Textes im Editor immer die aktuelle Version des referierten Text verwendet. Im Gegensatz zu einem inkludierten Text werden alle Textzeilen eines referierten Textes im SAPscript-Editor angezeigt. Allerdings ist der Textzeilenbereich des Editors nicht eingabebereit und Sie können somit keine Änderungen an dem Text vornehmen. Weiterhin können Sie auch keinen zusätzlichen Zeilen einfügen. Wenn Sie trotzdem den Text verändern wollen, müssen Sie ihn entsperren. Im Editor rufen Sie dazu die Menüpunkte  Text Entsperren auf. Die Referenz wird dann aufgelöst und die Zeilen wie beim INCLUDE in den aktuellen Text kopiert. Die Textzeilen des Editors sind jetzt eingabebereit Es besteht nun keine Verbindung mehr zu dem ursprünglich referierten Text.

Wollen Sie eine Referenz per Programm auflösen, so Löschen Sie einfach die Felder TDREFOBJ, TDREFNAME und TDREFID im Textheader. Stellen Sie aber zuvor sicher, daß sich die Textzeilen dieses Textes in der zugehörenden Zeilentabelle befinden.

Ist ein referierter Text nicht mehr vorhanden, so wird z.B. der Funktionsbaustein READ_TEXT mit der Ausnahme REFERENCE_CHECK abgebrochen. Bei der Druckaufbereitung durch den SAPscript-Composer wird ein fehlender Referenztext ignoriert.