Ansicht
Dokumentation

/PM0/ABU_NAMECHK_SHLP - Standard Suchhilfe-Exit zum Füllen der Trefferliste

ROGBILLS - Synchronize billing plans   TXBHW - Original Tax Base Amount in Local Currency  
Diese 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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.
6. Die Datenübertragung erfolgt nur für solche Parameter, die vom F4-Prozessor in RECORD_TAB auch verwaltet werden (siehe Funktionsbaustein F4UT_PARAMETER_ALLOCATE).
7. 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

CALLCONTROL
RECORD_TAB
SHLP
SHLP_TAB

Ausnahmen

Funktionsgruppe

/SAPLABU_NAMECHK

rdisp/max_wprun_time - Maximum work process run time   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4698 Date: 20240426 Time: 235449     sap01-206 ( 92 ms )