Variablenaktionen

Um manuell eine Variable in einem Desktop-Flow zu erstellen, stellen Sie die Aktion Variable festlegen bereit. Um diese Aktion verwenden zu können, müssen Sie für die neue Variable einen Namen und einen Wert angeben.

Wichtig

Reservierte Schlüsselwörter können nicht als Variablennamen verwendet werden. Die vollständige Liste der reservierten Schlüsselwörter finden Sie unter Reservierte Schlüsselwörter in Desktop-Flows.

Um den numerischen Wert einer Variablen zu erhöhen oder zu verringern, verwenden Sie die Aktionen Variable erhöhen bzw. Variable verringern.

Die meisten Aktionen geben ihr Ergebnis in eine Variable aus. Die Aktion Neue Liste erstellen erzeugt zum Beispiel eine leere Liste.

Die Aktion Zufallszahl generieren erzeugt in ähnlicher Weise einen zufälligen numerischen Wert. Wenn Sie Mehrere Zahlen generieren in dieser Aktion aktivieren, können Sie eine Listenvariable erstellen, die mehrere zufällige numerische Werte enthält.

Um Elemente zu einer vorhandenen Liste hinzuzufügen, stellen Sie die Aktion Element zur Liste hinzufügen bereit und geben Sie einen hartcodierten Wert oder eine Variable ein, um das hinzuzufügende Element zu definieren. Sie können ebenso Elemente mit der Aktion Element aus Liste entfernen von einer Liste entfernen.

Notiz

Listenindexe beginnen bei 0, was bedeutet, dass das erste Element in der Liste immer einen Index von 0 hat. Verwenden Sie die Notation %%ListName[0]%%, um sich auf das erste Element in der Liste zu beziehen, %%ListName[1]%% auf das zweite und so weiter.

Wenn Sie eine Datentabellenvariable erstellen möchten, stellen Sie die Aktion Neue Datentabelle erstellen bereit und geben Sie die Anfangselemente davon mit dem visuellen Generator an.

Um eine Datentabellenvariable zu bearbeiten, verwenden Sie die Aktionen der entsprechenden Aktionsuntergruppe, wie z. B. die Aktionen In Datentabelle suchen oder ersetzen und Element der Datentabelle aktualisieren.

Neue Datentabelle erstellen

Erstellt eine neue Datentabellenvariable.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Neue Tabelle	Nein	Datentabelle		Die Eingabedatentabelle

Erzeugte Variablen

Argument	Type	Beschreibung
DataTable	Datentabelle	Die neue Datentabelle

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Zeile in Datentabelle einfügen

Fügt eine Zeile am Ende oder vor einem bestimmten Indexwert ein.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss zuvor durch eine Aktion angegeben werden, die eine Datentabellenvariable erzeugt
In Position	Nicht zutreffend	Ende der Datentabelle, vor dem Zeilenindex	Ende der Datentabelle	Geben Sie an, ob die neue Zeile am Ende der Datentabelle oder vor einem bestimmten Zeilenindex eingefügt werden soll
Zeilenindex	Nein	Numerischer Wert		Fügt den Zeilenindexwert ein, der verwendet werden soll, wenn vorher der Zeilenindex als „In Position“-Parameter festgelegt wird
Neue(r) Wert(e)	Nein	Liste, Datenzeile		Dieser Parameter akzeptiert eine Listen- oder Datenzeilenvariable, bei der die Spaltenanzahl mit der Spaltenanzahl in der Datentabelle übereinstimmen soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Elementindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Elementindex außerhalb des zulässigen Bereichs liegt
Ungültige Eingabeargumente	Gibt an, dass ein ungültiger Eingabeparameter vorhanden ist
Fehler bei inkompatiblem Typ	Gibt an, dass ein Eingabeparameter eines inkompatiblen Typs bereitgestellt wird

Zeile aus der Datentabelle löschen

Löschen Sie eine Datentabellenzeile mit dem entsprechenden Zeilenindex.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss von einer Aktion angegeben werden, die eine Datentabellenvariable erzeugt
Zeilenindex	Nein	Numerischer Wert		Der Zeilenindex innerhalb einer Datentabelle, die gelöscht werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Elementindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass das angegebene Datentabellenelement außerhalb des zulässigen Bereichs liegt

Element der Datentabelle aktualisieren

Ein Element einer Datentabelle in einer bestimmten Spalte aktualisieren.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss zuvor durch eine Aktion angegeben werden, die eine Datentabellenvariable erzeugt.
Column	Nein	Textwert		Der Spaltenname oder Index des zu aktualisierenden Elements.
Zeile	Nein	Numerischer Wert		Der Zeilenindex des zu aktualisierenden Elements.
Neuer Wert	Nein	Textwert		Der neue zu aktualisierende Wert für den angegebenen Zeilenindex und die angegebene Spalte.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Elementindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass das angegebene Datentabellenelement außerhalb des zulässigen Bereichs liegt
Spaltenname ist nicht vorhanden	Gibt an, dass der bereitgestellte Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt
Fehler bei inkompatiblem Typ	Gibt an, dass ein Eingabeparameter eines inkompatiblen Typs bereitgestellt wurde

In Datentabelle suchen oder ersetzen

Findet und/oder ersetzt Datentabellenwerte.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss zuvor durch eine Aktion angegeben werden, die eine Datentabellenvariable erzeugt
Suchmodus	Nicht zutreffend	Suchen, suchen und ersetzen	Suchen	Der Modus der Suche (Suchen oder Suchen und Ersetzen)
Alle Ergebnisse	Nicht zutreffend	Boolescher Wert	Wahr	Gibt an, ob Text in allen gefundenen übereinstimmenden Zellen oder nur in der ersten übereinstimmenden Zelle gefunden/ersetzt werden soll
Zu suchender Text	Nein	Textwert		Der in der Datentabelle zu suchende Text
Mit einem regulären Ausdruck suchen	Nicht zutreffend	Boolescher Wert	Falsch	Gibt an, ob ein regulärer Ausdruck verwendet werden soll, um den Zelleninhalt mit dem zu suchenden Text abzugleichen
Groß-/Kleinschreibung beachten	Nicht zutreffend	Boolescher Wert	Falsch	Gibt an, ob bei der Suche nach Daten auf die Groß- und Kleinschreibung geachtet werden soll
Gesamten Zelleninhalt vergleichen	Nicht zutreffend	Boolescher Wert	Falsch	Gibt an, ob nach Zellen gesucht werden soll, die nur den angegebenen Text enthalten
Text zum Ersetzen	Nein	Textwert		Neuer, in den übereinstimmenden Zellen zu verwendender Text
Suche nach	Nicht zutreffend	Überall, Spalte	Überall	Die Reihenfolge, in der nach dem Text gesucht werden soll (überall oder in einer Spalte)
Spaltenindex oder -name	Nein	Text Wert		Die Spaltenüberschrift oder der Indexwert

Erzeugte Variablen

Argument	Type	Beschreibung
DataTableMatches	Datentabelle	Die Datentabelle, die die Zeilen- und Spaltenindizes für Übereinstimmungen enthält

Ausnahmen

Ausnahme	Beschreibung
Der angegebene reguläre Ausdruck ist ungültig	Gibt an, dass der angegebene reguläre Ausdruck ungültig ist
Spaltenname ist nicht vorhanden	Gibt an, dass der bereitgestellte Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt
Fehler bei inkompatiblem Typ	Gibt an, dass ein Eingabeparameter eines inkompatiblen Typs bereitgestellt wird

Spalte in Datentabelle einfügen

Fügt eine Spalte am Ende oder vor einem bestimmten Indexwert ein.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss von einer Aktion angegeben werden, die eine Datentabellenvariable erzeugt.
In Position	NICHT ZUTREFFEND	Ende der Datentabelle, vor dem Spaltenindex	Ende der Datentabelle	Geben Sie an, ob die neue Spalte am Ende der Datentabelle oder vor einem bestimmten Spaltenindex eingefügt werden soll.
Spaltenname	Nein	Textwert		Kopfzeile der neuen Spalte angeben.
Spaltenindex	Nein	Numerischer Wert		Geben Sie den Spaltenindexwert an, der verwendet wird, wenn für den Parameter In Position die Option Vor dem Spaltenindex ausgewählt ist.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt.
Doppelter Spaltenname	Gibt an, dass der angegebene Spaltenname bereits vorhanden ist.

