Typen von Funktionen
Funktionen sind in 10 verschiedene Kategorien wie Mathematik und Logik unterteilt. Die Kategorien sind organisiert, um das Auffinden einer bestimmten Funktion zu erleichtern. Nachfolgend erhalten Sie einen Überblick über jede Kategorie und einige Beispiele.
Denken Sie daran, dass wir beim Durchgehen der verschiedenen Beispiele statischen Text und Werte verwenden. Auf diese Weise können Sie die Beispiele so einfach wie möglich testen und neu erstellen. In Ihren Flows können Sie anstelle dieser statischen Daten dynamischen Inhalt ersetzen. Stellen Sie einfach sicher, dass Ihre dynamischen Daten das richtige Format für die Funktion haben.
In diesem Screenshot sehen Sie rechts neben jedem Kategorie-Header (wie Zeichenfolgen-Funktionen oder Sammlung) die Wörter Weitere Informationen. Durch Auswahl von Weitere Informationen wird die vollständige Liste der Funktionen für diese Kategorie angezeigt.
Wählen Sie Weitere Informationen neben den Zeichenfolgenfunktionen aus.
Zeichenfolgenfunktionen
Zeichenfolgenfunktionen (Textfunktionen) werden zum Ändern von Zeichenfolgen, zum Suchen von Zeichen in einer Zeichenfolge, zum Formatieren von Zeichenfolgen usw. verwendet. Die Textbearbeitung ist eine Kernkompetenz, die häufig verwendet wird, wenn Sie versuchen, Daten, die Sie von einem anderen Ort erhalten haben, besser zu formatieren oder zu ändern.
Ein Beispiel für eine Zeichenfolgenfunktion ist die Funktion formatNumber. Diese Funktion kann eine Zahl in eine Zeichenfolge in einem bestimmten Format konvertieren. Eine häufige Anforderung besteht darin, eine Zahl wie eine Währung aussehen zu lassen. Verwenden Sie die folgende Formel, um die Zahl 12,5 in 12,50 USD zu ändern:
formatNumber(12.5,'C')
Das C steht für die Zeichenfolge im numerischen Währungsformat. Machen Sie sich keine Sorgen. Eine Liste der anderen Optionen finden Sie unter Standardzeichenfolgen im numerischen Format. Sie fragen sich vielleicht, was passiert, wenn Sie die Nummer als Währung anzeigen möchten, jedoch mit dem Yen-Symbol? Es gibt einen optionalen Parameter, mit dem Sie das Gebietsschema übergeben können.
formatNumber(12.5,'C','ja-JP')
Diese Formel gibt 13 ¥ zurück.
Erfassungsfunktionen
Diese Funktionen werden für Arrays und Zeichenfolgen verwendet. Sie können Sie verwenden, um zu überprüfen, ob ein Array leer ist, um das erste oder letzte Element abzurufen oder sogar um Verknüpfungs-, Vereinigungs‑ und Überschneidungsvorgänge durchzuführen.
Ein Beispiel für eine hilfreiche Erfassungsfunktion ist Länge. Sie können Länge verwenden, um die Anzahl der Elemente in einer Zeichenfolge oder einem Array zurückzugeben. Das folgende Beispiel würde verwendet, um die Anzahl der Zeichen in der Zeichenfolge „Ich liebe Power Automate“ zu zählen.
length('I love Power Automate.')
Die Ausgabe wäre 22. Beachten Sie, dass ein Leerzeichen als ein Zeichen zählt. Sie können diesen Funktionstyp zur Validierung oder mit den Zeichenfolgenfunktionen zum Bearbeiten von Zeichenfolgen verwenden.
Logische Funktionen
Diese Funktionen werden verwendet, um mit Bedingungen zu arbeiten, Werte zu vergleichen und andere logikbasierte Auswertungen durchzuführen. Diese werden oft als If-Anweisungen betrachtet, bei denen Sie vergleichen möchten, ob eine Zahl größer als eine andere Zahl ist. Power Automate unterstützt alle logischen Vergleiche, die Sie erwarten würden.
In diesem Beispiel wird ein Ausdruck verglichen, wenn 12 größer als 10 ist, und dann die entsprechende Zeichenfolge ausgegeben. Dies ist auch Ihr erster Ausdruck, der mehr als eine Funktion verwendet. Wir werden die logischen Funktionen if und greater kombinieren.
If(greater(12,10),'Yes','No')
Das Ergebnis dieses Ausdrucks wäre die Zeichenfolge Ja. Um den Ausdruck zu verstehen, arbeiten Sie von innen nach außen. Größer (12,10) gibt „true“ oder „false“ zurück, je nachdem, ob 12 größer als 10 ist. Da dies der Fall ist, ist der zurückgegebene Wert „true“.
Jetzt, da Sie wissen, dass die Antwort „true“ ist, können Sie sehen, dass die Funktion If die Daten nach dem ersten Komma zurückgibt. In diesem Fall ist das die Zeichenfolge Ja. Wenn es falsch ist, wird die Zeichenfolge Nein zurückgegeben.
Wichtig
Während Sie wie oben gezeigt logische Ausdrücke schreiben können, gibt es auch eine Aktion mit der Bezeichnung Bedingung, mit der Sie If-Aussagen ohne Ausdruck schreiben können. Sie können einen neuen Schritt in Ihren Flow einfügen, indem Sie Copilot auffordern, eine Bedingung einzufügen, oder indem Sie das Plus-Symbol auswählen und nach der Aktion mit der Bezeichnung Bedingung suchen.
Hier ist die gleiche Logik, geschrieben mit einer Bedingungsaktion statt einem Ausdruck.
Tipp
Beachten Sie im obigen Screenshot, dass Copilot erfolgreich eine Compose-Aktion der True-Verzweigung hinzugefügt hat, die Compose 4-Aktion jedoch nicht der False-Verzweigung hinzugefügt hat. Copilot erreicht möglicherweise nicht immer das gewünschte Ergebnis. Stellen Sie daher sicher, dass die von Copilot hinzugefügten Aktionen richtig sind.
Sie werden im Laufe der Zeit feststellen, dass Sie je nach Ihren Anforderungen eine Kombination beider Ausdrücke und Bedingungen verwenden.
Konvertierungsfunktionen
Mit diesen Funktionen können Sie den Typ Ihrer Daten ändern. Dies können einfache Dinge wie das Konvertieren einer Textnummer in eine Ganzzahl oder komplexere Funktionen wie das Ändern der Codierung einer Datei von base64 in binär sein. Wenn Sie wissen, dass diese Funktionen verfügbar sind, können Sie Probleme überwinden, die bei der korrekten Strukturierung Ihrer Daten auftreten.
Ein häufiges Szenario ist die Notwendigkeit, int oder float zu verwenden, um eine Textnummer in eine tatsächliche Zahl umzuwandeln. Dies ist häufig der Fall, wenn Sie Daten aus einer Datenquelle in Ihren Flow importieren. Die Nummer 12 oder 12,4 kann als Text gespeichert werden. Um diese Nummer in einer logischen Funktion zu verwenden oder an einen Ort zu schreiben, an dem eine Nummer erwartet wird, müssen Sie sie konvertieren. Im folgenden Beispiel wird die Zeichenfolge „12“ in die Ganzzahl „12“ geändert.
Int('12')
Dadurch wird die Ganzzahl „12“ ausgegeben. Wäre es die Zeichenfolge „12,4“ gewesen, müssten Sie sie aufgrund der Dezimalstellen in ein Gleitkomma konvertieren. In diesem Fall würden Sie Folgendes verwenden:
Float('12.4')
Jetzt können Sie die Textnummer verwenden, um das vorherige Beispiel zu erstellen.
If(greater(Int('12'), Float('12.4')),'Yes','No')
Dies würde die Zeichenfolge „Nein“ ausgeben, da 12 nicht größer als 12,4 ist. Das Kombinieren solcher Funktionen ist üblich und ein nützliches Lernmuster.
Mathematische Funktionen
Mathematische Funktionen funktionieren genau so, wie Sie es erwarten würden. Mit ihnen können Sie andere ähnliche Funktionen addieren, subtrahieren, multiplizieren und ausführen. Darüber hinaus können Sie mit mathematischen Funktionen unter anderem die kleinste und größte Zahl von Datensätzen finden oder eine Zufallszahl in einem festgelegten Intervall und mehr erhalten. Verwenden Sie diesen Ausdruck, um eine Zufallszahl von 1 bis 10 zu erhalten:
rand(1,10)
Beachten Sie, dass es eine andere Funktion zum Hinzufügen von Zahlen (add) und zum Subtrahieren von Zahlen (sub) gibt. Viele Formelsprachen fügen negative Zahlen hinzu, um eine Subtraktion zu erzeugen, Power Automate jedoch nicht. Um zwei Zahlen zu addieren, verwenden Sie diesen Ausdruck:
add(12, 13)
Dies würde 25 zurückgeben. Wenn Sie drei Zahlen hinzufügen möchten, müssen Sie eine zweite Funktion wie folgt hinzufügen:
add(add(12,13),15)
Dies würde 40 zurückgeben. Wie Sie bereits gesehen haben, können Sie Verschachtelungsfunktionen finden, um die gewünschten Ergebnisse zu erzielen.
Datums‑ und Zeitfunktionen
Diese Funktionen werden verwendet, um das aktuelle Datum und die aktuelle Uhrzeit zurückzugeben, Zeitzonen zu ändern, bestimmte Informationen zu Datum und Uhrzeit zu finden und andere Datums‑ oder Uhrzeitbearbeitungen durchzuführen. Wenn Ihre Daten Datums‑ und Zeitwerte enthalten, benötigen Sie diese Funktionen.
Eine wichtige Sache, die Sie beim Erkunden von Datums‑ und Zeitfunktionen in Power Automate beachten sollten, ist, dass sie häufig auf UTC basieren. Die meisten Datenquellen übertragen Daten mit Power Automate im UTC-Format hin und her. Wenn Sie die Funktion UTCNow() verwenden, wird die aktuelle Uhrzeit im UTC-Format zurückgegeben. Wenn Sie dies zum Vergleichen mit Benutzerdaten verwenden möchten, die sich derzeit in der östlichen Zeitzone befinden, müssen Sie die folgende Formel verwenden, um sie zu konvertieren:
convertFromUtc(utcNow(), 'Eastern Standard Time', 'dd-MM-yyyy hh:mm tt' )
Dadurch wird „09-02-2024 11:28 AM“ ausgegeben. Eine vollständige Liste der Optionen für das Datums‑ und Uhrzeitformat finden Sie unter Benutzerdefinierte Zeichenfolgen im Datums‑ und Zeitformat.
Referenzierende Funktionen
Die referenzierenden Funktionen werden verwendet, um mit den Ausgaben Ihrer Aktionen und Trigger zu arbeiten. Das Gute ist, dass Power Automate diese Funktionen die meiste Zeit für Sie schreibt. Wenn Sie Ihrem Flow dynamischen Inhalt hinzufügen, verwenden Sie referenzierende Funktionen, ohne es zu wissen. Wenn Sie dynamischen Inhalt hinzufügen und dann mit der Maus über diesen Inhalt fahren, können Sie diesen in Aktion sehen.
In diesem Screenshot können Sie durch das Hinzufügen des dynamischen Inhalts des User name von meinem Trigger bis zu den Eingaben zum Erstellen dies in Aktion sehen.
Wenn Sie mit dem Mauszeiger über den Benutzernamen fahren, können Sie Folgendes sehen:
triggerOutputs()?['headers']?['x-ms-user-name-encoded']
Power Automate hat den Ausdruck mit den triggerOutputs für Sie erstellt. Es ist das Abrufen der Eigenschaft „x-ms-user-name-encoded“ aus der Eigenschaft Headers. Die meiste Zeit werden Sie diese Eigenschaften in Power Automate über dynamischen Inhalt referenzieren. Es ist jedoch möglich, eigene Ausdrücke zu schreiben, um dies bei Bedarf neu zu erstellen. Jeder Trigger und jede Aktion hat unterschiedliche Formate für das Abrufen ihrer Daten.
Erkunden Sie diese Funktionen, indem Sie verschiedene Trigger, Aktionen und Datenquellen hinzufügen und in Ihrem Flow auf jeden Loop anwenden. Verwenden Sie dann ihre Eigenschaften als dynamische Daten, um weitere Beispiele anzuzeigen. Die gute Nachricht ist, dass das Schreiben solcher Ausdrücke nicht üblich ist.
Workflowfunktionen
Die Workflowfunktionen werden zum Abrufen von Informationen zu Ihrem Flow verwendet und stehen in engem Zusammenhang mit den referenzierenden Funktionen. Eine der Funktionen heißt Workflow. Sie können sie wie hier gezeigt verwenden.
workflow().run.id
Dies gibt die ID der aktuellen Flowausführung zurück. Sie können dies bei Bedarf für die Fehlerberichterstattung oder Protokollierung verwenden. Diese Funktionen werden nicht häufig verwendet.
URI-Analysefunktionen
Diese Funktionen werden verwendet, um einen URI zu zerlegen, der als Zeichenfolge übergeben wird. Mit diesen Funktionen können Sie den Host, den Pfad, die Abfragezeichenfolge oder andere Teile des URI suchen. Das folgende Beispiel zeigt, wie Sie mit uriQuery den Teil der Abfragezeichenfolge des angegebenen URI abrufen.
uriQuery('https://flow.microsoft.com/fakeurl?Test=Yes')
Dies würde die Zeichenfolge ?Test=Yes zurückgeben, die Sie dann mit Zeichenfolgenfunktionen analysieren könnten, um den vom URI übergebenen Wert abzurufen.
Bearbeitungsfunktionen
Bearbeitungsfunktionen werden verwendet, um mit bestimmten Objekten in Ihrem Flow zu arbeiten. Sie können beispielsweise den ersten nicht leeren Wert suchen, mit Eigenschaften arbeiten oder xpath-Übereinstimmungen suchen. Diese Funktionen werden normalerweise bei der Auswertung von JSON‑ oder XML-Knoten verwendet.
Eine Funktion, die Sie vielleicht nützlich finden, ist Zusammenfügen. Mit dieser Funktion können Sie den ersten Wert ungleich Null aus einem angegebenen Wertesatz ermitteln. Sie verwenden die Funktion wie in der folgenden Formel gezeigt:
coalesce(null, 'Power Automate', 'Power Apps')
Diese Formel würde die Zeichenfolge Power Automate zurückgeben. Dies ist praktisch, wenn Sie mehrere Werte übergeben und den ersten Wert suchen möchten, der nicht null ist.