Ansicht
Dokumentation

DGEXC_LB02_PARAM_VALUE_GET - Standard Suchhilfe-Exit zur Bestimmung des Inhalts eines Suchhilfeparam.

ROGBILLS - Synchronize billing plans   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Durch Aufruf dieses Bausteins in einem Suchhilfe-Exit kann man den derzeitigen Inhalt eines Suchhilfeparameters ermitteln. Dazu ist der Name des Parameters in PARAMETER zu übergeben.

Grundsätzlich ist hierbei zu unterscheiden, zwischen den Parameterinhalten, die in den Selektionsprozeß des Eingabehilfeablaufs eingehen, und den Parameterinhalten, die durch den Selektionsprozeß und die Benutzerauswahl ermittelt werden.

Parameterinhalte, die in den Selektionsprozeß eingehen, sind Defaults von Suchhilfeparametern, Werte, die über die Anbindung der Suchhilfe ans Dynpro aus den Feldinhalten des Dynpros oder seines Modulpools in den Eingabehilfeablauf eingehen, sowie die eventuell komplexen Abgrenzungen, die der Benutzer im Popup zur Werteeinschränkung vorgenommen hat. Schließlich können natürlich auch durch das Suchhilfe-Exit selbst solche Parameterinhalte in den Eingabehilfeablauf eingebracht werden.

Die in den Selektionsprozeß eingehenden Inhalte des spezifizierten Parameters befinden sich nach dem Aufruf als komplexe Abgrenzungen in SELOPT_TAB. Ist durch diese komplexen Abgrenzungen exakt ein Wert festgelegt (d.h. bestehen die Abgrenzungen aus genau einer Zeile und gilt bei dieser Zeile SIGN = 'I' und OPTION = 'EQ'), so ist dieser eindeutige Wert in VALUE zu finden.

Parameterinhalte, die durch Selektionsprozeß und Benutzerauswahl ermittelt werden, sind die Parameterinhalte, die auf dem Popup zur Anzeige der Treffermenge zur Anzeige gebracht werden, bzw. die auf das Dynpro zurückgestellt werden. Sie werden vom F4-Prozessor in RECORD_TAB verwaltet.

Dieser Baustein bietet nun die Möglichkeit, die Informationen zum spezifizierten Parameter aus RECORD_TAB in aufbereiteter Form nach RESULTS_TAB zu bringen.

Dabei ist dem Funktionsbaustein im Parameter FIELDNAME der Name des Feldes von RESULTS_TAB mitzugeben, das die Inhalte des Parameters erhalten soll. Ist der Zeilentyp von RESULTS_TAB elementar, so ist in FIELDNAME der Wert '*' zu übergeben. Der übrige Bereich von RESULTS_TAB wird nicht verändert. Die Übertragung erfolgt dabei zeilenweise. Dabei wird durch Entfernen von Zeilen am Ende bzw. durch Anfügen von initialen Zeilen zunächst dafür gesorgt, daß RESULTS_TAB genau soviele Zeilen hat wie RECORD_TAB.

Beispiel

Ein Beispiel für die zweite Art der Verwendung dieses Bausteins finden Sie im Suchhilfe-Exit SAPBC_GLOBAL_F4_SFLIGHT der Suchhilfe SFLIGHT.

Beide Arten der Verwendung finden Sie im Suchhilfe-Exit SAPBC_GLOBAL_F4_SFLIGHT_MIN_FR der Suchhilfe SFLIGHT_MIN_FREE.

Hinweise

1. Die Parameter OFF_RESULT und LEN_RESULT sollten nicht mehr verwendet werden, da sich grundsätzliche Probleme mit der Behandlung von UNICODE ergeben. Die Inhalte dieser Parameter werden aus Kompatibilitätsgründen weiter ausgewertet, wenn der Parameter FIELDNAME initial ist.
2. Komplexe Abgrenzungen für einen Parameter können im Normalfall nur aus dem Popup zur Werteeinschränkung resultieren.
3. Hat VALUE den Wert SPACE, so bedeutet dies entweder, daß für den Parameter komplexe Angrenzungen vorhanden sind, oder daß der eindeutige Inhalt gerade SPACE ist. Um dies zu unterscheiden, muß dann also SELOPT_TAB ausgewertet werden.
4. Besitzt die Suchhilfe gar keinen Parameter des vorgegebenen Namens, so wird die Ausnahme PARAMETER_UNKNOWN ausgelöst.
5. In RECORD_TAB werden zunächst nur Inhalte für die Parameter der Suchhilfe, die auf der Trefferliste angezeigt werden oder die EXPORT-Parameter der Suchhilfe sind, verwaltet. Hat der spezifizierte Parameter nicht eine dieser Eigenschaften und ist der Parameter RESULTS_TAB beim Aufruf genannt, so kann ebenfalls die Ausnahme PARAMETER_UNKNOWN ausgelöst werden. Das gilt allerdings nicht, wenn für den Parameter bereits mit Hilfe des Funktionsbausteins F4UT_PARAMETER_RESULTS_PUT Ergebisse eingetragen wurden, oder wenn mit Hilfe des Funktionsbausteins F4UT_PARAMETER_ALLOCATE Platz für den Parameter in RECORD_TAB reserviert wurde. Der Parameter sollte daher nur versorgt werden, wenn tatsächlich Information über den Parameterinhalt nach Selektionsprozeß bzw. Benutzerauswahl benötigt wird.
6. Die Übertragung des Parameterinhalts von RECORD_TAB nach RESULTS_TAB erfolgt auch für die Kopzeilen der beiden Tabellen.
7. Die übrigen Parameter dieses Bausteins müssen mit den gleichnamigen Parametern des Suchhilfe-Exits versorgt werden. Sie werden durch diesen Baustein aber nicht verändert.
8. RESULTS_TAB sollte eine Standardtabelle sein.
9. Die Übertragung der Inhalte des spezifizierten Parameters in RECORD_TAB in das spezifizierte Feld der Tabelle RESULTS_TAB erfolgt durch ein typgerechtes MOVE. Ist ein solches nicht möglich, so erhält das Zielfeld Initialwert.
10. Besitzt RESULTS_TAB kein Feld des durch FIELDNAME gegebenen Namens, so wird nur die Zeilenzahl von RESULTS_TAB wie beschrieben an die von RECORD_TAB angeglichen.

Weiterführende Informationen

Parameter

CALLCONTROL
FIELDNAME
LEN_RESULT
OFF_RESULT
PARAMETER
RECORD_TAB
RESULTS_TAB
SELOPT_TAB
SHLP
SHLP_TAB
VALUE

Ausnahmen

PARAMETER_UNKNOWN

Funktionsgruppe

DGEXC_LB02

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6881 Date: 20240523 Time: 122649     sap01-206 ( 138 ms )