Referentiehandleiding voor werkstroomexpressiefuncties 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.

Notitie

Deze referentiepagina is van toepassing op zowel Azure Logic Apps als Power Automate, maar wordt weergegeven in de documentatie van Azure Logic Apps. Hoewel deze pagina specifiek verwijst naar werkstromen voor logische apps, werken deze functies voor zowel stromen als werkstromen voor logische apps. Raadpleeg Expressies gebruiken in voorwaarden voor meer informatie over functies en expressies in Power Automate.

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:

Opdracht	Functiesyntaxis	Resultaat
Retourneert een tekenreeks in kleine letters.	toLower('<text>') Bijvoorbeeld: toLower('Hello')	"hallo"
Retourneert een GUID (Globally Unique Identifier).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

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:

Opdracht	Functiesyntaxis in een expressie
Werk met een item door dat item door te geven aan een functie.	"@<functionName>(<item>)"
1. Haal de waarde van de parameterName op met behulp van de geneste parameters() functie. 2. Werk met het resultaat door die waarde door te geven aan functionName.	"@<functionName>(parameters('<parameterName>')"
1. Haal het resultaat op uit de geneste functie functionName. 2. Geef het resultaat door aan de buitenste functie functionName2.	"@<functionName2>(<functionName>(<item>)"
1. Haal het resultaat op uit functionName. 2. Aangezien het resultaat een object met property PropertyName is, haalt u de waarde van die eigenschap op.	"@<functionName>(<item).<>propertyName>"

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.

Tekenreeksfuncties

Als u met tekenreeksen wilt werken, kunt u deze tekenreeksfuncties en ook enkele verzamelingsfuncties gebruiken. Tekenreeksfuncties werken alleen voor tekenreeksen.

Tekenreeksfunctie	Opdracht
chunk	Splits een tekenreeks of verzameling in segmenten van gelijke lengte.
concat	Combineer twee of meer tekenreeksen en retourneer de gecombineerde tekenreeks.
endsWith	Controleer of een tekenreeks eindigt met de opgegeven subtekenreeks.
formatNumber	Een getal retourneren als een tekenreeks op basis van de opgegeven notatie
Guid	Genereer een GUID (Globally Unique Identifier) als een tekenreeks.
indexOf	De beginpositie voor een subtekenreeks retourneren.
isFloat	Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een drijvendekommagetal is.
isInt	Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een geheel getal is.
lastIndexOf	Retourneert de beginpositie voor het laatste exemplaar van een subtekenreeks.
length	Retourneert het aantal items in een tekenreeks of matrix.
nthIndexOf	Retourneert de beginpositie of indexwaarde waarbij het ndeexemplaar van een subtekenreeks wordt weergegeven in een tekenreeks.
replace	Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de bijgewerkte tekenreeks.
slice	Retourneer een subtekenreeks door de begin- en eindpositie of -waarde op te geven. Zie ook de subtekenreeks.
split	Retourneert een matrix die subtekenreeksen bevat, gescheiden door komma's, van een grotere tekenreeks op basis van een opgegeven scheidingsteken in de oorspronkelijke tekenreeks.
startsWith	Controleer of een tekenreeks begint met een specifieke subtekenreeks.
Subtekenreeks	Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie. Zie ook segment.
toLower	Retourneert een tekenreeks in kleine letters.
toUpper	Retourneert een tekenreeks in hoofdletters.
trim	Verwijder voorloop- en volgspaties uit een tekenreeks en retourneer de bijgewerkte tekenreeks.

Verzamelingsfuncties

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

Verzamelingsfunctie	Opdracht
chunk	Splits een tekenreeks of verzameling in segmenten van gelijke lengte.
Bevat	Controleer of een verzameling een specifiek item heeft.
empty	Controleer of een verzameling leeg is.
eerste	Retourneert het eerste item uit een verzameling.
kruispunt	Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen.
item	Als deze functie in een herhalende actie over een matrix wordt weergegeven, retourneert u het huidige item in de matrix tijdens de huidige iteratie van de actie.
join	Hiermee wordt een tekenreeks geretourneerd die alle items uit een matrix bevat, gescheiden door het opgegeven teken.
laatste	Retourneer het laatste item uit een verzameling.
length	Retourneert het aantal items in een tekenreeks of matrix.
reverse	De volgorde van items in een matrix omkeren.
skip	Verwijder items aan de voorzijde van een verzameling en retourneer alle andere items.
sort	Items in een verzameling sorteren.
nemen	Items retourneren van de voorzijde van een verzameling.
unie	Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat.

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.

Notitie

Als u logische functies of voorwaarden gebruikt om waarden te vergelijken, worden null-waarden geconverteerd naar lege tekenreekswaarden (""waarden). Het gedrag van voorwaarden verschilt wanneer u vergelijkt met een lege tekenreeks in plaats van een null-waarde. Zie de functie string() voor meer informatie.

Logische vergelijkingsfunctie	Opdracht
and	Controleer of alle expressies waar zijn.
is gelijk aan	Controleer of beide waarden gelijkwaardig zijn.
greater	Controleer of de eerste waarde groter is dan de tweede waarde.
greaterOrEquals	Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde.
if	Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.
isFloat	Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een drijvendekommagetal is.
isInt	Retourneert een Booleaanse waarde die aangeeft of een tekenreeks een geheel getal is.
less	Controleer of de eerste waarde kleiner is dan de tweede waarde.
lessOrEquals	Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde.
niet	Controleer of een expressie onwaar is.
or	Controleer of ten minste één expressie waar is.

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.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht weergavegedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Impliciete gegevenstypeconversies voor meer informatie.

Conversiefunctie	Opdracht
array	Retourneert een matrix van één opgegeven invoer. Zie CreateArray voor meerdere invoerwaarden.
base64	Retourneert de base64-gecodeerde versie voor een tekenreeks.
base64ToBinary	Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.
base64ToString	Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks.
binair	Retourneert de binaire versie voor een invoerwaarde.
bool	Retourneert de Boole-versie voor een invoerwaarde.
createArray	Retourneert een matrix van meerdere invoerwaarden.
dataUri	Retourneert de gegevens-URI voor een invoerwaarde.
dataUriToBinary	Retourneert de binaire versie voor een gegevens-URI.
dataUriToString	Retourneert de tekenreeksversie voor een gegevens-URI.
decimaal	Retourneert het decimaal getal voor een decimale tekenreeks.
decoderenBase64	Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks.
decodeDataUri	Retourneert de binaire versie voor een gegevens-URI.
decodeUriComponent	Retourneert een tekenreeks die escape-tekens vervangt door gedecodeerde versies.
encodeUriComponent	Retourneert een tekenreeks die URL-onveilige tekens vervangt door escapetekens.
drijven	Retourneert een drijvende-kommanummer voor een invoerwaarde.
int	Retourneert de gehele versie voor een tekenreeks.
json	Retourneert de JSON-typewaarde (JavaScript Object Notation) of het object voor een tekenreeks of XML.
snaar	Retourneert de tekenreeksversie voor een invoerwaarde.
uriComponent	Retourneert de URI-gecodeerde versie voor een invoerwaarde door URL-onveilige tekens te vervangen door escapetekens.
uriComponentToBinary	Retourneert de binaire versie voor een URI-gecodeerde tekenreeks.
uriComponentToString	Retourneert de tekenreeksversie voor een URI-gecodeerde tekenreeks.
xml	Retourneer de XML-versie voor een tekenreeks.

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

Notitie

Als u een van deze functies handmatig toevoegt terwijl u de ontwerpfunctie gebruikt, rechtstreeks naar een trigger of actie of met behulp van de expressie-editor, navigeert u weg van de ontwerpfunctie en keert u terug naar de ontwerpfunctie, verdwijnt de functie uit de ontwerpfunctie, waarbij alleen de parameterwaarden achterblijven. Dit gedrag treedt ook op als u een trigger of actie selecteert die deze functie gebruikt zonder de parameterwaarden van de functie te bewerken. Dit resultaat is alleen van invloed op de zichtbaarheid van de functie en niet op het effect. In de codeweergave wordt de functie niet beïnvloed. Als u echter de parameterwaarden van de functie bewerkt, worden de functie en het effect ervan beide verwijderd uit de codeweergave, waarbij alleen de parameterwaarden van de functie worden achtergelaten.

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.

Wiskundige functie	Opdracht
add	Retourneert het resultaat van het optellen van twee getallen.
div	Retourneert het resultaat van het delen van twee getallen.
max	Retourneert de hoogste waarde uit een set getallen of een matrix.
min	Retourneert de laagste waarde uit een set getallen of een matrix.
Mod	Retourneert de rest van het delen van twee getallen.
mul	Retourneer het product van het vermenigvuldigen van twee getallen.
rand	Retourneert een willekeurig geheel getal uit een opgegeven bereik.
range	Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal.
sub	Retourneert het resultaat van het aftrekken van het tweede getal van het eerste getal.

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.

Datum- of tijdfunctie	Opdracht
addDays	Dagen toevoegen aan een tijdstempel.
addHours	Uren toevoegen aan een tijdstempel.
addMinutes	Voeg minuten toe aan een tijdstempel.
addSeconds	Voeg seconden toe aan een tijdstempel.
addToTime	Voeg opgegeven tijdseenheden toe aan een tijdstempel. Zie ook getFutureTime.
convertFromUtc	Converteer een tijdstempel van Universal Time Coordinated (UTC) naar de doeltijdzone.
convertTimeZone	Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.
convertToUtc	Converteer een tijdstempel van de brontijdzone naar Universal Time Coordinated (UTC).
dateDifference	Retourneert het verschil tussen twee datums als een tijdspanne.
dayOfMonth	Retourneer de dag van het maandonderdeel uit een tijdstempel.
dayOfWeek	Retourneert de dag van de weekcomponent uit een tijdstempel.
dayOfYear	Retourneer de dag van het jaaronderdeel uit een tijdstempel.
formatDateTime	Retourneer de datum uit een tijdstempel.
getFutureTime	Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden. Zie ook addToTime.
getPastTime	Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden. Zie ook aftrekkenVanTijd.
parseDateTime	Retourneer de tijdstempel van een tekenreeks die een tijdstempel bevat.
startOfDay	Retourneer het begin van de dag voor een tijdstempel.
startOfHour	Retourneert het begin van het uur voor een tijdstempel.
startOfMonth	Retourneer het begin van de maand voor een tijdstempel.
aftrekkenFromTime	Trek een aantal tijdseenheden af van een tijdstempel. Zie ook getPastTime.
Teken	Retourneert de ticks eigenschapswaarde voor een opgegeven tijdstempel.
utcNow	Retourneert de huidige tijdstempel als een tekenreeks.

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.

Werkstroomfunctie	Opdracht
action	Retourneert de uitvoer van de huidige actie tijdens runtime of waarden van andere JSON-naam- en waardeparen. Zie ook acties.
Acties	Retourneert de uitvoer van een actie tijdens runtime of waarden van andere JSON-naam- en waardeparen. Zie ook actie.
hoofdtekst	Retourneert de uitvoer van body een actie tijdens runtime.
formDataMultiValues	Maak een matrix met de waarden die overeenkomen met een sleutelnaam in uitvoer van formuliergegevens of door formulieren gecodeerde actie.
formDataValue	Retourneert één waarde die overeenkomt met een sleutelnaam in de formuliergegevens of formuliercoderingsuitvoer van een actie.
item	Als deze functie in een herhalende actie over een matrix wordt weergegeven, retourneert u het huidige item in de matrix tijdens de huidige iteratie van de actie.
Items	Als deze functie in een Foreach- of Until-lus wordt weergegeven, retourneert u het huidige item uit de opgegeven lus.
iterationIndexes	Als deze functie in een Until-lus wordt weergegeven, retourneert u de indexwaarde voor de huidige iteratie. U kunt deze functie in geneste Until-lussen gebruiken.
listCallbackUrl	Retourneer de callback-URL die een trigger of actie aanroept.
multipartBody	Retourneer de hoofdtekst voor een specifiek onderdeel in de uitvoer van een actie met meerdere onderdelen.
Uitgangen	Retourneert de uitvoer van een actie tijdens runtime.
parameters	Retourneert de waarde voor een parameter die wordt beschreven in uw werkstroomdefinitie.
resultaat	Retourneert de invoer en uitvoer van de acties op het hoogste niveau binnen de opgegeven actie met bereik, zoals For_each, Untilen Scope.
activeren	Retourneert de uitvoer van een trigger tijdens runtime of van andere JSON-naam- en waardeparen. Zie ook triggerOutputs en triggerBody.
triggerBody	Retourneert de uitvoer van body een trigger tijdens runtime. Zie trigger.
triggerFormDataValue	Retourneert één waarde die overeenkomt met een sleutelnaam in uitvoer van formuliergegevens of met formuliercodering gecodeerde triggers.
triggerMultipartBody	Retourneer de hoofdtekst voor een specifiek onderdeel in de uitvoer van een trigger met meerdere onderdelen.
triggerFormDataMultiValues	Maak een matrix waarvan de waarden overeenkomen met een sleutelnaam in uitvoer van formuliergegevens of door formulieren gecodeerde triggers.
triggerOutputs	Retourneert de uitvoer van een trigger tijdens runtime of waarden van andere JSON-naam- en waardeparen. Zie trigger.
Variabelen	Retourneert de waarde voor een opgegeven variabele.
werkstroom	Retourneer alle details over de werkstroom zelf tijdens de runtime.

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.

URI-parseringsfunctie	Opdracht
uriHost	Retourneert de host waarde voor een uniform resource-id (URI).
URIPath	Retourneert de path waarde voor een uniform resource-id (URI).
uriPathAndQuery	Retourneert de path en query waarden voor een uniform resource-id (URI).
uriPort	Retourneert de port waarde voor een uniform resource-id (URI).
uriQuery	Retourneert de query waarde voor een uniform resource-id (URI).
uriScheme	Retourneert de scheme waarde voor een uniform resource-id (URI).

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.

Manipulatiefunctie	Opdracht
addProperty	Voeg een eigenschap en de bijbehorende waarde of naam-waardepaar toe aan een JSON-object en retourneer het bijgewerkte object.
samensmelten	Retourneert de eerste niet-null-waarde van een of meer parameters.
removeProperty	Verwijder een eigenschap uit een JSON-object en retourneer het bijgewerkte object.
setProperty	Stel de waarde in voor de eigenschap van een JSON-object en retourneer het bijgewerkte object.
xpath	Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden.

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

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>

Parameter	Vereist	Type	Description
<eigenschap>	Nee	String	De naam van de eigenschap van het actieobject waarvan u de gewenste waarde wilt: naam, startTime, endTime, invoer, uitvoer, status, code, trackingId en clientTrackingId. In Azure Portal kunt u deze eigenschappen vinden door de details van een specifieke uitvoeringsgeschiedenis te bekijken. Zie REST API - Werkstroomuitvoeringsacties voor meer informatie.

Retourwaarde	Type	Description
<actie-uitvoer>	String	De uitvoer van de huidige actie of eigenschap

acties

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.

Tip

De actions() functie retourneert uitvoer als een tekenreeks. Als u moet werken met een geretourneerde waarde als een JSON-object, moet u eerst de tekenreekswaarde converteren. U kunt de tekenreekswaarde transformeren naar een JSON-object met behulp van de actie JSON parseren.

Notitie

Eerder kunt u de actions() functie of het conditions element gebruiken wanneer u opgeeft dat een actie is uitgevoerd op basis van de uitvoer van een andere actie. Als u echter expliciet afhankelijkheden tussen acties wilt declareren, moet u nu de eigenschap van runAfter de afhankelijke actie gebruiken. Zie Voor meer informatie over de runAfter eigenschap Catch and handle failures with the runAfter property.

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

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De naam voor het actieobject waarvan u de uitvoer wilt
<eigenschap>	Nee	String	De naam van de eigenschap van het actieobject waarvan u de gewenste waarde wilt: naam, startTime, endTime, invoer, uitvoer, status, code, trackingId en clientTrackingId. In Azure Portal kunt u deze eigenschappen vinden door de details van een specifieke uitvoeringsgeschiedenis te bekijken. Zie REST API - Werkstroomuitvoeringsacties voor meer informatie.

Retourwaarde	Type	Description
<actie-uitvoer>	String	De uitvoer van de opgegeven actie of eigenschap

Voorbeeld

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

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

En retourneert dit resultaat: "Succeeded"

add

Retourneert het resultaat van het optellen van twee getallen.

add(<summand_1>, <summand_2>)

Parameter	Vereist	Type	Description
<>summand_1, <summand_2>	Ja	Geheel getal, float of gemengd	De getallen die moeten worden toegevoegd

Retourwaarde	Type	Description
<result-sum>	Geheel getal of float	Het resultaat van het toevoegen van de opgegeven getallen

Voorbeeld

In dit voorbeeld worden de opgegeven getallen toegevoegd:

add(1, 1.5)

En retourneert dit resultaat: 2.5

addDays

Dagen toevoegen aan een tijdstempel.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<Dagen>	Ja	Geheel getal	Het positieve of negatieve aantal dagen dat moet worden toegevoegd
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	Het tijdstempel plus het opgegeven aantal dagen

Voorbeeld 1

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

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

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

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

addHours

Uren toevoegen aan een tijdstempel.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<hours>	Ja	Geheel getal	Het positieve of negatieve aantal uren dat moet worden toegevoegd
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	Het tijdstempel plus het opgegeven aantal uren

Voorbeeld 1

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

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

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

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

addMinutes

Voeg minuten toe aan een tijdstempel.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<minutes>	Ja	Geheel getal	Het positieve of negatieve aantal minuten dat moet worden toegevoegd
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De tijdstempel plus het opgegeven aantal minuten

Voorbeeld 1

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

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

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

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object waaraan u een eigenschap wilt toevoegen
<eigenschap>	Ja	String	De naam van de eigenschap die moet worden toegevoegd
<value>	Ja	Alle	De waarde voor de eigenschap

