Ansicht
Dokumentation

F4TOOL_CHECKTABLE_HELP - Prüftabellenhilfe simulieren

Addresses (Business Address Services)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit diesem Funktionsbaustein können Sie die Prüftabellenhilfe für eine Tabelle aus dem ABAP Dictionary simulieren. Das heißt: Sie können das Verhalten der Eingabehilfe (F4-Hilfe) für ein Eingabefeld simulieren, das eine vorgegebene Tabelle als Prüftabelle besitzt.

Prüfen Sie bitte zunächst, ob die gewünschte Funktion nicht besser durch eine Verwendung entsprechend definierter ABAP Dictionary Objekte realisiert werden kann.

Der Name der Tabelle, die als Prüftabelle verwendet werden soll, ist im IMPORT-Parameter CHECKTABLEanzugeben. Im IMPORT-Parameter RETFIELD ist anzugeben, welches Schlüsselfeld der Prüftabelle dem Eingabefeld bei der (virtuellen) Fremdschlüsseldefinition zugeordnet wurde. Ist die Prüftabelle mandantenabhängig, so darf ihr Mandantenfeld hierbei nicht verwendet werden.

Für den Aufruf dieses Bausteins sind grundsätzlich zwei Szenarien möglich:

1. Der Aufruf des Funktionsbausteins erfolgt in einem Modul der Ablauflogik, das beim Dynproereignis PROCESS ON VALUE-REQUEST zum Eingabefeld prozessiert wird. Der Baustein ermittelt selbst zu berücksichtigende Benutzereingaben (und sonstige zu berücksichtigende Kontextinformationen). Wählt der Benutzer einen Wert aus, so sorgt der Baustein selbst dafür, daß dieser auf die Eingabemaske zurückgestellt wird. Hierbei werden ggf. auch die Inhalte weiterer Felder der Eingabemaske aktualisiert.
2. Der Funktionsbaustein wird zu einem beliebigen Zeitpunkt aufgerufen. Zu berücksichtigende Feldinhalte werden dem Funktionsbaustein explizit mitgegeben. Der Baustein führt keine automatische Rückstellung auf die Eingabemaske durch. Statt dessen wird der vom Benutzer ausgewählte Wert im TABLES-Parameter RETURN_TAB zurückgegeben.

Der Baustein wählt automatisch das zweite Szenario aus, wenn der TABLES-Parameter RETURN_TAB beim Aufruf versorgt ist.

Achtung: Das erste Szenario ist zu bevorzugen, da nur in diesem Fall die amodale Standardhilfe unterstützt werden kann. Außerdem ist in diesem Fall auch der Programmieraufwand für den Aufrufer dieses Bausteins geringer. Das erste Szenario kann allerdings nur verwendet werden, wenn der Aufruf des Bausteins tatsächlich im Dynproereignis PROCESS ON VALUE-REQUEST erfolgt. Andernfalls wird die Ausnahme ILLEGAL_CALL ausgelöst. Außerdem ist dieses Szenario (bisher) nur zulässig, wenn der IMPORT-Parameter MULTIPLE_CHOICE nicht gesetzt ist.

Beispiel

Auf einem Dynpro haben Sie zwei Felder CARR und CONN. Für das Feld CONN soll die Prüftabellenhilfe zur Tabelle SPFLI simuliert werden. Hierbei soll das Feld CONN dem Schlüsselfeld CONNID der Tabelle SPFLI entsprechen. Das zusätzliche Schlüsselfeld CARRID der Tabelle SPFLI soll hierbei dem Dynprofeld CARR zugeordnet sein.

Hierzu ist in der Ablauflogik des Dynpros der folgende Verweis zu hinterlegen:

PROCESS ON VALUE-REQUEST.
FIELD conn MODULE POV_FOR_CONN.

Hierbei ist der Name POV_FOR_CONN natürlich frei wählbar. Im Modulpool des Dynpros muß sich dann eine Definition dieses Moduls befinden, die den folgenden Programmtext enthalten sollte:

DATA mapping TYPE STANDARD TABLE OF DSELC WITH HEADER LINE.
mapping-FLDNAME = 'CARRID'.
mapping-DYFLDNAME = 'CARR'.
APPEND mapping.
CALL FUNCTION 'F4TOOL_CHECKTABLE_HELP'
EXPORTING
CHECKTABLE = 'SPFLI'
RETFIELD = 'CONNID'
WINDOW_TITLE = 'geeigneter Text, siehe Parameterdoku'
TABLES
DYNPFLD_MAPPING = mapping
EXCEPTIONS
OTHERS = 01.

Beachten Sie bitte, daß hierdurch noch keine Eingabehilfe für das Feld CARR zur Verfügung gestellt wurde.

Hinweise

Beachten Sie auch die Dokumentation der Parameter.

Weiterführende Informationen

Parameter

CHECKTABLE
DISPLAY
DYNPFLD_MAPPING
MULTIPLE_CHOICE
RETFIELD
RETURN_TAB
VALUE
WINDOW_TITLE

Ausnahmen

FIELD_NOT_EXISTS
ILLEGAL_CALL
TABL_NOT_EXISTS

Funktionsgruppe

SDHI

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5358 Date: 20240523 Time: 140943     sap01-206 ( 92 ms )