Ansicht
Dokumentation

CACS_VERS_F4 - Suchhilfe-Exit für versionsgeführte Tabellen mit CS-Zeitraumführung

Vendor Master (General Section)   General Data in Customer Master  
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 ein eigenes 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

Bei einem Feld, in dem Flugklassen eingetragen werden können, soll die Festwerthilfe der Domäne S_CLASS angezeigt werden. Hierbei soll allerdings die erste Klasse (Festwert 'F') nicht angeboten werden.
Die gewünschte Eingabehilfe können Sie über eine elementare Suchhilfe realisieren. Diese Suchhilfe sollte zwei EXPORT-Parameter besitzen, die die Namen VALUE und TEXT haben müssen. Dem Parameter VALUE muß ein Datenelement zugeordnet sein, das auf die Domäne S_CLASS zeigt (vorzugsweise das, das auch das Feld auf der Eingabemaske typisiert). Dem Parameter TEXT sollten Sie das Datenelement VAL_TEXT zuordnen. Weiterhin sollten Sie den Parametern VALUE und TEXT die Positionen 1 und 2 auf der Trefferliste zuordnen. Schließlich müssen Sie der Suchhilfe ein Suchhilfe-Exit zuordnen, das den folgenden Quelltext enthält:

DATA DD07V_tab TYPE STANDARD TABLE OF DD07V.
CHECK CALLCONTROL-STEP = 'SELECT'.
CALL FUNCTION 'F4UT_DOMAHLP_EXECUTE'
TABLES
SHLP_TAB = SHLP_TAB
RECORD_TAB = RECORD_TAB
DD07V_TAB = DD07V_tab
CHANGING
SHLP = SHLP
CALLCONTROL = CALLCONTROL.
DELETE DD07V_tab WHERE DOMVALUE_L = 'F'.
CALL FUNCTION 'F4UT_DOMAHLP_EXECUTE'
TABLES
SHLP_TAB = SHLP_TAB
RECORD_TAB = RECORD_TAB
DD07V_TAB = DD07V_tab
CHANGING
SHLP = SHLP
CALLCONTROL = CALLCONTROL.

Die so definierte Suchhilfe müssen Sie dann noch an das Bildschirmfeld anbinden, wobei dem Bildschirmfeld der Parameter VALUE zugeordnet werden sollte (der daher auch IMPORT-Parameter sein sollte).

Hinweise

1. Die in obigem Beispiel vorgenommenen Definitionen führen nicht dazu, daß der Wert 'F' auch von der Eingabeprüfung des entsprechenden Feldes zurückgewiesen wird. Eine solche Prüfung müssen Sie gegebenenfalls selbst in der Ablauflogik des entsprechenden Dynpros hinterlegen. Wird das Eingabefeld auf der Maske allerdings als Listbox dargestellt, so kann der Benutzer automatisch nur aus der Menge der Werte auswählen, die durch die Eingabehilfe angeboten werden.
2. Sie können das obige Beispiel auch so erweitern, daß die vorgenommene Einschränkung der Festwerte nur dann vorgenommen wird, wenn ein anderes Feld (z.B. 'Fluggesellschaft') einen bestimmten Inhalt hat (z.B. 'LH'). Hierzu müssen Sie die Suchhilfe um einen weiteren IMPORT-Parameter 'Fluggesellschaft' erweitern, den Sie bei der Anbindung mit dem entsprechenden Bildschirmfeld verbinden müssen.
   Mit Hilfe des Funktionsbausteins F4UT_PARAMETER_VALUE_GET können Sie dann im Suchhilfe-Exit die vom Benutzer eingegebene Fluggesellschaft bestimmen. Schließlich können Sie die oben durchgeführte Löschung aus DD07V_tab abhängig von dem so bestimmten Wert machen.
3. Dieser Baustein kann auch genutzt werden, um in einer Eingabehilfe nur die Festwerttexte zu einem Feld zu zeigen und die eigentlichen Festwerte zu unterdrücken. Im allgemeinen ist es für diese Zwecke aber günstiger, das entsprechende Eingabefeld als Listbox darzustellen.

Weiterführende Informationen

Parameter

CALLCONTROL
RECORD_TAB
SHLP
SHLP_TAB

Ausnahmen

Funktionsgruppe

CACS_VERS

BAL_S_LOG - Application Log: Log header data   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7094 Date: 20240523 Time: 095505     sap01-206 ( 155 ms )