Retourwaarde	Type	Description
<bijgewerkt-object>	Object	Het bijgewerkte JSON-object met de opgegeven eigenschap

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object waaraan u een eigenschap wilt toevoegen
<bovenliggende eigenschap>	Ja	String	De naam voor de bovenliggende eigenschap waaraan u de onderliggende eigenschap wilt toevoegen
<onderliggende eigenschap>	Ja	String	De naam voor de onderliggende eigenschap die moet worden toegevoegd
<value>	Ja	Alle	De waarde die moet worden ingesteld voor de opgegeven eigenschap

Retourwaarde	Type	Description
<bijgewerkt-object>	Object	Het bijgewerkte JSON-object waarvan u de eigenschap hebt ingesteld

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<Seconden>	Ja	Geheel getal	Het positieve of negatieve aantal seconden dat moet worden toegevoegd
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De tijdstempel plus het opgegeven aantal seconden

Voorbeeld 1

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

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

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

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden toegevoegd
<timeUnit>	Ja	String	De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	Het tijdstempel plus het opgegeven aantal tijdseenheden

Voorbeeld 1

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

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

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

en

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

Parameter	Vereist	Type	Description
<expressie1>, <expressie2>, ...	Ja	Booleaanse waarde	De expressies die moeten worden gecontroleerd

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar wanneer alle expressies waar zijn. Retourneer onwaar wanneer ten minste één expressie onwaar is.

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: Een 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: Een expressie is onwaar, dus retourneert false.
• Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false.

matrix

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