Spalte aus der Datentabelle löschen

Löscht eine Datentabellenspalte unter dem angegebenen Spaltenindex oder Spaltennamen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss von einer Aktion angegeben werden, die eine Datentabellenvariable erzeugt.
Spalte angeben mit	NICHT ZUTREFFEND	Name, Index	Name des Dataflows	Gibt an, ob die Spalte nach Name oder Index gefunden werden soll.
Spaltenname	Nein	Textwert		Der Name der Spalte, die gelöscht werden soll.
Spaltenindex	Nein	Numerischer Wert		Der Index der Spalte, die gelöscht werden soll. Spaltenindizes beginnen bei 0.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Spaltenname ist nicht vorhanden	Gibt an, dass der bereitgestellte Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt

Leere Zeilen aus Datentabelle löschen

Löscht die Zeilen der Datentabelle, in denen alle Zellen leer sind.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Datentabelle	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Diese Variable muss zuvor durch eine Aktion angegeben werden, die eine Datentabellenvariable erzeugt

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Doppelte Zeilen aus der Datentabelle löschen

Löscht alle doppelten Zeilen aus der Datentabelle, wenn die Werte in jeder Spalte den gleichen Datentyp aufweisen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Nicht übereinstimmende Typen in den Zellen einer Spalte	Gibt an, dass zwei oder mehr Werte in einer einzelnen Spalte von unterschiedlichem Datentyp sind

Datentabelle löschen

Löscht alle Zeilen der Datentabelle. Tabellenüberschriften werden nicht beeinträchtigt.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Datentabelle sortieren

Sortiert die Zeilen der Datentabelle in aufsteigender oder absteigender Reihenfolge nach der angegebenen Spalte, wenn alle Werte denselben Datentyp haben.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.
Spalte angeben mit	NICHT ZUTREFFEND	Name, Index	Name des Dataflows	Gibt an, ob die Spalte nach Name oder Index gefunden werden soll.
Spaltenname	Nein	Textwert		Der Name der Spalte, die sortiert werden soll.
Spaltenindex	Nein	Numerischer Wert		Der Index der Spalte, die sortiert werden soll. Spaltenindizes beginnen bei 0.
Anordnen	NICHT ZUTREFFEND	Aufsteigend, Absteigend	Aufsteigend	Die Reihenfolge zum Sortieren der Datentabelle.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Spaltenname ist nicht vorhanden	Gibt an, dass der angegebene Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt
Nicht übereinstimmende Typen in den Zellen einer Spalte	Gibt an, dass zwei oder mehr Werte in einer einzelnen Spalte von unterschiedlichem Datentyp sind

Datentabelle filtern

Filtert die Zeilen der Datentabelle auf der Grundlage der angewandten Regeln.

Im integrierten Assistenten der Aktion, der Sie beim Erstellen der benötigten Filter unterstützt, können Sie mehrere Filter auf verschiedene Spalten anwenden, die nach Name oder Index definiert sind. Jeder Filter besteht aus einer bestimmten Zielspalte, einem ausgewählten Operator und dem ihm zugewiesenen Wert.

Darüber hinaus werden mehrere Filter gemeinsam über UND- und/oder ODER-Regeln angewendet. Im resultierenden Filterausdruck werden zuerst UND-Regeln aufgelöst, gefolgt von den ODER-Regeln.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.
Anzuwendende Filter	Nein	Vom Benutzenden festgelegte Filterregeln	NICHT ZUTREFFEND	Auf die definierten Spalten angewendete Filterungsregeln

Erzeugte Variablen

Argument	typ	Beschreibung
FilteredDataTable	Datentabelle	Die generierte Datentabelle nach dem Anwenden der Filter

Ausnahmen

Ausnahme	Beschreibung
Spaltenname ist nicht vorhanden	Gibt an, dass der angegebene Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt
Nicht übereinstimmende Typen in den Zellen einer Spalte	Gibt an, dass zwei oder mehr Werte in einer einzelnen Spalte von unterschiedlichem Datentyp sind

Datentabellen zusammenführen

Führt zwei Datentabellen zusammen und gibt das Zusammenführungsverhalten an, falls die Anzahl der Spalten unterschiedlich ist.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Erste Datentabelle	Nein	Datentabelle		Die erste Datentabellenvariable, mit der gearbeitet werden soll. Dies ist auch die von der Aktion erzeugte Variable, die die zusammengeführte Datentabelle enthält
Zweite Datentabelle	Nein	Datentabelle		Die zweite Datentabelle, die in die erste Datentabelle integriert wird
Zusammenführungsmodus	NICHT ZUTREFFEND	Zusätzliche Spalten hinzufügen, Zusätzliche Spalten ignorieren, Fehler bei zusätzlichen Spalten	Zusätzliche Spalten hinzufügen	Das Zusammenführungsverhalten, das angewendet wird, wenn die Tabellen nicht die gleiche Anzahl von Spalten haben

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Fehlendes Schema	​​Zeigt an, dass die Datentabellen nicht die gleiche Anzahl von Spalten haben

Datentabellen verknüpfen

Verknüpft zwei Datentabellen basierend auf der angegebenen Verknüpfungsregel.

Im integrierten Assistenten der Aktion, der Sie beim Erstellen der erforderlichen Verknüpfungsregeln unterstützt, können Sie mehrere Regeln festlegen, indem Sie die Spalten der ersten und der zweiten Datentabelle entsprechend angeben sowie den zwischen ihnen geltenden Vergleichsoperator festlegen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Erste Datentabelle	Nein	Datentabelle		Die erste Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.
Zweite Datentabelle	Nein	Datentabelle		Die zweite Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.
Verknüpfungsvorgang	NICHT ZUTREFFEND	Innere, linke, vollständige Verknüpfung	Innerer	Die Join-Operation, mit der die beiden Tabellen verknüpft werden
Regeln beitreten	Nein	Vom Benutzenden festgelegte Verknüpfungsregeln	NICHT ZUTREFFEND	Definieren Sie die Spalten und die Operation, die zum Verbinden der beiden Datentabellen verwendet werden sollen

Erzeugte Variablen

Argument	typ	Beschreibung
JoinedDataTable	Datentabelle	Die generierte Datentabelle nach dem Verknüpfungsvorgang

Ausnahmen

Ausnahme	Beschreibung
Spaltenname ist nicht vorhanden	Gibt an, dass der angegebene Spaltenname nicht vorhanden ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der bereitgestellte Spaltenindex außerhalb des zulässigen Bereichs liegt

Aus CSV-Textvariable lesen

Erstellt eine Datentabelle aus einem CSV-Text.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
CSV-Text	Nein	Textwert		Die zu lesende CSV-Textvariable.
Felder kürzen	NICHT ZUTREFFEND	Boolescher Wert	true	Gibt an, ob die führenden und nachfolgenden Leerzeichen der extrahierten Zellen automatisch gekürzt werden sollen.
Erste Zeile enthält Spaltennamen	NICHT ZUTREFFEND	Boolescher Wert	False	Gibt an, ob die erste Zeile des CSV-Texts verwendet werden soll, um die Spaltennamen der resultierenden Datentabelle festzulegen. Aktivieren Sie diese Option, um das Einlesen der Namen als Daten in die Tabelle zu vermeiden. Nachfolgende Aktionen können auf die in der Datentabelle enthaltenen Daten unter Verwendung von Spaltennamen (anstelle von Spaltennummern) zugreifen.
CSV-Felder als Text abrufen	NICHT ZUTREFFEND	Boolescher Wert	False	Geben Sie an, ob der Inhalt der CSV-Textfelder reinen Text oder den am besten passenden Typ abrufen soll. Beispielsweise „Date Time“ für Daten und „Numeric“ für Zahlen.
Spaltentrennzeichen	NICHT ZUTREFFEND	Vordefinierte, benutzerdefinierte, feste Spaltenbreiten	Vordefiniert	Gibt an, ob ein vordefiniertes, Spaltentrennzeichen, ein benutzerdefiniertes Spaltentrennzeichen oder eine feste Spaltenbreite verwendet werden soll.
Trennzeichen	NICHT ZUTREFFEND	Systemvorgabe, Komma, Semikolon, Tabulator	System-Standard	Das Spaltentrennzeichen zum Analysieren des CSV-Texts.
Benutzerdefiniertes Trennzeichen	Nein	Textwert		Das benutzerdefinierte Spaltentrennzeichen, das zum Analysieren des CSV-Texts verwendet werden soll.
Feste Spaltenbreiten	Nein	Textwert		Die festen Spaltenbreiten, die für die Analyse des CSV-Texts verwendet werden sollen. Trennen Sie die Breiten mit Kommas, Leerzeichen, Tabulatoren oder Zeilenumbrüchen.

