Ansicht
Dokumentation
/PM0/ABU_NAMECHK_SHLP - Standard Suchhilfe-Exit zum Füllen der Trefferliste
RFUMSV00 - Advance Return for Tax on Sales/Purchases BAL_S_LOG - Application Log: Log header dataDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Dieser Funktionsbaustein kann genutzt werden, um innerhalb eines Suchhilfe-Exits die Treffermenge aus einer eigenen Datenstruktur in die vom F4-Prozessor verwaltete Datenstruktur zu übertragen.
Der Baustein wird typischerweise benutzt, wenn ein Suchhilfe-Exit zum Zeitpunkt 'SELECT' die Selektion der anzuzeigenden Werte selbst übernimmt, und dabei eine interne Tabelle eigener Struktur füllt. Diese Tabelle ist diesem Baustein im Parameter SOURCE_TAB zu übergeben. Im Parameter SOURCE_STRUCTURE kann der Name einer ABAP Dictionary Struktur mitgegeben werden, die die Struktur der in SOURCE_TAB verwalteten Daten beschreibt. Ist der Parameter SOURCE_STRUCTURE nicht versorgt, so wird die Struktur zugrunde gelegt, mit der SOURCE_TAB im Programm definiert wurde.
Der Baustein überträgt die Daten in die Tabelle RECORD_TAB, deren Inhalte vom F4-Prozessor interpretiert werden können. Dabei erhält RECORD_TAB zunächst einmal soviele (initiale) Zeilen, wie SOURCE_TAB Zeilen hat. Anschließend wird für jeden Parameter der prozessierten (elementaren) Suchhilfe geprüft, ob SOURCE_TAB ein gleichnamiges Feld besitzt. Ist dies der Fall, so wird der Inhalt zeilenweise übertragen.
Beispiel
Hinweise
- Dieser Baustein wird normalerweise zum Zeitpunkt 'SELECT' aufgerufen, nachdem das Suchhilfe-Exit die Selektion der Daten selbst durchgeführt hat. Anschließend sollte CALLCONTROL-STEP auf 'DISP' verändert werden, da der F4-Prozessor sonst im Zeitpunkt 'SELECT' die in RECORD_TAB eingetragenen Werte wieder löscht.
- Durch IMPORT-Parameter der Suchhilfe, durch Suchhilfe-Parameter, die einen Defaultwert besitzen und durch Benutzereingaben auf dem Popup zur Einschränkung der Werte können Einschränkungen an die anzuzeigenden Werte in die Eingabehilfe eingehen. Durch Setzen des Parameters APPLY_RESTRICTIONS können Sie erreichen, daß nur die Zeilen von SOURCE_TAB nach RECORD_TAB übertragen werden, die diesen Einschränkungen genügen. Wenn Sie diese Einschränkungen selbst bereits beim Aufbau der SOURCE_TAB berücksichtigen, können Sie diesen Parameter initial lassen.
- Der Zeilentyp von SOURCE_TAB muß eine flache Struktur sein, d.h. eine Struktur, deren Komponenten alle einen elementaren Typ besitzen. Andernfalls wird eventuell die Ausnahme ILLEGAL_STRUCTURE ausgelöst.
- Die Versorgung des Parameters SOURCE_STRUCTURE ist nur nötig, wenn SOURCE_TAB selbst nicht mit der entsprechenden Struktur angelegt werden konnte, etwa weil sich die Struktur der zu selektierenden Daten erst dynamisch ergeben hat.
- Die Übertragung der Daten von den Feldern der Tabelle SOURCE_TAB in die namensgleichen Suchhilfeparameter erfolgt durch ein typgerechtes MOVE. Würde dieses zu einem abfangbaren Laufzeitfehler führen, so unterbleibt die Datenübertragung.
- Die Datenübertragung erfolgt nur für solche Parameter, die vom F4-Prozessor in RECORD_TAB auch verwaltet werden (siehe Funktionsbaustein F4UT_PARAMETER_ALLOCATE).
- Durch diesen Baustein wird die RECORD_TAB vollkommen neu geschrieben. Soll nur der Inhalt eines Parameters in der RECORD_TAB verändert werden, so sollte eventuell der Baustein F4UT_PARAMETER_RESULTS_PUT benutzt werden.
Weiterführende Informationen
Parameter
CALLCONTROLRECORD_TAB
SHLP
SHLP_TAB
Ausnahmen
Funktionsgruppe
/SAPLABU_NAMECHKrdisp/max_wprun_time - Maximum work process run time rdisp/max_wprun_time - Maximum work process run time
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 4698 Date: 20240523 Time: 175658 sap01-206 ( 93 ms )