array('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks voor het maken van een matrix

Retourwaarde	Type	Description
[<waarde>]	Matrix	Een matrix die de enkele opgegeven invoer bevat

Voorbeeld

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

array('hello')

En retourneert dit resultaat: ["hello"]

B

base64

Retourneert de base64-gecodeerde versie voor een tekenreeks.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch gebruikt, kunt u onverwacht renderinggedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Base64-codering en -decodering voor meer informatie.

base64('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De invoertekenreeks

Retourwaarde	Type	Description
<base64-string>	String	De base64-gecodeerde versie voor de invoertekenreeks

Voorbeeld

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

base64('hello')

En retourneert dit resultaat: "aGVsbG8="

base64ToBinary

Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht weergavegedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Base64-codering en -decodering voor meer informatie.

base64ToBinary('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De met base64 gecodeerde tekenreeks die moet worden geconverteerd

Retourwaarde	Type	Description
<binary-for-base64-string>	String	De binaire versie voor de met base64 gecodeerde tekenreeks

Voorbeeld

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.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht weergavegedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Base64-codering en -decodering voor meer informatie.

base64ToString('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De met base64 gecodeerde tekenreeks om te decoderen

Retourwaarde	Type	Description
<decoded-base64-string>	String	De tekenreeksversie voor een met base64 gecodeerde tekenreeks

Voorbeeld

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

base64ToString('aGVsbG8=')

En retourneert dit resultaat: "hello"

binair

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

binary('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks die moet worden geconverteerd

Retourwaarde	Type	Description
<binary-for-input-value>	String	De met base64 gecodeerde binaire versie voor de opgegeven tekenreeks

Voorbeeld

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.

hoofdtekst

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

body('<actionName>')

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De naam voor de uitvoer van body de actie die u wilt

Retourwaarde	Type	Description
<action-body-output>	String	De body uitvoer van de opgegeven actie

Voorbeeld

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

body('Get_user')

En retourneert dit 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>)

Parameter	Vereist	Type	Description
<value>	Ja	Alle	De waarde die moet worden geconverteerd naar Booleaanse waarde.

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.

Retourwaarde	Type	Description
true of false	Booleaanse waarde	De Booleaanse versie van de opgegeven waarde.

Uitvoer

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

Invoerwaarde	Type	Retourwaarde
bool(1)	Geheel getal	true
bool(0)	Geheel getal	false
bool(-1)	Geheel getal	true
bool('true')	String	true
bool('false')	String	false

E

chunk

Splits een tekenreeks of matrix in segmenten van gelijke lengte.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks of matrix	De verzameling die moet worden gesplitst
<length>	Ja	De lengte van elk segment

Retourwaarde	Type	Description
<collectie>	Matrix	Een matrix van segmenten met de opgegeven lengte

Voorbeeld 1

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

chunk('abcdefghijklmnopqrstuvwxyz', 10)

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

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

samensmelten

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

Parameter	Vereist	Type	Description
<>object_1, <object_2>, ...	Ja	Elke, kan typen mixen	Een of meer items om te controleren op null

Retourwaarde	Type	Description
<first-non-null-item>	Alle	Het eerste item of de eerste waarde die niet null is. Als alle parameters null zijn, retourneert deze functie null.

Voorbeeld

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

Parameter	Vereist	Type	Description
<tekst1>, <tekst2>, ...	Ja	String	Ten minste twee tekenreeksen die moeten worden gecombineerd

Retourwaarde	Type	Description
<text1text2...>	String	De tekenreeks die is gemaakt op basis van de gecombineerde invoerreeksen. Opmerking: De lengte van het resultaat mag niet langer zijn dan 104.857.600 tekens.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren wanneer u de concat() functie gebruikt met gegevens die codering of decodering nodig hebben:

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

Als u deze functie echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht renderinggedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functie en niet op het effect, tenzij u de parameterwaarden van de functie bewerkt, waardoor de functie en het effect uit uw code worden verwijderd. Raadpleeg Base64-codering en -decodering voor meer informatie.

Voorbeeld

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

concat('Hello', 'World')

En retourneert dit resultaat: "HelloWorld"

bevat

Controleer of een verzameling een specifiek item heeft. Retourneer waar wanneer het item wordt gevonden of retourneer onwaar wanneer het niet is gevonden. Deze functie is hoofdlettergevoelig.

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

Deze functie werkt met name op deze verzamelingstypen:

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks, matrix of woordenlijst	De verzameling die moet worden gecontroleerd
<value>	Ja	Tekenreeks, matrix of woordenlijst, respectievelijk	Het item dat moet worden gevonden

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneert waar wanneer het item wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd op de subtekenreeks 'wereld' en wordt waar geretourneerd:

contains('hello world', 'world')

Voorbeeld 2

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd op de subtekenreeks 'universum' en wordt onwaar geretourneerd:

contains('hello world', 'universe')

convertFromUtc

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

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<destinationTimeZone>	Ja	String	De naam voor de doeltijdzone. Voor tijdzonenamen raadpleegt u De standaardtijdzones van Microsoft Windows.
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<geconverteerde tijdstempel>	String	Het tijdstempel is geconverteerd naar de doeltijdzone zonder de utc-offset van de tijdzone.

Voorbeeld 1

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

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

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

En retourneert dit resultaat: "Monday, January 1, 2018"

convertTimeZone

Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<sourceTimeZone>	Ja	String	De naam voor de brontijdzone. Voor tijdzonenamen raadpleegt u De standaardtijdzones van Microsoft Windows, maar mogelijk moet u interpunctie verwijderen uit de tijdzonenaam.
<destinationTimeZone>	Ja	String	De naam voor de doeltijdzone. Voor tijdzonenamen raadpleegt u De standaardtijdzones van Microsoft Windows, maar mogelijk moet u interpunctie verwijderen uit de tijdzonenaam.
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<geconverteerde tijdstempel>	String	De tijdstempel geconverteerd naar de doeltijdzone

Voorbeeld 1

In dit voorbeeld wordt de brontijdzone geconverteerd naar de doeltijdzone:

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

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

En retourneert dit resultaat: "Monday, January 1, 2018"

convertToUtc

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

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<sourceTimeZone>	Ja	String	De naam voor de brontijdzone. Voor tijdzonenamen raadpleegt u De standaardtijdzones van Microsoft Windows, maar mogelijk moet u interpunctie verwijderen uit de tijdzonenaam.
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<geconverteerde tijdstempel>	String	De tijdstempel geconverteerd naar UTC

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

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

En retourneert dit resultaat: "Monday, January 1, 2018"

createArray

Retourneert een matrix van meerdere invoerwaarden. Zie array()voor enkelvoudige invoermatrices.

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

Parameter	Vereist	Type	Description
<object1>, <object2>, ...	Ja	Alle, maar niet gemengd	Ten minste twee items om de matrix te maken

Retourwaarde	Type	Description
[<object1>, <object2>, ...]	Matrix	De matrix die is gemaakt op basis van alle invoeritems

Voorbeeld

In dit voorbeeld wordt een matrix gemaakt van deze invoer:

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

En retourneert dit resultaat: ["h", "e", "l", "l", "o"]

D

dataUri

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

dataUri('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks die moet worden geconverteerd

Retourwaarde	Type	Description
<gegevens-URI>	String	De gegevens-URI voor de invoertekenreeks

Voorbeeld

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De gegevens-URI die moet worden geconverteerd

Retourwaarde	Type	Description
<binary-for-data-uri>	String	De binaire versie voor de gegevens-URI

Voorbeeld

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

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

En retourneert dit resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De gegevens-URI die moet worden geconverteerd

Retourwaarde	Type	Description
<tekenreeks-voor-gegevens-URI>	String	De tekenreeksversie voor de gegevens-URI

Voorbeeld

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

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

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

Parameter	Vereist	Type	Description
<startDate>	Ja	String	Een tekenreeks die een tijdstempel bevat
<endDate>	Ja	String	Een tekenreeks die een tijdstempel bevat

Retourwaarde	Type	Description
<tijdspanne>	String	Het verschil tussen de twee tijdstempels, een tijdstempel in tekenreeksindeling. Als startDate dit recenter is dan endDate, is het resultaat een negatieve waarde.

Voorbeeld

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

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

En retourneert dit resultaat: "1268.00:00:00"

dayOfMonth

Retourneer de dag van de maand uit een tijdstempel.

dayOfMonth('<timestamp>')

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat

Retourwaarde	Type	Description
<dag van de maand>	Geheel getal	De dag van de maand op basis van de opgegeven tijdstempel

Voorbeeld

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

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

En retourneert dit resultaat: 15

dayOfWeek

Retourneer de dag van de week vanaf een tijdstempel.

dayOfWeek('<timestamp>')

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat

Retourwaarde	Type	Description
<dag van de week>	Geheel getal	De dag van de week vanaf de opgegeven tijdstempel waar zondag 0 is, maandag is 1, enzovoort

Voorbeeld

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

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

En retourneert dit resultaat: 4

dayOfYear

Retourneer de dag van het jaar uit een tijdstempel.

dayOfYear('<timestamp>')

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat

Retourwaarde	Type	Description
<dag van het jaar>	Geheel getal	De dag van het jaar uit de opgegeven tijdstempel

Voorbeeld

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

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

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

Notitie

De decimale precisie die wordt besproken in de context voor deze functie en de Azure Logic Apps-runtime is hetzelfde als de decimale precisie van .NET.

decimal('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	Het decimale getal in een tekenreeks

Retourwaarde	Type	Description
<decimaal>	Decimaal getal	Het decimale getal voor de invoertekenreeks

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

Retourneert de binaire versie voor een gegevens uniform resource-id (URI). Overweeg het gebruik van dataUriToBinary(), in plaats decodeDataUri()van . Hoewel beide functies op dezelfde manier werken, dataUriToBinary() heeft dit de voorkeur.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht weergavegedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Base64-codering en -decodering voor meer informatie.

decodeDataUri('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De gegevens-URI-tekenreeks om te decoderen

Retourwaarde	Type	Description
<binary-for-data-uri>	String	De binaire versie voor een gegevens-URI-tekenreeks

Voorbeeld

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

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

En retourneert dit resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks met de escapetekens om te decoderen

Retourwaarde	Type	Description
<decoderen-URI>	String	De bijgewerkte tekenreeks met de gedecodeerde escape-tekens

Voorbeeld

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

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

En retourneert dit resultaat: "https://contoso.com"

div

Retourneert het resultaat van het delen van twee getallen. Als u het restresultaat wilt ophalen, raadpleegt u mod().

div(<dividend>, <divisor>)

Parameter	Vereist	Type	Description
<dividend>	Ja	Geheel getal of float	Het getal dat moet worden gedeeld door de deler
<deler>	Ja	Geheel getal of float	Het getal dat het dividend deelt, maar niet nul kan zijn

Retourwaarde	Type	Description
<quotient-result>	Geheel getal of float	Het resultaat van het delen van het eerste getal door het tweede getal. Als het dividend of deler het floattype heeft, heeft het resultaat floattype. Opmerking: als u het floatresultaat wilt converteren naar een geheel getal, kunt u een functie in Azure maken en aanroepen vanuit uw logische app.

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 het gebruik van uriComponent(), in plaats encodeUriComponent()van . Hoewel beide functies op dezelfde manier werken, uriComponent() heeft dit de voorkeur.

Notitie

Azure Logic Apps voert automatisch of impliciet base64-codering en -decodering uit, dus u hoeft deze conversies niet handmatig uit te voeren met behulp van de coderings- en decoderingsfuncties. Als u deze functies echter toch in de ontwerpfunctie gebruikt, kunt u onverwacht weergavegedrag ervaren in de ontwerpfunctie. Dit gedrag heeft alleen invloed op de zichtbaarheid van de functies en niet op het effect ervan, tenzij u de parameterwaarden van de functies bewerkt, waardoor de functies en de bijbehorende effecten uit uw code worden verwijderd. Zie Base64-codering en -decodering voor meer informatie.

encodeUriComponent('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks die moet worden geconverteerd naar een URI-gecodeerde indeling

Retourwaarde	Type	Description
<gecodeerde-URI>	String	De tekenreeks met URI-codering met escapetekens

Voorbeeld

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

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

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

empty

Controleer of een verzameling leeg is. Retourneer waar wanneer de verzameling leeg is of retourneer onwaar als deze niet leeg is.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks, matrix of object	De verzameling die moet worden gecontroleerd

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneert waar wanneer de verzameling leeg is. Retourneer onwaar als deze niet leeg is.

Voorbeeld

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 retourneert true.
• Tweede voorbeeld: geeft de tekenreeks 'abc' door, zodat de functie retourneert false.

endsWith

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

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die moet worden gecontroleerd
<searchText>	Ja	String	De eindsubtekenreeks om te zoeken

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar wanneer de eindsubtekenreeks wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

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

endsWith('hello world', 'world')

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

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

Parameter	Vereist	Type	Description
<object1>, <object2>	Ja	Diverse	De waarden, expressies of objecten die moeten worden vergeleken

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar als beide gelijkwaardig zijn. Retourneer onwaar als dit niet gelijk is.

Voorbeeld

Deze voorbeelden controleren of de opgegeven invoer gelijkwaardig is.

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

En retourneert deze resultaten:

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

F

Eerste

Retourneert het eerste item uit een tekenreeks of matrix.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks of matrix	De verzameling waar het eerste item moet worden gevonden

Retourwaarde	Type	Description
<first-collection-item>	Alle	Het eerste item in de verzameling

Voorbeeld

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

zwevend

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

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks met een geldig drijvende-kommanummer dat moet worden geconverteerd. De minimum- en maximumwaarden zijn hetzelfde als de limieten voor het float-gegevenstype.
<locale>	Nee	String	De RFC 4646-landinstellingscode die moet worden gebruikt. Als dit niet is opgegeven, wordt de standaardinstelling gebruikt. Als de landinstelling geen geldige waarde is, wordt er een fout gegenereerd dat de opgegeven landinstelling niet geldig is of geen gekoppelde landinstelling heeft.

Retourwaarde	Type	Description
<float-value>	Float	Het drijvendekommagetal voor de opgegeven tekenreeks. De minimum- en maximumwaarden zijn hetzelfde als de limieten voor het float-gegevenstype.

Voorbeeld 1

In dit voorbeeld wordt een tekenreeksversie gemaakt voor dit drijvendekommagetal:

float('10,000.333')

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

En retourneert dit resultaat: 10000.333

formatDateTime

Retourneert een tijdstempel in de opgegeven indeling.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.
<locale>	Nee	String	De landinstelling die moet worden gebruikt. Als dit niet is opgegeven, is en-usde waarde . Als de landinstelling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<opnieuw opgemaakte tijdstempel>	String	De bijgewerkte tijdstempel in de opgegeven indeling en landinstelling, indien opgegeven.

Voorbeelden

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

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De actie waarvan de uitvoer de sleutelwaarde heeft die u wilt
<key>	Ja	String	De naam voor de sleutel waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
[<matrix-met-sleutel-waarden>]	Matrix	Een matrix met alle waarden die overeenkomen met de opgegeven sleutel

Voorbeeld

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

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De actie waarvan de uitvoer de sleutelwaarde heeft die u wilt
<key>	Ja	String	De naam voor de sleutel waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
<sleutelwaarde>	String	De waarde in de opgegeven sleutel

Voorbeeld

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

Parameter	Vereist	Type	Description
<getal>	Ja	Geheel getal of dubbel	De waarde die u wilt opmaken.
<format>	Ja	String	Een tekenreeks met samengestelde notatie die de indeling aangeeft die u wilt gebruiken. Zie Standaardtekenreeksen voor numerieke notatie, die worden ondersteund door number.ToString(<format>, <locale>)de ondersteunde tekenreeksen voor numerieke notatie.
<locale>	Nee	String	De landinstelling die moet worden gebruikt als ondersteund door number.ToString(<format>, <locale>). Als dit niet is opgegeven, is en-usde waarde . Als de landinstelling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<opgemaakt getal>	String	Het opgegeven getal als een tekenreeks in de notatie die u hebt opgegeven. U kunt deze retourwaarde casten naar een int of float.

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

Parameter	Vereist	Type	Description
<interval>	Ja	Geheel getal	Het aantal tijdseenheden dat moet worden toegevoegd
<timeUnit>	Ja	String	De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format>	Nee	String	Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de notatie geen geldige waarde is, wordt er een fout gegenereerd dat de opgegeven indeling niet geldig is en een tekenreeks met een numerieke notatie moet zijn.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	Het huidige tijdstempel plus het opgegeven aantal tijdseenheden

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

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

En retourneert dit resultaat: "Tuesday, March 6, 2018"

getPastTime

Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden.

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

Parameter	Vereist	Type	Description
<interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
<timeUnit>	Ja	String	De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format>	Nee	String	Eén opmaakaanduiding of een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de notatie geen geldige waarde is, wordt er een fout gegenereerd dat de opgegeven indeling niet geldig is en een tekenreeks met een numerieke notatie moet zijn.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De huidige tijdstempel minus het opgegeven aantal tijdseenheden

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

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

En retourneert dit resultaat: "Saturday, January 27, 2018"

greater

Controleer of de eerste waarde groter is dan de tweede waarde. Retourneert waar wanneer de eerste waarde meer is of onwaar retourneert als deze kleiner is.

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

Parameter	Vereist	Type	Description
<value>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of deze groter is dan de tweede waarde
<compareTo>	Ja	Geheel getal, float of tekenreeks, respectievelijk	De vergelijkingswaarde

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar wanneer de eerste waarde groter is dan de tweede waarde. Retourneer onwaar wanneer de eerste waarde gelijk is aan of kleiner is dan de tweede waarde.

Voorbeeld

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 true wanneer de eerste waarde groter of gelijk is aan, of retourneer onwaar wanneer de eerste waarde kleiner is.

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

Parameter	Vereist	Type	Description
<value>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of deze groter is dan of gelijk is aan de tweede waarde
<compareTo>	Ja	Geheel getal, float of tekenreeks, respectievelijk	De vergelijkingswaarde

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar wanneer de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneer onwaar wanneer de eerste waarde kleiner is dan de tweede waarde.

Voorbeeld

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

Parameter	Vereist	Type	Description
<format>	Nee	String	Eén indelingsaanduiding voor de geretourneerde GUID. De indeling is standaard 'D', maar u kunt 'N', 'D', 'B', 'P' of 'X' gebruiken.

Retourwaarde	Type	Description
<GUID-waarde>	String	Een willekeurig gegenereerde GUID

Voorbeeld

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

guid('P')

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

Parameter	Vereist	Type	Description
<uitdrukking>	Ja	Booleaanse waarde	De expressie die moet worden gecontroleerd
<waardeIndienWaar>	Ja	Alle	De waarde die moet worden geretourneerd wanneer de expressie waar is
<waardeIndienOnwaar>	Ja	Alle	De waarde die moet worden geretourneerd wanneer de expressie onwaar is

Retourwaarde	Type	Description
<opgegeven-retourwaarde>	Alle	De opgegeven waarde die wordt geretourneerd op basis van of de expressie waar of onwaar is

Voorbeeld

Dit voorbeeld retourneert omdat de opgegeven expressie waar retourneert "yes" . Anders retourneert "no"het voorbeeld:

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks met de subtekenreeks die moet worden gevonden
<searchText>	Ja	String	De subtekenreeks om te zoeken

Retourwaarde	Type	Description
<indexwaarde>	Geheel getal	De beginpositie of indexwaarde voor de opgegeven subtekenreeks. Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat.

Voorbeeld

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

indexOf('hello world', 'world')

En retourneert dit resultaat: 6

int

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

int('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeksversie voor het geheel getal dat moet worden geconverteerd. De minimum- en maximumwaarden zijn hetzelfde als de limieten voor het gegevenstype geheel getal.

Retourwaarde	Type	Description
<resultaat geheel getal>	Geheel getal	De gehele versie voor de opgegeven tekenreeks. De minimum- en maximumwaarden zijn hetzelfde als de limieten voor het gegevenstype geheel getal.

Voorbeeld

In dit voorbeeld wordt een geheel getal gemaakt voor de tekenreeks 10:

int('10')

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

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks die moet worden onderzocht
<locale>	Nee	String	De RFC 4646-landinstellingscode die moet worden gebruikt

Retourwaarde	Type	Description
<Booleaans resultaat>	Booleaanse waarde	Een Booleaanse waarde die aangeeft of de tekenreeks een drijvendekommagetal is

Voorbeeld 1

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

isFloat('10,000.00')

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

En retourneert dit resultaat: true

isInt

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

isInt('<string>')

Parameter	Vereist	Type	Omschrijving
<snaar>	Ja	String	De tekenreeks die moet worden onderzocht

Retourwaarde	Type	Description
<Booleaans resultaat>	Booleaanse waarde	Een Booleaanse waarde die aangeeft of de tekenreeks een geheel getal is

Voorbeeld

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

isInt('10')

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

Retourwaarde	Type	Description
<current-array-item>	Alle	Het huidige item in de matrix voor de huidige iteratie van de actie

Voorbeeld

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

Parameter	Vereist	Type	Description
<loopName>	Ja	String	De naam voor de for-each-lus

Retourwaarde	Type	Beschrijving
<item>	Alle	Het item uit de huidige cyclus in de opgegeven voor-elke lus

Voorbeeld

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

Parameter	Vereist	Type	Description
<loopName>	Ja	String	De naam voor de until-lus

Retourwaarde	Type	Description
<index>	Geheel getal	De indexwaarde voor de huidige iteratie binnen de opgegeven until-lus

Voorbeeld

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

Belangrijk

Zonder een XML-schema dat de structuur van de uitvoer definieert, kan de functie resultaten retourneren waarbij de structuur sterk verschilt van de verwachte indeling, afhankelijk van de invoer.

Dit gedrag maakt deze functie ongeschikt voor scenario's waarin de uitvoer moet voldoen aan een goed gedefinieerd contract, bijvoorbeeld in kritieke bedrijfssystemen of oplossingen.

Parameter	Vereist	Type	Description
<value>	Ja	Tekenreeks of XML	De tekenreeks of XML die moet worden geconverteerd

Retourwaarde	Type	Description
<JSON-result>	Systeemeigen JSON-type, object of matrix	De systeemeigen JSON-typewaarde, het object of de matrix van objecten uit de invoertekenreeks of XML. - Als u XML doorgeeft met één onderliggend element in het hoofdelement, retourneert de functie één JSON-object voor dat onderliggende element. - Als u XML doorgeeft met meerdere onderliggende elementen in het hoofdelement, retourneert de functie een matrix die JSON-objecten voor deze onderliggende elementen bevat. - Als de tekenreeks null is, retourneert de functie een leeg object.

Voorbeeld 1

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

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

En retourneert dit resultaat: [1, 2, 3]

Voorbeeld 2

In dit voorbeeld wordt deze tekenreeks geconverteerd naar JSON:

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

En retourneert dit 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 retourneert dit 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 retourneert dit resultaat:

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

kruispunt

Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen. 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>', ...)

Parameter	Vereist	Type	Description
<collection1>, <collection2>, ...	Ja	Matrix of object, maar niet beide	De verzamelingen van waaruit u alleen de algemene items wilt

Retourwaarde	Type	Description
<common-items>	Matrix of object, respectievelijk	Een verzameling met alleen de algemene items in de opgegeven verzamelingen

Voorbeeld

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

Retourneert een tekenreeks met alle items uit een matrix en heeft elk teken gescheiden door een scheidingsteken.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Matrix	De matrix waaraan de items moeten worden gekoppeld
<scheidingsteken>	Ja	String	Het scheidingsteken dat tussen elk teken in de resulterende tekenreeks wordt weergegeven

Retourwaarde	Type	Description
<char1><scheidingsteken teken2><scheidingsteken...><>	String	De resulterende tekenreeks die is gemaakt op basis van alle items in de opgegeven matrix. Opmerking: De lengte van het resultaat mag niet langer zijn dan 104.857.600 tekens.

Voorbeeld

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

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

En retourneert dit resultaat: "a.b.c"

L

Laatste

Retourneer het laatste item uit een verzameling.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks of matrix	De verzameling waar het laatste item moet worden gevonden

Retourwaarde	Type	Description
<last-collection-item>	Tekenreeks of matrix, respectievelijk	Het laatste item in de verzameling

Voorbeeld

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

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

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks met de subtekenreeks die moet worden gevonden
<searchText>	Ja	String	De subtekenreeks om te zoeken

Retourwaarde	Type	Description
<end-index-value>	Geheel getal	De beginpositie of indexwaarde voor het laatste exemplaar van de opgegeven subtekenreeks.

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.

Voorbeelden

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks of matrix	De verzameling met de items die moeten worden geteld

Retourwaarde	Type	Description
<lengte of aantal>	Geheel getal	Het aantal items in de verzameling

Voorbeeld

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

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

En retourneer dit resultaat: 4

less

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

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

Parameter	Vereist	Type	Description
<value>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of kleiner is dan de tweede waarde
<compareTo>	Ja	Geheel getal, float of tekenreeks, respectievelijk	Het vergelijkingsitem

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneert true wanneer de eerste waarde kleiner is dan de tweede waarde. Retourneer onwaar wanneer de eerste waarde gelijk is aan of groter is dan de tweede waarde.

Voorbeeld

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

Parameter	Vereist	Type	Description
<value>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of kleiner dan of gelijk is aan de tweede waarde
<compareTo>	Ja	Geheel getal, float of tekenreeks, respectievelijk	Het vergelijkingsitem

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar als de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneer onwaar wanneer de eerste waarde groter is dan de tweede waarde.

Voorbeeld

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

Retourwaarde	Type	Description
<callback-URL>	String	De callback-URL voor een trigger of actie

Voorbeeld

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

Parameter	Vereist	Type	Description
<getal1>, <getal2>, ...	Ja	Geheel getal, float of beide	De set getallen waarvan u de hoogste waarde wilt berekenen
[<getal1>, <getal2>, ...]	Ja	Matrix: geheel getal, float of beide	De matrix met getallen waaruit u de hoogste waarde wilt berekenen

Retourwaarde	Type	Description
<max-value>	Geheel getal of float	De hoogste waarde in de opgegeven matrix of set getallen

Voorbeeld

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 retourneer dit resultaat: 3

min.

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

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

Parameter	Vereist	Type	Description
<getal1>, <getal2>, ...	Ja	Geheel getal, float of beide	De set getallen waaruit u de laagste waarde wilt berekenen
[<getal1>, <getal2>, ...]	Ja	Matrix: geheel getal, float of beide	De matrix met getallen waaruit u de laagste waarde wilt berekenen

Retourwaarde	Type	Description
<min-waarde>	Geheel getal of float	De laagste waarde in de opgegeven set getallen of opgegeven matrix

Voorbeeld

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

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

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

Parameter	Vereist	Type	Description
<dividend>	Ja	Geheel getal of float	Het getal dat moet worden gedeeld door de deler
<deler>	Ja	Geheel getal of float	Het getal dat het dividend deelt, maar niet nul kan zijn

Retourwaarde	Type	Description
<modulo-result>	Geheel getal of float	Het restgetal van het delen van het eerste getal door het tweede getal

Voorbeeld 1

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

mod(3, 2)

En 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 van het vermenigvuldigen van twee getallen.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Vereist	Type	Description
<vermenigvuldigd1>	Ja	Geheel getal of float	Het getal dat moet worden vermenigvuldigd met vermenigvuldiging2
<vermenigvuldigd2>	Ja	Geheel getal of float	Het getal dat veelvouden vermenigvuldigd1

Retourwaarde	Type	Description
<productresultaat>	Geheel getal of float	Het product van het vermenigvuldigen van het eerste getal met het tweede getal

Voorbeeld

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

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De naam van de actie met uitvoer met meerdere onderdelen
<index>	Ja	Geheel getal	De indexwaarde voor het gewenste onderdeel

Retourwaarde	Type	Description
<hoofdtekst>	String	De hoofdtekst voor het opgegeven deel

N

not

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

not(<expression>)

Parameter	Vereist	Type	Description
<uitdrukking>	Ja	Booleaanse waarde	De expressie die moet worden gecontroleerd

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneer waar wanneer de expressie onwaar is. Retourneer onwaar wanneer de expressie waar is.

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die de subtekenreeks bevat die moet worden gevonden
<searchText>	Ja	String	De subtekenreeks om te zoeken
<gebeurtenis>	Ja	Geheel getal	Een getal dat het neexemplaar van de subtekenreeks aangeeft dat moet worden gevonden. Als de gebeurtenis negatief is, begint u met zoeken vanaf het einde.

Retourwaarde	Type	Description
<indexwaarde>	Geheel getal	De beginpositie of indexwaarde voor het neexemplaar van de opgegeven subtekenreeks. Als de subtekenreeks niet wordt gevonden of minder dan n exemplaren van de subtekenreeks bestaat, retourneer -1dan .

Voorbeelden

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

Parameter	Vereist	Type	Description
<expressie1>, <expressie2>, ...	Ja	Booleaanse waarde	De expressies die moeten worden gecontroleerd

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneert waar wanneer ten minste één expressie waar is. Retourneer onwaar wanneer alle expressies onwaar zijn.

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.

uitvoer

Retourneert de uitvoer van een actie tijdens runtime.

outputs('<actionName>')

Parameter	Vereist	Type	Description
<actionName>	Ja	String	De naam voor de uitvoer van de actie die u wilt

Retourwaarde	Type	Description
<uitvoer>	String	De uitvoer van de opgegeven actie

Voorbeeld

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

outputs('Get_user')

En retourneert dit 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>')

Parameter	Vereist	Type	Description
<parameterName>	Ja	String	De naam voor de parameter waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
<parameterwaarde>	Alle	De waarde voor de opgegeven parameter

Voorbeeld

Stel dat u deze JSON-waarde hebt:

{
  "fullName": "Sophia Owen"
}

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

parameters('fullName')

En retourneert dit resultaat: "Sophia Owen"

parseDateTime

Retourneer de tijdstempel van een tekenreeks die een tijdstempel bevat.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<locale>	Nee	String	De landinstelling die moet worden gebruikt. Als dit niet is opgegeven, is en-usde standaardlandinstelling . Als de landinstelling geen geldige waarde is, wordt er een fout gegenereerd.
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling niet is opgegeven, probeert u te parseren met meerdere indelingen die compatibel zijn met de opgegeven landinstelling. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<parsed-timestamp>	String	De geparseerde tijdstempel in de indeling "o" (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt.

Voorbeelden

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

rand

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

rand(<minValue>, <maxValue>)

Parameter	Vereist	Type	Description
<minValue>	Ja	Geheel getal	Het laagste gehele getal in het bereik
<maxValue>	Ja	Geheel getal	Het gehele getal dat volgt op het hoogste gehele getal in het bereik dat door de functie kan worden geretourneerd

Retourwaarde	Type	Description
<willekeurig resultaat>	Geheel getal	Het willekeurige gehele getal dat wordt geretourneerd uit het opgegeven bereik

Voorbeeld

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, of 34

range

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

range(<startIndex>, <count>)

Parameter	Vereist	Type	Description
<startIndex>	Ja	Geheel getal	Een geheel getal dat de matrix start als het eerste item
<count>	Ja	Geheel getal	Het aantal gehele getallen in de matrix. De count parameterwaarde moet een positief geheel getal zijn dat niet groter is dan 100.000. Opmerking: De som van de startIndex en count waarden mag niet groter zijn dan 2.147.483.647.

Retourwaarde	Type	Description
[<bereikresultaat>]	Matrix	De matrix met gehele getallen die beginnen met de opgegeven index

Voorbeeld

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)

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object van waaruit u een eigenschap wilt verwijderen
<eigenschap>	Ja	String	De naam voor de eigenschap die moet worden verwijderd

Retourwaarde	Type	Description
<bijgewerkt-object>	Object	Het bijgewerkte JSON-object zonder de opgegeven eigenschap

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

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object waarvan u de eigenschap wilt verwijderen
<bovenliggende eigenschap>	Ja	String	De naam voor de bovenliggende eigenschap met de onderliggende eigenschap die u wilt verwijderen
<onderliggende eigenschap>	Ja	String	De naam voor de onderliggende eigenschap die moet worden verwijderd

Retourwaarde	Type	Description
<bijgewerkt-object>	Object	Het bijgewerkte JSON-object waarvan de onderliggende eigenschap die u hebt verwijderd

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks met de subtekenreeks die moet worden vervangen
<oldText>	Ja	String	De subtekenreeks die moet worden vervangen
<newText>	Ja	String	De vervangende tekenreeks

Retourwaarde	Type	Description
<bijgewerkte tekst>	String	De bijgewerkte tekenreeks na het vervangen van de subtekenreeks Als de subtekenreeks niet wordt gevonden, retourneert u de oorspronkelijke tekenreeks.

Voorbeeld

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

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

En retourneert dit resultaat: "the new string"

resultaat

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.

Notitie

Deze functie retourneert alleen informatie van de acties op het eerste niveau in de scoped-actie en niet van diepere geneste acties, zoals switch- of voorwaardeacties.

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

Parameter	Vereist	Type	Description
<scopedActionName>	Ja	String	De naam van de scoped-actie waar u de invoer en uitvoer van de acties op het hoogste niveau binnen dat bereik wilt gebruiken

Retourwaarde	Type	Description
<matrixobject>	Matrixobject	Een matrix met matrices van invoer en uitvoer van elke actie op het hoogste niveau binnen het opgegeven bereik

Voorbeeld

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Matrix	De verzameling die moet worden omgekeerd

Retourwaarde	Type	Description
[<bijgewerkte verzameling>]	Matrix	De omgekeerde verzameling

Voorbeeld

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object waarvan u de eigenschap wilt instellen
<eigenschap>	Ja	String	De naam voor de bestaande of nieuwe eigenschap die moet worden ingesteld
<value>	Ja	Alle	De waarde die moet worden ingesteld voor de opgegeven eigenschap

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

Parameter	Vereist	Type	Description
<object>	Ja	Object	Het JSON-object waarvan u de eigenschap wilt instellen
<bovenliggende eigenschap>	Ja	String	De naam voor de bovenliggende eigenschap met de onderliggende eigenschap die u wilt instellen
<onderliggende eigenschap>	Ja	String	De naam voor de onderliggende eigenschap die moet worden ingesteld
<value>	Ja	Alle	De waarde die moet worden ingesteld voor de opgegeven eigenschap

Retourwaarde	Type	Description
<bijgewerkt-object>	Object	Het bijgewerkte JSON-object waarvan u de eigenschap hebt ingesteld

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Matrix	De verzameling waarvan u de items wilt verwijderen
<count>	Ja	Geheel getal	Een positief geheel getal voor het aantal items dat aan de voorzijde moet worden verwijderd

Retourwaarde	Type	Description
[<bijgewerkte verzameling>]	Matrix	De bijgewerkte verzameling na het verwijderen van de opgegeven items

Voorbeeld

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die de subtekenreeks bevat die moet worden gevonden
<startIndex>	Ja	Geheel getal	De op nul gebaseerde beginpositie of -waarde waar moet worden gezocht naar de subtekenreeks - Als startIndex groter is dan de tekenreekslengte, retourneert u een lege tekenreeks. - Als startIndex negatief is, begint u te zoeken naar de indexwaarde die de som is van de lengte van de tekenreeks en startIndex.
<endIndex>	Nee	Geheel getal	De op nul gebaseerde eindpositie of -waarde voor waar moet worden gezocht naar de subtekenreeks. Het teken dat zich in de eindindexwaarde bevindt, wordt niet opgenomen in de zoekopdracht. - Als endIndex niet is opgegeven of groter is dan de lengte van de tekenreeks, zoekt u tot aan het einde van de tekenreeks. - Als endIndex negatief is, eindigt u met zoeken op de indexwaarde die de som van de tekenreekslengte en endIndex.

Retourwaarde	Type	Description
<slice-result>	String	Een nieuwe tekenreeks die de gevonden subtekenreeks bevat

Voorbeelden

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Matrix	De verzameling met de items die moeten worden gesorteerd
<sortBy>	Nee	String	De sleutel die moet worden gebruikt voor het sorteren van de verzamelingsobjecten

Retourwaarde	Type	Description
[<bijgewerkte verzameling>]	Matrix	De gesorteerde verzameling

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die moet worden gescheiden in subtekenreeksen op basis van het opgegeven scheidingsteken in de oorspronkelijke tekenreeks
<scheidingsteken>	Ja	String	Het teken in de oorspronkelijke tekenreeks dat moet worden gebruikt als scheidingsteken

Retourwaarde	Type	Description
[<subtekenreeks1,subtekenreeks2><>,...]	Matrix	Een matrix die subtekenreeksen van de oorspronkelijke tekenreeks bevat, gescheiden door komma's

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De opgegeven tijdstempel, maar beginnend bij de nuluurmarkering voor de dag

Voorbeeld

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

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

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

startOfHour

Retourneert het begin van het uur voor een tijdstempel.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De opgegeven tijdstempel, maar beginnend bij de nulminutenmarkering voor het uur

Voorbeeld

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

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

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

startOfMonth

Retourneer het begin van de maand voor een tijdstempel.

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	De opgegeven tijdstempel, maar beginnend op de eerste dag van de maand op het nuluurmarkering

Voorbeeld 1

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

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

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

En retourneert dit resultaat: "2018-03-01"

startsWith

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

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die moet worden gecontroleerd
<searchText>	Ja	String	De begintekenreeks die moet worden gevonden

Retourwaarde	Type	Description
waar of onwaar	Booleaanse waarde	Retourneert waar wanneer de beginsubtekenreeks wordt gevonden. Retourneer onwaar wanneer deze niet is gevonden.

Voorbeeld 1

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

startsWith('hello world', 'hello')

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

En retourneert dit resultaat: false

tekenreeks

Retourneert de tekenreeksversie voor een waarde.

string(<value>)

Parameter	Vereist	Type	Description
<value>	Ja	Alle	De waarde die moet worden geconverteerd. Als deze waarde null is of als null wordt geëvalueerd, wordt de waarde geconverteerd naar een lege tekenreekswaarde (""). Als u bijvoorbeeld een tekenreeksvariabele toewijst aan een niet-bestaande eigenschap, waartoe u toegang hebt met de ? operator, wordt de null-waarde geconverteerd naar een lege tekenreeks. Het vergelijken van een null-waarde is echter niet hetzelfde als het vergelijken van een lege tekenreeks.

Retourwaarde	Type	Description
<tekenreekswaarde>	String	De tekenreeksversie voor de opgegeven waarde. Als de waardeparameter null is of als null wordt geëvalueerd, wordt deze waarde geretourneerd als een lege tekenreekswaarde (""waarde).

Voorbeeld 1

In dit voorbeeld wordt de tekenreeksversie voor dit getal gemaakt:

string(10)

En 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" } )

En retourneert dit resultaat: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

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

sub(<minuend>, <subtrahend>)

Parameter	Vereist	Type	Description
<minuend>	Ja	Geheel getal of float	Het getal van waaruit het aftrekken moet worden afgetrokken
<aftrekken>	Ja	Geheel getal of float	Het getal dat moet worden afgetrokken van de minuend

Retourwaarde	Type	Omschrijving
<resultaat>	Geheel getal of float	Het resultaat van het aftrekken van het tweede getal van het eerste getal

Voorbeeld

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

sub(10.3, .3)

En retourneert dit resultaat: 10

Subtekenreeks

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks waarvan u de tekens wilt
<startIndex>	Ja	Geheel getal	Een positief getal dat gelijk is aan of groter is dan 0 dat u wilt gebruiken als de beginpositie of indexwaarde
<length>	Nee	Geheel getal	Een positief aantal tekens dat u in de subtekenreeks wilt opnemen

Notitie

Zorg ervoor dat de som van het toevoegen van de parameterwaarden startIndex en lengte kleiner is dan de lengte van de tekenreeks die u opgeeft voor de tekstparameter . Anders krijgt u een fout, in tegenstelling tot vergelijkbare functies in andere talen, waarbij het resultaat de subtekenreeks is van de startIndex tot het einde van de tekenreeks. De lengteparameter is optioneel en indien niet opgegeven, neemt de functie subtekenreeks() alle tekens die beginnen vanaf startIndex tot het einde van de tekenreeks.

Retourwaarde	Type	Description
<subtekenreeksresultaat>	String	Een subtekenreeks met het opgegeven aantal tekens, beginnend bij de opgegeven indexpositie in de brontekenreeks

Voorbeeld

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)

En retourneert dit resultaat: "world"

aftrekkenFromTime

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

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks die de tijdstempel bevat
<interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
<timeUnit>	Ja	String	De tijdseenheid die moet worden gebruikt met interval: 'Seconde', 'Minuut', 'Uur', 'Dag', 'Week', 'Maand', 'Jaar'
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<bijgewerkte tijdstempel>	String	Het tijdstempel minus het opgegeven aantal tijdseenheden

Voorbeeld 1

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

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

En 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

Items retourneren van de voorzijde van een verzameling.

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

Parameter	Vereist	Type	Description
<collectie>	Ja	Tekenreeks of matrix	De verzameling waarvan u de gewenste items wilt
<count>	Ja	Geheel getal	Een positief geheel getal voor het gewenste aantal items aan de voorzijde

Retourwaarde	Type	Description
<subset> of [<subset>]	Tekenreeks of matrix, respectievelijk	Een tekenreeks of matrix met het opgegeven aantal items dat afkomstig is van de voorzijde van de oorspronkelijke verzameling

Voorbeeld

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]

Teken

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

Parameter	Vereist	Type	Description
<tijdstempel>	Ja	String	De tekenreeks voor een tijdstempel

Retourwaarde	Type	Description
<maatstreepjes-getal>	Geheel getal	Het aantal tikken sinds de opgegeven tijdstempel

toLower

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

toLower('<text>')

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die moet worden geretourneerd in kleine letters

Retourwaarde	Type	Description
<kleine letters>	String	De oorspronkelijke tekenreeks in kleine letters

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar kleine letters:

toLower('Hello World')

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

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks die moet worden geretourneerd in hoofdletters

Retourwaarde	Type	Description
<hoofdletters/tekst>	String	De oorspronkelijke tekenreeks in hoofdletters

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar hoofdletters:

toUpper('Hello World')

En retourneert dit resultaat: "HELLO WORLD"

activeren

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

Retourwaarde	Type	Description
<trigger-output>	String	De uitvoer van een trigger tijdens runtime

triggerBody

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

triggerBody()

Retourwaarde	Type	Description
<trigger-body-output>	String	De body uitvoer van de trigger

triggerFormDataMultiValues

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

triggerFormDataMultiValues('<key>')

Parameter	Vereist	Type	Description
<key>	Ja	String	De naam voor de sleutel waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
[<matrix-met-sleutel-waarden>]	Matrix	Een matrix met alle waarden die overeenkomen met de opgegeven sleutel

Voorbeeld

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

Parameter	Vereist	Type	Description
<key>	Ja	String	De naam voor de sleutel waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
<sleutelwaarde>	String	De waarde in de opgegeven sleutel

Voorbeeld

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

Parameter	Vereist	Type	Description
<index>	Ja	Geheel getal	De indexwaarde voor het gewenste onderdeel

Retourwaarde	Type	Description
<hoofdtekst>	String	De hoofdtekst voor het opgegeven deel in de uitvoer van een trigger met meerdere onderdelen

triggerOutputs

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

triggerOutputs()

Retourwaarde	Type	Description
<trigger-output>	String	De uitvoer van een trigger tijdens runtime

trim

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

trim('<text>')

Parameter	Vereist	Type	Beschrijving
<tekst>	Ja	String	De tekenreeks met de voorloop- en volgspaties die u wilt verwijderen

Retourwaarde	Type	Description
<updatedText>	String	Een bijgewerkte versie voor de oorspronkelijke tekenreeks zonder voorloop- of volgspaties

Voorbeeld

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

trim(' Hello World  ')

En retourneert dit resultaat: "Hello World"

U

union

Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat. Als u het resultaat wilt weergeven, kan een item worden weergegeven in elke verzameling 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>], ...)

Parameter	Vereist	Type	Description
<collection1>, <collection2>, ...	Ja	Matrix of object, maar niet beide	De verzamelingen van waaruit u alle items wilt

Retourwaarde	Type	Description
<updatedCollection>	Matrix of object, respectievelijk	Een verzameling met alle items uit de opgegeven verzamelingen - geen duplicaten

Voorbeeld

In dit voorbeeld worden alle items uit deze verzamelingen opgehaald:

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

En 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, uriComponent() heeft dit de voorkeur.

uriComponent('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks die moet worden geconverteerd naar een URI-gecodeerde indeling

Retourwaarde	Type	Description
<gecodeerde-URI>	String	De tekenreeks met URI-codering met escapetekens

Voorbeeld

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De URI-gecodeerde tekenreeks die moet worden geconverteerd

Retourwaarde	Type	Description
<binary-for-encoded-uri>	String	De binaire versie voor de URI-gecodeerde tekenreeks. De binaire inhoud is base64-gecodeerd en vertegenwoordigd door $content.

Voorbeeld

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

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

En retourneert dit resultaat:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

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

uriComponentToString('<value>')

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks met URI-codering om te decoderen

Retourwaarde	Type	Description
<decoderen-URI>	String	De gedecodeerde versie voor de URI-gecodeerde tekenreeks

Voorbeeld

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

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

En retourneert dit resultaat: "https://contoso.com"

uriHost

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

uriHost('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI waarvan host u de waarde wilt bepalen

Retourwaarde	Type	Description
<hostwaarde>	String	De host waarde voor de opgegeven URI

Voorbeeld

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

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

En retourneert dit resultaat: "www.localhost.com"

URIPath

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

uriPath('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI waarvan path u de waarde wilt bepalen

Retourwaarde	Type	Description
<padwaarde>	String	De path waarde voor de opgegeven URI. Als path er geen waarde is, geeft u het teken /als resultaat.

Voorbeeld

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

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

En retourneert dit resultaat: "/catalog/shownew.htm"

uriPathAndQuery

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

uriPathAndQuery('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI wiens path en query waarden u wilt

Retourwaarde	Type	Description
<path-query-value>	String	De path en query waarden voor de opgegeven URI. Als path er geen waarde wordt opgegeven, geeft u het teken /als resultaat.

Voorbeeld

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

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

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

uriPort

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

uriPort('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI waarvan port u de waarde wilt bepalen

Retourwaarde	Type	Description
<poortwaarde>	Geheel getal	De port waarde voor de opgegeven URI. Als port er geen waarde wordt opgegeven, retourneert u de standaardpoort voor het protocol.

Voorbeeld

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

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

En retourneert dit resultaat: 8080

uriQuery

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

uriQuery('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI waarvan query u de waarde wilt bepalen

Retourwaarde	Type	Description
<querywaarde>	String	De query waarde voor de opgegeven URI

Voorbeeld

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

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

En retourneert dit resultaat: "?date=today"

uriScheme

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

uriScheme('<uri>')

Parameter	Vereist	Type	Description
<Uri>	Ja	String	De URI waarvan scheme u de waarde wilt bepalen

Retourwaarde	Type	Description
<scheme-value>	String	De scheme waarde voor de opgegeven URI

Voorbeeld

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

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

En retourneert dit resultaat: "http"

utcNow

Retourneer de huidige tijdstempel.

utcNow('<format>')

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

Parameter	Vereist	Type	Description
<format>	Nee	String	Een tekenreeks met een numerieke notatie die één opmaakaanduiding of een aangepast opmaakpatroon is. De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601 en informatie over de tijdzone behoudt. Als de indeling geen geldige waarde is, wordt er een fout gegenereerd.

Retourwaarde	Type	Description
<current-timestamp>	String	De huidige datum en tijd

Voorbeeld 1

Stel dat vandaag 15 april 2018 om 13:00:00 uur is. In dit voorbeeld wordt de huidige tijdstempel opgehaald:

utcNow()

En retourneert dit resultaat: "2018-04-15T13:00:00.0000000Z"

Voorbeeld 2

Stel dat vandaag 15 april 2018 om 13:00:00 uur is. In dit voorbeeld wordt de huidige tijdstempel opgehaald met behulp van de optionele D-indeling:

utcNow('D')

En retourneert dit resultaat: "Sunday, April 15, 2018"

V

variabelen

Retourneert de waarde voor een opgegeven variabele.

variables('<variableName>')

Parameter	Vereist	Type	Description
<variableName>	Ja	String	De naam voor de variabele waarvan u de waarde wilt bepalen

Retourwaarde	Type	Description
<variabele-waarde>	Alle	De waarde voor de opgegeven variabele

Voorbeeld

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

En retourneert dit resultaat: 20

Wo

werkstroom

Retourneer alle details over de werkstroom zelf tijdens de runtime.

workflow().<property>

Parameter	Vereist	Type	Description
<eigenschap>	Nee	String	De naam voor de werkstroomeigenschap waarvan u de waarde wilt bepalen Een werkstroomobject heeft standaard de volgende eigenschappen: name, type, id, location, en runtags. - De run eigenschapswaarde is een JSON-object dat deze eigenschappen bevat: name, typeen id. - De tags eigenschap is een JSON-object dat tags bevat die zijn gekoppeld aan uw logische app in Azure Logic Apps of stroom in Power Automate en de waarden voor deze tags. Raadpleeg tagresources, resourcegroepen en abonnementen voor logische organisatie in Azure voor meer informatie over tags in Azure-resources. Opmerking: een logische app heeft standaard geen tags, maar een Power Automate-stroom bevat de flowDisplayName en environmentName tags.

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 environmentName eigenschap van uw stroomflowDisplayName.

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

Parameter	Vereist	Type	Description
<value>	Ja	String	De tekenreeks met het JSON-object dat moet worden geconverteerd Het JSON-object mag slechts één hoofdeigenschap hebben. Dit kan geen matrix zijn. Gebruik het backslashteken (\) als escapeteken voor het dubbele aanhalingsteken (").

Retourwaarde	Type	Description
<xml-version>	Object	De gecodeerde XML voor de opgegeven tekenreeks of JSON-object

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>

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.

Notitie

In logische apps verbruik en Standaard gebruiken alle functie-expressies de .NET XPath-bibliotheek. XPath-expressies zijn compatibel met de onderliggende .NET-bibliotheek en ondersteunen alleen de expressie die door de onderliggende .NET-bibliotheek wordt ondersteund.

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

Parameter	Vereist	Type	Description
<xml>	Ja	Alle	De XML-tekenreeks om te zoeken naar knooppunten of waarden die overeenkomen met een XPath-expressiewaarde
<xpath>	Ja	Alle	De XPath-expressie die wordt gebruikt om overeenkomende XML-knooppunten of -waarden te vinden

Retourwaarde	Type	Description
<xml-node>	XML	Een XML-knooppunt wanneer slechts één knooppunt overeenkomt met de opgegeven XPath-expressie
<value>	Alle	De waarde van een XML-knooppunt wanneer slechts één waarde overeenkomt met de opgegeven XPath-expressie
[<xml-node1>, <xml-node2>, ...] -or- [<waarde1>, <waarde2>, ...]	Matrix	Een matrix met XML-knooppunten of -waarden die overeenkomen met de opgegeven XPath-expressie

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>

Belangrijk

Als u in de codeweergave werkt, escapet u het dubbele aanhalingsteken (") met behulp van het backslashteken (\). U moet bijvoorbeeld escapetekens gebruiken wanneer u een expressie serialiseert als een JSON-tekenreeks. Als u echter werkt in de ontwerpfunctie of expressie-editor, hoeft u niet te ontsnappen aan het dubbele aanhalingsteken omdat het backslashteken automatisch wordt toegevoegd aan de onderliggende definitie, bijvoorbeeld:

• Codeweergave: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

• Expressie-editor: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="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