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 müssen (Selektionsmethode)
Welche erweiterten Optionen für die die Suchmethode angeboten werden sollten (Suche mit Vorschlagsfunktion (Type-Ahead) und Volltextsuche)
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, wird dies bei der Datenselektion zur Formulierung einer WHERE-Bedingung für das Feld der Selektionsmethode mit gleichem Namen verwendet. Umgekehrt werden die Parameter der Suchhilfe den Inhalten der namensgleichen Felder der Selektionsmethode zugeordnet.

Achtung

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:

Importparameter:
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.

Hinweis
Ein Parameter kann gleichzeitig Import- und Exportparameter 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 Importparameter der Suchhilfe ihre Werte beziehen und in welche Felder die Inhalte der Exportparameter 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.

Erweiterte Funktionen der Suchhilfe

Sie können die Funktionen eines Suchhilfeobjekts für die Anzeige möglicher Suchergebnisse und weiterer Werte bereits während der Eingabe in eine Dropdown-Box unterhalb des Suchfelds erweitern. Damit wird der Benutzer in seiner Suche nach dem gewünschten Eintrag unterstützt. Zusätzlich können Sie einen fehlertoleranten Wert für die Fuzzy-Suche definieren, um die Abweichung der relevanten Ergebnisse zu bestimmen.

Hinweis

In Transaktion SDSH_CONFIG können Sie die erweiterten Optionen systemweit durch das Entmarkieren der Option “Vorschlagssuche auf Eingabefeldern verwenden” deaktivieren. Beachten Sie, dass für diesen Zweck die Standardberechtigung 02 ('ändern') des Berechtigungsobjekts S_DEVELOP erforderlich ist.

Eingabefelder, die über eine Suchhilfe mit ihnen zugewiesenen aktivierten erweiterten Optionen verfügen, werden mit dem Symbol einer Lupe gekennzeichnet.

Eingabefeld, das die erweiterten Optionen unterstützt

Suchmethoden

In Transaktion SE11 können Sie die erweiterten Optionen für jede elementare Suchhilfe auswählen. Abhängig von den gewählten erweiterten Optionen und den Fähigkeiten der Datenbank werden die folgenden Suchmethoden angeboten:

Suche mit Vorschlagsfunktion (Type-Ahead): Für Eingabefelder, die diese Suchhilfe verwenden, kann die Vorschlagssuche aktiviert werden, das heißt, es wird ein Lupensymbol angezeigt. Der Suchbegriff des Benutzers wird automatisch vervollständigt und / oder mögliche Vorschläge des Suchergebnisses werden in einer Dropdown-Box angezeigt. In dieser Dropdown-Box können Sie die übereinstimmenden Datenbankeinträge bereits während der Eingabe auswählen, ohne dass Sie die traditionelle F4-Hilfe aufrufen müssen. Diese Funktion verwendet die standardmäßige musterbasierte Logik der Suchhilfe-Infrastruktur und ist deswegen auf allen Datenbanken verfügbar.
Volltextsuche: Wenn die Option “Mehrspaltige Volltextsuche” aktiviert ist und vom entsprechenden Datenbanksystem unterstützt wird, wird eine Volltextsuche auch auf den Selektionsmethoden durchgeführt. Im Gegensatz zur musterbasierten Logik sucht das System nach dem Suchbegriff in allen Spalten, die als suchbar gekennzeichnet sind. Die Volltextsuche kann in einer fehlertoleranten Weise durchgeführt werden (in der unten stehenden Tabelle finden Sie die Details).

Voraussetzungen

Sie müssen für die Bereitstellung einer erweiterten Suchhilfe die folgenden Voraussetzungen erfüllen:

SAP GUI Version 7.30 für Windows Patch-Level 5; empfohlen wird Patch-Level 6
SAP NetWeaver 7.4 SP06
Die Fuzzy-Suche wird zurzeit nur von der SAP HANA-Datenbank auf ABAP-Systemen unterstützt.

Einschränkungen

