Show TOC

ProzessLesen von Texten Dieses Dokument in der Navigationsstruktur finden

 

Texte können nur bearbeitet werden, wenn Sie in programminternen Arbeitsbereichen abgelegt sind. Deshalb muß ein Text zuvor in diese Arbeitsbereiche gestellt werden.

Dazu dient der Funktionsbaustein READ_TEXT. Er übertragt den Textheader des gewünschten Textes in die angegebene Feldleiste und legt seine Zeilen in der spezifizierten Zeilentabelle ab.

Prozess

Primär wird der Text von der Textdatei gelesen. Bei Texten mit verbuchungsseitiger Sicherung wird aber zuerst im Textmemory nachgeschaut, ob dort eine aktuell bearbeitete Version vorliegt. Ist dies der Fall, wird diese Version des Textes zur Verfügung gestellt, ansonsten wird ebenfalls der Text von der Textdatei zur Verfügung gestellt.

Über den Parameter ARCHIVE_HANDLE kann man auch die im Archiv abgelegte Version des Textes lesen.

Existiert der gewünschte Text noch nicht, so wird READ_TEXT mit der Ausnahme NOT_FOUND beendet. Der Inhalt der Arbeitsbereiche für den Textheader und die Textzeilen haben dann keinen definierten Zustand, bedingt durch das Beendien des Funktionsbausteins über eine Ausnahme. Sie müssen anschließend die Arbeitsbereiche mit INIT_TEXT initialisieren, um einen Zustand herzustellen, mit dem die weiteren SAPscript-Funktionsbausteine arbeiten können.

Der Funktionsbaustein READ_TEXT behandelt auch Textreferenzen. Er arbeitet dazu die Referenzkette so lange ab, bis das Ende der Kette erreicht ist, und liefert die Textzeilen dieses Textes in der Zeilentabelle zurück.