Referentiehandleiding voor functies in expressies voor werkstromen in Azure Logic Apps en Power Automate

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Voor werkstroomdefinities in Azure Logic Apps en Power Automate halen sommige expressies hun waarden op uit runtimeacties die mogelijk nog niet bestaan wanneer uw werkstroom wordt uitgevoerd. Als u naar de waarden in deze expressies wilt verwijzen of verwerken, kunt u expressiefuncties gebruiken die worden geleverd door de taal van de werkstroomdefinitie.

U kunt bijvoorbeeld waarden berekenen met behulp van wiskundige functies, zoals de functie add(), wanneer u de som van gehele getallen of floats wilt berekenen. Hier volgen andere voorbeeldtaken die u met functies kunt uitvoeren:

Bekijk de volgende tabellen om functies te vinden op basis van hun algemeen gebruik. Zie de alfabetische lijst voor gedetailleerde informatie over elke functie.

Functies in expressies

Als u wilt laten zien hoe u een functie in een expressie gebruikt, ziet u in dit voorbeeld hoe u de waarde van de customerName parameter kunt ophalen en die waarde kunt toewijzen aan de accountName eigenschap met behulp van de functie parameters() in een expressie:

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

Hier volgen enkele andere algemene manieren waarop u functies in expressies kunt gebruiken:

De concat() functie kan bijvoorbeeld twee of meer tekenreekswaarden als parameters gebruiken. Deze functie combineert deze tekenreeksen in één tekenreeks. U kunt letterlijke tekenreeksen doorgeven, bijvoorbeeld "Sophia" en "Owen" zodat u een gecombineerde tekenreeks krijgt, "SophiaOwen":

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

U kunt ook tekenreekswaarden ophalen uit parameters. In dit voorbeeld wordt de parameters() functie in elke concat() parameter en de firstName parameters gebruikt lastName . Vervolgens geeft u de resulterende tekenreeksen door aan de concat() functie, zodat u een gecombineerde tekenreeks krijgt, bijvoorbeeld 'SophiaOwen':

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

In beide voorbeelden wordt het resultaat aan de customerName eigenschap toegewezen.

Overwegingen voor het gebruik van functies

• De ontwerpfunctie evalueert geen runtime-expressies die tijdens het ontwerp worden gebruikt als functieparameters. De ontwerpfunctie vereist dat alle expressies volledig kunnen worden geëvalueerd tijdens het ontwerp.

• Functieparameters worden van links naar rechts geëvalueerd.

• In de syntaxis voor parameterdefinities, een vraagteken (?) dat wordt weergegeven na een parameter betekent dat de parameter optioneel is. Zie bijvoorbeeld getFutureTime().

• Voor functie-expressies die inline met tekst zonder opmaak worden weergegeven, moeten accolades ({}) worden geplaatst om de geïnterpoleerde indeling van de expressie te gebruiken. Met deze indeling voorkomt u parseringsproblemen. Als uw functie-expressie niet inline met tekst zonder opmaak wordt weergegeven, zijn er geen accolades nodig.

  In het volgende voorbeeld ziet u de juiste en onjuiste syntaxis:

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

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

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

In de volgende secties worden functies ingedeeld op basis van hun algemeen gebruik of kunt u deze functies in alfabetische volgorde doorzoeken.

Stringfuncties

Als u met tekenreeksen wilt werken, kunt u deze tekenreeksfuncties en ook enkele verzamelingsfunctiesgebruiken. Tekenreeksfuncties werken alleen op tekenreeksen.

Verzamelingsfuncties

Als u wilt werken met verzamelingen, over het algemeen matrices, tekenreeksen en soms woordenlijsten, kunt u deze verzamelingsfuncties gebruiken.

Logische vergelijkingsfuncties

Als u met voorwaarden wilt werken, waarden en expressieresultaten wilt vergelijken of verschillende soorten logica wilt evalueren, kunt u deze logische vergelijkingsfuncties gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

Conversiefuncties

Als u het type of de indeling van een waarde wilt wijzigen, kunt u deze conversiefuncties gebruiken. U kunt bijvoorbeeld een waarde van een Booleaanse waarde wijzigen in een geheel getal. Zie Inhoudstypen verwerken voor meer informatie over hoe Azure Logic Apps inhoudstypen verwerkt tijdens de conversie. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

Impliciete conversies van gegevenstypen

Azure Logic Apps wordt automatisch of impliciet geconverteerd tussen bepaalde gegevenstypen, dus u hoeft deze conversies niet handmatig uit te voeren. Als u bijvoorbeeld niet-tekenreekswaarden gebruikt waarbij tekenreeksen worden verwacht als invoer, worden de niet-tekenreekswaarden automatisch geconverteerd naar tekenreeksen.

Stel dat een trigger een numerieke waarde retourneert als uitvoer:

triggerBody()?['123']

Als u deze numerieke uitvoer gebruikt waarbij tekenreeksinvoer wordt verwacht, zoals een URL, converteert Azure Logic Apps de waarde automatisch naar een tekenreeks met behulp van de accolades ({}) notatie:

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

Base64-codering en -decodering

Azure Logic Apps voert automatisch of impliciet base64-codering of -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de bijbehorende functies:

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

Wiskundige functies

Als u wilt werken met gehele getallen en floats, kunt u deze wiskundige functies gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

Datum- en tijdfuncties

Als u met datums en tijden wilt werken, kunt u deze datum- en tijdfuncties gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

Werkstroomfuncties

Deze werkstroomfuncties kunnen u helpen:

• Meer informatie over een werkstroomexemplaren tijdens runtime.
• Werk samen met de invoer die wordt gebruikt voor het instantiëren van logische apps of stromen.
• Verwijs naar de uitvoer van triggers en acties.

U kunt bijvoorbeeld verwijzen naar de uitvoer van één actie en die gegevens in een latere actie gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

URI-parseringsfuncties

Als u wilt werken met uniform resource-id's (URI's) en verschillende eigenschapswaarden voor deze URI's wilt ophalen, kunt u deze URI-parseringsfuncties gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

Manipulatiefuncties: JSON & XML

Als u wilt werken met JSON-objecten en XML-knooppunten, kunt u deze bewerkingsfuncties gebruiken. Zie de alfabetische lijst voor de volledige naslaginformatie over elke functie.

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

Alle functies - alfabetische lijst

In deze sectie worden alle beschikbare functies in alfabetische volgorde weergegeven.

A

action

Retourneert de uitvoer van de huidige actie tijdens runtime of waarden van andere JSON-naam- en waardeparen, die u kunt toewijzen aan een expressie. Deze functie verwijst standaard naar het hele actieobject, maar u kunt desgewenst een eigenschap opgeven waarvan u de gewenste waarde wilt. Zie ook acties().

U kunt de action() functie alleen op deze plaatsen gebruiken:

• De unsubscribe eigenschap voor een webhookactie, zodat u toegang hebt tot het resultaat van de oorspronkelijke subscribe aanvraag
• De trackedProperties eigenschap voor een actie
• De do-until lusvoorwaarde voor een actie

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

actions

Retourneert de uitvoer van een actie tijdens runtime of waarden uit andere JSON-naam- en waardeparen, die u kunt toewijzen aan een expressie. De functie verwijst standaard naar het hele actieobject, maar u kunt desgewenst een eigenschap opgeven waarvan u de gewenste waarde wilt. Zie body()voor verkorte versies. Zie action()voor de huidige actie.

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

Example

In dit voorbeeld wordt de status eigenschapswaarde opgehaald van de X-actie Get user tijdens runtime:

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

Retourneert dit resultaat: "Succeeded"

add

Retourneert het resultaat van het optellen van twee getallen.

add(<summand_1>, <summand_2>)

Example

In dit voorbeeld worden de opgegeven getallen toegevoegd:

add(1, 1.5)

Retourneert dit resultaat: 2.5

addDays

Dagen toevoegen aan een tijdstempel.

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

Voorbeeld 1

In dit voorbeeld wordt 10 dagen toegevoegd aan het opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-25T00:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf dagen afgetrokken van de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-10T00:00:00.0000000Z"

addHours

Uren toevoegen aan een tijdstempel.

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

Voorbeeld 1

In dit voorbeeld wordt 10 uur toegevoegd aan de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T10:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf uur afgetrokken van de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T10:00:00.0000000Z"

addMinutes

Voeg minuten toe aan een tijdstempel.

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

Voorbeeld 1

In dit voorbeeld wordt 10 minuten toegevoegd aan het opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T00:20:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf minuten afgetrokken van de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T00:15:00.0000000Z"

addProperty

Voeg een eigenschap en de bijbehorende waarde of naam-waardepaar toe aan een JSON-object en retourneer het bijgewerkte object. Als de eigenschap al bestaat tijdens runtime, mislukt de functie en treedt er een fout op.

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

Als u een bovenliggende eigenschap wilt toevoegen aan een bestaande eigenschap, gebruikt u de setProperty() functie, niet de addProperty() functie. Anders retourneert de functie alleen het onderliggende object als uitvoer.

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

Voorbeeld 1

In dit voorbeeld wordt de middleName eigenschap toegevoegd aan een JSON-object, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON( ). Het object bevat al de firstName en surName eigenschappen. De functie wijst de opgegeven waarde toe aan de nieuwe eigenschap en retourneert het bijgewerkte object:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

Voorbeeld 2

In dit voorbeeld wordt de middleName onderliggende eigenschap toegevoegd aan de bestaande customerName eigenschap in een JSON-object, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON( ). De functie wijst de opgegeven waarde toe aan de nieuwe eigenschap en retourneert het bijgewerkte object:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

addSeconds

Voeg seconden toe aan een tijdstempel.

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

Voorbeeld 1

In dit voorbeeld wordt 10 seconden toegevoegd aan de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T00:00:10.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt vijf seconden afgetrokken van de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-03-15T00:00:25.0000000Z"

addToTime

Voeg de opgegeven tijdseenheden toe aan een tijdstempel. Zie ook getFutureTime().

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

Voorbeeld 1

In dit voorbeeld wordt één dag toegevoegd aan de opgegeven tijdstempel:

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

Retourneert dit resultaat: "2018-01-02T00:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt één dag toegevoegd aan de opgegeven tijdstempel:

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

En retourneert het resultaat met de optionele D-indeling: "Tuesday, January 2, 2018"

and

Controleer of alle expressies waar zijn. Retourneer waar als alle expressies waar zijn of als er ten minste één expressie onwaar is.

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

Voorbeeld 1

In deze voorbeelden wordt gecontroleerd of de opgegeven Booleaanse waarden allemaal waar zijn:

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

En retourneert deze resultaten:

• Eerste voorbeeld: Beide expressies zijn waar, dus retourneert true.
• Tweede voorbeeld: Één expressie is onwaar, dus retourneert false.
• Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false.

Voorbeeld 2

In deze voorbeelden wordt gecontroleerd of de opgegeven expressies waar zijn:

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

En retourneert deze resultaten:

• Eerste voorbeeld: Beide expressies zijn waar, dus retourneert true.
• Tweede voorbeeld: Één expressie is onwaar, dus retourneert false.
• Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false.

array

Retourneert een matrix van één opgegeven invoer. Zie createArray()voor meerdere invoerwaarden.

array('<value>')

Example

In dit voorbeeld wordt een matrix gemaakt op basis van de 'hallo'-tekenreeks:

array('hello')

Retourneert dit resultaat: ["hello"]

B

base64

Retourneert de base64-gecodeerde versie voor een tekenreeks.

base64('<value>')

Example

In dit voorbeeld wordt de 'hello'-tekenreeks geconverteerd naar een met base64 gecodeerde tekenreeks:

base64('hello')

Retourneert dit resultaat: "aGVsbG8="

base64ToBinary

Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.

base64ToBinary('<value>')

Example

In dit voorbeeld wordt de met base64 gecodeerde tekenreeks 'aGVsbG8=' geconverteerd naar een binaire tekenreeks:

base64ToBinary('aGVsbG8=')

Stel dat u een HTTP-actie gebruikt om een aanvraag te verzenden. U kunt base64ToBinary() een met base64 gecodeerde tekenreeks converteren naar binaire gegevens en die gegevens verzenden met behulp van het application/octet-stream inhoudstype in de aanvraag.

base64ToString

Retourneer de tekenreeksversie voor een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd. Gebruik deze functie in plaats van decodeBase64(), die is afgeschaft.

base64ToString('<value>')

Example

In dit voorbeeld wordt de met base64 gecodeerde tekenreeks 'aGVsbG8=' geconverteerd naar alleen een tekenreeks:

base64ToString('aGVsbG8=')

Retourneert dit resultaat: "hello"

binary

Retourneert de binaire versie met base64-codering van een tekenreeks.

binary('<value>')

Example

U gebruikt bijvoorbeeld een HTTP-actie die een afbeelding of videobestand retourneert. U kunt binary() de waarde converteren naar een met base 64 gecodeerd inhoudsenvelopmodel. Vervolgens kunt u de inhoudsvelop opnieuw gebruiken in andere acties, zoals Compose. U kunt deze functie-expressie gebruiken om de tekenreeksbytes te verzenden met het application/octet-stream inhoudstype in de aanvraag.

body

Retourneert de uitvoer van body een actie tijdens runtime. Afkorting voor actions('<actionName>').outputs.body. Zie acties().

body('<actionName>')

Example

In dit voorbeeld wordt de body uitvoer opgehaald van de Get user X-actie:

body('Get_user')

En dit geeft het volgende resultaat:

"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

Retourneert de Booleaanse versie van een waarde.

bool(<value>)

Als u een object gebruikt bool() , moet de waarde van het object een tekenreeks of geheel getal zijn dat kan worden geconverteerd naar Booleaanse waarde.

Outputs

In deze voorbeelden ziet u de verschillende ondersteunde typen invoer voor bool():

C

chunk

Splits een tekenreeks of matrix in segmenten van gelijke lengte.

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

Voorbeeld 1

In dit voorbeeld wordt een tekenreeks gesplitst in segmenten van lengte 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

Retourneert dit resultaat: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Voorbeeld 2

In dit voorbeeld wordt een matrix gesplitst in segmenten van lengte 5.

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

Retourneert dit resultaat: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

coalesce

Retourneert de eerste niet-null-waarde van een of meer parameters. Lege tekenreeksen, lege matrices en lege objecten zijn niet null.

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

Example

Deze voorbeelden retourneren de eerste niet-null-waarde van de opgegeven waarden of null wanneer alle waarden null zijn:

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

En retourneert deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: "hello"
• Derde voorbeeld: null

concat

Combineer twee of meer tekenreeksen en retourneer de gecombineerde tekenreeks.

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

Example

In dit voorbeeld worden de tekenreeksen "Hallo" en "Wereld" gecombineerd:

concat('Hello', 'World')

Retourneert dit resultaat: "HelloWorld"

contains

Controleer of een verzameling een specifiek item heeft. Geef waar terug als het item wordt gevonden, of geef onwaar terug als het niet gevonden is. Deze functie is hoofdlettergevoelig.

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

Deze functie werkt met name op deze verzamelingstypen:

• Een tekenreeks om te zoeken naar een subtekenreeks
• Een matrix om een -waarde te vinden
• Een woordenlijst om een sleutel te vinden

Voorbeeld 1

Dit voorbeeld controleert de tekenreeks "hallo wereld" op de subtekenreeks "wereld" en retourneert true.

contains('hello world', 'world')

Voorbeeld 2

Dit voorbeeld controleert de string 'hallo wereld' op de subtekenreeks 'universum' en geeft 'onwaar' terug.

contains('hello world', 'universe')

convertFromUtc

Converteer een tijdstempel van Universal Time Coordinated (UTC) naar de doeltijdzone.

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

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven tijdzone:

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

Retourneert dit resultaat: "2018-01-01T00:00:00.0000000"

Voorbeeld 2

In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven tijdzone en indeling:

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

Retourneert dit resultaat: "Monday, January 1, 2018"

convertTimeZone

Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.

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

Voorbeeld 1

In dit voorbeeld wordt de brontijdzone geconverteerd naar de doeltijdzone:

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

Retourneert dit resultaat: "2018-01-01T00:00:00.0000000"

Voorbeeld 2

In dit voorbeeld wordt een tijdzone geconverteerd naar de opgegeven tijdzone en indeling:

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

Retourneert dit resultaat: "Monday, January 1, 2018"

convertToUtc

Converteer een tijdstempel van de brontijdzone naar Universal Time Coordinated (UTC).

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

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

Retourneert dit resultaat: "2018-01-01T08:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

Retourneert dit resultaat: "Monday, January 1, 2018"

createArray

Retourneert een matrix van meerdere invoerwaarden. Zie array()voor één invoermatrix.

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

Example

In dit voorbeeld wordt een matrix gemaakt van deze invoer:

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

Retourneert dit resultaat: ["h", "e", "l", "l", "o"]

D

dataUri

Retourneert een URI (Data Uniform Resource Identifier) voor een tekenreeks.

dataUri('<value>')

Example

In dit voorbeeld wordt een gegevens-URI gemaakt voor de 'hello'-tekenreeks:

dataUri('hello')

Retourneert dit resultaat: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retourneer de binaire versie van een gegevens-URI. Gebruik deze functie in plaats van decodeDataUri(). Hoewel beide functies op dezelfde manier werken, heeft dataUriBinary() de voorkeur.

dataUriToBinary('<value>')

Example

In dit voorbeeld wordt een binaire versie voor deze gegevens-URI gemaakt:

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

En dit geeft het volgende resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retourneert de tekenreeksversie voor een URI (Data Uniform Resource Identifier).

dataUriToString('<value>')

Example

In dit voorbeeld wordt een tekenreeks gemaakt voor deze data-URI.

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

Retourneert dit resultaat: "hello"

dateDifference

Retourneer het verschil tussen twee tijdstempels als een tijdspanne. Deze functie startDate trekt af van endDateen retourneert het resultaat als tijdstempel in tekenreeksindeling.

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

Example

In dit voorbeeld wordt de eerste waarde afgetrokken van de tweede waarde:

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

Retourneert dit resultaat: "1268.00:00:00"

dayOfMonth

Retourneer de dag van de maand uit een tijdstempel.

dayOfMonth('<timestamp>')

Example

In dit voorbeeld wordt het getal voor de dag van de maand uit deze tijdstempel geretourneerd:

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

Retourneert dit resultaat: 15

dayOfWeek

Retourneer de dag van de week vanaf een tijdstempel.

dayOfWeek('<timestamp>')

Example

In dit voorbeeld wordt het getal voor de dag van de week uit deze tijdstempel geretourneerd:

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

Retourneert dit resultaat: 4

dayOfYear

Retourneer de dag van het jaar uit een tijdstempel.

dayOfYear('<timestamp>')

Example

In dit voorbeeld wordt het aantal dagen van het jaar uit deze tijdstempel geretourneerd:

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

Retourneert dit resultaat: 74

decimal

Retourneert een decimaal getal in een tekenreeks als een decimaal getal. U kunt deze functie gebruiken wanneer u werkt met gegevens waarvoor decimale precisie is vereist en ook als invoer voor logische vergelijkingsfuncties en wiskundige functies. Als u precisie wilt vastleggen en behouden wanneer u het resultaat van de functie decimal() gebruikt, verpakt u alle decimale uitvoer met de tekenreeksfunctie. Dit gebruik wordt weergegeven in de volgende voorbeelden hieronder, waar u precisie kunt verliezen als u het decimale resultaat als een getal gebruikt.

decimal('<value>')

Voorbeeld 1

In dit voorbeeld wordt een decimaal getal gemaakt dat wordt gebruikt als een getal:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Voorbeeld 2

In dit voorbeeld wordt een decimaal gemaakt en wordt het resultaat vervolgens geconverteerd naar een tekenreeks voor precisiebehoud:

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

voorbeeld 3

In dit voorbeeld wordt een wiskundige functie gebruikt voor twee decimale getallen en wordt het resultaat als een getal gebruikt:

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

Voorbeeld 4

In dit voorbeeld wordt een wiskundige functie op twee decimale getallen gebruikt en wordt het resultaat geconverteerd naar een tekenreeks voor precisiebehoud:

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

decoderenBase64 (afgeschaft)

Deze functie is afgeschaft, dus gebruik in plaats daarvan base64ToString().

decodeDataUri

Retourneer de binaire versie van een gegevens-URI. Overweeg om dataUriToBinary()te gebruiken in plaats van decodeDataUri(). Hoewel beide functies op dezelfde manier werken, heeft dataUriToBinary() de voorkeur.

decodeDataUri('<value>')

Example

In dit voorbeeld wordt de binaire versie voor deze gegevens-URI geretourneerd:

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

Retourneert dit resultaat: "hello"

decodeUriComponent

Retourneert een tekenreeks die escape-tekens vervangt door gedecodeerde versies.

decodeUriComponent('<value>')

Example

In dit voorbeeld worden de escape-tekens in deze tekenreeks vervangen door gedecodeerde versies:

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

Retourneert dit resultaat: "https://contoso.com"

div

Retourneert het resultaat van het delen van twee getallen. Zie mod()om het restresultaat op te halen.

div(<dividend>, <divisor>)

Voorbeeld 1

Beide voorbeelden retourneren deze waarde met het type Geheel getal: 2

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

Voorbeeld 2

Beide voorbeelden retourneren deze waarde met floattype: 2.2

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

E

encodeUriComponent

Retourneert een URI-gecodeerde versie (Uniform Resource Identifier) voor een tekenreeks door URL-onveilige tekens te vervangen door escapetekens. Overweeg uriComponent()te gebruiken in plaats van encodeUriComponent(). Hoewel beide functies op dezelfde manier werken, heeft uriComponent() de voorkeur.

encodeUriComponent('<value>')

Example

In dit voorbeeld wordt een URI-gecodeerde versie voor deze tekenreeks gemaakt:

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

Retourneert dit resultaat: "https%3A%2F%2Fcontoso.com"

empty

Controleer of een verzameling leeg is. Geef true terug wanneer de verzameling leeg is, of geef false terug wanneer deze niet leeg is.

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

Example

In deze voorbeelden wordt gecontroleerd of de opgegeven verzamelingen leeg zijn:

empty('')
empty('abc')

En retourneert deze resultaten:

• Eerste voorbeeld: Geeft een lege tekenreeks door, zodat de functie trueretourneert.
• Tweede voorbeeld: geeft de tekenreeks 'abc' door, zodat de functie falseretourneert.

endsWith

Controleer of een tekenreeks eindigt met een specifieke subtekenreeks. Retourneer true wanneer de subtekenreeks wordt gevonden, of retourneer false wanneer deze niet wordt gevonden. Deze functie is niet hoofdlettergevoelig.

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

Voorbeeld 1

In dit voorbeeld wordt gecontroleerd of de string 'hello world' eindigt op de string 'world'.

endsWith('hello world', 'world')

Retourneert dit resultaat: true

Voorbeeld 2

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' eindigt op de tekenreeks 'universum':

endsWith('hello world', 'universe')

Retourneert dit resultaat: false

equals

Controleer of beide waarden, expressies of objecten gelijkwaardig zijn. Retourneer waar wanneer beide gelijkwaardig zijn of retourneer onwaar als ze niet gelijkwaardig zijn.

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

Example

Deze voorbeelden controleren of de opgegeven invoer gelijkwaardig is.

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

En retourneert deze resultaten:

• Eerste voorbeeld: Beide waarden zijn gelijkwaardig, dus de functie retourneert true.
• Tweede voorbeeld: Beide waarden zijn niet gelijkwaardig, dus de functie retourneert false.

F

first

Retourneert het eerste item uit een tekenreeks of matrix.

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

Example

In deze voorbeelden vindt u het eerste item in deze verzamelingen:

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

En retourneer deze resultaten:

• Eerste voorbeeld: "h"
• Tweede voorbeeld: 0

float

Converteer een tekenreeksversie voor een drijvendekommagetal naar een werkelijk drijvendekommagetal. U kunt deze functie alleen gebruiken wanneer u aangepaste parameters doorgeeft aan een app, bijvoorbeeld een werkstroom voor een logische app of Power Automate-stroom. Als u drijvende-kommatekenreeksen wilt converteren die worden weergegeven in landinstellingen, kunt u desgewenst een RFC 4646-landinstellingscode opgeven.

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

Voorbeeld 1

In dit voorbeeld wordt een tekenreeks gemaakt voor dit drijvende kommagetal.

float('10,000.333')

Retourneert dit resultaat: 10000.333

Voorbeeld 2

In dit voorbeeld wordt een tekenreeksversie gemaakt voor dit drijvendekommagetal in Duitse stijl:

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

Retourneert dit resultaat: 10000.333

voorbeeld 3

Voorbeelden van onverwacht geldige invoer:

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

Retourneert een tijdstempel in de opgegeven indeling.

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

Retourneert een matrix met waarden die overeenkomen met een sleutelnaam in de formuliergegevens of formuliercoderingsuitvoer van een actie.

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

Example

In dit voorbeeld wordt een matrix gemaakt op basis van de waarde van de onderwerpsleutel in de formuliergegevens of formuliercoderingsuitvoer van de opgegeven actie:

formDataMultiValues('Send_an_email', 'Subject')

En retourneert de onderwerptekst in een matrix, bijvoorbeeld: ["Hello world"]

formDataValue

Retourneert één waarde die overeenkomt met een sleutelnaam in de formuliergegevens of formuliercoderingsuitvoer van een actie. Als de functie meer dan één overeenkomst vindt, genereert de functie een fout.

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

Example

In dit voorbeeld wordt een tekenreeks gemaakt op basis van de waarde van de onderwerpsleutel in de formuliergegevens of de formulier-gecodeerde uitvoer van de opgegeven actie:

formDataValue('Send_an_email', 'Subject')

En retourneert de onderwerptekst als een tekenreeks, bijvoorbeeld: "Hello world"

formatNumber

Retourneert een getal als een tekenreeks die is gebaseerd op de opgegeven notatie.

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

Voorbeeld 1

Stel dat u het getal 1234567890wilt opmaken. In dit voorbeeld wordt dat getal opgemaakt als de tekenreeks '1.234.567.890,00'.

formatNumber(1234567890, '#,##0.00', 'en-US')

*Voorbeeld 2"

Stel dat u het getal 1234567890wilt opmaken. In dit voorbeeld wordt het getal opgemaakt naar de tekenreeks 1.234.567.890,00.

formatNumber(1234567890, '#,##0.00', 'is-IS')

voorbeeld 3

Stel dat u het getal 17.35wilt opmaken. In dit voorbeeld wordt het getal opgemaakt naar de tekenreeks $17,35.

formatNumber(17.35, 'C2')

Voorbeeld 4

Stel dat u het getal 17.35wilt opmaken. In dit voorbeeld wordt het getal opgemaakt naar de tekenreeks 17,35 kr.

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

G

getFutureTime

Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden.

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

Voorbeeld 1

Stel dat de huidige tijdstempel 2018-03-01T00:00:00.0000000Z is. In dit voorbeeld worden vijf dagen aan die tijdstempel toegevoegd:

getFutureTime(5, 'Day')

Retourneert dit resultaat: "2018-03-06T00:00:00.0000000Z"

Voorbeeld 2

Stel dat de huidige tijdstempel 2018-03-01T00:00:00.0000000Z is. In dit voorbeeld worden vijf dagen toegevoegd en wordt het resultaat geconverteerd naar de indeling D:

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

Retourneert dit resultaat: "Tuesday, March 6, 2018"

getPastTime

Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden.

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

Voorbeeld 1

Stel dat de huidige tijdstempel 2018-02-01T00:00:00.0000000Z is. In dit voorbeeld wordt vijf dagen afgetrokken van die tijdstempel:

getPastTime(5, 'Day')

Retourneert dit resultaat: "2018-01-27T00:00:00.0000000Z"

Voorbeeld 2

Stel dat de huidige tijdstempel 2018-02-01T00:00:00.0000000Z is. In dit voorbeeld wordt vijf dagen afgetrokken en wordt het resultaat geconverteerd naar de indeling D:

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

Retourneert dit resultaat: "Saturday, January 27, 2018"

greater

Controleer of de eerste waarde groter is dan de tweede waarde. Geeft waar terug wanneer de eerste waarde meer is, of geeft onwaar terug als deze kleiner is.

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

Example

In deze voorbeelden wordt gecontroleerd of de eerste waarde groter is dan de tweede waarde:

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

En retourneer deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

greaterOrEquals

Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneer waar wanneer de eerste waarde groter dan of gelijk is aan de tweede waarde, of retourneer onwaar wanneer de eerste waarde kleiner is.

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

Example

In deze voorbeelden wordt gecontroleerd of de eerste waarde groter of gelijk is aan de tweede waarde:

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

En retourneer deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

guid

Genereer een GUID (Globally Unique Identifier) als een tekenreeks, bijvoorbeeld 'c2ecc88d-88c8-4096-912c-d6f2e2b138ce':

guid()

U kunt ook een andere indeling opgeven voor de GUID dan de standaardindeling D. Dit zijn 32 cijfers gescheiden door afbreekstreepjes.

guid('<format>')

Example

In dit voorbeeld wordt dezelfde GUID gegenereerd, maar als 32 cijfers, gescheiden door afbreekstreepjes en tussen haakjes:

guid('P')

Retourneert dit resultaat: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde. Parameters worden van links naar rechts geëvalueerd.

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

Example

In dit voorbeeld wordt "yes" geretourneerd omdat de opgegeven expressie waar retourneert. Anders retourneert het voorbeeld "no":

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

indexOf

Retourneert de beginpositie of indexwaarde voor een subtekenreeks. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.

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

Example

In dit voorbeeld wordt de beginindexwaarde voor de subtekenreeks 'wereld' gevonden in de tekenreeks 'hallo wereld':

indexOf('hello world', 'world')

Retourneert dit resultaat: 6

int

Converteer de tekenreeksversie voor een geheel getal naar een werkelijk geheel getal.

int('<value>')

Example

In dit voorbeeld wordt een geheel getal versie gemaakt van de tekenreeks "10".

int('10')

Retourneert dit resultaat: 10

isFloat

Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een drijvendekommagetal is. Deze functie maakt standaard gebruik van de invariante cultuur voor de drijvendekommage-indeling. Als u drijvendekommagenummers wilt identificeren die worden weergegeven in andere landinstellingen, kunt u desgewenst een RFC 4646-landinstellingscode opgeven.

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

Voorbeeld 1

In dit voorbeeld wordt gecontroleerd of een tekenreeks een drijvendekommagetal is in de invariante cultuur:

isFloat('10,000.00')

Retourneert dit resultaat: true

Voorbeeld 2

In dit voorbeeld wordt gecontroleerd of een tekenreeks een drijvendekommagetal is in de Duitse landinstelling:

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

Retourneert dit resultaat: true

isInt

Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een geheel getal is.

isInt('<string>')

Example

In dit voorbeeld wordt gecontroleerd of een tekenreeks een geheel getal is:

isInt('10')

Retourneert dit resultaat: true

item

Wanneer u in een herhalende actie over een matrix wordt gebruikt, retourneert u het huidige item in de matrix tijdens de huidige iteratie van de actie. U kunt ook de waarden ophalen uit de eigenschappen van dat item.

item()

Example

In dit voorbeeld wordt het body element opgehaald uit het huidige bericht voor de actie 'Send_an_email' in de huidige iteratie van elke lus:

item().body

items

Retourneer het huidige item uit elke cyclus in een for-each-lus. Gebruik deze functie binnen de lus voor elke lus.

items('<loopName>')

Example

