Arbeiten mit Datenquelle und Wertbindung

Hintergrundinformationen

Die Felder Datenquelle und Wertbindung eines Steuerelements sind zweifach gebunden, d. h. sie können beide die Stammdaten aktualisieren, die an dieses Steuerelement gebunden sind.

Zum besseren Verständnis können wir ein einfaches Beispiel anführen. Sie können versuchen, eine Beschriftung und ein Textfeld zu einer App hinzuzufügen und dann eine App-Variable zu erstellen. Weisen Sie der Variablen die Eigenschaft Wertbindung des Textfeldsteuerelements und die Eigenschaft Text des Beschriftungssteuerelements zu. Bei der Vorschau der App sehen Sie, dass die App-Variable ebenfalls aktualisiert wird, wenn Sie den Wert Ihres Textfeldes ändern. Die Eigenschaft Text hingegen ist ein einseitig gebundenes Feld, das nur Daten anzeigt, die nicht aktualisiert werden können.

Beispiel

In diesem Beispiel erstellen wir eine App, in der der Benutzer mehrere Elemente aus einer benutzerdefinierten Liste auswählen kann, die aus einem Prozess stammt.

In diesem Beispiel erstellen wir Folgendes:

• Einen Automatisierungsprozess
• Eine App, die UiPath^® Appsverwendet

Erstellen des Workflows

Der erste Schritt dieses Beispiels ist das Erstellen des Workflows in ^UiPath® Studio. Dies ist ein einfacher Workflow, der aus einigen wenigen Argumenten besteht.

1. Öffnen Sie Studio und erstellen Sie einen neuen Prozess.

2. Erstellen Sie die folgenden Argumente:

   Argument name	Richtung	Argumenttyp	Standardwert
   out_DataTable	Aus	DataTable	-
   in_SelectedItems	in	DataTable	neues DataDable
   filtered_SelectedItems	Aus	DataTable	-

3. Ziehen Sie eine Sequence in den Workflow-Designer.

4. Fügen Sie eine Build Data Table-Aktivität innerhalb des Sequence-Containers hinzu.

   • Fügen Sie das out_DataTable-Argument in das Feld DataTable ein.
   • Fügen Sie eine Spalte mit dem Namen Ausgewählt hinzu.

   • Konfigurieren Sie die Tabelle wie in der folgenden Abbildung:

     
     

     

     
     

5. Fügen Sie eine If-Aktivität unter der Aktivität Build Data Table hinzu und führen Sie die folgenden Schritte aus, um sie zu konfigurieren.

   • Fügen Sie in_SelectedItems.Rows.Count > 0 im Feld Bedingung hinzu.

   • Konfigurieren Sie Then und Else wie unten gezeigt.

     Then

     1. Ziehen Sie eine Sequence in den Container „Then“.

     2. Fügen Sie eine Assign-Aktivität innerhalb des Sequence-Containers hinzu.

     - Fügen Sie Filtered_SelectedItems im Feld An hinzu.

     - Add (from r In in_SelectedItems.Select() Wobei r("Selected").Equals(true) Wählen Sie r).CopyToDataTable im Feld Wert aus.

     3. Fügen Sie eine Log Message-Aktivität unter der Assign-Aktivität hinzu.
     – Legen Sie Protokollierungsstufe auf Info fest.
     – Fügen Sie filtered_SelectedItems.ToString im Feld Nachricht hinzu.

     Else

     1. Ziehen Sie eine Sequence in den Else-Container.

     2. Fügen Sie eine Log Message-Aktivität unter der Assign-Aktivität hinzu.

     – Legen Sie Protokollierungsstufe auf Info fest.
     – Fügen Sie "First run or empty" im Feld Nachricht hinzu.

Ergebnis

Am Ende sollte der Workflow wie in der folgenden Abbildung aussehen.

Wichtig:

