Datentabellen verbinden (Join Data Tables)

UiPath.Core.Activities.JoinDataTables

Beschreibung

Kombiniert Zeilen aus zwei Tabellen durch Verwenden von Werten, die in beiden gemeinsam vorkommen, nach einer Verbindungsregel, die in der Eigenschaft Typ verbinden (JoinType) angegeben ist.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Plattformübergreifende Konfiguration

• Datentabelle 1 (DataTable1) - Die erste Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.

• Datentabelle 2 (DataTable2) - Die zweite Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.

  Hinweis:

  Die Reihenfolge, in der die beiden Tabellen zur Verfügung gestellt werden, ist sehr wichtig, weil sie die Struktur der resultierenden Tabelle entsprechend der im Eigenschaftsfeld Typ verbinden (JoinType) ausgewählten Option beeinflusst.

• Typ verbinden (JoinType) - Der Typ der Verbinden-Operation, die Sie verwenden möchten. Die folgenden Optionen sind verfügbar:

  • Innerer (Inner) - Alle Zeilen aus Datentabelle 1 und Datentabelle 2 behalten, die der Verbinden-Regel entsprechen. Alle Zeilen, die der Regel nicht entsprechen, werden aus der resultierenden Tabelle entfernt.
  • Links (Left) - Alle Zeilen aus Datentabelle 1 (DataTable1) und nur die Werte aus Datentabelle 2 (DataTable2) behalten, welche der Verbinden-Regel entsprechen. Nullwerte werden in die Spalte für die Zeilen aus Datentabelle 1 (DataTable1) eingefügt, die auf den Zeilen von Datentabelle 2 (DataTable2) keine Übereinstimmung aufweisen.
  • Vollständig (Full) - Alle Zeilen aus Datentabelle 1 (DataTable1) und Datentabelle 2 (DataTable2) behalten, unabhängig davon, ob die Verbinden-Bedingung erfüllt ist. Nullwerte werden zu den Zeilen beider Tabellen hinzugefügt, die keine Entsprechung aufweisen.
    Hinweis:

    Wenn eine Spalte aus Datentabelle 2 (DataTable2) denselben Namen wie eine Spalte der Datentabelle 1 (DataTable1) hat, wird der Name der Spalte aus Datentabelle2 (DataTable2) in der resultierenden Tabelle in [ColumnName]_1 geändert. Wenn die Spalte mit dem Namen [ColumnName]_1 bereits existiert, wird stattdessen die folgende Zahl verwendet, die noch nicht benutzt wird. Beispiel: Wenn Datentabelle 1 (DataTable1) Spalten mit dem Namen ID, ID_1 und ID_2 hat und Datentabelle 2 (DataTable2) eine Spalte mit dem Namen ID aufweist, erhält die Spalte in Datentabelle 2 (DataTable2) nach dem Verbinden den Namen ID_3.

• Verknüpfungsregeln – Die Bedingungen zum Verbinden der Tabellen. Wenn Sie das Feld auswählen, wird ein einfacher Filtergenerator geöffnet, in dem Sie Regeln hinzufügen können, aus denen sich der Filter zusammensetzt.

Windows – Legacy, Windows-Konfiguration

