Referenzhandbuch für Workflowausdrucksfunktionen in Azure Logic Apps und Power Automate
Gilt für: Azure Logic Apps (Verbrauch + Standard)
Bei Workflowdefinitionen in Azure Logic Apps und Power Automate erhalten einige Ausdrücke ihre Werte von Laufzeitaktionen, die zu Beginn der Ausführung Ihres Workflows möglicherweise noch nicht vorhanden sind. Sie können mithilfe von Ausdrucksfunktionen, die von der Definitionssprache für Workflows bereitgestellt werden, auf die Werte in diesen Ausdrücken verweisen oder diese Werte in diesen Ausdrücken verarbeiten.
Hinweis
Diese Referenzseite gilt sowohl für Azure Logic Apps als auch für Power Automate, wird aber in der Dokumentation zu Azure Logic Apps angezeigt. Obwohl sich diese Seite speziell auf Logik-App-Workflows bezieht, funktionieren diese Funktionen sowohl mit Flows als auch mit Logik-App-Workflows. Weitere Informationen zu Funktionen und Ausdrücken in Power Automate finden Sie unter Verwenden von Ausdrücken in Bedingungen.
Beispielsweise können Sie Werte berechnen, indem Sie mathematische Funktionen wie die add()-Funktion verwenden, wenn Sie die Summe aus Integer- oder Gleitkommazahlen erhalten möchten. Im Folgenden finden Sie weitere Beispielaufgaben, die Sie mit Funktionen ausführen können:
Aufgabe | Funktionssyntax | Ergebnis |
---|---|---|
Gibt eine Zeichenfolge in Kleinbuchstaben zurück. | toLower('<text>') Beispiel: toLower('Hello') |
"hello" |
Gibt einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) zurück. | guid() | "c2ecc88d-88c8-4096-912c-d6f2e2b138ce" |
In den nachfolgenden Tabellen finden Sie Funktionen basierend auf dem allgemeinen Zweck aufgeführt. Ausführliche Informationen zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Funktionen in Ausdrücken
Um die Verwendung einer Funktion in einem Ausdruck zu veranschaulichen, zeigt dieses Beispiel, wie Sie den Wert über den Parameter customerName
abrufen und ihn mithilfe der Funktion parameters() in einem Ausdruck der Eigenschaft accountName
zuweisen können:
"accountName": "@parameters('customerName')"
Im Folgenden werden einige weitere allgemeine Möglichkeiten für die Verwendung von Funktionen in Ausdrücken aufgeführt:
Aufgabe | Funktionssyntax in einem Ausdruck |
---|---|
Führen Sie Aufgaben mit einem Element durch, indem Sie dieses Element an eine Funktion übergeben. | "@<functionName>(<item>)" |
1. Rufen Sie den Wert von parameterName mit der geschachtelten Funktion parameters() ab. 2. Führen Sie Aufgaben mit dem Ergebnis durch, indem Sie diesen Wert an functionName übergeben. |
"@<functionName>(parameters('<parameterName>'))" |
1. Rufen Sie das Ergebnis der geschachtelten inneren Funktion functionName ab. 2. Übergeben Sie das Ergebnis an die äußere Funktion functionName2. |
"@<functionName2>(<functionName>(<item>))" |
1. Abrufen des Ergebnisses aus functionName. 2. Da das Ergebnis ein Objekt mit der Eigenschaft propertyName ist, rufen Sie den Eigenschaftswert ab. |
"@<functionName>(<item>).<propertyName>" |
Die Funktion concat()
kann z.B. mindestens zwei Zeichenfolgenwerte als Parameter aufweisen. In dieser Funktion werden diese Zeichenfolgen in einer Zeichenfolge kombiniert. Sie können Zeichenfolgenliterale eingeben, wie z.B. „Sophia“ und „Owen“, um eine kombinierte Zeichenfolge („SophiaOwen“) zu erhalten:
"customerName": "@concat('Sophia', 'Owen')"
Alternativ können Sie Zeichenfolgenwerte von Parametern abrufen. In diesem Beispiel wird die Funktion parameters()
in den einzelnen concat()
-Parametern und den Parametern firstName
und lastName
verwendet. Anschließend übergeben Sie die resultierenden Zeichenfolgen an die Funktion concat()
, um eine kombinierte Zeichenfolge zu erhalten, wie z.B. „SophiaOwen“:
"customerName": "@concat(parameters('firstName'), parameters('lastName'))"
Das Ergebnis wird in beiden Fällen und Beispielen der Eigenschaft customerName
zugewiesen.
Überlegungen zur Verwendung von Funktionen
Der Designer wertet keine Laufzeitausdrücke aus, die zur Entwurfszeit als Funktionsparameter verwendet werden. Er erfordert, dass alle Ausdrücke zur Entwurfszeit vollständig ausgewertet werden können.
Funktionsparameter werden von links nach rechts ausgewertet.
In der Syntax für Parameterdefinitionen bedeutet ein Fragezeichen (?), das hinter einem Parameter steht, dass der Parameter optional ist. Sie finden dies beispielsweise in getFutureTime().
Funktionsausdrücke, die inline mit einfachem Text erscheinen, benötigen geschweifte Klammern ({}), um stattdessen das interpolierte Format des Ausdrucks zu verwenden. Dieses Format hilft, Probleme beim Parsen zu vermeiden. Wenn Ihr Funktionsausdruck nicht inline mit einfachem Text erscheint, sind keine geschweiften Klammern erforderlich.
Das folgende Beispiel zeigt die richtige und die falsche Syntax:
Richtig:
"<text>/@{<function-name>('<parameter-name>')}/<text>"
Unrichtig:
"<text>/@<function-name>('<parameter-name>')/<text>"
OK:
"@<function-name>('<parameter-name>')"
In den folgenden Abschnitten sind die Funktionen nach allgemeinem Zweck sortiert. Alternativ können Sie sich diese Funktionen auch in alphabetischer Reihenfolge ansehen.
Zeichenfolgenfunktionen
Für die Arbeit mit Zeichenfolgen können Sie folgende Zeichenfolgenfunktionen und auch einige Sammlungsfunktionen verwenden. Zeichenfolgenfunktionen können nur in Zeichenfolgen verwendet werden.
Zeichenfolgenfunktion | Aufgabe |
---|---|
chunk | Teilt eine Zeichenfolge oder Sammlung in Blöcke gleicher Länge auf. |
concat | Kombiniert mindestens zwei Zeichenfolgen miteinander und gibt die kombinierte Zeichenfolge zurück. |
endsWith | Überprüft, ob eine Zeichenfolge mit der angegebenen Teilzeichenfolge endet. |
formatNumber | Gibt eine Zahl als Zeichenfolge zurück, basierend auf dem angegebenen Format. |
guid | Generiert einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) als Zeichenfolge. |
indexOf | Gibt die Anfangsposition für eine Teilzeichenfolge zurück. |
isFloat | Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine Gleitkommazahl ist. |
isInt | Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine ganze Zahl ist. |
lastIndexOf | Gibt die Anfangsposition des letzten Vorkommens einer Teilzeichenfolge zurück. |
length | Gibt die Anzahl der Elemente in einer Zeichenfolge oder einem Array zurück. |
nthIndexOf | Gibt die Anfangsposition oder den Indexwert zurück, an der bzw. dem das n-te Vorkommen einer Teilzeichenfolge in einer Zeichenfolge erscheint. |
replace | Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück. |
slice | Gibt durch die Angabe der Anfangs- oder Endposition bzw. eines entsprechenden Werts eine Teilzeichenfolge zurück. Siehe auch substring (Unterzeichenfolge). |
split | Gibt ein Array mit Teilzeichenfolgen, die durch Trennzeichen getrennt sind, aus einer größeren Zeichenfolge basierend auf einem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge zurück. |
startsWith | Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. |
substring | Gibt Zeichen aus einer Zeichenfolge zurück, beginnend mit der angegebenen Position. Siehe auch slice (Datenschnitt). |
toLower | Gibt eine Zeichenfolge in Kleinbuchstaben zurück. |
toUpper | Gibt eine Zeichenfolge in Großbuchstaben zurück. |
trim | Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück. |
Auflistungsfunktionen
Für die Arbeit mit Sammlungen (in der Regel Arrays, Zeichenfolgen und manchmal auch Bibliotheken) können Sie folgende Sammlungsfunktionen verwenden.
Sammlungsfunktion | Aufgabe |
---|---|
chunk | Teilt eine Zeichenfolge oder Sammlung in Blöcke gleicher Länge auf. |
contains | Überprüft, ob eine Sammlung ein bestimmtes Element enthält. |
empty | Überprüft, ob eine Sammlung leer ist. |
first | Gibt das erste Element aus einer Sammlung zurück. |
intersection | Gibt eine Sammlung zurück, die nur die gängigen Elemente aus den angegebenen Sammlungen enthält. |
item | Wird diese Funktion in einer wiederholten Aktion für ein Array verwendet, gibt sie das Element zurück, das in der aktuellen Iteration der Aktion das aktuelle Arrayelement ist. |
join | Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält, getrennt durch das angegebene Zeichen. |
last | Gibt das letzte Element aus einer Sammlung zurück. |
length | Gibt die Anzahl der Elemente in einer Zeichenfolge oder einem Array zurück. |
reverse | Kehrt die Reihenfolge der Elemente in einem Array um. |
skip | Entfernt Elemente vom Anfang einer Sammlung und gibt alle anderen Elemente zurück. |
sort | Sortiert die Elemente in einer Sammlung. |
take | Gibt Elemente vom Anfang einer Sammlung zurück. |
union | Gibt eine Sammlung zurück, die sämtliche Elemente aus den angegebenen Sammlungen enthält. |
Logische Vergleichsfunktionen
Sie können für die Arbeit mit Bedingungen, das Vergleichen von Werten und Ausdrucksergebnissen oder das Auswerten verschiedener Logiken folgende logische Vergleichsfunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Hinweis
Wenn Sie logische Funktionen oder Bedingungen zum Vergleichen von Werten verwenden, werden NULL-Werte in leere Zeichenfolgenwerte (""
) konvertiert. Das Verhalten der Bedingungen unterscheidet sich, wenn Sie eine leere Zeichenfolge anstelle eines NULL-Werts für den Vergleich verwenden. Weitere Informationen finden Sie unter string.
Logische Vergleichsfunktion | Aufgabe |
---|---|
und | Überprüft, ob für sämtliche Ausdrücke der Wert „TRUE“ festgelegt ist. |
equals | Überprüft, ob beide Werte identisch sind. |
greater | Überprüft, ob der erste Wert größer als der zweite ist. |
greaterOrEquals | Überprüft, ob der erste Wert größer als oder gleich dem zweiten ist. |
if | Überprüft, ob ein Ausdruck gleich „true“ oder „false“ ist. Gibt abhängig vom Ergebnis einen angegebenen Wert zurück. |
isFloat | Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine Gleitkommazahl ist. |
isInt | Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine ganze Zahl ist. |
less | Überprüft, ob der erste Wert kleiner als der zweite ist. |
lessOrEquals | Überprüft, ob der erste Wert kleiner als oder gleich dem zweiten ist. |
not | Überprüft, ob ein Ausdruck gleich „false“ ist. |
or | Überprüft, ob mindestens ein Ausdruck gleich „true“ ist. |
Konvertierungsfunktionen
Sie können mit den folgenden Konvertierungsfunktionen den Typ oder das Format eines Werts ändern. So können Sie beispielsweise einen Wert von einem booleschen Wert in einen ganzzahligen Wert ändern. Weitere Informationen dazu, wie Azure Logic Apps Inhaltstypen während der Konvertierung behandelt, finden Sie unter Behandeln von Inhaltstypen. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem im Designer verwenden, treten möglicherweise unerwartete Renderingverhaltenim Designer auf. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Implizite Datentypkonvertierungen.
Konvertierungsfunktion | Aufgabe |
---|---|
array | Gibt ein Array aus einer einzelnen angegebenen Eingabe zurück. Für mehrere Eingaben siehe createArray. |
base64 | Gibt die base64-codierte Version für eine Zeichenfolge zurück. |
base64ToBinary | Gibt die Binärversion für eine base64-codierte Zeichenfolge zurück. |
base64ToString | Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück. |
binary | Gibt die Binärversion für einen Eingabewert zurück. |
bool | Gibt die Version des booleschen Werts für einen Eingabewert zurück. |
createArray | Gibt ein Array aus mehreren Eingaben zurück. |
dataUri | Gibt den Daten-URI für einen Eingabewert zurück. |
dataUriToBinary | Gibt die Binärversion für einen Daten-URI zurück. |
dataUriToString | Gibt die Zeichenfolgenversion für einen Daten-URI zurück. |
decimal | Gibt die Dezimalzahl für eine Dezimalzeichenfolge zurück. |
decodeBase64 | Gibt die Zeichenfolgenversion für eine base64-codierte Zeichenfolge zurück. |
decodeDataUri | Gibt die Binärversion für einen Daten-URI zurück. |
decodeUriComponent | Gibt eine Zeichenfolge zurück, in der Escapezeichen durch decodierte Versionen ersetzt sind. |
encodeUriComponent | Gibt eine Zeichenfolge zurück, die URL-unsichere Zeichen durch Escapezeichen ersetzt. |
float | Gibt eine Gleitkommazahl für einen Eingabewert zurück. |
int | Gibt die Ganzzahlversion für eine Zeichenfolge zurück. |
json | Gibt den JSON-Typwert oder das JSON-Objekt (JSON = JavaScript Object Notation) für eine Zeichenfolge oder XML zurück. |
string | Gibt die Zeichenfolgenversion für einen Eingabewert zurück. |
uriComponent | Gibt die URI-codierte Version für einen Eingabewert zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. |
uriComponentToBinary | Gibt die Binärversion für eine URI-codierte Zeichenfolge zurück. |
uriComponentToString | Gibt die Zeichenfolgenversion für eine URI-codierte Zeichenfolge zurück. |
xml | Gibt die XML-Version für eine Zeichenfolge zurück. |
Implizite Datentypkonvertierungen
Mit Azure Logic Apps werden Werte automatisch oder implizit zwischen einigen Datentypen konvertiert, sodass Sie diese Wechsel nicht manuell ausführen müssen. Wenn Sie z. B. Werte verwenden, die keine Zeichenfolgen sind, und Zeichenfolgen als Eingaben erwartet werden, konvertiert Azure Logic Apps die Nicht-Zeichenfolgenwerte automatisch in Zeichenfolgen.
Angenommen, ein Auslöser gibt einen numerischen Wert als Ausgabe zurück:
triggerBody()?['123']
Wenn Sie diese numerische Ausgabe verwenden und eine Zeichenfolgeneingabe wie z. B. eine URL erwartet wird, konvertiert Azure Logic Apps den Wert mithilfe von geschweiften Klammern ({}
) automatisch in eine Zeichenfolge:
@{triggerBody()?['123']}
Base64-Codierung und -Decodierung
Azure Logic Apps führt automatisch oder implizit eine Base64-Codierung oder -Decodierung durch, daher müssen Sie diese Konvertierung nicht mithilfe der entsprechenden Funktionen manuell ausführen:
base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)
Hinweis
Wenn Sie eine dieser Funktionen manuell mithilfe des Designers direkt zu einem Trigger oder einer Aktion oder mithilfe des Ausdrucks-Editors hinzufügen, aus dem Designer navigieren und diesen dann wieder öffnen, verschwindet die Funktion aus dem Designer und lässt nur die Parameterwerte zurück. Dieses Verhalten tritt auch auf, wenn Sie einen Auslöser oder eine Aktion auswählen, die diese Funktion verwendet, ohne die Parameterwerte der Funktion zu bearbeiten. Dieses Ergebnis betrifft nur die Sichtbarkeit der Funktion und nicht die Wirkung. In der Codeansicht ist die Funktion davon nicht betroffen. Wenn Sie jedoch die Parameterwerte der Funktion bearbeiten, werden sowohl die Funktion als auch ihr Effekt aus der Codeansicht entfernt, sodass nur die Parameterwerte der Funktion zurückbleiben.
Mathematische Funktionen
Sie können mithilfe der folgenden mathematischen Funktionen mit ganzen Zahlen und Gleitkommazahlen arbeiten. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Mathematische Funktion | Aufgabe |
---|---|
add | Gibt das Ergebnis der Addition zweier Zahlen zurück. |
div | Gibt das Ergebnis der Division zweier Zahlen zurück. |
max | Gibt den höchsten Wert aus einer Reihe von Zahlen oder einem Array zurück. |
min | Gibt den niedrigsten Wert aus einer Reihe von Zahlen oder einem Array zurück. |
mod | Gibt den Restwert aus der Division zweier Zahlen zurück. |
mul | Gibt das Produkt aus der Multiplikation zweier Zahlen zurück. |
rand | Gibt eine beliebige ganze Zahl aus einem angegebenen Bereich zurück. |
range | Gibt ein Array mit ganzen Zahlen zurück, das mit einer angegebenen ganzen Zahl beginnt. |
sub | Gibt das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl zurück. |
Datums- und Uhrzeitfunktionen
Sie können für die Arbeit mit Datums- und Uhrzeitangaben folgende Datums- und Uhrzeitfunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Datums- oder Zeitfunktion | Aufgabe |
---|---|
addDays | Fügt einem Zeitstempel Tage hinzu. |
addHours | Fügt einem Zeitstempel Stunden hinzu. |
addMinutes | Fügt einem Zeitstempel Minuten hinzu. |
addSeconds | Fügt einem Zeitstempel Sekunden hinzu. |
addToTime | Fügt einem Zeitstempel angegebene Zeiteinheiten hinzu. Siehe auch getFutureTime. |
convertFromUtc | Konvertiert einen Zeitstempel von der UTC-Zeitzone (UTC = Universal Time, Coordinated) in die Zielzeitzone. |
convertTimeZone | Konvertiert einen Zeitstempel von der Quellzeitzone in die Zielzeitzone. |
convertToUtc | Konvertiert einen Zeitstempel von der Quellzeitzone in die UTC-Zeitzone (UTC = Universal Time, Coordinated). |
dateDifference | Gibt die Differenz zwischen zwei Datumsangaben als eine Zeitspanne zurück. |
dayOfMonth | Gibt den Tag der Monatskomponente eines Zeitstempels zurück. |
dayOfWeek | Gibt den Tag der Wochenkomponente eines Zeitstempels zurück. |
dayOfYear | Gibt den Tag der Jahreskomponente eines Zeitstempels zurück. |
formatDateTime | Gibt das Datum eines Zeitstempels zurück. |
getFutureTime | Gibt den aktuellen Zeitstempel plus der angegebenen Zeiteinheiten zurück. Siehe auch addToTime. |
getPastTime | Gibt den aktuellen Zeitstempel abzüglich der angegebenen Zeiteinheiten zurück. Siehe auch subtractFromTime. |
parseDateTime | Gibt den Zeitstempel aus einer Zeichenfolge zurück, die einen Zeitstempel enthält. |
startOfDay | Gibt den Beginn des Tages für einen Zeitstempel zurück. |
startOfHour | Gibt den Beginn der Stunde für einen Zeitstempel zurück. |
startOfMonth | Gibt den Beginn des Monats für einen Zeitstempel zurück. |
subtractFromTime | Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime. |
ticks | Gibt den Eigenschaftswert ticks für einen angegebenen Zeitstempel zurück. |
utcNow | Gibt den aktuellen Zeitstempel als Zeichenfolge zurück. |
Workflowfunktionen
Diese Workflowfunktionen können für folgende Aktionen hilfreich sein:
- Abrufen von Details zu einer Workflowinstanz zur Laufzeit.
- Arbeiten mit den Eingaben für die Instanziierung von Logik-Apps oder Flows.
- Verweisen auf die Ausgaben von Triggern und Aktionen.
Sie können beispielsweise auf die Ausgaben einer Aktion verweisen und die Daten in einer späteren Aktion verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Workflowfunktion | Aufgabe |
---|---|
action | Gibt die Ausgabe der aktuellen Aktion zur Laufzeit oder Werte aus anderen Name/Wert-Paaren im JSON-Format zurück. Siehe auch actions. |
actions | Gibt die Ausgabe einer Aktion zur Laufzeit oder Werte aus anderen Name/Wert-Paaren im JSON-Format zurück. Siehe auch action. |
body | Gibt die body -Ausgabe einer Aktion zur Laufzeit zurück. |
formDataMultiValues | Erstellt ein Array mit den Werten, die mit einem Schlüsselnamen in Aktionsausgaben vom Typ form-data oder form-encoded übereinstimmen. |
formDataValue | Gibt einen einzelnen Wert zurück, der mit einem Schlüsselnamen in einer Aktionsausgabe vom Typ form-data oder form-encoded übereinstimmt. |
item | Wird diese Funktion in einer wiederholten Aktion für ein Array verwendet, gibt sie das Element zurück, das in der aktuellen Iteration der Aktion das aktuelle Arrayelement ist. |
items | Wird diese Funktion in einer Foreach- oder Until-Schleife verwendet, wird das aktuelle Element aus der angegebenen Schleife zurückgegeben. |
iterationIndexes | Wird diese Funktion in einer Until-Schleife verwendet, wird der Indexwert für die aktuelle Iteration zurückgegeben. Sie können diese Funktion in geschachtelten „Until“-Schleifen verwenden. |
listCallbackUrl | Gibt die „Rückruf-URL“ zurück, die einen Trigger oder eine Aktion aufruft. |
multipartBody | Gibt den Textteil für einen bestimmten Teil einer Aktionsausgabe zurück, die mehrere Teile hat. |
outputs | Gibt die Ausgabe einer Aktion zur Laufzeit zurück. |
parameters | Gibt den Wert für einen Parameter zurück, der in Ihrer Workflowdefinition beschrieben wird. |
result | Gibt die Eingaben und Ausgaben der Aktionen der obersten Ebene zurück, die in der angegebenen bereichsbezogenen Aktion enthalten sind, z. B. For_each , Until und Scope . |
trigger | Gibt die Ausgabe eines Triggers zur Laufzeit oder aus anderen Name/Wert-Paaren im JSON-Format zurück. Siehe auch triggerOutputs und triggerBody. |
triggerBody | Gibt die body -Ausgabe eines Triggers zur Laufzeit zurück. Siehe trigger. |
triggerFormDataValue | Gibt einen einzelnen Wert zurück, der mit einem Schlüsselnamen in Triggerausgaben vom Typ form-data oder form-encoded übereinstimmt. |
triggerMultipartBody | Gibt einen bestimmten Textteil in der mehrteiligen Ausgabe eines Triggers zurück. |
triggerFormDataMultiValues | Erstellt ein Array, dessen Werte mit einem Schlüsselnamen in Triggerausgaben vom Typ form-data oder form-encoded übereinstimmen. |
triggerOutputs | Gibt eine Triggerausgabe zur Laufzeit oder Werte aus anderen JSON-Name/Wert-Paaren zurück. Siehe trigger. |
variables | Gibt den Wert für eine angegebene Variable zurück. |
workflow | Gibt sämtliche Details zum Workflow selbst zur Laufzeit zurück. |
URI-Analysefunktionen
Sie können für die Arbeit mit URIs (Uniform Resource Identifiers) und das Abrufen verschiedener Eigenschaftswerte für diese URIs folgende URI-Analysefunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
URI-Analysefunktion | Aufgabe |
---|---|
uriHost | Gibt den Wert host für einen Uniform Resource Identifier (URI) zurück. |
uriPath | Gibt den Wert path für einen Uniform Resource Identifier (URI) zurück. |
uriPathAndQuery | Gibt die den path - und den query -Wert für einen Uniform Resource Identifier (URI) zurück. |
uriPort | Gibt den Wert port für einen Uniform Resource Identifier (URI) zurück. |
uriQuery | Gibt den Wert query für einen Uniform Resource Identifier (URI) zurück. |
uriScheme | Gibt den Wert scheme für einen Uniform Resource Identifier (URI) zurück. |
Bearbeitungsfunktionen: JSON und XML
Für die Arbeit mit JSON-Objekten und XML-Knoten können Sie folgende Bearbeitungsfunktionen verwenden. Die vollständige Referenz zu den einzelnen Funktionen finden Sie unter Funktionsreferenz zur Definitionssprache für Workflows in Azure Logic Apps.
Bearbeitungsfunktion | Aufgabe |
---|---|
addProperty | Fügt eine Eigenschaft und den zugehörigen Wert, oder ein Name/Wert-Paar zu einem JSON-Objekt hinzu und gibt das aktualisierte Objekt zurück. |
coalesce | Gibt den ersten Wert ungleich NULL aus mindestens einem Parameter zurück. |
removeProperty | Entfernt eine Eigenschaft aus einem JSON-Objekt und gibt das aktualisierte Objekt zurück. |
setProperty | Legt den Wert für die Eigenschaft eines JSON-Objekts fest und gibt das aktualisierte Objekt zurück. |
xpath | Überprüft die XML auf Knoten oder Werte, die mit einem XPath-Ausdruck (XML Path Language) übereinstimmen, und gibt die übereinstimmenden Knoten oder Werte zurück. |
---------------------------------
Alle Funktionen – alphabetische Liste
In diesem Abschnitt werden alle verfügbaren Funktionen in alphabetischer Reihenfolge aufgelistet.
Ein
action
Gibt die Ausgabe der aktuellen Aktion zur Laufzeit oder Werte aus anderen JSON-Name/Wert-Paaren zurück, die Sie einem Ausdruck zuweisen können. Standardmäßig verweist diese Funktion auf das gesamte Aktionsobjekt, Sie können jedoch optional eine Eigenschaft angeben, deren Wert Sie abrufen möchten. Informationen hierzu finden Sie auch unter actions().
Sie können die action()
-Funktion nur an folgenden Stellen verwenden:
- In der
unsubscribe
-Eigenschaft für eine Webhookaktion, sodass Sie auf das Ergebnis aus der ursprünglichensubscribe
-Anforderung zugreifen können - In der
trackedProperties
-Eigenschaft für eine Aktion - In der
do-until
-Schleifenbedingung für eine Aktion
action()
action().outputs.body.<property>
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<property> | Nein | String | Der Name der Aktionsobjekteigenschaft, deren Wert Sie abrufen möchten: name, startTime, endTime, inputs, outputs, status, code, trackingId und clientTrackingId. Im Azure-Portal finden Sie diese Eigenschaften, indem Sie die Details eines bestimmten Ausführungsverlaufs überprüfen. Weitere Informationen hierzu finden Sie unter REST-API - Workflowausführungsaktionen. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<action-output> | String | Die Ausgabe von der aktuellen Aktion oder die Eigenschaft |
Aktionen
Gibt die Ausgabe einer Aktion zur Laufzeit oder Werte aus anderen JSON-Name/Wert-Paaren zurück, die Sie einem Ausdruck zuweisen können. Standardmäßig verweist die Funktion auf das gesamte Aktionsobjekt, Sie können aber optional eine Eigenschaft angeben, deren Wert Sie abrufen möchten. Kurze Versionen finden Sie unter "body()". Informationen hinsichtlich der aktuellen Aktion finden Sie unter action().
Tipp
Die Ausgabe der Funktion actions()
wird als Zeichenfolge zurückgegeben. Wenn Sie als Rückgabewert ein JSON-Objekt benötigen, müssen Sie den Zeichenfolgenwert erst konvertieren. Der Zeichenfolgenwert kann mithilfe der Aktion „Parse JSON“ in ein JSON-Objekt transformiert werden.
Hinweis
Bisher konnten Sie die actions()
-Funktion oder das conditions
-Element verwenden, wenn Sie angeben haben, dass eine Aktion auf Basis der Ausgabe einer anderen Aktion ausgeführt wurde. Sie müssen nun aber, um Abhängigkeiten zwischen Aktionen explizit zu deklarieren, die runAfter
-Eigenschaft der abhängigen Aktion verwenden.
Weitere Informationen zur runAfter
-Eigenschaft finden Sie unter Abfangen und Behandeln von Fehlern mit der RunAfter-Eigenschaft.
actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Der Name des Aktionsobjekts, dessen Ausgabe Sie abrufen möchten |
<property> | Nein | String | Der Name der Aktionsobjekteigenschaft, deren Wert Sie abrufen möchten: name, startTime, endTime, inputs, outputs, status, code, trackingId und clientTrackingId. Im Azure-Portal finden Sie diese Eigenschaften, indem Sie die Details eines bestimmten Ausführungsverlaufs überprüfen. Weitere Informationen hierzu finden Sie unter REST-API - Workflowausführungsaktionen. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<action-output> | String | Die Ausgabe von der angegebenen Aktion oder Eigenschaft |
Beispiel
In diesem Beispiel wird der status
Eigenschaftswert aus der X-Aktion Get user
zur Laufzeit abgerufen:
actions('Get_user').outputs.body.status
Dies ist das zurückgegebene Ergebnis: "Succeeded"
add
Gibt das Ergebnis der Addition zweier Zahlen zurück.
add(<summand_1>, <summand_2>)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<summand_1>, <summand_2> | Ja | Integer, Float oder kombiniert | Die zu addierenden Zahlen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<result-sum> | Integer oder Float | Das Ergebnis der Addition der angegebenen Zahlen |
Beispiel
In diesem Beispiel werden die angegebenen Zahlen addiert:
add(1, 1.5)
Dies ist das zurückgegebene Ergebnis: 2.5
addDays
Fügt einem Zeitstempel Tage hinzu.
addDays('<timestamp>', <days>, '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<days> | Ja | Integer | Die positive oder negative Anzahl von Tagen, die hinzugefügt werden sollen |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel plus der angegebenen Anzahl von Tagen |
Beispiel 1
In diesem Beispiel werden 10 Tage zu dem angegebenen Zeitstempel addiert:
addDays('2018-03-15T00:00:00Z', 10)
Dies ist das zurückgegebene Ergebnis: "2018-03-25T00:00:00.0000000Z"
Beispiel 2
In diesem Beispiel werden 10 Tage vom angegebenen Zeitstempel subtrahiert:
addDays('2018-03-15T00:00:00Z', -5)
Dies ist das zurückgegebene Ergebnis: "2018-03-10T00:00:00.0000000Z"
addHours
Fügt einem Zeitstempel Stunden hinzu.
addHours('<timestamp>', <hours>, '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<hours> | Ja | Integer | Die positive oder negative Anzahl von Stunden, die hinzugefügt werden sollen |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel plus der angegebenen Anzahl von Stunden |
Beispiel 1
In diesem Beispiel werden 10 Stunden zu dem angegebenen Zeitstempel addiert:
addHours('2018-03-15T00:00:00Z', 10)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T10:00:00.0000000Z"
Beispiel 2
In diesem Beispiel werden 10 Stunden vom angegebenen Zeitstempel subtrahiert:
addHours('2018-03-15T15:00:00Z', -5)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T10:00:00.0000000Z"
addMinutes
Fügt einem Zeitstempel Minuten hinzu.
addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<minutes> | Ja | Integer | Die positive oder negative Anzahl von Minuten, die hinzugefügt werden sollen |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel plus der angegebenen Anzahl von Minuten |
Beispiel 1
In diesem Beispiel werden 10 Minuten zu dem angegebenen Zeitstempel addiert:
addMinutes('2018-03-15T00:10:00Z', 10)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:20:00.0000000Z"
Beispiel 2
In diesem Beispiel werden fünf Minuten vom angegebenen Zeitstempel subtrahiert:
addMinutes('2018-03-15T00:20:00Z', -5)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:15:00.0000000Z"
addProperty
Fügt eine Eigenschaft und den zugehörigen Wert, oder ein Name/Wert-Paar zu einem JSON-Objekt hinzu und gibt das aktualisierte Objekt zurück. Wenn die Eigenschaft zur Laufzeit bereits vorhanden ist, tritt in der Funktion ein Fehler auf, und sie löst einen Fehler aus.
addProperty(<object>, '<property>', <value>)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, zu dem Sie eine Eigenschaft hinzufügen möchten |
<property> | Ja | String | Der Name der zu Eigenschaft, die hinzugefügt werden soll |
<value> | Ja | Any | Der Wert für die Eigenschaft |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-object> | Object | Das aktualisierte JSON-Objekt mit der angegebenen Eigenschaft |
Verwenden Sie zum Hinzufügen einer übergeordneten Eigenschaft zu einer vorhandenen Eigenschaft die setProperty()
-Funktion und nicht die addProperty()
-Funktion. Andernfalls gibt die Funktion nur das untergeordnete Objekt als Ausgabe zurück.
setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, zu dem Sie eine Eigenschaft hinzufügen möchten |
<parent-property> | Ja | String | Der Name der übergeordneten Eigenschaft, der Sie die untergeordnete Eigenschaft hinzufügen möchten |
<child-property> | Ja | String | Der Name für die untergeordnete Eigenschaft, die hinzugefügt werden soll |
<value> | Ja | Any | Der Wert, auf den die angegebene Eigenschaft festgelegt werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-object> | Object | Das aktualisierte JSON-Objekt, dessen Eigenschaft Sie festlegen |
Beispiel 1
In diesem Beispiel wird die middleName
-Eigenschaft zu einem JSON-Objekt hinzugefügt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird. Das Objekt enthält bereits die Eigenschaften firstName
und surName
. Die Funktion weist der neuen Eigenschaft den angegebenen Wert zu und gibt das aktualisierte Objekt zurück:
addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"surName": "Owen"
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
Beispiel 2
In diesem Beispiel wird die untergeordnete middleName
-Eigenschaft zu der vorhandenen customerName
-Eigenschaft in einem JSON-Objekt hinzugefügt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird. Die Funktion weist der neuen Eigenschaft den angegebenen Wert zu und gibt das aktualisierte Objekt zurück:
setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophia",
"surName": "Owen"
}
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
}
addSeconds
Fügt einem Zeitstempel Sekunden hinzu.
addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<seconds> | Ja | Integer | Die positive oder negative Anzahl von Sekunden, die hinzugefügt werden sollen |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel plus der angegebenen Anzahl von Sekunden |
Beispiel 1
In diesem Beispiel werden 10 Sekunden zu dem angegebenen Zeitstempel addiert:
addSeconds('2018-03-15T00:00:00Z', 10)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:10.0000000Z"
Beispiel 2
In diesem Beispiel werden fünf Sekunden vom angegebenen Zeitstempel subtrahiert:
addSeconds('2018-03-15T00:00:30Z', -5)
Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:25.0000000Z"
addToTime
Fügt einem Zeitstempel die angegebenen Zeiteinheiten hinzu. Siehe auch getFutureTime().
addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<interval> | Ja | Integer | Die Anzahl der angegebenen Zeiteinheiten, die hinzugefügt werden sollen |
<timeUnit> | Ja | String | Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel plus der angegebenen Anzahl von Zeiteinheiten |
Beispiel 1
In diesem Beispiel wird ein Tag zu dem angegebenen Zeitstempel addiert:
addToTime('2018-01-01T00:00:00Z', 1, 'Day')
Dies ist das zurückgegebene Ergebnis: "2018-01-02T00:00:00.0000000Z"
Beispiel 2
In diesem Beispiel wird ein Tag zu dem angegebenen Zeitstempel addiert:
addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')
Dies ist das zurückgegebene Ergebnis mit dem optionalen „D“-Format: "Tuesday, January 2, 2018"
and
Überprüft, ob für sämtliche Ausdrücke der Wert „TRUE“ festgelegt ist. Gibt „true“ zurück, wenn alle Ausdrücke gleich „true“ sind, oder gibt „false“ zurück, wenn mindestens ein Ausdruck gleich „false“ ist.
and(<expression1>, <expression2>, ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<expression1>, <expression2>, ... | Ja | Boolean | Die Ausdrücke, die überprüft werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn alle Ausdrücke gleich „true“ sind. Gibt „false“ zurück, wenn mindestens ein Ausdruck gleich „false“ ist. |
Beispiel 1
In diesen Beispielen wird überprüft, ob alle angegebenen booleschen Werte gleich „true“ sind:
and(true, true)
and(false, true)
and(false, false)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Beide Ausdrücke sind gleich „true“, daher wird
true
zurückgegeben. - Zweites Beispiel: Ein Ausdruck ist gleich „false“, daher wird
false
zurückgegeben. - Drittes Beispiel: Beide Ausdrücke sind gleich „false“, daher wird
false
zurückgegeben.
Beispiel 2
In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke gleich „true“ sind:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Beide Ausdrücke sind gleich „true“, daher wird
true
zurückgegeben. - Zweites Beispiel: Ein Ausdruck ist gleich „false“, daher wird
false
zurückgegeben. - Drittes Beispiel: Beide Ausdrücke sind gleich „false“, daher wird
false
zurückgegeben.
array
Gibt ein Array aus einer einzelnen angegebenen Eingabe zurück. Informationen hinsichtlich mehrerer Eingaben finden Sie unter createArray().
array('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge zum Erstellen eines Arrays |
Rückgabewert | type | Beschreibung |
---|---|---|
[<value>] | Array | Ein Array, das die einzelne angegebene Eingabe enthält |
Beispiel
In diesem Beispiel wird ein Array aus der Zeichenfolge „hello“ erstellt:
array('hello')
Dies ist das zurückgegebene Ergebnis: ["hello"]
B
base64
Gibt die base64-codierte Version für eine Zeichenfolge zurück.
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem verwenden, kann es zu unerwartetem Rendering-Verhalten im Designer kommen. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
base64('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die eingegebene Zeichenfolge |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<base64-string> | String | Die base64-codierte Version für die eingegebene Zeichenfolge |
Beispiel
In diesem Beispiel wird die Zeichenfolge „hello“ in eine base64-codierte Zeichenfolge konvertiert:
base64('hello')
Dies ist das zurückgegebene Ergebnis: "aGVsbG8="
base64ToBinary
Gibt die Binärversion für eine base64-codierte Zeichenfolge zurück.
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem im Designer verwenden, treten möglicherweise unerwartete Renderingverhaltenim Designer auf. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
base64ToBinary('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die base64-codierte Zeichenfolge, die konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<binary-for-base64-string> | String | Die Binärversion für die base64-codierte Zeichenfolge |
Beispiel
In diesem Beispiel wird die base64-codierte Zeichenfolge „aGVsbG8“ in eine Binärzeichenfolge konvertiert:
base64ToBinary('aGVsbG8=')
Angenommen, Sie verwenden eine HTTP-Aktion, um eine Anforderung zu senden. Sie können base64ToBinary()
verwenden, um eine Base64-codierte Zeichenfolge in Binärdaten zu konvertieren, und diese Daten mit dem Inhaltstyp application/octet-stream
in der Anforderung senden.
base64ToString
Gibt die Zeichenfolgenversion einer base64-codierten Zeichenfolge zurück, d. h., die base64-Zeichenfolge wird decodiert. Verwenden Sie diese Funktion anstelle der veralteten Funktion decodeBase64().
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem im Designer verwenden, treten möglicherweise unerwartete Renderingverhaltenim Designer auf. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
base64ToString('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die base64-codierte Zeichenfolge, die decodiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<decoded-base64-string> | String | Die Zeichenfolgenversion für eine base64-codierte Zeichenfolge |
Beispiel
In diesem Beispiel wird die base64-codierte Zeichenfolge „aGVsbG8“ in eine einfache Zeichenfolge konvertiert:
base64ToString('aGVsbG8=')
Dies ist das zurückgegebene Ergebnis: "hello"
BINARY
Geben Sie die Base64-codierte Binärversion einer Zeichenfolge zurück.
binary('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge, die konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<binary-for-input-value> | String | Dies ist die Base64-codierte Binärversion für die angegebene Zeichenfolge. |
Beispiel
Sie verwenden beispielsweise eine HTTP-Aktion, die eine Bild- oder Videodatei zurückgibt. Sie können binary()
verwenden, um den Wert in ein Base64-codiertes Inhaltsumschlagsmodell zu konvertieren. Dann können Sie den Inhaltsumschlag erneut für andere Aktionen verwenden (z. B. Compose
).
Sie können diesen Funktionsausdruck verwenden, um die Zeichenfolgebytes mit dem Inhaltstyp application/octet-stream
in der Anforderung zu senden.
body
Gibt die body
-Ausgabe einer Aktion zur Laufzeit zurück. Kurzform für actions('<actionName>').outputs.body
. Siehe actions().
body('<actionName>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Der Name der Aktion, deren body -Ausgabe Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<action-body-output> | String | Die body -Ausgabe von der angegebenen Aktion |
Beispiel
In diesem Beispiel wird die body
Ausgabe der X-Aktion abgerufen Get user
:
body('Get_user')
Dies ist das zurückgegebene Ergebnis:
"body": {
"FullName": "Contoso Corporation",
"Location": "Generic Town, USA",
"Id": 283541717,
"UserName": "ContosoInc",
"FollowersCount": 172,
"Description": "Leading the way in transforming the digital workplace.",
"StatusesCount": 93,
"FriendsCount": 126,
"FavouritesCount": 46,
"ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}
bool
Gibt die boolesche Version eines Werts zurück.
bool(<value>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Any | Der Wert, der in einen booleschen Wert konvertiert werden soll. |
Wenn Sie bool()
mit einem Objekt verwenden, muss der Wert des Objekts eine Zeichenfolge oder eine ganze Zahl sein, die in einen booleschen Wert konvertiert werden kann.
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false |
Boolean | Die boolesche Version des angegebenen Werts |
Ausgaben
In diesen Beispielen werden die verschiedenen unterstützten Eingabetypen für bool()
gezeigt:
Eingabewert | Typ | Rückgabewert |
---|---|---|
bool(1) |
Integer | true |
bool(0) |
Integer | false |
bool(-1) |
Integer | true |
bool('true') |
String | true |
bool('false') |
String | false |
C
Block
Teilt eine Zeichenfolge oder ein Array in Blöcke gleicher Länge auf.
chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge oder Array | Die aufzuteilende Sammlung |
<length> | Ja | Die Länge jedes Blocks |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<collection> | Array | Ein Array von Blöcken mit der angegebenen Länge |
Beispiel 1
In diesem Beispiel wird eine Zeichenfolge in Blöcke mit der Länge 10 unterteilt:
chunk('abcdefghijklmnopqrstuvwxyz', 10)
Dies ist das zurückgegebene Ergebnis: ['abcdefghij', 'klmnopqrst', 'uvwxyz']
Beispiel 2
In diesem Beispiel wird ein Array in Blöcke mit der Länge 5 unterteilt.
chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)
Dies ist das zurückgegebene Ergebnis: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]
coalesce
Gibt den ersten Wert ungleich NULL aus mindestens einem Parameter zurück. Leere Zeichenfolgen, leere Arrays und leere Objekte sind nicht NULL.
coalesce(<object_1>, <object_2>, ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object_1>, <object_2>, ... | Ja | Beliebig, Typen können kombiniert sein | Ein oder mehrere Elemente, die auf NULL geprüft werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<first-non-null-item> | Any | Das erste Element oder der erste Wert, das oder der ungleich NULL ist. Sind alle Parameter gleich NULL, gibt diese Funktion NULL zurück. |
Beispiel
In diesen Beispielen wird für die angegebenen Werte der erste Wert ungleich NULL oder NULL zurückgegeben, wenn alle Werte gleich NULL sind:
coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
true
- Zweites Beispiel:
"hello"
- Drittes Beispiel:
null
concat
Kombiniert mindestens zwei Zeichenfolgen miteinander und gibt die kombinierte Zeichenfolge zurück.
concat('<text1>', '<text2>', ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<text1>, <text2>, ... | Ja | String | Mindestens zwei Zeichenfolgen, die kombiniert werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<text1text2...> | String | Die Zeichenfolge, die aus den kombinierten Eingabezeichenfolgen erstellt wurde. Hinweis: Die Länge des Ergebnisses darf 104.857.600 Zeichen nicht überschreiten. |
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Kodierung und -Dekodierung durch, sodass Sie diese Konvertierungen nicht manuell durchführen müssen, wenn Sie die concat()
Funktion mit Daten verwenden, die kodiert oder dekodiert werden müssen:
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
Wenn Sie diese Funktion jedoch trotzdem im Designer verwenden, kann es zu unerwartetem Rendering-Verhalten im Designer kommen. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf die Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
Beispiel
In diesem Beispiel werden die Zeichenfolgen „Hello“ und „World“ kombiniert:
concat('Hello', 'World')
Dies ist das zurückgegebene Ergebnis: "HelloWorld"
contains
Überprüft, ob eine Sammlung ein bestimmtes Element enthält. Gibt „true“ zurück, wenn das Element gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung beachtet.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
Diese Funktion ist insbesondere für diese Sammlungstypen vorgesehen:
- Eine Zeichenfolge, in der nach einer Teilzeichenfolge gesucht werden soll
- Ein Array, in dem nach einem Wert gesucht werden soll
- Ein Wörterbuch, in dem nach einem Schlüssel gesucht werden soll
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge, Array oder Wörterbuch | Die Sammlung, die überprüft werden soll |
<value> | Ja | Zeichenfolge, Array bzw. Wörterbuch | Das Element, nach dem gesucht werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“, wenn das Element gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde. |
Beispiel 1
In diesem Beispiel wird die Zeichenfolge „hello world“ auf die Teilzeichenfolge „world“ geprüft und „true“ zurückgegeben:
contains('hello world', 'world')
Beispiel 2
In diesem Beispiel wird die Zeichenfolge „hello world“ auf die Teilzeichenfolge „universed“ geprüft und „false“ zurückgegeben:
contains('hello world', 'universe')
convertFromUtc
Konvertiert einen Zeitstempel von der UTC-Zeitzone (UTC = Universal Time, Coordinated) in die Zielzeitzone.
convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<destinationTimeZone> | Ja | String | Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Standardzeitzonen. |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<converted-timestamp> | String | Der in die Zielzeitzone konvertierte Zeitstempel ohne UTC-Zeitzonenabweichung. |
Beispiel 1
In diesem Beispiel wird ein Zeitstempel in das Format der angegebenen Zeitzone konvertiert:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')
Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00.0000000"
Beispiel 2
In diesem Beispiel wird ein Zeitstempel in das Format der angegebenen Zeitzone konvertiert und formatiert:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')
Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"
convertTimeZone
Konvertiert einen Zeitstempel von der Quellzeitzone in die Zielzeitzone.
convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<sourceTimeZone> | Ja | String | Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Standardzeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen. |
<destinationTimeZone> | Ja | String | Der Name für die Zielzeitzone. Informationen zu Zeitzonennamen finden Sie unter Standardzeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen. |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<converted-timestamp> | String | Der in das Format der Zielzeitzone konvertierte Zeitstempel |
Beispiel 1
In diesem Beispiel wird ein Zeitstempel von der Quellzeitzone in die Zielzeitzone konvertiert.
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')
Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00.0000000"
Beispiel 2
In diesem Beispiel wird eine Zeitzone in die angegebene Zeitzone konvertiert und formatiert:
convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')
Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"
convertToUtc
Konvertiert einen Zeitstempel von der Quellzeitzone in die UTC-Zeitzone (UTC = Universal Time, Coordinated).
convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<sourceTimeZone> | Ja | String | Der Name für die Quellzeitzone. Informationen zu Zeitzonennamen finden Sie unter Standardzeitzonen. Möglicherweise müssen Sie aber alle Satzzeichen aus dem Zeitzonennamen entfernen. |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<converted-timestamp> | String | Der Zeitstempel, der in UTC konvertiert wurde |
Beispiel 1
In diesem Beispiel wird ein Zeitstempel in UTC konvertiert:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')
Dies ist das zurückgegebene Ergebnis: "2018-01-01T08:00:00.0000000Z"
Beispiel 2
In diesem Beispiel wird ein Zeitstempel in UTC konvertiert:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')
Dies ist das zurückgegebene Ergebnis: "Monday, January 1, 2018"
createArray
Gibt ein Array aus mehreren Eingaben zurück. Informationen zu Arrays mit einzelner Eingabe finden Sie unter array().
createArray('<object1>', '<object2>', ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object1>, <object2>, ... | Ja | Beliebig, aber nicht kombiniert | Mindestens zwei Elemente, mit denen das Array erstellt wird |
Rückgabewert | type | Beschreibung |
---|---|---|
[<object1>, <object2>, ...] | Array | Das Array, das aus allen Eingabeelemente erstellt wurde |
Beispiel
In diesem Beispiel wird ein Array aus diesen Eingaben erstellt:
createArray('h', 'e', 'l', 'l', 'o')
Dies ist das zurückgegebene Ergebnis: ["h", "e", "l", "l", "o"]
D
dataUri
Gibt einen Daten-URI (Uniform Resource Identifier) für eine Zeichenfolge zurück.
dataUri('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge, die konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<data-uri> | String | Der Daten-URI für die Eingabezeichenfolge |
Beispiel
In diesem Beispiel wird ein Daten-URI für die Zeichenfolge „hello“ erstellt:
dataUri('hello')
Dies ist das zurückgegebene Ergebnis: "data:text/plain;charset=utf-8;base64,aGVsbG8="
dataUriToBinary
Gibt die binäre Version eines Daten-URIs (Uniform Resource Identifier) zurück.
Verwenden Sie diese Funktion anstelle von decodeDataUri().
Obwohl beide Funktionen in gleicher Weise funktionieren, wird dataUriBinary()
bevorzugt.
dataUriToBinary('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Der Daten-URI, der konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<binary-for-data-uri> | String | Die binäre Version für den Daten-URI |
Beispiel
In diesem Beispiel wird eine binäre Version für diesen Daten-URI erstellt:
dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Dies ist das zurückgegebene Ergebnis:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
dataUriToString
Gibt die Zeichenfolgenversion für einen Daten-URI (Uniform Resource Identifier) zurück.
dataUriToString('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Der Daten-URI, der konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<string-for-data-uri> | String | Die Zeichenfolgenversion des Daten-URIs |
Beispiel
In diesem Beispiel wird eine Zeichenfolge für diesen Daten-URI erstellt:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Dies ist das zurückgegebene Ergebnis: "hello"
dateDifference
Gibt die Differenz zwischen zwei Zeitstempeln als eine Zeitspanne zurück. Diese Funktion subtrahiert startDate
von endDate
, und gibt das Ergebnis als Zeitstempel im Zeichenfolgenformat zurück.
dateDifference('<startDate>', '<endDate>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<startDate> | Ja | String | Eine Zeichenfolge, die einen Zeitstempel enthält |
<endDate> | Ja | String | Eine Zeichenfolge, die einen Zeitstempel enthält |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<timespan> | String | Der Unterschied zwischen den beiden Zeitstempeln, d. h. ein Zeitstempel im Zeichenfolgenformat. Wenn startDate jünger ist als endDate , ist das Ergebnis ein negativer Wert. |
Beispiel
In diesem Beispiel wird der erste Wert vom zweiten Wert subtrahiert:
dateDifference('2015-02-08', '2018-07-30')
Dies ist das zurückgegebene Ergebnis: "1268.00:00:00"
dayOfMonth
Gibt den Tag des Monats aus einem Zeitstempel zurück.
dayOfMonth('<timestamp>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<day-of-month> | Integer | Der Tag des Monats aus dem angegebenen Zeitstempel |
Beispiel
In diesem Beispiel wird die Zahl für den Tag des Monats aus diesem Zeitstempel zurückgegeben:
dayOfMonth('2018-03-15T13:27:36Z')
Dies ist das zurückgegebene Ergebnis: 15
dayOfWeek
Gibt den Wochentag aus einem Zeitstempel zurück.
dayOfWeek('<timestamp>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<day-of-week> | Integer | Der Wochentag aus dem angegebenen Zeitstempel, wobei Folgendes gilt: Sonntag = 0, Montag = 1 usw. |
Beispiel
In diesem Beispiel wird die Zahl für den Wochentag aus diesem Zeitstempel zurückgegeben:
dayOfWeek('2018-03-15T13:27:36Z')
Dies ist das zurückgegebene Ergebnis: 4
dayOfYear
Gibt den Tag des Jahres aus einem Zeitstempel zurück.
dayOfYear('<timestamp>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<day-of-year> | Integer | Der Tag des Jahres aus dem angegebenen Zeitstempel |
Beispiel
In diesem Beispiel wird die Zahl für den Tag des Jahres aus diesem Zeitstempel zurückgegeben:
dayOfYear('2018-03-15T13:27:36Z')
Dies ist das zurückgegebene Ergebnis: 74
Decimal
Gibt eine Dezimalzahl in einer Zeichenfolge als Dezimalzahl zurück. Sie können diese Funktion verwenden, wenn Sie mit Daten arbeiten, die dezimale Genauigkeit erfordern, sowie als Eingabe für logische Vergleichsfunktionen und mathematische Funktionen. Um die Genauigkeit zu erfassen und beizubehalten, wenn Sie das Ergebnis der decimal()-Funktion verwenden, umschließen Sie jede Dezimalausgabe mit der Zeichenfolgenfunktion. Diese Verwendung wird in den folgenden Beispielen gezeigt, in denen Sie die Genauigkeit verlieren können, wenn Sie das Dezimalergebnis als Zahl verwenden.
Hinweis
Die Dezimalgenauigkeit, die im Kontext für diese Funktion und die Azure Logic Apps-Runtime erläutert wird, entspricht der Dezimalgenauigkeit von .NET.
decimal('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Dezimalzahl in einer Zeichenfolge |
Rückgabewert | type | Beschreibung |
---|---|---|
<dezimal> | Decimal Number | Die Dezimalzahl für die Eingabezeichenfolge |
Beispiel 1
In diesem Beispiel wird eine Dezimalzahl erstellt, die als Zahl verwendet wird:
decimal('1.2345678912312131') // Returns 1.234567891231213.
Beispiel 2
In diesem Beispiel wird eine Dezimalzahl erstellt und dann das Ergebnis zur Beibehaltung der Genauigkeit in eine Zeichenfolge konvertiert:
string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".
Beispiel 3
In diesem Beispiel wird eine mathematische Funktion mit zwei Dezimalzahlen und das Ergebnis als Zahl verwendet:
add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.
Beispiel 4
In diesem Beispiel wird eine mathematische Funktion für zwei Dezimalzahlen verwendet und das Ergebnis zur Beibehaltung der Genauigkeit in eine Zeichenfolge konvertiert:
string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".
decodeBase64 (veraltet)
Diese Funktion ist veraltet. Verwenden Sie stattdessen base64ToString().
decodeDataUri
Gibt die binäre Version eines Daten-URIs (Uniform Resource Identifier) zurück. Sie sollten dataUriToBinary() anstelle von decodeDataUri()
verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird dataUriToBinary()
bevorzugt.
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem im Designer verwenden, treten möglicherweise unerwartete Renderingverhaltenim Designer auf. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
decodeDataUri('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Daten-URI-Zeichenfolge, die decodiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<binary-for-data-uri> | String | Die Binärversion für eine Daten-URI-Zeichenfolge |
Beispiel
In diesem Beispiel wird die binäre Version für diesen Daten-URI zurückgegeben:
decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Dies ist das zurückgegebene Ergebnis:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
decodeUriComponent
Gibt eine Zeichenfolge zurück, in der Escapezeichen durch decodierte Versionen ersetzt sind.
decodeUriComponent('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge mit den Escapezeichen, die decodiert werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<decoded-uri> | String | Die aktualisierte Zeichenfolge mit den decodierten Escapezeichen |
Beispiel
In diesem Beispiel werden die Escapezeichen in dieser Zeichenfolge durch decodierte-Versionen ersetzt:
decodeUriComponent('https%3A%2F%2Fcontoso.com')
Dies ist das zurückgegebene Ergebnis: "https://contoso.com"
div
Gibt das Ergebnis der Division zweier Zahlen zurück. Informationen zum Abrufen des Restwerts finden Sie unter mod().
div(<dividend>, <divisor>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<dividend> | Ja | Integer oder Float | Die Zahl, die durch den Divisor dividiert werden soll. |
<divisor> | Ja | Integer oder Float | Die Zahl, durch die der Dividend geteilt wird. Darf nicht null sein. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<quotient-result> | Integer oder Float | Das Ergebnis aus der Division der ersten Zahl durch die zweite Zahl. Wenn der Dividend oder der Divisor den Typ Float aufweist, weist auch das Ergebnis den Typ Float auf. Hinweis: Um das Float-Ergebnis in einen Integer zu konvertieren, können Sie in Azure in Ihrer Logik-App eine Funktion erstellen und aufrufen. |
Beispiel 1
Beide Beispiele geben diesen Wert mit dem Typ Integer zurück: 2
div(10,5)
div(11,5)
Beispiel 2
Beide Beispiele geben diesen Wert mit dem Typ Float zurück: 2.2
div(11,5.0)
div(11.0,5)
E
encodeUriComponent
Gibt eine URI-codierte (Uniform Resource Identifier) Version für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Sie sollten uriComponent() anstelle von encodeUriComponent()
verwenden. Obwohl beide Funktionen in gleicher Weise funktionieren, wird uriComponent()
bevorzugt.
Hinweis
Azure Logic Apps führt automatisch oder implizit die Base64-Codierung und -Decodierung durch, sodass Sie diese Konvertierungen nicht manuell mithilfe der Codierungs- und Decodierungsfunktionen durchführen müssen. Wenn Sie diese Funktionen jedoch trotzdem im Designer verwenden, treten möglicherweise unerwartete Renderingverhaltenim Designer auf. Diese Verhalten wirken sich nur auf die Sichtbarkeit der Funktionen aus, und nicht auf ihre Auswirkung, es sei denn, Sie bearbeiten die Parameterwerte der Funktionen, wodurch die Funktionen und ihre Effekte aus dem Code entfernt werden. Weitere Informationen finden Sie unter Base64-Codierung und-Decodierung.
encodeUriComponent('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<encoded-uri> | String | Die URI-codierte Zeichenfolge mit Escapezeichen |
Beispiel
In diesem Beispiel wird eine URI-codierte Version für diese Zeichenfolge erstellt:
encodeUriComponent('https://contoso.com')
Dies ist das zurückgegebene Ergebnis: "https%3A%2F%2Fcontoso.com"
empty
Überprüft, ob eine Sammlung leer ist. Gibt „true“ zurück, wenn die Sammlung leer ist, oder gibt „false“ zurück, wenn sie nicht leer ist.
empty('<collection>')
empty([<collection>])
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge, Array oder Objekt | Die Sammlung, die überprüft werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn die Sammlung leer ist. Gibt „false“ zurück, wenn sie nicht leer ist. |
Beispiel
In diesen Beispielen wird überprüft, ob die angegebenen Sammlungen leer sind:
empty('')
empty('abc')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Es wird eine leere Zeichenfolge übergeben, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Es wird die Zeichenfolge „abc“ übergeben, weshalb die Funktion
false
zurückgibt.
endsWith
Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge endet. Gibt „true“ zurück, wenn die Teilzeichenfolge gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.
endsWith('<text>', '<searchText>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die überprüft werden soll |
<searchText> | Ja | String | Die beendende Teilzeichenfolge, nach der gesucht werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn die beendende Teilzeichenfolge gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde. |
Beispiel 1
In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Zeichenfolge „world“ endet:
endsWith('hello world', 'world')
Dies ist das zurückgegebene Ergebnis: true
Beispiel 2
In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Zeichenfolge „universe“ endet:
endsWith('hello world', 'universe')
Dies ist das zurückgegebene Ergebnis: false
equals
Überprüft, ob beide Werte, Ausdrücke oder Objekte gleichwertig sind. Gibt „true“ zurück, wenn beide gleichwertig sind, gibt andernfalls „false“ zurück.
equals('<object1>', '<object2>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object1>, <object2> | Ja | Verschiedene | Die Werte, Ausdrücke oder Objekte, die verglichen werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn beide gleichwertig sind. Gibt „false“ zurück, wenn sie nicht gleichwertig sind. |
Beispiel
In diesen Beispielen wird überprüft, ob die angegebenen Eingaben gleichwertig sind:
equals(true, 1)
equals('abc', 'abcd')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Beide Werte sind gleichwertig, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Beide Werte sind nicht gleichwertig, weshalb die Funktion
false
zurückgibt.
F
first
Gibt das erste Element aus einer Zeichenfolge oder einem Array zurück.
first('<collection>')
first([<collection>])
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge oder Array | Die Sammlung, aus der das erste Element abgerufen werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<first-collection-item> | Any | Das erste Element in der Sammlung |
Beispiel
In diesen Beispielen wird jeweils das erste Element aus diesen Sammlungen abgerufen:
first('hello')
first(createArray(0, 1, 2))
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
"h"
- Zweites Beispiel:
0
float
Konvertiert die Zeichenfolgenversion einer Gleitkommazahl in eine tatsächliche Gleitkommazahl. Diese Funktion können Sie nur verwenden, wenn Sie benutzerdefinierte Parameter an eine App (z. B. einen Workflow einer Logik-App oder einen Power Automate-Flow) übergeben. Um in gebietsschemaspezifischen Formaten dargestellte Gleitkommazeichenfolgen zu konvertieren, können Sie optional einen RFC 4646-Gebietsschemacode angeben.
float('<value>', '<locale>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge, die die gültige Gleitkommazahl angibt, die konvertiert werden soll. Die Mindest- und Höchstwerte sind identisch mit den Grenzwerten für den float-Datentyp. |
<locale> | Nein | String | Der zu verwendende RFC 4646-Gebietsschemacode. Ohne Angabe wird das Standardgebietsschema verwendet. Wenn locale kein gültiger Wert ist, wird ein Fehler mit dem Hinweis generiert, dass das bereitgestellte Gebietsschema ungültig ist oder kein zugeordnetes Gebietsschema vorhanden ist. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<float-value> | Float | Die Gleitkommazahl für die angegebene Zeichenfolge. Die Mindest- und Höchstwerte sind identisch mit den Grenzwerten für den float-Datentyp. |
Beispiel 1
In diesem Beispiel wird eine Zeichenfolgenversion für diese Gleitkommazahl erstellt:
float('10,000.333')
Dies ist das zurückgegebene Ergebnis: 10000.333
Beispiel 2
In diesem Beispiel wird eine Zeichenfolgenversion für diese Gleitkommazahl im deutschen Format erstellt:
float('10.000,333', 'de-DE')
Dies ist das zurückgegebene Ergebnis: 10000.333
formatDateTime
Gibt einen Zeitstempel im angegebenen Format zurück.
formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. |
<locale> | Nein | String | Das zu verwendende Gebietsschema. Ohne Angabe wird der Wert en-us verwendet. Wenn locale kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<reformatted-timestamp> | String | Der aktualisierte Zeitstempel im angegebenen Format und Gebietsschema, sofern angegeben |
Beispiele
formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.
formDataMultiValues
Gibt ein Array mit den Werten zurück, die mit einem Schlüsselnamen (key-Name) in der form-data- oder form-encoded-Ausgabe einer Aktion übereinstimmen.
formDataMultiValues('<actionName>', '<key>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Die Aktion, deren Ausgabe den Schlüsselwert (key-Wert) hat, den Sie abrufen möchten |
<key> | Ja | String | Der Name des Schlüssels, dessen Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
[<array-with-key-values>] | Array | Ein Array mit allen Werten, die mit dem angegebenen Schlüssel übereinstimmen. |
Beispiel
In diesem Beispiel wird ein Array aus dem Wert erstellt, den der „Subject“-Schlüssel in der form-data- oder form-encoded Ausgabe der angegebenen Aktion hat:
formDataMultiValues('Send_an_email', 'Subject')
Der Betrefftext (Subject) wird in einem Array zurückgegeben, zum Beispiel: ["Hello world"]
formDataValue
Gibt einen einzelnen Wert zurück, der mit einem Schlüsselnamen (key-Name) in der form-data- oder form-encoded-Ausgabe einer Aktion übereinstimmt. Findet die Funktion mehrere Übereinstimmungen, löst sie einen Fehler aus.
formDataValue('<actionName>', '<key>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Die Aktion, deren Ausgabe den Schlüsselwert (key-Wert) hat, den Sie abrufen möchten |
<key> | Ja | String | Der Name des Schlüssels, dessen Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<key-value> | String | Der Wert in dem angegebenen Schlüssel |
Beispiel
In diesem Beispiel wird eine Zeichenfolge aus dem Wert des „Subject“-Schlüssels in der form-data- oder form-encoded Ausgabe der angegebenen Aktion erstellt:
formDataValue('Send_an_email', 'Subject')
Der Betrefftext (Subject) wird als Zeichenfolge zurückgegeben, zum Beispiel: "Hello world"
formatNumber
Gibt eine Zahl als Zeichenfolge zurück, die auf dem angegebenen Format basiert.
formatNumber(<number>, <format>, <locale>?)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<number> | Ja | Integer oder Double | Der Wert, den Sie formatieren möchten. |
<format> | Ja | String | Eine kombinierten Formatzeichenfolge, die das Format angibt, das Sie verwenden möchten. Informationen zu den unterstützten Formatzeichenfolgen für Zahlen finden Sie unter Standardformatzeichenfolgen für Zahlen, die von number.ToString(<format>, <locale>) unterstützt werden. |
<locale> | Nein | String | Das zu verwendende Gebietsschema gemäß der Unterstützung durch number.ToString(<format>, <locale>) . Ohne Angabe wird der Wert en-us verwendet. Wenn locale kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<formatted-number> | String | Die angegebene Zahl als Zeichenfolge in dem von Ihnen angegebenen Format. Sie können diesen Rückgabewert in einen int - oder float -Wert umwandeln. |
Beispiel 1
Angenommen, Sie möchten die Zahl 1234567890
formatieren. In diesem Beispiel wird diese Zahl als Zeichenfolge „1,234,567,890.00“ formatiert.
formatNumber(1234567890, '0,0.00', 'en-us')
*Beispiel 2:
Angenommen, Sie möchten die Zahl 1234567890
formatieren. In diesem Beispiel wird diese Zahl als Zeichenfolge „1.234.567.890,00“ formatiert.
formatNumber(1234567890, '0,0.00', 'is-is')
Beispiel 3
Angenommen, Sie möchten die Zahl 17.35
formatieren. In diesem Beispiel wird diese Zahl als Zeichenfolge „$17.35“ formatiert.
formatNumber(17.35, 'C2')
Beispiel 4
Angenommen, Sie möchten die Zahl 17.35
formatieren. In diesem Beispiel wird diese Zahl als Zeichenfolge „17,35 kr“ formatiert.
formatNumber(17.35, 'C2', 'is-is')
G
getFutureTime
Gibt den aktuellen Zeitstempel plus der angegebenen Zeiteinheiten zurück.
getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<interval> | Ja | Integer | Die Anzahl hinzuzufügender Zeiteinheiten. |
<timeUnit> | Ja | String | Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year |
<format> | Nein | String | Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler mit dem Hinweis generiert, dass das angegebene Format ungültig ist und eine numerische Formatzeichenfolge sein muss. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der aktuelle Zeitstempel plus der angegebenen Anzahl von Zeiteinheiten |
Beispiel 1
Angenommen, der aktuelle Zeitstempel lautet „2018-03-01T00:00:00.0000000Z“. In diesem Beispiel werden diesem Zeitstempel fünf Tage hinzugefügt:
getFutureTime(5, 'Day')
Dies ist das zurückgegebene Ergebnis: "2018-03-06T00:00:00.0000000Z"
Beispiel 2
Angenommen, der aktuelle Zeitstempel lautet „2018-03-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage hinzugefügt, und das Ergebnis wird in das „D“-Format konvertiert:
getFutureTime(5, 'Day', 'D')
Dies ist das zurückgegebene Ergebnis: "Tuesday, March 6, 2018"
getPastTime
Gibt den aktuellen Zeitstempel abzüglich der angegebenen Zeiteinheiten zurück.
getPastTime(<interval>, <timeUnit>, <format>?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<interval> | Ja | Integer | Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen |
<timeUnit> | Ja | String | Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year |
<format> | Nein | String | Entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster. Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler mit dem Hinweis generiert, dass das angegebene Format ungültig ist und eine numerische Formatzeichenfolge sein muss. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der aktuelle Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten |
Beispiel 1
Angenommen, der aktuelle Zeitstempel lautet „2018-02-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage von diesem Zeitstempel subtrahiert:
getPastTime(5, 'Day')
Dies ist das zurückgegebene Ergebnis: "2018-01-27T00:00:00.0000000Z"
Beispiel 2
Angenommen, der aktuelle Zeitstempel lautet „2018-02-01T00:00:00.0000000Z“. In diesem Beispiel werden fünf Tage subtrahiert, und das Ergebnis wird in das „D“-Format konvertiert:
getPastTime(5, 'Day', 'D')
Dies ist das zurückgegebene Ergebnis: "Saturday, January 27, 2018"
greater
Überprüft, ob der erste Wert größer als der zweite ist. Gibt „true“ zurück, wenn der erste Wert größer ist, gibt andernfalls „false“ zurück.
greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Integer, Float oder Zeichenfolge | Der Wert (erster Wert), für den überprüft wird, ob er größer ist als der zweite Wert. |
<compareTo> | Ja | Integer, Float bzw. Zeichenfolge | Der Vergleichswert |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn der erste Wert größer ist als der zweite Wert. Gibt „false“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist. |
Beispiel
In diesen Beispiel wird überprüft, ob der erste Wert größer ist als der zweite Wert.
greater(10, 5)
greater('apple', 'banana')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
true
- Zweites Beispiel:
false
greaterOrEquals
Überprüft, ob der erste Wert größer als oder gleich dem zweiten ist. Gibt „true“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist, gibt andernfalls „false“ zurück.
greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Integer, Float oder Zeichenfolge | Der Wert (erster Wert), für den überprüft werden soll, ob er größer gleich dem zweiten Wert ist. |
<compareTo> | Ja | Integer, Float bzw. Zeichenfolge | Der Vergleichswert |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist. Gibt „false“ zurück, wenn der erste Wert kleiner ist als der zweite Wert. |
Beispiel
In diesen Beispiel wird überprüft, ob der erste Wert größer gleich dem zweiten Wert ist:
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
true
- Zweites Beispiel:
false
guid
Generiert einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID) als Zeichenfolge, z. B. „c2ecc88d-88c8-4096-912c-d6f2e2b138ce“:
guid()
Außerdem können Sie für den GUID ein anderes Format angeben, das vom Standardformat „D“ abweicht, das aus 32 durch Bindestriche getrennten Ziffern besteht.
guid('<format>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<format> | Nein | String | Ein einzelner Formatbezeichner für den zurückgegebenen GUID. Das Standardformat ist „D“, Sie können aber „N“, „D“, „B“, „P“ oder „X“ verwenden. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<GUID-value> | String | Ein zufällig generierter GUID |
Beispiel
In diesem Beispiel wird derselbe GUID generiert, jedoch mit 32 Ziffern, die durch Bindestriche getrennt sind und in Klammern stehen:
guid('P')
Dies ist das zurückgegebene Ergebnis: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"
I
if
Überprüft, ob ein Ausdruck gleich „true“ oder „false“ ist. Gibt abhängig vom Ergebnis einen angegebenen Wert zurück. Parameter werden von links nach rechts ausgewertet.
if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<expression> | Ja | Boolean | Der zu überprüfende Ausdruck |
<valueIfTrue> | Ja | Any | Der Wert, der zurückgegeben werden soll, wenn der Ausdruck gleich „true“ ist |
<valueIfFalse> | Ja | Any | Der Wert, der zurückgegeben werden soll, wenn der Ausdruck gleich „false“ ist |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<specified-return-value> | Any | Der angegebene Wert, der abhängig davon zurückgegeben wird, ob der Ausdruck gleich „true“ oder „false“ ist. |
Beispiel
In diesem Beispiel wird "yes"
zurückgegeben, weil für den angegebenen Ausdruck „true“ zurückgegeben wird.
Andernfalls wird in dem Beispiel "no"
zurückgegeben:
if(equals(1, 1), 'yes', 'no')
indexOf
Gibt die Anfangsposition oder den Anfangsindexwert für eine Teilzeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.
indexOf('<text>', '<searchText>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll |
<searchText> | Ja | String | Die Teilzeichenfolge, nach der gesucht werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<index-value> | Integer | Die Anfangsposition oder der Anfangsindexwert für die angegebene Teilzeichenfolge. Wird die Zeichenfolge nicht gefunden, wird die Zahl -1 zurückgegeben. |
Beispiel
In diesem Beispiel wird für die Teilzeichenfolge „world“ nach dem Anfangsindexwert gesucht, den sie in der Zeichenfolge „hello world“ hat:
indexOf('hello world', 'world')
Dies ist das zurückgegebene Ergebnis: 6
INT
Konvertiert die Zeichenfolgenversion einer ganzen Zahl in eine tatsächliche ganze Zahl.
int('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolgenversion für die zu konvertierende ganze Zahl. Die Mindest- und Höchstwerte sind identisch mit den Grenzwerten für den integer-Datentyp. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<integer-result> | Integer | Die Ganzzahlversion für die angegebene Zeichenfolge. Die Mindest- und Höchstwerte sind identisch mit den Grenzwerten für den integer-Datentyp. |
Beispiel
In diesem Beispiel wird die Ganzzahlversion für die Zeichenfolge „10“ erstellt:
int('10')
Dies ist das zurückgegebene Ergebnis: 10
isFloat
Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine Gleitkommazahl ist. Standardmäßig verwendet diese Funktion die invariante Kultur für das Gleitkommaformat. Um in anderen gebietsschemaspezifischen Formaten dargestellte Gleitkommazahlen zu identifizieren, können Sie optional einen RFC 4646-Gebietsschemacode angeben.
isFloat('<string>', '<locale>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die zu untersuchende Zeichenfolge |
<locale> | Nein | String | Der zu verwendende RFC 4646-Gebietsschemacode |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<boolean-result> | Boolean | Ein boolescher Wert, der angibt, ob die Zeichenfolge eine Gleitkommazahl ist |
Beispiel 1
In diesem Beispiel wird überprüft, ob eine Zeichenfolge eine Gleitkommazahl in der invarianten Kultur ist:
isFloat('10,000.00')
Dies ist das zurückgegebene Ergebnis: true
Beispiel 2
In diesem Beispiel wird überprüft, ob eine Zeichenfolge eine Gleitkommazahl im deutschen Gebietsschema ist:
isFloat('10.000,00', 'de-DE')
Dies ist das zurückgegebene Ergebnis: true
isInt
Gibt einen booleschen Wert zurück, der angibt, ob eine Zeichenfolge eine ganze Zahl ist.
isInt('<string>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<string> | Ja | String | Die zu untersuchende Zeichenfolge |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<boolean-result> | Boolean | Ein boolescher Wert, der angibt, ob die Zeichenfolge eine ganze Zahl ist |
Beispiel
In diesem Beispiel wird überprüft, ob eine Zeichenfolge eine ganze Zahl ist:
isInt('10')
Dies ist das zurückgegebene Ergebnis: true
item
Wird diese Funktion in einer wiederholten Aktion für ein Array verwendet, gibt sie das Element zurück, das in der aktuellen Iteration der Aktion das aktuelle Arrayelement ist. Sie können die Werte auch aus den Eigenschaften dieses Elements abrufen.
item()
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<current-array-item> | Any | Das aktuelle Element im Array für die aktuelle Iteration der Aktion |
Beispiel
In diesem Beispiel wird das body
-Element aus der aktuellen Nachricht für die „Send_an_email“-Aktion in der aktuellen Iteration einer for-each-Schleife abgerufen:
item().body
items
Gibt das aktuelle Element aus jedem Zyklus einer for-each-Schleife zurück. Verwenden Sie diese Funktion in einer for-each-Schleife.
items('<loopName>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<loopName> | Ja | String | Der Name der for-each-Schleife |
Rückgabewert | type | Beschreibung |
---|---|---|
<item> | Any | Das Element aus dem aktuellen Zyklus in der angegebenen for-each-Schleife |
Beispiel
In diesem Beispiel wird das aktuelle Element aus der angegebenen for-each-Schleife abgerufen:
items('myForEachLoopName')
iterationIndexes
Gibt den Indexwert für die aktuelle Iteration in einer „Until“-Schleife zurück. Sie können diese Funktion in geschachtelten „Until“-Schleifen verwenden.
iterationIndexes('<loopName>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<loopName> | Ja | String | Name der „Until“-Schleife |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<index> | Integer | Indexwert für die aktuelle Iteration in der angegebenen „Until“-Schleife |
Beispiel
In diesem Beispiel wird eine Zählervariable erstellt, die dann bei jeder Iteration einer „Until“-Schleife um den Wert 1 inkrementiert wird, bis der Zählerwert 5 erreicht ist. Außerdem wird im Beispiel eine Variable erstellt, mit der der aktuelle Index für jede Iteration nachverfolgt wird. In dem Beispiel wird bei jeder Iteration in der Until-Schleife der Zählerwert erhöht und dem aktuellen Indexwert zugewiesen. Anschließend wird der Zählerwert erhöht. Innerhalb der Schliefe verweist dieses Beispiel mithilfe der Funktion iterationIndexes
auf den aktuellen Iterationsindex:
iterationIndexes('Until_Max_Increment')
{
"actions": {
"Create_counter_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myCounter",
"type": "Integer",
"value": 0
}
]
},
"runAfter": {}
},
"Create_current_index_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myCurrentLoopIndex",
"type": "Integer",
"value": 0
}
]
},
"runAfter": {
"Create_counter_variable": [ "Succeeded" ]
}
},
"Until_Max_Increment": {
"type": "Until",
"actions": {
"Assign_current_index_to_counter": {
"type": "SetVariable",
"inputs": {
"name": "myCurrentLoopIndex",
"value": "@variables('myCounter')"
},
"runAfter": {
"Increment_variable": [ "Succeeded" ]
}
},
"Compose": {
"inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
"runAfter": {
"Assign_current_index_to_counter": [
"Succeeded"
]
},
"type": "Compose"
},
"Increment_variable": {
"type": "IncrementVariable",
"inputs": {
"name": "myCounter",
"value": 1
},
"runAfter": {}
}
},
"expression": "@equals(variables('myCounter'), 5)",
"limit": {
"count": 60,
"timeout": "PT1H"
},
"runAfter": {
"Create_current_index_variable": [ "Succeeded" ]
}
}
}
}
J
json
Gibt den Typwert, das Objekt oder ein Array aus Objekten im JSON-Format (JavaScript Object Notation) für eine Zeichenfolge oder XML-Daten zurück.
json('<value>')
json(xml('value'))
Wichtig
Ohne XML-Schema, das die Struktur der Ausgabe definiert, gibt die Funktion möglicherweise Ergebnisse zurück, bei denen die Struktur je nach Eingabe stark vom erwarteten Format abweicht.
Durch dieses Verhalten ist diese Funktion nicht für Szenarien geeignet, in denen die Ausgabe einem klar definierten Vertrag entsprechen muss, beispielsweise in kritischen Geschäftssystemen oder -lösungen.
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Zeichenfolge oder XML | Die Zeichenfolge oder das XML-Objekt, die oder das konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<JSON-result> | Nativer JSON-Typ, natives JSON-Objekt oder natives JSON-Array | Der native JSON-Typwert, das native JSON-Objekt oder ein natives JSON-Objektarray aus der Eingabezeichenfolge oder den XML-Daten. – Wenn Sie XML-Daten mit einem einzelnen untergeordneten Element im Stammelement übergeben, gibt die Funktion ein einzelnes JSON-Objekt für dieses untergeordnete Element zurück. – Wenn Sie XML-Daten mit mehreren untergeordneten Elementen im Stammelement übergeben, gibt die Funktion ein Array zurück, das JSON-Objekte für diese untergeordneten Elemente enthält. – Wenn die Zeichenfolge NULL ist, gibt die Funktion ein leeres Objekt zurück. |
Beispiel 1
Dieses Beispiel konvertiert diese Zeichenfolge in einen JSON-Wert:
json('[1, 2, 3]')
Dies ist das zurückgegebene Ergebnis: [1, 2, 3]
Beispiel 2
Dieses Beispiel konvertiert diese Zeichenfolge in JSON:
json('{"fullName": "Sophia Owen"}')
Dies ist das zurückgegebene Ergebnis:
{
"fullName": "Sophia Owen"
}
Beispiel 3
Dieses Beispiel verwendet die Funktionen json()
und xml()
, um XML-Daten mit einem einzelnen untergeordneten Element im Stammelement in ein JSON-Objekt namens person
für dieses untergeordnete Element zu konvertieren:
json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
Dies ist das zurückgegebene Ergebnis:
{
"?xml": {
"@version": "1.0"
},
"root": {
"person": {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
}
}
}
Beispiel 4
Dieses Beispiel verwendet die Funktionen json()
und xml()
, um XML-Daten mit mehreren untergeordneten Elementen im Stammelement in ein Array namens person
zu konvertieren, das JSON-Objekte für diese untergeordneten Elemente enthält:
json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</name> <occupation>Engineer</occupation> </person> </root>'))
Dies ist das zurückgegebene Ergebnis:
{
"?xml": {
"@version": "1.0"
},
"root": {
"person": [
{
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
},
{
"@id": "2",
"name": "John Doe",
"occupation": "Engineer"
}
]
}
}
Schnittmenge
Gibt eine Sammlung zurück, die nur die gängigen Elemente aus den angegebenen Sammlungen enthält. Damit ein Element im Ergebnis enthalten ist, muss es in allen Sammlungen enthalten sein, die an diese Funktion übergeben werden. Haben mehrere Elemente denselben Namen, enthält das Ergebnis das letzte Element mit diesem Namen.
intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<collection1>, <collection2>, ... | Ja | Array oder Objekt, aber nicht beide | Die Sammlungen, aus denen Sie nur die gemeinsame Elemente wünschen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<common-items> | Array bzw. Objekt | Eine Sammlung, die nur die Elemente enthält, die in jeder der angegebenen Sammlungen enthalten sind. |
Beispiel
In diesem Beispiel wird nach den Elementen gesucht, die in jedem dieser Arrays enthalten sind:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
Es wird ein Array zurückgegeben, das nur diese Elemente enthält: [1, 2]
join
Gibt eine Zeichenfolge zurück, die alle Elemente aus einem Array enthält und in der je zwei Elemente durch ein Trennzeichen getrennt sind.
join([<collection>], '<delimiter>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Array | Das Array, das die Elemente enthält, die verknüpft werden sollen |
<delimiter> | Ja | String | Das Trennzeichen, das zwischen den einzelnen Elementen in der Ergebniszeichenfolge steht. |
Rückgabewert | type | Beschreibung |
---|---|---|
<char1><delimiter><char2><delimiter>... | String | Die resultierende Zeichenfolge, die aus allen Elementen im angegebenen Array erstellt wurde. Hinweis: Die Länge des Ergebnisses darf 104.857.600 Zeichen nicht überschreiten. |
Beispiel
In diesem Beispiel wird eine Zeichenfolge erstellt, die aus allen Elementen in diesem Array und dem angegebenen Zeichen als Trennzeichen besteht:
join(createArray('a', 'b', 'c'), '.')
Dies ist das zurückgegebene Ergebnis: "a.b.c"
L
last
Gibt das letzte Element aus einer Sammlung zurück.
last('<collection>')
last([<collection>])
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge oder Array | Die Sammlung, aus der das letzte Element abgerufen werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<last-collection-item> | Zeichenfolge bzw. Array | Das letzte Element in der Sammlung |
Beispiel
In diesen Beispielen wird jeweils das letzte Element aus diesen Sammlungen abgerufen:
last('abcd')
last(createArray(0, 1, 2, 3))
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
"d"
- Zweites Beispiel:
3
lastIndexOf
Gibt die Anfangsposition oder den Indexwert des letzten Vorkommens einer Teilzeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet, und Indizes beginnen mit der Zahl 0.
lastIndexOf('<text>', '<searchText>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die die Teilzeichenfolge enthält, nach der gesucht werden soll |
<searchText> | Ja | String | Die Teilzeichenfolge, nach der gesucht werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<ending-index-value> | Integer | Die Anfangsposition oder der Indexwert des letzten Vorkommens der angegebenen Teilzeichenfolge. |
Wenn der Zeichenfolgen- oder Teilzeichenfolgenwert leer ist, tritt das folgende Verhalten auf:
Wenn nur der Zeichenfolgenwert leer ist, gibt die Funktion
-1
zurück.Wenn Zeichenfolgen- und Teilzeichenfolgenwerte leer sind, wird
0
zurückgegeben.Wenn nur der Zeichenfolgenwert leer ist, gibt die Funktion die Zeichenfolgenlänge minus 1 zurück.
Beispiele
In diesem Beispiel wird für die Teilzeichenfolge world
nach dem Anfangsindexwert des letzten Vorkommens gesucht, den sie in der Zeichenfolge hello world hello world
hat. Als Ergebnis wird 18
zurückgegeben:
lastIndexOf('hello world hello world', 'world')
In diesem Beispiel fehlt der Teilzeichenfolgenparameter, und der Wert 22
wird zurückgegeben, da der Wert der Eingabezeichenfolge (23
) minus 1 größer als 0 (null) ist.
lastIndexOf('hello world hello world', '')
length
Gibt Anzahl von Elementen einer Sammlung zurück
length('<collection>')
length([<collection>])
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge oder Array | Die Sammlung mit den Elementen, die gezählt werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<length-or-count> | Integer | Die Anzahl von Elementen in der Sammlung |
Beispiel
In diesen Beispielen wird die Anzahl von Elementen in diesen Sammlungen gezählt:
length('abcd')
length(createArray(0, 1, 2, 3))
Dies ist das zurückgegebene Ergebnis: 4
less
Überprüft, ob der erste Wert kleiner als der zweite ist. Gibt „true“ zurück, wenn der erste Wert kleiner ist, gibt andernfalls „false“ zurück.
less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Integer, Float oder Zeichenfolge | Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner ist als der zweite Wert |
<compareTo> | Ja | Integer, Float bzw. Zeichenfolge | Das Vergleichselement |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn der erste Wert kleiner ist als der zweite Wert. Gibt „false“ zurück, wenn der erste Wert größer gleich dem zweiten Wert ist. |
Beispiel
In diesen Beispiel wird überprüft, ob der erste Wert kleiner ist als der zweite Wert.
less(5, 10)
less('banana', 'apple')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
true
- Zweites Beispiel:
false
lessOrEquals
Überprüft, ob der erste Wert kleiner als oder gleich dem zweiten ist. Gibt „true“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist, gibt andernfalls „false“ zurück.
lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Integer, Float oder Zeichenfolge | Der Wert (erster Wert), für den überprüft werden soll, ob er kleiner gleich dem zweiten Wert ist. |
<compareTo> | Ja | Integer, Float bzw. Zeichenfolge | Das Vergleichselement |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn der erste Wert kleiner gleich dem zweiten Wert ist. Gibt „false“ zurück, wenn der erste Wert größer ist als der zweite Wert. |
Beispiel
In diesen Beispiel wird überprüft, ob der erste Wert kleiner gleich dem zweiten Wert ist.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
true
- Zweites Beispiel:
false
listCallbackUrl
Gibt die „Rückruf-URL“ zurück, die einen Trigger oder eine Aktion aufruft. Diese Funktion funktioniert nur mit Triggern und Aktionen für die Connectortypen HttpWebhook und ApiConnectionWebhook, nicht für die Typen Manual, Recurrence, HTTP und APIConnection.
listCallbackUrl()
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<callback-URL> | String | Die Rückruf-URL für einen Trigger oder eine Aktion |
Beispiel
Dieses Beispiel zeigt einer Beispielrückruf-URL, die von dieser Funktion zurückgegeben werden könnte:
"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"
M
max
Gibt den größten Wert aus einer Liste oder einem Array mit Zahlen zurück, mit dem Wert an beiden Enden inklusive.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<number1>, <number2>, ... | Ja | Integer, Float oder beide | Die Menge der Zahlen, aus denen Sie den größten Wert abrufen möchten |
[<number1>, <number2>, ...] | Ja | Array: Integer, Float oder beide | Das Array mit den Zahlen, aus denen Sie den größten Wert abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<max-value> | Integer oder Float | Der größte Wert in dem angegebenen Array oder in der angegebenen Menge von Zahlen |
Beispiel
In diesen Beispielen wird der größte Wert aus der Menge von Zahlen und aus dem Array abgerufen:
max(1, 2, 3)
max(createArray(1, 2, 3))
Dies ist das zurückgegebene Ergebnis: 3
Min
Gibt den niedrigsten Wert aus einer Reihe von Zahlen oder einem Array zurück.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<number1>, <number2>, ... | Ja | Integer, Float oder beide | Die Menge der Zahlen, aus denen Sie den kleinsten Wert abrufen möchten |
[<number1>, <number2>, ...] | Ja | Array: Integer, Float oder beide | Das Array mit den Zahlen, aus denen Sie den kleinsten Wert abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<min-value> | Integer oder Float | Der kleinste Wert in der angegebenen Menge von Zahlen oder in dem angegebenen Array |
Beispiel
In diesen Beispielen wird der kleinste Wert aus der Menge von Zahlen und aus dem Array abgerufen:
min(1, 2, 3)
min(createArray(1, 2, 3))
Dies ist das zurückgegebene Ergebnis: 1
mod
Gibt den Restwert aus der Division zweier Zahlen zurück. Informationen zum Abrufen des Ganzzahlergebnisses finden Sie unter div().
mod(<dividend>, <divisor>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<dividend> | Ja | Integer oder Float | Die Zahl, die durch den Divisor dividiert werden soll. |
<divisor> | Ja | Integer oder Float | Die Zahl, durch die der Dividend geteilt wird. Darf nicht null sein. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<modulo-result> | Integer oder Float | Der Rest aus der Division der ersten Zahl durch die zweite Zahl |
Beispiel 1
In diesem Beispiel wird die erste Zahl durch die zweite Zahl dividiert:
mod(3, 2)
Dies ist das zurückgegebene Ergebnis: 1
Beispiel 2
Dieses Beispiel zeigt, dass das Ergebnis dem Vorzeichen des Dividenden entspricht, wenn ein oder beide Werte negativ sind:
mod(-5, 2)
mod(4, -3)
Im Beispiel werden die folgenden Ergebnisse zurückgegeben:
- Erstes Beispiel:
-1
- Zweites Beispiel:
1
mul
Gibt das Produkt aus der Multiplikation zweier Zahlen zurück.
mul(<multiplicand1>, <multiplicand2>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<multiplicand1> | Ja | Integer oder Float | Die Zahl, mit der multiplicand2 multipliziert werden soll. |
<multiplicand2> | Ja | Integer oder Float | Die Zahl, mit der multiplicand1 multipliziert werden soll. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<product-result> | Integer oder Float | Das Produkt aus der Multiplikation der ersten Zahl mit der zweiten Zahl |
Beispiel
In diesen Beispielen wird die erste Zahl mit der zweiten Zahl multipliziert:
mul(1, 2)
mul(1.5, 2)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
2
- Zweites Beispiel:
3
multipartBody
Gibt den Textteil für einen bestimmten Teil einer Aktionsausgabe zurück, die mehrere Teile hat.
multipartBody('<actionName>', <index>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Der Name der Aktion, für die es Ausgabe mit mehreren Teilen gibt |
<index> | Ja | Integer | Der Indexwert des von Ihnen gewünschten Teils |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<body> | String | Der Textteil für den angegebenen Teil |
N
not
Überprüft, ob ein Ausdruck gleich „false“ ist. Gibt „true“ zurück, wenn der Ausdruck gleich „false“ ist, oder gibt „false“ zurück, wenn er gleich „true“ ist.
not(<expression>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<expression> | Ja | Boolean | Der zu überprüfende Ausdruck |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn der Ausdruck gleich „false“ ist. Gibt „false“ zurück, wenn der Ausdruck gleich „true“ ist. |
Beispiel 1
In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke gleich „false“ sind:
not(false)
not(true)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Der Ausdruck ist gleich „false“, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Der Ausdruck ist gleich „true“, weshalb die Funktion
false
zurückgibt.
Beispiel 2
In diesen Beispielen wird überprüft, ob die angegebenen Ausdrücke gleich „false“ sind:
not(equals(1, 2))
not(equals(1, 1))
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Der Ausdruck ist gleich „false“, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Der Ausdruck ist gleich „true“, weshalb die Funktion
false
zurückgibt.
nthIndexOf
Gibt die Anfangsposition oder den Indexwert zurück, an der bzw. dem das n-te Vorkommen einer Teilzeichenfolge in einer Zeichenfolge erscheint.
nthIndexOf('<text>', '<searchText>', <occurrence>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die die zu suchende Teilzeichenfolge enthält |
<searchText> | Ja | String | Die Teilzeichenfolge, nach der gesucht werden soll |
<occurrence> | Ja | Integer | Eine Zahl, die das n-te Vorkommen der zu suchenden Teilzeichenfolge angibt. Wenn occurrence negativ ist, beginnt die Suche am Ende. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<index-value> | Integer | Die Anfangsposition oder der Indexwert für das n-te Vorkommen der angegebenen Teilzeichenfolge. Wenn die Teilzeichenfolge nicht gefunden wird oder weniger als n Vorkommen der Teilzeichenfolge vorhanden sind, wird -1 zurückgegeben. |
Beispiele
nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.
O
oder
Überprüft, ob mindestens ein Ausdruck gleich „true“ ist. Gibt „true“ zurück, wenn mindestens ein Ausdruck gleich „true“ ist, oder gibt „false“ zurück, wenn alle Ausdrücke gleich „false“ ist.
or(<expression1>, <expression2>, ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<expression1>, <expression2>, ... | Ja | Boolean | Die Ausdrücke, die überprüft werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn mindestens ein Ausdruck gleich „true“ ist. Gibt „false“ zurück, wenn alle Ausdrücke gleich „false“ sind. |
Beispiel 1
In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck gleich „true“ ist:
or(true, false)
or(false, false)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Beide Ausdrücke sind gleich „false“, weshalb die Funktion
false
zurückgibt.
Beispiel 2
In diesen Beispielen wird überprüft, ob mindestens ein Ausdruck gleich „true“ ist:
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel: Mindestens ein Ausdruck ist gleich „true“, weshalb die Funktion
true
zurückgibt. - Zweites Beispiel: Beide Ausdrücke sind gleich „false“, weshalb die Funktion
false
zurückgibt.
outputs
Gibt die Ausgabe einer Aktion zur Laufzeit zurück.
outputs('<actionName>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<actionName> | Ja | String | Der Name der Aktion, deren Ausgabe Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<output> | String | Die Ausgabe von der angegebenen Aktion |
Beispiel
In diesem Beispiel wird die Ausgabe der X-Aktion Get user
abgerufen:
outputs('Get_user')
Dies ist das zurückgegebene Ergebnis:
{
"statusCode": 200,
"headers": {
"Pragma": "no-cache",
"Vary": "Accept-Encoding",
"x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
"X-Content-Type-Options": "nosniff",
"Timing-Allow-Origin": "*",
"Cache-Control": "no-cache",
"Date": "Mon, 09 Apr 2018 18:47:12 GMT",
"Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Type": "application/json; charset=utf-8",
"Expires": "-1",
"Content-Length": "339"
},
"body": {
"FullName": "Contoso Corporation",
"Location": "Generic Town, USA",
"Id": 283541717,
"UserName": "ContosoInc",
"FollowersCount": 172,
"Description": "Leading the way in transforming the digital workplace.",
"StatusesCount": 93,
"FriendsCount": 126,
"FavouritesCount": 46,
"ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}
}
P
parameters
Gibt den Wert für einen Parameter zurück, der in Ihrer Workflowdefinition beschrieben wird.
parameters('<parameterName>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<parameterName> | Ja | String | Der Name des Parameters, dessen Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<parameter-value> | Any | Der Wert des angegebenen Parameters |
Beispiel
Angenommen, Sie haben diesen JSON-Wert:
{
"fullName": "Sophia Owen"
}
In diesem Beispiel wird der Wert des angegebenen Parameters abgerufen:
parameters('fullName')
Dies ist das zurückgegebene Ergebnis: "Sophia Owen"
parseDateTime
Gibt den Zeitstempel aus einer Zeichenfolge zurück, die einen Zeitstempel enthält.
parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<locale> | Nein | String | Das zu verwendende Gebietsschema. Ohne Angabe ist en-us das Standardgebietsschema. Wenn locale kein gültiger Wert ist, wird ein Fehler generiert. |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Ist das Format nicht angegeben, versuchen Sie, Analysen mit mehreren Formaten durchzuführen, die mit dem angegebenen Gebietsschema kompatibel sind. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | Beschreibung |
---|---|---|
<parsed-timestamp> | String | Der analysierte Zeitstempel im Format „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das ISO 8601 entspricht und in dem Zeitzoneninformationen erhalten bleiben |
Beispiele
parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.
R
rand
Gibt eine zufällige Ganzzahl aus einem angegebenen Bereich zurück, wobei nur der Anfangswert inklusive ist.
rand(<minValue>, <maxValue>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<minValue> | Ja | Integer | Die kleinste ganze Zahl im Bereich |
<maxValue> | Ja | Integer | Die ganze Zahl, die im Bereich auf die größte Zahl folgt, die die Funktion zurückgeben kann |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<random-result> | Integer | Die zufällige ganze Zahl, die aus dem angegebenen Bereich zurückgegeben wird |
Beispiel
In diesem Beispiel wird eine Zufallsganzzahl aus dem angegebenen Bereich abgerufen, wobei der größte Wert ausgeschlossen ist:
rand(1, 5)
Eine dieser Zahlen wird als Ergebnis zurückgegeben: 1
, 2
, 3
oder 4
range
Gibt ein Array mit ganzen Zahlen zurück, das mit einer angegebenen ganzen Zahl beginnt.
range(<startIndex>, <count>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<startIndex> | Ja | Integer | Ein ganzzahliger Wert, der das erste Element im Array ist |
<count> | Ja | Integer | Die Anzahl von ganzen Zahlen im Array. Der count -Parameter muss eine positive ganze Zahl sein, die 100.000 nicht überschreitet. Hinweis: Die Summe der Werte startIndex und count darf 2.147.483.647 nicht überschreiten. |
Rückgabewert | type | Beschreibung |
---|---|---|
[<range-result>] | Array | Das Array mit ganzen Zahlen ab dem angegebenen Index |
Beispiel
In diesem Beispiel wird ein Array aus ganzen Zahlen erstellt, das mit angegebenen Index beginnt und die angegebene Anzahl von ganzen Zahlen hat:
range(1, 4)
Dies ist das zurückgegebene Ergebnis: [1, 2, 3, 4]
removeProperty
Entfernt eine Eigenschaft aus einem Objekt und gibt das aktualisierte Objekt zurück. Ist die Eigenschaft, die Sie entfernen möchten, nicht vorhanden, gibt die Funktion das ursprüngliche Objekt zurück.
removeProperty(<object>, '<property>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, aus dem Sie eine Eigenschaft entfernen möchten |
<property> | Ja | String | Der Name der zu Eigenschaft, die entfernt werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-object> | Object | Das aktualisierte JSON-Objekt ohne die angegebene Eigenschaft |
Verwenden Sie die folgende Syntax, um eine untergeordnete Eigenschaft aus einer vorhandenen Eigenschaft zu entfernen:
removeProperty(<object>['<parent-property>'], '<child-property>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, dessen Eigenschaft Sie entfernen möchten |
<parent-property> | Ja | String | Der Name der übergeordneten Eigenschaft mit der untergeordneten Eigenschaft, die Sie entfernen möchten |
<child-property> | Ja | String | Der Name der untergeordneten Eigenschaft, die entfernt werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-object> | Object | Das aktualisierte JSON-Objekt, dessen untergeordnete Eigenschaft entfernt wurde |
Beispiel 1
In diesem Beispiel wird die middleName
-Eigenschaft aus einem JSON-Objekt entfernt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird, und es wird das aktualisierte Objekt zurückgegeben:
removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"surName": "Owen"
}
Beispiel 2
In diesem Beispiel wird die untergeordnete middleName
-Eigenschaft aus der übergeordneten customerName
-Eigenschaft in einem JSON-Objekt entfernt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird, und es wird das aktualisierte Objekt zurückgegeben:
removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophia",
"surName": "Owen"
}
}
replace
Ersetzt eine Teilzeichenfolge durch die angegebene Zeichenfolge und gibt die resultierende Zeichenfolge zurück. Für diese Funktion wird die Groß-/Kleinschreibung beachtet.
replace('<text>', '<oldText>', '<newText>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die die Teilzeichenfolge enthält, die ersetzt werden soll |
<oldText> | Ja | String | Die Teilzeichenfolge, die ersetzt werden soll |
<newText> | Ja | String | Die Ersatzzeichenfolge |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-text> | String | Die aktualisierte Zeichenfolge, nachdem die Teilzeichenfolge ersetzt wurde. Wenn die Teilzeichenfolge nicht gefunden wird, wird die ursprüngliche Zeichenfolge zurückgegeben. |
Beispiel
In diesem Beispiel wird in „the old string“ nach der Teilzeichenfolge „old“ gesucht und „old“ durch „new“ ersetzt:
replace('the old string', 'old', 'new')
Dies ist das zurückgegebene Ergebnis: "the new string"
result
Gibt die Ergebnisse aus den Aktionen der obersten Ebene in der angegebenen bereichsbezogenen Aktion zurück, z. B. einer For_each
-, Until
- oder Scope
-Aktion. Die result()
-Funktion nimmt einen einzigen Parameter entgegen, nämlich den Namen des Bereichs, und gibt ein Array zurück, das Informationen aus den Aktionen der obersten Ebene in diesem Bereich enthält. Diese Aktionsobjekte enthalten die gleichen Attribute, die auch von der Funktion actions()
zurückgegeben werden, z. B. Start- und Endzeit der Aktion, Status, Eingaben, Korrelations-IDs und Ausgaben.
Hinweis
Diese Funktion gibt nur Informationen aus den Aktionen der obersten Ebene in der bereichsbezogenen Aktion und nicht aus tiefer geschachtelten Aktionen wie Schalter- oder Bedingungsaktionen zurück.
Beispielsweise können Sie mit dieser Funktion die Ergebnisse von fehlerhaften Aktionen abrufen, sodass Sie Ausnahmen diagnostizieren und behandeln können. Weitere Informationen finden Sie unter Abrufen von Kontext und Ergebnissen für Fehler.
result('<scopedActionName>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<scopedActionName> | Ja | String | Der Name der bereichsbezogenen Aktion, in der die Eingaben und Ausgaben der Aktionen der obersten Ebene in diesem Bereich verwendet werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<array-object> | Arrayobjekt | Ein Array, das Arrays mit Eingaben und Ausgaben aus jeder Aktion der obersten Ebene enthält, die im angegebenen Bereich enthalten ist |
Beispiel
In diesem Beispiel wird die result()
-Funktion in der Compose
-Aktion verwendet, um die Eingaben und Ausgaben jeder Iteration einer HTTP-Aktion zurückgegeben, die sich in einer For_each
-Schleife befindet:
{
"actions": {
"Compose": {
"inputs": "@result('For_each')",
"runAfter": {
"For_each": [
"Succeeded"
]
},
"type": "compose"
},
"For_each": {
"actions": {
"HTTP": {
"inputs": {
"method": "GET",
"uri": "https://httpstat.us/200"
},
"runAfter": {},
"type": "Http"
}
},
"foreach": "@triggerBody()",
"runAfter": {},
"type": "Foreach"
}
}
}
Das im Beispiel zurückgegebene Array könnte wie folgt aussehen, wobei das äußere outputs
-Objekt die Eingaben und Ausgaben von jeder Iteration der Aktionen enthält, die in der For_each
-Aktion enthalten sind.
[
{
"name": "HTTP",
"outputs": [
{
"name": "HTTP",
"inputs": {
"uri": "https://httpstat.us/200",
"method": "GET"
},
"outputs": {
"statusCode": 200,
"headers": {
"X-AspNetMvc-Version": "5.1",
"Access-Control-Allow-Origin": "*",
"Cache-Control": "private",
"Date": "Tue, 20 Aug 2019 22:15:37 GMT",
"Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
"Server": "Microsoft-IIS/10.0",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Length": "0"
},
"startTime": "2019-08-20T22:15:37.6919631Z",
"endTime": "2019-08-20T22:15:37.95762Z",
"trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
"clientTrackingId": "085863526764.....",
"code": "OK",
"status": "Succeeded"
}
},
{
"name": "HTTP",
"inputs": {
"uri": "https://httpstat.us/200",
"method": "GET"
},
"outputs": {
"statusCode": 200,
"headers": {
"X-AspNetMvc-Version": "5.1",
"Access-Control-Allow-Origin": "*",
"Cache-Control": "private",
"Date": "Tue, 20 Aug 2019 22:15:37 GMT",
"Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
"Server": "Microsoft-IIS/10.0",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Length": "0"
},
"startTime": "2019-08-20T22:15:37.6919631Z",
"endTime": "2019-08-20T22:15:37.95762Z",
"trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
"clientTrackingId": "085863526764.....",
"code": "OK",
"status": "Succeeded"
}
}
]
}
]
reverse
Kehrt die Reihenfolge der Elemente in einer Sammlung um. Wenn Sie diese Funktion mit sort() verwenden, können Sie eine Sammlung in absteigender Reihenfolge sortieren.
reverse([<collection>])
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Array | Die umzukehrende Sammlung |
Rückgabewert | type | Beschreibung |
---|---|---|
[<updated-collection>] | Array | Die umgekehrte Sammlung |
Beispiel
In diesem Beispiel wird ein Array mit ganzen Zahlen umgekehrt:
reverse(createArray(0, 1, 2, 3))
Es gibt dieses Array zurück: [3,2,1,0]
E
setProperty
Legt den Wert für eine Eigenschaft eines JSON-Objekts fest und gibt das aktualisierte Objekt zurück. Wenn die Eigenschaft, die Sie festlegen möchten, nicht vorhanden ist, wird die Eigenschaft dem Objekt hinzugefügt. Verwenden Sie die addProperty()-Funktion, um eine neue Eigenschaft hinzuzufügen.
setProperty(<object>, '<property>', <value>)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, dessen Eigenschaft Sie festlegen möchten |
<property> | Ja | String | Der Name der vorhandenen oder neuen Eigenschaft, die festgelegt werden soll |
<value> | Ja | Any | Der Wert, auf den die angegebene Eigenschaft festgelegt werden soll |
Wenn Sie die untergeordnete Eigenschaft in einem untergeordneten Objekt festlegen möchten, verwenden Sie stattdessen einen geschachtelten setProperty()
-Aufruf. Andernfalls gibt die Funktion nur das untergeordnete Objekt als Ausgabe zurück.
setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<object> | Ja | Object | Das JSON-Objekt, dessen Eigenschaft Sie festlegen möchten |
<parent-property> | Ja | String | Der Name der übergeordneten Eigenschaft mit der untergeordneten Eigenschaft, die Sie festlegen möchten |
<child-property> | Ja | String | Der Name für die untergeordnete Eigenschaft, die festgelegt werden soll |
<value> | Ja | Any | Der Wert, auf den die angegebene Eigenschaft festgelegt werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-object> | Object | Das aktualisierte JSON-Objekt, dessen Eigenschaft Sie festlegen |
Beispiel 1
In diesem Beispiel wird die surName
-Eigenschaft in einem JSON-Objekt festgelegt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird. Die Funktion weist der Eigenschaft den angegebenen Wert zu und gibt das aktualisierte Objekt zurück:
setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"surName": "Owen"
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"firstName": "Sophia",
"surName": "Hartnett"
}
Beispiel 2
In diesem Beispiel wird die untergeordnete surName
-Eigenschaft der übergeordneten customerName
-Eigenschaft in einem JSON-Objekt festgelegt, das mit der JSON()-Funktion aus einer Zeichenfolge in JSON konvertiert wird. Die Funktion weist der Eigenschaft den angegebenen Wert zu und gibt das aktualisierte Objekt zurück:
setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))
Das aktuelle JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophie",
"surName": "Owen"
}
}
Das aktualisierte JSON-Objekt sieht wie folgt aus:
{
"customerName": {
"firstName": "Sophie",
"surName": "Hartnett"
}
}
skip
Entfernt Elemente vom Anfang einer Sammlung und gibt alle anderen Elemente zurück.
skip([<collection>], <count>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Array | Die Sammlung, aus der Sie Elemente entfernen möchten |
<count> | Ja | Integer | Eine positive ganze Zahl für die Anzahl von Elementen, die am Anfang entfernt werden sollen |
Rückgabewert | type | Beschreibung |
---|---|---|
[<updated-collection>] | Array | Die aktualisierte Auflistung, nachdem die angegebenen Elemente entfernt wurden |
Beispiel
In diesem Beispiel wird ein Element, die Zahl 0, am Anfang des angegebenen Arrays entfernt:
skip(createArray(0, 1, 2, 3), 1)
Es wird dieses Array mit den restlichen Elementen zurückgegeben: [1,2,3]
Slice
Gibt durch die Angabe der Anfangs- oder Endposition bzw. eines entsprechenden Werts eine Teilzeichenfolge zurück. Siehe auch substring().
slice('<text>', <startIndex>, <endIndex>?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die die zu suchende Teilzeichenfolge enthält |
<startIndex> | Ja | Ganzzahl | Die nullbasierte Anfangsposition oder der Wert, an dem die Suche nach der Teilzeichenfolge beginnen soll - Wenn startIndex größer als die Zeichenfolgenlänge ist, wird eine leere Zeichenfolge zurückgegeben. - Wenn startIndex negativ ist, beginnen Sie mit der Suche am Indexwert, der die Summe der Zeichenfolgenlänge und startIndex darstellt |
<endIndex> | Nein | Integer | Die nullbasierte Endposition oder der Wert für das Ende der Suche nach der Teilzeichenfolge. Das Zeichen, das sich am Endindexwert befindet, ist nicht in der Suche enthalten. - Wenn endIndex nicht angegeben oder größer als die Zeichenfolgenlänge ist, wird bis zum Ende der Zeichenfolge gesucht. - Wenn endIndex negativ ist, wird die Suche am Indexwert beendet, der die Summe der Zeichenfolgenlänge und endIndex darstellt. |
Rückgabewert | type | Beschreibung |
---|---|---|
<slice-result> | String | Eine neue Zeichenfolge, die die gefundene Teilzeichenfolge enthält |
Beispiele
slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.
sort
Sortiert die Elemente in einer Sammlung. Sie können die Sammlungsobjekte mithilfe eines beliebigen Schlüssels sortieren, der einen einfachen Typ enthält.
sort([<collection>], <sortBy>?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Array | Die Sammlung mit den zu sortierenden Elementen |
<sortBy> | Nein | String | Der zum Sortieren der Sammlungsobjekte zu verwendende Schlüssel |
Rückgabewert | type | Beschreibung |
---|---|---|
[<updated-collection>] | Array | Die sortierte Sammlung |
Beispiel 1
In diesem Beispiel wird ein Array mit ganzen Zahlen sortiert:
sort(createArray(2, 1, 0, 3))
Es gibt dieses Array zurück: [0,1,2,3]
Beispiel 2
In diesem Beispiel wird ein Array von Objekten nach einem Schlüssel sortiert:
sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')
Es gibt dieses Array zurück: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]
split
Gibt ein Array mit Teilzeichenfolgen, die durch Trennzeichen getrennt sind, basierend auf einem angegebenen Trennzeichen in der ursprünglichen Zeichenfolge zurück.
split('<text>', '<delimiter>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die auf Grundlage des angegebenen Trennzeichens in der ursprünglichen Zeichenfolge in Teilzeichenfolgen unterteilt wird |
<delimiter> | Ja | String | Das Zeichen in der ursprünglichen Zeichenfolge, das als Trennzeichen verwendet wird |
Rückgabewert | type | Beschreibung |
---|---|---|
[<substring1>,<substring2>,...] | Array | Ein Array mit Teilzeichenfolgen aus der ursprünglichen Zeichenfolge, das durch Trennzeichen getrennt ist |
Beispiel 1
Dieses Beispiel erstellt ein Array mit Teilzeichenfolgen aus der angegebenen Zeichenfolge basierend auf dem angegebenen Zeichen als Trennzeichen:
split('a_b_c', '_')
Dieses Array wird als Ergebnis zurückgegeben: ["a","b","c"]
Beispiel 2
In diesem Beispiel wird ein Array mit einem einzelnen Element erstellt, wenn kein Trennzeichen in der Zeichenfolge vorhanden ist:
split('a_b_c', ' ')
Dieses Array wird als Ergebnis zurückgegeben: ["a_b_c"]
startOfDay
Gibt den Beginn des Tages für einen Zeitstempel zurück.
startOfDay('<timestamp>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der angegebene Zeitstempel, der jedoch bei null Uhr für den Tag beginnt |
Beispiel
In diesem Beispiel wird der Beginn des Tags für diesen Zeitstempel ermittelt:
startOfDay('2018-03-15T13:30:30Z')
Dies ist das zurückgegebene Ergebnis: "2018-03-15T00:00:00.0000000Z"
startOfHour
Gibt den Beginn der Stunde für einen Zeitstempel zurück.
startOfHour('<timestamp>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der angegebene Zeitstempel, der jedoch bei null Minuten für die Stunde beginnt |
Beispiel
In diesem Beispiel wird der Beginn der Stunde für diesen Zeitstempel ermittelt:
startOfHour('2018-03-15T13:30:30Z')
Dies ist das zurückgegebene Ergebnis: "2018-03-15T13:00:00.0000000Z"
startOfMonth
Gibt den Beginn des Monats für einen Zeitstempel zurück.
startOfMonth('<timestamp>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der angegebene Zeitstempel, der jedoch am ersten Tag des Monats um null Uhr beginnt |
Beispiel 1
In diesem Beispiel wird der Beginn des Monats für diesen Zeitstempel zurückgegeben:
startOfMonth('2018-03-15T13:30:30Z')
Dies ist das zurückgegebene Ergebnis: "2018-03-01T00:00:00.0000000Z"
Beispiel 2
In diesem Beispiel wird der Beginn des Monats für diesen Zeitstempel im angegebenen Format zurückgegeben:
startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')
Dies ist das zurückgegebene Ergebnis: "2018-03-01"
startsWith
Überprüft, ob eine Zeichenfolge mit einer bestimmten Teilzeichenfolge beginnt. Gibt „true“ zurück, wenn die Teilzeichenfolge gefunden wurde, gibt andernfalls „false“ zurück. Für diese Funktion wird die Groß-/Kleinschreibung nicht beachtet.
startsWith('<text>', '<searchText>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die überprüft werden soll |
<searchText> | Ja | String | Die beginnende Zeichenfolge, nach der gesucht werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
true oder false | Boolean | Gibt „true“ zurück, wenn die beginnende Teilzeichenfolge gefunden wurde. Gibt „false“ zurück, wenn sie nicht gefunden wurde. |
Beispiel 1
In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Teilzeichenfolge „world“ beginnt:
startsWith('hello world', 'hello')
Dies ist das zurückgegebene Ergebnis: true
Beispiel 2
In diesem Beispiel wird überprüft, ob die Zeichenfolge „hello world“ mit der Teilzeichenfolge „greetings“ beginnt:
startsWith('hello world', 'greetings')
Dies ist das zurückgegebene Ergebnis: false
Zeichenfolge
Gibt die Zeichenfolgenversion für einen Wert zurück.
string(<value>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | Any | Der zu konvertierende Wert. Wenn dieser Wert NULL ist oder NULL ergibt, wird der Wert in einen leeren Zeichenfolgenwert ("" ) konvertiert. Wenn Sie z. B. einer nicht vorhandenen Eigenschaft, auf die Sie mit dem ? -Operator zugreifen können, eine Zeichenfolgenvariable zuweisen, wird der NULL-Wert in eine leere Zeichenfolge konvertiert. Das Vergleichen eines NULL-Werts ist jedoch nicht mit dem Vergleich einer leeren Zeichenfolge identisch. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<string-value> | String | Die Zeichenfolgenversion des angegebenen Werts. Wenn der value-Parameter NULL ist oder NULL ergibt, wird dieser Wert als leerer Zeichenfolgenwert ("" ) zurückgegeben. |
Beispiel 1
In diesem Beispiel wird die Zeichenfolgenversion dieser Zahl erstellt:
string(10)
Dies ist das zurückgegebene Ergebnis: "10"
Beispiel 2
In diesem Beispiel wird eine Zeichenfolge für das angegebene JSON-Objekt erstellt, und der umgekehrte Schrägstrich (\) wird als Escapezeichen für die doppelten Anführungszeichen (") verwendet.
string( { "name": "Sophie Owen" } )
Dies ist das zurückgegebene Ergebnis: "{ \\"name\\": \\"Sophie Owen\\" }"
sub
Gibt das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl zurück.
sub(<minuend>, <subtrahend>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<minuend> | Ja | Integer oder Float | Die Zahl, von der subtrahend subtrahiert werden soll |
<subtrahend> | Ja | Integer oder Float | Die Zahl, die von minuend subtrahiert werden soll |
Rückgabewert | type | Beschreibung des Dataflows |
---|---|---|
<result> | Integer oder Float | Das Ergebnis aus der Subtraktion der zweiten Zahl von der ersten Zahl |
Beispiel
In diesem Beispiel wird die zweite Zahl von der ersten Zahl subtrahiert:
sub(10.3, .3)
Dies ist das zurückgegebene Ergebnis: 10
substring
Gibt Zeichen aus einer Zeichenfolge zurück, beginnend mit dem angegebenen Indexwert (Position). Indexwerte beginnen bei 0. Siehe auch slice().
substring('<text>', <startIndex>, <length>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, aus der die Zeichen zurückgegeben werden sollen |
<startIndex> | Ja | Integer | Eine positive Zahl gleich oder größer als 0, die Sie als Ausgangswert oder Indexwert verwenden können. |
<length> | Nein | Integer | Eine positive Anzahl von Zeichen, die in der Teilzeichenfolge enthalten sein sollen |
Hinweis
Stellen Sie sicher, dass die Summe aus der Addition der Parameterwerte von startIndex und length kleiner als die Länge der Zeichenfolge ist, die Sie für den Parameter text angeben. Andernfalls erhalten Sie einen Fehler, im Gegensatz zu ähnlichen Funktionen in anderen Sprachen, bei denen das Ergebnis die Teilzeichenfolge ab dem startIndex bis zum Ende der Zeichenfolge ist. Der length-Parameter ist optional, und wenn er nicht angegeben wird, nimmt die substring() -Funktion alle Zeichen ab startIndex bis zum Ende der Zeichenfolge entgegen.
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<substring-result> | String | Eine Teilzeichenfolge, die die angegebene Anzahl von Zeichen enthält und in der Quellzeichenfolge an der angegebenen Indexposition beginnt |
Beispiel
In diesem Beispiel wird aus der angegebenen Zeichenfolge ab dem Indexwert 6 eine Teilzeichenfolge mit fünf Zeichen erstellt:
substring('hello world', 6, 5)
Dies ist das zurückgegebene Ergebnis: "world"
subtractFromTime
Subtrahiert eine Anzahl von Zeiteinheiten von einem Zeitstempel. Siehe auch getPastTime.
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge, die den Zeitstempel enthält |
<interval> | Ja | Integer | Die Anzahl der angegebenen Zeiteinheiten, die subtrahiert werden sollen |
<timeUnit> | Ja | String | Die mit interval zu verwendende Zeiteinheit: Second, Minute, Hour, Day, Week, Month, Year |
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updated-timestamp> | String | Der Zeitstempel abzüglich der angegebenen Anzahl von Zeiteinheiten |
Beispiel 1
In diesem Beispiel wird ein Tag von diesem Zeitstempel subtrahiert:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')
Dies ist das zurückgegebene Ergebnis: "2018-01-01T00:00:00.0000000Z"
Beispiel 2
In diesem Beispiel wird ein Tag von diesem Zeitstempel subtrahiert:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')
Dies ist das zurückgegebene Ergebnis mit dem optionalen „D“-Format: "Monday, January, 1, 2018"
T
take
Gibt Elemente vom Anfang einer Sammlung zurück.
take('<collection>', <count>)
take([<collection>], <count>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<collection> | Ja | Zeichenfolge oder Array | Die Sammlung, aus der Sie Elemente abrufen möchten |
<count> | Ja | Integer | Eine positive ganze Zahl für die Anzahl von Elementen, die ab dem Anfang abgerufen werden sollen |
Rückgabewert | type | Beschreibung |
---|---|---|
<subset> oder [<subset>] | Zeichenfolge bzw. Array | Eine Zeichenfolge oder ein Array, die oder das die angegebene Anzahl von Elementen ab dem Anfang der ursprünglichen Sammlung enthält |
Beispiel
In diesen Beispielen wird die angegebene Anzahl von Elementen ab dem Anfang dieser Sammlungen abgerufen:
take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)
Dies sind die zurückgegebenen Ergebnisse:
- Erstes Beispiel:
"abc"
- Zweites Beispiel:
[0, 1, 2]
ticks
Gibt die Anzahl der Ticks zurück, bei denen es sich um 100-Nanosekunden-Intervalle handelt, seit dem 1. Januar 0001 12:00:00 Mitternacht (oder DateTime.Ticks in C# ) bis zum angegebenen Zeitstempel. Weitere Informationen finden Sie in diesem Thema: DateTime.Ticks-Eigenschaft (System).
ticks('<timestamp>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<timestamp> | Ja | String | Die Zeichenfolge für einen Zeitstempel |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<ticks-number> | Integer | Die Anzahl von Ticks seit dem angegebenen Zeitstempel |
toLower
Gibt eine Zeichenfolge in Kleinbuchstaben zurück. Gibt es für ein Zeichen in der Zeichenfolge keine Kleinschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.
toLower('<text>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die in Kleinbuchstaben zurückgegeben werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<lowercase-text> | String | Die ursprüngliche Zeichenfolge in Kleinbuchstaben |
Beispiel
In diesem Beispiel wird diese Zeichenfolge in Kleinbuchstaben konvertiert:
toLower('Hello World')
Dies ist das zurückgegebene Ergebnis: "hello world"
toUpper
Gibt eine Zeichenfolge in Großbuchstaben zurück. Gibt es für ein Zeichen in der Zeichenfolge keine Großschreibungsversion, verbleibt dieses Zeichen unverändert in der zurückgegebenen Zeichenfolge.
toUpper('<text>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, die in Großbuchstaben zurückgegeben werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<uppercase-text> | String | Die ursprüngliche Zeichenfolge in Großbuchstaben |
Beispiel
In diesem Beispiel wird diese Zeichenfolge in Großbuchstaben konvertiert:
toUpper('Hello World')
Dies ist das zurückgegebene Ergebnis: "HELLO WORLD"
Trigger (trigger)
Gibt die Ausgabe eines Triggers zur Laufzeit oder Werte aus anderen JSON-Name/Wert-Paaren zurück, die Sie einem Ausdruck zuweisen können.
Wird diese Funktion in Eingaben eines Triggers verwendet, gibt sie die Ausgabe der vorherigen Ausführung zurück.
Wird diese Funktion in der Bedingung eines Triggers verwendet, gibt sie die Ausgabe der aktuellen Ausführung zurück.
Standardmäßig verweist die Funktion auf das gesamte Triggerobjekt, Sie können aber optional eine Eigenschaft angeben, deren Wert Sie abrufen möchten. Außerdem gibt es für diese Funktion Kurzformversionen. Informationen hierzu finden Sie unter triggerOutputs() und triggerBody().
trigger()
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<trigger-output> | String | Die Ausgabe von einem Trigger zur Laufzeit |
triggerBody
Gibt die body
-Ausgabe eines Triggers zur Laufzeit zurück. Kurzform für trigger().outputs.body
. Siehe trigger().
triggerBody()
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<trigger-body-output> | String | Die body -Ausgabe des Triggers |
triggerFormDataMultiValues
Gibt ein Array mit den Werten zurück, die mit einem Schlüsselnamen (key-Name) in der form-data- oder form-encoded-Ausgabe eines Triggers übereinstimmen.
triggerFormDataMultiValues('<key>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<key> | Ja | String | Der Name des Schlüssels, dessen Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
[<array-with-key-values>] | Array | Ein Array mit allen Werten, die mit dem angegebenen Schlüssel übereinstimmen. |
Beispiel
In diesem Beispiel wird ein Array aus dem Wert erstellt, den der „feedUrl“-Schlüssel in der form-data- oder form-encoded Ausgabe eines RSS-Triggers hat:
triggerFormDataMultiValues('feedUrl')
Dieses Array wird als Beispielergebnis zurückgegeben: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]
triggerFormDataValue
Gibt eine Zeichenfolge mit einem einzelnen Wert zurück, der mit einem Schlüsselnamen (key-Name) in der form-data- oder form-encoded-Ausgabe eines Triggers übereinstimmt. Findet die Funktion mehrere Übereinstimmungen, löst sie einen Fehler aus.
triggerFormDataValue('<key>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<key> | Ja | String | Der Name des Schlüssels, dessen Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<key-value> | String | Der Wert in dem angegebenen Schlüssel |
Beispiel
In diesem Beispiel wird eine Zeichenfolge aus dem Wert erstellt, den der „feedUrl“-Schlüssel in der form-data- oder form-encoded Ausgabe eines RSS-Triggers hat:
triggerFormDataValue('feedUrl')
Diese Zeichenfolge wird als Beispielergebnis zurückgegeben: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"
triggerMultipartBody
Gibt den Textteil für einen bestimmten Teil einer Triggerausgabe zurück, die mehrere Teile hat.
triggerMultipartBody(<index>)
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<index> | Ja | Integer | Der Indexwert des von Ihnen gewünschten Teils |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<body> | String | Der Textteil für den angegebenen Teil in der mehrteiligen Ausgabe eines Triggers |
triggerOutputs
Gibt eine Triggerausgabe zur Laufzeit oder Werte aus anderen JSON-Name/Wert-Paaren zurück. Kurzform für trigger().outputs
. Siehe trigger().
triggerOutputs()
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<trigger-output> | String | Die Ausgabe von einem Trigger zur Laufzeit |
trim
Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge und gibt die aktualisierte Zeichenfolge zurück.
trim('<text>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<text> | Ja | String | Die Zeichenfolge, in der sich die führenden und nachfolgende Leerzeichen befinden, die entfernt werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updatedText> | String | Eine aktualisierte Version der ursprünglichen Zeichenfolge ohne führende oder nachfolgende Leerzeichen |
Beispiel
In diesem Beispiel werden das führende und das nachgestellte Leerzeichen aus der Zeichenfolge „ Hello World “ entfernt:
trim(' Hello World ')
Dies ist das zurückgegebene Ergebnis: "Hello World"
U
union
Gibt eine Sammlung zurück, die sämtliche Elemente aus den angegebenen Sammlungen enthält. Damit ein Element im Ergebnis enthalten ist, kann es in irgendeiner der Sammlungen enthalten sein, die an diese Funktion übergeben werden. Haben mehrere Elemente denselben Namen, enthält das Ergebnis das letzte Element mit diesem Namen.
union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<collection1>, <collection2>, ... | Ja | Array oder Objekt, aber nicht beide | Die Sammlungen, aus denen Sie alle Elemente wünschen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<updatedCollection> | Array bzw. Objekt | Eine Sammlung mit allen Elementen aus den angegebenen Sammlungen – keine Duplikate |
Beispiel
In diesem Beispiel werden alle Elemente aus diesen Auflistungen abgerufen:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
Dies ist das zurückgegebene Ergebnis: [1, 2, 3, 10, 101]
uriComponent
Gibt eine URI-codierte (Uniform Resource Identifier) Version für eine Zeichenfolge zurück, indem URL-unsichere Zeichen durch Escapezeichen ersetzt werden. Verwenden Sie diese Funktion anstelle von encodeUriComponent(). Obwohl beide Funktionen in gleicher Weise funktionieren, wird uriComponent()
bevorzugt.
uriComponent('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge, die in das URI-codierte Format konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<encoded-uri> | String | Die URI-codierte Zeichenfolge mit Escapezeichen |
Beispiel
In diesem Beispiel wird eine URI-codierte Version für diese Zeichenfolge erstellt:
uriComponent('https://contoso.com')
Dies ist das zurückgegebene Ergebnis: "https%3A%2F%2Fcontoso.com"
uriComponentToBinary
Gibt die binäre Version einer URI-Komponente (Uniform Resource Identifier) zurück.
uriComponentToBinary('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die URI-codierte Zeichenfolge, die konvertiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<binary-for-encoded-uri> | String | Die Binärversion für die URI-codierte Zeichenfolge Der binäre Inhalt ist base64-codiert und wird von $content dargestellt. |
Beispiel
In diesem Beispiel wird die binäre Version für diese URI-codierte Zeichenfolge erstellt:
uriComponentToBinary('https%3A%2F%2Fcontoso.com')
Dies ist das zurückgegebene Ergebnis:
"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"
uriComponentToString
Gibt die Zeichenfolgenversion einer URI-codierten Zeichenfolge (Uniform Resource Identifier) zurück, d. h., die URI-codierte Zeichenfolge wird decodiert.
uriComponentToString('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die URI-codierte Zeichenfolge, die decodiert werden soll |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<decoded-uri> | String | Die decodierte Version für die URI-codierte Zeichenfolge |
Beispiel
In diesem Beispiel wird die decodierte Zeichenfolgenversion für diese URI-codierte Zeichenfolge erstellt:
uriComponentToString('https%3A%2F%2Fcontoso.com')
Dies ist das zurückgegebene Ergebnis: "https://contoso.com"
uriHost
Gibt den Wert host
für einen Uniform Resource Identifier (URI) zurück.
uriHost('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen host -Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<host-value> | String | Der host -Wert des angegebenen URIs |
Beispiel
In diesem Beispiel wird der host
-Wert dieses URIs abgerufen:
uriHost('https://www.localhost.com:8080')
Dies ist das zurückgegebene Ergebnis: "www.localhost.com"
uriPath
Gibt den Wert path
für einen Uniform Resource Identifier (URI) zurück.
uriPath('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen path -Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<path-value> | String | Der path -Wert des angegebenen URIs. Hat path keinen Wert, wird das Zeichen „/“ zurückgegeben. |
Beispiel
In diesem Beispiel wird der path
-Wert dieses URIs abgerufen:
uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')
Dies ist das zurückgegebene Ergebnis: "/catalog/shownew.htm"
uriPathAndQuery
Gibt die den path
- und den query
-Wert für einen Uniform Resource Identifier (URI) zurück.
uriPathAndQuery('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen path - und query -Wert abgerufen werden sollen |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<path-query-value> | String | Der path - und der query -Wert des angegebenen URIs. Gibt path keinen Wert an, wird das Zeichen „/“ zurückgegeben. |
Beispiel
In diesem Beispiel werden der path
- und der query
-Wert dieses URIs abgerufen:
uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')
Dies ist das zurückgegebene Ergebnis: "/catalog/shownew.htm?date=today"
uriPort
Gibt den Wert port
für einen Uniform Resource Identifier (URI) zurück.
uriPort('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen port -Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<port-value> | Integer | Der port -Wert des angegebenen URIs. Gibt port keinen Wert an, wird der Standardport für das Protokoll zurückgegeben. |
Beispiel
In diesem Beispiel wird der port
-Wert dieses URIs zurückgegeben:
uriPort('https://www.localhost:8080')
Dies ist das zurückgegebene Ergebnis: 8080
uriQuery
Gibt den Wert query
für einen Uniform Resource Identifier (URI) zurück.
uriQuery('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen query -Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<query-value> | String | Der query -Wert des angegebenen URIs |
Beispiel
In diesem Beispiel wird der query
-Wert dieses URIs zurückgegeben:
uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')
Dies ist das zurückgegebene Ergebnis: "?date=today"
uriScheme
Gibt den Wert scheme
für einen Uniform Resource Identifier (URI) zurück.
uriScheme('<uri>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<uri> | Ja | String | Der URI, dessen scheme -Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<scheme-value> | String | Der scheme -Wert des angegebenen URIs |
Beispiel
In diesem Beispiel wird der scheme
-Wert dieses URIs zurückgegeben:
uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')
Dies ist das zurückgegebene Ergebnis: "http"
utcNow
Gibt den aktuellen Zeitstempel zurück.
utcNow('<format>')
Optional können Sie mit dem <format>-Parameter ein anderes Format angeben.
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<format> | Nein | String | Eine numerische Formatzeichenfolge (entweder ein einzelner Formatbezeichner oder ein benutzerdefiniertes Formatmuster). Das Standardformat für den Zeitstempel ist „o“ (JJJJ-MM-TTT hh:mm:ss.fffffffK), das mit ISO 8601 übereinstimmt und in dem Zeitzoneninformationen erhalten bleiben. Wenn das Format kein gültiger Wert ist, wird ein Fehler generiert. |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<current-timestamp> | String | Das aktuelle Datum und die aktuelle Uhrzeit |
Beispiel 1
Nehmen Sie an, heute ist der 15. April 2018, 13:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel abgerufen:
utcNow()
Dies ist das zurückgegebene Ergebnis: "2018-04-15T13:00:00.0000000Z"
Beispiel 2
Nehmen Sie an, heute ist der 15. April 2018, 13:00:00 Uhr. In diesem Beispiel wird der aktuelle Zeitstempel mit dem optionalen „D“-Format abgerufen:
utcNow('D')
Dies ist das zurückgegebene Ergebnis: "Sunday, April 15, 2018"
V
variables
Gibt den Wert für eine angegebene Variable zurück.
variables('<variableName>')
Parameter | Erforderlich | Type | Beschreibung |
---|---|---|---|
<variableName> | Ja | String | Der Name der Variablen, deren Wert Sie abrufen möchten |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<variable-value> | Any | Der Wert der angegebenen Variablen |
Beispiel
Angenommen, die Variable „numItems“ hat aktuell den Wert 20. In diesem Beispiel wird der ganzzahlige Wert dieser Variablen abgerufen:
variables('numItems')
Dies ist das zurückgegebene Ergebnis: 20
W
workflow
Gibt sämtliche Details zum Workflow selbst zur Laufzeit zurück.
workflow().<property>
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<property> | Nein | String | Der Name für die Workfloweigenschaft, deren Wert Sie verwenden möchten Standardmäßig verfügt ein Workflowobjekt über folgende Eigenschaften: name , type , id , location , run und tags . - Der Wert der run -Eigenschaft ist ein JSON-Objekt, das die folgenden Eigenschaften enthält: name , type und id . - Die tags -Eigenschaft ist ein JSON-Objekt, das -Tags, die ihrer Logik-App in Azure Logic Apps oder Flow in Power Automate zugeordnet sind, sowie die Werte für diese Tags enthält. Weitere Informationen zu Tags in Azure-Ressourcen finden Sie unter Tagressourcen, Ressourcengruppen und Abonnements für die logische Organisation in Azure. Hinweis: Standardmäßig verfügt eine Logik-App nicht über Tags, aber ein Power Automate-Flow verfügt über die Tags flowDisplayName und environmentName . |
Beispiel 1
In diesem Beispiel wird der Name der aktuellen Ausführung eines Workflows zurückgegeben:
workflow().run.name
Beispiel 2
Wenn Sie die Power Automate verwenden, können Sie einen @workflow()
-Ausdruck erstellen, der die Ausgabeeigenschaft tags
verwendet, um die Werte aus der Eigenschaft flowDisplayName
oder environmentName
abzurufen.
Beispielsweise können Sie aus dem Flow selbst benutzerdefinierte E-Mail-Benachrichtigungen senden, die widerum mit Ihrem Flow verlinkt sind. Diese Benachrichtigungen können einen HTML-Link enthalten, der den Anzeigenamen des Flows im E-Mail-Titel enthält und der folgenden Syntax folgt:
<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>
X
Xml
Gibt die XML-Version einer Zeichenfolge zurück, die ein JSON-Objekt enthält.
xml('<value>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<value> | Ja | String | Die Zeichenfolge mit dem JSON-Objekt, das konvertiert werden soll. Das JSON-Objekt darf nur eine Stammeigenschaft haben, die kein Array sein darf. Verwenden Sie den umgekehrten Schrägstrich (\) als Escapezeichen für das doppelte Anführungszeichen ("). |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<xml-version> | Object | Das codierte XML-Objekt für die angegebene Zeichenfolge oder das angegebene JSON-Objekt |
Beispiel 1
In diesem Beispiel wird die Zeichenfolge in XML konvertiert:
xml('<name>Sophia Owen</name>')
Dies ist das zurückgegebene XML-Objekt:
<name>Sophia Owen</name>
Beispiel 2
In diesem Beispiel wird die XML-Version für diese Zeichenfolge erstellt, die ein JSON-Objekt enthält:
xml(json('{ "name": "Sophia Owen" }'))
Dies ist das zurückgegebene XML-Objekt:
<name>Sophia Owen</name>
Beispiel 3
Angenommen, Sie haben dieses JSON-Objekt:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
In diesem Beispiel wird das XML-Objekt für eine Zeichenfolge erstellt, die dieses JSON-Objekt enthält:
xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))
Dies ist das zurückgegebene XML-Objekt:
<person>
<name>Sophia Owen</name>
<city>Seattle</city>
<person>
xpath
Überprüft die XML auf Knoten oder Werte, die mit einem XPath-Ausdruck (XML Path Language) übereinstimmen, und gibt die übereinstimmenden Knoten oder Werte zurück. Ein XPath-Ausdruck oder einfach „XPath“ vereinfacht Ihnen das Navigieren in einer XML-Dokumentstruktur, sodass Sie im XML-Inhalt Knoten auswählen oder Werte berechnen können.
Hinweis
In Verbrauchs- und Standard-Logik-Apps verwenden alle Funktionsausdrücke die .NET XPath-Bibliothek. XPath-Ausdrücke sind mit der zugrunde liegenden .NET-Bibliothek kompatibel und unterstützen nur den Ausdruck, den die zugrunde liegende .NET-Bibliothek unterstützt.
xpath('<xml>', '<xpath>')
Parameter | Erforderlich | Type | BESCHREIBUNG |
---|---|---|---|
<xml> | Ja | Any | Die XML-Zeichenfolge, in der nach Knoten oder Werten gesucht werden soll, die mit einem XPath-Ausdruckswert übereinstimmen |
<xpath> | Ja | Any | Der XPath-Ausdruck, der für die Suche nach übereinstimmenden XML-Knoten oder -Werten verwendet wird |
Rückgabewert | type | BESCHREIBUNG |
---|---|---|
<xml-node> | XML | Ein XML-Knoten, wenn nur ein einziger Knoten mit dem angegebenen XPath-Ausdruck übereinstimmt |
<value> | Any | Der Wert aus einem XML-Knoten, wenn nur ein einziger Wert mit dem angegebenen XPath-Ausdruck übereinstimmt |
[<xml-node1>, <xml-node2>, ...] oder [<value1>, <value2>, ...] | Array | Ein Array mit XML-Knoten oder -Werten, die mit den angegebenen XPath-Ausdruck übereinstimmen |
Beispiel 1
Angenommen, es liegt diese XML-Zeichenfolge 'items'
vor:
<?xml version="1.0"?>
<produce>
<item>
<name>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
In diesem Beispiel wird der XPath-Ausdruck '/produce/item/name/text()'
übergeben, um die mit dem Knoten <name></name>
in der XML-Zeichenfolge 'items'
übereinstimmenden Knoten zu suchen, und es wird ein Array mit diesen Knotenwerten zurückgegeben:
xpath(xml(parameters('items')), '/produce/item/name/text()')
Im Beispiel wird außerdem die parameters()-Funktion verwendet, um die XML-Zeichenfolge aus 'items'
abzurufen, und die Zeichenfolge wird mit der xml()-Funktion in das XML-Format konvertiert.
Hier ist das Ergebnisarray, das mit Werten der Knoten aufgefüllt ist, die <name></name>
entsprechen:
[ Gala, Honeycrisp ]
Beispiel 2
In diesem Beispiel, das an Beispiel 1 anschließt, wird der XPath-Ausdruck '/produce/item/name[1]'
übergeben, um das erste Element name
zu finden, das dem Element item
untergeordnet ist.
xpath(xml(parameters('items')), '/produce/item/name[1]')
Das Ergebnis lautet wie folgt: Gala
.
Beispiel 3
In diesem Beispiel, das an Beispiel 1 anschließt, wird der XPath-Ausdruck '/produce/item/name[last()]'
übergeben, um das letzte Element name
zu finden, das dem Element item
untergeordnet ist.
xpath(xml(parameters('items')), '/produce/item/name[last()]')
Das Ergebnis lautet wie folgt: Honeycrisp
.
Beispiel 4
In diesem Beispiel wird angenommen, dass Ihre XML-Zeichenfolge items
auch die Attribute expired='true'
und expired='false'
enthält:
<?xml version="1.0"?>
<produce>
<item>
<name expired='true'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name expired='false'>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
In diesem Beispiel wird der XPath-Ausdruck '//name[@expired]'
übergeben, um alle name
-Elemente zu suchen, die über das Attribut expired
verfügen:
xpath(xml(parameters('items')), '//name[@expired]')
Das Ergebnis lautet wie folgt: [ Gala, Honeycrisp ]
.
Beispiel 5
In diesem Beispiel wird angenommen, dass Ihre XML-Zeichenfolge items
nur das Attribut expired = 'true'
enthält:
<?xml version="1.0"?>
<produce>
<item>
<name expired='true'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
In diesem Beispiel wird der XPath-Ausdruck '//name[@expired = 'true']'
übergeben, um alle name
-Elemente zu suchen, die über das Attribut expired = 'true'
verfügen:
xpath(xml(parameters('items')), '//name[@expired = 'true']')
Das Ergebnis lautet wie folgt: [ Gala ]
.
Beispiel 6
In diesem Beispiel wird angenommen, dass Ihre XML-Zeichenfolge items
auch diese Attribute enthält:
expired='true' price='12'
expired='false' price='40'
<?xml version="1.0"?>
<produce>
<item>
<name expired='true' price='12'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name expired='false' price='40'>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
In diesem Beispiel wird der XPath-Ausdruck '//name[@price>35]'
übergeben, um alle name
-Elemente zu suchen, die über price > 35
verfügen:
xpath(xml(parameters('items')), '//name[@price>35]')
Das Ergebnis lautet wie folgt: Honeycrisp
.
Beispiel 7
In diesem Beispiel wird angenommen, dass Ihre XML-Zeichenfolge items
mit der in Beispiel 1 übereinstimmt:
<?xml version="1.0"?>
<produce>
<item>
<name>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
In diesem Beispiel wird nach Knoten gesucht, die mit dem Knoten <count></count>
übereinstimmen, und diese Knotenwerte werden mit der sum()
-Funktion addiert:
xpath(xml(parameters('items')), 'sum(/produce/item/count)')
Das Ergebnis lautet wie folgt: 30
.
Beispiel 8
In diesem Beispiel wird angenommen, dass Sie über diese XML-Zeichenfolge verfügen, die den XML-Dokumentnamespace xmlns="https://contoso.com"
enthält:
<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>
In diesen Ausdrücken wird einer der XPath-Ausdrücke /*[name()="file"]/*[name()="location"]
oder /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]
verwendet, um nach Knoten zu suchen, die mit dem Knoten <location></location>
übereinstimmen. Diese Beispiele zeigen die Syntax, die Sie im Designer oder im Ausdrucks-Editor verwenden:
xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')
Dies ist der Ergebnisknoten, der mit dem <location></location>
-Knoten übereinstimmt:
<location xmlns="https://contoso.com">Paris</location>
Wichtig
Wenn Sie in der Codeansicht arbeiten, verwenden Sie den umgekehrten Schrägstrich (\) als Escapezeichen für das doppelte Anführungszeichen ("). Beispielsweise müssen Sie Escapezeichen verwenden, wenn Sie einen Ausdruck als JSON-Zeichenfolge serialisieren. Wenn Sie jedoch im Designer oder im Ausdrucks-Editor arbeiten, müssen Sie das doppelte Anführungszeichen nicht mit Escapezeichen versehen, da der umgekehrte Schrägstrich automatisch der zugrunde liegenden Definition hinzugefügt wird, z. B.:
Codeansicht:
xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Ausdrucks-Editor:
xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
Beispiel 9
In diesem Beispiel, das an Beispiel 8 anschließt, wird der XPath-Ausdruck 'string(/*[name()="file"]/*[name()="location"])'
verwendet, um den Wert im Knoten <location></location>
zu suchen:
xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')
Das Ergebnis lautet wie folgt: Paris
.
Nächste Schritte
Informationen zu der Definitionssprache für Workflows