Wenn Ihr Prozess ein komplexes .NET-Objekt in seiner Eingabe oder Ausgabe verwendet (z. B. DataTable), weiß App Studio nicht, um welche Felder dieses Objekts es sich standardmäßig handelt. Sie können dies auf zwei Arten angeben:

• Führen Sie Ihren Prozess aus, bevor Sie ihn zu Ihrer App hinzufügen. Wenn ein Prozess ein Objekt verwendet, überprüft Apps seine Auftragshistorie, um das Schema/die Felder dieses Objekts automatisch zu erkennen.
• Geben Sie manuell Objektfelder für die Prozesseingabe/-ausgabe an. Wenn Ihr Prozess keine Auftragshistorie hat, müssen Sie nach dem Hinzufügen zu Ihrer App seine Felder manuell angeben, um sie in Ihrer App verwenden zu können.

Manuell zum Prozess hinzugefügte Parameter werden entfernt, wenn der Prozess aktualisiert wird.

Erstellen der App

Nach der Veröffentlichung des Workflow-Builds während des Verfahrens zum Erstellen des Workflows in Ihrem Orchestrator ist es nun an der Zeit, die App selbst zu erstellen.

1. Erstellen Sie eine neue App.
2. Verweisen Sie auf den oben erstellten Prozess.
3. Fügen Sie ein Steuerelement Benutzerdefinierte Liste und ein Steuerelement Tabelle nebeneinander in Ihre App ein.
4. Fügen Sie im Feld Datenquelle der Tabelle Out: out_DataTable aus dem Prozess hinzu.
   
   

   

   
   
5. Fügen Sie der benutzerdefinierten Liste ein Kontrollkästchen-Steuerelement und ein Textfeld-Steuerelement hinzu und konfigurieren Sie sie wie folgt:
   • Fügen Sie das Out: Item-Element aus dem Abschnitt Out: out_DataTable des Prozesses im Feld Beschriftung des Kontrollkästchen-Steuerelements hinzu.
   • Fügen Sie das Out: Selected-Element aus dem Abschnitt Out: out_DataTable des Prozesses im Feld Wertbindung des Kontrollkästchen-Steuerelements hinzu.
   • Fügen Sie das Out: Quantity-Element aus dem Abschnitt Out: out_DataTable des Prozesses im Feld Wertbindung des Textfeld-Steuerelements hinzu.
6. Fügen Sie ein Schaltflächensteuerelement hinzu und nennen Sie es Run. Konfigurieren Sie die angeklickte Regel wie folgt:
   • Fügen Sie eine Regel Prozess starten hinzu.
   • Fügen Sie einen Namen im Feld Auftragsname hinzu und markieren Sie ihn als Attended.
   • Fügen Sie in_SelectedItems und Out.out_DataTable im Feld Eingabe überschreiben hinzu.
     
     

     

     
     
7. Fügen Sie einen Container unter der Schaltfläche hinzu.
8. Fügen Sie zwei Label-Steuerelemente nebeneinander hinzu.
   • Fügen Sie das filtered_SelectedItems.Item-Element aus dem Abschnitt Out: filtered_SelectedItems des Prozesses im Feld Text der ersten Beschriftung hinzu.
     • Fügen Sie das filtered_SelectedItems.Quantity-Element aus dem Abschnitt Out: filtered_SelectedItems des Prozesses im Feld Text der ersten Beschriftung hinzu.

Schlussfolgerung

Bei der Vorschau der App können Sie Elemente in einer benutzerdefinierten Liste auswählen, die aus einem Prozess stammt.

Dieses Beispiel dient vor allem dazu, den Unterschied zwischen Datenquelle, Wertbindung und Eingabe besser zu verstehen:

• Datenquelle und Wertbindung sind zweifach gebunden. Das heißt, dass sie beide die Stammdaten aktualisieren können, die an ein Steuerelement gebunden sind.
• Die Überschreibung der Eingabe ermöglicht es Ihnen, Objekte aus anderen Quellen zu übergeben, z. B. eine Datentabelle aus einem Prozess oder eine Entität aus dem Data Service.