Eigenschaften-Panel

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Datentabelle 1 (DataTable1) - Die erste Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.
• Datentabelle 2 (DataTable2) - Die zweite Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.
  Hinweis:

  Die Reihenfolge, in der die beiden Tabellen zur Verfügung gestellt werden, ist sehr wichtig, weil sie die Struktur der resultierenden Tabelle entsprechend der im Eigenschaftsfeld Typ verbinden (JoinType) ausgewählten Option beeinflusst.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• Typ verbinden (JoinType) - Der Typ der Verbinden-Operation, die Sie verwenden möchten. Die folgenden Optionen sind verfügbar:
  • Innerer (Inner) - Alle Zeilen aus Datentabelle 1 und Datentabelle 2 behalten, die der Verbinden-Regel entsprechen. Alle Zeilen, die der Regel nicht entsprechen, werden aus der resultierenden Tabelle entfernt.
  • Links (Left) - Alle Zeilen aus Datentabelle 1 (DataTable1) und nur die Werte aus Datentabelle 2 (DataTable2) behalten, welche der Verbinden-Regel entsprechen. Nullwerte werden in die Spalte für die Zeilen aus Datentabelle 1 (DataTable1) eingefügt, die auf den Zeilen von Datentabelle 2 (DataTable2) keine Übereinstimmung aufweisen.
  • Vollständig (Full) - Alle Zeilen aus Datentabelle 1 (DataTable1) und Datentabelle 2 (DataTable2) behalten, unabhängig davon, ob die Verbinden-Bedingung erfüllt ist. Nullwerte werden zu den Zeilen beider Tabellen hinzugefügt, die keine Entsprechung aufweisen.
    Hinweis:

    Wenn eine Spalte aus Datentabelle 2 (DataTable2) denselben Namen wie eine Spalte der Datentabelle 1 (DataTable1) hat, wird der Name der Spalte aus Datentabelle2 (DataTable2) in der resultierenden Tabelle in [ColumnName]_1 geändert. Wenn die Spalte mit dem Namen [ColumnName]_1 bereits existiert, wird stattdessen die folgende Zahl verwendet, die noch nicht benutzt wird. Beispiel: Wenn Datentabelle 1 (DataTable1) Spalten mit dem Namen ID, ID_1 und ID_2 hat und Datentabelle 2 (DataTable2) eine Spalte mit dem Namen ID aufweist, erhält die Spalte in Datentabelle 2 (DataTable2) nach dem Verbinden den Namen ID_3.

Ausgabe

• Datentabelle (DataTable) - Die Tabelle mit den verbundenen Werten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.

Join-Assistent

Dieser Assistent hilft Ihnen dabei, die Eigenschaften der Aktivität Datentabellen verbinden) zu konfigurieren. Er kann mit der Schaltfläche Verbinden-Assistent (Join Wizard) im Hauptteil der Aktivität im Panel Designer (Designer) geöffnet werden.

Im oberen Abschnitt des Assistenten können Sie beide Variablen DataTable auswählen, die Sie in der Operation verwenden möchten, den Verbinden-Typ, und die Ausgabevariable der folgenden Felder:

• Eingabedatentabelle 1 (Input DataTable1) - Die DataTable-Variable, welche die erste Tabelle enthält, die Sie verwenden möchten.
• Eingabedatentabelle 2 (Input DataTable2) - Die DataTable- Variable, welche die zweite Tabelle enthält, die Sie verwenden möchten.
• Ausgabedatentabelle (Output DataTable) - Die Variable DataTable, in der Sie die resultierende Tabelle speichern möchten.
• Typ verbinden (JoinType) - Der Typ der Verbinden-Operation, die Sie verwenden möchten. Die folgenden Optionen sind verfügbar:
• Innerer (Inner) - Alle Zeilen aus Datentabelle 1 und Datentabelle 2 behalten, die der Verbinden-Regel entsprechen. Alle Zeilen, die der Regel nicht entsprechen, werden aus der resultierenden Tabelle entfernt.
• Links (Left) - Alle Zeilen aus Datentabelle 1 (DataTable1) und nur die Werte aus Datentabelle 2 (DataTable2) behalten, welche der Verbinden-Regel entsprechen. Nullwerte werden in die Spalte für die Zeilen aus Datentabelle 1 (DataTable1) eingefügt, die auf den Zeilen von Datentabelle 2 (DataTable2) keine Übereinstimmung aufweisen.
• Vollständig (Full) - Alle Zeilen aus Datentabelle 1 (DataTable1) und Datentabelle 2 (DataTable2) behalten, unabhängig davon, ob die Verbinden-Bedingung erfüllt ist. Nullwerte werden zu den Zeilen beider Tabellen hinzugefügt, die keine Entsprechung aufweisen.

Im unteren Abschnitt des Assistenten können Sie die Struktur der resultierenden Tabelle konfigurieren, indem Sie Ausdrücke hinzufügen, die Beziehungen zwischen Spalten angeben. Jeder dieser Ausdrücke umfasst die folgenden drei Elemente:

