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 – Die erste Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.

• Datentabelle2 – 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 Beitrittstyp 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 DataTable2 denselben Namen wie eine Spalte aus DataTable1hat, wird der Name der Spalte aus DataTable2 in der resultierenden Tabelle in [ColumnName]_1 geändert. Wenn bereits eine Spalte mit dem Namen [ColumnName]_1 vorhanden ist, wird stattdessen die fortlaufende Nummer verwendet, die noch nicht verwendet wird. Wenn DataTable1 beispielsweise Spalten mit den Namen ID, ID_1 und ID_2hat und DataTable2 eine Spalte mit dem Namen IDhat, heißt die Spalte in DataTable2 nach der Verknüpfung ID_3.

• Join-Regeln – 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 der Filter besteht.

Windows – Legacy, Windows-Konfiguration

Eigenschaften-Panel

Allgemein

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

Eingabe

• Datentabelle 1 – Die erste Tabelle, die Sie in der Verbindungsoperation verwenden möchten, gespeichert in einer DataTable-Variablen. Dieses Feld unterstützt nur DataTable-Variablen.
• Datentabelle2 – 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 Beitrittstyp 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 DataTable2 denselben Namen wie eine Spalte aus DataTable1hat, wird der Name der Spalte aus DataTable2 in der resultierenden Tabelle in [ColumnName]_1 geändert. Wenn bereits eine Spalte mit dem Namen [ColumnName]_1 vorhanden ist, wird stattdessen die fortlaufende Nummer verwendet, die noch nicht verwendet wird. Wenn DataTable1 beispielsweise Spalten mit den Namen ID, ID_1 und ID_2hat und DataTable2 eine Spalte mit dem Namen IDhat, heißt die Spalte in DataTable2 nach der Verknüpfung ID_3.

Ausgabe

• Datentabelle – 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 – Die DataTable-Variable, welche die erste Tabelle enthält, die Sie verwenden möchten.
• Eingabedatentabelle 2 – Die DataTable-Variable, welche die zweite Tabelle enthält, die Sie verwenden möchten.
• Ausgabedatentabelle – Die DataTable-Variable, 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:

• Spaltentabelle1 – 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
  • > - größer als
  • < - kleiner als
  • >= - größer gleich
  • <= - kleiner gleich
• Spaltentabelle2 – 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

Zur Erläuterung, wie man mit dieser Aktivität arbeitet, 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, dass 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: