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

Gäller för: Azure Logic Apps (Consumption + 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.

Anteckning

Den här referenssidan gäller för både Azure Logic Apps och Power Automate, men visas i dokumentationen för 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 i 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 följer andra exempeluppgifter som du kan utföra med funktioner:

Uppgift Funktionssyntax Resultat
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. Mer information om varje funktion finns i 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 som du kan använda funktioner i uttryck på:

Uppgift Funktionssyntax i ett uttryck
Utför arbete med ett objekt genom att skicka objektet till en funktion. "@<functionName>(<item>)"
1. Hämta parameterName-värdet 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 property propertyName hämtar du egenskapens värde.
"@<functionName>(<item>).<propertyName>"

Funktionen kan till exempel concat() ha två eller flera strängvärden som parametrar. Den här funktionen kombinerar dessa strängar till 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')"

Eller så kan du 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 customerName egenskapen .

Att tänka på när du använder 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 infogade med oformaterad text kräver klammerparenteser ({}) för att använda uttryckets interpolerade format i stället. Det här formatet hjälper dig att undvika parsningsproblem. Om funktionsuttrycket inte visas i stil med oformaterad text behö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 bara på strängar.

Strängfunktion Uppgift
Bit 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ätta Ersätt en delsträng med den angivna strängen och returnera den uppdaterade strängen.
Skiva Returnera en delsträng genom att ange start- och slutpositionen eller värdet. Se även delsträng.
Split 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.

Samlingsfunktioner

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

Samlingsfunktion Uppgift
Bit Dela upp en sträng eller samling i segment med samma längd.
Innehåller Kontrollera om en samling har ett specifikt objekt.
tomt Kontrollera om en samling är tom.
Första Returnera det första objektet från en samling.
Korsningen Returnera en samling som bara har de vanliga objekten i de angivna samlingarna.
Objekt 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.
Ansluta sig till Returnera en sträng som innehåller alla objekt från en matris, avgränsad med det angivna tecknet.
Senaste Returnera det sista objektet från en samling.
length Returnera antalet objekt i en sträng eller matris.
Omvänd Ändra ordning på objekt i en matris.
Hoppa över 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.
Unionen 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.

Anteckning

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.
större än Kontrollera om det första värdet är större än det andra värdet.
större än eller lika med 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.
Mindre Kontrollera om det första värdet är mindre än det andra värdet.
mindre än eller lika med Kontrollera om det första värdet är mindre än eller lika med det andra värdet.
Inte Kontrollera om ett uttryck är falskt.
Eller 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.

Anteckning

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 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
matris 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.
binary Returnera den binära versionen för ett indatavärde.
boolesk 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.
float 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 datatypkonverteringar

Azure Logic Apps konverteras 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 icke-strängvärden 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>)

Anteckning

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 funktionens parametervärden kvar.

Matematiska funktioner

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
Add 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.
Mod 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.
Utbud Returnera en heltalsmatris som startar från ett angivet heltal.
Sub Returnera resultatet från subtrahering av det andra talet från det första talet.

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ånadskomponentens dag 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 subtraheraFromTime.
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 att:

  • 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ärder 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.
actionBody Returnera en åtgärds body utdata vid körning. Se även brödtext.
actionOutputs Returnera en åtgärds utdata vid körning. Se utdata och å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.
Kroppen Returnera en åtgärds body utdata vid körning. Se även actionBody.
formDataMultiValues Skapa en matris med de värden som matchar ett nyckelnamn i utdata från formdata eller formulärkodade åtgärder.
formDataValue Returnera ett enskilt värde som matchar ett nyckelnamn i en åtgärds formulärdata - eller formulärkodade utdata.
Objekt 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.
Resultatet Returnera indata och utdata från åtgärderna på den översta nivån i den angivna begränsade åtgärden, till exempel For_each, Untiloch Scope.
Utlösa Returnera en utlösares utdata vid körning eller från andra namn- och värdepar för JSON. Se även triggerOutputs och triggerBody.
triggerBody Returnera utdata från en utlösare body vid körning. Se utlösare.
triggerFormDataValue Returnera ett enskilt värde som matchar ett nyckelnamn i utdata från formdata eller formulärkodade utlösare.
triggerMultipartBody Returnera brödtexten för en viss del i en utlösarens 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-parsningsfunktioner

Om du vill arbeta med URI:er (Uniform Resource Identifiers) 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 URI (Uniform Resource Identifier).
uriPath path Returnera värdet för en URI (Uniform Resource Identifier).
uriPathAndQuery path Returnera värdena och query för en URI (Uniform Resource Identifier).
uriPort port Returnera värdet för en URI (Uniform Resource Identifier).
uriQuery query Returnera värdet för en URI (Uniform Resource Identifier).
uriScheme scheme Returnera värdet för en URI (Uniform Resource Identifier).

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.
coalesce Returnera det första icke-null-värdet 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 funktionen action() 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 Krävs Typ Description
<Egenskapen> Inga Sträng Namnet på åtgärdsobjektets egenskap vars värde du vill använda: name, startTime, endTime, inputs, outputs, status, code, trackingId och clientTrackingId. I Azure Portal hittar du dessa egenskaper genom att granska en specifik körningshistoriks information. Mer information finns i REST API – Arbetsflödeskörningsåtgärder.
Returvärde Typ Description
<action-output> Sträng Utdata från den aktuella åtgärden eller egenskapen

actionBody

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

actionBody('<actionName>')
Parameter Krävs Typ Description
<actionName> Ja Sträng Namnet på åtgärdens body utdata som du vill ha
Returvärde Typ Description
<action-body-output> Sträng Utdata body från den angivna åtgärden

Exempel

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

actionBody('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"
}

actionOutputs

Returnera en åtgärds utdata vid körning. och är en förkortning för actions('<actionName>').outputs. Se actions(). Funktionen actionOutputs() matchas till i designern, så överväg att outputs() använda outputs(), i stället actionOutputs()för . Även om båda funktionerna fungerar på samma sätt outputs() är det att föredra.

actionOutputs('<actionName>')
Parameter Krävs Typ Description
<actionName> Ja Sträng Namnet på åtgärdens utdata som du vill ha
Returvärde Typ Description
<Produktionen> Sträng Utdata från den angivna åtgärden

Exempel

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

actionOutputs('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"
  }
}

å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 actionBody(), actionOutputs()och body(). Den aktuella åtgärden finns i action().

Tips

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.

Anteckning

Tidigare kunde du använda actions() funktionen eller -elementet conditions när du angav 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 runAfterFånga och hantera fel med egenskapen runAfter.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parameter Krävs Typ Description
<actionName> Ja Sträng Namnet på det åtgärdsobjekt vars utdata du vill ha
<Egenskapen> Inga Sträng Namnet på åtgärdsobjektets egenskap vars värde du vill ha: name, startTime, endTime, inputs, outputs, status, code, trackingId och clientTrackingId. I Azure Portal hittar du dessa egenskaper genom att granska en specifik körningshistoriks information. Mer information finns i REST API – Arbetsflödeskörningsåtgärder.
Returvärde Typ Description
<action-output> Sträng Utdata från den angivna åtgärden eller egenskapen

Exempel

Det här exemplet hämtar egenskapsvärdet status från Twitter-å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 Krävs Typ Description
<>summand_1, <summand_2> Ja Heltal, flyttal eller blandat De tal som ska läggas till
Returvärde Typ Description
<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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Dagar> Ja Integer Det positiva eller negativa antalet dagar som ska läggas till
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Timmar> Ja Integer Det positiva eller negativa antalet timmar som ska läggas till
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Minuter> Ja Integer Det positiva eller negativa antalet minuter som ska läggas till
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 genererar ett fel.

addProperty(<object>, '<property>', <value>)
Parameter Krävs Typ Description
<Objekt> Ja Objekt Det JSON-objekt där du vill lägga till en egenskap
<Egenskapen> Ja Sträng Namnet på egenskapen som ska läggas till
<Värde> Ja Valfri Värdet för egenskapen
Returvärde Typ Description
<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 Krävs Typ Description
<Objekt> Ja Objekt Det JSON-objekt där du vill lägga till en egenskap
<parent-property> Ja Sträng Namnet på den överordnade egenskapen där du vill lägga till den underordnade egenskapen
<underordnad egenskap> Ja Sträng Namnet på den underordnade egenskapen som ska läggas till
<Värde> Ja Valfri Värdet som ska anges för den angivna egenskapen
Returvärde Typ Description
<updated-object> Objekt Det uppdaterade JSON-objektet vars egenskap du anger

Exempel 1

I det middleName här exemplet läggs egenskapen till 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 till 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Sekunder> Ja Integer Det positiva eller negativa antalet sekunder som ska läggas till
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Intervall> Ja Integer Antalet angivna tidsenheter som ska läggas till
<timeUnit> Ja Sträng Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 returnera falskt när minst ett uttryck är falskt.