In dit voorbeeld wordt het huidige item opgehaald uit de opgegeven lus voor elke lus:

items('myForEachLoopName')

iterationIndexes

Retourneert de indexwaarde voor de huidige iteratie binnen een Until-lus. U kunt deze functie in geneste Until-lussen gebruiken.

iterationIndexes('<loopName>')

Example

In dit voorbeeld wordt een tellervariabele gemaakt en wordt die variabele met één verhoogd tijdens elke iteratie in een Until-lus totdat de tellerwaarde vijf bereikt. In het voorbeeld wordt ook een variabele gemaakt waarmee de huidige index voor elke iteratie wordt bijgehouden. Tijdens elke iteratie in de Until-lus wordt in het voorbeeld de tellerwaarde verhoogd en vervolgens de tellerwaarde toegewezen aan de huidige indexwaarde en vervolgens de tellerwaarde verhoogd. Tijdens de lus verwijst dit voorbeeld naar de huidige iteratieindex met behulp van de iterationIndexes functie:

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

Retourneert de JSON-typewaarde (JavaScript Object Notation), het object of de matrix van objecten voor een tekenreeks of XML.

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

Voorbeeld 1

In dit voorbeeld wordt deze tekenreeks geconverteerd naar een JSON-waarde:

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

Retourneert dit resultaat: [1, 2, 3]

Voorbeeld 2

In dit voorbeeld wordt deze tekenreeks geconverteerd naar JSON:

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

En dit geeft het volgende resultaat:

{
  "fullName": "Sophia Owen"
}

voorbeeld 3

In dit voorbeeld worden de json() en xml() functies gebruikt om XML met één onderliggend element in het hoofdelement te converteren naar een JSON-object met de naam person voor dat onderliggende element:

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

En dit geeft het volgende resultaat:

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

Voorbeeld 4

In dit voorbeeld worden de json() en xml() functies gebruikt om XML met meerdere onderliggende elementen in het hoofdelement te converteren naar een matrix met de naam person JSON-objecten voor deze onderliggende elementen:

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

En dit geeft het volgende resultaat:

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

intersection

Hiermee wordt een verzameling geretourneerd die alleen de gemeenschappelijke items van de opgegeven verzamelingen bevat. Als u het resultaat wilt weergeven, moet een item worden weergegeven in alle verzamelingen die aan deze functie zijn doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.

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

Example

In dit voorbeeld worden de algemene items in deze matrices gevonden:

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

En retourneert een matrix met alleen deze items: [1, 2]

join

Retourneer een tekenreeks die alle items uit een array bevat en waarbij elk teken gescheiden is door een scheidingsteken.

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

Example

In dit voorbeeld wordt een tekenreeks gemaakt van alle items in deze matrix met het opgegeven teken als scheidingsteken:

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

Retourneert dit resultaat: "a.b.c"

L

last

Retourneer het laatste item uit een verzameling.

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

Example

In deze voorbeelden vindt u het laatste item in deze verzamelingen:

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

En retourneert deze resultaten:

• Eerste voorbeeld: "d"
• Tweede voorbeeld: 3

lastIndexOf

Retourneer de beginpositie of indexwaarde van de laatste keer dat een subtekenreeks voorkomt. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.

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

Als de tekenreeks of subtekenreekswaarde leeg is, gebeurt het volgende gedrag:

• Als alleen de tekenreekswaarde leeg is, retourneert -1de functie.

• Als de tekenreeks- en subtekenreekswaarden beide leeg zijn, retourneert 0de functie.

• Als alleen de subtekenreekswaarde leeg is, retourneert de functie de tekenreekslengte min 1.

Examples

In dit voorbeeld wordt de beginindexwaarde gevonden voor het laatste exemplaar van de subtekenreeks world in de tekenreeks hello world hello world. Het geretourneerde resultaat is 18:

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

In dit voorbeeld ontbreekt de subtekenreeksparameter en wordt een waarde 22 geretourneerd omdat de waarde van de invoertekenreeks (23) min 1 groter is dan 0.

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

length

Retourneert het aantal items in een verzameling.

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

Example

In deze voorbeelden wordt het aantal items in deze verzamelingen geteld:

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

En vervolgens retourneer dit resultaat: 4

less

Controleer of de eerste waarde kleiner is dan de tweede waarde. Retourneer true wanneer de eerste waarde kleiner is, of retourneer false wanneer de eerste waarde groter is.

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

Example

In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner is dan de tweede waarde.

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

En retourneer deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

lessOrEquals

Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneer waar als de eerste waarde kleiner is dan of gelijk is aan, of retourneer onwaar wanneer de eerste waarde meer is.

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

Example

In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner of gelijk is aan de tweede waarde.

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

En retourneer deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

listCallbackUrl

Retourneer de callback-URL die een trigger of actie aanroept. Deze functie werkt alleen met triggers en acties voor de connectortypen HttpWebhook en ApiConnectionWebhook , maar niet met de typen Handmatig, Terugkeerpatroon, HTTP en APIConnection .

listCallbackUrl()

Example

In dit voorbeeld ziet u een voorbeeld van een callback-URL die door deze functie kan worden geretourneerd:

"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

Retourneert de hoogste waarde uit een lijst of matrix met getallen die aan beide uiteinden inclusief zijn.

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

Example

In deze voorbeelden wordt de hoogste waarde opgehaald uit de set getallen en de matrix:

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

En vervolgens retourneer dit resultaat: 3

min

Retourneert de laagste waarde uit een set getallen of een matrix.

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

Example

Deze voorbeelden krijgen de laagste waarde in de set getallen en de matrix:

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

En vervolgens retourneer dit resultaat: 1

mod

Retourneert de rest van het delen van twee getallen. Zie div()om het resultaat van het gehele getal op te halen.

mod(<dividend>, <divisor>)

Voorbeeld 1

In dit voorbeeld wordt het eerste getal gedeeld door het tweede getal:

mod(3, 2)

Retourneert dit resultaat: 1

Voorbeeld 2

In dit voorbeeld ziet u dat als een of beide waarden negatief zijn, het resultaat overeenkomt met het teken van het dividend:

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

In het voorbeeld worden deze resultaten geretourneerd:

• Eerste voorbeeld: -1
• Tweede voorbeeld: 1

mul

Retourneer het product door twee getallen te vermenigvuldigen.

mul(<multiplicand1>, <multiplicand2>)

Example

In deze voorbeelden wordt het eerste getal met het tweede getal vermenigvuldigd:

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

En retourneer deze resultaten:

• Eerste voorbeeld: 2
• Tweede voorbeeld 3

multipartBody

Retourneer de hoofdtekst voor een specifiek onderdeel in de uitvoer van een actie met meerdere onderdelen.

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

N

not

Controleer of een expressie onwaar is. Retourneer waar wanneer de expressie onwaar is, of retourneer onwaar wanneer de expressie waar is.

not(<expression>)

Voorbeeld 1

Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:

not(false)
not(true)

En retourneer deze resultaten:

• Eerste voorbeeld: De expressie is onwaar, dus de functie retourneert true.
• Tweede voorbeeld: De expressie is waar, dus de functie retourneert false.

Voorbeeld 2

Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:

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

En retourneer deze resultaten:

• Eerste voorbeeld: De expressie is onwaar, dus de functie retourneert true.
• Tweede voorbeeld: De expressie is waar, dus de functie retourneert false.

nthIndexOf

Retourneert de beginpositie of indexwaarde waarbij het ndeexemplaar van een subtekenreeks wordt weergegeven in een tekenreeks.

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

Controleer of ten minste één expressie waar is. Retourneer waar wanneer ten minste één expressie waar is of retourneer onwaar als ze allemaal onwaar zijn.

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

Voorbeeld 1

In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:

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

En retourneer deze resultaten:

• Eerste voorbeeld: Ten minste één expressie is waar, dus de functie retourneert true.
• Tweede voorbeeld: Beide expressies zijn onwaar, dus de functie retourneert false.

Voorbeeld 2

In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:

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

En retourneer deze resultaten:

• Eerste voorbeeld: Ten minste één expressie is waar, dus de functie retourneert true.
• Tweede voorbeeld: Beide expressies zijn onwaar, dus de functie retourneert false.

outputs

Retourneert de uitvoer van een actie tijdens runtime.

outputs('<actionName>')

Example

In dit voorbeeld wordt de uitvoer opgehaald van de X-actie Get user:

outputs('Get_user')

En dit geeft het volgende resultaat:

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

Retourneert de waarde voor een parameter die wordt beschreven in uw werkstroomdefinitie.

parameters('<parameterName>')

Example

Stel dat u deze JSON-waarde hebt:

{
  "fullName": "Sophia Owen"
}

In dit voorbeeld wordt de waarde voor de opgegeven parameter opgehaald:

parameters('fullName')

Retourneert dit resultaat: "Sophia Owen"

parseDateTime

Retourneer de tijdstempel van een tekenreeks die een tijdstempel bevat.

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

Retourneert een willekeurig geheel getal uit een opgegeven bereik. Dit is alleen inclusief aan het begineinde.

rand(<minValue>, <maxValue>)

Example

In dit voorbeeld wordt een willekeurig geheel getal opgehaald uit het opgegeven bereik, met uitzondering van de maximumwaarde:

rand(1, 5)

En retourneert een van deze getallen als resultaat: 1, 2, 3of 4

range

Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal.

range(<startIndex>, <count>)

Example

In dit voorbeeld wordt een matrix met gehele getallen gemaakt die begint met de opgegeven index en het opgegeven aantal gehele getallen heeft:

range(1, 4)

Retourneert dit resultaat: [1, 2, 3, 4]

removeProperty

Verwijder een eigenschap uit een object en retourneer het bijgewerkte object. Als de eigenschap die u probeert te verwijderen niet bestaat, retourneert de functie het oorspronkelijke object.

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

Als u een onderliggende eigenschap uit een bestaande eigenschap wilt verwijderen, gebruikt u deze syntaxis:

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

Voorbeeld 1

In dit voorbeeld wordt de middleName eigenschap verwijderd uit een JSON-object, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON() en wordt het bijgewerkte object geretourneerd:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

Voorbeeld 2

In dit voorbeeld wordt de middleName onderliggende eigenschap verwijderd uit een customerName bovenliggende eigenschap in een JSON-object, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON() en wordt het bijgewerkte object geretourneerd:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

replace

Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de resultaattekenreeks. Deze functie is hoofdlettergevoelig.

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

Example

In dit voorbeeld wordt de subtekenreeks 'oud' in 'de oude tekenreeks' gevonden en wordt 'oud' vervangen door 'nieuw':

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

Retourneert dit resultaat: "the new string"

result

Retourneert de resultaten van de acties op het hoogste niveau in de opgegeven bereikactie, zoals een For_each, Untilof Scope actie. De result() functie accepteert één parameter, de naam van het bereik en retourneert een matrix die informatie bevat uit de acties op het eerste niveau in dat bereik. Deze actieobjecten bevatten dezelfde kenmerken als de kenmerken die door de actions() functie worden geretourneerd, zoals de begintijd, eindtijd, status, invoer, correlatie-id's en uitvoer van de actie.

U kunt deze functie bijvoorbeeld gebruiken om de resultaten van mislukte acties op te halen, zodat u uitzonderingen kunt diagnosticeren en afhandelen. Zie Context en resultaten ophalen voor fouten voor meer informatie.

result('<scopedActionName>')

Example

In dit voorbeeld worden de invoer en uitvoer van elke iteratie van een HTTP-actie in een For_each lus geretourneerd met behulp van de result() functie in de Compose actie:

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

Hier ziet u hoe het geretourneerde voorbeeldmatrix eruit kan zien waar het buitenste outputs object de invoer en uitvoer van elke iteratie van de acties in de For_each actie bevat.

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

De volgorde van items in een verzameling omkeren. Wanneer u deze functie gebruikt met sort(), kunt u een verzameling in aflopende volgorde sorteren.

reverse([<collection>])

Example

In dit voorbeeld wordt een matrix met gehele getallen omgekeerd:

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

En retourneert deze matrix: [3,2,1,0]

S

setProperty

Stel de waarde in voor de eigenschap van het JSON-object en retourneer het bijgewerkte object. Als de eigenschap die u probeert in te stellen niet bestaat, wordt de eigenschap toegevoegd aan het object. Als u een nieuwe eigenschap wilt toevoegen, gebruikt u de functie addProperty().

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

Als u de onderliggende eigenschap in een onderliggend object wilt instellen, gebruikt u in plaats daarvan een geneste setProperty() aanroep. Anders retourneert de functie alleen het onderliggende object als uitvoer.

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

Voorbeeld 1

In dit voorbeeld wordt de surName eigenschap in een JSON-object ingesteld, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON( ). De functie wijst de opgegeven waarde toe aan de eigenschap en retourneert het bijgewerkte object:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

Voorbeeld 2

In dit voorbeeld wordt de surName onderliggende eigenschap voor de customerName bovenliggende eigenschap ingesteld in een JSON-object, dat wordt geconverteerd van een tekenreeks naar JSON met behulp van de functie JSON( ). De functie wijst de opgegeven waarde toe aan de eigenschap en retourneert het bijgewerkte object:

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

Dit is het huidige JSON-object:

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

Dit is het bijgewerkte JSON-object:

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

skip

Verwijder items aan de voorzijde van een verzameling en retourneer alle andere items.

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

Example

In dit voorbeeld wordt één item, het getal 0, verwijderd van de voorzijde van de opgegeven matrix:

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

En retourneert deze matrix met de resterende items: [1,2,3]

slice

Retourneer een subtekenreeks door de begin- en eindpositie of -waarde op te geven. Zie ook subtekenreeks().

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

Items in een verzameling sorteren. U kunt de verzamelingsobjecten sorteren met een willekeurige sleutel die een eenvoudig type bevat.

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

Voorbeeld 1

In dit voorbeeld wordt een matrix met gehele getallen gesorteerd:

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

En retourneert deze matrix: [0,1,2,3]

Voorbeeld 2

In dit voorbeeld wordt een matrix met objecten gesorteerd op sleutel:

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

En retourneert deze matrix: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

split

Retourneert een matrix die subtekenreeksen bevat, gescheiden door komma's, op basis van het opgegeven scheidingsteken in de oorspronkelijke tekenreeks.

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

Voorbeeld 1

In dit voorbeeld wordt een matrix gemaakt met subtekenreeksen van de opgegeven tekenreeks op basis van het opgegeven teken als scheidingsteken:

split('a_b_c', '_')

En retourneert deze matrix als resultaat: ["a","b","c"]

Voorbeeld 2

In dit voorbeeld wordt een matrix met één element gemaakt wanneer er geen scheidingsteken bestaat in de tekenreeks:

split('a_b_c', ' ')

En retourneert deze matrix als resultaat: ["a_b_c"]

startOfDay

Retourneer het begin van de dag voor een tijdstempel.

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

Example

In dit voorbeeld wordt het begin van de dag voor deze tijdstempel gevonden:

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

Retourneert dit resultaat: "2018-03-15T00:00:00.0000000Z"

startOfHour

Retourneert het begin van het uur voor een tijdstempel.

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

Example

In dit voorbeeld wordt het begin van het uur voor deze tijdstempel gevonden:

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

Retourneert dit resultaat: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Retourneer het begin van de maand voor een tijdstempel.

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

Voorbeeld 1

Dit voorbeeld geeft het begin van de maand terug voor zijn tijdstempel.

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

Retourneert dit resultaat: "2018-03-01T00:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt het begin van de maand geretourneerd in de opgegeven indeling voor deze tijdstempel:

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

Retourneert dit resultaat: "2018-03-01"

startsWith

Controleer of een tekenreeks begint met een specifieke subtekenreeks. Retourneer true wanneer de subtekenreeks wordt gevonden, of retourneer false wanneer deze niet wordt gevonden. Deze functie is niet hoofdlettergevoelig.

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

Voorbeeld 1

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' begint met de subtekenreeks 'hallo':

