Iteratorbezogene Bedingungen

Ein Schleifeniterator ist eine Variable, die die aktuelle Iteration innerhalb einer Schleife verfolgt. Er wird verwendet, um die Anzahl der Ausführungen der Schleife zu steuern und während jeder Iteration auf Elemente in einer Liste oder einem Array zuzugreifen.

Wenn Sie beispielsweise eine Liste von Elementen durchlaufen, können Sie mit dem Schleifeniterator nacheinander auf jedes Element zugreifen, bis die Schleife abgeschlossen ist. Das Schleife-Paket bietet mehrere Iteratorbedingungen zur Steuerung der Iteration von Schleifen.
Tabelle 1. Schleifeniteratoren
Iterator Beschreibung
Für jede Zeile in CSV/TXT Wiederholt den Satz an Aktionen für jede Zeile in der angegebenen CSV- oder Textdatei und weist die Werte in der aktuellen Zeile einer Datensatzvariablen zu. Einzelheiten finden Sie unter Verwenden des Iterators „Für jede Zeile in CSV/TXT“.
Für jede Zeile in Datentabelle Wiederholt den Satz an Aktionen für jede Zeile in der angegebenen Tabelle und weist die Werte in der aktuellen Zeile einer Datensatzvariablen zu. Einzelheiten finden Sie unter Verwendung des Iterators „Für jede Zeile in der Tabelle“.
Für jede Zeile eines SQL-Abfrage-Datasets Wiederholt den Satz an Aktionen für jede Zeile im angegebenen SQL-Abfragedatensatz und weist die Werte in der aktuellen Zeile einer Datensatzvariablen zu. Geben Sie den Sitzungsnamen an, mit dem Sie eine Verbindung zur Datenbank hergestellt haben.
Für jeden Schlüssel im Wörterbuch Wiederholt den Satz an Aktionen für jeden Schlüssel in der angegebenen Wörterbuchvariablen und weist den Namen des aktuellen Schlüssels einer Variablen zu.
Anmerkung: Wenn ein Bot eine Schleife-Aktion durchführt, die eine Wörterbuch > Setzen-Aktion enthält, gibt der Bot nur die ursprüngliche Anzahl der Elemente in einem Wörterbuch aus; er ignoriert Elemente, die mit der Setzen-Aktion eingefügt wurden.
Für jeden Wert im Wörterbuch Wiederholt der Satz an Aktionen für jeden Wert in der angegebenen Wörterbuchvariablen und weist den aktuellen Wert einer Variablen zu. Da dieser Variablentyp verschiedene Untertypen (String, Number, Boolean usw.) enthalten kann, wird bei der Schnellanlage einer Variablen bei der Konfiguration der Aktion diese dem Typ Any zugeordnet.
Anmerkung: Wenn ein Bot eine Aktion Schleife durchführt, die eine Wörterbuch > Setzen-Aktion enthält, gibt der Bot nur die ursprüngliche Anzahl der Elemente in einem Wörterbuch aus; er ignoriert Elemente, die mit der SetzenAktion eingefügt wurden.
Für jede E-Mail im Postfach Wiederholt das Set an Aktionen für jede E-Mail im angegebenen Postfach. Einzelheiten finden Sie unter Verwendung des Iterators „Für jede E-Mail im Postfach“.
Für jede Zeile im Arbeitsblatt (Excel Basic oder Excel Advanced) Wiederholt den Satz an Aktionen für jede Zeile, die Daten in einem Arbeitsblatt enthält, und weist die Werte in der aktuellen Zeile einer Datensatzvariablen zu. Geben Sie den Namen der Sitzung an, die Sie zum Öffnen des Excel Basic- oder Excel Advanced-Arbeitsblattes verwendet haben. Geben Sie an, ob die Aktionen für alle Zeilen, spezifische Zeilen oder einen bestimmten Zellbereich wiederholt werden soll. Wählen Sie eine Datensatzvariable aus der Liste Aktuelle Zeile dieser Variablen zuweisen aus oder erstellen Sie eine neue Variable. Einzelheiten finden Sie unter Datensatzvariable.
Dieser Iterator ruft Zellwerte als String-Datentypen ab. Er unterstützt Excel-Zellenformate, einschließlich Zahlen, Prozentsätze, Währungen, wissenschaftliche Daten und Datum. So behält beispielsweise ein Wert aus einer Zelle mit Währungsformatierung das Währungssymbol bei, wenn er an eine Tabellen- oder Datensatzvariable übergeben wird.
  • Sie müssen die Werte konvertieren, um Nicht-String-Operationen durchführen zu können.
  • Wenn Sie in Excel Advanced den Schleifeniterator als Für jede Zeile im Arbeitsblatt auswählen, haben Sie eine Lesen-Option, um entweder den sichtbaren Text oder den Wert der Zelle zu lesen.

    Zum Beispiel, wenn die Zelle 70 % als Zellinhalt hat, liest die Option Zellenwert lesen den Wert als 70 und ignoriert dabei das %-Format, während die Option Sichtbaren Text lesen den Inhalt als 70 % liest.

    Empfehlung: Verwenden Sie die Option Zellenwert lesen als Lesewert, um eine bessere Leistung als beim Lesen von sichtbarem Text in einer Zelle zu erzielen.

