Wie man wertvolle Hilfen und Vorschläge in Benutzereingaben integriert

Written by Andreas Dallner
März 12, 2025

Warum sollten Sie Hilfe und/oder Vorschläge verwenden?

Die Integration von Wertehilfe und Vorschlägen in das Eingabe-Widget führt Ihre Benutzer, erhöht die Datenqualität und beschleunigt die Identifizierung der richtigen Werte. Insbesondere bei Eingaben, die nur bestimmte Werte zulassen, erhöht die Verwendung von Wertehilfedialogen die Benutzererfahrung erheblich.

Es kann sich jedoch wiederholen, wenn Sie die Wertehilfe handhaben, indem Sie alle erforderlichen Widgets zu Ihren Bildschirmen hinzufügen und die Daten laden, indem Sie Business Objekt-/Connector-Aufrufe oder UI-Aktionen in Ihren Prozess-Storys hinzufügen.

Daher enthält unser Eingabe-Widget eine integrierte Wertehilfe und Vorschläge. Es ist nicht mehr notwendig, weitere Widgets hinzuzufügen oder Storys zu bearbeiten.

Tabular value help for input widget

Voraussetzungen

Um wertvolle Hilfen und Vorschläge zu implementieren, wie in diesem Knowledge Base-Artikel gezeigt, müssen Sie den neuesten Standardinhalt für Ihre Simplifier-Version herunterladen.

Holen Sie sich die neuesten Standardinhalte

SCHRITT 1: Definieren Sie die Datenquelle für Ihre Wertehilfe/Vorschläge

Fügen Sie zunächst ein Eingabe-Widget zu Ihrem Bildschirm hinzu. Öffnen Sie die Eigenschaften des Widgets, indem Sie es im WYSIWYG-Editor auswählen und definieren Sie im Abschnitt Standard die folgenden Eigenschaften:

  • valueHelpSource -> Auf Business Objekt oder Variable setzen
  • valueHelpSourceObject -> Legen Sie den Namen des serverseitigen Business Objekts fest (wenn die Quelle ‘Business Object’ ist) oder den Namen der Variablen (wenn die Quelle ‘Variable’ ist)
  • valueHelpSourceFunction -> Wenn die Quelle “Business Objekt” ist, legen Sie den Namen der Funktion fest, die den Wert help data zurückgibt.

Die Daten werden nun automatisch abgerufen. Die Eigenschaft ‘showValueHelp’ ist in Ihrer Anwendung standardmäßig aktiviert, auch wenn sie in den Eigenschaften deaktiviert ist.

Define the input's value help data source

Der Benutzer benötigt die Ausführungsberechtigung für das konfigurierte Business-Objekt. Verwenden Sie Projekte oder globale Rollen, um die Berechtigung zu erteilen.

SCHRITT 2: Spaltentitel der Wertehilfe festlegen (optional)

Das Widget analysiert die Ergebnismenge des serverseitigen Business Objekts/der Variablen und zeigt alle enthaltenen Eigenschaften an. Standardmäßig werden die Namen der Eigenschaften als Spaltentitel der Wertehilfetabelle angezeigt. Wenn Sie die Überschriftentitel anpassen möchten, fügen Sie sie einfach als kommagetrennte Liste in der Eigenschaft valueHelpColumnTitles hinzu. Die Eigenschaft ist auch übersetzbar, um die Werthilfe auch in multinationalen Anwendungen zu stärken.

Define the column titles of your input's value help

SCHRITT 3: Erweiterte Konfiguration Ihrer Wertehilfe (optional)

Wenn Sie das Verhalten der Wertehilfe ändern möchten, können Sie die folgenden Eigenschaften im Abschnitt Erweitert festlegen:

Eigentum Beschreibung
valueHelpTitle Der Titel des Wertehilfedialogs lautet “Element auswählen”. Bei Bedarf können Sie sie ändern, indem Sie die Eigenschaft valueHelpTitle bearbeiten
valueHelpResultPath Die Daten, die als Wertehilfe verwendet werden, werden basierend auf dieser Eigenschaft dynamisch abgerufen.

Wenn leer (Standard), wird zuerst geprüft, ob die Ergebnismenge des Business Objekts/Werts der Variablen eine Eigenschaft ‘result’ enthält, die ein Array ist. Wenn dies der Fall ist, wird der Wert der Eigenschaft als Wertehilfeinhalt verwendet.

Ist dies nicht der Fall, wird der Wert der Ergebnismenge/Variablen nach Arrays/Sammlungen durchsucht. Das erste gefundene Array wird dann als Wertehilfe verwendet.

Durch das Festlegen eines Ergebnispfads in dieser Eigenschaft wird das Standardverhalten überschrieben. Nun wird der Wert des Ergebnispfads in der Ergebnismenge/Variablen als Werthilfeinhalt verwendet.

Hinweis: Wenn es sich bei den Daten nicht um ein Array handelt, wird die Wertehilfe deaktiviert
valueHelpColumns Sie möchten nicht alle Eigenschaften des Wertehilfeinhalts anzeigen oder die Reihenfolge der Spalten ändern? Fügen Sie einfach eine durch Kommas getrennte Liste von Eigenschaften hinzu. Es werden nur die definierten Eigenschaften angezeigt. Die Reihenfolge der kommagetrennten Liste wird auch für die angezeigten Spalten verwendet
valueHelpEigenschaft Standardmäßig wird der Wert der ersten Spalte der ausgewählten Wertehilfe verwendet, um den Wert der Eingabe festzulegen. Wenn der Wert einer anderen Spalte verwendet werden soll, setzen Sie hier einfach den Namen der Eigenschaft.
Advanced properties to configure input value help

SCHRITT 4: Eingabevorschlag aktivieren (optional)

Standardmäßig ist nur ein Wertehilfedialog aktiviert. Darüber hinaus können Sie auch Vorschlagselemente aktivieren, indem Sie die Eigenschaft ‘showSuggestion’ festlegen. Nun wird beim Tippen in das Eingabefeld ein tabellarischer Vorschlag angezeigt.

Suggestion items for input widget

SCHRITT 5: Anwendung bereitstellen

Setzen Sie jetzt die integrierte Hilfe und Vorschläge aus und probieren Sie sie aus!

Requesting the value help

Wenn Sie komplexere Hilfe benötigen, können Sie immer noch unsere Low-Code-Funktionen verwenden, um diese bei Bedarf zu implementieren.

Tags:

Was this article helpful?

 
Related Articles