List-package

Das Liste-package enthält actions, die es ermöglichen, verschiedene Operationen mit einer Variablen vom Datentyp Liste durchzuführen.

Arbeiten mit Variablen des Datentyps Liste

Eine Liste ist eine Sammlung von geordneten Werten. Die Werte können vom Untertyp Boolescher Wert, Ziffer oder Zeichenfolge sein. Wenn Sie eine Listenvariable initialisieren, können Sie die Option Beliebig wählen, um einen der drei Daten-Untertypen aufzunehmen. Sie können Werte manuell eingeben, indem Sie eine neue Variable erstellen oder eine vorhandene Variable aus dem Menü Variablen auswählen und dann auf Hinzufügen klicken.

Häufige Anwendungen für Listenvariablen sind u. a.:

Versenden einer E-Mail an mehrere Empfänger
Durchsuchen mehrerer Web-Adressen

Actions des Liste-packages

Wenn Sie eine action Liste in einer action Schleife verwenden, müssen Sie den Iterator Für jedes Element in der Liste verwenden.

Die folgenden actions sind im Liste-package verfügbar:


Action	Beschreibung
Element hinzufügen	Fügt ein Element in eine Listenvariable ein. Sie können wählen, ob Sie das Element am Ende der Liste hinzufügen oder eine Position in der Liste angeben. Wählen Sie die Listenvariable, in die ein Element aus der Liste Listenvariable eingefügt werden soll. Wählen Sie die Variable, die den hinzuzufügenden Wert enthält, aus der Liste Hinzuzufügendes Element. Anmerkung: Die Variable muss vom gleichen Datenuntertyp sein wie die anderen Listenelemente. Wählen Sie die Option Zum Ende der Liste, um das Element am Ende der Liste einzufügen, oder wählen Sie Am Listenindex, um den Index in der Liste anzugeben, an dem das Element eingefügt werden soll. Der Listenindex beginnt bei 0. Der erste Eintrag in der Liste steht an Position 0, der zweite Eintrag an Position 1, usw. Um zum Beispiel ein Element an der vierten Position in einer Liste hinzuzufügen, geben Sie `3` in das Feld Am Listenindex ein.
Anhängen	Fügt eine Listenvariable in dem Spaltenindex einer Datentabelle hinzu. Sie können wählen, ob Sie die Listenvariable am Anfang oder am Ende hinzufügen oder eine Position in der Datentabelle angeben wollen. Wählen Sie die Listenvariable aus, die den hinzuzufügenden Wert enthält. Wählen Sie im Feld Ergebnis zur Datentabelle zuweisen eine Tabellenvariable aus, die Sie zum Speichern der Ausgabe verwenden möchten. Wählen Sie eine der folgenden Optionen, um eine Spalte mit Index einzufügen: Erster Index: Setzt den Wert an die erste Position (Index 0) in einer Datentabelle. Letzter Index: Setzt den Wert ans Ende der Datentabelle. Spezifischer Index: Geben Sie den Index an, in den Sie den Spaltenindex eingeben wollen. Um zum Beispiel einen Wert für die erste Spalte festzulegen, geben Sie `0` ein. Die Indexnummer beginnt bei 0. Das erste Element in der Datentabelle steht an Position 0, das zweite Element an Position 1, usw. Um zum Beispiel ein Element an der dritten Position in einer Datentabelle hinzuzufügen, geben Sie `2` in das Feld Spezifischer Index ein.
Zuweisen	Weist den Wert der Quellliste der Ziellistenvariablen zu. Wählen Sie die Quelllisten-Variable aus der Dropdown-Liste aus oder erstellen Sie eine neue Listenvariable. Wählen Sie eine Listenvariable aus oder erstellen Sie eine Variable, um die Ausgabe zu speichern.
Löschen	Löscht alle Elemente aus der ausgewählten Listenvariable.
Element abrufen	Ruft einen Wert an der angegebenen Position in einer Liste ab und speichert die Ausgabe in einer Variablen. Wählen Sie die Listenvariable, von der Sie einen Wert aus der Liste Listenvariable abrufen möchten. Geben Sie die Position in der Liste an, ab der Sie den Wert im Feld Indexnummer abrufen möchten. Der Listenindex beginnt bei 0. Der erste Eintrag in der Liste steht an Position 0, der zweite Eintrag an Position 1, usw. Wählen Sie in der Liste Ausgabe einer Variablen zuweisen die Variable aus, die Sie zum Speichern der Ausgabe verwenden möchten.
Elemente verbinden	Verbindet alle verfügbaren Werte in einer Listenvariablen und speichert die Ausgabe in einer Zeichenfolgenvariablen. Sie können das Trennzeichen angeben, das Sie in der Ausgabe als Trennzeichen verwenden möchten. Wählen Sie die zu verwendende Listenvariable aus der Liste Listenvariable aus. Geben Sie im Feld Trennzeichen das Trennzeichen an, das Sie zur Trennung der Werte in der Ausgabe verwenden möchten. Wählen Sie in der Liste Ausgabe einer Variablen zuweisen die Variable aus, die Sie zum Speichern der Ausgabe verwenden möchten.
Element entfernen	Entfernt ein Element aus einer Liste und weist die Ausgabe einer Variable zu. Wählen Sie die Listenvariable, aus der Sie ein Element aus der Listenvariable-Liste entfernen möchten. Geben Sie die Position in der Liste an, ab der Sie den Wert im Feld Indexnummer entfernen möchten. Der Listenindex beginnt bei 0. Der erste Eintrag in der Liste steht an Position 0, der zweite Eintrag an Position 1, usw. Wählen Sie in der Liste Ausgabe einer Variablen zuweisen die Variable aus, die Sie zum Speichern der Ausgabe verwenden möchten.
Element festlegen	Setzt ein Element an eine bestimmte Position in einer Liste und speichert die Ausgabe in einer Variablen. Wählen Sie aus der Liste Listenvariable die Listenvariable aus, für die Sie einen Wert festlegen möchten. Geben Sie im Feld Indexnummer die Position in der Liste an, an der Sie das Element festlegen möchten. Der Listenindex beginnt bei 0. Der erste Eintrag in der Liste steht an Position 0, der zweite Eintrag an Position 1, usw. Wählen Sie in der Liste Ausgabe einer Variablen zuweisen die Variable aus, die Sie zum Speichern der Ausgabe verwenden möchten.
Größe	Ermittelt die Anzahl der Elemente in einer Liste und ordnet die Ausgabe einer Zahlenvariablen zu. Wählen Sie die Listenvariable, für die Sie die Größe abrufen möchten, aus der Liste Listenvariable aus. Wählen Sie eine Zahlenvariable, die Sie zum Speichern der Ausgabe verwenden möchten, aus der Liste Weist die Anzahl der Elemente einer Variablen zu.

