For Each Excel Row

UiPath.Excel.Activities.Business.ExcelForEachRow

Führt eine oder mehrere Aktivitäten für jede Zeile in einem Bereich, einer Tabelle oder einem Blatt aus. Die Aktivität kann mit einer Excel-Datei verwendet werden, die für eine übergeordnete Use Excel File -Aktivität ausgewählt wurde, oder mit dem Projekt-Notebook.

Verwenden Sie diese Aktivität, wenn Sie mit einem Bereich oder Blatt mit mehreren Zeilen arbeiten und eine oder mehrere Aktivitäten für jede einzelne Zeile wiederholen möchten. Legen Sie die Aktivitäten fest, die in Excel für jede Zeile wiederholt werden sollen, und wählen Sie bei der Konfiguration der Aktivitäten im Plus die Option AktuelleZeile aus um anzugeben, dass Sie die Aktionen für jede Zeile in der Iteration wiederholen möchten.

Für die meisten Aktivitäten müssen Sie auch eine bestimmte Spalte auswählen, die aus jeder Zeile verwendet werden soll. Informationen dazu, welche Optionen zum Angeben der Spalte in Abhängigkeit von Ihrer Bereichsauswahl verfügbar sind, finden Sie unter Funktionsweise der Bereichsauswahl. Sie können die Spalte auch mit der Option In Excel angeben unter CurrentRow angeben. In diesem Fall können Sie eine beliebige Zelle aus der Spalte auswählen, die Sie direkt aus der Datei verwenden möchten.

Informationen zur Verwendung dieser Aktivität finden Sie unter:

• Tutorial: Durchlaufen von Zeilen in einer Tabelle
• Tutorial: Arbeiten mit Word-Automatisierung

Konfigurieren der Aktivität

Im Textkörper der Aktivität

• For each – Geben Sie einen Namen ein, der für die aktuelle Zeile in der Iteration verwendet werden soll. Die Verwendung eines Namens, der die Zeilen im Bereich beschreibt, erleichtert das Identifizieren und Auswählen der aktuellen Zeile in der Iteration beim Konfigurieren von Aktivitäten, die in „Excel For Each Row“ eingefügt werden. Für einen Bereich mit Informationen über einen anderen Lieferanten in jeder Zeile können Sie z. B. Supplier eingeben. Der Standardwert ist CurrentRow.

  Wenn zwei „Excel For Each Row“-Aktivitäten innerhalb der anderen hinzugefügt werden und dieser Name für beide derselbe ist, wird nur die Option für die nächste im Plusangezeigt für untergeordnete Aktivitäten.

• In Bereich – Klicken Sie auf das Plus rechts neben dem Feld und wählen Sie dann im Menü den Bereich, die Tabelle oder das Blatt aus, das verwendet werden soll, oder wählen Sie In Excel angeben aus , um die Datei zu öffnen und einen Bereich direkt in der Datei auszuwählen. Alternativ können Sie Benutzerdefinierte Eingabe auswählen, um den Bereich, Tabellennamen oder Blattnamen manuell einzugeben, oder Im erweiterten Editor öffnen , um einen VB-Ausdruck einzugeben.
• Hat Header – Wenn diese Option ausgewählt ist, wird angegeben, dass die erste Zeile des Bereichs eine Headerzeile ist. Wenn Sie dann die Aktivitäten konfigurieren, die Sie in „Excel For Each Row“ hinzufügen, können Sie die Daten, die aus der aktuellen Zeile ausgewählt werden sollen, leicht anhand der Spaltenheader identifizieren.
• Nach jeder Zeile speichern – Wenn diese Option ausgewählt ist, wird die Excel-Datei während der Projektausführung gespeichert, nachdem jede Zeile in der Iteration verarbeitet wurde. Wenn diese Option nicht ausgewählt ist, wird die Datei erst gespeichert, sobald alle Zeilen in der Iteration verarbeitet wurden. Diese Option ist standardmäßig nicht ausgewählt.

Eigenschaften-Panel

Allgemein

• Anzeigename – Der Name, der für die Aktivität im Designerbereich angezeigt wird.

Sonstiges

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

Optionen

• Verhalten bei leeren Zeilen – Wählen Sie aus, wie sich die Automatisierung verhalten soll, wenn eine leere Zeile gefunden wird:

  • NachDreiAufeinanderfolgendenLeerenZeilenAnhalten – Die Iteration wird nach drei aufeinanderfolgenden leeren Zeilen angehalten. Dies ist die Standardoption.
  • Anhalten – Hält die Iteration durch Zeilen an.
  • Überspringen – Überspringen Sie die leere Zeile und gehen Sie zur nächsten Zeile über.
  • Prozess – Verarbeiten der leeren Zeile.
• HasHeaders: Siehe Hat Überschriften im Textkörper der Aktivität.
• In Bereich – Siehe In Bereich im Textkörper der Aktivität.
• Jede Zeile speichern – Siehe Jede Zeile speichern im Textkörper der Aktivität.

Funktionsweise der Bereichsauswahl

StudioX ermöglicht es Ihnen, den Zielbereich einer Aktivität „Excel For Each Row“ auf verschiedene Arten zu definieren. Im Folgenden wird beschrieben, wie unterschiedliche Auswahlen für In Bereich den Bereich beeinflussen, der von den in Excel For Each Row hinzugefügten Aktivitäten verwendet wird. Darüber hinaus werden die verfügbaren Optionen beschrieben, mit denen angegeben werden kann, welche Spalte der aktuellen Zeile verwendet werden soll.

Gesamtes Blatt

Auswahlbeispiel: [Excel]Sheet1

• Verwendeter Bereich: Alle Zeilen, in denen Daten im Blatt vorhanden sind.

• Aktuelle Zeilenoptionen:

  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in Zeile 1 des Blatts.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Spaltenbuchstaben (A, B, C usw.).

Tabelle

Auswahlbeispiel: [Excel]Sheet1!Table1

• Verwendeter Bereich: Alle Zeilen in der ausgewählten Tabelle.
• Aktuelle Zeilenoptionen: Die Werte im Tabellenheader, unabhängig davon, ob „Hat Header“ in „Excel For Each Row“ ausgewählt ist oder nicht.

Benannter Bereich

Auswahlbeispiel: [Excel]Sheet1!Range1

• Verwendeter Bereich: Alle Zeilen im ausgewählten Bereich.
• Aktuelle Zeilenoptionen:
  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in der ersten Zeile des Bereichs.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Spaltenindizes die Optionen (Spalte 1, Spalte 2 usw.).

Unbenannter Bereich

Auswahlbeispiel: [Excel]Sheet1!B3:F10

• Verwendeter Bereich: Alle Zeilen im ausgewählten Bereich.
• Aktuelle Zeilenoptionen:
  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in der ersten Zeile der Auswahl.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Spaltenindizes die Optionen (Spalte 1, Spalte 2 usw.).

Gesamte Spalten

Auswahlbeispiel: [Excel]Sheet1!B:F

• Verwendeter Bereich: Die Zeilen in den ausgewählten Spalten, in denen Daten im Blatt vorhanden sind, einschließlich der Zeilen, in denen Daten in anderen Spalten als den ausgewählten vorhanden sind.
• Aktuelle Zeilenoptionen:
  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in der ersten Zeile der Spalten.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Spaltenindizes die Optionen (Spalte 1, Spalte 2 usw.).

Gesamte Zeilen

Auswahlbeispiel: [Excel]Sheet1!3:10

• Verwendeter Bereich: Die Zellen, in denen Daten in den ausgewählten Zeilen vorhanden sind.
• Aktuelle Zeilenoptionen:
  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in der ersten Zeile der Auswahl.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Spaltenindizes die Optionen (Spalte 1, Spalte 2 usw.).

Einzelzelle

Auswahlbeispiel: [Excel]Sheet1!B3

• Verwendeter Bereich: Aktivitäten identifizieren einen Bereich, der mit der ausgewählten Element als obere linke Ecke beginnt und erweitern den Bereich nach rechts und unten, solange Daten auf dem Blatt vorhanden sind. Wenn die Auswahl beispielsweise Sheet1!B3 ist und Sheet1 Daten bis zur Spalte AC und Zeile 115 enthält, verwenden Aktivitäten innerhalb „Excel For Each Row“ den berechneten Bereich B3:AC115.

  Befindet sich die ausgewählte Zelle rechts von der letzten Spalte mit Daten oder unterhalb der letzten Zeile mit Daten, werden nur die Daten in der ausgewählten Zelle verwendet.

• Aktuelle Zeilenoptionen:

  • Wenn „Hat Header“ in „Excel For Each Row“ ausgewählt ist, sind die Optionen die Werte in der ersten Zeile der Auswahl.
  • Wenn „Hat Header“ nicht in „Excel For Each Row“ ausgewählt ist, sind die Spaltenindizes die Optionen (Spalte 1, Spalte 2 usw.).

Hinweis: Die oben genannten Auswahlbeispiele können sich in StudioX unterscheiden. Das hängt davon ab, ob Sie einen Ausdruck für eine Eigenschaft festlegen oder die Ausdrucksvorschau anzeigen.