and(<expression1>, <expression2>, ...)
Parameter Krävs Typ Description
<expression1>, <expression2>, ... Ja Boolesk De uttryck som ska kontrolleras
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när alla uttryck är sanna. Returnera falskt 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 Krävs Typ Description
<Värde> Ja Sträng Strängen för att skapa en matris
Returvärde Typ Description
[<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"]

B

base64

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

Anteckning

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 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 Base64-kodning och avkodning.

base64('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Indatasträngen
Returvärde Typ Description
<base64-string> Sträng 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.

Anteckning

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 Base64-kodning och avkodning.

base64ToBinary('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Den base64-kodade sträng som ska konverteras
Returvärde Typ Description
<binary-for-base64-string> Sträng Den binära versionen 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.

Anteckning

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 Base64-kodning och avkodning.

base64ToString('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Den base64-kodade strängen som ska avkodas
Returvärde Typ Description
<decoded-base64-string> Sträng Strängversionen för en base64-kodad sträng

Exempel

Det här exemplet konverterar "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 Krävs Typ Description
<Värde> Ja Sträng Strängen som ska konverteras
Returvärde Typ Description
<binary-for-input-value> Sträng 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ängbyte med application/octet-stream innehållstypen i begäran.

body

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

body('<actionName>')
Parameter Krävs Typ Description
<actionName> Ja Sträng Namnet på åtgärdens body utdata som du vill ha
Returvärde Typ Description
<action-body-output> Sträng Utdata body från den angivna åtgärden

Exempel

Det här exemplet hämtar body utdata från Twitter-å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"
}

boolesk

Returnera den booleska versionen av ett värde.

bool(<value>)
Parameter Krävs Typ Description
<Värde> Ja Valfri 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 Description
true eller false Boolesk 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') Sträng true
bool('false') Sträng false

C

Bit

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

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parameter Krävs Typ Description
<Samling> Ja Sträng eller matris Samlingen som ska delas
<Längd> Ja Längden på varje segment
Returvärde Typ Description
<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ängden 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 av 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] ]

coalesce

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

coalesce(<object_1>, <object_2>, ...)
Parameter Krävs Typ Description
<>object_1, <object_2>, ... Ja Alla, kan blanda typer Ett eller flera objekt att söka efter null
Returvärde Typ Description
<first-non-null-item> Valfri 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 icke-null-värdet 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 Krävs Typ Description
<text1>, <text2>, ... Ja Sträng Minst två strängar att kombinera
Returvärde Typ Description
<text1text2...> Sträng Strängen som skapats från de kombinerade indatasträngarna.



Obs! Resultatet får inte vara längre än 104 857 600 tecken.

Anteckning

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å dessa 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 Krävs Typ Description
<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 Description
sant eller falskt Boolesk 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 delsträngen "universe" och returnerar false:

contains('hello world', 'universe')

convertFromUtc

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

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<destinationTimeZone> Ja Sträng Namnet på måltidszonen. Information om tidszonsnamn finns i Standardtidszoner för Microsoft Windows.
<Format> Inga Sträng 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 Description
<konverterad tidsstämpel> Sträng 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<sourceTimeZone> Ja Sträng 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 tidszonens namn.
<destinationTimeZone> Ja Sträng 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 tidszonens namn.
<Format> Inga Sträng 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 Description
<konverterad tidsstämpel> Sträng Tidsstämpeln som konverteras 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 UTC (Universal Time Coordinated).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<sourceTimeZone> Ja Sträng 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 tidszonens namn.
<Format> Inga Sträng 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 Description
<konverterad tidsstämpel> Sträng Tidsstämpeln som konverteras 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. Information om enskilda indatamatriser finns i array().

createArray('<object1>', '<object2>', ...)
Parameter Krävs Typ Description
<object1>, <object2>, ... Ja Alla, men inte blandade Minst två objekt för att skapa matrisen
Returvärde Typ Description
[<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 Krävs Typ Description
<Värde> Ja Sträng Strängen som ska konverteras
Returvärde Typ Description
<data-URI> Sträng 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 URI (Data Uniform Resource Identifier). 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 Krävs Typ Description
<Värde> Ja Sträng Data-URI:n som ska konverteras
Returvärde Typ Description
<binary-for-data-uri> Sträng Binärversionen för data-URI:n

Exempel

I det här exemplet skapas 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 Krävs Typ Description
<Värde> Ja Sträng Data-URI:n som ska konverteras
Returvärde Typ Description
<string-for-data-uri> Sträng 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 ett tidsintervall. Den här funktionen subtraherar startDate från endDateoch returnerar resultatet som tidsstämpel i strängformat.

dateDifference('<startDate>', '<endDate>')
Parameter Krävs Typ Description
<Startdate> Ja Sträng En sträng som innehåller en tidsstämpel
<endDate> Ja Sträng En sträng som innehåller en tidsstämpel
Returvärde Typ Description
<Gått> Sträng 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
Returvärde Typ Description
<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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
Returvärde Typ Description
<veckodag> Integer Veckodagen från den angivna tidsstämpeln där söndagen är 0, måndagen ä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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
Returvärde Typ Description
<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.

Anteckning

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

decimal('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Decimaltalet i en sträng
Returvärde Typ Description
<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

Det här exemplet använder en matematisk funktion på två decimaltal och använder resultatet som ett tal:

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

Exempel 4

Det här exemplet använder en matematisk funktion på två decimaltal och konverterar resultatet 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() rekommenderas.

Anteckning

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 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 Base64-kodning och avkodning.

decodeDataUri('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Data-URI-strängen som ska avkodas
Returvärde Typ Description
<binary-for-data-uri> Sträng Den binära versionen för en data-URI-sträng

Exempel

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

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

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Strängen med de escape-tecken som ska avkodas
Returvärde Typ Description
<decoded-uri> Sträng 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 Krävs Typ Description
<Utdelning> Ja Heltal eller flyttal Talet som ska divideras med nämnaren
<Divisor> Ja Heltal eller flyttal Talet som dividerar utdelningen, men får inte vara noll
Returvärde Typ Description
<kvotresultat> Heltal eller flyttal Resultatet från att dividera det första talet med det andra talet. Om antingen utdelningen eller nämnaren har float-typen har resultatet float-typ.



Obs! Om du vill konvertera flyttalsresultatet 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 float-typen: 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.

Anteckning

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 Base64-kodning och avkodning.

encodeUriComponent('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Strängen som ska konverteras till URI-kodat format
Returvärde Typ Description
<encoded-uri> Sträng Den URI-kodade strängen med escape-tecken

Exempel

I det här exemplet skapas 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"

tomt

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 Krävs Typ Description
<Samling> Ja Sträng, matris eller objekt Samlingen som ska kontrolleras
Returvärde Typ Description
sant eller falskt Boolesk 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 Krävs Typ Description
<Text> Ja Sträng Strängen som ska kontrolleras
<searchText> Ja Sträng Den avslutande delsträngen för att hitta
Returvärde Typ Description
sant eller falskt Boolesk 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

lika med

Kontrollera om både värden, uttryck eller objekt är likvärdiga. Returnera sant när båda är likvärdiga eller returnerar falskt när de inte är likvärdiga.

equals('<object1>', '<object2>')
Parameter Krävs Typ Description
<object1>, <object2> Ja Olika De värden, uttryck eller objekt som ska jämföras
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när båda är likvärdiga. Returnera falskt när det inte är ekvivalent.

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 Krävs Typ Description
<Samling> Ja Sträng eller matris Samlingen där du hittar det första objektet
Returvärde Typ Description
<first-collection-item> Valfri 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 följande resultat:

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

flyt

Konvertera en strängversion för ett flyttalsnummer till ett faktiskt flyttalsnummer. Du kan bara använda den här funktionen när du skickar anpassade parametrar till en app, till exempel ett logikappsarbetsflö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 Krävs Typ Description
<Värde> Ja Sträng Strängen som har ett giltigt flyttalsnummer att konvertera. Minimi- och maxvärdena är samma som gränserna för flyttalsdatatypen.
<Locale> Inga Sträng Den RFC 4646-språkkod som ska användas.

Om inget annat anges används standardspråk.

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ågot associerat språk.
Returvärde Typ Description
<float-value> Float 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Format> Inga Sträng 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.
<Locale> Inga Sträng Språkvarianten som ska användas. Om det är ospecificerat är en-usvärdet . Om nationella inställningar inte är ett giltigt värde genereras ett fel.
Returvärde Typ Description
<formaterad tidsstämpel> Sträng Den uppdaterade tidsstämpeln i det angivna formatet och nationella inställningar, om den har angetts.

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 formdata - eller formulärkodade utdata.

formDataMultiValues('<actionName>', '<key>')
Parameter Krävs Typ Description
<actionName> Ja Sträng Åtgärden vars utdata har det nyckelvärde som du vill använda
<Nyckel> Ja Sträng Namnet på nyckeln vars värde du vill använda
Returvärde Typ Description
[<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 enskilt 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 Krävs Typ Description
<actionName> Ja Sträng Åtgärden vars utdata har det nyckelvärde som du vill använda
<Nyckel> Ja Sträng Namnet på nyckeln vars värde du vill använda
Returvärde Typ Description
<nyckelvärde> Sträng 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 Krävs Typ Description
<Nummer> Ja Heltal eller dubbel Det värde som du vill formatera.
<Format> Ja Sträng En sammansatt formatsträng som anger det format som du vill använda. De numeriska formatsträngar som stöds finns i Strängar i numeriskt standardformat som stöds av number.ToString(<format>, <locale>).
<Locale> Inga Sträng Språkvarianten som stöds av number.ToString(<format>, <locale>). Om det är ospecificerat är en-usvärdet . Om nationella inställningar inte är ett giltigt värde genereras ett fel.
Returvärde Typ Description
<formaterat tal> Sträng 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. Det här exemplet formaterar 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 Krävs Typ Description
<Intervall> Ja Integer Antalet tidsenheter som ska läggas till
<timeUnit> Ja Sträng Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng Den aktuella tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är "2018-03-01T00:00:00.0000000Z". 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.0000000Z". Det här exemplet lägger till fem dagar och konverterar resultatet till formatet "D":

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 Krävs Typ Description
<Intervall> Ja Integer Antalet angivna tidsenheter som ska subtraheras
<timeUnit> Ja Sträng Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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"

större än

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 Krävs Typ Description
<Värde> Ja Heltal, flyttal eller sträng Det första värdet som kontrollerar om det är större än det andra värdet
<compareTo> Ja Heltal, Flyttal eller Sträng, respektive Jämförelsevärdet
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när det första värdet är större än det andra värdet. Returnera falskt 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

större än eller lika med

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 Krävs Typ Description
<Värde> Ja Heltal, flyttal eller sträng Det första värdet som kontrollerar om det är större än eller lika med det andra värdet
<compareTo> Ja Heltal, Flyttal eller Sträng, respektive Jämförelsevärdet
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när det första värdet är större än eller lika med det andra värdet. Returnera falskt 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 Krävs Typ Description
<Format> Inga Sträng 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 Description
<GUID-värde> Sträng Ett slumpmässigt genererat GUID

Exempel

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

guid('P')

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

I

om

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 Krävs Typ Description
<Uttryck> Ja Boolesk Det uttryck som ska kontrolleras
<valueIfTrue> Ja Valfri Värdet som ska returneras när uttrycket är sant
<valueIfFalse> Ja Valfri Värdet som ska returneras när uttrycket är falskt
Returvärde Typ Description
<specified-return-value> Valfri 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 Krävs Typ Description
<Text> Ja Sträng Strängen som har delsträngen att hitta
<searchText> Ja Sträng Delsträngen som ska hittas
Returvärde Typ Description
<index-value> 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

int

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

int('<value>')
Parameter Krävs Typ Description
<Värde> Ja Sträng Strängversionen för heltal som ska konverteras. De lägsta och högsta värdena är samma som gränserna för heltalsdatatypen.
Returvärde Typ Description
<integer-result> Integer Heltalsversionen för den angivna strängen. De lägsta och högsta vä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 Krävs Typ Description
<Värde> Ja Sträng Strängen som ska undersökas
<Locale> Inga Sträng RFC 4646-språkkoden som ska användas
Returvärde Typ Description
<boolean-result> Boolesk 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

Det här exemplet kontrollerar 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 Krävs Typ Description
<Sträng> Ja Sträng Strängen som ska undersökas
Returvärde Typ Description
<boolean-result> Boolesk 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

objekt

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 Description
<current-array-item> Valfri 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 Krävs Typ Description
<loopName> Ja Sträng Namnet på for-each-loopen
Returvärde Typ Description
<Objekt> Valfri 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 Krävs Typ Description
<loopName> Ja Sträng Namnet på Until-loopen
Returvärde Typ Description
<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 med hjälp iterationIndexes 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 Krävs Typ Description
<Värde> Ja Sträng eller XML Strängen eller XML som ska konverteras
Returvärde Typ Description
<JSON-resultat> Inbyggd JSON-typ, objekt eller matris Det inbyggda JSON-typvärdet, objektet eller matrisen med objekt från indatasträngen eller XML-filen.



– 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

I det här exemplet konverteras 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 här exemplet används json() 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"
         }
      ]
   }
}

Korsningen

Returnera en samling som bara innehåller de gemensamma 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 Krävs Typ Description
<collection1>, <collection2>, ... Ja Matris eller objekt, men inte båda Samlingarna där du bara vill ha de gemensamma objekten
Returvärde Typ Description
<common-items> Matris respektive objekt En samling som bara har gemensamma objekt i de angivna samlingarna

Exempel

Det här exemplet hittar vanliga objekt 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]

join

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

join([<collection>], '<delimiter>')
Parameter Krävs Typ Description
<Samling> Ja Matris Matrisen som har de objekt som ska kopplas
<Avgränsare> Ja Sträng Avgränsaren som visas mellan varje tecken i den resulterande strängen
Returvärde Typ Description
<char1><Avgränsare><char2><Avgränsare>... Sträng Den resulterande strängen som skapas från alla objekt i den angivna matrisen.



Obs! Längden på resultatet får inte överstiga 104 857 600 tecken.

Exempel

Det här exemplet skapar 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 Krävs Typ Description
<Samling> Ja Sträng eller matris Samlingen där du hittar det sista objektet
Returvärde Typ Description
<last-collection-item> Sträng eller matris 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 Krävs Typ Description
<Text> Ja Sträng Strängen som har delsträngen att hitta
<searchText> Ja Sträng Delsträngen som ska hittas
Returvärde Typ Description
<ending-index-value> Integer Startpositionen eller indexvärdet för den sista förekomsten av den angivna delsträngen.

Om värdet för strängen eller delsträngen ä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 sista 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 22 på eftersom värdet för indatasträngen (23) minus 1 är större än 0.

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

length

Returnera antalet objekt i en samling.

length('<collection>')
length([<collection>])
Parameter Krävs Typ Description
<Samling> Ja Sträng eller matris Samlingen med de objekt som ska räknas
Returvärde Typ Description
<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

mindre än

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 Krävs Typ Description
<Värde> Ja Heltal, flyttal eller sträng Det första värdet som kontrollerar om mindre än det andra värdet
<compareTo> Ja Heltal, Flyttal eller Sträng, respektive Jämförelseobjektet
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när det första värdet är mindre än det andra värdet. Returnera falskt 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

mindre än eller lika med

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 returnerar falskt när det första värdet är mer.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Krävs Typ Description
<Värde> Ja Heltal, flyttal eller sträng Det första värdet som kontrollerar om det är mindre än eller lika med det andra värdet
<compareTo> Ja Heltal, Flyttal eller Sträng, respektive Jämförelseobjektet
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när det första värdet är mindre än eller lika med det andra värdet. Returnera falskt 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 Description
<callback-URL> Sträng Återanrops-URL:en för en utlösare eller åtgärd

Exempel

Det här exemplet visar ett exempel på återanrops-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 Krävs Typ Description
<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åde och Matrisen med tal som du vill ha det högsta värdet från
Returvärde Typ Description
<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 Krävs Typ Description
<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åde och Matrisen med tal som du vill ha det lägsta värdet från
Returvärde Typ Description
<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 Krävs Typ Description
<Utdelning> Ja Heltal eller flyttal Talet som ska divideras med divisorn
<Divisor> Ja Heltal eller flyttal Talet som dividerar utdelningen, men får inte vara noll
Returvärde Typ Description
<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 divideras 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 Krävs Typ Description
<multiplicand1> Ja Heltal eller flyttal Talet som ska multipliceras med multiplicand2
<multiplicand2> Ja Heltal eller flyttal Talet som multiplicand1 multiplicand1
Returvärde Typ Description
<produktresultat> Heltal eller flyttal Produkten från att multiplicera det första talet med det andra talet

Exempel

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

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

Och returnera följande 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 Krävs Typ Description
<actionName> Ja Sträng 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 Description
<Kroppen> Sträng Brödtexten för den angivna delen

N

inte

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

not(<expression>)
Parameter Krävs Typ Description
<Uttryck> Ja Boolesk Uttrycket som ska kontrolleras
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när uttrycket är falskt. Returnera falskt när uttrycket är sant.

Exempel 1

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

not(false)
not(true)

Och returnera följande 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 följande 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 Krävs Typ Description
<Text> Ja Sträng Strängen som innehåller delsträngen som ska hittas
<searchText> Ja Sträng 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 Description
<index-value> 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 Krävs Typ Description
<expression1>, <expression2>, ... Ja Boolesk De uttryck som ska kontrolleras
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när minst ett uttryck är sant. Returnera falskt 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 följande resultat:

  • Första exemplet: Minst ett uttryck är sant, så funktionen returnerar true.
  • Andra exemplet: Båda uttrycken är false, 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 följande resultat:

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

Utgångar

Returnera en åtgärds utdata vid körning. Använd den här funktionen i stället actionOutputs()för , som matchas till outputs() i designern. Även om båda funktionerna fungerar på samma sätt outputs() är det att föredra.

outputs('<actionName>')
Parameter Krävs Typ Description
<actionName> Ja Sträng Namnet på åtgärdens utdata som du vill ha
Returvärde Typ Description
<Produktionen> Sträng Utdata från den angivna åtgärden

Exempel

Det här exemplet hämtar utdata från Twitter-å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 Krävs Typ Description
<parameterName> Ja Sträng Namnet på parametern vars värde du vill ha
Returvärde Typ Description
<parameter-value> Valfri 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Locale> Inga Sträng Språkvarianten som ska användas.

Om inget anges är en-usstandardspråket .

Om nationella inställningar inte är ett giltigt värde genereras ett fel.
<Format> Inga Sträng 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 anges försöker du parsa med flera format som är kompatibla med de angivna nationella inställningarna. Om formatet inte är ett giltigt värde genereras ett fel.
Returvärde Typ Description
<parsad tidsstämpel> Sträng 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 Krävs Typ Description
<minValue> Ja Integer Det lägsta heltalet i intervallet
<Maxvalue> Ja Integer Heltal som följer det högsta heltal i intervallet som funktionen kan returnera
Returvärde Typ Description
<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, 3, eller 4

Utbud

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

range(<startIndex>, <count>)
Parameter Krävs Typ Description
<startIndex> Ja Integer Ett heltalsvärde som startar matrisen som det första objektet
<Räkna> Ja Integer Antalet heltal i matrisen. Parametervärdet count måste vara ett positivt heltal som inte överskrider 100 000.



Obs! Summan av startIndex värdena och count får inte överstiga 2 147 483 647.
Returvärde Typ Description
[<intervallresultat>] Matris Matrisen med heltal från det angivna indexet

Exempel

I det här exemplet skapas 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 Krävs Typ Description
<Objekt> Ja Objekt JSON-objektet där du vill ta bort en egenskap
<Egenskapen> Ja Sträng Namnet på egenskapen som ska tas bort
Returvärde Typ Description
<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 Krävs Typ Description
<Objekt> Ja Objekt Det JSON-objekt vars egenskap du vill ta bort
<parent-property> Ja Sträng Namnet på den överordnade egenskapen med den underordnade egenskapen som du vill ta bort
<underordnad egenskap> Ja Sträng Namnet på den underordnade egenskapen som ska tas bort
Returvärde Typ Description
<updated-object> Objekt Det uppdaterade JSON-objektet vars underordnade egenskap som du har tagit bort

Exempel 1

Det här exemplet tar middleName bort 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ätta

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 Krävs Typ Description
<Text> Ja Sträng Strängen som har delsträngen att ersätta
<oldText> Ja Sträng Delsträngen som ska ersättas
<newText> Ja Sträng Ersättningssträngen
Returvärde Typ Description
<updated-text> Sträng 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 "old" med "new":

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 de attribut som returneras av actions() funktionen, till exempel åtgärdens starttid, sluttid, status, indata, korrelations-ID och utdata.

Anteckning

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 resultat 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 Krävs Typ Description
<scopedActionName> Ja Sträng 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 Description
<array-object> Matrisobjekt En matris som innehåller matriser med indata och utdata från varje åtgärd på den översta nivån inom 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 ordning 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 Krävs Typ Description
<Samling> Ja Matris Samlingen som ska vändas
Returvärde Typ Description
[<updated-collection>] Matris Den omvända samlingen

Exempel

Det här exemplet vänder 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 Krävs Typ Description
<Objekt> Ja Objekt JSON-objektet vars egenskap du vill ange
<Egenskapen> Ja Sträng Namnet på den befintliga eller nya egenskapen som ska anges
<Värde> Ja Valfri 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 Krävs Typ Description
<Objekt> Ja Objekt JSON-objektet vars egenskap du vill ange
<parent-property> Ja Sträng Namnet på den överordnade egenskapen med den underordnade egenskapen som du vill ange
<underordnad egenskap> Ja Sträng Namnet på den underordnade egenskapen som ska anges
<Värde> Ja Valfri Värdet som ska anges för den angivna egenskapen
Returvärde Typ Description
<updated-object> Objekt Det uppdaterade JSON-objektet vars egenskap du anger

Exempel 1

Det här exemplet anger surName 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

Det här exemplet anger 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 Krävs Typ Description
<Samling> Ja Matris Samlingen vars objekt du vill ta bort
<Räkna> Ja Integer Ett positivt heltal för antalet objekt som ska avlägsnas fram
Returvärde Typ Description
[<updated-collection>] Matris Den uppdaterade samlingen när du har tagit bort de angivna objekten

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]

