COPY_TEXTS 
Mit diesem Funktionsbaustein werden Texte kopiert. Sie können nur solche Texte kopieren, die schon in der Textdatei existieren.
Die Funktion COPY_TEXTS benötigt neben den Textschlüsseln der zu kopierenden Texte nur noch die Textschlüssel der Zieltexte. Diese Angaben werden über die Tabelle TEXTS dem Funktionsbaustein mitgeteilt.
Beim eigentlichen Kopiervorgang werden die Texte blockweise kopiert, ohne sie zuvor in die bekannten Textarbeitsbereiche zu übertragen.
Nach Ausführung des Funktionsbausteins können Sie im Feld SUBRC der Tabelle TEXTS für jeden Text das Ergebnis des Kopiervorgangs ablesen.
Diese Funktion ist wesentlich schneller als das Kopieren auf die folgende Weise:
Zu kopierenden Text mit READ_TEXT lesen
Textschlüssel für Zieltext in Header eintragen
Textbaustein unter neuem Namen sichern mit SAVE_TEXT
Funktionsaufruf:
Syntax
CALL FUNCTION 'COPY_TEXTS' EXPORTING SAVEMODE_DIRECT = ' ' INSERT = ' ' IMPORTING ERROR = TABLES TEXTS = ?...
Export-Parameter:
SAVEMODE_DIRECT |
Der Sicherungsmodus eines Textbausteins (direkt oder über Verbuchung) wird anhand des Textobjekts über die Tabelle TTXOB festgelegt. In bestimmten Fällen ist es jedoch sinnvoll, die verbuchungsseitige Sicherung durch eine sofortige Sicherung des Textes zu ersetzen (z.B. bei Hintergrundprogrammen). Mögliche Werte:
|
INSERT |
Der Parameter teilt der Textverarbeitung mit, daß es sich um einen noch nicht vorhandenen Textbaustein handelt. Normalerweise prüft SAPscript durch Lesen in der Textdatei, ob ein Textbaustein neu ist. Falls dies schon im rufenden Anwendungsprogramm bekannt ist, kann durch den Parameter das Probelesen unterdrückt und damit die Performanz verbessert werden. Mögliche Werte:
|
Import-Parameter:
ERROR |
Der Parameter zeigt an, ob beim Kopieren ein Fehler aufgetreten ist. Mögliche Werte:
Dieses Fehlerkennzeichen zeigt nur an, daß beim Kopieren eines Texts ein Fehler aufgetreten ist. Nähere Information kann dem Feld SUBRC in der Tabelle TEXTS entnommen werden. |
Tabellen-Parameter:
TEXTS |
Die Tabelle enthält die zu kopierenden Texte. Je Tabellenzeile kann eine Kopierfunktion aufgerufen werden. Dabei ist der vollständige Textschlüssel des Quelltextes und des Zieltextes anzugeben. Generische Angaben sind nicht zugelassen. Im Feld SUBRC wird nach Aufruf des Funktionsbausteins für jeden Text der Rückgaberecht des Kopiervorgangs zurückgegeben. Mögliche Werte von SUBRC:
Struktur: ITCTC |