Elementare Suchhilfen 

Verwendung

Eine elementare Suchhilfe definiert den Standardablauf einer Eingabehilfe. In der Suchhilfe können folgende Bestandteile dieses Ablaufs bestimmt werden:

●      woher die in der Trefferliste angezeigten Daten stammen (Selektionsmethode)

●      welche Informationen auf dem Dialogfenster zur Werteselektion und auf der Trefferliste angezeigt werden müssen (Suchhilfeparameter)

●      welche Feldinhalte für die Selektion der Trefferliste berücksichtigt werden können und welche Werte aus der Trefferliste in Dynpro-Felder zurückgestellt werden können (Suchhilfeparameter)

●      welche Dialogschritte bei der Eingabehilfe ausgeführt werden müssen (Dialogverhalten)

Funktionsumfang

Selektionsmethode

Die auf der Trefferliste angezeigten möglichen Eingabewerte für ein Feld werden zur Laufzeit durch eine Selektion von der Datenbank ermittelt. Die folgende Abbildung zeigt eine einfache Darstellung der Datenbankselektion.

Stammen alle auf der Trefferliste benötigten Daten aus einer einzigen Tabelle, genügt es diese Tabelle (oder eine Projektions-View dieser Tabelle) als Selektionsmethode zu wählen. Falls eine Texttabelle zur Tabelle existiert, stehen die Felder dieser Texttabelle bei der Eingabehilfe ebenfalls zur Verfügung. Ein Tabelleneintrag wird über den vorhandenen Fremdschlüssel mit dem zugehörigen Text verknüpft.

Falls die auf der Trefferliste benötigten Daten aus mehreren Tabellen stammen, müssen diese Tabellen über eine View (Datenbank-View oder Help-View) verknüpft werden. Sie müssen diese View als Selektionsmethode definieren.

Sind die zugrunde liegenden Tabellen mandantenabhängig, muss das Mandantenfeld in der View enthalten sein. Andernfalls wäre die Auswahl der Eingabehilfe für alle Mandanten gültig.

Suchhilfeparameter

Eine Suchhilfe besitzt eine Schnittstelle aus Parametern. Über diese Parameter wird festgelegt, welche Felder der Selektionsmethode in der Eingabehilfe verwendet werden.

Jedem Feld auf dem Dialogfenster zur Werteselektion und jedem Feld auf der Trefferliste muss ein Parameter der Suchhilfe entsprechen. Die Parameter werden aus der zugehörigen Selektionsmethode übernommen, d.h. sie haben den gleichen Namen wie das entsprechende Feld der Selektionsmethode.

Wird die Suche über einen Parameter der Suchhilfe eingeschränkt, so wird dies bei der Datenselektion zur Formulierung einer WHERE-Bedingung für das Feld der Selektionsmethode mit gleichem Namen genutzt. Umgekehrt werden die Parameter der Suchhilfe den Inhalten der namensgleichen Felder der Selektionsmethode zugeordnet.

Die Suchhilfe darf keinen Parameter für den Mandanten enthalten.

Ist die zugrunde liegende Tabelle mandantenabhängig, wählt das System automatisch nur die Werte für die Eingabehilfe aus, die zu dem aktuellen Mandanten gehören.

Ein Datenelement muss jedem Suchhilfeparameter zugeordnet sein. D. h., für die Suchhilfeparameter muss ein Typ definiert werden.

Eine Suchhilfe kann noch weitere Parameter enthalten, die keinem Feld der Selektionsmethode entsprechen. Dies ist aber nur dann notwendig, wenn der durch die Suchhilfe beschriebene Standardablauf der Eingabehilfe noch über ein Suchhilfe-Exit modifiziert werden muss.

Import- und Export-Parameter

Beim Aufruf einer Eingabehilfe werden die von Ihnen auf der Eingabemaske bereits vorgenommenen Eingaben berücksichtigt. Wenn Sie beispielsweise die Eingabehilfe für Flugnummern aufrufen und die Fluggesellschaft bereits angegeben haben, werden nur die Nummern zu Flügen dieser Fluggesellschaft angeboten.

Wenn Sie umgekehrt eine Zeile der Trefferliste auswählen, so müssen mehrere Felder der Eingabemaske mit Daten aus der gewählten Zeile der Trefferliste gefüllt werden. Wird beispielsweise die Flugnummer aus der Trefferliste übernommen, so müssen auch gleich der Abflugort und der Ankunftsort in die Bildschirmmaske zurückgestellt werden. Die folgende Abbildung schildert dies anhand eines Beispiels.

Über die Schnittstelle einer Suchhilfe wird festgelegt, welche Kontextdaten in die Eingabehilfe eingehen können und welche Daten auf die Eingabemaske zurückgestellt werden können.

Ein Parameter einer Suchhilfe kann klassifiziert werden als:

●      Import-Parameter

Parameter, über den Kontextinformationen aus der verarbeiteten Eingabemaske (Dynpro) in den Hilfeablauf übernommen werden.

●      Export-Parameter

Parameter, über den Werte aus der Trefferliste auf die Eingabemaske zurückgestellt werden dürfen.

Ein Parameter kann gleichzeitig Import- und Export-Parameter sein. Eine Suchhilfe kann auch Parameter enthalten, die weder Import- noch Export-Parameter sind. Solche Parameter können z.B. für den internen Ablauf der Eingabehilfe benötigt werden.

Bei der Suchilfeanbindung wird festgelegt, woher die Import-Parameter der Suchhilfe ihre Werte beziehen und in welche Felder die Inhalte der Export-Parameter zurückgestellt werden. Weitere Informationen finden Sie unter Wertetransport bei der Eingabehilfe.

Beschreibung des Dialogverhaltens

Das Dialogverhalten bestimmt, welche Dialogschritte beim Ablauf der Eingabehilfe durchlaufen werden und wie die Trefferliste und das Dialogfenster zur Werteselektion aufgebaut sind.

Der Dialogtyp entscheidet, ob das Dialogfenster zur Werteselektion angezeigt werden soll oder nicht. Wenn Sie das Dialogfenster zur Werteselektion überspringen möchten, wird die Trefferliste direkt nach Aufruf der Eingabehilfe angezeigt.

Bei der Definition einer elementaren Suchhilfe können Sie auch das Aussehen des Dialogfensters zur Werteselektion und der Trefferliste gestalten. Hier können Sie z.B. die Position eines Parameters in dem Dialogfenster zur Werteselektion bestimmen. Auch die Spaltenposition, in der die Werte eines Parameters auf der Trefferliste angezeigt werden sollen, kann hier festgelegt werden.

Siehe auch:

Anlegen einer elementaren Suchhilfe

Beispiel zu Suchhilfen