Skiva

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

slice('<text>', <startIndex>, <endIndex>?)
Parameter Krävs Typ Description
<Text> Ja Sträng Strängen som innehåller delsträngen för att hitta
<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> Inga Integer Den nollbaserade slutpositionen eller värdet för var du ska sluta söka efter delsträngen. Tecknet som finns vid det sista 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 avslutas sökningen med indexvärdet som summan av stränglängden och endIndex.
Returvärde Typ Description
<segmentresultat> Sträng 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 Krävs Typ Description
<Samling> Ja Matris Samlingen med de objekt som ska sorteras
<sortBy> Inga Sträng Nyckeln som ska användas för att sortera samlingsobjekten
Returvärde Typ Description
[<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" }')]

split

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 Krävs Typ Description
<Text> Ja Sträng Strängen som ska separeras i delsträngar baserat på den angivna avgränsaren i den ursprungliga strängen
<Avgränsare> Ja Sträng Tecknet i den ursprungliga strängen som ska användas som avgränsare
Returvärde Typ Description
[<substring1,substring2>><,...] Matris En matris som innehåller delsträngar från den ursprungliga strängen, avgränsade 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

I det här exemplet skapas 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng Den angivna tidsstämpeln men börjar vid nolltimmarsmarkeringen 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng Den angivna tidsstämpeln men börjar med nollminutersmarkeringen för timmen

Exempel

Det här exemplet hittar timstarten 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 det inte hittas. Den här funktionen är inte skiftlägeskänslig.

startsWith('<text>', '<searchText>')
Parameter Krävs Typ Description
<Text> Ja Sträng Strängen som ska kontrolleras
<searchText> Ja Sträng Den startsträng som ska hittas
Returvärde Typ Description
sant eller falskt Boolesk Returnera sant när den inledande delsträ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 Krävs Typ Description
<Värde> Ja Valfri 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 obefintlig egenskap, 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 Description
<string-value> Sträng 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

Det här exemplet skapar 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\\" }"

Sub

Returnera resultatet från subtrahering av det andra talet från det första talet.

sub(<minuend>, <subtrahend>)
Parameter Krävs Typ Description
<minuend> Ja Heltal eller flyttal Talet som subtrafend ska subtraheras från
<subtrahend> Ja Heltal eller flyttal Talet som ska subtraheras från minuend
Returvärde Typ Description
<Resultatet> Heltal eller flyttal Resultatet av 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 Krävs Typ Description
<Text> Ja Sträng 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
<Längd> Inga Integer Ett positivt antal tecken som du vill använda i delsträngen

Anteckning

Kontrollera att summan från att lägga till parametervärdena startIndex och length ä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 tillhandahålls tar funktionen substring() alla tecken från startIndex till slutet av strängen.

Returvärde Typ Description
<substring-result> Sträng 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 på 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen som innehåller tidsstämpeln
<Intervall> Ja Integer Antalet angivna tidsenheter som ska subtraheras
<timeUnit> Ja Sträng Den tidsenhet som ska användas med intervall: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Format> Inga Sträng 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 Description
<updated-timestamp> Sträng 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 formatet "D": "Monday, January, 1, 2018"

T

take

Returnera objekt från framsidan av en samling.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Krävs Typ Description
<Samling> Ja Sträng eller matris Den samling vars objekt du vill ha
<Räkna> Ja Integer Ett positivt heltal för antalet objekt som du vill ha framifrån
Returvärde Typ Description
<Delmängd> eller [<delmängd>] Sträng eller matris En sträng eller matris som har det angivna antalet objekt som hämtats från den ursprungliga samlingens framsida

Exempel

De här exemplen hämtar det angivna antalet objekt från framsidan av 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 nanosekunder, 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 Krävs Typ Description
<Tidsstämpel> Ja Sträng Strängen för en tidsstämpel
Returvärde Typ Description
<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 Krävs Typ Description
<Text> Ja Sträng Strängen som ska returneras i gemener
Returvärde Typ Description
<gemener-text> Sträng Den ursprungliga strängen i gemener

Exempel

Det här exemplet konverterar 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 Krävs Typ Description
<Text> Ja Sträng Strängen som ska returneras i versaler
Returvärde Typ Description
<versaler-text> Sträng Den ursprungliga strängen i versaler

Exempel

Det här exemplet konverterar strängen till versaler:

toUpper('Hello World')

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

Utlösa

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 ha. Dessutom har den här funktionen shorthand-versioner tillgängliga, se triggerOutputs() och triggerBody().

trigger()
Returvärde Typ Description
<trigger-output> Sträng Utdata från en utlösare vid körning

triggerBody

Returnera utdata från en utlösare body vid körning. Förkortning för trigger().outputs.body. Se trigger().

triggerBody()
Returvärde Typ Description
<trigger-body-output> Sträng 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 Krävs Typ Description
<Nyckel> Ja Sträng Namnet på nyckeln vars värde du vill ha
Returvärde Typ Description
[<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 utdata för formdata eller formulärkodad:

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 Krävs Typ Description
<Nyckel> Ja Sträng Namnet på nyckeln vars värde du vill använda
Returvärde Typ Description
<nyckelvärde> Sträng 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 formulärdata- 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 viss del i en utlösarens utdata som har flera delar.

triggerMultipartBody(<index>)
Parameter Krävs Typ Description
<Index> Ja Integer Indexvärdet för den del som du vill ha
Returvärde Typ Description
<Kroppen> Sträng 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 Description
<trigger-output> Sträng 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 Krävs Typ Description
<Text> Ja Sträng Strängen som har inledande och avslutande blanksteg att ta bort
Returvärde Typ Description
<updatedText> Sträng 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

Unionen

Returnera en samling som innehåller alla objekt från de angivna samlingarna. För att visas i resultatet kan 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.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Krävs Typ Description
<collection1>, <collection2>, ... Ja Matris eller objekt, men inte båda Samlingarna där du vill ha alla objekt
Returvärde Typ Description
<updatedCollection> Matris respektive objekt 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 Krävs Typ Description
<Värde> Ja Sträng Strängen som ska konverteras till URI-kodat format
Returvärde Typ Description
<encoded-uri> Sträng 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 Krävs Typ Description
<Värde> Ja Sträng Den URI-kodade sträng som ska konverteras
Returvärde Typ Description
<binary-for-encoded-uri> Sträng 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 den binära versionen 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 Krävs Typ Description
<Värde> Ja Sträng Den URI-kodade strängen som ska avkodas
Returvärde Typ Description
<decoded-uri> Sträng Den avkodade versionen för den URI-kodade strängen

Exempel

Det här exemplet skapar 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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars host värde du vill ha
Returvärde Typ Description
<värdvärde> Sträng Värdet host för angiven URI

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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars path värde du vill ha
Returvärde Typ Description
<path-value> Sträng 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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars path och query de värden du vill ha
Returvärde Typ Description
<path-query-value> Sträng 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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars port värde du vill ha
Returvärde Typ Description
<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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars query värde du vill ha
Returvärde Typ Description
<query-value> Sträng Värdet query för angiven URI

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 Krävs Typ Description
<Uri> Ja Sträng Den URI vars scheme värde du vill ha
Returvärde Typ Description
<scheme-value> Sträng Värdet scheme för angiven URI

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 Krävs Typ Description
<Format> Inga Sträng 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 Description
<aktuell tidsstämpel> Sträng 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 Krävs Typ Description
<variableName> Ja Sträng Namnet på variabeln vars värde du vill ha
Returvärde Typ Description
<variable-value> Valfri 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

W

arbetsflöde

Returnera all information om själva arbetsflödet under körningen.

workflow().<property>
Parameter Krävs Typ Description
<Egenskapen> Inga Sträng Namnet på arbetsflödesegenskapen vars värde du vill ha



Som standard har ett arbetsflödesobjekt följande egenskaper: name, type, id, location, runoch tags.



– Egenskapsvärdet run är ett JSON-objekt som innehåller följande egenskaper: name, typeoch 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 Krävs Typ Description
<Värde> Ja Sträng Strängen med JSON-objektet som ska konverteras

JSON-objektet får bara ha en rotegenskap, vilket inte kan vara en matris.
Använd omvänt snedstreck (\) som escape-tecken för det dubbla citattecknet (").
Returvärde Typ Description
<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.

Anteckning

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 Krävs Typ Description
<Xml> Ja Valfri XML-strängen för att söka efter noder eller värden som matchar ett XPath-uttrycksvärde
<Xpath> Ja Valfri XPath-uttrycket som används för att hitta matchande XML-noder eller värden
Returvärde Typ Description
<xml-node> XML En XML-nod när endast en enda nod matchar det angivna XPath-uttrycket
<Värde> Valfri 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 också 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 ifylld 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 till -elementet item .

xpath(xml(parameters('items')), '/produce/item/name[1]')

Här är resultatet: Gala

Exempel 3

Efter exempel 1 skickar det här exemplet I XPath-uttrycket, '/produce/item/name[last()]', för att hitta det sista name elementet som är underordnat elementet till elementet item .

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Här är resultatet: Honeycrisp

Exempel 4

I det här exemplet antar vi 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>

I det här exemplet skickas XPath-uttrycket, '//name[@expired]', för att hitta alla name element som har attributet expired :

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 bara 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>

I det här exemplet skickas 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>

I det här exemplet skickas 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 den syntax 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 kringgå det dubbla citattecknet eftersom omvänt snedstreck automatiskt läggs till 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äs mer om arbetsflödesdefinitionsspråket