• Spalte Tabelle 1 (Column Table 1) - Der Name der Spalte in der ersten Tabelle. Dieses Feld unterstützt nur String-Variablen, die den Spaltennamen enthalten, Int32 Variablen, die den Spaltenindex enthalten, oder ExcelColumn-Variablen.
• Operation (Operation) - Die Operation, welche die Beziehung zwischen den Spalten enthält. Die folgenden Optionen sind verfügbar:
  • = - gleich
  • != - ungleich
  • > - Greater than
  • < - Less than
  • >= - Greater than or equal to
  • <= - Less than or equal to
• Spalte Tabelle 2 - Der Name der Spalte in der zweiten Tabelle. Dieses Feld unterstützt nur String-Variablen, die den Spaltennamen enthalten, Int32 Variablen, die den Spaltenindex enthalten, oder ExcelColumn-Variablen.

Beispiel der Verwendung der Aktivität zum Verbinden von Datentabellen

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Projekt erstellt, in dem zwei Blätter einer Arbeitsmappe auf einem anderen Blatt dieser Arbeitsmappe miteinander verbunden werden. Das erste Blatt enthält Details über Aufträge, während das zweite Blatt Details zu Kunden enthält. Die beiden Blätter haben eine gemeinsame Spalte, Kunden-ID, welche für die Verbinden-Operation verwendet wird. Das Projekt kann hier heruntergeladen werden.

1. Erstellen Sie ein leeres Projekt.

2. Ziehen Sie einen Sequenz- (Sequence) Container in das Panel Designer (Designer).

3. Ziehen Sie einen Excel-Anwendungsbereich (Excel Application Scope) und setzen Sie den Pfad der Excel-Arbeitsmappe in die Eigenschaft Arbeitsmappen-Pfad (Workbook Path).

4. Erstellen Sie zwei DataTable-Variablen, eine für das Arbeitsblatt Kunden (Customers) und eine für das Arbeitsblatt Aufträge (Orders).

5. Ziehen Sie im Excel-Anwendungsbereich (Excel Application Scope) zwei Aktivitäten Bereich lesen (Read Range).

6. Setzen Sie die beiden Aktivitäten Bereich lesen (Read Range), um jedes der Arbeitsblätter der Excel-Arbeitsmappe zu lesen, und speichern Sie diese in den entsprechenden Variablen.

7. Erstellen Sie eine DataTable-Variable, um die resultierende Tabelle zu speichern.

8. Ziehen Sie eine Aktivität Datentabellen verbinden (Join Data Tables) in den Bereichscontainer.

9. Klicken Sie auf die Schaltfläche Assistenten verbinden (Join Wizard) im Hauptteil der Aktivität. Der Assistent Datentabellen verbinden (Join Data Tables Wizard) wird geöffnet.

10. Setzen Sie die Variable mit dem Kundenarbeitsblatt in das Feld Eingabedatentabelle 1 (Input DataTable 1).

11. Setzen Sie die Variable mit dem Auftragsarbeitsblatt in das Feld Eingabedatentabelle 2 (Input DataTable 2).

12. Setzen Sie die Variable zum Speichern der resultierenden Tabelle in das Feld Ausgabedatentabelle (Output DataTable).

13. Wählen Sie im Dropdownmenü Verbindungstyp (Join Type) die Option Innere/r (Inner) aus.

14. Geben Sie in das Feld Spaltentabelle 1 die Spalte ein, die der Spalte CustomerID im „Customers“-Blatt entspricht.

15. Wählen Sie im Dropdownmenü Operation (Operation) die Option = aus.

16. Geben Sie im Feld Spalte Tabelle 2 (Column Table 2) die Spalte ein, die der Spalte Kunden-ID (CustomerID) im Auftragsarbeitsblatt entspricht. Der Assistent sollte folgendermaßen aussehen:

    

17. Ziehen Sie eine Aktivität Schreiben-Bereich (Write Range) in das Panel Designer (Designer).

18. Konfigurieren Sie den Schreiben-Bereich so, das Sie die DataTable-Variable mit der resultierenden Tabelle in ein neues Arbeitsblatt der ursprünglichen Arbeitsmappe schreiben können.

19. Der endgültige Workflow sollte folgendermaßen aussehen: