Suchhilfe-Exit 
Suchhilfe-Exit
Eine Suchhilfe beschreibt einen Standardablauf einer Eingabehilfe für ein Feld. Die spezielle Semantik des Feldes kann es erforderlich machen, von diesem Standard in einigen Punkten abzuweichen. Eine solche Abweichung vom Standard kann über ein Suchhilfe-Exit realisiert werden.
Der Ablauf der Eingabehilfe sollte sich dem Endbenutzer systemweit möglichst eindeutig präsentieren. Deshalb sollten Suchhilfe-Exits nur in Ausnahmefällen verwendet werden!
Ein Suchhilfe-Exit ist ein Funktionsbaustein, der eine vordefinierte Schnittstelle besitzt. Ein Suchhilfe-Exit wird vom Hilfeprozessor zu festgesetzten Zeitpunkten aufgerufen. Über die Schnittstelle werden dem Suchhilfe-Exit dabei die Verwaltungsdaten des Hilfeprozessors übergeben.
Im Suchhilfe-Exit kann eigene Programmlogik hinterlegt werden, die diese Verwaltungsdaten manipuliert. Über ein Suchhilfe-Exit können auch einzelne Schritte des Ablaufs der Eingabehilfe übersprungen werden.
Jedes Suchhilfe-Exit muß die gleiche Schnittstelle wie der Funktionsbaustein F4IF_SHLP_EXIT_EXAMPLE (dient als Muster für alle anzulegenden Suchhilfe-Exits) besitzen. Genauere Informationen zur Schnittstelle können Sie der Dokumentation dieses Funktionsbausteins entnehmen.
Aufruf des Suchhilfe-Exits
Ist einer Suchhilfe ein Suchhilfe-Exit zugeordnet, so wird dieses zu fünf Zeitpunkten vom Hilfeprozessor aufgerufen:
Vor der Anzeige des Dialogfensters zur Auswahl des gewünschten Suchpfades.
Der Aufruf erfolgt nur für Sammelsuchhilfen. Über das Suchhilfe-Exit kann hier z.B. die Menge der zur Verfügung stehenden elementaren Suchhilfen kontextsensitiv eingeschränkt werden.
Vor der Anzeige des Dialogfensters zur Eingabe der Suchbedingungen.
Hier kann der Dialog zur Eingabe der Suchbedingungen entweder beeinflußt oder ganz übersprungen werden. Es ist auch möglich das Aussehen des Selektionsbildes zu beeinflussen.
Vor der Datenselektion.
Die Datenselektion kann teilweise oder vollständig vom Suchhilfe-Exit übernommen werden. Dies kann notwendig sein, falls die Datenselektion nicht über ein SELECT-Statement auf eine Tabelle oder einen View realisiert werden kann.
Vor der Anzeige der Trefferliste.
Die Anzeige der Trefferliste kann in diesem Schritt durch den Suchhilfe-Exit beeinflußt werden. Hier kann die Menge der angezeigten Werte reduziert werden. Beispielsweise können nur die Werte angezeigt werden, für die der Aufrufer der Eingabehilfe eine Berechtigung besitzt. Die Anzeige der Trefferliste kann aber auch vollständig vom Suchhilfe-Exit übernommen werden.
Vor dem Zurückstellen der vom Benutzer gewählten Werte in die Eingabemaske.
Ein Eingriff zu diesem Zeitpunkt kann sinnvoll sein, wenn die Steuerung des weiteren Ablaufs der Transaktion vom gewählten Wert abhängig gemacht werden soll. Ein typisches Beispiel ist das Setzen von Set-/Get-Parametern.
