Referensguide till funktioner för arbetsflödesuttryck i Azure Logic Apps och Power Automate

Artikel
12/15/2023

Gäller för: Azure Logic Apps (Förbrukning + Standard)

För arbetsflödesdefinitioner i Azure Logic Apps och Power Automate får vissa uttryck sina värden från körningsåtgärder som kanske inte finns ännu när arbetsflödet börjar köras. Om du vill referera till eller bearbeta värdena i dessa uttryck kan du använda uttrycksfunktioner som tillhandahålls av arbetsflödesdefinitionsspråket.

Kommentar

Den här referenssidan gäller för både Azure Logic Apps och Power Automate, men visas i Dokumentationen om Azure Logic Apps. Även om den här sidan specifikt refererar till arbetsflöden för logikappar fungerar dessa funktioner för både flöden och logikapparbetsflöden. Mer information om funktioner och uttryck i Power Automate finns i Använda uttryck under villkor.

Du kan till exempel beräkna värden med hjälp av matematiska funktioner, till exempel funktionen add(), när du vill ha summan från heltal eller flyttal. Här är andra exempeluppgifter som du kan utföra med funktioner:

Uppgift	Funktionssyntax	Result
Returnera en sträng i gemener.	toLower('<text>') Till exempel: toLower('Hello')	"hej"
Returnera en globalt unik identifierare (GUID).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Om du vill hitta funktioner baserat på deras allmänna syfte läser du följande tabeller. Eller, för detaljerad information om varje funktion, se den alfabetiska listan.

Funktioner i uttryck

Om du vill visa hur du använder en funktion i ett uttryck visar det här exemplet hur du kan hämta värdet från parametern customerName och tilldela värdet till accountName egenskapen med hjälp av funktionen parameters() i ett uttryck:

"accountName": "@parameters('customerName')"

Här följer några andra allmänna sätt att använda funktioner i uttryck:

Uppgift	Funktionssyntax i ett uttryck
Utför arbete med ett objekt genom att skicka objektet till en funktion.	"@<functionName>(<item>)"
1. Hämta parameterNames värde med hjälp av den kapslade `parameters()` funktionen. 2. Utför arbete med resultatet genom att skicka värdet till functionName.	"@<functionName>(parameters('<parameterName>'))"
1. Hämta resultatet från den kapslade inre funktionen functionName. 2. Skicka resultatet till den yttre funktionen functionName2.	"@<functionName2>(<functionName>(<item>))"
1. Hämta resultatet från functionName. 2. Med tanke på att resultatet är ett objekt med egenskapen propertyname hämtar du egenskapens värde.	"@<functionName>(<item).<>propertyName>"

Funktionen kan till exempel concat() ta två eller flera strängvärden som parametrar. Den här funktionen kombinerar dessa strängar i en sträng. Du kan antingen skicka in strängliteraler, till exempel "Sophia" och "Owen" så att du får en kombinerad sträng, "SophiaOwen":

"customerName": "@concat('Sophia', 'Owen')"

Du kan också hämta strängvärden från parametrar. I det parameters() här exemplet används funktionen i varje concat() parameter och parametrarna firstName och lastName . Sedan skickar du de resulterande strängarna till concat() funktionen så att du får en kombinerad sträng, till exempel "SophiaOwen":

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

Hur som helst tilldelar båda exemplen resultatet till egenskapen customerName .

Överväganden för att använda funktioner

Designern utvärderar inte körningsuttryck som används som funktionsparametrar vid designtillfället. Designern kräver att alla uttryck kan utvärderas fullständigt vid designtillfället.
Funktionsparametrar utvärderas från vänster till höger.
I syntaxen för parameterdefinitioner innebär ett frågetecken (?) som visas efter en parameter att parametern är valfri. Se till exempel getFutureTime().
Funktionsuttryck som visas i rad med oformaterad text kräver att klammerparenteser omsluts ({}) för att använda uttryckets interpolerade format i stället. Det här formatet hjälper till att undvika parsningsproblem. Om funktionsuttrycket inte visas i stil med oformaterad text krävs inga klammerparenteser.

I följande exempel visas rätt och felaktig syntax:

Rätt: "<text>/@{<function-name>('<parameter-name>')}/<text>"

Fel: "<text>/@<function-name>('<parameter-name>')/<text>"

OK: "@<function-name>('<parameter-name>')"

I följande avsnitt ordnas funktioner baserat på deras allmänna syfte, eller så kan du bläddra bland dessa funktioner i alfabetisk ordning.

Strängfunktioner

Om du vill arbeta med strängar kan du använda dessa strängfunktioner och även vissa samlingsfunktioner. Strängfunktioner fungerar endast på strängar.

Strängfunktion	Uppgift
segment	Dela upp en sträng eller samling i segment med samma längd.
concat	Kombinera två eller flera strängar och returnera den kombinerade strängen.
endsWith	Kontrollera om en sträng slutar med den angivna delsträngen.
formatNumber	Returnera ett tal som en sträng baserat på det angivna formatet
GUID	Generera en globalt unik identifierare (GUID) som en sträng.
indexOf	Returnera startpositionen för en delsträng.
isFloat	Returnera ett booleskt värde som anger om en sträng är ett flyttalsnummer.
isInt	Returnera ett booleskt värde som anger om en sträng är ett heltal.
lastIndexOf	Returnera startpositionen för den sista förekomsten av en delsträng.
length	Returnera antalet objekt i en sträng eller matris.
nthIndexOf	Returnera startpositionen eller indexvärdet där den n:e förekomsten av en delsträng visas i en sträng.
ersätt	Ersätt en delsträng med den angivna strängen och returnera den uppdaterade strängen.
sektor	Returnera en delsträng genom att ange start- och slutpositionen eller värdet. Se även delsträng.
dela	Returnera en matris som innehåller delsträngar, avgränsade med kommatecken, från en större sträng baserat på ett angivet avgränsartecken i den ursprungliga strängen.
startsWith	Kontrollera om en sträng börjar med en specifik delsträng.
Delsträng	Returnera tecken från en sträng med början från den angivna positionen. Se även segment.
toLower	Returnera en sträng i gemener.
toUpper	Returnera en sträng i versaler.
trimma	Ta bort inledande och avslutande blanksteg från en sträng och returnera den uppdaterade strängen.

Insamlingsfunktioner

Om du vill arbeta med samlingar, vanligtvis matriser, strängar och ibland ordlistor, kan du använda dessa samlingsfunktioner.

Samlingsfunktion	Uppgift
segment	Dela upp en sträng eller samling i segment med samma längd.
Innehåller	Kontrollera om en samling har ett specifikt objekt.
empty	Kontrollera om en samling är tom.
första	Returnera det första objektet från en samling.
vägkorsning	Returnera en samling som bara har de vanliga objekten i de angivna samlingarna.
sak	Om den här funktionen visas i en upprepande åtgärd över en matris returnerar du det aktuella objektet i matrisen under åtgärdens aktuella iteration.
join	Returnera en sträng som innehåller alla objekt från en matris, avgränsad med det angivna tecknet.
sist	Returnera det sista objektet från en samling.
length	Returnera antalet objekt i en sträng eller matris.
omvänd	Ändra ordningen på objekt i en matris.
skippa	Ta bort objekt från framsidan av en samling och returnera alla andra objekt.
sortera	Sortera objekt i en samling.
ta	Returnera objekt från framsidan av en samling.
union	Returnera en samling som innehåller alla objekt från de angivna samlingarna.

Logiska jämförelsefunktioner

Om du vill arbeta med villkor, jämföra värden och uttrycksresultat eller utvärdera olika typer av logik kan du använda dessa logiska jämförelsefunktioner. Fullständig referens om varje funktion finns i den alfabetiska listan.

Kommentar

Om du använder logiska funktioner eller villkor för att jämföra värden konverteras null-värden till tomma strängvärden (""). Beteendet för villkor skiljer sig åt när du jämför med en tom sträng i stället för ett null-värde. Mer information finns i funktionen string().

Logisk jämförelsefunktion	Uppgift
and	Kontrollera om alla uttryck är sanna.
Motsvarar	Kontrollera om båda värdena är likvärdiga.
greater	Kontrollera om det första värdet är större än det andra värdet.
greaterOrEquals	Kontrollera om det första värdet är större än eller lika med det andra värdet.
om	Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde.
isFloat	Returnera ett booleskt värde som anger om en sträng är ett flyttalsnummer.
isInt	Returnera ett booleskt värde som anger om en sträng är ett heltal.
less	Kontrollera om det första värdet är mindre än det andra värdet.
lessOrEquals	Kontrollera om det första värdet är mindre än eller lika med det andra värdet.
inte	Kontrollera om ett uttryck är falskt.
or	Kontrollera om minst ett uttryck är sant.

Konverteringsfunktioner

Om du vill ändra ett värdes typ eller format kan du använda dessa konverteringsfunktioner. Du kan till exempel ändra ett värde från ett booleskt värde till ett heltal. Mer information om hur Azure Logic Apps hanterar innehållstyper under konverteringen finns i Hantera innehållstyper. Fullständig referens om varje funktion finns i den alfabetiska listan.

Kommentar

Azure Logic Apps utför automatiskt eller implicit base64-kodning och avkodning, så du behöver inte utföra dessa konverteringar manuellt med hjälp av kodnings- och avkodningsfunktionerna. Men om du använder dessa funktioner ändå i designern kan det uppstå oväntade återgivningsbeteenden i designern. Dessa beteenden påverkar bara funktionernas synlighet och inte deras effekt om du inte redigerar funktionernas parametervärden, vilket tar bort funktionerna och deras effekter från koden. Mer information finns i Implicita datatypkonverteringar.

Konverteringsfunktion	Uppgift
samling	Returnera en matris från en enda angiven indata. Flera indata finns i createArray.
base64	Returnera den base64-kodade versionen för en sträng.
base64ToBinary	Returnera den binära versionen för en base64-kodad sträng.
base64ToString	Returnera strängversionen för en base64-kodad sträng.
binär	Returnera den binära versionen för ett indatavärde.
Bool	Returnera den booleska versionen för ett indatavärde.
createArray	Returnera en matris från flera indata.
dataUri	Returnera data-URI:n för ett indatavärde.
dataUriToBinary	Returnera den binära versionen för en data-URI.
dataUriToString	Returnera strängversionen för en data-URI.
decimal	Returnera decimaltalet för en decimalsträng.
avkodaBase64	Returnera strängversionen för en base64-kodad sträng.
decodeDataUri	Returnera den binära versionen för en data-URI.
decodeUriComponent	Returnera en sträng som ersätter escape-tecken med avkodade versioner.
encodeUriComponent	Returnera en sträng som ersätter URL-osäkra tecken med escape-tecken.
flyta	Returnera ett flyttalsnummer för ett indatavärde.
Int	Returnera heltalsversionen för en sträng.
json	Returnera JSON-typvärdet (JavaScript Object Notation) för en sträng eller XML.
sträng	Returnera strängversionen för ett indatavärde.
uriComponent	Returnera den URI-kodade versionen för ett indatavärde genom att ersätta URL-osäkra tecken med escape-tecken.
uriComponentToBinary	Returnera den binära versionen för en URI-kodad sträng.
uriComponentToString	Returnera strängversionen för en URI-kodad sträng.
xml	Returnera XML-versionen för en sträng.

Implicita datatypskonverteringar

Azure Logic Apps konverterar automatiskt eller implicit mellan vissa datatyper, så du behöver inte utföra dessa konverteringar manuellt. Om du till exempel använder icke-strängvärden där strängar förväntas som indata konverterar Azure Logic Apps automatiskt värdena som inte är strängar till strängar.

Anta till exempel att en utlösare returnerar ett numeriskt värde som utdata:

triggerBody()?['123']

Om du använder dessa numeriska utdata där strängindata förväntas, till exempel en URL, konverterar Azure Logic Apps automatiskt värdet till en sträng med hjälp av klammerparenteser ({}) notation:

@{triggerBody()?['123']}

Base64-kodning och avkodning

Azure Logic Apps utför automatiskt eller implicit base64-kodning eller avkodning, så du behöver inte utföra dessa konverteringar manuellt med hjälp av motsvarande funktioner:

base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)

Kommentar

Om du lägger till någon av dessa funktioner manuellt när du använder designern, antingen direkt till en utlösare eller åtgärd eller genom att använda uttrycksredigeraren, navigerar bort från designern och sedan återgår till designern försvinner funktionen från designern och lämnar bara parametervärdena kvar. Det här beteendet inträffar också om du väljer en utlösare eller åtgärd som använder den här funktionen utan att redigera funktionens parametervärden. Det här resultatet påverkar bara funktionens synlighet och inte effekten. I kodvyn påverkas inte funktionen. Men om du redigerar funktionens parametervärden tas både funktionen och dess effekt bort från kodvyn och lämnar bara kvar funktionens parametervärden.

Matematikfunktioner

Om du vill arbeta med heltal och flyttal kan du använda dessa matematiska funktioner. Fullständig referens om varje funktion finns i den alfabetiska listan.

Matematisk funktion	Uppgift
addera	Returnera resultatet från att lägga till två tal.
div	Returnera resultatet från att dela upp två tal.
max	Returnera det högsta värdet från en uppsättning tal eller en matris.
min	Returnera det lägsta värdet från en uppsättning tal eller en matris.
mods	Returnera resten från att dela upp två tal.
mul	Returnera produkten från att multiplicera två tal.
Rand	Returnera ett slumpmässigt heltal från ett angivet intervall.
intervall	Returnera en heltalsmatris som startar från ett angivet heltal.
under	Returnera resultatet från att subtrahera det andra talet från det första talet.

Översikt över datum- och tidsfunktioner

Om du vill arbeta med datum och tider kan du använda dessa datum- och tidsfunktioner. Fullständig referens om varje funktion finns i den alfabetiska listan.