Die Verwendung der Globale Sitzung-Option zur gemeinsamen Nutzung einer Microsoft Excel-Sitzung mit dem Excel Advanced-Paket ist mit dieser Option nicht verfügbar.

Alternative Lösung: Verwenden Sie die Mehrere Zellen abrufen-Aktion und speichern Sie die Daten in einer Datentabellenvariablen und verwenden Sie dann das Schleife-Paket und wählen Sie dafür die Option Datentabelle aus.
Für jede Datei im Ordner Wiederholt das Set an Aktionen für jede Datei im angegebenen Ordner und weist die Eigenschaften der aktuellen Datei einer Wörterbuchvariablen zu, die zwei Schlüssel enthält: der Schlüssel name enthält den Dateinamen und der Schlüssel extension enthält die Dateierweiterung.

Um Dateien mit unterschiedlichen Erweiterungen zu öffnen, verwenden Sie die Variablenoption, um den Ordnerpfad, den Dateinamen und die Dateierweiterung zuzuweisen. Erstellen Sie zunächst eine Variable für den Ordnerpfad, $sOrdner$. Erstellen Sie dann für die Dateien im Ordnerpfad zwei Variablen, eine für den Dateinamen $Name$ und eine weitere für die Dateierweiterung $Erweiterung$. Um eine Datei zu öffnen, kombinieren Sie die Variablen zu einer Zeichenfolge, z. B $sOrdner$\$Name$.$Erweiterung$. Damit die Erweiterung mit verschiedenen Dateitypen und unterschiedlichen Öffnungsoptionen arbeiten kann, können Sie eine bedingte Logik hinzufügen.
Für jeden Ordner im Ordner Wiederholt den Satz an Aktionen für jeden Ordner im angegebenen Ordner und weist den aktuellen Ordnernamen einer Zeichenfolgevariablen zu.