Erzeugte Variablen

Argument	typ	Beschreibung
CSVTable	Datentabelle	Der Inhalt des CSV-Texts als Datentabelle

Ausnahmen

Ausnahme	Beschreibung
Fehler bei CSV-Analyse	​Zeigt ein Problem beim Parsen des CSV-Textes an

Datentabelle in Text konvertieren

Konvertiert eine Datentabelle in einen CSV-Text.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabellenvariable, mit der gearbeitet werden soll. Die angegebene Variable muss durch eine Aktion definiert werden, die eine Datentabellenvariable generiert.
Spaltennamen einschließen	NICHT ZUTREFFEND	Boolescher Wert	False	Gibt an, ob die Spaltennamen der angegebenen Variante die erste Zeile des CSV-Texts werden sollen.
Benutzerdefiniertes Spaltentrennzeichen verwenden	NICHT ZUTREFFEND	Boolescher Wert	False	Gibt an, ob ein benutzerdefiniertes Spaltentrennzeichen oder ein vordefiniertes Spaltentrennzeichen verwendet werden soll.
Trennzeichen	NICHT ZUTREFFEND	Systemvorgabe, Komma, Semikolon, Tabulator	System-Standard	Das Spaltentrennzeichen, das im angegebenen CSV-Text verwendet werden soll.
Benutzerdefiniertes Spaltentrennzeichen	Nein	Textwert		Das benutzerdefinierte Spaltentrennzeichen, das im angegebenen CSV-Text verwendet werden soll.

Erzeugte Variablen

Argument	typ	Beschreibung
CSVText	Textwert	Die Variable, in dem das CSV-Ergebnis gespeichert wird

Ausnahmen

Ausnahme	Beschreibung
Konvertierung fehlgeschlagen	Zeigt ein Problem bei der Konvertierung der Datentabelle in CSV-Text an

Zahl abschneiden

Ruft die Vor‑ oder Nachkommastellen eines numerischen Werts ab oder rundet den Wert auf eine angegebene Anzahl von Dezimalstellen auf.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Number to truncate	Nein	Numerischer Wert		Die Zahl oder Variable, die den numerischen Wert zum Kürzen/Aufrunden enthält
Operation	n/v	Ganzzahligen Teil holen, Dezimalteil holen, Zahl runden	Ganzzahlteil abrufen	Gibt den Vorgang an, der für die angegebene Zahl ausgeführt werden soll
Decimal places	Ja	Numerischer Wert	3	Die Anzahl der Dezimalstellen, auf die die angegebene Zahl aufgerundet werden soll. Geben Sie 0 ein, um eine ganze Zahl als Ergebnis zu erhalten

Erzeugte Variablen

Argument	Type	Beschreibung
TruncatedValue	Numerischer Wert	Die gekürzte oder gerundete Zahl

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Zufallszahl generieren