Datum- eller tidsfunktion	Uppgift
addDays	Lägg till dagar i en tidsstämpel.
addHours	Lägg till timmar i en tidsstämpel.
addMinutes	Lägg till minuter i en tidsstämpel.
addSeconds	Lägg till sekunder i en tidsstämpel.
addToTime	Lägg till angivna tidsenheter i en tidsstämpel. Se även getFutureTime.
convertFromUtc	Konvertera en tidsstämpel från Universal Time Coordinated (UTC) till måltidszonen.
convertTimeZone	Konvertera en tidsstämpel från källtidszonen till måltidszonen.
convertToUtc	Konvertera en tidsstämpel från källtidszonen till Universal Time Coordinated (UTC).
dateDifference	Returnera skillnaden mellan två datum som ett tidsintervall.
dayOfMonth	Returnera månadskomponenten från en tidsstämpel.
dayOfWeek	Returnera veckodag-komponenten från en tidsstämpel.
dayOfYear	Returnera årskomponentens dag från en tidsstämpel.
formatDateTime	Returnera datumet från en tidsstämpel.
getFutureTime	Returnera den aktuella tidsstämpeln plus de angivna tidsenheterna. Se även addToTime.
getPastTime	Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna. Se även subtractFromTime.
parseDateTime	Returnera tidsstämpeln från en sträng som innehåller en tidsstämpel.
startOfDay	Returnera dagens start för en tidsstämpel.
startOfHour	Returnera timmens start för en tidsstämpel.
startOfMonth	Returnera början av månaden för en tidsstämpel.
subtractFromTime	Subtrahera ett antal tidsenheter från en tidsstämpel. Se även getPastTime.
Fästingar	Returnera egenskapsvärdet `ticks` för en angiven tidsstämpel.
utcNow	Returnera den aktuella tidsstämpeln som en sträng.

Arbetsflödesfunktioner

Dessa arbetsflödesfunktioner kan hjälpa dig:

Få information om en arbetsflödesinstans vid körning.
Arbeta med indata som används för att instansiera logikappar eller flöden.
Referera till utdata från utlösare och åtgärder.

Du kan till exempel referera till utdata från en åtgärd och använda dessa data i en senare åtgärd. Fullständig referens om varje funktion finns i den alfabetiska listan.

Arbetsflödesfunktion	Uppgift
åtgärd	Returnera den aktuella åtgärdens utdata vid körning eller värden från andra JSON-namn-och-värde-par. Se även åtgärder.
Åtgärder	Returnera en åtgärds utdata vid körning eller värden från andra JSON-namn-och-värde-par. Se även åtgärd.
brödtext	Returnera en åtgärds `body` utdata vid körning.
formDataMultiValues	Skapa en matris med de värden som matchar ett nyckelnamn i formdata - eller formulärkodade åtgärdsutdata.
formDataValue	Returnera ett enda värde som matchar ett nyckelnamn i en åtgärds formulärdata eller formulärkodade utdata.
sak	Om den här funktionen visas i en upprepande åtgärd över en matris returnerar du det aktuella objektet i matrisen under åtgärdens aktuella iteration.
Objekt	Om den här funktionen visas i en Foreach- eller Until-loop returnerar du det aktuella objektet från den angivna loopen.
iterationIndexes	Om den här funktionen visas i en Until-loop returnerar du indexvärdet för den aktuella iterationen. Du kan använda den här funktionen i kapslade Until-loopar.
listCallbackUrl	Returnera den "motringnings-URL" som anropar en utlösare eller åtgärd.
multipartBody	Returnera brödtexten för en viss del i en åtgärds utdata som har flera delar.
Utgångar	Returnera en åtgärds utdata vid körning.
parameters	Returnera värdet för en parameter som beskrivs i arbetsflödesdefinitionen.
resultat	Returnera indata och utdata från åtgärderna på den översta nivån i den angivna omfångsåtgärden, till exempel `For_each`, `Until`och `Scope`.
utlösa	Returnera en utlösares utdata vid körning eller från andra JSON-namn-och-värde-par. Se även triggerOutputs och triggerBody.
triggerBody	Returnera en utlösares `body` utdata vid körning. Se utlösare.
triggerFormDataValue	Returnera ett enda värde som matchar ett nyckelnamn i utdata från formdata eller formulärkodade utlösare.
triggerMultipartBody	Returnera brödtexten för en specifik del i en utlösares utdata för flera delar.
triggerFormDataMultiValues	Skapa en matris vars värden matchar ett nyckelnamn i utdata från formdata eller formulärkodade utlösare.
triggerOutputs	Returnera en utlösares utdata vid körning eller värden från andra JSON-namn-och-värde-par. Se utlösare.
Variabler	Returnera värdet för en angiven variabel.
arbetsflöde	Returnera all information om själva arbetsflödet under körningen.

URI tolkningsfunktioner

Om du vill arbeta med enhetliga resursidentifierare (URI:er) och hämta olika egenskapsvärden för dessa URI:er kan du använda dessa URI-parsningsfunktioner. Fullständig referens om varje funktion finns i den alfabetiska listan.

URI-parsningsfunktion	Uppgift
uriHost	`host` Returnera värdet för en enhetlig resursidentifierare (URI).
uriPath	`path` Returnera värdet för en enhetlig resursidentifierare (URI).
uriPathAndQuery	`path` Returnera värdena och `query` för en enhetlig resursidentifierare (URI).
uriPort	`port` Returnera värdet för en enhetlig resursidentifierare (URI).
uriQuery	`query` Returnera värdet för en enhetlig resursidentifierare (URI).
uriScheme	`scheme` Returnera värdet för en enhetlig resursidentifierare (URI).

Manipulationsfunktioner: JSON & XML

Om du vill arbeta med JSON-objekt och XML-noder kan du använda dessa manipulationsfunktioner. Fullständig referens om varje funktion finns i den alfabetiska listan.

Manipulationsfunktion	Uppgift
addProperty	Lägg till en egenskap och dess värde, eller namn/värde-par, i ett JSON-objekt och returnera det uppdaterade objektet.
sammansmälta	Returnera det första värdet som inte är null från en eller flera parametrar.
removeProperty	Ta bort en egenskap från ett JSON-objekt och returnera det uppdaterade objektet.
setProperty	Ange värdet för ett JSON-objekts egenskap och returnera det uppdaterade objektet.
xpath	Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden.

---------------------------------

Alla funktioner – alfabetisk lista

I det här avsnittet visas alla tillgängliga funktioner i alfabetisk ordning.

A

åtgärd

Returnera den aktuella åtgärdens utdata vid körning, eller värden från andra JSON-namn-och-värde-par, som du kan tilldela till ett uttryck. Som standard refererar den här funktionen till hela åtgärdsobjektet, men du kan också ange en egenskap vars värde du vill använda. Se även actions().

Du kan bara använda action() funktionen på följande platser:

Egenskapen unsubscribe för en webhook-åtgärd så att du kan komma åt resultatet från den ursprungliga subscribe begäran
Egenskapen trackedProperties för en åtgärd
Loopvillkoret do-until för en åtgärd

action()
action().outputs.body.<property>

Parameter	Obligatoriskt	Type	Beskrivning
<egenskap>	Nej	String	Namnet på åtgärdsobjektets egenskap vars värde du vill ha: namn, startTime, endTime, indata, utdata, status, kod, trackingId och clientTrackingId. I Azure Portal kan du hitta de här egenskaperna genom att granska en specifik körningshistoriks information. Mer information finns i REST API – Arbetsflödeskörningsåtgärder.

Returvärde	Typ	Beskrivning
<action-output>	String	Utdata från den aktuella åtgärden eller egenskapen

åtgärder

Returnera en åtgärds utdata vid körning, eller värden från andra JSON-namn-och-värde-par, som du kan tilldela till ett uttryck. Som standard refererar funktionen till hela åtgärdsobjektet, men du kan också ange en egenskap vars värde du vill använda. För korta versioner, se body(). För den aktuella åtgärden, se action().

Dricks

Funktionen actions() returnerar utdata som en sträng. Om du behöver arbeta med ett returnerat värde som ett JSON-objekt måste du först konvertera strängvärdet. Du kan omvandla strängvärdet till ett JSON-objekt med åtgärden Parsa JSON.

Kommentar

Tidigare kan du använda actions() funktionen eller elementet conditions när du anger att en åtgärd kördes baserat på utdata från en annan åtgärd. Men om du vill deklarera explicit beroenden mellan åtgärder måste du nu använda den beroende åtgärdens runAfter egenskap. Mer information om egenskapen finns i runAfter Fånga och hantera fel med egenskapen runAfter.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Namnet på åtgärdsobjektet vars utdata du vill ha
<egenskap>	Nej	String	Namnet på åtgärdsobjektets egenskap vars värde du vill ha: namn, startTime, endTime, indata, utdata, status, kod, trackingId och clientTrackingId. I Azure Portal kan du hitta de här egenskaperna genom att granska en specifik körningshistoriks information. Mer information finns i REST API – Arbetsflödeskörningsåtgärder.

Returvärde	Typ	Beskrivning
<action-output>	String	Utdata från den angivna åtgärden eller egenskapen

Exempel

Det här exemplet hämtar egenskapsvärdet status från X-åtgärden Get user vid körning:

actions('Get_user').outputs.body.status

Och returnerar det här resultatet: "Succeeded"

add

Returnera resultatet från att lägga till två tal.

add(<summand_1>, <summand_2>)

Parameter	Obligatoriskt	Type	Beskrivning
<>summand_1, <summand_2>	Ja	Heltal, flyttal eller blandat	De tal som ska läggas till

Returvärde	Typ	Beskrivning
<result-sum>	Heltal eller flyttal	Resultatet av att lägga till de angivna talen

Exempel

Det här exemplet lägger till de angivna talen:

add(1, 1.5)

Och returnerar det här resultatet: 2.5

addDays

Lägg till dagar i en tidsstämpel.