startsWith('hello world', 'hello')

Retourneert dit resultaat: true

Voorbeeld 2

In dit voorbeeld wordt gecontroleerd of de tekenreeks 'hallo wereld' begint met de subtekenreeks 'begroetingen':

startsWith('hello world', 'greetings')

Retourneert dit resultaat: false

string

Retourneert de tekenreeksweergave van een waarde.

string(<value>)

Voorbeeld 1

In dit voorbeeld wordt de tekenreeksversie voor dit getal gemaakt:

string(10)

Retourneert dit resultaat: "10"

Voorbeeld 2

In dit voorbeeld wordt een tekenreeks gemaakt voor het opgegeven JSON-object en wordt het backslash-teken (\) gebruikt als een escape-teken voor het dubbele aanhalingsteken (").

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

Retourneert dit resultaat: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Retourneert het resultaat van het aftrekken van het tweede getal van het eerste getal.

sub(<minuend>, <subtrahend>)

Example

In dit voorbeeld wordt het tweede getal afgetrokken van het eerste getal:

sub(10.3, .3)

Retourneert dit resultaat: 10

substring

Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie of index. Indexwaarden beginnen met het getal 0. Zie ook slice().

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

Example

In dit voorbeeld wordt een subtekenreeks van vijf tekens gemaakt op basis van de opgegeven tekenreeks, te beginnen met de indexwaarde 6:

substring('hello world', 6, 5)

Retourneert dit resultaat: "world"

subtractFromTime

Trek een aantal tijdseenheden af van een tijdstempel. Zie ook getPastTime.

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

Voorbeeld 1

In dit voorbeeld wordt één dag afgetrokken van deze tijdstempel:

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

Retourneert dit resultaat: "2018-01-01T00:00:00.0000000Z"

Voorbeeld 2

In dit voorbeeld wordt één dag afgetrokken van deze tijdstempel:

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

En retourneert dit resultaat met de optionele D-indeling: "Monday, January, 1, 2018"

T

take

Artikelen terughalen van de voorkant van een verzameling.

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

Example

In deze voorbeelden ziet u het opgegeven aantal items aan de voorzijde van deze verzamelingen:

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

En retourneer deze resultaten:

• Eerste voorbeeld: "abc"
• Tweede voorbeeld: [0, 1, 2]

ticks

Retourneert het aantal tikken, dat intervallen van 100 nanoseconden is, sinds 1 januari 0001 12:00:00 middernacht (of DateTime.Ticks in C#) tot aan de opgegeven tijdstempel. Zie dit onderwerp voor meer informatie: DateTime.Ticks Property (System).

ticks('<timestamp>')

toLower

Retourneert een tekenreeks in kleineletterformaat. Als een teken in de tekenreeks geen kleine letterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.

toLower('<text>')

Example

In dit voorbeeld wordt deze tekenreeks geconverteerd naar kleine letters:

toLower('Hello World')

Retourneert dit resultaat: "hello world"

toUpper

Retourneert een tekenreeks in hoofdletters. Als een teken in de tekenreeks geen hoofdletterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.

toUpper('<text>')

Example

In dit voorbeeld wordt deze tekenreeks geconverteerd naar hoofdletters:

toUpper('Hello World')

Retourneert dit resultaat: "HELLO WORLD"

trigger

Retourneert de uitvoer van een trigger tijdens runtime of waarden uit andere JSON-naam- en waardeparen, die u kunt toewijzen aan een expressie.

• Binnen de invoer van een trigger retourneert deze functie de uitvoer van de vorige uitvoering.

• Binnen de voorwaarde van een trigger retourneert deze functie de uitvoer van de huidige uitvoering.

De functie verwijst standaard naar het hele triggerobject, maar u kunt desgewenst een eigenschap opgeven waarvan u de gewenste waarde wilt. Deze functie heeft ook verkorte versies beschikbaar, zie triggerOutputs() en triggerBody().

trigger()

triggerBody

Retourneert de uitvoer van body een trigger tijdens runtime. Afkorting voor trigger().outputs.body. Zie trigger().

triggerBody()

triggerFormDataMultiValues

Retourneert een matrix met waarden die overeenkomen met een sleutelnaam in de formuliergegevens of formuliercoderingsuitvoer van een trigger.

triggerFormDataMultiValues('<key>')

Example

In dit voorbeeld wordt een matrix gemaakt op basis van de sleutelwaarde feedUrl in de formuliergegevens of formuliercoderingsuitvoer van een RSS-trigger:

triggerFormDataMultiValues('feedUrl')

En retourneert deze matrix als voorbeeldresultaat: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Retourneert een tekenreeks met één waarde die overeenkomt met een sleutelnaam in de formuliergegevens of formuliercoderingsuitvoer van een trigger. Als de functie meer dan één overeenkomst vindt, genereert de functie een fout.

triggerFormDataValue('<key>')

Example

In dit voorbeeld wordt een tekenreeks gemaakt op basis van de sleutelwaarde feedUrl in de formuliergegevens van een RSS-trigger of door een formulier gecodeerde uitvoer:

triggerFormDataValue('feedUrl')

En retourneert deze tekenreeks als voorbeeldresultaat: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Retourneer de hoofdtekst voor een specifiek onderdeel in de uitvoer van een trigger met meerdere onderdelen.

triggerMultipartBody(<index>)

triggerOutputs

Retourneert de uitvoer van een trigger tijdens runtime of waarden van andere JSON-naam- en waardeparen. Afkorting voor trigger().outputs. Zie trigger().

triggerOutputs()

trim

Verwijder voorloop- en volgspaties uit een tekenreeks en retourneer de bijgewerkte tekenreeks.

trim('<text>')

Example

In dit voorbeeld wordt de voorloop- en volgspaties verwijderd uit de tekenreeks 'Hallo wereld':

trim(' Hello World  ')

Retourneert dit resultaat: "Hello World"

U

union

Geef een verzameling terug met alle items uit de opgegeven verzamelingen. Om in het resultaat te verschijnen, kan een item in elke collectie voorkomen die aan deze functie is doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.

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

Example

In dit voorbeeld haalt alle items uit deze verzamelingen op:

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

Retourneert dit resultaat: [1, 2, 3, 10, 101]

uriComponent

Retourneert een URI-gecodeerde versie (Uniform Resource Identifier) voor een tekenreeks door URL-onveilige tekens te vervangen door escapetekens. Gebruik deze functie in plaats van encodeUriComponent(). Hoewel beide functies op dezelfde manier werken, heeft uriComponent() de voorkeur.

uriComponent('<value>')

Example

In dit voorbeeld wordt een URI-gecodeerde versie voor deze tekenreeks gemaakt:

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

Retourneert dit resultaat: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retourneert de binaire versie voor een URI-onderdeel (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Example

In dit voorbeeld wordt de binaire versie voor deze URI-gecodeerde tekenreeks gemaakt:

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

Retourneert dit resultaat: "aHR0cHM6Ly9jb250b3NvLmNvbQ=="

uriComponentToString

Retourneert de tekenreeksversie voor een URI-gecodeerde tekenreeks (Uniform Resource Identifier), waardoor de URI-gecodeerde tekenreeks effectief wordt gedecodeerd.

uriComponentToString('<value>')

Example

In dit voorbeeld wordt de gedecodeerde tekenreeksversie gemaakt voor deze URI-gecodeerde tekenreeks:

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

Retourneert dit resultaat: "https://contoso.com"

uriHost

Retourneert de host waarde voor een uniform resource-id (URI).

uriHost('<uri>')

Example

In dit voorbeeld wordt de host waarde voor deze URI gevonden:

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

Retourneert dit resultaat: "www.localhost.com"

uriPath

Retourneert de path waarde voor een uniform resource-id (URI).

uriPath('<uri>')

Example

In dit voorbeeld wordt de path waarde voor deze URI gevonden:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

Retourneert dit resultaat: "/catalog/shownew.htm"

uriPathAndQuery

Retourneert de path en query waarden voor een uniform resource-id (URI).

uriPathAndQuery('<uri>')

Example

In dit voorbeeld worden de path en query waarden voor deze URI gevonden:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

Retourneert dit resultaat: "/catalog/shownew.htm?date=today"

uriPort

Retourneert de port waarde voor een uniform resource-id (URI).

uriPort('<uri>')

Example

In dit voorbeeld wordt de port waarde voor deze URI geretourneerd:

uriPort('https://www.localhost:8080')

Retourneert dit resultaat: 8080

uriQuery

Retourneert de query waarde voor een uniform resource-id (URI).

uriQuery('<uri>')

Example

In dit voorbeeld wordt de query waarde voor deze URI geretourneerd:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

Retourneert dit resultaat: "?date=today"

uriScheme

Retourneert de scheme waarde voor een uniform resource-id (URI).

uriScheme('<uri>')

Example

In dit voorbeeld wordt de scheme waarde voor deze URI geretourneerd:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

Retourneert dit resultaat: "http"

utcNow

Retourneer de huidige tijdstempel.

utcNow('<format>')

U kunt desgewenst een andere indeling opgeven met de <-indeling> parameter.

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

Retourneert de waarde voor een opgegeven variabele.

variables('<variableName>')

Example

Stel dat de huidige waarde voor een variabele numItems 20 is. In dit voorbeeld wordt de waarde van het gehele getal voor deze variabele opgehaald:

variables('numItems')

Retourneert dit resultaat: 20

W

workflow

Retourneer alle details over de werkstroom zelf tijdens de runtime.

workflow().<property>

Voorbeeld 1

In dit voorbeeld wordt de naam voor de huidige uitvoering van een werkstroom geretourneerd:

workflow().run.name

Voorbeeld 2

Als u Power Automate gebruikt, kunt u een @workflow() expressie maken die gebruikmaakt van de tags uitvoereigenschap om de waarden op te halen uit de of flowDisplayName eigenschap van uw stroomenvironmentName.

U kunt bijvoorbeeld aangepaste e-mailmeldingen verzenden vanuit de stroom zelf die een koppeling naar uw stroom maken. Deze meldingen kunnen een HTML-koppeling bevatten die de weergavenaam van de stroom in de e-mailtitel bevat en deze syntaxis volgt:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Retourneert de XML-versie voor een tekenreeks die een JSON-object bevat.

xml('<value>')

Voorbeeld 1

In dit voorbeeld wordt de tekenreeks geconverteerd naar XML:

xml('<name>Sophia Owen</name>')

En retourneert dit resultaat-XML:

<name>Sophia Owen</name>

Voorbeeld 2

In dit voorbeeld wordt de XML-versie voor deze tekenreeks gemaakt, die een JSON-object bevat:

xml(json('{ "name": "Sophia Owen" }'))

En retourneert dit resultaat-XML:

<name>Sophia Owen</name>

voorbeeld 3

Stel dat u dit JSON-object hebt:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

In dit voorbeeld wordt XML gemaakt voor een tekenreeks die dit JSON-object bevat:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

En retourneert dit resultaat-XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

Voorbeeld 4

De xml() functie verwacht een object of een tekenreeks die geldige XML bevat. De functie accepteert geen onbewerkte matrix als invoer.

Als uw gegevens een JSON-tekenreeks zijn, kunt u de json() functie gebruiken om de tekenreeks te converteren naar een JSON-object voordat u het resultaat doorgeeft aan de xml() functie, bijvoorbeeld:

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

Als u een JSON-matrix hebt, zoals in het volgende voorbeeld, hebt u twee opties.

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

Optie 1: Sla de JSON-matrix op in een actie Opstellen met de naam Compose1. Gebruik vervolgens de outputs() functie om een JSON-object uit Compose1 te retourneren.

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

Sla het geretourneerde JSON-object op in een andere actie met de naam Compose2. Vervolgens kunt u de xml() en outputs() functies gebruiken om XML te maken op basis van de JSON-objectuitvoer van Compose2, bijvoorbeeld:

xml(outputs('Compose2'))

Optie 2: Sla de JSON-matrix op in een actie Opstellen met de naam Compose1. Gebruik vervolgens de outputs()functies , json()concat()en xml() functies om XML te maken op basis van de uitvoer van het JSON-object, bijvoorbeeld:

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

Alle drie de voorbeelden, waaronder het voorbeeld van JSON-tekenreeksgegevens, optie 1 en optie 2, retourneren het volgende XML-resultaat:

<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

Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden. Met een XPath-expressie of alleen XPath kunt u navigeren in een XML-documentstructuur, zodat u knooppunten of rekenwaarden in de XML-inhoud kunt selecteren.

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

Voorbeeld 1

Stel dat u deze 'items' XML-tekenreeks hebt:

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

In dit voorbeeld wordt de XPath-expressie doorgegeven om '/produce/item/name/text()'de knooppunten te vinden die overeenkomen met het <name></name> knooppunt in de 'items' XML-tekenreeks en wordt een matrix geretourneerd met deze knooppuntwaarden:

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

In het voorbeeld wordt ook de functie parameters() gebruikt om de XML-tekenreeks op te halen en 'items' de tekenreeks te converteren naar XML-indeling met behulp van de functie XML( ).

Hier volgt de resultaatmatrix die is gevuld met waarden van de knooppunten die overeenkomen <name></name>:

[ Gala, Honeycrisp ]

Voorbeeld 2

Na voorbeeld 1 wordt in dit voorbeeld de XPath-expressie '/produce/item/name[1]'doorgegeven om het eerste name element te vinden dat het onderliggende element van het item element is.

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

Dit is het resultaat: Gala

voorbeeld 3

Na voorbeeld 1 geeft dit voorbeeld de XPath-expressie '/produce/item/name[last()]'door om het laatste name element te vinden dat het onderliggende element van het item element is.

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

Dit is het resultaat: Honeycrisp

Voorbeeld 4

In dit voorbeeld bevat uw items XML-tekenreeks ook de kenmerken en expired='true'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>

In dit voorbeeld wordt de XPath-expressie '//name[@expired]'doorgegeven om alle name elementen te vinden die het expired kenmerk hebben:

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

Dit is het resultaat: [ Gala, Honeycrisp ]

Voorbeeld 5

In dit voorbeeld bevat uw items XML-tekenreeks alleen dit kenmerk: 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>

In dit voorbeeld wordt de XPath-expressie '//name[@expired = 'true']'doorgegeven om alle name elementen te vinden die het kenmerk hebben: expired = 'true'

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

Dit is het resultaat: [ Gala ]

Voorbeeld 6

In dit voorbeeld bevat uw items XML-tekenreeks ook de volgende kenmerken:

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

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

In dit voorbeeld wordt de XPath-expressie '//name[@price>35]'doorgegeven om alle name elementen price > 35met:

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

Dit is het resultaat: Honeycrisp

Voorbeeld 7

Stel dat uw items XML-tekenreeks in dit voorbeeld hetzelfde is als in voorbeeld 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>

In dit voorbeeld worden knooppunten gevonden die overeenkomen met het <count></count> knooppunt en worden deze knooppuntwaarden toegevoegd met de sum() functie:

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

Dit is het resultaat: 30

Voorbeeld 8

In dit voorbeeld hebt u deze XML-tekenreeks, die de XML-documentnaamruimte bevat: xmlns="https://contoso.com"

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

Deze expressies gebruiken XPath-expressies /*[name()="file"]/*[name()="location"] of /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]om knooppunten te vinden die overeenkomen met het <location></location> knooppunt. In deze voorbeelden ziet u de syntaxis die u gebruikt in de ontwerpfunctie of in de expressie-editor:

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

Dit is het resultaatknooppunt dat overeenkomt met het <location></location>-knooppunt:

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

Voorbeeld 9

In dit voorbeeld wordt in dit voorbeeld de XPath-expressie 'string(/*[name()="file"]/*[name()="location"])'gebruikt om de waarde in het <location></location> knooppunt te vinden:

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

Dit is het resultaat: Paris

Volgende stappen

Meer informatie over de taal van de werkstroomdefinitie