Generiert eine Zufallszahl oder eine Liste mit Zufallszahlen, die zwischen einem Minimal‑ und Maximalwert liegen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Minimum value	Ja	Numerischer Wert	0	Die Untergrenze für die zu generierende(n) Zufallszahl(en)
Maximum value	Ja	Numerischer Wert	100	Die Obergrenze für die zu generierende(n) Zufallszahl(en)
Generate multiple numbers	n/v	Boolescher Wert	Nein	Gibt an, ob eine einzelne Zufallszahl oder eine Liste mit Zufallszahlen generiert werden soll
How many numbers	Ja	Numerischer Wert	10	Gibt an, wie viele Zufallszahlen generiert werden
Allow duplicates	n/v	Boolescher Wert	Nein	Gibt an, ob dieselbe Zahl mehr als einmal in der Liste der Zufallszahlen angezeigt werden darf oder nicht

Erzeugte Variablen

Argument	Type	Beschreibung
RandomNumber	Numerischer Wert	Die neu generierte Zufallszahl
RandomNumbers	Liste mit numerischen Werten	Die neu generierte Liste mit Zufallszahlen

Ausnahmen

Ausnahme	Beschreibung
Generieren der Zufallszahl fehlgeschlagen	Gibt an, dass beim Generieren einer Zufallszahl ein Fehler aufgetreten ist

Liste leeren

Alle Elemente aus einer Liste entfernen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
List to clear	Nein	Liste der allgemeinen Werte		Eine Listenvariable zum Entfernen ihrer Elemente

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Element aus Liste entfernen

Entfernt ein oder mehrere Elemente aus einer Liste.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Remove item by	n/v	Index, Wert	Index	Gibt an, ob das Element an einem angegebenen Index oder an das/die Element(e) mit einem bestimmten Wert entfernt werden soll(en)
At index	Nein	Numerischer Wert		Indexnummer des zu entfernenden Elements
With value	Nein	Allgemeiner Wert		Zu entfernendes Element
Remove all item occurrences	n/v	Boolescher Wert	Nein	Entfernt alle vorkommenden Elemente, die mit dem angegebenen Element übereinstimmen
From list	Nein	Liste der allgemeinen Werte		Liste mit zu entfernenden Elementen

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Elementindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der Elementindex außerhalb des zulässigen Bereichs liegt
Element nicht gefunden	Gibt an, dass das Element nicht in der Liste vorhanden ist

Liste sortieren

Sortiert die Elemente einer Liste. Elemente desselben Typs verwenden.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
List to sort	Nein	Liste der allgemeinen Werte		Die Variable, die die zu sortierende Liste enthält
Sort by list item's properties	n/v	Boolescher Wert	False	Wenn es sich bei den Listenelementen um Objekte handelt (z. B. Dateien, Ordner usw.), aktivieren Sie diese Option, um das Element nach einer bestimmten Eigenschaft zu sortieren. Lassen Sie diese Option deaktiviert, um die Elemente nach ihrer Standardeigenschaft zu sortieren (zum Beispiel werden Dateiobjekte nach ihrem vollständigen Pfad sortiert)
Erste Eigenschaft, nach der sortiert wird	Ja	Textwert		Der Name der Eigenschaft eines Elements, nach der die Liste sortiert werden soll. Die Eigenschaftsnamen der einzelnen Objekte finden Sie in der Hilfedatei
Sort	n/v	Aufsteigend, Absteigend	Aufsteigend	Gibt an, ob aufsteigend oder absteigend nach der ersten Eigenschaft sortiert werden soll
Second property to sort by	Ja	Textwert		Der Name einer zweiten Eigenschaft, nach der die Liste sortiert werden soll
Sort	n/v	Aufsteigend, Absteigend	Aufsteigend	Gibt an, ob aufsteigend oder absteigend nach der zweiten Eigenschaft sortiert werden soll
Third property to sort by	Ja	Textwert		Der Name einer dritten Eigenschaft, nach der die Liste sortiert werden soll
Sort	n/v	Aufsteigend, Absteigend	Aufsteigend	Gibt an, ob aufsteigend oder absteigend nach der dritten Eigenschaft sortiert werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Liste mischen

Zufällige Permutation einer Liste erstellen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
List to shuffle	Nein	Liste der allgemeinen Werte		Die Variable, die die zu mischende Liste enthält

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Listen zusammenführen