Verwenden Sie die Option Alle Unterordner einbeziehen, um rekursiv jeden Unterordner innerhalb eines Ordners zu durchlaufen, einschließlich versteckter Ordner.
Für jedes Element in der Liste Wiederholt den Satz an Aktionen für jedes Element in der angegebenen Liste und ordnet das aktuelle Element einer Variablen zu. Geben Sie an, ob die Wiederholung der Aktion für alle Elemente in der Liste oder nur für den Bereich der Elemente in der Liste durchgeführt werden soll. Da dieser Variablentyp verschiedene Untertypen (Zeichenfolge, Nummer, boolescher Wert usw.) enthalten kann, wird bei der Schnellanlage einer Variablen bei der Konfiguration der Aktion diese dem Typ „Beliebig“ zugeordnet.
Anmerkung: Der Index in einer Liste beginnt bei Null. Um zum Beispiel die Aktion für Elemente von der dritten bis zur sechsten Position der Liste zu wiederholen, geben Sie 2 und 5 in den entsprechenden Feldern an.
für n-mal Wiederholt die Aktionen im Container die angegebene Anzahl an Wiederholungen. Sie können die Iterationsanzahl einer Zahlenvariablen zuweisen.
Für jeden Wert im Datensatz Wiederholt die Aktionen für jeden Wert im angegebenen Datensatz und weist den aktuellen Wert einer Variablen zu. Da dieser Variablentyp verschiedene Untertypen (String, Number, Boolean usw.) enthalten kann, wird bei der Schnellanlage einer Variablen bei der Konfiguration der Aktion diese dem Typ Any zugeordnet.
Für jede Besprechung im Kalender. Verwenden Sie diese Option, um den Satz an Aktionen für jede Besprechung im angegebenen Kalender zu wiederholen. Einzelheiten finden Sie unter Microsoft 365-Kalender-Aktionen in einer Schleife verwenden.
Für jede Zeile im Arbeitsblatt (Microsoft 365 Excel) Wiederholt den Satz an Aktionen für jede Zeile, die Daten in einem Arbeitsblatt enthält.
  • Geben Sie den Namen der Sitzung an, die Sie zum Öffnen des Arbeitsblatts verwendet haben.
  • Geben Sie an, ob die Wiederholung der Aktionen für alle Zeilen oder für spezifische Zeilen durchgeführt werden soll.
  • Sie können die Werte in der aktuellen Zeile einer Datensatzvariablen zuweisen.
Für jede E-Mail im Postfach (Microsoft 365 Outlook) Wiederholt das Set an Aktionen für jede E-Mail im Microsoft 365 Outlook-Posteingang.
  • Geben Sie den Sitzungsnamen an, den Sie in der Verbinden-Aktion verwendet haben.
  • Geben Sie den Status der E-Mail an, den Sie für den Iterator verwenden möchten. Um ihn beispielsweise auf E-Mails anzuwenden, die Sie noch nicht gelesen haben, wählen Sie Ungelesen.
  • Legen Sie die Reihenfolge fest, in der die E-Mails sortiert werden sollen, indem Sie eine der folgenden Optionen im Feld E-Mails sortieren auswählen:
    • Neuste zuerst: Wenn die Microsoft 365 Outlook Paket-Version auf 1.6.1 oder höher aktualisiert wird, wird diese Einstellung für bestehende und neue Automatisierungen aktiviert, und alle E-Mails im Postfach werden standardmäßig nach dem LIFO-Verfahren sortiert.
    • Älteste zuerst: Diese Einstellung aktiviert die FIFO-Methode zum Sortieren der E-Mails im Postfach. Diese Einstellung gilt für alle Microsoft 365 Outlook-Aktionen, die mithilfe von Schleifen-Iteratoren durchgeführt werden können, wie zum Beispiel:
      • Status ändern
      • Löschen
      • Weiterleiten
      • Antworten
      • Anlage speichern in
      • E-Mail speichern
  • Stellen Sie das Nachrichtenformat entweder auf HTML oder Nur-Text ein.
  • Wählen Sie eine bestimmte Zeitzone aus.
Für jedes Aufgabenelement in der Warteschlange (Workload) Wiederholt den Satz von Aktionen für jedes Aufgabenelement in einer Warteschlange und weist die Aufgabenelemente der Datensatzvariable zu. Die Datensatzvariable gibt drei feste Schlüsselwerte zurück, nämlich workitemId, workitemValues und workitemMetadata. Einzelheiten finden Sie unter Verwenden des Iterators „Für jedes Aufgabenelement in der Warteschlange“.
Für jeden Knoten in einem XML-Dataset Wiederholt den Satz an Aktionen für jeden Knoten in einem XML-Dataset und weist den aktuellen Knoten einer Zeichenfolgevariablen zu. Geben Sie den Namen der Sitzung an, die Sie zum Öffnen der XML-Datei verwendet haben.