EDIT_TEXT (SAP-Bibliothek - BC - SAPscript Formulardruck)

EDIT_TEXT

Mit diesem Funktionsbaustein wird der Fullscreen-Editor aufgerufen. Die Textzeilen können mit den dort vorhandenen Funktionen bearbeitet werden. Die Editoroberfläche wird entsprechend der dem Textobjekt zugeordneten Oberfläche eingestellt.

Normalerweise wird beim Verlassen des Editors mit der Funktion Sichern oder Merken der Funktionsbaustein SAVE_TEXT implizit aufgerufen, soweit der Text entsprechend dem eingestellten Textobjekt in der Textdatei gespeichert wird. Dieser Aufruf kann über den Parameter SAVE ausgeschaltet werden.

Hat das Feld TDFORMAT im Textheader den Wert SPACE, wird der SAPscript-Editor aufgerufen. Im anderen Fall wird der Funktionsbaustein EDIT_TEXT_FORMAT_xxx aufgerufen, wobei xxx für den Inhalt des Feldes TDFORMAT steht. Dieser Funktionsbaustein muß dann den für dieses Textformat vorgesehenen Editor aufrufen. Es hängt von diesem Schnittstellenbaustein und der aufgerufenen Textverarbeitung ab, welche der beim EDIT_TEXT übergebenen Parameter ausgewertet werden.

Funktionsaufruf

CALL FUNCTION 'EDIT_TEXT'
EXPORTING
DISPLAY = SPACE
EDITOR_TITLE= SPACE
HEADER =
SAVE = 'X'
CONTROL = SPACE
PROGRAM = SPACE
IMPORTING
NEWHEADER =
FUNCTION =
RESULT =
TABLES
LINES =
EXCEPTIONS
ID =
LANGUAGE =
LINESIZE =
NAME =
OBJECT =
TEXTFORMAT =
COMMUNICATION=

Export-Parameter

DISPLAY	Der Parameter steuert, ob der Texteditor im Anzeigemodus oder im Veränderungsmodus aufgerufen wird. Im Anzeigemodus kann der Benutzer keine Änderungen am Text vornehmen. Mögliche Werte: 'X' Anzeigemodus ' ' Änderungsmodus Defaultwert: SPACE
EDITOR_TITLE	Der angegebene Titel wird zusätzlich zu den sonstigen, von SAPscript generierten Überschriften in der Titelzeile des Texteditorfensters angezeigt. Dadurch ist es möglich einen beliebigen Titeltext im Editor zu setzen. Somit können komplizierte technische Textnamen umgeschlüsselt werden und dann in der Titelleiste angezeigt werden. Bezugsfeld: TTXIT-TDTEXT Defaultwert: SPACE
HEADER	Übergeben Sie hier die Feldleiste, die den Textheader des zu bearbeitenden Textes enthält. Struktur: THEAD
CONTROL	Über den Parameter CONTROL können Sie bestimmte Eigenschaften des SAPscript-Editors einstellen. Die Eigenschaften sind in den Feldern der Struktur ITCED beschrieben. Struktur: ITCED Defaultwert: SPACE
SAVE	Mit diesem Parameter legen Sie fest, ob vom Texteditor beim Sichern oder Merken die Funktion SAVE_TEXT aufgerufen wird. Wird ein Sichern durch den Editor nicht gewünscht, muß das Anwendungsprogramm den Funktionsbaustein SAVE_TEXT selbst aufrufen. Die geänderten Textzeilen werden in beiden Fällen an das Anwendungsprogramm zurückgegeben. Mögliche Werte: 'X' SAVE_TEXT aufrufen ' ' SAVE_TEXT nicht aufrufen Defaultwert: 'X'
PROGRAM	Mit diesem Parameter legen Sie das Programm fest, aus dessen Arbeitsbereiche die Werte der Programmsymbole ersetzt werden. Bei Nichtsetzen des Parameters werden die Feldwerte in dem zuerst aufgerufenen Programm gesucht (SY-CPROG). Bezugsfeld: SY-REPID Defaultwert: SPACE

