Erweiterte Steuerelemente für Dropdownmenüs

In den Tutorials auf dieser Seite wird die Verwendung von Dropdownlisten mit dem UiPath Form Designerin der Aktivität Create Form Task (Create Form Task) veranschaulicht. Die am häufigsten verwendete Eigenschaft zum Erzielen der Ergebnisse in den Tutorials ist die FormData(Collection).

Dynamische Dropdownmenüs erstellen

Verwenden Sie sie in Workflows, in denen Sie dynamische Daten senden möchten, um ein Dropdown-Steuerelement in einer Formularaktion auszufüllen.

Bei dieser Methode enthält eine Variable vom Typ Liste der Zeichenfolgen die Werte der Dropdownliste, anstatt statische Werte auf der Registerkarte Daten im UiPath Form Designer hinzuzufügen.

Im folgenden Beispiel erstellen wir eine dynamische Dropdownliste mit Ländern, initialisieren eine Variable mit der Liste der Länder und erstellen eine zusätzliche Variable, um das von den Benutzern ausgewählte Land zu erfassen.

So erstellen Sie eine dynamische Dropdownliste:

1. Klicken Sie in der Aktivität Create Form Task (Formularaufgabe erstellen) auf die Auslassungspunkte (...) rechts neben FormData.

2. Fügen Sie ein Argument für die dynamische Dropdownliste wie folgt hinzu:

   • Name: countryList_dropdown
   • Richtung: In
   • Typ: Liste der Zeichenfolgen (List<String>)
   • Wert: Drücken Sie Strg + K und geben Sie listOfCountries als Variablennamen ein.
     Die Variable listOfCountries enthält die Elemente in der Dropdownliste.
     Hinweis: Array of Strings wird ebenfalls unterstützt, aber Sie müssen die Dropdown-Komponente im Formular-Designer manuell hinzufügen und den Wert des Feldschlüssels hinzufügen.

3. Wenn Sie die Benutzerauswahl wieder in den Workflow zurückholen möchten, fügen Sie ein weiteres Argument hinzu, um den ausgewählten Wert zu erfassen:

   • Name: country (der Feldschlüssel der Dropdown-Komponente)
   • Richtung: In/Out oder Out
   • Typ: String
   • Wert: Drücken Sie Strg + K und geben Sie selectedCountry als Variablennamen ein.
4. Klicken Sie auf OK , um Formulardatenzu schließen.
5. Öffnen Sie das Panel Variablen und initialisieren Sie listOfCountries mit dem Standardwert new List(of string) from { "India", "Romania", "US" }.
   Tipp: Sie können listOfCountries auch über andere Aktivitäten auffüllen, anstatt es zu initialisieren.

Erstellen von kaskadierten Dropdownmenüs

Verwenden Sie sie in aufgabenbasierten Formularen, wenn Sie möchten, dass die Auswahl in einer Dropdownliste (übergeordnet) die Werte in der zweiten Dropdownliste (untergeordnet) ausfüllt.

So erstellen Sie eine kaskadierte Dropdownliste:

1. Klicken Sie in der Aktivität Create Form Task (Formularaufgabe erstellen) auf die Auslassungspunkte (...) rechts neben FormData.

2. Binden Sie das übergeordnete Dropdown-Menü an den Workflow.

   Erstellen Sie für dieses Beispiel ein Argument, das die Variable listOfCountries List<String> als Dropdownliste an den Workflow übergibt.
   Hinweis: Die Variable listOfCountries enthält die Elemente in der übergeordneten Dropdownliste, d. h. die Liste der Länder.
   1. Benennen Sie das Argument CountryList_dropdown. Der Eigenschaftsname des Feldschlüssels für dieses Argument ist CountryList.
   2. Legen Sie die Richtung wie in 2.3 fest. Legen Sie den Typ als System.Collections.Generic.List<System.String>.
   3. Legen Sie den Wert als die Variable listOfCountries List<String> fest.

