Ansicht
Dokumentation

FC_SHLPEXIT_RCL_COITP - Standard Suchhilfe-Exit zur Simulation der Eingabehilfe einer Domäne

Fill RESBD Structure from EBP Component Structure   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Baustein kann als Suchhilfe-Exit einer elementaren Suchhilfe genutzt werden, die den Eingabehilfeablauf beschreibt, der durch eine Domäne beschrieben wird. Dieser Ablauf kann dabei durch die Attribute der Suchhilfe noch modifiziert werden. Um komplexere Modifikationen zu realisieren müssen Sie dabei eventuell einen eigenen Suchhilfe-Exit anlegen, in dem dieser Baustein aufgerufen wird.

Der Eingabehilfeablauf einer Domäne wird definiert durch ihre Festwerte und ihren Datentyp. Besitzt die Domäne Festwerte, so werden diese von der Eingabehilfe mit ihren eventuell vorhandenen Kurzbeschreibungen angezeigt. Sonst ist der Domäne nur dann eine Eingabehilfe zugeordnet, wenn sie vom Datentyp DATS oder TIMS ist. Für diese Datentypen stehen standardisierte Eingabehilfen zur Verfügung.

Zur Steuerung des Eingabehilfeablaufs kann die elementare Suchhilfe bis zu drei Parameter besitzen, die die Namen DOMNAME, VALUE und TEXT haben müssen. Es muß mindestens einer der beiden Parameter VALUE und TEXT existieren und auch EXPORT-Parameter sein.

Der Parameter DOMNAME kann benutzt werden, um den Namen der betroffenen Domäne festzulegen. Wird dieser Baustein in einem Suchhilfe-Exit aufgerufen, so kann ihm der Name der Domäne auch über seinen IMPORTING-Parameter DOMNAME mitgeteilt werden. Falls beide Mechanismen nicht genutzt werden, so wird automatisch die Domäne des Datenelements genutzt, das dem Parameter VALUE zugeordnet wurde. Falls der Parameter VALUE auch nicht definiert wurde, oder falls die ermittelte Domäne keine Eingabehilfe besitzt, so wird die Ausnahme NO_F4_HLP zusammen mit einer geeigneten Nachricht ausgelöst.

Im Parameter VALUE werden die eigentlichen durch die Domäne definierten Werte behandelt. Im Parameter TEXT werden die Festwerttexte zu diesen Werten behandelt. Dieser Parameter ist daher für die standardisierten Eingabehilfen zu den Datentypen DATS und TIMS bedeutungslos.

Wenn Sie die Liste der Festwerte (einschließlich ihrer Texte) noch modifizieren wollen, so rufen Sie diesen Baustein in einem eigenen Suchhilfe-Exit zweimal auf, wobei Sie beim Aufruf DD07V_TAB jeweils nennen. Zwischen den Aufrufen können Sie durch Modifikation an DD07V_TAB dann noch Einfluß auf die Festwertliste nehmen. Andernfalls sollten Sie DD07V_TAB beim Aufruf unversorgt lassen.

Beispiel

Mit Hilfe dieses Bausteins können Sie eine Suchhilfe anlegen, die nur die Festwerttexte zu einer Domäne anzeigt. Definieren Sie den Parameter VALUE dazu als einen nicht auf der Trefferliste erscheinenden.

Hinweise

Wenn wie im Beispiel formuliert nur die Festwerttexte angezeigt werden sollen, so sollen oft auf dem Dynpro auch nur diese angezeigt werden. Für die interne Programmlogik ist es aber meistens notwendig, den eigentlichen Festwert zu kennen. Daher sollte die Suchhilfe VALUE auch in diesem Fall als EXPORT-Parameter haben. Die Anbindung der Suchhilfe geschieht dann zwar über den Parameter TEXT, aber auch dem Parameter VALUE sollte ein entsprechendes Feld des Dynpro zugeordnet sein, das gegebenenfalls unsichtbar sein sollte (es reicht nicht, wenn das Feld nur im Modulpool des Dynpros bekannt ist, da dorthin keine Werte vom F4-Prozessor zurückgestellt werden können). Um zu verhindern, daß der Festwerttext vom Benutzer direkt in das Feld eingetragen wird, wird das entsprechende Textfeld oftmals als nicht eingabebereit definiert. Das wird allerdings vom F4-Prozessor im Normalfall so gedeutet, daß die Treffer nur angezeigt werden sollen, aber keine Rückstellung möglich ist. Wenn Sie dies umgehen wollen, sollten Sie einen eigenen Suchhilfe-Exit schreiben, indem Sie vor dem Aufruf dieses Bausteins noch die Zeilen:

DATA interface_wa LIKE DDSHIFACE.
MODIFY SHLP-INTERFACE FROM interface_wa TRANSPORTING DISPFIELD
WHERE F4FIELD = 'X'.

ausführen.

Ist in den Festwerten zur Domäne mindestens ein Intervall enthalten, so werden die Festwerte auf jeden Fall angezeigt, auch wenn die Suchhilfe keinen Parameter VALUE besitzt.

Weiterführende Informationen

Parameter

CALLCONTROL
DD07V_TAB
DOMNAME
RECORD_TAB
SHLP
SHLP_TAB

Ausnahmen

NO_F4_HLP

Funktionsgruppe

FC00

CPI1466 during Backup   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5416 Date: 20240523 Time: 122716     sap01-206 ( 127 ms )