Beispiel

Erstellen Sie einen bot, um einer Liste Elemente hinzuzufügen und Daten aus einer Liste abzurufen. Führen Sie die folgenden Schritte aus, um diese Funktionalität zu erreichen:

Erstellen Sie einen bot.
1. Klicken Sie im linken Feld auf Automatisierung.
  Eine Liste der verfügbaren bots und Formulare wird angezeigt.
2. Klicken Sie auf Bot erstellen.
3. Geben Sie den Namen des bots ein: ListBot
4. Klicken Sie auf Erstellen und Bearbeiten.
Erstellen Sie die folgenden Variablen:
- Variable: StringList
  - Typ: Liste
  - Untertyp: Zeichenfolge
  - Name: StringList
  - Standardwert bei 0: Automation
  - Standardwert bei 1: Anywhere
- Variable: SampleString
  - Name: SampleString
  - Standardwert: PvtLtd
- Variable: ListOutput
  - Typ: Beliebig
  - Name: ListOutput
Um ein Element in eine Listenvariable einzufügen, doppelklicken Sie im Bereich Aktionen auf die action Liste > Element hinzufügen oder ziehen Sie sie.
Um einen Wert an einer bestimmten Position in einer Liste abzurufen, doppelklicken Sie im Bereich Aktionen auf die action Liste > Abrufen oder ziehen Sie sie.
1. Wählen Sie im Feld Listenvariable die Option StringList.
2. In das Feld Indexnummer geben Sie 0 ein. Damit geben Sie die Position in der Liste an, ab der Sie einen Wert abrufen möchten.
3. Um die Ausgabe von Ausgabe einer Variablenliste zuweisen zu speichern, wählen Sie ListOutput.
Um den Wert des Index 0 zu drucken, doppelklicken oder ziehen Sie die action Nachrichtenfeld. Klicken Sie auf Speichern und Ausführen.
Der bot zeigt die Nullindexdaten der Listenvariablen an, also Automation.

Automation 360