3. Binden Sie das untergeordnete Dropdown-Menü an den Workflow.

   Erstellen Sie für dieses Beispiel ein Argument, das die Variable stateDictionaryList Dictionary<String, List<String>> als Dropdownliste an den Workflow übergibt.
   Hinweis: Die Variable stateDictionaryList enthält die Elemente in der untergeordneten Dropdownliste, d. h. die Bundesstaaten für jedes Land.
4. Benennen Sie das Argument stateDictList_dropdown. Der Eigenschaftsname des Feldschlüssels für dieses Argument ist stateDictList.
5. Legen Sie die Richtung wie in 3.3 fest. Legen Sie den Typ als System.Collections.Generic.Dictionary<System.String, System.Collections.Generic.List<System.String>.
6. Legen Sie den Wert als die Variable stateDictionaryList Dictionary<String, List<String> fest

7. Binden Sie das untergeordnete Dropdown-Menü an das übergeordnete Dropdown-Menü.

   Erstellen Sie ein Argument mit dem Namen der untergeordneten Dropdownliste und fügen Sie das Suffix _parent hinzu. Legen Sie dann den Wert des Arguments auf den Namen des übergeordneten Dropdownmenüs fest: ”ParentDropdownVariableName”.
   Erstellen Sie für dieses Beispiel ein Argument mit dem Namen stateDictList_parent. Die untergeordnete Dropdownliste ist stateDictList und Sie fügen das Suffix _parent hinzu.

   1. Legen Sie die Richtung als Infest.

   2. Legen Sie den Typ als String.
   3. Legen Sie den Wert als ”CountryList”.
      Beachten Sie beim Ausfüllen der Wörterbuchvariable stateDictList , dass der Wörterbuchschlüssel ein Wert aus der Dropdownliste des übergeordneten Elements ist und der entsprechende Wert eine Liste von Optionen ist, die im Formular angezeigt werden sollen, wenn das übergeordnete Element auf den Schlüssel festgelegt ist.
      Tipp:

      Sie können die vorab auszufüllenden Werte (z. B. mit Feldern für Land und Bundesstaat) in der FormData- Auflistung übergeben.

      Wenn Sie untergeordnete Werte übergeben, stellen Sie sicher, dass Sie auch den übergeordneten Wert einschließen, um unerwartetes Verhalten zu verhindern.

8. Ordnen Sie jeden Wert aus der übergeordneten Dropdownliste einer Variablen „List of Strings“ zu. Sie können die Liste (Wörterbuch) für das übergeordnete Dropdown-Menü auf beliebige Weise ausfüllen, aber in diesem Beispiel verwenden wir für jeden Wert die Aktivität Zum Wörterbuch hinzufügen.

   • Wörterbuch: das Wörterbuch der untergeordneten Dropdownliste, stateDictList.
   • Schlüssel: ein Wert aus der Liste der Zeichenfolgen für die übergeordnete Dropdownliste, CountryList – in diesem Beispiel "US", "India"und "Romania".
   • Wert: Drücken Sie Strg + K und geben Sie einen Namen für die Variable Liste der Zeichenfolgen ein, die die Werte enthält, die in der untergeordneten Dropdownliste angezeigt werden sollen, wenn der Schlüsselwert im übergeordneten Element ausgewählt ist - usaStatesList, indianStatesListund romanianCountyListbzw.
9. Stellen Sie sicher, dass Sie die Aktivität(en) für den obigen Schritt vor der Aktivität Formularaufgabe erstellen ( Create Form Task ) platzieren.
10. Klicken Sie auf OK , um Formulardatenzu schließen.

11. Öffnen Sie das Panel Variablen und initialisieren Sie die neue Liste der String-Variablen, die Sie mit den folgenden Standardwerten erstellt haben:

    • Für indianStatesList: new List(of string) from { "Odisha", "Rajasthan", "Karnataka" }
    • Für usaStatesList: new List(of string) from {"Florida", "Georgia", "Washington"}
    • für romanianCountyList: new List(of string) from {"Cluj", "Prahova", "Constanta"}.

