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

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

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

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

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

Funktioner i uttryck

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

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

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

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

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

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

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

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

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

• Designern utvärderar inte körningsuttryck som används som funktionsparametrar vid designtillfället. Designern kräver att alla uttryck kan utvärderas fullständigt vid designtillfället.

• Funktionsparametrar utvärderas från vänster till höger.

• I syntaxen för parameterdefinitioner innebär ett frågetecken (?) som visas efter en parameter att parametern är valfri. Se till exempel getFutureTime().

• Funktionsuttryck som visas i rad med oformaterad text kräver att klammerparenteser omsluts ({}) för att använda uttryckets interpolerade format i stället. Det här formatet hjälper till att undvika parsningsproblem. Om funktionsuttrycket inte visas i stil med oformaterad text krävs inga klammerparenteser.

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

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

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

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

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

Strängfunktioner

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

Samlingsfunktioner

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

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.

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.

Implicita datatypskonverteringar

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

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

triggerBody()?['123']

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

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

Base64-kodning och avkodning

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

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

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.

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.

Arbetsflödesfunktioner

Dessa arbetsflödesfunktioner kan hjälpa dig:

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

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

URI tolkningsfunktioner

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

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.

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

Alla funktioner – alfabetisk lista

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

A

action

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

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

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

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

actions

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

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

Example

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

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

Och returnerar det här resultatet: "Succeeded"

add

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

add(<summand_1>, <summand_2>)

Example

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

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

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

Exempel 1

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

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

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

Exempel 2

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

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

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

addProperty

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

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

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

Exempel 1

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

Exempel 2

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

addSeconds

Lägg till sekunder i en tidsstämpel.

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

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

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"

and

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

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

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.

array

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

array('<value>')

Example

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.

base64('<value>')

Example

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.

base64ToBinary('<value>')

Example

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.

base64ToString('<value>')

Example

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

base64ToString('aGVsbG8=')

Och returnerar det här resultatet: "hello"

binary

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

binary('<value>')

Example

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

body

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

body('<actionName>')

Example

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

body('Get_user')

Och returnerar det här resultatet:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

bool

Returnera den booleska versionen av ett värde.

bool(<value>)

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.

Outputs

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

C

chunk

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

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

Exempel 1

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

chunk('abcdefghijklmnopqrstuvwxyz', 10)

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

Exempel 2

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

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

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

coalesce

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

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

Example

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

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

Och returnerar följande resultat:

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

concat

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

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

Example

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

concat('Hello', 'World')

Och returnerar det här resultatet: "HelloWorld"

contains

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

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

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

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

Exempel 1

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

contains('hello world', 'world')

Exempel 2

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

contains('hello world', 'universe')

convertFromUtc

Konvertera en tidsstämpel från Koordinerad universell tid (UTC) till målzonen.

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

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älla tidszon till mål tidszon.

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

Exempel 1

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

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

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

Exempel 2

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

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

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

convertToUtc

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

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

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

Example

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

Example

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')

Example

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

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

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

Example

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

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

Och returnerar det här resultatet: "hello"

dateDifference

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

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

Example

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

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

dayOfMonth('<timestamp>')

Example

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

Example

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

Example

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.

decimal('<value>')

Exempel 1

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

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exempel 2

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

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

exempel 3

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

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

Exempel 4

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

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

decodeBase64 (inaktuell)

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

decodeDataUri

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

decodeDataUri('<value>')

Example

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

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

Och returnerar det här resultatet: "hello"

decodeUriComponent

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

decodeUriComponent('<value>')

Example

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. För att få resterande resultat, använd mod().

div(<dividend>, <divisor>)

Exempel 1

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

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

Exempel 2

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

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

E

encodeUriComponent

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

encodeUriComponent('<value>')

Example

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

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

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

empty

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

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

Example

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

Exempel 1

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

endsWith('hello world', 'world')

Och returnerar det här resultatet: true

Exempel 2

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

endsWith('hello world', 'universe')

Och returnerar det här resultatet: false

equals

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

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

Example

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

first

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

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

Example

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

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

Och returnera dessa resultat:

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

float

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

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

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

exempel 3

Exempel på oväntat giltiga indata:

float('12,3,4,5678')  //Returns   12345678
float('1234567,8+')   //Returns   12345678
float('12345,6,78,-') //Returns  -12345678
float('-12,345,678,') //Returns  -12345678
float('12345678.-')   //Returns  -12345678
float('.12345678')    //Returns 0.12345678

formatDateTime

Returnera en tidsstämpel i det angivna formatet.

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

Examples

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

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

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

Example

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

formDataMultiValues('Send_an_email', 'Subject')

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

formDataValue

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

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

Example

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

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.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.00', 'is-IS')

exempel 3

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

formatNumber(17.35, 'C2')

Exempel 4

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

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

G

getFutureTime

Skicka tillbaka den aktuella tidsstämpeln plus de angivna tidsenheterna.

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

Exempel 1

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

getFutureTime(5, 'Day')

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

Exempel 2

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

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

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

getPastTime

Returnera den aktuella tidsstämpeln med de angivna tidsenheterna mindre.

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

Exempel 1

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

getPastTime(5, 'Day')

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

Exempel 2

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

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

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

greater

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

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

Example

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

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

Och returnera dessa resultat:

• Första exemplet: true
• Andra exemplet: false

greaterOrEquals

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

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

Example

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

Example

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

guid('P')

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

I

if

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

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

Example

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

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

Example

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

Example

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

Exempel 1

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

isFloat('10,000.00')

Och returnerar det här resultatet: true

Exempel 2

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

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

Och returnerar det här resultatet: true

isInt

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

isInt('<string>')

Example

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

isInt('10')

Och returnerar det här resultatet: true

item

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

Example

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

items

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

Example

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

Example

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

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

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

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

Exempel 1

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

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

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

Exempel 2

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

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

Och returnerar det här resultatet:

{
  "fullName": "Sophia Owen"
}

exempel 3

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

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

Och returnerar det här resultatet:

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

Exempel 4

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

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

Och returnerar det här resultatet:

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

intersection

Returnera en samling som bara har gemensamma objekt 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>', ...)

Example

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

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

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

join

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

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

Example

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

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

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

L

last

Returnera det sista objektet från en samling.

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

Example

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

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

• Om endast strängvärdet är tomt returnerar -1funktionen .

• Om både sträng- och delsträngsvärdena är tomma returnerar 0funktionen .

• Om endast delsträngsvärdet är tomt returnerar funktionen stränglängden minus 1.

Examples

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

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

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

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

length

Returnera antalet objekt i en samling.

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

Example

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

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

Och returnera det här resultatet: 4

less

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

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

Example

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

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

Och returnera dessa resultat:

• Första exemplet: true
• Andra exemplet: false

lessOrEquals

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

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

Example

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

Example

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

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

max

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

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

Example

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>, ...])

Example

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 vid division av två tal. För att få heltalsresultatet, se div().

mod(<dividend>, <divisor>)

Exempel 1

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

mod(3, 2)

Och returnerar det här resultatet: 1

Exempel 2

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

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

Exemplet returnerar följande resultat:

• Första exemplet: -1
• Andra exemplet: 1

mul

Återge produkten av att multiplicera två tal.

mul(<multiplicand1>, <multiplicand2>)

Example

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

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

Och returnera dessa resultat:

• Första exemplet: 2
• Andra exemplet 3

multipartBody

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

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

N

not

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

not(<expression>)

Exempel 1

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

not(false)
not(true)

Och returnera dessa resultat:

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

Exempel 2

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

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

Och returnera dessa resultat:

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

nthIndexOf

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

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

Examples

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

or

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>, ...)

Exempel 1

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

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

Och returnera dessa resultat:

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

Exempel 2

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

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

Och returnera dessa resultat:

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

outputs

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

outputs('<actionName>')

Example

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

outputs('Get_user')

Och returnerar det här resultatet:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

parameters

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

parameters('<parameterName>')

Example

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

Examples

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('20190521', 'fr-fr', 'yyyyMMdd') // 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>)

Example

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

rand(1, 5)

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

range

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

range(<startIndex>, <count>)

Example

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

range(1, 4)

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

removeProperty

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

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

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

Exempel 1

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

Exempel 2

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