Die Suche mit Vorschlagsfunktion und Volltextsuche werden zurzeit nur für SAP-GUI-Bildschirme auf Windows unterstützt. Andere UI-Technologien wie Web Dynpro werden zurzeit nicht unterstützt. Weitere Informationen finden Sie im SAP-Hinweis 1861491.

Erweiterte Optionen

Die folgenden erweiterten Optionen werden angeboten:

Tabelle 1:
Option	Relevante Suchmethode	Beschreibung
Vorschlagssuche für Eingabefelder	Suche mit Vorschlagsfunktion (Type-Ahead):	Diese Option gibt an, dass ein Suchhilfeobjekt eine Suche mit Vorschlagsfunktion durchführen kann. Die Suchergebnisse werden in einer Liste angezeigt, die auf der Grundlage der modellierten LPos-Parameter generiert werden. Die Werte der Parameter, die zum Eingabefeld gehören, werden immer unabhängig vom LPos-Wert in der ersten Spalte der Dropdown-Box angezeigt. Alle anderen Parameter wenden anschließend gemäß ihres LPos-Wertes angezeigt. Hinweis Wenn nur dieses Feld gesetzt ist oder wenn die Option "Mehrspaltige Volltextsuche" nicht von der vom System verwendeten Datenbank unterstützt wird, wird die Suche nur in der Spalte der Datenbank ausgeführt, die zum Feld oder dem zugeordneten Suchhilfeparameter gehört. Zusätzliche Selektionsbedingungen für andere Spalten der Tabelle(n) oder Sicht werden nur in den folgenden Fällen berücksichtigt: Wenn diese Selektionsbedingungen als Importparameter in der Suchhilfe modelliert sind. Wenn Werte in der Benutzeroberfläche oder als Standardwerte in der Suchhilfe abgelegt werden und wenn sie an die Importparameter angepasst werden können. In der Dropdown-Box eines Eintrags oder Suchfelds werden standardmäßig zehn Suchergebnisse angezeigt. Vor dem Aktivieren dieser Option für Suchhilfeobjekte, die Exits mit komplexen Selektionsbedingungen enthalten oder lange laufende Operationen implementieren, sollten Sie das Laufzeitverhalten dieses Suchhilfeobjekts testen. Sie müssen außerdem sicherstellen, dass ein bestehender Suchhilfe-Exit keine SAP-GUI-spezifische Logik selbst aufruft (beispielsweise eigene Dialoge).
Mehrspaltige Volltextsuche (datenbankspezifisch)	Volltextsuche	Das System führt zusätzlich zu der standardmäßigen musterbasierten Suche eine mehrspaltige Volltextsuche durch. Ergebnisse der beiden Suchvorgänge werden kombiniert und in der Reihenfolge ihrer Relevanz bezüglich der Suchanfrage zurückgegeben. Hinweis Sie können diese Option nur wählen, wenn die Option “Vorschlagssuche für Eingabefelder” bereits gewählt ist und die Volltextsuche von der oder den Selektionsmethoden unterstützt wird. Dies gilt für Tabellen, Texttabellen wie auch für Standardsichten und Projektions-Views. Andere Varianten werden nicht unterstüzt. Die entsprechenden Spalten müssen als `IMPORT`- oder `SPos`-Parameter gekennzeichnet werden.
Genauigkeitswert für fehlertolerante Volltextsuche	Fuzzy-Suche	Der fehlertolerante Wert legt die Variationsbandbreite der angezeigten Suchergebnisse fest. Auf diese Weise können auch Ergebnisse mit Rechtschreibfehlern berücksichtigt werden. Hinweis Dieser Wert liegt zwischen 0 und 1. Der Wert 0 bedeutet, dass die Suchanfrage und das Suchergebnis keine Gemeinsamkeit aufweisen. 1 bedeutet, dass eine vollständige Übereinstimmung vorliegt. Je niedriger der Wert also ist, desto mehr Variationen werden angezeigt. Der fehlertolerante Wert kann nur für die mehrspaltige Volltextsuche verwendet werden.

Siehe auch:

Elementare Suchhilfen anlegen

Beispiel zu Suchhilfen