Zwei Listen zu einer zusammenführen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
First list	Nein	Liste der allgemeinen Werte		Die erste Liste mit Elementen zum Zusammenführen
Second list	Nein	Liste der allgemeinen Werte		Die zweite Liste mit Elementen zum Zusammenführen

Erzeugte Variablen

Argument	Type	Beschreibung
OutputList	Liste der allgemeinen Werte	Die zusammengefasste Liste. Die ursprünglichen Listen sind davon nicht betroffen

Ausnahmen

Ausnahme	Beschreibung
Angegebene Listen sind nicht kompatibel	Gibt an, dass die angegebenen Listen nicht kompatibel sind

Listensortierung umkehren

Kehrt die Reihenfolge der Elemente einer Liste um.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
List to reverse	Nein	Liste der allgemeinen Werte		Die Liste, deren Elementreihenfolge umgekehrt werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Doppelte Elemente aus Liste entfernen

Entfernt mehrfach vorkommende Elemente in einer Liste, sodass in der Ergebnisliste jedes Element nur einmal vorhanden ist.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
List to remove duplicate items from	Nein	Liste der allgemeinen Werte		Die Listenvariable, aus der doppelte Elemente entfernt werden sollen
Ignore text case while searching for duplicate items	n/v	Boolescher Wert	Nein	Gibt an, ob die Groß‑/Kleinschreibung bei der Suche nach doppelten Elementen nicht berücksichtigt werden soll (gilt nur für Listen mit Textelementen)

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Gemeinsame Listenelemente suchen

Vergleicht zwei Listen und erstellt eine neue Liste mit Elementen, die in beiden enthalten sind.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
First list	Nein	Liste der allgemeinen Werte		Die Variable, die die erste zu vergleichende Liste enthält
Second list	Nein	Liste der allgemeinen Werte		Die Variable, die die zweite zu vergleichende Liste enthält

Erzeugte Variablen

Argument	Type	Beschreibung
IntersectionList	Liste der allgemeinen Werte	Die neue Liste mit gemeinsamen Elementen

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Listen subtrahieren

Vergleicht zwei Listen und erstellt eine neue Liste mit den Elementen, die sich in der ersten, aber nicht in der zweiten Liste befinden.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
First list	Nein	Liste der allgemeinen Werte		Die Variable, die die erste zu vergleichende Liste enthält
Second list	Nein	Liste der allgemeinen Werte		Die Variable, die die zweite zu vergleichende Liste enthält

Erzeugte Variablen

Argument	Type	Beschreibung
ListDifference	Liste der allgemeinen Werte	Die neue resultierende Liste

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Spalte einer Datentabelle als Liste abrufen

Konvertiert die Inhalte einer Datentabelle in eine Liste.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Data table	Nein	Datentabelle		Die Datentabelle mit der Spalte, die in eine Liste konvertiert werden soll
Column name or index	Nein	Textwert		Der Spaltenname, wenn Spaltennamen definiert sind, oder die Indexnummer der abzurufenden Spalte

Erzeugte Variablen

Argument	Type	Beschreibung
ColumnAsList	Liste der allgemeinen Werte	Die neue Liste, die den Inhalt der angegebenen Datentabelle enthält

Ausnahmen

Ausnahme	Beschreibung
Spaltenname ist nicht vorhanden	Gibt an, dass der Spaltenname nicht in der Datentabelle angegeben ist
Spaltenindex liegt außerhalb des zulässigen Bereichs	Gibt an, dass der Spaltenindex außerhalb des zulässigen Bereichs liegt

JSON in benutzerdefiniertes Objekt konvertieren

Konvertiert eine JSON-Zeichenfolge in ein benutzerdefiniertes Objekt.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
JSON	Nein	Textwert		Ein JSON-Text oder eine zuvor erstellte Variable mit JSON-Text für die Konvertierung in ein benutzerdefiniertes Objekt

Erzeugte Variablen

Argument	Type	Beschreibung
JsonAsCustomObject	Allgemeiner Wert	Das konvertierte benutzerdefinierte Objekt aus dem angegebenen JSON

Ausnahmen

Ausnahme	Beschreibung
Fehler beim Analysieren der JSON	Gibt an, dass ein Fehler beim Analysieren der angegebenen JSON aufgetreten ist