replace

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

Example

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

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

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

result

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

Du kan till exempel använda den här funktionen för att hämta resultatet från misslyckade åtgärder så att du kan diagnostisera och hantera undantag. För mer information, se Få kontext och resultat för misslyckanden.

result('<scopedActionName>')

Example

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

reverse

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

reverse([<collection>])

Example

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

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

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

S

setProperty

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

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

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

Exempel 1

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

Exempel 2

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

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

Här är det aktuella JSON-objektet:

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

Här är det uppdaterade JSON-objektet:

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

skip

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

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

Example

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]

slice

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

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

Examples

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sort

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

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

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

Exempel 1

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

split('a_b_c', '_')

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

Exempel 2

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

split('a_b_c', ' ')

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

startOfDay

Returnera dagens start för en tidsstämpel.

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

Example

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

Example

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

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

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

startOfMonth

Returnera ett värde som representerar början av månaden för en tidsstämpel.

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

Exempel 1

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

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

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

Exempel 2

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

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

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

startsWith

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

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

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

string

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

string(<value>)

Exempel 1

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

string(10)

Och returnerar det här resultatet: "10"

Exempel 2

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

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

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

sub

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

sub(<minuend>, <subtrahend>)

Example

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

substring

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

Example

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

substring('hello world', 6, 5)

Och returnerar det här resultatet: "world"

subtractFromTime

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

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

Exempel 1

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

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

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

Exempel 2

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

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

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

T

take

Returnera objekt från framsidan av en samling.

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

Example

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

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

Och returnera dessa resultat:

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

ticks

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

ticks('<timestamp>')

toLower

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

toLower('<text>')

Example

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

toLower('Hello World')

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

toUpper

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

toUpper('<text>')

Example

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

toUpper('Hello World')

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

trigger

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

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

• I en utlösares villkor returnerar den här funktionen utdata från den aktuella körningen.

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

trigger()

triggerBody

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

triggerBody()

triggerFormDataMultiValues

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

triggerFormDataMultiValues('<key>')

Example

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

triggerFormDataMultiValues('feedUrl')

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

triggerFormDataValue

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

triggerFormDataValue('<key>')

Example

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

triggerFormDataValue('feedUrl')

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

triggerMultipartBody

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

triggerMultipartBody(<index>)

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

trim

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

trim('<text>')

Example

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

trim(' Hello World  ')

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

U

union

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

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

Example

Det här exemplet hämtar alla objekten 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 är uriComponent() att föredra.

uriComponent('<value>')

Example

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

Example

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

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

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

uriComponentToString

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

uriComponentToString('<value>')

Example

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

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

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

uriHost

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

uriHost('<uri>')

Example

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

Example

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

Example

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

Example

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

Example

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

Example

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 parametern <format>.

Examples

utcNow()                  // Returns 2025-09-25T05:18:31.3384797Z
utcNow('u')               // Returns 2025-09-25 05:18:31Z
utcNow('U')               // Returns Thursday, September 25, 2025 5:18:31 AM
utcNow('d')               // Returns 9/25/2025
utcNow('D')               // Returns Thursday, September 25, 2025
utcNow('t')               // Returns 5:18 AM
utcNow('T')               // Returns 5:18:31 AM
utcNow('y')               // Returns September 2025
utcNow('yyyy')            // Returns 2025
utcNow('ddd, d MMM yyyy') // Returns Thu, 25 Sep 2025

V

variables

Returnera värdet för en angiven variabel.

variables('<variableName>')

Example

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

workflow

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

workflow().<property>

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

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>

Exempel 4

Funktionen xml() förväntar sig antingen ett objekt eller en sträng som innehåller giltig XML. Funktionen accepterar inte en råmatris som indata.

Om dina data är en JSON-sträng kan du använda json() funktionen för att konvertera strängen till ett JSON-objekt innan du skickar resultatet till funktionen, till xml() exempel:

xml(
  json('{"root":{"array":[
    { "ID": 1, "Name": "James" },
    { "ID": 2, "Name": "John" },
    { "ID": 3, "Name": "Sam" }
  ]}}')
)

Om du har en JSON-matris, som i följande exempel, har du två alternativ.

