SELECT_TEXT

Verwendung

SELECT_TEXT erzeugt eine Tabelle mit den Textheadern aller Textbausteine, die den in OBJECT, NAME, ID und LANGUAGE spezifizierten Bedingungen entsprechen. Die Angaben in den Parametern OBJECT, NAME, ID und LANGUAGE können auch generisch sein.

Normalerweise sucht der Funktionsbaustein Texte sowohl im Textmemory als auch in der Textdatei. Über die Parameter TEXTMEMORY_ONLY bzw DATABASE_ONLY kann der Suchbereich eingeschränkt werden.

Wird im Parameter ARCHIV_HANDLE ein Wert > 0 übergeben, so werden die zu selektierenden Texte im Archiv gesucht.

Funktionsaufruf:

CALL FUNCTION  'SELECT_TEXT'
        EXPORTING
                CLIENT          = SY-MANDT
                OBJECT          = ?...
                NAME            = ?...
                ID              = ?...
                LANGUAGE        = ?...
                DATABASE_ONLY   = SPACE
                TEXTMEMORY_ONLY = SPACE
                ARCHIVE_HANDLE  = 0
        IMPORTING
                ENTRIES         =
        TABLES
                SELECTIONS      = ?...
        EXCEPTIONS
                WRONG_ACCESS_TO_ARCHIVE =

Export-Parameter:

CLIENT	Spezifizieren Sie hier den Mandanten, aus dem Sie die Texte selektieren möchten. Ist dieser Parameter nicht angegeben, so wird als Standardwert der aktuelle Mandant verwendet. Bezugsfeld: SY-MANDT Defaultwert: SY-MANDT
OBJECT	Hier geben Sie den Namen des Textobjekts des zu suchenden Textes an. Das Textobjekt kann auch generisch angegeben werden. Bezugsfeld: THEAD-TDOBJECT
NAME	Der Parameter legt den Namen des zu suchenden Textbausteins fest. Der Name kann auch generisch angegeben werden. Bezugsfeld: THEAD-TDNAME
ID	Tragen Sie hier eine Text-Id ein. In ID können Sie auch einen generischen Wert angeben. Bezugsfeld: THEAD-TDID
LANGUAGE	Über diesen Parameter spezifizieren Sie den Sprachschlüssel des Textbausteins. Die Sprache können Sie auch generisch angeben. Es wird dann der Text in allen vorhandenen Sprachen gesucht. Bezugsfeld: THEAD-TDSPRAS
DATABASE_ONLY	Mit dem Parameter kann angegeben werden, ob die Textbausteine nur in der Textdatei gesucht werden sollen. Mögliche Werte: ' ' suchen sowohl in der Textdatei als auch im Textmemory 'X' nur in der Textdatei suchen Defaultwert: SPACE
TEXTMEMORY_ONLY	Mit dem Parameter kann angegeben werden, ob die Textbausteine nur im Textmemory gesucht werden sollen. Mögliche Werte: ' ' suchen sowohl in der Textdatei als auch im Textmemory 'X' suchen nur im Textmemory Defaultwert: SPACE
ARCHIVE_HANDLE	Falls Sie die Texte im Archiv suchen wollen, müssen Sie hier ein Handle angeben. Dieses wird benötigt, um auf das Archiv zugreifen zu können. Das Handle können Sie mit dem Funktionsbaustein ACHIVE_OPEN_FOR_READ erzeugen. Der Wert '0' bedeutet, daß der Text nicht vom Archiv gelesen werden soll. Bezugsfeld: SY-TABIX Defaultwert: 0

Import-Parameter:

ENTRIES

ENTRIES enthält die Anzahl der selektierten Textbausteine. Der Wert entspricht der Anzahl der Zeilen in der Tabelle SELECTIONS.

Bezugsfeld: SY-TFILL

Tabellen-Parameter:

SELECTIONS

Die Tabelle SELECTIONS enthält die Textheader zu allen gefundenen Texten, die den beim Aufruf des Funktionsbausteins SELECT_TEXT festgelegten Selektionskriterien entsprechen.

Struktur: THEAD

Exceptions:

WRONG_ACCESS_TO

_ARCHIVE

Die Ausnahme WRONG_ACCESS_TO_ARCHIVE wird ausgelöst, wenn auf ein Archiv mit falschem bzw. nicht existierenden Archiv-Handle oder falschem Modus zugegriffen wird (d.h. lesend, wenn Archiv für Schreiben geöffnet wurde bzw. schreibend, wenn Archiv für Lesen geöffnet wurde).