Laden Sie diese Beispiele hierherunter

Erstellen von kaskadierten Dropdownmenüs in den Komponenten „Edit Grid“ und „Data Grid“

So verwenden Sie kaskadierte Dropdownmenüs in einer Edit Grid- oder Data Grid -Komponente:

1. Erstellen Sie die Dropdownfelder gemäß den obigen Schritten (mit dem FormData- Assistenten).
2. Öffnen Sie den Formular-Designer.

3. Wenn die Dropdownfelder nicht in Ihrem Formular erstellt werden, überprüfen Sie Folgendes:

   • Die Argumente <dropdownKey> , <dropdownKey>_dropdownund <dropdownKey>_parent werden der FormData- Auflistung korrekt hinzugefügt.

   • Das Kontrollkästchen GenerateInputFields ist aktiviert.

4. Ziehen Sie die Komponente „Edit Grid“ oder „Data Grid “ und legen Sie sie dort ab.
5. Ziehen Sie die in Schritt 1 erstellten Dropdownmenüs per Drag-and-Drop in die Komponente Raster bearbeiten oder Datenraster .
6. Öffnen Sie das Konfigurationsmenü für die untergeordnete Dropdownliste (klicken Sie auf ).

7. Beachten Sie auf der Registerkarte Logik die vorkonfigurierte erweiterte Logik.

   
   

   

   
   
8. Navigieren Sie zum Feld Aktionen > Schemadefinition .
9. Ersetzen Sie [data.<parent_dropdown_key>] durch [row.<parent_dropdown_key>] im Schemaausdruck.
   
   

   

   
   
   Hinweis: Das Schlüsselwort row weist das Formular an, den übergeordneten Wert aus der Rasterzeile zu verwenden.
10. Speichern Sie das Formular.

Festlegen der Anzahl der Suchergebnisse für Dropdown-Menüs

Dropdown-Menüs zeigen standardmäßig höchstens vier Suchergebnisse an. Sie können diesen Grenzwert ändern, indem Sie eine Eigenschaft im Formularentwurf festlegen.

So legen Sie die Anzahl der Suchergebnisse für eine Dropdownliste fest:

1. Klicken Sie im UiPath Form Designerauf Bearbeiten , um die Einstellungen für die Dropdownliste zu öffnen, und wählen Sie dann die Registerkarte Daten aus.
2. Fügen Sie unter Choices.js-Optionen { "searchResultLimit" : x }hinzu, wobei x die maximale Anzahl der Ergebnisse ist, die Sie anzeigen möchten.

Anzeigen aller Optionen in Dropdownmenüs

Wenn die Zeichenfolgen im Dropdownmenü mehr als 50 Zeichen haben, werden sie möglicherweise nicht angezeigt.

So zeigen Sie alle Optionen an, die Ihrem Suchbegriff entsprechen:

1. Klicken Sie auf JSON bearbeiten . für die Dropdownlistenkomponente, die Sie bearbeiten möchten.

2. Fügen Sie im Feld Komponenten-JSON die folgenden Eigenschaften hinzu:

   ...
     "fuseOptions": {
       "distance": 800,
       },
     "threshold": 1,
     "useExactSearch": false,
   ...

Hinweis: Die Eigenschaft threshold bestimmt, an welchem Punkt der Algorithmus den Suchvorgang für den angegebenen Suchbegriff beendet. Beispielsweise erfordert ein threshold von 0 eine genaue Übereinstimmung von Buchstaben und Ort. Ein threshold von 1 kann mit allem übereinstimmen, sogar mit Rechtschreibfehlern. Passen Sie den Wert threshold basierend auf Ihrem Anwendungsfall an.