Vorschlagswerte für InputFields 
Für Benutzer, die die möglichen Werte für InputFields nicht kennen, können Eingabehilfen, in denen eine Auswahl über Suchkriterien getroffen werden kann, angeboten werden.
Die Eingabehilfen werden traditionell in Form von Popups dargestellt. Eine einfachere Benutzerführung für die Auswahl eines Wertes steht in Form einer Vorschlagswerteliste zur Verfügung.
Die Vorschlagswerteliste wird vom SAP-System zur Verfügung gestellt: Einerseits können dies Eingaben sein, die der Benutzer bereits früher in dieses InputField eingegeben hat (die sogenannte Historie), andererseits versucht das SAP-System anhand einer Suchhilfe passende Werte zu finden. Die Vorschlagswerteliste wird angezeigt, sobald der Benutzer ein oder mehrere Zeichen in ein InputField eingegeben hat.
Wenn Sie den Wert A in ein InputField für beispielsweise Abflugorte eingeben, wird eine DropDown-Liste angezeigt, die alle Abflugorte auflistet, die mit 'A' beginnen. Die Werte aus der Historie werden im oberen Teil der DropDown-Liste angezeigt. Die Werte, die das SAP-System anhand einer Suchhilfe findet, werden im unteren Teil der DropDown-Liste angezeigt (siehe Grafik).
(Vorschlagswerteliste)
Die Vorschlagswerteliste beinhaltet insgesamt maximal 10 Werte, unabhängig davon, wieviele Werte sich in Ihrer Historie befinden und in der Trefferliste der Eingabehilfe vorhanden sind. Gibt es noch mehr Werte in der Trefferliste, können Sie sich diese anzeigen lassen, indem Sie die F4–Taste betätigen oder auf den unter der Trefferliste angezeigten Link klicken.
Hinweis
Für das passwordField gibt es keine Eingabe-Historie und keine Vorschlagswerte.
Contextmenü-Einträge für die Eingabefeld-Historie
Mit dem Befehl Eingabe-Historie für Benutzer <User> löschen wird die gesamte Feldhistorie des Benutzers <User> gelöscht. Dieser Befehl steht jedoch nur zur Verfügung, wenn die Feldhistorie für die Anwendung eingeschaltet ist (siehe Anwendungsparameter WDENABLEFIELDHISTORY).
Mit dem Befehl Historie für Eingabefeld „<Label>“ im Untermenü Benutzer-Einstellungen eines InputFields kann die Feldhistorie ein- bzw. ausgeschaltet werden.
Dieser Befehl steht nur zur Verfügung, wenn folgende Bedingungen erfüllt sind:
Die Feldhistorie ist für die Anwendung eingeschaltet (siehe Anwendungsparameter WDENABLEFIELDHISTORY).
Eine Feldhistorie ist für dieses InputField erlaubt. Die Feldhistorie für ein InputField ist nicht erlaubt, wenn die Eigenschaft NoHistory am InputField-UI Control gesetzt ist oder der Typ des InputFields aus dem ABAP-Dictionary stammt und dort das NoHistory- Flag gesetzt ist.
Hinweis
Mit der Eigenschaft NoHistory im InputField kann die Feldhistorie für dieses InputField abgeschaltet werden. Die NoHistory-Information eines Datenelements aus dem ABAP-Dictionary kann hiermit nicht übersteuert werden. Das heißt, wenn am Datenelement die Eigenschaft NoHistory gesetzt ist, kann dies am InputField nicht zurückgenommen werden.
Notwendige Einstellungen
Die Vorschlagswerteliste für ein InputField steht zur Verfügung, wenn folgende Bedingungen erfüllt sind:
Die Eigenschaft valueSuggest des InputFields ist gesetzt.
Die Eigenschaft value des InputFields muss an ein Context-Attribut gebunden sein für das eine ABAP-Dictionary-Wertehilfe oder eine Wertemenge (ValueSet) zur Verfügung steht.
Der Applikationsparameter WDALLOWVALUESUGGEST ist für Ihr System oder Ihre Anwendung gesetzt.
Der Modus für die Barrierefreiheit ist deaktiviert. Das heißt, dass im barrierefreien Modus keine Vorschlagswerte zur Verfügung stehen.
Die Historie steht zur Verfügung, wenn folgende Bedingungen erfüllt sind:
Der Applikationsparameter WDENABLEFIELDHISTORY ist für Ihr System oder Ihre Anwendung gesetzt.
Der Modus für die Barrierefreiheit ist deaktiviert.
Hinweise zur Verwendung
Die Auswahl eines Eintrags der Vorschlagswerteliste eines InputFields bezieht sich lediglich auf dieses eine InputField. Andere InputFields werden nicht aktualisiert, selbst wenn sie mit einer ABAP-Dictionary-Suchhilfe über Output-Parameter verbunden sind.
Beachten Sie, dass nicht alle ABAP-Dictionary-Suchhilfen für die Vorschlagswerte geeignet sind. Bei komplexen ABAP-Dictionary-Suchhilfen können die Vorschlagswerte unübersichtlich werden:
Wenn beispielsweise die Schlüsselspalte der Vorschlagswerteliste kein Schlüsselfeld der darunterliegenden Datenbanktabelle ist, ist die Suchhilfe hier nicht geeignet. In diesem Fall können mehrere Einträge für die Schlüsselspalte der Vorschlagswerteliste auftreten. Das Web-Dynpro-ABAP-Framework wählt lediglich einen Eintrag für die Vorschlagswerteliste aus.
Konkretes Beispiel:
Sie verwenden eine ABAP-Dictionary-Suchhilfe mit zwei Feldern für Mitarbeiter und Wohnort. Die Suchhilfe basiert auf einer Datenbanktabelle, in der alle Mitarbeiter mit ihrem Wohnort aufgelistet sind. In diesem Fall werden Vorschlagswerte für ein InputField, das an Mitarbeiter gebunden ist, gut funktionieren. Wird in dem InputField jedoch der Wohnort angezeigt, dann ist das Resultat für die Vorschlagswerte eine Liste von Wohnorten mit irgend einem Mitarbeiter, der dort wohnt, als Beschreibungstext. Dies kann für den Benutzer verwirrend sein.
Vorschlagswertelisten unterstützen keine Datenelemente mit einer Domäne, die zwischen Groß- und Kleinschreibung unterscheidet.
Die Anzeige der Vorschlagswerteliste führt zu erhöhter Netzwerkbelastung und verbraucht zusätzliche Rechenzeit auf dem Server.
Für OVS- und frei-programmierte Wertehilfen werden keine Vorschlagswertelisten angezeigt.
Die Historie eines InputFields ist unabhängig von jeglicher Wertehilfe. Sie steht für jedes InputField zur Verfügung, das heißt auch für Eingabefelder, die eine OVS- oder frei-programmierte Wertehilfe haben.
Einträge aus der Historie können mit der Entf-Taste aus der Historie gelöscht werden.
Verwendung von Suchhilfe-Exits für Vorschlagswertelisten
Ein Suchhilfe-Exit kann vom Web Dynpro Framework zur Bestimmung entweder der Vorschlagswerteliste oder der Trefferliste des Wertehilfe-Popups aufgerufen werden.
Die Variante, in der er aufgerufen wird, kann mit CL_WEB_DYNPRO=>valuehelpinfo-valuesuggest abgefragt werden. Mögliche Werte sind abap_true oder abap_false.
Ein Suchhilfe-Exit darf auch über mehrere Spalten suchen. Setzen Sie hierfür CL_WEB_DYNPRO=>valuehelpinfo-suggestfiltercolumn = '01' (allColumns)
Achtung
Die Vorschlagswerteliste wird nur 2–spaltig dargestellt: Die erste Spalte ist die Schlüsselspalte, die zweite die Beschreibungsspalte.
Die Schlüsselspalte enthält die Benutzereingabe, die Beschreibungspalte eine Liste des restlichen Zeileninhalts. Jede Zelle wird durch Komma und Leerzeichen getrennt (siehe Grafik).
Falls suggestFilterMethod = prefixSearch gesetzt ist, wird deshalb nur in den ersten beiden Spalten gesucht. Verwenden Sie suggestFilterMethod = containsSearch, wenn Sie in allen Spalten suchen möchten.
Weitere Informationen
Sie finden ein Beispiel im System in der Component DEMO_VALUE_SUGGEST.