Benutzerdefiniertes Objekt in JSON konvertieren

Konvertiert ein benutzerdefiniertes Objekt in eine JSON-Zeichenfolge.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Custom object	Nein	Custom object		Das benutzerdefinierte Objekt, das in JSON konvertiert werden soll

Erzeugte Variablen

Argument	Type	Beschreibung
CustomObjectAsJson	Text Wert	Die konvertierte JSON aus dem angegebenen benutzerdefinierten Objekt

Ausnahmen

Ausnahme	Beschreibung
Fehler beim Analysieren des benutzerdefinierten Objekts	Gibt an, dass ein Fehler beim Analysieren des benutzerdefinierten Objekts aufgetreten ist

Element zu Liste hinzufügen

Neues Element an eine Liste anfügen.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Add item	Nein	Allgemeiner Wert		Ein Wert oder eine Variable, die der Liste hinzugefügt werden soll. Geben Sie eine Liste von Werten an, um mehrere Elemente anzuhängen. Wenn die Liste einen bestimmten Typ von Elementen hat, wird das neue Element in diesen Typ umgewandelt
Into list	Nein	Liste der allgemeinen Werte		Eine Listenvariable zum Anfügen neuer Elemente

Erzeugte Variablen

Argument	Type	Beschreibung
NewList	Liste der allgemeinen Werte	Die neue Liste

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Neue Liste erstellen

Erstellt eine neue leere Liste.

Eingabeparameter

Diese Aktion erfordert keine Eingabe.

Erzeugte Variablen

Argument	Type	Beschreibung
List	Liste der allgemeinen Werte	Die neue Liste

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Variable erhöhen

Erhöht den Wert einer Variablen um eine bestimmte Zahl.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Variable name	Nein	Numerischer Wert		Der numerische Wert, der erhöht werden soll
Increase by	Nein	Numerischer Wert		Ein numerischer Wert oder eine zuvor erstellte Variable mit einem numerischen Wert, um den die Variable erhöht werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Variable verringern

Verringert den Wert einer Variablen um eine bestimmte Zahl.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Variable name	Nein	Numerischer Wert		Ein numerischer Wert oder eine zuvor erstellte Variable mit einem numerischen Wert, um den die Variable verringert werden soll
Decrease by	Nein	Numerischer Wert		Ein numerischer Wert oder eine zuvor erstellte Variable mit einem numerischen Wert, um den die Variable verringert werden soll

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Power Fx-Ausdruck ausführen

Führt den bereitgestellten Power Fx-Ausdruck aus.

Anmerkung

Diese Aktion ist nur für Power Fx-fähige Desktop-Flows (Vorschauversion) verfügbar.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Ausdruck	Nein	*		Der auszuführende Power Fx-Ausdruck

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Diese Aktion enthält keine Ausnahmen.

Variable festlegen

Legt den Wert einer neuen oder vorhandenen Variablen fest. Erstellt eine neue Variable oder überschreibt eine zuvor erstellte Variable.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
To	Nein	*		Der Wert, der der Variablen zugewiesen werden soll.

Erzeugte Variablen

Argument	Type	Beschreibung
NewVar	*	Der Name der festzulegenden Variablen

Anmerkung

Variablennamen müssen entweder mit einem Buchstaben oder einem Unterstrich (_) beginnen. Nach dem ersten Zeichen können Variablennamen Buchstaben, Unterstriche und Ziffern (0 bis 9) enthalten. Bei Namen wird die Groß-/Kleinschreibung nicht beachtet, was bedeutet, dass myVar, myvar und MYVAR als dieselbe Variable angesehen werden. Die folgenden reservierten Schlüsselwörter können nicht als Variablennamen verwendet werden: if, then, else, switch, case, default, loop, from, to, step, foreach, in, while, next, exit, label, goto, call, output, function, block, end, error, wait, for, set, main, and, or, xor, not, true, false, yes, no, disable, on, repeat, times, throw, action, mod, global, input, import

Ausnahmen

Diese Aktion enthält keine Ausnahmen.