Datentabelle filtern (Filter Data Table)

UiPath.Core.Activities.FilterDataTable

Aktiviert das Filtern einer DataTable-Variable durch Angabe von Bedingungen im Fenster Filter-Assistent (Filter Wizard). Die Aktivität kann Zeilen oder Spalten entsprechend den logischen Bedingungen, die im Assistenten angegeben sind, beibehalten oder löschen. Der Textkörper dieser Aktivität enthält einen Filter-Assistent (Filter Wizard), damit Sie auf den Assistenten zugreifen und Ihre Einstellungen jederzeit ändern können.

Wichtig: Aufgrund interner Änderungen wird diese Aktivität nach dem Upgrade auf v20.4 oder neuere Versionen nicht mehr in der Favoritenliste angezeigt, wenn sie mit v19.4 oder einer älteren Version von UiPath.System.Activities zur Favoritenliste hinzugefügt wurde.

Projektkompatibilität

Windows – Legacy | Plattformübergreifend

Plattformübergreifende Konfiguration

Eigenschaften

• Datentabelle – Die Variable DataTable, die Sie filtern möchten. Dieses Feld unterstützt nur DataTable-Variablen.
• Filterbedingungen – Die Bedingungen, nach denen die Datentabelle gefiltert wird.

Erweiterte Optionen

• Aktion – Gibt an, ob die Tabelle durch Beibehalten oder Entfernen von Zielzeilen gefiltert werden soll.
• Tabelle mit gefilterten Daten – Die resultierende Tabelle mit gefilterten Daten.

• Erste Zeile – Die erste Zeile der Datentabelle, die den konfigurierten Filtern entspricht.

  
  

  

  
  

Windows – Legacy, Windows-Konfiguration

Eigenschaften

Allgemein

• DisplayName - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Zeichenfolgen oder String -Variablen.

Eingabe

• Datentabelle – Die Variable DataTable, die Sie filtern möchten. Dieses Feld unterstützt nur DataTable-Variablen.

Sonstiges

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

Optionen

• FilterZeilenModus (FilterRowsMode) - Gibt an, ob die Tabelle durch Beibehalten oder Entfernen von Zielzeilen gefiltert werden soll. Wählen Sie eine der zwei Optionen aus dem Dropdown-Menü aus: Behalten oder Entfernen. Der Standardwert ist Behalten.
• SpaltenModusAuswählen – Gibt an, ob die Tabelle durch Beibehalten oder Entfernen der Zielspalten gefiltert werden soll. Wählen Sie eine der zwei Optionen aus dem Dropdown-Menü aus: Behalten oder Entfernen. Der Standardwert ist Behalten.

Ausgabe

• Datentabelle – Die resultierende gefilterte DataTable-Variable. Wenn Sie die gleiche Variable wie die im Feld „Eingabe“ platzieren, wird die ursprüngliche Variable überschrieben, während beim Hinzufügen einer neuen Variable die ursprüngliche Variable nicht geändert wird. Dieses Feld unterstützt nur DataTable-Variablen.
  Hinweis:

  • Wenn Sie eine benutzerdefinierte Aktivität vom Typ Datentabelle filtern (Filter Data Table) kopieren und einfügen, wird ihre Konfiguration nicht übernommen.
  • Excel-Bereiche werden nicht als Eingabe für diese Aktivität unterstützt.

Filter-Assistent (Filter Wizard)

Mit diesem Assistenten können Sie die Filteroptionen für eine DataTable-Variable erstellen. Er wird über die Schaltfläche „Filter-Assistent“ im Textkörper der Aktivität im Designerbereich geöffnet. Sie können den zu ändernden DataTable sowie alle anderen, bei denen Sie Änderungen speichern möchten, in den folgenden Feldern auswählen:

• Datentabelle eingeben – Die Variable DataTable, die Sie filtern möchten. Dieses Feld unterstützt nur DataTable-Variablen.
• Datentabelle ausgeben – Die Ausgabe der Variable DataTable. Wenn die gleiche Variable bereits im Feld „Eingabe“ verwendet wurde, wird sie mit den Änderungen überschrieben. Das Bereitstellen einer anderen Variable ändert nicht die Eingabevariable.

Abhängig von der gewählten Registerkarte können Sie auch auswählen, ob Sie nach Zeile (Row) oder Spalte (Column) sortieren möchten. Die folgenden zwei Registerkarten stehen zur Verfügung:

Filter Zeilen Registerkarte Feldbeschreibungen (Filter Rows Tab Field Descriptions)

Die Registerkarte „Zeilen filtern“ ermöglicht das Filtern einer DataTable nach Zeilen. Dazu haben Sie die folgenden Optionen:

1. Übereinstimmende Zeilen beibehalten oder entfernen – Gibt an, ob die gefilterten Zeilen behalten oder entfernt werden sollen. Dies ist über die Optionsfelder Behalten oder Entfernen auswählbar. Wenn Sie Behalten auswählen, werden nur die Zeilen behalten, welche die angegebene Bedingung erfüllen. Wenn Sie Entfernen auswählen, werden die Zeilen entfernt, welche die angegebene Bedingung erfüllen.
2. Und/Oder (And/Or) - Gibt die logischen Verbindungen an, die zwischen Bedingungen verwendet werden sollen. Diese Schaltfläche wird nur angezeigt, wenn Sie mehrere Bedingungen haben. Wenn Sie eine neue Bedingung hinzufügen, wird die Schaltfläche standardmäßig als Und (And)angezeigt. Klicken Sie auf die Schaltfläche, um den Wert in Oder (Or) zu ändern.
3. Spalte (Column) - Der Name oder Index der Spalte, die die Bedingung erfüllen soll.
4. Vorgang (Operation) - Die logische Bedingung, die zwischen Spalte (Column) und dem Wert (Value) erfüllt sein muss.
5. Wert (Value) - Der Wert, der für Vorgang (Operation) und Spalte (Column) geprüft werden soll.
6. Bedingung hinzufügen/entfernen – Wenn Sie auf die Schaltfläche + klicken, wird der Bedingung ein weiterer Satz hinzugefügt, während durch Klicken auf die Schaltfläche x ein Satz entfernt wird.
   Hinweis: Wenn eine Variable im Textfeld „Spalte“ angegeben wird, können Sie eine Variable Int32 zur Angabe eines Spaltenindex verwenden oder eine Variable String, um den Spaltennamen anzugeben.

Ausgabe

Auf der Registerkarte Ausgabespalten können Sie eine DataTable nach Spalten filtern. Dazu haben Sie die folgenden Optionen:

1. Spaltenauswahlmodus – Gibt an, ob die gefilterten Spalten behalten oder entfernt werden sollen. Dies ist über die Optionsfelder „Behalten“ oder „Entfernen“ auswählbar. Wenn Sie „Behalten“ auswählen, werden nur die Spalten beibehalten, die die Bedingung unten erfüllen. Mit „Entfernen“ löschen Sie die unten angegebenen Zeilen aus der Eingabe DataTable.
2. Spalte – Die Spalten, die Sie in Ihrer DataTable beibehalten oder entfernen möchten.
   Hinweis: Wenn eine Variable im Textfeld Spalte angegeben wird, können Sie eine Variable Int32 zur Angabe eines Spaltenindex verwenden oder eine Variable String, um den Spaltennamen anzugeben.
3. Spalten hinzufügen/entfernen – Wenn Sie auf die Schaltfläche + klicken, wird eine weitere Spalte hinzugefügt, während durch Klicken auf die Schaltfläche x eine Spalte entfernt wird.
   Hinweis: Die Reihenfolge der Spalten in der Ausgabetabelle entspricht der Reihenfolge, in der Sie die Spalten im Assistenten hinzugefügt haben.

Verwendungsbeispiel der „Filter Data Table“-Aktivität

Hier sehen Sie, wie die Aktivität Filter Data Table in einem Beispiel verwendet wird, das mehrere Aktivitäten enthält.