addDays('<timestamp>', <days>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<Dagar>	Ja	Integer	Det positiva eller negativa antalet dagar som ska läggas till
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet dagar

Exempel 1

Det här exemplet lägger till 10 dagar till den angivna tidsstämpeln:

addDays('2018-03-15T00:00:00Z', 10)

Och returnerar det här resultatet: "2018-03-25T00:00:00.0000000Z"

Exempel 2

Det här exemplet subtraherar fem dagar från den angivna tidsstämpeln:

addDays('2018-03-15T00:00:00Z', -5)

Och returnerar det här resultatet: "2018-03-10T00:00:00.0000000Z"

addHours

Lägg till timmar i en tidsstämpel.

addHours('<timestamp>', <hours>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<hours>	Ja	Integer	Det positiva eller negativa antalet timmar som ska läggas till
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet timmar

Exempel 1

Det här exemplet lägger till 10 timmar till den angivna tidsstämpeln:

addHours('2018-03-15T00:00:00Z', 10)

Och returnerar det här resultatet: "2018-03-15T10:00:00.0000000Z"

Exempel 2

Det här exemplet subtraherar fem timmar från den angivna tidsstämpeln:

addHours('2018-03-15T15:00:00Z', -5)

Och returnerar det här resultatet: "2018-03-15T10:00:00.0000000Z"

addMinutes

Lägg till minuter i en tidsstämpel.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<minutes>	Ja	Integer	Det positiva eller negativa antalet minuter som ska läggas till
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet minuter

Exempel 1

Det här exemplet lägger till 10 minuter till den angivna tidsstämpeln:

addMinutes('2018-03-15T00:10:00Z', 10)

Och returnerar det här resultatet: "2018-03-15T00:20:00.0000000Z"

Exempel 2

Det här exemplet subtraherar fem minuter från den angivna tidsstämpeln:

addMinutes('2018-03-15T00:20:00Z', -5)

Och returnerar det här resultatet: "2018-03-15T00:15:00.0000000Z"

addProperty

Lägg till en egenskap och dess värde, eller namn/värde-par, i ett JSON-objekt och returnera det uppdaterade objektet. Om egenskapen redan finns vid körning misslyckas funktionen och utlöser ett fel.

addProperty(<object>, '<property>', <value>)

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet där du vill lägga till en egenskap
<egenskap>	Ja	String	Namnet på egenskapen som ska läggas till
<värde>	Ja	Alla	Värdet för egenskapen

Returvärde	Typ	Beskrivning
<updated-object>	Objekt	Det uppdaterade JSON-objektet med den angivna egenskapen

Om du vill lägga till en överordnad setProperty() egenskap i en befintlig egenskap använder du funktionen, inte funktionen addProperty() . Annars returnerar funktionen endast det underordnade objektet som utdata.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet där du vill lägga till en egenskap
<parent-property>	Ja	String	Namnet på den överordnade egenskapen där du vill lägga till den underordnade egenskapen
<underordnad egenskap>	Ja	String	Namnet på den underordnade egenskapen som ska läggas till
<värde>	Ja	Alla	Värdet som ska anges för den angivna egenskapen

Returvärde	Typ	Beskrivning
<updated-object>	Objekt	Det uppdaterade JSON-objektet vars egenskap du anger

Exempel 1

Det här exemplet lägger till middleName egenskapen i ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON(). Objektet innehåller firstName redan egenskaperna och surName . Funktionen tilldelar det angivna värdet till den nya egenskapen och returnerar det uppdaterade objektet:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

Här är det aktuella JSON-objektet:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Här är det uppdaterade JSON-objektet:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Exempel 2

Det här exemplet lägger till den middleName underordnade egenskapen i den befintliga customerName egenskapen i ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON(). Funktionen tilldelar det angivna värdet till den nya egenskapen och returnerar det uppdaterade objektet:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

Här är det aktuella JSON-objektet:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

Här är det uppdaterade JSON-objektet:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

Lägg till sekunder i en tidsstämpel.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<Sekunder>	Ja	Integer	Det positiva eller negativa antalet sekunder som ska läggas till
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet sekunder

Exempel 1

Det här exemplet lägger till 10 sekunder till den angivna tidsstämpeln:

addSeconds('2018-03-15T00:00:00Z', 10)

Och returnerar det här resultatet: "2018-03-15T00:00:10.0000000Z"

Exempel 2

Det här exemplet subtraherar fem sekunder till den angivna tidsstämpeln:

addSeconds('2018-03-15T00:00:30Z', -5)

Och returnerar det här resultatet: "2018-03-15T00:00:25.0000000Z"

addToTime

Lägg till de angivna tidsenheterna i en tidsstämpel. Se även getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska läggas till
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Det här exemplet lägger till en dag i den angivna tidsstämpeln:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

Och returnerar det här resultatet: "2018-01-02T00:00:00.0000000Z"

Exempel 2

Det här exemplet lägger till en dag i den angivna tidsstämpeln:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

Och returnerar resultatet med det valfria D-formatet: "Tuesday, January 2, 2018"

och

Kontrollera om alla uttryck är sanna. Returnera sant när alla uttryck är sanna eller returnerar false när minst ett uttryck är falskt.

and(<expression1>, <expression2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>, ...	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när alla uttryck är sanna. Returnera false när minst ett uttryck är falskt.

Exempel 1

De här exemplen kontrollerar om de angivna booleska värdena är sanna:

and(true, true)
and(false, true)
and(false, false)

Och returnerar följande resultat:

Första exemplet: Båda uttrycken är sanna, så returnerar true.
Andra exemplet: Ett uttryck är falskt, så returnerar false.
Tredje exemplet: Båda uttrycken är falska, så returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken är sanna:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Och returnerar följande resultat:

Första exemplet: Båda uttrycken är sanna, så returnerar true.
Andra exemplet: Ett uttryck är falskt, så returnerar false.
Tredje exemplet: Båda uttrycken är falska, så returnerar false.

matris

Returnera en matris från en enda angiven indata. Flera indata finns i createArray().

array('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen för att skapa en matris

Returvärde	Typ	Beskrivning
[<värde>]	Matris	En matris som innehåller den enda angivna indatan

Exempel

I det här exemplet skapas en matris från "hello"-strängen:

array('hello')

Och returnerar det här resultatet: ["hello"]

F

base64

Returnera den base64-kodade versionen för en sträng.

Kommentar

Azure Logic Apps utför automatiskt eller implicit base64-kodning och avkodning, så du behöver inte utföra dessa konverteringar manuellt med hjälp av kodnings- och avkodningsfunktionerna. Men om du ändå använder dessa funktioner kan du uppleva oväntade återgivningsbeteenden i designern. Dessa beteenden påverkar bara funktionernas synlighet och inte deras effekt om du inte redigerar funktionernas parametervärden, vilket tar bort funktionerna och deras effekter från koden. Mer information finns i Base64-kodning och avkodning.

base64('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Indatasträngen

Returvärde	Typ	Beskrivning
<base64-string>	String	Den base64-kodade versionen för indatasträngen

Exempel

I det här exemplet konverteras "hello"-strängen till en base64-kodad sträng:

base64('hello')

Och returnerar det här resultatet: "aGVsbG8="

base64ToBinary

Returnera den binära versionen för en base64-kodad sträng.

Kommentar

base64ToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den base64-kodade sträng som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-base64-string>	String	Binärversionen för den base64-kodade strängen

Exempel

Det här exemplet konverterar "aGVsbG8=" base64-kodad sträng till en binär sträng:

base64ToBinary('aGVsbG8=')

Anta till exempel att du använder en HTTP-åtgärd för att skicka en begäran. Du kan använda base64ToBinary() för att konvertera en base64-kodad sträng till binära data och skicka dessa data med hjälp av application/octet-stream innehållstypen i begäran.

base64ToString

Returnera strängversionen för en base64-kodad sträng, vilket effektivt avkodar base64-strängen. Använd den här funktionen i stället för att avkodaBase64(), som är inaktuell.

Kommentar

base64ToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den base64-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-base64-string>	String	Strängversionen för en base64-kodad sträng

Exempel

I det här exemplet konverteras "aGVsbG8=" base64-kodad sträng till bara en sträng:

base64ToString('aGVsbG8=')

Och returnerar det här resultatet: "hello"

binary

Returnera den base64-kodade binära versionen av en sträng.

binary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-input-value>	String	Den base64-kodade binära versionen för den angivna strängen

Exempel

Du använder till exempel en HTTP-åtgärd som returnerar en bild- eller videofil. Du kan använda binary() för att konvertera värdet till en base-64-kodad innehållskuvertmodell. Sedan kan du återanvända innehållskuvertet i andra åtgärder, till exempel Compose. Du kan använda det här funktionsuttrycket för att skicka strängbyten med application/octet-stream innehållstypen i begäran.

brödtext

Returnera en åtgärds body utdata vid körning. Förkortning för actions('<actionName>').outputs.body. Se actions().

body('<actionName>')

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Namnet på åtgärdens `body` utdata som du vill använda

Returvärde	Typ	Beskrivning
<action-body-output>	String	Utdata `body` från den angivna åtgärden

Exempel

Det här exemplet hämtar body utdata från X-åtgärden Get user :

body('Get_user')

Och returnerar det här resultatet:

"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

Returnera den booleska versionen av ett värde.

bool(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Alla	Värdet som ska konverteras till booleskt värde.

Om du använder bool() med ett objekt måste värdet för objektet vara en sträng eller ett heltal som kan konverteras till booleskt värde.

Returvärde	Typ	Beskrivning
`true` eller `false`	Booleskt	Den booleska versionen av det angivna värdet.

Utdata

De här exemplen visar de olika typerna av indata som stöds för bool():

Indatavärde	Typ	Returvärde
`bool(1)`	Integer	`true`
`bool(0)`	Integer	`false`
`bool(-1)`	Integer	`true`
`bool('true')`	String	`true`
`bool('false')`	String	`false`

C

segment

Dela upp en sträng eller matris i segment med samma längd.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen som ska delas
<length>	Ja	Längden på varje segment

Returvärde	Typ	Beskrivning
<samling>	Matris	En matris med segment med angiven längd

Exempel 1

I det här exemplet delas en sträng upp i segment med längd 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

Och returnerar det här resultatet: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Exempel 2

I det här exemplet delas en matris upp i segment med längd 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

Och returnerar det här resultatet: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

sammansmälta

Returnera det första värdet som inte är null från en eller flera parametrar. Tomma strängar, tomma matriser och tomma objekt är inte null.

coalesce(<object_1>, <object_2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<>object_1, <object_2>, ...	Ja	Valfritt, kan blanda typer	Ett eller flera objekt att söka efter null

Returvärde	Typ	Beskrivning
<first-non-null-item>	Alla	Det första objektet eller värdet som inte är null. Om alla parametrar är null returnerar den här funktionen null.

Exempel

De här exemplen returnerar det första värdet som inte är null från de angivna värdena eller null när alla värden är null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Och returnerar följande resultat:

Första exemplet: true
Andra exemplet: "hello"
Tredje exemplet: null

concat

Kombinera två eller flera strängar och returnera den kombinerade strängen.

concat('<text1>', '<text2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<text1>, <text2>, ...	Ja	String	Minst två strängar att kombinera

Returvärde	Typ	Beskrivning
<text1text2...>	String	Strängen som skapats från de kombinerade indatasträngarna. Obs! Längden på resultatet får inte överstiga 104 857 600 tecken.

Kommentar

Azure Logic Apps utför automatiskt eller implicit base64-kodning och avkodning, så du behöver inte utföra dessa konverteringar manuellt när du använder concat() funktionen med data som behöver kodas eller avkodas:

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

Men om du använder den här funktionen ändå i designern kan det uppstå oväntade återgivningsbeteenden i designern. Dessa beteenden påverkar bara funktionens synlighet och inte effekten om du inte redigerar funktionens parametervärden, vilket tar bort funktionen och effekten från koden. Mer information finns i Base64-kodning och avkodning.

Exempel

I det här exemplet kombineras strängarna "Hello" och "World":

concat('Hello', 'World')

Och returnerar det här resultatet: "HelloWorld"

innehåller

Kontrollera om en samling har ett specifikt objekt. Returnera sant när objektet hittas eller returnera falskt när det inte hittas. Den här funktionen är skiftlägeskänslig.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Mer specifikt fungerar den här funktionen på följande samlingstyper:

En sträng för att hitta en delsträng
En matris för att hitta ett värde
En ordlista för att hitta en nyckel

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng, matris eller ordlista	Samlingen som ska kontrolleras
<värde>	Ja	Sträng, matris eller ordlista	Objektet som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när objektet hittas. Returnera falskt när det inte hittas.

Exempel 1

I det här exemplet kontrolleras strängen "hello world" för delsträngen "world" och returnerar true:

contains('hello world', 'world')

Exempel 2

I det här exemplet kontrolleras strängen "hello world" för understrängen "universe" och returnerar false:

contains('hello world', 'universe')

convertFromUtc

Konvertera en tidsstämpel från Universal Time Coordinated (UTC) till måltidszonen.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<destinationTimeZone>	Ja	String	Namnet på måltidszonen. Information om tidszonsnamn finns i Standardtidszoner för Microsoft Windows.
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterades till måltidszonen utan tidszonens UTC-förskjutning.

Exempel 1

I det här exemplet konverteras en tidsstämpel till den angivna tidszonen:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

Och returnerar det här resultatet: "2018-01-01T00:00:00.0000000"

Exempel 2

I det här exemplet konverteras en tidsstämpel till den angivna tidszonen och formatet:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

Och returnerar det här resultatet: "Monday, January 1, 2018"

convertTimeZone

Konvertera en tidsstämpel från källtidszonen till måltidszonen.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<sourceTimeZone>	Ja	String	Namnet på källtidszonen. Information om tidszonsnamn finns i Standardtidszoner för Microsoft Windows, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<destinationTimeZone>	Ja	String	Namnet på måltidszonen. Information om tidszonsnamn finns i Standardtidszoner för Microsoft Windows, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterad till måltidszonen

Exempel 1

I det här exemplet konverteras källtidszonen till måltidszonen:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

Och returnerar det här resultatet: "2018-01-01T00:00:00.0000000"

Exempel 2

I det här exemplet konverteras en tidszon till den angivna tidszonen och formatet:

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

Och returnerar det här resultatet: "Monday, January 1, 2018"

convertToUtc

Konvertera en tidsstämpel från källtidszonen till Universal Time Coordinated (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<sourceTimeZone>	Ja	String	Namnet på källtidszonen. Information om tidszonsnamn finns i Standardtidszoner för Microsoft Windows, men du kan behöva ta bort eventuella skiljetecken från tidszonsnamnet.
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	String	Tidsstämpeln konverterad till UTC

Exempel 1

I det här exemplet konverteras en tidsstämpel till UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

Och returnerar det här resultatet: "2018-01-01T08:00:00.0000000Z"

Exempel 2

I det här exemplet konverteras en tidsstämpel till UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

Och returnerar det här resultatet: "Monday, January 1, 2018"

createArray

Returnera en matris från flera indata. För enskilda indatamatriser, se matris().

createArray('<object1>', '<object2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>, ...	Ja	Alla, men inte blandade	Minst två objekt för att skapa matrisen

Returvärde	Typ	Beskrivning
[<object1>, <object2>, ...]	Matris	Matrisen som skapats från alla indataobjekt

Exempel

I det här exemplet skapas en matris från dessa indata:

createArray('h', 'e', 'l', 'l', 'o')

Och returnerar det här resultatet: ["h", "e", "l", "l", "o"]

D

dataUri

Returnera en datauniform resursidentifierare (URI) för en sträng.

dataUri('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<data-uri>	String	Data-URI för indatasträngen

Exempel

I det här exemplet skapas en data-URI för "hello"-strängen:

dataUri('hello')

Och returnerar det här resultatet: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Returnera den binära versionen för en datauniform resursidentifierare (URI). Använd den här funktionen i stället för att avkodaDataUri(). Även om båda funktionerna fungerar på samma sätt dataUriBinary() är det att föredra.

dataUriToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-data-uri>	String	Den binära versionen för data-URI:n

Exempel

Det här exemplet skapar en binär version för den här data-URI:n:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Returnera strängversionen för en URI (Data Uniform Resource Identifier).

dataUriToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
<string-for-data-uri>	String	Strängversionen för data-URI:n

Exempel

I det här exemplet skapas en sträng för den här data-URI:n:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Och returnerar det här resultatet: "hello"

dateDifference

Returnera skillnaden mellan två tidsstämplar som tidsintervall. Den här funktionen subtraherar startDate från endDateoch returnerar resultatet som tidsstämpel i strängformat.

dateDifference('<startDate>', '<endDate>')

Parameter	Obligatoriskt	Type	Beskrivning
<startDate>	Ja	String	En sträng som innehåller en tidsstämpel
<endDate>	Ja	String	En sträng som innehåller en tidsstämpel

Returvärde	Typ	Beskrivning
<tidsintervall>	String	Skillnaden mellan de två tidsstämplarna, som är en tidsstämpel i strängformat. Om `startDate` är nyare än `endDate`är resultatet ett negativt värde.

Exempel

I det här exemplet subtraheras det första värdet från det andra värdet:

dateDifference('2015-02-08', '2018-07-30')

Och returnerar det här resultatet: "1268.00:00:00"

dayOfMonth

Returnera dagen i månaden från en tidsstämpel.

dayOfMonth('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag i månaden>	Integer	Dagen i månaden från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar talet för dagen i månaden från den här tidsstämpeln:

dayOfMonth('2018-03-15T13:27:36Z')

Och returnerar det här resultatet: 15

dayOfWeek

Returnera veckodagen från en tidsstämpel.

dayOfWeek('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<veckodag>	Integer	Veckodagen från den angivna tidsstämpeln där söndag är 0, måndag är 1 och så vidare

Exempel

Det här exemplet returnerar numret för veckodagen från den här tidsstämpeln:

dayOfWeek('2018-03-15T13:27:36Z')

Och returnerar det här resultatet: 4

dayOfYear

Returnera dagen på året från en tidsstämpel.

dayOfYear('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag på året>	Integer	Dagen på året från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar antalet dagar på året från den här tidsstämpeln:

dayOfYear('2018-03-15T13:27:36Z')

Och returnerar det här resultatet: 74

decimal

Returnerar ett decimaltal i en sträng som ett decimaltal. Du kan använda den här funktionen när du arbetar med data som kräver decimalprecision och även som indata för logiska jämförelsefunktioner och matematiska funktioner. Om du vill samla in och bevara precision när du använder resultatet från funktionen decimal() omsluter du eventuella decimalutdata med strängfunktionen. Den här användningen visas i följande exempel nedan där du kan förlora precision om du använder decimalresultatet som ett tal.

Kommentar

Decimalprecisionen som beskrivs i kontexten för den här funktionen och Azure Logic Apps-körningen är samma som .NET-decimalprecisionen.

decimal('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Decimaltalet i en sträng

Returvärde	Typ	Beskrivning
<decimal>	Decimaltal	Decimaltalet för indatasträngen

Exempel 1

I det här exemplet skapas en decimal som används som ett tal:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exempel 2

Det här exemplet skapar en decimal och konverterar sedan resultatet till en sträng för precisionsbevarande:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

Exempel 3

I det här exemplet används en matematisk funktion på två decimaltal och resultatet används som ett tal:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

Exempel 4

I det här exemplet används en matematisk funktion på två decimaltal och resultatet konverteras till en sträng för precisionsbevarande:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64 (inaktuell)

Den här funktionen är inaktuell, så använd base64ToString() i stället.

decodeDataUri

Returnera den binära versionen för en datauniform resursidentifierare (URI). Överväg att använda dataUriToBinary(), i stället decodeDataUri()för . Även om båda funktionerna fungerar på samma sätt dataUriToBinary() är det att föredra.

Kommentar

decodeDataUri('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Data-URI-strängen som ska avkodas

Returvärde	Typ	Beskrivning
<binary-for-data-uri>	String	Binär version för en data-URI-sträng

Exempel

Det här exemplet returnerar binärversionen för den här data-URI:n:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Och returnerar det här resultatet:

decodeUriComponent

Returnera en sträng som ersätter escape-tecken med avkodade versioner.

decodeUriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen med escape-tecknen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-uri>	String	Den uppdaterade strängen med de avkodade escape-tecknen

Exempel

Det här exemplet ersätter escape-tecknen i den här strängen med avkodade versioner:

decodeUriComponent('https%3A%2F%2Fcontoso.com')

Och returnerar det här resultatet: "https://contoso.com"

div

Returnera resultatet från att dela upp två tal. Information om hur du hämtar resten av resultatet finns i mod().

div(<dividend>, <divisor>)

Parameter	Obligatoriskt	Type	Beskrivning
<utdelning>	Ja	Heltal eller flyttal	Talet som ska divideras med divisorn
<divisor>	Ja	Heltal eller flyttal	Talet som delar upp utdelningen, men som inte får vara noll

Returvärde	Typ	Beskrivning
<kvotresultat>	Heltal eller flyttal	Resultatet från att dividera det första talet med det andra talet. Om antingen utdelningen eller divisorn har typen Float har resultatet float-typ. Obs! Om du vill konvertera float-resultatet till ett heltal kan du prova att skapa och anropa en funktion i Azure från logikappen.

Exempel 1

Båda exemplen returnerar det här värdet med heltalstyp: 2

div(10,5)
div(11,5)

Exempel 2

Båda exemplen returnerar det här värdet med typen Float: 2.2

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

Returnera en URI-kodad version (uniform resource identifier) för en sträng genom att ersätta URL-osäkra tecken med escape-tecken. Överväg att använda uriComponent(), i stället encodeUriComponent()för . Även om båda funktionerna fungerar på samma sätt uriComponent() är det att föredra.

Kommentar

encodeUriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras till URI-kodat format

Returvärde	Typ	Beskrivning
<encoded-uri>	String	Den URI-kodade strängen med escape-tecken

Exempel

Det här exemplet skapar en URI-kodad version för den här strängen:

encodeUriComponent('https://contoso.com')

Och returnerar det här resultatet: "https%3A%2F%2Fcontoso.com"

empty

Kontrollera om en samling är tom. Returnera sant när samlingen är tom eller returnera falskt när den inte är tom.

empty('<collection>')
empty([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng, matris eller objekt	Samlingen som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när samlingen är tom. Returnera falskt när det inte är tomt.

Exempel

De här exemplen kontrollerar om de angivna samlingarna är tomma:

empty('')
empty('abc')

Och returnerar följande resultat:

Första exemplet: Skickar en tom sträng, så funktionen returnerar true.
Andra exemplet: Skickar strängen "abc", så funktionen returnerar false.

endsWith

Kontrollera om en sträng slutar med en specifik delsträng. Returnera sant när delsträngen hittas eller returnera falskt när den inte hittas. Den här funktionen är inte skiftlägeskänslig.

endsWith('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska kontrolleras
<searchText>	Ja	String	Den avslutande delsträngen som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när den avslutande delsträngen hittas. Returnera falskt när det inte hittas.

Exempel 1

Det här exemplet kontrollerar om "hello world"-strängen slutar med "world"-strängen:

endsWith('hello world', 'world')

Och returnerar det här resultatet: true

Exempel 2

Det här exemplet kontrollerar om "hello world"-strängen slutar med "universum"-strängen:

endsWith('hello world', 'universe')

Och returnerar det här resultatet: false

equals

Kontrollera om båda värdena, uttrycken eller objekten är likvärdiga. Returnera sant när båda är likvärdiga eller returnerar false när de inte är likvärdiga.

equals('<object1>', '<object2>')

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>	Ja	Olika	De värden, uttryck eller objekt som ska jämföras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när båda är likvärdiga. Returnera falskt när det inte är likvärdigt.

Exempel

De här exemplen kontrollerar om de angivna indata är likvärdiga.

equals(true, 1)
equals('abc', 'abcd')

Och returnerar följande resultat:

Första exemplet: Båda värdena är likvärdiga, så funktionen returnerar true.
Andra exemplet: Båda värdena är inte likvärdiga, så funktionen returnerar false.

F

Första

Returnera det första objektet från en sträng eller matris.

first('<collection>')
first([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen där du hittar det första objektet

Returvärde	Typ	Beskrivning
<first-collection-item>	Alla	Det första objektet i samlingen

Exempel

De här exemplen hittar det första objektet i dessa samlingar:

first('hello')
first(createArray(0, 1, 2))

Och returnera dessa resultat:

Första exemplet: "h"
Andra exemplet: 0

flyttal

Konvertera en strängversion för ett flyttalsnummer till ett verkligt flyttalsnummer. Du kan bara använda den här funktionen när du skickar anpassade parametrar till en app, till exempel ett logikapparbetsflöde eller Power Automate-flöde. Om du vill konvertera flyttalssträngar som representeras i språkspecifika format kan du ange en RFC 4646-språkkod.

float('<value>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som har ett giltigt flyttalsnummer att konvertera. Minimi- och maxvärdena är samma som gränserna för flyttalsdatatypen.
<nationella inställningar>	Nej	String	Den RFC 4646-språkkod som ska användas. Om det inte anges används standardspråket. Om nationella inställningar inte är ett giltigt värde genereras ett fel om att det angivna språket inte är giltigt eller inte har någon associerad språkvariant.

Returvärde	Typ	Beskrivning
<float-value>	Flyttal	Flyttalsnumret för den angivna strängen. Minimi- och maxvärdena är samma som gränserna för flyttalsdatatypen.

Exempel 1

I det här exemplet skapas en strängversion för det här flyttalsnumret:

float('10,000.333')

Och returnerar det här resultatet: 10000.333

Exempel 2

I det här exemplet skapas en strängversion för det här flyttalsnumret i tysk stil:

float('10.000,333', 'de-DE')

Och returnerar det här resultatet: 10000.333

formatDateTime

Returnera en tidsstämpel i det angivna formatet.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation.
<nationella inställningar>	Nej	String	Språkvarianten som ska användas. Om det är ospecificerat är `en-us`värdet . Om nationella inställningar inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<formaterad tidsstämpel>	String	Den uppdaterade tidsstämpeln i det angivna formatet och nationella inställningar, om den anges.

Exempel

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

Returnera en matris med värden som matchar ett nyckelnamn i en åtgärds formulärdata eller formulärkodade utdata.

formDataMultiValues('<actionName>', '<key>')

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Åtgärden vars utdata har det nyckelvärde du vill ha
<nyckel>	Ja	String	Namnet på nyckeln vars värde du vill ha

Returvärde	Typ	Beskrivning
[<matris-med-nyckel-värden>]	Matris	En matris med alla värden som matchar den angivna nyckeln

Exempel

I det här exemplet skapas en matris från värdet för ämnesnyckeln i den angivna åtgärdens formulärdata- eller formulärkodade utdata:

formDataMultiValues('Send_an_email', 'Subject')

Och returnerar ämnestexten i en matris, till exempel: ["Hello world"]

formDataValue

Returnera ett enda värde som matchar ett nyckelnamn i en åtgärds formulärdata eller formulärkodade utdata. Om funktionen hittar fler än en matchning utlöser funktionen ett fel.

formDataValue('<actionName>', '<key>')

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Åtgärden vars utdata har det nyckelvärde du vill ha
<nyckel>	Ja	String	Namnet på nyckeln vars värde du vill ha

Returvärde	Typ	Beskrivning
<nyckelvärde>	String	Värdet i den angivna nyckeln

Exempel

I det här exemplet skapas en sträng från värdet för ämnesnyckeln i den angivna åtgärdens formulärdata- eller formulärkodade utdata:

formDataValue('Send_an_email', 'Subject')

Och returnerar ämnestexten som en sträng, till exempel: "Hello world"

formatNumber

Returnera ett tal som en sträng som baseras på det angivna formatet.

formatNumber(<number>, <format>, <locale>?)

Parameter	Obligatoriskt	Type	Beskrivning
<nummer>	Ja	Heltal eller dubbel	Det värde som du vill formatera.
<format>	Ja	String	En sammansatt formatsträng som anger det format som du vill använda. De numeriska formatsträngar som stöds finns i Standard numeriska formatsträngar, som stöds av `number.ToString(<format>, <locale>)`.
<nationella inställningar>	Nej	String	Språkvarianten som stöds av `number.ToString(<format>, <locale>)`. Om det är ospecificerat är `en-us`värdet . Om nationella inställningar inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<formaterat tal>	String	Det angivna talet som en sträng i det format som du angav. Du kan omvandla det här returvärdet till en `int` eller `float`.

Exempel 1

Anta att du vill formatera talet 1234567890. I det här exemplet formateras talet som strängen "1 234 567 890,00".

formatNumber(1234567890, '0,0.00', 'en-us')

*Exempel 2"

Anta att du vill formatera talet 1234567890. I det här exemplet formateras talet till strängen "1.234.567.890,00".

formatNumber(1234567890, '0,0.00', 'is-is')

Exempel 3

Anta att du vill formatera talet 17.35. I det här exemplet formateras talet till strängen "$17.35".

formatNumber(17.35, 'C2')

Exempel 4

Anta att du vill formatera talet 17.35. I det här exemplet formateras talet till strängen "17,35 kr".

formatNumber(17.35, 'C2', 'is-is')

G

getFutureTime

Returnera den aktuella tidsstämpeln plus de angivna tidsenheterna.

getFutureTime(<interval>, <timeUnit>, <format>?)

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	Integer	Antalet tidsenheter som ska läggas till
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel om att det angivna formatet inte är giltigt och måste vara en numerisk formatsträng.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den aktuella tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är "2018-03-01T00:00:00.000000Z". Det här exemplet lägger till fem dagar till den tidsstämpeln:

getFutureTime(5, 'Day')

Och returnerar det här resultatet: "2018-03-06T00:00:00.0000000Z"

Exempel 2

Anta att den aktuella tidsstämpeln är "2018-03-01T00:00:00.000000Z". Det här exemplet lägger till fem dagar och konverterar resultatet till "D"-format:

getFutureTime(5, 'Day', 'D')

Och returnerar det här resultatet: "Tuesday, March 6, 2018"

getPastTime

Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna.

getPastTime(<interval>, <timeUnit>, <format>?)

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska subtraheras
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	Antingen en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel om att det angivna formatet inte är giltigt och måste vara en numerisk formatsträng.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den aktuella tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är "2018-02-01T00:00:00.0000000Z". Det här exemplet subtraherar fem dagar från den tidsstämpeln:

getPastTime(5, 'Day')

Och returnerar det här resultatet: "2018-01-27T00:00:00.0000000Z"

Exempel 2

Anta att den aktuella tidsstämpeln är "2018-02-01T00:00:00.0000000Z". Det här exemplet subtraherar fem dagar och konverterar resultatet till formatet "D":

getPastTime(5, 'Day', 'D')

Och returnerar det här resultatet: "Saturday, January 27, 2018"

greater

Kontrollera om det första värdet är större än det andra värdet. Returnera sant när det första värdet är mer eller returnera falskt när det är mindre.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om större än det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är större än det andra värdet. Returnera false när det första värdet är lika med eller mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större än det andra värdet:

greater(10, 5)
greater('apple', 'banana')

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

greaterOrEquals

Kontrollera om det första värdet är större än eller lika med det andra värdet. Returnera sant när det första värdet är större eller lika med eller returnerar falskt när det första värdet är mindre.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om det är större än eller lika med det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är större än eller lika med det andra värdet. Returnera false när det första värdet är mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större eller lika med det andra värdet:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

guid

Generera en globalt unik identifierare (GUID) som en sträng, till exempel "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Du kan också ange ett annat format för GUID än standardformatet "D", som är 32 siffror avgränsade med bindestreck.

guid('<format>')

Parameter	Obligatoriskt	Type	Beskrivning
<format>	Nej	String	En enskild formatspecificerare för det returnerade GUID:t. Som standard är formatet "D", men du kan använda "N", "D", "B", "P" eller "X".

Returvärde	Typ	Beskrivning
<GUID-värde>	String	Ett slumpmässigt genererat GUID

Exempel

Det här exemplet genererar samma GUID, men som 32 siffror avgränsade med bindestreck och omges av parenteser:

guid('P')

Och returnerar det här resultatet: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde. Parametrar utvärderas från vänster till höger.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parameter	Obligatoriskt	Type	Beskrivning
<uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras
<valueIfTrue>	Ja	Alla	Värdet som ska returneras när uttrycket är sant
<valueIfFalse>	Ja	Alla	Värdet som ska returneras när uttrycket är falskt

Returvärde	Typ	Beskrivning
<specified-return-value>	Alla	Det angivna värdet som returneras baserat på om uttrycket är sant eller falskt

Exempel

Det här exemplet returnerar "yes" eftersom det angivna uttrycket returnerar true. Annars returnerar "no"exemplet :

if(equals(1, 1), 'yes', 'no')

indexOf

Returnera startpositionen eller indexvärdet för en delsträng. Den här funktionen är inte skiftlägeskänslig och index börjar med talet 0.

indexOf('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att hitta
<searchText>	Ja	String	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<indexvärde>	Integer	Startpositionen eller indexvärdet för den angivna delsträngen. Om strängen inte hittas returnerar du talet -1.

Exempel

Det här exemplet hittar startindexvärdet för understrängen "world" i strängen "hello world":

indexOf('hello world', 'world')

Och returnerar det här resultatet: 6

heltal

Konvertera strängversionen för ett heltal till ett faktiskt heltalsnummer.

int('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängversionen för heltal som ska konverteras. Minimi- och maxvärdena är samma som gränserna för heltalsdatatypen.

Returvärde	Typ	Beskrivning
<integer-result>	Integer	Heltalsversionen för den angivna strängen. Minimi- och maxvärdena är samma som gränserna för heltalsdatatypen.

Exempel

Det här exemplet skapar en heltalsversion för strängen "10":

int('10')

Och returnerar det här resultatet: 10

isFloat

Returnera ett booleskt värde som anger om en sträng är ett flyttalsnummer. Som standard använder den här funktionen den invarianta kulturen för flyttalsformatet. Om du vill identifiera flyttalsnummer som representeras i andra språkspecifika format kan du ange en RFC 4646-språkkod.

isFloat('<string>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska undersökas
<nationella inställningar>	Nej	String	Den RFC 4646-språkkod som ska användas

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Ett booleskt värde som anger om strängen är ett flyttalsnummer

Exempel 1

Det här exemplet kontrollerar om en sträng är ett flyttalsnummer i den invarianta kulturen:

isFloat('10,000.00')

Och returnerar det här resultatet: true

Exempel 2

I det här exemplet kontrolleras om en sträng är ett flyttalsnummer i det tyska språket:

isFloat('10.000,00', 'de-DE')

Och returnerar det här resultatet: true

isInt

Returnera ett booleskt värde som anger om en sträng är ett heltal.

isInt('<string>')

Parameter	Obligatoriskt	Type	Description
<sträng>	Ja	String	Strängen som ska undersökas

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Ett booleskt värde som anger om strängen är ett heltal

Exempel

Det här exemplet kontrollerar om en sträng är ett heltal:

isInt('10')

Och returnerar det här resultatet: true

sak

När det används i en upprepande åtgärd över en matris returnerar du det aktuella objektet i matrisen under åtgärdens aktuella iteration. Du kan också hämta värdena från objektets egenskaper.

item()

Returvärde	Typ	Beskrivning
<current-array-item>	Alla	Aktuellt objekt i matrisen för åtgärdens aktuella iteration

Exempel

Det här exemplet hämtar elementet body från det aktuella meddelandet för åtgärden "Send_an_email" i en for-each-loops aktuella iteration:

item().body

objekt

Returnera det aktuella objektet från varje cykel i en for-each-loop. Använd den här funktionen i for-each-loopen.

items('<loopName>')

Parameter	Obligatoriskt	Type	Beskrivning
<loopName>	Ja	String	Namnet på for-each-loopen

Returvärde	Typ	Beskrivning
<sak>	Alla	Objektet från den aktuella cykeln i den angivna for-each-loopen

Exempel

Det här exemplet hämtar det aktuella objektet från den angivna for-each-loopen:

items('myForEachLoopName')

iterationIndexes

Returnera indexvärdet för den aktuella iterationen i en Until-loop. Du kan använda den här funktionen i kapslade Until-loopar.

iterationIndexes('<loopName>')

Parameter	Obligatoriskt	Type	Beskrivning
<loopName>	Ja	String	Namnet på Until-loopen

Returvärde	Typ	Beskrivning
<index>	Integer	Indexvärdet för den aktuella iterationen i den angivna Until-loopen

Exempel

Det här exemplet skapar en räknarvariabel och ökar variabeln med en under varje iteration i en Until-loop tills räknarvärdet når fem. Exemplet skapar också en variabel som spårar det aktuella indexet för varje iteration. Under varje iteration i Until-loopen ökar exemplet räknarvärdet och tilldelar sedan räknarvärdet till det aktuella indexvärdet och ökar sedan räknarvärdet. I loopen refererar det här exemplet till det aktuella iterationsindexet iterationIndexes med hjälp av funktionen:

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

Returnera JSON-typvärdet (JavaScript Object Notation), objektet eller matrisen med objekt för en sträng eller XML.

json('<value>')
json(xml('value'))

Viktigt!

Utan ett XML-schema som definierar utdatastrukturen kan funktionen returnera resultat där strukturen skiljer sig avsevärt från det förväntade formatet, beroende på indata.

Det här beteendet gör den här funktionen olämplig för scenarier där utdata måste överensstämma med ett väldefinierat kontrakt, till exempel i kritiska affärssystem eller lösningar.

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Sträng eller XML	Strängen eller XML som ska konverteras

Returvärde	Typ	Beskrivning
<JSON-resultat>	Inbyggd JSON-typ, objekt eller matris	Det interna JSON-typvärdet, -objektet eller matrisen med objekt från indatasträngen eller XML. – Om du skickar in XML som har ett enda underordnat element i rotelementet returnerar funktionen ett enda JSON-objekt för det underordnade elementet. – Om du skickar in XML som har flera underordnade element i rotelementet returnerar funktionen en matris som innehåller JSON-objekt för dessa underordnade element. – Om strängen är null returnerar funktionen ett tomt objekt.

Exempel 1

Det här exemplet konverterar den här strängen till ett JSON-värde:

json('[1, 2, 3]')

Och returnerar det här resultatet: [1, 2, 3]

Exempel 2

I det här exemplet konverteras strängen till JSON:

json('{"fullName": "Sophia Owen"}')

Och returnerar det här resultatet:

{
  "fullName": "Sophia Owen"
}

Exempel 3

I det json() här exemplet används funktionerna och xml() för att konvertera XML som har ett enda underordnat element i rotelementet till ett JSON-objekt med namnet person för det underordnade elementet:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Och returnerar det här resultatet:

{
   "?xml": { 
      "@version": "1.0" 
   },
   "root": {
      "person": {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      }
   }
}

Exempel 4

I det json() här exemplet används funktionerna och xml() för att konvertera XML som har flera underordnade element i rotelementet till en matris med namnet person som innehåller JSON-objekt för dessa underordnade element:

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>'))

Och returnerar det här resultatet:

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

vägkorsning

Returnera en samling som bara har de vanliga objekten i de angivna samlingarna. För att visas i resultatet måste ett objekt visas i alla samlingar som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>, ...	Ja	Matris eller objekt, men inte båda	Samlingarna där du bara vill ha de vanliga objekten

Returvärde	Typ	Beskrivning
<common-items>	Matris eller objekt, respektive	En samling som bara har de vanliga objekten i de angivna samlingarna

Exempel

Det här exemplet hittar de vanliga objekten i dessa matriser:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Och returnerar en matris med endast följande objekt: [1, 2]

anslut

Returnera en sträng som innehåller alla objekt från en matris och där varje tecken avgränsas med en avgränsare.

join([<collection>], '<delimiter>')

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Matrisen som har de objekt som ska kopplas
<avgränsare>	Ja	String	Avgränsaren som visas mellan varje tecken i den resulterande strängen

Returvärde	Typ	Beskrivning
<char1><avgränsare><char2><avgränsare...>	String	Den resulterande strängen som skapats från alla objekt i den angivna matrisen. Obs! Längden på resultatet får inte överstiga 104 857 600 tecken.

Exempel

I det här exemplet skapas en sträng från alla objekt i den här matrisen med det angivna tecknet som avgränsare:

join(createArray('a', 'b', 'c'), '.')

Och returnerar det här resultatet: "a.b.c"

L

senaste

Returnera det sista objektet från en samling.

last('<collection>')
last([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen där du hittar det sista objektet

Returvärde	Typ	Beskrivning
<last-collection-item>	Sträng eller matris, respektive	Det sista objektet i samlingen

Exempel

De här exemplen hittar det sista objektet i dessa samlingar:

last('abcd')
last(createArray(0, 1, 2, 3))

Och returnerar följande resultat:

Första exemplet: "d"
Andra exemplet: 3

lastIndexOf

Returnera startpositionen eller indexvärdet för den sista förekomsten av en delsträng. Den här funktionen är inte skiftlägeskänslig och index börjar med talet 0.

lastIndexOf('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att hitta
<searchText>	Ja	String	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<ending-index-value>	Integer	Startpositionen eller indexvärdet för den senaste förekomsten av den angivna delsträngen.

Om sträng- eller delsträngsvärdet är tomt inträffar följande beteende:

Om endast strängvärdet är tomt returnerar -1funktionen .
Om både sträng- och delsträngsvärdena är tomma returnerar 0funktionen .
Om endast delsträngsvärdet är tomt returnerar funktionen stränglängden minus 1.

Exempel

Det här exemplet hittar startindexvärdet för den senaste förekomsten av delsträngsundersträngen world i strängen hello world hello world. Det returnerade resultatet är 18:

lastIndexOf('hello world hello world', 'world')

Det här exemplet saknar parametern substring och returnerar ett värde för 22 eftersom värdet för indatasträngen (23) minus 1 är större än 0.

lastIndexOf('hello world hello world', '')

längd

Returnera antalet objekt i en samling.

length('<collection>')
length([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen med de objekt som ska räknas

Returvärde	Typ	Beskrivning
<längd eller antal>	Integer	Antalet objekt i samlingen

Exempel

I de här exemplen räknas antalet objekt i dessa samlingar:

length('abcd')
length(createArray(0, 1, 2, 3))

Och returnera det här resultatet: 4

less

Kontrollera om det första värdet är mindre än det andra värdet. Returnera sant när det första värdet är mindre eller returnera falskt när det första värdet är mer.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är mindre än det andra värdet. Returnera false när det första värdet är lika med eller större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre än det andra värdet.

less(5, 10)
less('banana', 'apple')

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

lessOrEquals

Kontrollera om det första värdet är mindre än eller lika med det andra värdet. Returnera sant när det första värdet är mindre än eller lika med, eller returnera falskt när det första värdet är mer.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än eller lika med det andra värdet
<compareTo>	Ja	Heltal, flyttal respektive sträng	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när det första värdet är mindre än eller lika med det andra värdet. Returnera false när det första värdet är större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre eller lika med det andra värdet.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Och returnera dessa resultat:

Första exemplet: true
Andra exemplet: false

listCallbackUrl

Returnera den "motringnings-URL" som anropar en utlösare eller åtgärd. Den här funktionen fungerar bara med utlösare och åtgärder för anslutningstyperna HttpWebhook och ApiConnectionWebhook , men inte typerna Manuell, Återkommande, HTTP och APIConnection .

listCallbackUrl()

Returvärde	Typ	Beskrivning
<callback-URL>	String	Motringnings-URL:en för en utlösare eller åtgärd

Exempel

Det här exemplet visar ett exempel på motringnings-URL som den här funktionen kan returnera:

"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

Returnera det högsta värdet från en lista eller matris med tal som är inkluderande i båda ändar.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Heltal, flyttal eller båda	Den uppsättning tal som du vill ha det högsta värdet från
[<number1>, <number2>, ...]	Ja	Matris – heltal, flyttal eller båda	Matrisen med tal som du vill ha det högsta värdet från

Returvärde	Typ	Beskrivning
<max-value>	Heltal eller flyttal	Det högsta värdet i den angivna matrisen eller uppsättningen med tal

Exempel

De här exemplen får det högsta värdet från uppsättningen tal och matrisen:

max(1, 2, 3)
max(createArray(1, 2, 3))

Och returnera det här resultatet: 3

min

Returnera det lägsta värdet från en uppsättning tal eller en matris.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Heltal, flyttal eller båda	Den uppsättning tal som du vill ha det lägsta värdet från
[<number1>, <number2>, ...]	Ja	Matris – heltal, flyttal eller båda	Matrisen med tal som du vill ha det lägsta värdet från

Returvärde	Typ	Beskrivning
<min-value>	Heltal eller flyttal	Det lägsta värdet i den angivna uppsättningen tal eller angiven matris

Exempel

De här exemplen får det lägsta värdet i uppsättningen tal och matrisen:

min(1, 2, 3)
min(createArray(1, 2, 3))

Och returnera det här resultatet: 1

mod

Returnera resten från att dela upp två tal. Information om hur du hämtar heltalsresultatet finns i div().

mod(<dividend>, <divisor>)

Parameter	Obligatoriskt	Type	Beskrivning
<utdelning>	Ja	Heltal eller flyttal	Talet som ska divideras med divisorn
<divisor>	Ja	Heltal eller flyttal	Talet som delar upp utdelningen, men som inte får vara noll

Returvärde	Typ	Beskrivning
<modulo-result>	Heltal eller flyttal	Resten från att dividera det första talet med det andra talet

Exempel 1

I det här exemplet delas det första talet med det andra talet:

mod(3, 2)

Och returnerar det här resultatet: 1

Exempel 2

Det här exemplet visar att om ett eller båda värdena är negativa matchar resultatet tecknet för utdelningen:

mod(-5, 2)
mod(4, -3)

Exemplet returnerar följande resultat:

Första exemplet: -1
Andra exemplet: 1

mul

Returnera produkten från att multiplicera två tal.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Obligatoriskt	Type	Beskrivning
<multiplicand1>	Ja	Heltal eller flyttal	Talet som ska multipliceras med multiplicand2
<multiplicand2>	Ja	Heltal eller flyttal	Talet som multiplicand1 multiplicand1

Returvärde	Typ	Beskrivning
<produktresultat>	Heltal eller flyttal	Produkten från att multiplicera det första talet med det andra talet

Exempel

De här exemplen multipel det första talet med det andra talet:

mul(1, 2)
mul(1.5, 2)

Och returnera dessa resultat:

Första exemplet: 2
Andra exemplet 3

multipartBody

Returnera brödtexten för en viss del i en åtgärds utdata som har flera delar.

multipartBody('<actionName>', <index>)

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Namnet på åtgärden som har utdata med flera delar
<index>	Ja	Integer	Indexvärdet för den del som du vill ha

Returvärde	Typ	Beskrivning
<brödtext>	String	Brödtexten för den angivna delen

N

not

Kontrollera om ett uttryck är falskt. Returnera sant när uttrycket är falskt eller returnera falskt när det är sant.

not(<expression>)

Parameter	Obligatoriskt	Type	Beskrivning
<uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när uttrycket är falskt. Returnera false när uttrycket är sant.

Exempel 1

De här exemplen kontrollerar om de angivna uttrycken är falska:

not(false)
not(true)

Och returnera dessa resultat:

Första exemplet: Uttrycket är falskt, så funktionen returnerar true.
Andra exemplet: Uttrycket är sant, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken är falska:

not(equals(1, 2))
not(equals(1, 1))

Och returnera dessa resultat:

Första exemplet: Uttrycket är falskt, så funktionen returnerar true.
Andra exemplet: Uttrycket är sant, så funktionen returnerar false.

nthIndexOf

Returnera startpositionen eller indexvärdet där den n:e förekomsten av en delsträng visas i en sträng.

nthIndexOf('<text>', '<searchText>', <occurrence>)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som innehåller delsträngen som ska hittas
<searchText>	Ja	String	Delsträngen som ska hittas
<förekomst>	Ja	Integer	Ett tal som anger den n:e förekomsten av delsträngen som ska hittas. Om förekomsten är negativ börjar du söka från slutet.

Returvärde	Typ	Beskrivning
<indexvärde>	Integer	Startpositionen eller indexvärdet för den n:e förekomsten av den angivna delsträngen. Om delsträngen inte hittas eller om det finns färre än n förekomster av delsträngen returnerar du `-1`.

Exempel

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

eller

Kontrollera om minst ett uttryck är sant. Returnera sant när minst ett uttryck är sant eller returnera falskt när alla är falska.

or(<expression1>, <expression2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>, ...	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när minst ett uttryck är sant. Returnera false när alla uttryck är falska.

Exempel 1

De här exemplen kontrollerar om minst ett uttryck är sant:

or(true, false)
or(false, false)

Och returnera dessa resultat:

Första exemplet: Minst ett uttryck är sant, så funktionen returnerar true.
Andra exemplet: Båda uttrycken är falska, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om minst ett uttryck är sant:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Och returnera dessa resultat:

Första exemplet: Minst ett uttryck är sant, så funktionen returnerar true.
Andra exemplet: Båda uttrycken är falska, så funktionen returnerar false.

Utgångar

Returnera en åtgärds utdata vid körning.

outputs('<actionName>')

Parameter	Obligatoriskt	Type	Beskrivning
<actionName>	Ja	String	Namnet på åtgärdens utdata som du vill använda

Returvärde	Typ	Beskrivning
<utdata>	String	Utdata från den angivna åtgärden

Exempel

Det här exemplet hämtar utdata från X-åtgärden Get user:

outputs('Get_user')

Och returnerar det här resultatet:

{
  "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

parametrar

Returnera värdet för en parameter som beskrivs i arbetsflödesdefinitionen.

parameters('<parameterName>')

Parameter	Obligatoriskt	Type	Beskrivning
<parameterName>	Ja	String	Namnet på parametern vars värde du vill ha

Returvärde	Typ	Beskrivning
<parameter-value>	Alla	Värdet för den angivna parametern

Exempel

Anta att du har det här JSON-värdet:

{
  "fullName": "Sophia Owen"
}

Det här exemplet hämtar värdet för den angivna parametern:

parameters('fullName')

Och returnerar det här resultatet: "Sophia Owen"

parseDateTime

Returnera tidsstämpeln från en sträng som innehåller en tidsstämpel.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<nationella inställningar>	Nej	String	Språkvarianten som ska användas. Om det inte anges är `en-us`standardspråket . Om nationella inställningar inte är ett giltigt värde genereras ett fel.
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte har angetts försöker du parsa med flera format som är kompatibla med det angivna språket. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<parsad tidsstämpel>	String	Den parsade tidsstämpeln i formatet "o" (åååå-MM-ddTHH:mm:ss.fffffffK) som uppfyller ISO 8601 och bevarar tidszonsinformation.

Exempel

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

Returnera ett slumpmässigt heltal från ett angivet intervall, som endast är inkluderande i startänden.

rand(<minValue>, <maxValue>)

Parameter	Obligatoriskt	Type	Beskrivning
<minValue>	Ja	Integer	Det lägsta heltalet i intervallet
<maxValue>	Ja	Integer	Det heltal som följer det högsta heltalet i intervallet som funktionen kan returnera

Returvärde	Typ	Beskrivning
<slumpmässigt resultat>	Integer	Det slumpmässiga heltal som returneras från det angivna intervallet

Exempel

Det här exemplet hämtar ett slumpmässigt heltal från det angivna intervallet, exklusive det maximala värdet:

rand(1, 5)

Och returnerar ett av dessa tal som resultat: 1, 2, 3eller 4

intervall

Returnera en heltalsmatris som startar från ett angivet heltal.

range(<startIndex>, <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<startIndex>	Ja	Integer	Ett heltalsvärde som startar matrisen som det första objektet
<antal>	Ja	Integer	Antalet heltal i matrisen. Parametervärdet `count` måste vara ett positivt heltal som inte överstiger 100 000. Obs! Summan av `startIndex` värdena och `count` får inte överstiga 2 147 483 647.

Returvärde	Typ	Beskrivning
[<intervallresultat>]	Matris	Matrisen med heltal från det angivna indexet

Exempel

Det här exemplet skapar en heltalsmatris som startar från det angivna indexet och har det angivna antalet heltal:

range(1, 4)

Och returnerar det här resultatet: [1, 2, 3, 4]

removeProperty

Ta bort en egenskap från ett objekt och returnera det uppdaterade objektet. Om egenskapen som du försöker ta bort inte finns returnerar funktionen det ursprungliga objektet.

removeProperty(<object>, '<property>')

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet där du vill ta bort en egenskap
<egenskap>	Ja	String	Namnet på egenskapen som ska tas bort

Returvärde	Typ	Beskrivning
<updated-object>	Objekt	Det uppdaterade JSON-objektet utan den angivna egenskapen

Om du vill ta bort en underordnad egenskap från en befintlig egenskap använder du den här syntaxen:

removeProperty(<object>['<parent-property>'], '<child-property>')

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet vars egenskap du vill ta bort
<parent-property>	Ja	String	Namnet på den överordnade egenskapen med den underordnade egenskapen som du vill ta bort
<underordnad egenskap>	Ja	String	Namnet på den underordnade egenskapen som ska tas bort

Returvärde	Typ	Beskrivning
<updated-object>	Objekt	Det uppdaterade JSON-objektet vars underordnade egenskap som du tog bort

Exempel 1

Det här exemplet tar bort middleName egenskapen från ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON() och returnerar det uppdaterade objektet:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

Här är det aktuella JSON-objektet:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Här är det uppdaterade JSON-objektet:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Exempel 2

Det här exemplet tar bort den middleName underordnade egenskapen från en customerName överordnad egenskap i ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON() och returnerar det uppdaterade objektet:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

Här är det aktuella JSON-objektet:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

Här är det uppdaterade JSON-objektet:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

ersätt

Ersätt en delsträng med den angivna strängen och returnera resultatsträngen. Den här funktionen är skiftlägeskänslig.

replace('<text>', '<oldText>', '<newText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har delsträngen att ersätta
<oldText>	Ja	String	Delsträngen som ska ersättas
<newText>	Ja	String	Ersättningssträngen

Returvärde	Typ	Beskrivning
<updated-text>	String	Den uppdaterade strängen efter att du har ersatt delsträngen Om delsträngen inte hittas returnerar du den ursprungliga strängen.

Exempel

Det här exemplet hittar den "gamla" delsträngen i "den gamla strängen" och ersätter "gammal" med "ny":

replace('the old string', 'old', 'new')

Och returnerar det här resultatet: "the new string"

resultat

Returnera resultaten från åtgärderna på den översta nivån i den angivna omfångsåtgärden, till exempel en For_each, Untileller Scope -åtgärd. Funktionen result() accepterar en enskild parameter, som är omfångets namn, och returnerar en matris som innehåller information från åtgärderna på den första nivån i omfånget. Dessa åtgärdsobjekt innehåller samma attribut som attributen som returneras av actions() funktionen, till exempel åtgärdens starttid, sluttid, status, indata, korrelations-ID och utdata.

Kommentar

Den här funktionen returnerar endast information från åtgärder på första nivån i den begränsade åtgärden och inte från djupare kapslade åtgärder, till exempel växel- eller villkorsåtgärder.

Du kan till exempel använda den här funktionen för att hämta resultatet från misslyckade åtgärder så att du kan diagnostisera och hantera undantag. Mer information finns i Hämta kontext och resultat för fel.

result('<scopedActionName>')

Parameter	Obligatoriskt	Type	Beskrivning
<scopedActionName>	Ja	String	Namnet på den begränsade åtgärden där du vill ha indata och utdata från åtgärderna på den översta nivån i omfånget

Returvärde	Typ	Beskrivning
<array-object>	Matrisobjekt	En matris som innehåller matriser med indata och utdata från varje åtgärd på den översta nivån i det angivna omfånget

Exempel

Det här exemplet returnerar indata och utdata från varje iteration av en HTTP-åtgärd inuti som finns i en For_each loop med hjälp result() av funktionen i Compose åtgärden:

{
   "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"
      }
   }
}

Så här kan den exempelreturerade matrisen se ut där det yttre outputs objektet innehåller indata och utdata från varje iteration av åtgärderna i For_each åtgärden.

[
   {
      "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"
            }
         }
      ]
   }
]

omvänd

Ändra ordningen på objekt i en samling. När du använder den här funktionen med sort()kan du sortera en samling i fallande ordning.

reverse([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Samlingen som ska vändas

Returvärde	Typ	Beskrivning
[<updated-collection>]	Matris	Den omvända samlingen

Exempel

I det här exemplet återförs en matris med heltal:

reverse(createArray(0, 1, 2, 3))

Och returnerar den här matrisen: [3,2,1,0]

S

setProperty

Ange värdet för JSON-objektets egenskap och returnera det uppdaterade objektet. Om egenskapen som du försöker ange inte finns läggs egenskapen till i objektet. Om du vill lägga till en ny egenskap använder du funktionen addProperty().

setProperty(<object>, '<property>', <value>)

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet vars egenskap du vill ange
<egenskap>	Ja	String	Namnet på den befintliga eller nya egenskapen som ska anges
<värde>	Ja	Alla	Värdet som ska anges för den angivna egenskapen

Om du vill ange den underordnade egenskapen i ett underordnat objekt använder du ett kapslat setProperty() anrop i stället. Annars returnerar funktionen endast det underordnade objektet som utdata.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

Parameter	Obligatoriskt	Type	Beskrivning
<objekt>	Ja	Objekt	JSON-objektet vars egenskap du vill ange
<parent-property>	Ja	String	Namnet på den överordnade egenskapen med den underordnade egenskapen som du vill ange
<underordnad egenskap>	Ja	String	Namnet på den underordnade egenskapen som ska anges
<värde>	Ja	Alla	Värdet som ska anges för den angivna egenskapen

Returvärde	Typ	Beskrivning
<updated-object>	Objekt	Det uppdaterade JSON-objektet vars egenskap du anger

Exempel 1

I det surName här exemplet anges egenskapen i ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON(). Funktionen tilldelar det angivna värdet till egenskapen och returnerar det uppdaterade objektet:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

Här är det aktuella JSON-objektet:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Här är det uppdaterade JSON-objektet:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

Exempel 2

I det här exemplet anges den surName underordnade egenskapen för den customerName överordnade egenskapen i ett JSON-objekt, som konverteras från en sträng till JSON med hjälp av funktionen JSON(). Funktionen tilldelar det angivna värdet till egenskapen och returnerar det uppdaterade objektet:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

Här är det aktuella JSON-objektet:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

Här är det uppdaterade JSON-objektet:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

hoppa över

Ta bort objekt från framsidan av en samling och returnera alla andra objekt.

skip([<collection>], <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Samlingen vars objekt du vill ta bort
<antal>	Ja	Integer	Ett positivt heltal för antalet objekt att ta bort längst fram

Returvärde	Typ	Beskrivning
[<updated-collection>]	Matris	Den uppdaterade samlingen efter att de angivna objekten har tagits bort

Exempel

Det här exemplet tar bort ett objekt, talet 0, från den angivna matrisens framsida:

skip(createArray(0, 1, 2, 3), 1)

Och returnerar den här matrisen med de återstående objekten: [1,2,3]

sektor

Returnera en delsträng genom att ange start- och slutpositionen eller värdet. Se även substring().

slice('<text>', <startIndex>, <endIndex>?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som innehåller delsträngen som ska hittas
<startIndex>	Ja	Integer	Den nollbaserade startpositionen eller värdet för var du ska börja söka efter delsträngen – Om startIndex är större än stränglängden returnerar du en tom sträng. – Om startIndex är negativt börjar du söka efter indexvärdet som är summan av stränglängden och startIndex.
<endIndex>	Nej	Integer	Den nollbaserade slutpositionen eller värdet för var du ska sluta söka efter delsträngen. Tecknet som finns vid det avslutande indexvärdet ingår inte i sökningen. – Om endIndex inte har angetts eller är större än stränglängden söker du upp till slutet av strängen. – Om endIndex är negativt slutar du söka efter indexvärdet som summan av stränglängden och endIndex.

Returvärde	Typ	Beskrivning
<segmentresultat>	String	En ny sträng som innehåller den hittade delsträngen

Exempel

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 ''.

sortera

Sortera objekt i en samling. Du kan sortera samlingsobjekten med valfri nyckel som innehåller en enkel typ.

sort([<collection>], <sortBy>?)

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Matris	Samlingen med de objekt som ska sorteras
<sortBy>	Nej	String	Nyckeln som ska användas för att sortera samlingsobjekten

Returvärde	Typ	Beskrivning
[<updated-collection>]	Matris	Den sorterade samlingen

Exempel 1

I det här exemplet sorteras en matris med heltal:

sort(createArray(2, 1, 0, 3))

Och returnerar den här matrisen: [0,1,2,3]

Exempel 2

I det här exemplet sorteras en matris med objekt efter nyckel:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

Och returnerar den här matrisen: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

dela

Returnera en matris som innehåller delsträngar, avgränsade med kommatecken, baserat på det angivna avgränsartecknet i den ursprungliga strängen.

split('<text>', '<delimiter>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska delas upp i delsträngar baserat på den angivna avgränsaren i den ursprungliga strängen
<avgränsare>	Ja	String	Tecknet i den ursprungliga strängen som ska användas som avgränsare

Returvärde	Typ	Beskrivning
[<substring1,substring2><>,...]	Matris	En matris som innehåller delsträngar från den ursprungliga strängen, avgränsad med kommatecken

Exempel 1

I det här exemplet skapas en matris med delsträngar från den angivna strängen baserat på det angivna tecknet som avgränsare:

split('a_b_c', '_')

Och returnerar den här matrisen som resultat: ["a","b","c"]

Exempel 2

Det här exemplet skapar en matris med ett enda element när det inte finns någon avgränsare i strängen:

split('a_b_c', ' ')

Och returnerar den här matrisen som resultat: ["a_b_c"]

startOfDay

Returnera dagens start för en tidsstämpel.

startOfDay('<timestamp>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar med nolltimmesmarkeringen för dagen

Exempel

Det här exemplet hittar dagens start för den här tidsstämpeln:

startOfDay('2018-03-15T13:30:30Z')

Och returnerar det här resultatet: "2018-03-15T00:00:00.0000000Z"

startOfHour

Returnera timmens start för en tidsstämpel.

startOfHour('<timestamp>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar med nollminutersmarkeringen för timmen

Exempel

Det här exemplet hittar timmens början för den här tidsstämpeln:

startOfHour('2018-03-15T13:30:30Z')

Och returnerar det här resultatet: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Returnera början av månaden för en tidsstämpel.

startOfMonth('<timestamp>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Den angivna tidsstämpeln men börjar den första dagen i månaden vid nolltimmesmarkeringen

Exempel 1

Det här exemplet returnerar början av månaden för den här tidsstämpeln:

startOfMonth('2018-03-15T13:30:30Z')

Och returnerar det här resultatet: "2018-03-01T00:00:00.0000000Z"

Exempel 2

Det här exemplet returnerar början av månaden i det angivna formatet för den här tidsstämpeln:

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

Och returnerar det här resultatet: "2018-03-01"

startsWith

Kontrollera om en sträng börjar med en specifik delsträng. Returnera sant när delsträngen hittas eller returnera falskt när den inte hittas. Den här funktionen är inte skiftlägeskänslig.

startsWith('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska kontrolleras
<searchText>	Ja	String	Den startsträng som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera sant när startundersträngen hittas. Returnera falskt när det inte hittas.

Exempel 1

Det här exemplet kontrollerar om "hello world"-strängen börjar med understrängen "hello":

startsWith('hello world', 'hello')

Och returnerar det här resultatet: true

Exempel 2

Det här exemplet kontrollerar om "hello world"-strängen börjar med understrängen "greetings":

startsWith('hello world', 'greetings')

Och returnerar det här resultatet: false

sträng

Returnera strängversionen för ett värde.

string(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	Alla	Värdet som ska konverteras. Om det här värdet är null eller utvärderas till null konverteras värdet till ett tomt strängvärde (`""`). Om du till exempel tilldelar en strängvariabel till en egenskap som inte finns, som du kan komma åt med operatorn `?` , konverteras null-värdet till en tom sträng. Att jämföra ett null-värde är dock inte detsamma som att jämföra en tom sträng.

Returvärde	Typ	Beskrivning
<string-value>	String	Strängversionen för det angivna värdet. Om värdeparametern är null eller utvärderas till null returneras det här värdet som ett tomt strängvärde (`""`).

Exempel 1

I det här exemplet skapas strängversionen för det här numret:

string(10)

Och returnerar det här resultatet: "10"

Exempel 2

Det här exemplet skapar en sträng för det angivna JSON-objektet och använder omvänt snedstreck (\) som ett escape-tecken för det dubbla citattecknet (").

string( { "name": "Sophie Owen" } )

Och returnerar det här resultatet: "{ \\"name\\": \\"Sophie Owen\\" }"

under

Returnera resultatet från att subtrahera det andra talet från det första talet.

sub(<minuend>, <subtrahend>)

Parameter	Obligatoriskt	Type	Beskrivning
<minuend>	Ja	Heltal eller flyttal	Talet som subtrakten ska subtraheras från
<subtrahend>	Ja	Heltal eller flyttal	Talet som ska subtraheras från minuend

Returvärde	Typ	Description
<resultat>	Heltal eller flyttal	Resultatet från att subtrahera det andra talet från det första talet

Exempel

Det här exemplet subtraherar det andra talet från det första talet:

sub(10.3, .3)

Och returnerar det här resultatet: 10

Delsträng

Returnera tecken från en sträng, med början från den angivna positionen eller indexet. Indexvärden börjar med talet 0. Se även slice().

substring('<text>', <startIndex>, <length>)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen vars tecken du vill ha
<startIndex>	Ja	Integer	Ett positivt tal som är lika med eller större än 0 som du vill använda som startposition eller indexvärde
<length>	Nej	Integer	Ett positivt antal tecken som du vill använda i understrängen

Kommentar

Kontrollera att summan från att lägga till parametervärdena startIndex och längd är mindre än längden på strängen som du anger för textparametern . Annars får du ett fel, till skillnad från liknande funktioner på andra språk där resultatet är delsträngen från startIndex till slutet av strängen. Längdparametern är valfri och om den inte anges tar funktionen substring() alla tecken från startIndex till slutet av strängen.

Returvärde	Typ	Beskrivning
<substring-result>	String	En delsträng med det angivna antalet tecken, med början vid den angivna indexpositionen i källsträngen

Exempel

I det här exemplet skapas en delsträng med fem tecken från den angivna strängen, med början från indexvärdet 6:

substring('hello world', 6, 5)

Och returnerar det här resultatet: "world"

subtractFromTime

Subtrahera ett antal tidsenheter från en tidsstämpel. Se även getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen som innehåller tidsstämpeln
<interval>	Ja	Integer	Antalet angivna tidsenheter som ska subtraheras
<timeUnit>	Ja	String	Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<updated-timestamp>	String	Tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Det här exemplet subtraherar en dag från den här tidsstämpeln:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

Och returnerar det här resultatet: "2018-01-01T00:00:00.0000000Z"

Exempel 2

Det här exemplet subtraherar en dag från den här tidsstämpeln:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

Och returnerar det här resultatet med det valfria D-formatet: "Monday, January, 1, 2018"

T

ta

Returnera objekt från framsidan av en samling.

take('<collection>', <count>)
take([<collection>], <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<samling>	Ja	Sträng eller matris	Samlingen vars objekt du vill ha
<antal>	Ja	Integer	Ett positivt heltal för det antal objekt som du vill använda framifrån

Returvärde	Typ	Beskrivning
<delmängd eller [<delmängd>]>	Sträng eller matris, respektive	En sträng eller matris som har det angivna antalet objekt som tagits framifrån den ursprungliga samlingen

Exempel

I de här exemplen hämtas det angivna antalet objekt längst fram i dessa samlingar:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Och returnera dessa resultat:

Första exemplet: "abc"
Andra exemplet: [0, 1, 2]

Fästingar

Returnerar antalet tick, som är 100 nanosekunders intervall, sedan den 1 januari 0001 12:00:00 midnatt (eller DateTime.Ticks i C#) upp till den angivna tidsstämpeln. Mer information finns i det här avsnittet: DateTime.Ticks Property (System).

ticks('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	String	Strängen för en tidsstämpel

Returvärde	Typ	Beskrivning
<ticks-number>	Integer	Antalet fästingar sedan den angivna tidsstämpeln

toLower

Returnera en sträng i gemener. Om ett tecken i strängen inte har en gemen version förblir det tecknet oförändrat i den returnerade strängen.

toLower('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska returneras i gemener

Returvärde	Typ	Beskrivning
<gemener-text>	String	Den ursprungliga strängen i gemener

Exempel

I det här exemplet konverteras strängen till gemener:

toLower('Hello World')

Och returnerar det här resultatet: "hello world"

toUpper

Returnera en sträng i versaler. Om ett tecken i strängen inte har en versalversion förblir det tecknet oförändrat i den returnerade strängen.

toUpper('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som ska returneras i versaler

Returvärde	Typ	Beskrivning
<versaler-text>	String	Den ursprungliga strängen i versaler

Exempel

I det här exemplet konverteras strängen till versaler:

toUpper('Hello World')

Och returnerar det här resultatet: "HELLO WORLD"

utlösare

Returnera en utlösares utdata vid körning, eller värden från andra JSON-namn-och-värde-par, som du kan tilldela till ett uttryck.

I en utlösares indata returnerar den här funktionen utdata från föregående körning.
I en utlösares villkor returnerar den här funktionen utdata från den aktuella körningen.

Som standard refererar funktionen till hela utlösarobjektet, men du kan också ange en egenskap vars värde du vill använda. Den här funktionen har även tillgängliga shorthand-versioner, se triggerOutputs() och triggerBody().

trigger()

Returvärde	Typ	Beskrivning
<trigger-output>	String	Utdata från en utlösare vid körning

triggerBody

Returnera en utlösares body utdata vid körning. Förkortning för trigger().outputs.body. Se trigger().

triggerBody()

Returvärde	Typ	Beskrivning
<trigger-body-output>	String	Utdata `body` från utlösaren

triggerFormDataMultiValues

Returnera en matris med värden som matchar ett nyckelnamn i en utlösares formulärdata eller formulärkodade utdata.

triggerFormDataMultiValues('<key>')

Parameter	Obligatoriskt	Type	Beskrivning
<nyckel>	Ja	String	Namnet på nyckeln vars värde du vill ha

Returvärde	Typ	Beskrivning
[<matris-med-nyckel-värden>]	Matris	En matris med alla värden som matchar den angivna nyckeln

Exempel

I det här exemplet skapas en matris från nyckelvärdet "feedUrl" i en RSS-utlösares formulärdata- eller formulärkodade utdata:

triggerFormDataMultiValues('feedUrl')

Och returnerar den här matrisen som ett exempelresultat: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Returnera en sträng med ett enda värde som matchar ett nyckelnamn i utlösarens formulärdata eller formulärkodade utdata. Om funktionen hittar fler än en matchning utlöser funktionen ett fel.

triggerFormDataValue('<key>')

Parameter	Obligatoriskt	Type	Beskrivning
<nyckel>	Ja	String	Namnet på nyckeln vars värde du vill ha

Returvärde	Typ	Beskrivning
<nyckelvärde>	String	Värdet i den angivna nyckeln

Exempel

I det här exemplet skapas en sträng från nyckelvärdet "feedUrl" i en RSS-utlösares formdata- eller formulärkodade utdata:

triggerFormDataValue('feedUrl')

Och returnerar den här strängen som ett exempelresultat: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Returnera brödtexten för en specifik del i en utlösarens utdata som har flera delar.

triggerMultipartBody(<index>)

Parameter	Obligatoriskt	Type	Beskrivning
<index>	Ja	Integer	Indexvärdet för den del som du vill ha

Returvärde	Typ	Beskrivning
<brödtext>	String	Brödtexten för den angivna delen i en utlösares utdata för flera delar

triggerOutputs

Returnera en utlösares utdata vid körning eller värden från andra JSON-namn-och-värde-par. Förkortning för trigger().outputs. Se trigger().

triggerOutputs()

Returvärde	Typ	Beskrivning
<trigger-output>	String	Utdata från en utlösare vid körning

trimma

Ta bort inledande och avslutande blanksteg från en sträng och returnera den uppdaterade strängen.

trim('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	String	Strängen som har det inledande och avslutande blanksteget att ta bort

Returvärde	Typ	Beskrivning
<updatedText>	String	En uppdaterad version för den ursprungliga strängen utan inledande eller avslutande blanksteg

Exempel

Det här exemplet tar bort det inledande och avslutande blanksteget från strängen " Hello World ":

trim(' Hello World  ')

Och returnerar det här resultatet: "Hello World"

U

union

Returnera en samling som innehåller alla objekt från de angivna samlingarna. För att visas i resultatet kan ett objekt visas i valfri samling som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>, ...	Ja	Matris eller objekt, men inte båda	Samlingarna där du vill ha alla objekt

Returvärde	Typ	Beskrivning
<updatedCollection>	Matris eller objekt, respektive	En samling med alla objekt från de angivna samlingarna – inga dubbletter

Exempel

Det här exemplet hämtar alla objekt från dessa samlingar:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Och returnerar det här resultatet: [1, 2, 3, 10, 101]

uriComponent

Returnera en URI-kodad version (uniform resource identifier) för en sträng genom att ersätta URL-osäkra tecken med escape-tecken. Använd den här funktionen i stället för encodeUriComponent(). Även om båda funktionerna fungerar på samma sätt uriComponent() är det att föredra.

uriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen som ska konverteras till URI-kodat format

Returvärde	Typ	Beskrivning
<encoded-uri>	String	Den URI-kodade strängen med escape-tecken

Exempel

Det här exemplet skapar en URI-kodad version för den här strängen:

uriComponent('https://contoso.com')

Och returnerar det här resultatet: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Returnera den binära versionen för en URI-komponent (uniform resource identifier).

uriComponentToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den URI-kodade strängen som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-encoded-uri>	String	Den binära versionen för den URI-kodade strängen. Det binära innehållet är base64-kodat och representeras av `$content`.

Exempel

Det här exemplet skapar binärversionen för den här URI-kodade strängen:

uriComponentToBinary('https%3A%2F%2Fcontoso.com')

Och returnerar det här resultatet:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Returnera strängversionen för en URI-kodad sträng (uniform resource identifier) som effektivt avkodar den URI-kodade strängen.

uriComponentToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Den URI-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-uri>	String	Den avkodade versionen för den URI-kodade strängen

Exempel

I det här exemplet skapas den avkodade strängversionen för den här URI-kodade strängen:

uriComponentToString('https%3A%2F%2Fcontoso.com')

Och returnerar det här resultatet: "https://contoso.com"

uriHost

host Returnera värdet för en enhetlig resursidentifierare (URI).

uriHost('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `host` värde du vill ha

Returvärde	Typ	Beskrivning
<värdvärde>	String	Värdet `host` för den angivna URI:n

Exempel

Det här exemplet hittar host värdet för den här URI:n:

uriHost('https://www.localhost.com:8080')

Och returnerar det här resultatet: "www.localhost.com"

uriPath

path Returnera värdet för en enhetlig resursidentifierare (URI).

uriPath('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `path` värde du vill ha

Returvärde	Typ	Beskrivning
<path-value>	String	Värdet `path` för den angivna URI:n. Om `path` inte har något värde returnerar du tecknet "/".

Exempel

Det här exemplet hittar path värdet för den här URI:n:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar det här resultatet: "/catalog/shownew.htm"

uriPathAndQuery

path Returnera värdena och query för en enhetlig resursidentifierare (URI).

uriPathAndQuery('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `path` värden och `query` värden du vill ha

Returvärde	Typ	Beskrivning
<path-query-value>	String	Värdena `path` och `query` för den angivna URI:n. Om `path` inte anger något värde returnerar du tecknet "/".

Exempel

Det här exemplet hittar path värdena och query för den här URI:n:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar det här resultatet: "/catalog/shownew.htm?date=today"

uriPort

port Returnera värdet för en enhetlig resursidentifierare (URI).

uriPort('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `port` värde du vill ha

Returvärde	Typ	Beskrivning
<portvärde>	Integer	Värdet `port` för den angivna URI:n. Om `port` inte anger något värde returnerar du standardporten för protokollet.

Exempel

Det här exemplet returnerar port värdet för den här URI:n:

uriPort('https://www.localhost:8080')

Och returnerar det här resultatet: 8080

uriQuery

query Returnera värdet för en enhetlig resursidentifierare (URI).

uriQuery('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `query` värde du vill ha

Returvärde	Typ	Beskrivning
<query-value>	String	Värdet `query` för den angivna URI:n

Exempel

Det här exemplet returnerar query värdet för den här URI:n:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar det här resultatet: "?date=today"

uriScheme

scheme Returnera värdet för en enhetlig resursidentifierare (URI).

uriScheme('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	String	Den URI vars `scheme` värde du vill ha

Returvärde	Typ	Beskrivning
<scheme-value>	String	Värdet `scheme` för den angivna URI:n

Exempel

Det här exemplet returnerar scheme värdet för den här URI:n:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar det här resultatet: "http"

utcNow

Returnera den aktuella tidsstämpeln.

utcNow('<format>')

Du kan också ange ett annat format med formatparametern<>.

Parameter	Obligatoriskt	Type	Beskrivning
<format>	Nej	String	En numerisk formatsträng som antingen är en enskild formatspecificerare eller ett anpassat formatmönster. Standardformatet för tidsstämpeln är "o" (åå-MM-ddTHH:mm:ss.fffffffK), som uppfyller ISO 8601 och bevarar tidszonsinformation. Om formatet inte är ett giltigt värde genereras ett fel.

Returvärde	Typ	Beskrivning
<current-timestamp>	String	Aktuellt datum och tid

Exempel 1

Anta att idag är den 15 april 2018 kl. 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln:

utcNow()

Och returnerar det här resultatet: "2018-04-15T13:00:00.0000000Z"

Exempel 2

Anta att idag är den 15 april 2018 kl. 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln med det valfria D-formatet:

utcNow('D')

Och returnerar det här resultatet: "Sunday, April 15, 2018"

V

variabler

Returnera värdet för en angiven variabel.

variables('<variableName>')

Parameter	Obligatoriskt	Type	Beskrivning
<variableName>	Ja	String	Namnet på variabeln vars värde du vill ha

Returvärde	Typ	Beskrivning
<variable-value>	Alla	Värdet för den angivna variabeln

Exempel

Anta att det aktuella värdet för variabeln "numItems" är 20. Det här exemplet hämtar heltalsvärdet för den här variabeln:

variables('numItems')

Och returnerar det här resultatet: 20

O

arbetsflöde

Returnera all information om själva arbetsflödet under körningen.

workflow().<property>

Parameter	Obligatoriskt	Type	Beskrivning
<egenskap>	Nej	String	Namnet på arbetsflödesegenskapen vars värde du vill ha Som standard har ett arbetsflödesobjekt följande egenskaper: `name`, `type`, `id`, `location`, `run`och `tags`. – Egenskapsvärdet `run` är ett JSON-objekt som innehåller följande egenskaper: `name`, `type`och `id`. - Egenskapen `tags` är ett JSON-objekt som innehåller taggar som är associerade med din logikapp i Azure Logic Apps eller flöde i Power Automate och värdena för dessa taggar. Mer information om taggar i Azure-resurser finns i Tagga resurser, resursgrupper och prenumerationer för logisk organisation i Azure. Obs! Som standard har en logikapp inga taggar, men ett Power Automate-flöde har taggarna `flowDisplayName` och `environmentName` .

Exempel 1

Det här exemplet returnerar namnet på ett arbetsflödes aktuella körning:

workflow().run.name

Exempel 2

Om du använder Power Automate kan du skapa ett @workflow() uttryck som använder utdataegenskapen tags för att hämta värdena från flödets flowDisplayName eller environmentName egenskapen.

Du kan till exempel skicka anpassade e-postaviseringar från själva flödet som länkar tillbaka till ditt flöde. Dessa meddelanden kan innehålla en HTML-länk som innehåller flödets visningsnamn i e-postrubriken och följer den här syntaxen:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Returnera XML-versionen för en sträng som innehåller ett JSON-objekt.

xml('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	String	Strängen med JSON-objektet som ska konverteras JSON-objektet får bara ha en rotegenskap, som inte kan vara en matris. Använd omvänt snedstreck (\) som ett escape-tecken för det dubbla citattecknet (").

Returvärde	Typ	Beskrivning
<xml-version>	Objekt	Kodad XML för den angivna strängen eller JSON-objektet

Exempel 1

I det här exemplet konverteras strängen till XML:

xml('<name>Sophia Owen</name>')

Och returnerar den här resultat-XML:en:

<name>Sophia Owen</name>

Exempel 2

I det här exemplet skapas XML-versionen för den här strängen, som innehåller ett JSON-objekt:

xml(json('{ "name": "Sophia Owen" }'))

Och returnerar den här resultat-XML:en:

<name>Sophia Owen</name>

Exempel 3

Anta att du har det här JSON-objektet:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

I det här exemplet skapas XML för en sträng som innehåller det här JSON-objektet:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

Och returnerar den här resultat-XML:en:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden. Ett XPath-uttryck, eller bara "XPath", hjälper dig att navigera i en XML-dokumentstruktur så att du kan välja noder eller beräkningsvärden i XML-innehållet.

Kommentar

I förbruknings- och standardlogikappar använder alla funktionsuttryck .NET XPath-biblioteket. XPath-uttryck är kompatibla med det underliggande .NET-biblioteket och stöder endast det uttryck som det underliggande .NET-biblioteket stöder.

xpath('<xml>', '<xpath>')

Parameter	Obligatoriskt	Type	Beskrivning
<xml>	Ja	Alla	XML-strängen för att söka efter noder eller värden som matchar ett XPath-uttrycksvärde
<xpath>	Ja	Alla	XPath-uttrycket som används för att hitta matchande XML-noder eller värden

Returvärde	Typ	Beskrivning
<xml-node>	XML	En XML-nod när endast en enskild nod matchar det angivna XPath-uttrycket
<värde>	Alla	Värdet från en XML-nod när endast ett enda värde matchar det angivna XPath-uttrycket
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Matris	En matris med XML-noder eller värden som matchar det angivna XPath-uttrycket

Exempel 1

Anta att du har den här 'items' XML-strängen:

<?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>

Det här exemplet skickar XPath-uttrycket , '/produce/item/name/text()'för att hitta noderna som matchar <name></name> noden i XML-strängen 'items' och returnerar en matris med dessa nodvärden:

xpath(xml(parameters('items')), '/produce/item/name/text()')

I exemplet används även funktionen parameters() för att hämta XML-strängen från 'items' och konvertera strängen till XML-format med hjälp av funktionen xml().

Här är resultatmatrisen som fylls med värden för de noder som matchar <name></name>:

[ Gala, Honeycrisp ]

Exempel 2

I exempel 1 skickas det här exemplet i XPath-uttrycket , '/produce/item/name[1]'för att hitta det första name elementet som är underordnat elementet item .

xpath(xml(parameters('items')), '/produce/item/name[1]')

Här är resultatet: Gala

Exempel 3

I exempel 1 skickar det här exemplet XPath-uttrycket , '/produce/item/name[last()]'för att hitta det sista name elementet som är underordnat elementet item .

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Här är resultatet: Honeycrisp

Exempel 4

I det här exemplet antar du att XML-strängen items också innehåller attributen expired='true' och expired='false':

<?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>

Det här exemplet skickas i XPath-uttrycket , '//name[@expired]'för att hitta alla name element som har expired attributet:

xpath(xml(parameters('items')), '//name[@expired]')

Här är resultatet: [ Gala, Honeycrisp ]

Exempel 5

I det här exemplet antar vi att XML-strängen items endast innehåller det här attributet: expired = 'true'

<?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>

Det här exemplet skickas i XPath-uttrycket , '//name[@expired = 'true']'för att hitta alla name element som har attributet : expired = 'true'

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Här är resultatet: [ Gala ]

Exempel 6

I det här exemplet antar vi att XML-strängen items också innehåller följande attribut:

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>

Det här exemplet skickas i XPath-uttrycket , '//name[@price>35]'för att hitta alla name element som har price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Här är resultatet: Honeycrisp

Exempel 7

I det här exemplet antar vi att XML-strängen items är samma som i exempel 1:

<?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>

Det här exemplet hittar noder som matchar <count></count> noden och lägger till dessa nodvärden med sum() funktionen:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Här är resultatet: 30

Exempel 8

I det här exemplet antar vi att du har den här XML-strängen, som innehåller XML-dokumentnamnområdet: xmlns="https://contoso.com"

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

Dessa uttryck använder antingen XPath-uttryck /*[name()="file"]/*[name()="location"] eller /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], för att hitta noder som matchar <location></location> noden. De här exemplen visar syntaxen som du använder i designern eller i uttrycksredigeraren:

xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

Här är resultatnoden som matchar <location></location> noden:

<location xmlns="https://contoso.com">Paris</location>

Viktigt!

Om du arbetar i kodvyn kan du undvika det dubbla citattecknet (") med hjälp av omvänt snedstreck (\). Du måste till exempel använda escape-tecken när du serialiserar ett uttryck som en JSON-sträng. Men om du arbetar i designern eller uttrycksredigeraren behöver du inte undkomma det dubbla citattecknet eftersom omvänt snedstreck läggs till automatiskt i den underliggande definitionen, till exempel:

Kodvy: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Uttrycksredigerare: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Exempel 9

I exempel 8 använder det här exemplet XPath-uttrycket, , 'string(/*[name()="file"]/*[name()="location"])'för att hitta värdet i <location></location> noden:

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

Här är resultatet: Paris

Nästa steg

Lär dig mer om arbetsflödesdefinitionsspråket

Dela via

Referensguide till funktioner för arbetsflödesuttryck i Azure Logic Apps och Power Automate

Funktioner i uttryck

Överväganden för att använda funktioner

Strängfunktioner

Insamlingsfunktioner

Logiska jämförelsefunktioner

Konverteringsfunktioner

Implicita datatypskonverteringar

Base64-kodning och avkodning

Matematikfunktioner

Översikt över datum- och tidsfunktioner

Arbetsflödesfunktioner

URI tolkningsfunktioner

Manipulationsfunktioner: JSON & XML

---------------------------------

Alla funktioner – alfabetisk lista

A

åtgärd

åtgärder

add

addDays

addHours

addMinutes

addProperty

addSeconds

addToTime

och

matris

F

base64

base64ToBinary

base64ToString

binary

brödtext

bool

C

segment

sammansmälta

concat

innehåller

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dateDifference

dayOfMonth

dayOfWeek

dayOfYear

decimal

decodeBase64 (inaktuell)

decodeDataUri

decodeUriComponent

div

E

encodeUriComponent

empty

endsWith

equals

F

Första

flyttal

formatDateTime

formDataMultiValues

formDataValue

formatNumber

G

getFutureTime

getPastTime

greater

greaterOrEquals

guid

I

if

indexOf

heltal