Import-Parameter

NEWHEADER	Rückgabeparameter für den Textheader. Aufgrund bestimmter Operationen im Editor werden auch Felder im Textheader verändert. Struktur: THEAD
FUNCTION	Der Parameter gibt den Verarbeitungsstatus des Textbausteins für den aktuellen Editor-Aufruf zurück. Mögliche Werte: ' ' keine Aktion 'I' Textbaustein wurde neu angelegt 'U' Textbaustein wurde verändert 'D' Textbaustein wurde gelöscht
RESULT	Über diesen Parameter gibt der SAPscript-Editor eine Statusinformation an das rufende Programm zurück. Diese Information wird durch die Felder der Struktur ITCER beschrieben. Struktur: ITCER

Tabellen-Parameter

LINES

Enthält die Tabelle mit den Zeilen des Textbausteins.

Struktur: TLINE

Exceptions

ID	Die im Textheader, Feld TDID, angegebene Text-Id ist nicht in der Tabelle TTXID vorhanden. Sie muß dort zusammen mit dem Objekt des Textbausteins definiert sein.
LANGUAGE	Im Feld TDSPRAS des Textheaders ist ein Sprachkennzeichen angegeben, welches nicht in der Tabelle T002 definiert ist.
LINESIZE	Das Feld TDLINESIZE des Textheaders enthält eine Zeilenbreite, die kleiner als 0 oder größer als 132 ist.
NAME	Im Feld TDNAME des Textheaders wurde der Name eines Textbausteins übergeben, der nicht den SAPscript-Konventionen entspricht. Mögliche Fehler: Feld enthält nur Leerzeichen Feld enthält die unzulässigen Zeichen '*' oder ','
OBJECT	Das Feld TDOBJECT im Textheader enthält den Namen eines Textobjekts, welches nicht in der Tabelle TTXOB enthalten ist.
TEXTFORMAT	Die an den Funktionsbaustein übergebenen Textzeilen liegen in einem Format vor, das in der aktuellen Umgebung nicht verarbeitet werden kann. Das Format ist im Textheader in dem Feld TDTEXTTYPE abgelegt. Mögliche Ursachen für das Auftreten dieser Ausnahme können sein: Das Textformat wird überhaupt nicht unterstützt. Das Textformat kann auf dem aktuellen Frontend nicht verarbeitet werden, da hier die dazu notwendige Textverarbeitung nicht installiert ist. Das Textformat kann unter Batch-Input-Bedingungen nicht verarbeitet werden, da das dafür zuständige Textverarbeitungsprogramm nicht Batch-Input-fähig ist. Das Textformat kann nicht im Hintergrund verarbeitet werden, da das dafür zuständige Textverarbeitungsprogramm nicht aus Hintergrundabläufen angestoßen werden kann. etc
COMMUNICATION	Das Feld TDTEXTTYPE des Textheaders ist nicht leer, d.h. es enthält die Angabe eines Textformats, welches den Aufruf eines externen Textverarbeitungsprogramms erfordert. Beim Aufruf dieser Textverarbeitung ist ein Fehler aufgetreten. Mögliche Ursachen: Die externe Textverarbeitung ist auf dem Frontend nicht oder falsch installiert Die Textverarbeitung konnte nicht gestartet werden Bei der Kommunikation mit dieser Textverarbeitung trat ein Fehler auf Bei der Übertragung der Textdaten trat ein Fehler auf etc. Zur Bearbeitung von Texten in einem Fremdformat werden intern die Funktionsbausteine EDIT_TEXT_FORMAT_xxx bzw. PRINT_TEXT_FORMAT_xxx aufgerufen, wobei xxx der Inhalt des Feldes TDTEXTTYPE ist. Diese Funktionsbausteine enden mit der Ausnahme COMMUNICATION. SAPscript reicht diese Abbruchmeldung ohne weitere Analyse an das Druckprogramm weiter.