[
  { "ID": 1, "Name": "James" },
  { "ID": 2, "Name": "John" },
  { "ID": 3, "Name": "Sam" }
]

Alternativ 1: Lagra JSON-matrisen i en Skriv-åtgärd med namnet Compose1. Använd outputs() sedan funktionen för att returnera ett JSON-objekt från Compose1.

{
  "root": {
    "array": @{outputs('Compose1')}
  }
}

Lagra det returnerade JSON-objektet i en annan åtgärd med namnet Compose2. Du kan sedan använda xml() funktionerna och outputs() för att skapa XML från JSON-objektutdata från Compose2, till exempel:

xml(outputs('Compose2'))

Alternativ 2: Lagra JSON-matrisen i en Skriv-åtgärd med namnet Compose1. Använd outputs()sedan funktionerna , concat(), json()och xml() för att skapa XML från JSON-objektutdata, till exempel:

xml(
  json(
    concat(
      '{"root":{"array":',
      outputs('Compose1'),
      '}}'
    )
  )
)

Alla tre exemplen, som inkluderar JSON-strängdataexemplet, alternativ 1 och alternativ 2, returnerar följande XML-resultat:

<root>
  <array>
    <ID>1</ID>
    <Name>James</Name>
  </array>
  <array>
    <ID>2</ID>
    <Name>John</Name>
  </array>
  <array>
    <ID>3</ID>
    <Name>Sam</Name>
  </array>
</root>

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.

xpath('<xml>', '<xpath>')

Exempel 1

Anta att du har den här 'items' XML-strängen:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Det här exemplet skickar XPath-uttrycket , '/produce/item/name/text()'för att hitta noderna som matchar <name></name> noden i XML-strängen 'items' och returnerar en matris med dessa nodvärden:

xpath(xml(parameters('items')), '/produce/item/name/text()')

I exemplet används även funktionen parameters() för att hämta XML-strängen från 'items' och konvertera strängen till XML-format med hjälp av funktionen xml().

Här är resultatmatrisen som fylls med värden för de noder som matchar <name></name>:

[ Gala, Honeycrisp ]

Exempel 2

I exempel 1 skickas det här exemplet i XPath-uttrycket , '/produce/item/name[1]'för att hitta det första name elementet som är underordnat elementet item .

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

Här är resultatet: Gala

exempel 3

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

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

Här är resultatet: Honeycrisp

Exempel 4

I det här exemplet antar du att XML-strängen items också innehåller attributen expired='true' och expired='false':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

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

xpath(xml(parameters('items')), '//name[@expired]')

Här är resultatet: [ Gala, Honeycrisp ]

Exempel 5

I det här exemplet antar vi att XML-strängen items endast innehåller det här attributet: expired = 'true'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

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

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Här är resultatet: [ Gala ]

Exempel 6

I det här exemplet antar vi att XML-strängen items också innehåller följande attribut:

• expired='true' price='12'
• expired='false' price='40'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Det här exemplet skickas i XPath-uttrycket , '//name[@price>35]'för att hitta alla name element som har price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Här är resultatet: Honeycrisp

Exempel 7

I det här exemplet antar vi att XML-strängen items är samma som i exempel 1:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Det här exemplet hittar noder som matchar <count></count> noden och lägger till dessa nodvärden med sum() funktionen:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Här är resultatet: 30

Exempel 8

I det här exemplet antar vi att du har den här XML-strängen, som innehåller XML-dokumentnamnområdet: xmlns="https://contoso.com"

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

Dessa uttryck använder antingen XPath-uttryck /*[name()="file"]/*[name()="location"] eller /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], för att hitta noder som matchar <location></location> noden. De här exemplen visar syntaxen som du använder i designern eller i uttrycksredigeraren:

• xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
• xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

Här är resultatnoden som matchar den <location></location> noden:

<location xmlns="https://contoso.com">Paris</location>

Exempel 9

I exempel 8 använder det här exemplet XPath-uttrycket, , 'string(/*[name()="file"]/*[name()="location"])'för att hitta värdet i <location></location> noden:

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

Här är resultatet: Paris

Nästa steg

Lär dig mer om arbetsflödesdefinitionsspråket