Show TOC Anfang des Inhaltsbereichs

Objektdokumentation Suchhilfen  Dokument im Navigationsbaum lokalisieren

Definition

Suchhilfen sind Objekte, die Sie verwenden können, um Dynpro-Feldern eine Eingabehilfe (F4-Hilfe) zuzuordnen. Hierzu müssen Sie im ABAP Dictionary eine Suchhilfe anlegen und diese dann an das entsprechende Dynpro-Feld anbinden.

Verwendung

Die Eingabehilfe (F4-Hilfe) ist eine Standardfunktion des SAP-Systems. Über die Eingabehilfe können Sie sich die Liste aller möglichen Eingabewerte für ein Dynpro-Feld anzeigen lassen. Sie können die möglichen Eingabewerte mit zusätzlichen Informationen erweitern. Dies ist insbesondere dann sinnvoll, wenn das Feld die Eingabe eines formalen Schlüssels erfordert.

Um den Funktionsumfang der Suchhilfen genau zu verstehen, müssen Sie den Standardablauf für Eingabehilfen kennen.

Standardablauf einer Eingabehilfe

Sie können eine Eingabehilfe über die folgenden Schritte aufrufen (je nach Gestaltung der Eingabehilfe können einzelne Schritte entfallen):

       1.      Sie starten die Eingabehilfe, um sich mögliche Eingabewerte für ein Feld (Suchfeld) auf einer Bildschirmmaske anzeigen zu lassen.

       2.      Das System bietet Ihnen eine Reihe von möglichen Suchpfaden an. Sie müssen einen davon auswählen. Jeder Suchpfad bietet eine Reihe von Einschränkungen, um die Menge der möglichen Eingabewerte einzugrenzen. Diese werden nach Auswahl des Suchpfads auf einem Dialogfenster zur Werteselektion angeboten.

       3.      Geben Sie ggf. die einschränkenden Bedingungen ein und starten Sie die Suche.

Die folgende Abbildung zeigt ein Beispiel, in dem die ersten drei Schritte erklärt werden.

Diese Grafik wird im zugehörigen Text erklärt

       4.      Das System ermittelt die auf die eingegebenen Einschränkungen passenden Werte (Treffermenge) und zeigt diese als Liste (Trefferliste) an.

Die folgende Abbildung erklärt Schritt 4 und 5.

Diese Grafik wird im zugehörigen Text erklärt

       5.      Wählen Sie die passende Zeile der Trefferliste mit einem Doppelklick aus.

       6.      Der Wert des Suchfeldes wird (evtl. zusammen mit anderen Werten) in die Bildschirmmaske zurückgestellt.

Hinweis

Schritt 2 entfällt, falls nur ein einziger Suchpfad zur Verfügung steht. In diesem Fall wird direkt das Dialogfenster zur Werteselektion angeboten. Es ist auch möglich direkt nach dem Starten der Eingabehilfe die Liste der Treffer auszugeben. In diesem Fall entfallen die Schritte 3 und 4.

Funktion einer Suchhilfe

Dieser Standardablauf kann durch Anlegen einer Suchhilfe im ABAP Dictionary vollständig gestaltet werden. Diese Suchhilfe muss nur dem Dynpro-Feld zugeordnet werden, in dem es verfügbar sein muss. (Weitere Informationen finden Sie unter Anbindung einer Suchhilfe an ein Dynpro-Feld.)

Es gibt zwei Arten von Suchhilfen:

      Elementare Suchhilfen

Elementare Suchhilfen beschreiben einen Suchpfad. Sie müssen Folgendes festlegen:

       Woher die Daten der Trefferliste gelesen werden (die Selektionsmethode)

       Wie der Austausch von Werten zwischen der Bildschirmmaske und der Selektionsmethode umgesetzt wird (die Schnittstelle der Suchhilfe)

       Wie der Dialog der Eingabehilfe gestaltet sein muss (Dialogverhalten der Suchhilfe).

      Sammelsuchhilfen

Sammelsuchhilfen fassen mehrere elementare Suchhilfen zusammen. Über eine Sammelsuchhilfe können also mehrere alternative Suchpfade zur Verfügung gestellt werden.

Verwendung von Suchhilfen im Web Dynpro ABAP

Sie können Suchhilfen aus dem ABAP Dictionary in Web Dynpro for ABAP verwenden. Weitere Informationen finden Sie im Abschnitt ABAP-Dictionary Suchhilfen.

Siehe auch:

Beispiel zu Suchhilfen

Elementare Suchhilfen anlegen

Sammelsuchhilfen anlegen

 

 

 

Ende des Inhaltsbereichs