Expressies en functies voor Data Factory in Microsoft Fabric

Dit artikel bevat informatie over expressies en functies die worden ondersteund door Data Factory in Microsoft Fabric.

Uitdrukkingen

Expressiewaarden in de definitie kunnen letterlijk zijn of expressies die tijdens runtime worden geëvalueerd. Bijvoorbeeld:

"value"

of

"@pipeline().parameters.password"

Expressies kunnen overal in een tekenreekswaarde worden weergegeven en resulteren altijd in een andere tekenreekswaarde. Als een waarde een expressie is, wordt de hoofdtekst van de expressie geëxtraheerd door het at-sign (@) te verwijderen. Als er een letterlijke tekenreeks nodig is die begint met @, moet deze worden geëscaped met @@. In de volgende voorbeelden ziet u hoe expressies worden geëvalueerd.

Expressiewaarde	Resultaat
"parameters"	De karakters 'parameters' worden geretourneerd.
parameters[1]	De tekens 'parameters[1]' worden geretourneerd.
"@@"	Er wordt een tekenreeks van 1 teken die '@' bevat teruggegeven.
" @"	Er wordt een tekenreeks van 2 tekens geretourneerd die @bevat.

Expressies kunnen ook worden weergegeven in tekenreeksen, met behulp van een functie met de naam tekenreeksinterpolatie waar expressies in @{ ... }worden verpakt. Bijvoorbeeld: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Met behulp van tekenreeksinterpolatie is het resultaat altijd een tekenreeks. Stel dat ik myNumber heb gedefinieerd als 42 en myString als foo:

Expressiewaarde	Resultaat
"@pipeline().parameters.myString"	Retourneert foo als een tekenreeks.
"@{pipeline().parameters.myString}"	Retourneert foo als een tekenreeks.
"@pipeline().parameters.myNumber"	Retourneert 42 als een getal.
"@{pipeline().parameters.myNumber}"	Retourneert 42 als een tekenreeks.
"Antwoord is: @{pipeline().parameters.myNumber}"	Retourneert de tekenreeks Answer is: 42.
@concat('Antwoord is: ', string(pipeline().parameters.myNumber))	Retourneert de tekenreeks Answer is: 42
"Antwoord is: @@{pipeline().parameters.myNumber}"	Retourneert de tekenreeks Answer is: @{pipeline().parameters.myNumber}.

Bij controlestroomactiviteiten zoals de ForEach-activiteit kunt u een array opgeven om over te itereren voor de eigenschapsitems en @item() gebruiken om een enkele opsomming in de ForEach-activiteit te herhalen. Als items bijvoorbeeld een matrix zijn: [1, 2, 3], retourneert @item() 1 in de eerste iteratie, 2 in de tweede iteratie en 3 in de derde iteratie. U kunt ook @range(0,10) zoals expressie gebruiken om 10 keer te herhalen vanaf 0 eindigend op 9.

U kunt @activity('activiteitsnaam') gebruiken om de uitvoer van activiteit vast te leggen en beslissingen te nemen. Overweeg een webactiviteit met de naam Web1. Voor het plaatsen van de uitvoer van de eerste activiteit in de hoofdtekst van de tweede ziet de expressie er doorgaans uit: @activity('Web1').output of @activity('Web1').output.data of iets vergelijkbaars, afhankelijk van hoe de uitvoer van de eerste activiteit eruitziet.

Voorbeelden

Voorbeeld van complexe expressie

In het onderstaande voorbeeld ziet u een complex voorbeeld dat verwijst naar een diep subveld van de uitvoer van de activiteit. Als u wilt verwijzen naar een pijplijnparameter die naar een subveld evalueert, gebruikt u de syntaxis [] in plaats van dot(.) operator (zoals in het geval van subveld1 en subveld2), als onderdeel van een activiteitsuitvoer.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Het dynamisch maken van bestanden en het benoemen ervan is een gangbaar patroon. Laten we enkele voorbeelden van dynamische bestandsnamen verkennen.

• Datum toevoegen aan een bestandsnaam: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Datum/tijd toevoegen in de tijdzone van de klant: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Triggertijd toevoegen: @concat('Test_', pipeline().TriggerTime)
• Een aangepaste bestandsnaam genereren in een Mapping Data Flow bij exporteren naar een enkel bestand met datum: 'Test_' + toString(currentDate()) + '.csv'

In bovenstaande gevallen worden vier dynamische bestandsnamen gemaakt vanaf Test_.

Dynamische inhoudseditor

De dynamische inhoudseditor vervangt automatisch tekens in uw inhoud na het bewerken. De volgende inhoud in de inhoudseditor is bijvoorbeeld een tekenreeksinterpolatie met een expressiefunctie.

"@{toUpper('myData')}"

De dynamische inhoudseditor converteert de bovenstaande inhoud naar expressie "@{toUpper('myData')}". Het resultaat van deze expressie is de opgemaakte tekenreeks die hieronder wordt weergegeven.

"MYDATA"

Speciale tekens vervangen

De dynamische inhoudseditor ontsnapt automatisch aan tekens zoals dubbele aanhalingstekens en backslash in uw inhoud, wanneer u klaar bent met bewerken. Dit veroorzaakt problemen als u regelinvoer of tab wilt vervangen met behulp van \n, \t in replace() functie. U kunt uw dynamische inhoud bewerken in de codeweergave om de extra \ in de expressie te verwijderen, of u kunt de onderstaande stappen volgen om speciale tekens te vervangen met behulp van expressietaal:

1. URL-codering op basis van de oorspronkelijke tekenreekswaarde
2. Vervang URL-gecodeerde tekenreeks, bijvoorbeeld regelfeed (%0A), regelterugloop (%0D), horizontale tab (%09).
3. URL-decodering

Variabele companyName bijvoorbeeld met een newlineteken in de waarde, expressie @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) het nieuwe regelteken kan verwijderen.

Contoso- Corporation

Eén aanhalingsteken ontsnappen

Expressiefuncties gebruiken enkele aanhalingstekens voor parameters voor tekenreekswaarden. Gebruik twee enkele aanhalingstekens om een ' teken in tekenreeksfuncties te escapen. De expressie @concat('Baba', '''s ', 'book store') retourneert bijvoorbeeld het onderstaande resultaat.

Baba's book store

Variabelen voor pijplijnbereik

Naar deze systeemvariabelen kan overal in de pijplijn worden verwezen.

Variabelenaam	Beschrijving
@pipeline().DataFactory	Id van de werkruimte waar de pijplijnuitvoering wordt uitgevoerd binnen
@pipeline().Pipeline	Id van de pijplijn
@pipeline().PipelineName	Naam van de pijplijn
@pipeline().RunId	ID van de specifieke pijplijnuitvoering
@pipeline().TriggerId	Id van de trigger die de pijplijn heeft aangeroepen
@pipeline().TriggerName	Naam van de trigger die de pijplijn heeft aangeroepen
@pipeline().TriggerTime	Tijd van de triggeractie die de pijplijn heeft opgestart. Dit is het tijdstip waarop de trigger daadwerkelijk is geactiveerd om de pijplijnuitvoering te starten, en dit kan enigszins afwijken van de geplande tijd van de trigger.
@pipeline().GroupId	Id van de groep waartoe de pijplijnuitvoering behoort.
@pipeline()?. TriggeredByPipelineName	Naam van de pijplijn die de pijplijnuitvoering activeert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Evalueer als Null wanneer het in andere omstandigheden wordt gebruikt. Let op het vraagteken na @pipeline()
@pipeline()?. TriggeredByPipelineRunId	De run-ID van de pijplijn die de pijplijnrun activeert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Evalueer als Null wanneer het in andere omstandigheden wordt gebruikt. Let op het vraagteken na @pipeline()

Notitie

Systeemvariabelen met betrekking tot triggers (in zowel pijplijn- als triggerbereiken) retourneren UTC-datums in ISO 8601-indeling, bijvoorbeeld 2017-06-01T22:20:00.4061448Z.

Functies

U kunt functies aanroepen binnen expressies. De volgende secties bevatten informatie over de functies die kunnen worden gebruikt in een expressie.

Datumfuncties

Datum- of tijdfunctie	Taak
addDays	Voeg een aantal dagen toe aan een tijdstempel.
addHours	Voeg een aantal uren toe aan een tijdstempel.
addMinutes	Voeg een aantal minuten toe aan een tijdstempel.
addSeconds	Voeg een aantal seconden toe aan een tijdstempel.
voegToeAanTijd	Voeg een aantal 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.
converteerNaarUtc	Converteer een tijdstempel van de brontijdzone naar Universal Time Coordinated (UTC).
dagVanDeMaand	Retourneer de dag van het maandonderdeel uit een tijdstempel.
dagVanDeWeek	Retourneert de dag van de weekcomponent uit een tijdstempel.
dagVanHetJaar	Retourneer de dag van het jaaronderdeel uit een tijdstempel.
datumTijdOpmaak	Retourneert de tijdstempel als een tekenreeks in optionele notatie.
getFutureTime	Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden. Zie ook addToTime.
getPastTime	Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden. Zie ook aftrekken van tijd.
start van de dag	Retourneer het begin van de dag voor een tijdstempel.
startVanHetUur	Retourneert het begin van het uur voor een tijdstempel.
beginVanMaand-	Retourneer het begin van de maand voor een tijdstempel.
vanFromTime aftrekken	Trek een aantal tijdseenheden af van een tijdstempel. Zie ook getPastTime.
tikken	Retourneert de ticks eigenschapswaarde voor een opgegeven tijdstempel.
utcNow	Retourneert de huidige tijdstempel als een tekenreeks.

Tekenreeksfuncties

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

Tekenreeksfunctie	Taak
samenvoegen	Combineer twee of meer tekenreeksen en retourneer de gecombineerde tekenreeks.
eindigt met	Controleer of een tekenreeks eindigt met de opgegeven subtekenreeks.
guid -	Genereer een GUID (Globally Unique Identifier) als een tekenreeks.
indexOf	Geef de beginpositie van een subtekenreeks terug.
lastIndexOf	Retourneert de beginpositie voor de laatste keer dat een subtekenreeks voorkomt.
vervangen	Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de bijgewerkte tekenreeks.
gesplitste	Retourneert een matrix die subtekenreeksen bevat, gescheiden door komma's, van een grotere tekenreeks op basis van een opgegeven scheidingsteken in de oorspronkelijke tekenreeks.
begintMet	Controleer of een tekenreeks begint met een specifieke subtekenreeks.
substring	Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie.
toLower	Retourneert een tekenreeks in kleineletterformaat.
toUpper	Retourneert een tekenreeks in hoofdletters.
	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	Taak
bevat	Controleer of een verzameling een specifiek item heeft.
lege	Controleer of een verzameling leeg is.
eerste	Retourneert het eerste item uit een verzameling.
snijpunt	Hiermee wordt een verzameling geretourneerd die alleen de gemeenschappelijke items van de opgegeven verzamelingen bevat.
deelnemen aan	Retourneert een tekenreeks met alle de items uit een array, gescheiden door het opgegeven teken.
laatste	Retourneer het laatste item uit een verzameling.
lengte	Retourneert het aantal items in een tekenreeks of matrix.
overslaan	Verwijder items uit het begin van een verzameling en retourneer alle andere items.
nemen	Items ophalen aan de voorkant van een verzameling.
	Geef een verzameling terug met alle items uit de opgegeven verzamelingen.

Logische functies

Deze functies zijn handig binnen voorwaarden, ze kunnen worden gebruikt om elk type logica te evalueren.

Logische vergelijkingsfunctie	Taak
en	Controleer of alle expressies waar zijn.
is gelijk aan	Controleer of beide waarden gelijkwaardig zijn.
groter	Controleer of de eerste waarde groter is dan de tweede waarde.
groter dan of gelijk aan	Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde.
als	Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.
minder	Controleer of de eerste waarde kleiner is dan de tweede waarde.
minder of gelijk aan	Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde.
niet	Controleer of een expressie onwaar is.
of	Controleer of ten minste één expressie waar is.

Conversiefuncties

Deze functies worden gebruikt om conversies uit te voeren tussen elk van de datatypes in de taal.

• snaar
• geheel getal
• drijven
• booleaans
• Arrays
• Woordenboeken

Conversiefunctie	Taak
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.
binaire	Geef de binaire weergave van een invoerwaarde.
bool	Retourneert de Boole-versie voor een invoerwaarde.
samensmelten	Retourneert de eerste niet-null-waarde van een of meer parameters.
array aanmaken	Retourneert een matrix van meerdere invoerwaarden.
dataUri	Retourneert de gegevens-URI voor een invoerwaarde.
dataUriToBinary	Retourneer de binaire versie van een gegevens-URI.
dataUriToString	Retourneert de tekenreeksversie voor een gegevens-URI.
decodeBase64	Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks.
decodeDataUri	Retourneer de binaire versie van 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.
float	Retourneert een drijvende-kommanummer voor een invoerwaarde.
	Retourneert de integer-versie van een tekenreeks.
tekenreeks	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.
xpath-	Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden.

Wiskundige functies

Deze functies kunnen worden gebruikt voor beide typen getallen: gehele getallen en floats.

Wiskundige functie	Taak
toevoegen	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 door twee getallen te vermenigvuldigen.
rand	Retourneert een willekeurig geheel getal uit een opgegeven bereik.
bereik	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.

Functiereferentie

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

toevoegen

Retourneert het resultaat van het optellen van twee getallen.

add(<summand_1>, <summand_2>)

Parameter	Vereist	Typ	Beschrijving
< >summand_1, summand_2<>	Ja	Geheel getal, kommagetal of gemengd	De getallen die moeten worden toegevoegd

Retourwaarde	Typ	Beschrijving
< >	Geheel getal of kommagetal	Het resultaat van het toevoegen van de opgegeven getallen

Voorbeeld

In dit voorbeeld worden de opgegeven getallen toegevoegd:

add(1, 1.5)

Retourneert dit resultaat: 2.5

voegDagenToe

Voeg een aantal dagen toe aan een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< dagen>	Ja	Geheel getal	Het positieve of negatieve aantal dagen dat moet worden toegevoegd
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	Het tijdstempel plus het opgegeven aantal dagen

voorbeeld 1

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

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

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

voorbeeld 2

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

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

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

urenToevoegen

Voeg een aantal uren toe aan een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< uur>	Ja	Geheel getal	Het positieve of negatieve aantal uren dat moet worden toegevoegd
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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)

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

voorbeeld 2

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

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

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

addMinutes

Voeg een aantal minuten toe aan een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< minuten>	Ja	Geheel getal	Het positieve of negatieve aantal minuten dat moet worden toegevoegd
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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)

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

voorbeeld 2

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

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

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

addSeconds

Voeg een aantal seconden toe aan een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< seconden>	Ja	Geheel getal	Het positieve of negatieve aantal seconden dat moet worden toegevoegd
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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)

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

voorbeeld 2

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

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

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

voegToeAanTijd

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

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden toegevoegd
< timeUnit>	Ja	Snaar	De tijdseenheid die moet worden gebruikt met interval: "Seconde", "Minuut", "Uur", "Dag", "Week", "Maand", "Jaar"
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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 beide expressies waar zijn. Retourneer 'waar' als beide uitdrukkingen waar zijn; anders retourneer 'onwaar' als ten minste één uitdrukking onwaar is.

and(<expression1>, <expression2>)

Parameter	Vereist	Typ	Beschrijving
< expressie1>, <expressie2>	Ja	Booleaans	De expressies die moeten worden gecontroleerd

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Geeft true terug wanneer beide expressies true zijn. Retourneer onwaar wanneer ten minste één expressie onwaar is.

voorbeeld 1

Deze voorbeelden controleren of de opgegeven Booleaanse waarden beide waar zijn:

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

En retourneert deze resultaten:

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

voorbeeld 2

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

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

En retourneert deze resultaten:

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

array

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

array('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De string voor het maken van een array

Retourwaarde	Typ	Beschrijving
[<waarde>]	Array	Een matrix die de enkele opgegeven invoer bevat

Voorbeeld

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

array('hello')

Retourneert dit resultaat: ["hello"]

base64

Retourneert de base64-gecodeerde versie voor een tekenreeks.

base64('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De invoertekenreeks

Retourwaarde	Typ	Beschrijving
< base64-tekenreeks>	Snaar	De base64-gecodeerde versie voor de invoertekenreeks

Voorbeeld

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

base64('hello')

Retourneert dit resultaat: "aGVsbG8="

base64ToBinary

Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks.

base64ToBinary('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De met base64 gecodeerde tekenreeks die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< binary-for-base64-string>	Snaar	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=')

En dit geeft het volgende resultaat:

"0110000101000111010101100111001101100010010001110011100000111101"

base64 naar string

Retourneer de tekenreeksversie voor een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd. Gebruik deze functie in plaats van decodeBase64(). Hoewel beide functies op dezelfde manier werken, heeft base64ToString() de voorkeur.

base64ToString('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De met base64 gecodeerde tekenreeks om te decoderen

Retourwaarde	Typ	Beschrijving
< gedecodeerde base64-tekenreeks>	Snaar	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=')

Retourneert dit resultaat: "hello"

binair

Retourneert de binaire versie voor een tekenreeks.

binary('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< binaire waarde voor invoerwaarde>	Snaar	De binaire versie voor de opgegeven tekenreeks

Voorbeeld

In dit voorbeeld wordt de 'hello'-tekenreeks geconverteerd naar een binaire tekenreeks:

binary('hello')

En dit geeft het volgende resultaat:

"0110100001100101011011000110110001101111"

Bool

Retourneert de Booleaanse versie voor een waarde.

bool(<value>)

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Enig	De waarde die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	De Booleaanse versie voor de opgegeven waarde

Voorbeeld

In deze voorbeelden worden de opgegeven waarden geconverteerd naar Booleaanse waarden:

bool(1)
bool(0)

En retourneert deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

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	Typ	Beschrijving
< >object_1, <object_2>, ...	Ja	Alle soorten kunnen worden gemengd	Een of meer items om te controleren op null-waarden

Retourwaarde	Typ	Beschrijving
< eerste niet-null-item>	Enig	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	Typ	Beschrijving
< tekst1>, <tekst2>, ...	Ja	Snaar	Ten minste twee tekenreeksen combineren

Retourwaarde	Typ	Beschrijving
< text1text2...>	Snaar	De tekenreeks die is gemaakt uit de gecombineerde invoerreeksen

Voorbeeld

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

concat('Hello', 'World')

Retourneert dit resultaat: "HelloWorld"

Bevat

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

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

Deze functie werkt met name op deze verzamelingstypen:

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks, matrix of woordenlijst	De verzameling die moet worden gecontroleerd
< waarde>	Ja	Tekenreeks, matrix of woordenlijst, respectievelijk	Het item dat moet worden gevonden

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Geeft true terug wanneer het item wordt gevonden. Retourneer false wanneer het niet gevonden is.

voorbeeld 1

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

contains('hello world', 'world')

voorbeeld 2

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

contains('hello world', 'universe')

convertFromUtc

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

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< destinationTimeZone>	Ja	Snaar	De naam voor de doeltijdzone. Zie Microsoft-tijdzonewaardenvoor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< geconverteerde tijdstempel>	Snaar	De tijdstempel geconverteerd naar de doeltijdzone

voorbeeld 1

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

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

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

voorbeeld 2

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

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

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

tijdzone converteren

Converteer een tijdstempel van de brontijdzone naar de doeltijdzone.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< sourceTimeZone>	Ja	Snaar	De naam voor de brontijdzone. Zie Microsoft-tijdzonewaardenvoor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
< destinationTimeZone>	Ja	Snaar	De naam voor de doeltijdzone. Zie Microsoft-tijdzonewaardenvoor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< geconverteerde tijdstempel>	Snaar	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')

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-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

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

converteerNaarUtc

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

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< sourceTimeZone>	Ja	Snaar	De naam voor de brontijdzone. Zie Microsoft-tijdzonewaardenvoor tijdzonenamen, maar mogelijk moet u interpunctie uit de tijdzonenaam verwijderen.
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< geconverteerde tijdstempel>	Snaar	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')

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

voorbeeld 2

In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC:

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

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

createArray

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

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

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

Retourwaarde	Typ	Beschrijving
[<object1>, <object2>, ...]	Array	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')

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

dataUri

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

dataUri('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< gegevens-URI>	Snaar	De gegevens-URI voor de invoertekenreeks

Voorbeeld

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De gegevens-URI die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< binary-for-data-uri>	Snaar	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 dit geeft het volgende resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De gegevens-URI die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< tekenreeks-voor-gegevens-URI>	Snaar	De tekenreeksversie voor de gegevens-URI

Voorbeeld

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

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

Retourneert dit resultaat: "hello"

dagVanDeMaand

Retourneer de dag van de maand uit een tijdstempel.

dayOfMonth('<timestamp>')

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat

Retourwaarde	Typ	Beschrijving
< 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')

Retourneert dit resultaat: 15

dagVanDeWeek

Retourneer de dag van de week vanaf een tijdstempel.

dayOfWeek('<timestamp>')

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat

Retourwaarde	Typ	Beschrijving
< 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')

Retourneert dit resultaat: 3

dayOfYear

Retourneer de dag van het jaar uit een tijdstempel.

dayOfYear('<timestamp>')

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat

Retourwaarde	Typ	Beschrijving
< 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')

Retourneert dit resultaat: 74

Base64 decoderen

Retourneer de tekenreeksversie voor een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd. Overweeg het gebruik van base64ToString() in plaats van decodeBase64(). Hoewel beide functies op dezelfde manier werken, heeft base64ToString() de voorkeur.

decodeBase64('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De met base64 gecodeerde tekenreeks om te decoderen

Retourwaarde	Typ	Beschrijving
< gedecodeerde base64-tekenreeks>	Snaar	De tekenreeksversie voor een met base64 gecodeerde tekenreeks

Voorbeeld

In dit voorbeeld wordt een tekenreeks gemaakt voor een met base64 gecodeerde tekenreeks:

decodeBase64('aGVsbG8=')

Retourneert dit resultaat: "hello"

decodeDataUri

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

decodeDataUri('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De gegevens-URI string die moet worden gedecodeerd

Retourwaarde	Typ	Beschrijving
< binary-for-data-uri>	Snaar	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 dit geeft het volgende resultaat:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks met de escapetekens om te decoderen

Retourwaarde	Typ	Beschrijving
< decoderen-URI>	Snaar	De bijgewerkte tekenreeks met de gedecodeerde escape-tekens

Voorbeeld

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

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

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

Div

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

div(<dividend>, <divisor>)

Parameter	Vereist	Typ	Beschrijving
< dividend>	Ja	Geheel getal of kommagetal	Het getal dat moet worden gedeeld door de deler
< deler>	Ja	Geheel getal of kommagetal	Het getal dat het dividend deelt, maar niet 0 kan zijn,.

Retourwaarde	Typ	Beschrijving
< quotiëntresultaat>	Geheel getal	Het gehele quotient van het eerste nummer gedeeld door het tweede nummer

Voorbeeld

In beide voorbeelden wordt het eerste getal gedeeld door het tweede getal:

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

En vervolgens retourneer dit resultaat: 2

encodeUriComponent

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

encodeUriComponent('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die moet worden geconverteerd naar een URI-gecodeerd formaat

Retourwaarde	Typ	Beschrijving
< gecodeerde URI>	Snaar	De URI-gecodeerde tekenreeks met escape-tekens

Voorbeeld

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

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

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

leeg

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

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks, reeks of Object	De verzameling die moet worden gecontroleerd

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Geef waar wanneer de verzameling leeg is. Retourneer onwaar als het 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 trueretourneert.
• Tweede voorbeeld: geeft de tekenreeks 'abc' door, zodat de functie falseretourneert.

eindigtMet

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

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

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

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer true wanneer de eindsubtekenreeks wordt gevonden. Retourneer false wanneer het niet gevonden is.

voorbeeld 1

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

endsWith('hello world', 'world')

Retourneert dit resultaat: true

voorbeeld 2

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

endsWith('hello world', 'universe')

Retourneert dit resultaat: false

is gelijk aan

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	Typ	Beschrijving
< object1>, <object2>	Ja	Verschillend	De waarden, expressies of objecten die moeten worden vergeleken

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer de waarheid als beide hetzelfde zijn. Geef false terug wanneer niet equivalent.

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 gelijkwaardig, dus de functie retourneert true.
• Tweede voorbeeld: Beide waarden zijn niet gelijkwaardig, dus de functie retourneert false.

eerste

Retourneert het eerste item uit een tekenreeks of matrix.

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks of array	De verzameling waar het eerste item moet worden gevonden

Retourwaarde	Typ	Beschrijving
< eerste verzamelingsitem>	Enig	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

drijven

Converteer een tekenreeksversie voor een drijvendekommagetal naar een werkelijk drijvendekommagetal.

float('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die een geldig drijvend-komma getal bevat om te converteren.

Retourwaarde	Typ	Beschrijving
< float-value>	Drijven	Het kommagetal met drijvende komma voor de opgegeven tekenreeks

Voorbeeld

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

float('10.333')

Retourneert dit resultaat: 10.333

formatDateTime

Retourneert een tijdstempel in de opgegeven indeling.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< opnieuw opgemaakte tijdstempel>	Snaar	De bijgewerkte tijdstempel in de opgegeven indeling

Voorbeeld

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

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Retourneert dit resultaat: "2018-03-15T12:00:00"

getFutureTime

Retourneer de huidige tijdstempel plus de opgegeven tijdseenheden.

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

Parameter	Vereist	Typ	Beschrijving
< interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden toegevoegd
< timeUnit>	Ja	Snaar	De tijdseenheid die moet worden gebruikt met interval: "Seconde", "Minuut", "Uur", "Dag", "Week", "Maand", "Jaar"
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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

voorbeeld 2

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

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

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

verstreken tijd ophalen

Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden.

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

Parameter	Vereist	Typ	Beschrijving
< interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
< timeUnit>	Ja	Snaar	De tijdseenheid die moet worden gebruikt met interval: "Seconde", "Minuut", "Uur", "Dag", "Week", "Maand", "Jaar"
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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

voorbeeld 2

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

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

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

groter

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

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

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of deze groter is dan de tweede waarde
< vergelijken met>	Ja	Geheel getal, zwevend kommagetal of string, respectievelijk	De vergelijkingswaarde

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer 'true' 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

groterOfGelijkAan

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

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

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of deze groter is dan of gelijk is aan de tweede waarde
< vergelijken met>	Ja	Geheel getal, zwevend kommagetal of string, respectievelijk	De vergelijkingswaarde

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer true 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	Typ	Beschrijving
< formaat>	Nee	Snaar	Eén notatieaanduiding voor de geretourneerde GUID. De indeling is standaard 'D', maar u kunt 'N', 'D', 'B', 'P' of 'X' gebruiken.

Retourwaarde	Typ	Beschrijving
< GUID-waarde>	Snaar	Een willekeurig gegenereerde GUID

Voorbeeld

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

guid('P')

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

als

Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.

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

Parameter	Vereist	Typ	Beschrijving
< uitdrukking>	Ja	Booleaans	De uitdrukking om te controleren
< valueIfTrue>	Ja	Enig	De waarde die moet worden geretourneerd wanneer de expressie waar is
< valueIfFalse>	Ja	Enig	De waarde die moet worden geretourneerd wanneer de expressie onwaar is

Retourwaarde	Typ	Beschrijving
< opgegeven retourwaarde>	Enig	De opgegeven waarde die wordt geretourneerd op basis van of de expressie waar of onwaar is

Voorbeeld

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

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

indexOf

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

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

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

Retourwaarde	Typ	Beschrijving
< 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')

Retourneert dit resultaat: 6

Int

Retourneert de integer-versie van een tekenreeks.

int('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< geheel-getal-resultaat>	Geheel getal	De gehele getalrepresentatie voor de opgegeven tekenreeks

Voorbeeld

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

int('10')

Retourneert dit resultaat: 10

json

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

json('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Tekenreeks of XML	De tekenreeks of XML die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< JSON-resultaat>	Ingebouwde JSON-type of object	De systeemeigen JSON-typewaarde of -object voor de opgegeven tekenreeks of XML. Als de tekenreeks null is, retourneert de functie een leeg object.

voorbeeld 1

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

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

Retourneert dit resultaat: [1, 2, 3]

voorbeeld 2

In dit voorbeeld wordt deze tekenreeks geconverteerd naar JSON:

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

En dit geeft het volgende resultaat:

{
  "fullName": "Sophia Owen"
}

voorbeeld 3

In dit voorbeeld wordt deze XML geconverteerd naar JSON:

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

En dit geeft het volgende resultaat:

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

kruispunt

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

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

Parameter	Vereist	Typ	Beschrijving
< collection1>, <collection2>, ...	Ja	Matrix of object, maar niet beide	De verzamelingen waarvan u alleen de gemeenschappelijke items wilt

Retourwaarde	Typ	Beschrijving
< algemene artikelen>	Array of objecten, respectievelijk	Een verzameling met alleen de gemeenschappelijke items tussen 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]

deelnemen aan

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

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Array	De matrix waaraan de items moeten worden gekoppeld
< scheidingsteken>	Ja	Snaar	Het scheidingsteken dat tussen elk teken in de resulterende tekenreeks verschijnt.

Retourwaarde	Typ	Beschrijving
< char1><scheidingsteken><teken2><scheidingsteken>...	Snaar	De resulterende tekenreeks die is gemaakt op basis van alle items in de opgegeven matrix

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

Retourneert dit resultaat: "a.b.c"

laatste

Retourneer het laatste item uit een verzameling.

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks of array	De verzameling waar het laatste item moet worden gevonden

Retourwaarde	Typ	Beschrijving
< laatste verzamelingsitem>	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

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

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

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

Retourwaarde	Typ	Beschrijving
< eind-index-waarde>	Geheel getal	De beginpositie of indexwaarde voor het laatste voorkomen van de opgegeven subtekenreeks. Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat.

Voorbeeld

In dit voorbeeld wordt de beginindexwaarde gevonden voor het laatste voorkomen van de subtekenreeks "world" in de tekenreeks "hello world":

lastIndexOf('hello world', 'world')

Retourneert dit resultaat: 6

lengte

Retourneert het aantal items in een verzameling.

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks of array	De verzameling met de items die moeten worden geteld

Retourwaarde	Typ	Beschrijving
< 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 vervolgens retourneer dit resultaat: 4

minder

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

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

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of kleiner is dan de tweede waarde
< vergelijken met>	Ja	Geheel getal, zwevend kommagetal of string, respectievelijk	Het vergelijkingsitem

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	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

kleinerDanOfGelijkAan

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	Typ	Beschrijving
< waarde>	Ja	Geheel getal, float of tekenreeks	De eerste waarde om te controleren of kleiner dan of gelijk is aan de tweede waarde
< vergelijken met>	Ja	Geheel getal, zwevend kommagetal of string, respectievelijk	Het vergelijkingsitem

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer true als de eerste waarde kleiner dan of gelijk aan de tweede waarde is. 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

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	Typ	Beschrijving
< getal1>, <getal2>, ...	Ja	Geheel getal, kommagetal 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	Typ	Beschrijving
< maximumwaarde>	Geheel getal of kommagetal	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 vervolgens retourneer dit resultaat: 3

Min

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

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

Parameter	Vereist	Typ	Beschrijving
< getal1>, <getal2>, ...	Ja	Geheel getal, kommagetal 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	Typ	Beschrijving
< min-waarde>	Geheel getal of kommagetal	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 vervolgens retourneer dit resultaat: 1

Mod

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

mod(<dividend>, <divisor>)

Parameter	Vereist	Typ	Beschrijving
< dividend>	Ja	Geheel getal of kommagetal	Het getal dat moet worden gedeeld door de deler
< deler>	Ja	Geheel getal of kommagetal	Het getal dat de dividend deelt, maar kan niet 0 zijn.

Retourwaarde	Typ	Beschrijving
< modulo-resultaat>	Geheel getal of kommagetal	Het restgetal van het delen van het eerste getal door het tweede getal

Voorbeeld

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

mod(3, 2)

En vervolgens retourneer dit resultaat: 1

mul

Retourneer het product door twee getallen te vermenigvuldigen.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Vereist	Typ	Beschrijving
< vermenigvuldigd1>	Ja	Geheel getal of kommagetal	Het getal om mee te vermenigvuldigen met multiplikand2
< vermenigvuldigd2>	Ja	Geheel getal of kommagetal	Het getal dat vermenigvuldigt met

Retourwaarde	Typ	Beschrijving
< productresultaat>	Geheel getal of kommagetal	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

niet

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

not(<expression>)

Parameter	Vereist	Typ	Beschrijving
< uitdrukking>	Ja	Booleaans	De uitdrukking om te controleren

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneer waarheidsgetrouw wanneer de expressie onwaar is. Retourneer onwaar wanneer de uitdrukking 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.

of

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

or(<expression1>, <expression2>)

Parameter	Vereist	Typ	Beschrijving
< expressie1>, <expressie2>	Ja	Booleaans	De expressies die moeten worden gecontroleerd

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneert waar wanneer ten minste één expressie waar is. Retourneer onwaar wanneer beide 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.

rand

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

rand(<minValue>, <maxValue>)

Parameter	Vereist	Typ	Beschrijving
< minWaarde>	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	Typ	Beschrijving
< willekeurige resultaten>	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, 3of 4

bereik

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

range(<startIndex>, <count>)

Parameter	Vereist	Typ	Beschrijving
< startIndex>	Ja	Geheel getal	Een geheel getal dat de array als eerste item start
< aantal>	Ja	Geheel getal	Het aantal gehele getallen in de array

Retourwaarde	Typ	Beschrijving
[<bereikresultaat>]	Array	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)

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

vervangen

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

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

Parameter	Vereist	Typ	Beschrijving
< tekst>	Ja	Snaar	De tekenreeks met de subtekenreeks die moet worden vervangen
< oldText>	Ja	Snaar	De te vervangen subtekenreeks
< newText>	Ja	Snaar	De vervangende tekenreeks

Retourwaarde	Typ	Beschrijving
< bijgewerkte tekst>	Snaar	De bijgewerkte tekenreeks na het vervangen van de subtekenreeks Als de subtekenreeks niet wordt gevonden, wordt de oorspronkelijke tekenreeks geretourneerd.

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

Retourneert dit resultaat: "the new string"

overslaan

Verwijder items uit het begin van een verzameling en retourneer alle andere items.

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Array	De verzameling waarvan u de items wilt verwijderen
< aantal>	Ja	Geheel getal	Een positief geheel getal voor het aantal items dat aan de voorkant moet worden verwijderd

Retourwaarde	Typ	Beschrijving
[<bijgewerkte verzameling>]	Array	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]

splijten

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	Typ	Beschrijving
< tekst>	Ja	Snaar	De tekenreeks die moet worden gescheiden in subtekenreeksen op basis van het opgegeven scheidingsteken in de oorspronkelijke tekenreeks
< scheidingsteken>	Ja	Snaar	Het teken in de oorspronkelijke tekenreeks dat moet worden gebruikt als scheidingsteken

Retourwaarde	Typ	Beschrijving
[<deelreeks1>,<deelreeks2>,...]	Array	Een matrix die subtekenreeksen van de oorspronkelijke tekenreeks bevat, gescheiden door komma's

Voorbeeld

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

beginVanDeDag

Retourneer het begin van de dag voor een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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

begin van het uur

Retourneert het begin van het uur voor een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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

beginVanMaand

Retourneer het begin van de maand voor een tijdstempel.

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	De opgegeven tijdstempel, maar beginnend op de eerste dag van de maand op het nuluurmarkering

Voorbeeld

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

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

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

begintMet

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

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

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

Retourwaarde	Typ	Beschrijving
waar of onwaar	Booleaans	Retourneert true wanneer een beginsubtekenreeks wordt aangetroffen. Retourneer false wanneer het niet gevonden is.

voorbeeld 1

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

startsWith('hello world', 'hello')

Retourneert dit resultaat: true

voorbeeld 2

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

startsWith('hello world', 'greetings')

Retourneert dit resultaat: false

snaar

Retourneert de tekenreeksweergave van een waarde.

string(<value>)

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Enig	De waarde die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< tekenreekswaarde>	Snaar	De tekenreeksversie voor de opgegeven waarde

voorbeeld 1

In dit voorbeeld wordt de tekenreeksversie voor dit getal gemaakt:

string(10)

Retourneert dit resultaat: "10"

voorbeeld 2

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

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

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

sub

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

sub(<minuend>, <subtrahend>)

Parameter	Vereist	Typ	Beschrijving
< minuend>	Ja	Geheel getal of kommagetal	Het getal waaruit de moet worden afgetrokken
< aftrekken van>	Ja	Geheel getal of kommagetal	Het getal dat moet worden afgetrokken van het -aftrektal

Retourwaarde	Typ	Beschrijving
< resultaat>	Geheel getal of kommagetal	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)

Retourneert dit resultaat: 10

substring

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

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

Parameter	Vereist	Typ	Beschrijving
< tekst>	Ja	Snaar	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
< lengte>	Ja	Geheel getal	Een positief aantal tekens dat u in de subtekenreeks wilt opnemen

Retourwaarde	Typ	Beschrijving
< subtekenreeksresultaat>	Snaar	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)

Retourneert dit resultaat: "world"

aftrekkenVanTijd

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

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

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks die de tijdstempel bevat
< interval>	Ja	Geheel getal	Het aantal opgegeven tijdseenheden dat moet worden afgetrokken
< timeUnit>	Ja	Snaar	De tijdseenheid die moet worden gebruikt met interval: "Seconde", "Minuut", "Uur", "Dag", "Week", "Maand", "Jaar"
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< bijgewerkte tijdstempel>	Snaar	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')

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"

nemen

Items ophalen aan de voorkant van een verzameling.

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

Parameter	Vereist	Typ	Beschrijving
< verzameling>	Ja	Tekenreeks of array	De verzameling waarvan u de items wilt
< aantal>	Ja	Geheel getal	Een positief geheel getal voor het aantal items dat je van voren wilt hebben

Retourwaarde	Typ	Beschrijving
< deelverzameling> of [<deelverzameling>]	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 de ticks eigenschapswaarde voor een opgegeven tijdstempel. Een tick is een interval van 100 nanoseconden.

ticks('<timestamp>')

Parameter	Vereist	Typ	Beschrijving
< tijdstempel>	Ja	Snaar	De tekenreeks voor een tijdstempel

Retourwaarde	Typ	Beschrijving
< streepjesaantal>	Geheel getal	Het aantal tikken dat is verstreken sinds 12:00:00 middernacht, 1 januari 0001 in de Gregoriaanse kalender sinds de tijdstempel van invoer

toLower

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

toLower('<text>')

Parameter	Vereist	Typ	Beschrijving
< tekst>	Ja	Snaar	De tekenreeks die in kleine lettervorm moet worden teruggegeven

Retourwaarde	Typ	Beschrijving
< kleine letters>	Snaar	De oorspronkelijke tekenreeks in kleine letters

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar kleine letters:

toLower('Hello World')

Retourneert dit resultaat: "hello world"

toUpper

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

toUpper('<text>')

Parameter	Vereist	Typ	Beschrijving
< tekst>	Ja	Snaar	De tekenreeks die moet worden geretourneerd in hoofdletters

Retourwaarde	Typ	Beschrijving
< hoofdlettertekst>	Snaar	De oorspronkelijke tekenreeks in hoofdletterformaat

Voorbeeld

In dit voorbeeld wordt deze tekenreeks geconverteerd naar hoofdletters:

toUpper('Hello World')

Retourneert dit resultaat: "HELLO WORLD"

trimmen

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

trim('<text>')

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

Retourwaarde	Typ	Beschrijving
< updatedText>	Snaar	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  ')

Retourneert dit resultaat: "Hello World"

unie

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

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

Parameter	Vereist	Typ	Beschrijving
< collection1>, <collection2>, ...	Ja	Matrix of object, maar niet beide	De verzamelingen waarvan u alle items wilt

Retourwaarde	Typ	Beschrijving
< updatedCollection>	Array of objecten, respectievelijk	Een verzameling met alle items uit de opgegeven verzamelingen - geen duplicaten

Voorbeeld

In dit voorbeeld haalt alle items uit deze verzamelingen op:

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

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

uriComponent

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

uriComponent('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De tekenreeks die moet worden geconverteerd naar een URI-gecodeerd formaat

Retourwaarde	Typ	Beschrijving
< gecodeerde URI>	Snaar	De URI-gecodeerde tekenreeks met escape-tekens

Voorbeeld

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	De URI-gecodeerde tekenreeks die moet worden geconverteerd

Retourwaarde	Typ	Beschrijving
< binary-for-encoded-uri>	Snaar	De binaire versie voor de URI-gecodeerde tekenreeks. De binaire inhoud wordt met base64 gecodeerd en vertegenwoordigd door $content.

Voorbeeld

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

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

En dit geeft het volgende 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	Typ	Beschrijving
< waarde>	Ja	Snaar	De URI-gecodeerde tekenreeks om te decoderen

Retourwaarde	Typ	Beschrijving
< decoderen-URI>	Snaar	De gedecodeerde versie voor de URI-gecodeerde tekenreeks

Voorbeeld

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

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

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

utcNow

Retourneer de huidige tijdstempel.

utcNow('<format>')

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

Parameter	Vereist	Typ	Beschrijving
< formaat>	Nee	Snaar	Een enkelvoudige opmaaknotatie of een aangepast opmaakpatroon . De standaardindeling voor de tijdstempel is 'o' (jjjj-MM-ddTHH:mm:ss.fffffffK), die voldoet aan ISO 8601- en behoudt tijdzonegegevens.

Retourwaarde	Typ	Beschrijving
< huidige tijdstempel>	Snaar	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()

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 het optionele "D-formaat".

utcNow('D')

Retourneert dit resultaat: "Sunday, April 15, 2018"

xml

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

xml('<value>')

Parameter	Vereist	Typ	Beschrijving
< waarde>	Ja	Snaar	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	Typ	Beschrijving
< xml-versie>	Object	De gecodeerde XML voor de opgegeven tekenreeks of JSON-object

voorbeeld 1

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 2

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.

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

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

Retourwaarde	Typ	Beschrijving
< xml-knooppunt>	XML	Een XML-knooppunt wanneer slechts één knooppunt overeenkomt met de opgegeven XPath-expressie
< waarde>	Enig	De waarde van een XML-knooppunt wanneer slechts één waarde overeenkomt met de opgegeven XPath-expressie
[<xml-node1>, <xml-node2>, ...] -or- [<waarde1>, <waarde2>, ...]	Array	Een matrix met XML-knooppunten of -waarden die overeenkomen met de opgegeven XPath-expressie

voorbeeld 1

Na voorbeeld 1 vindt u in dit voorbeeld knooppunten die overeenkomen met het <count></count> knooppunt en voegt u deze knooppuntwaarden toe met de functie sum():

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

Retourneert dit resultaat: 30

voorbeeld 2

Voor dit voorbeeld zoeken beide expressies knooppunten die overeenkomen met het knooppunt <location></location>, in de opgegeven argumenten, die XML met een naamruimte bevatten. De expressies gebruiken het backslashteken (\) als escapeteken voor het dubbele aanhalingsteken (").

• Expressie 1

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

• Expressie 2

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

Dit zijn de argumenten:

• Deze XML, die de XML-documentnaamruimte bevat, xmlns="http://contoso.com":

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

• U kunt hier een van beide XPath-expressies gebruiken:

  • /*[name()=\"file\"]/*[name()=\"location\"]

  • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

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

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

voorbeeld 3

Bij dit voorbeeld, aansluitend op voorbeeld 3, wordt de waarde in het knooppunt <location></location> gevonden.

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

Retourneert dit resultaat: "Paris"

Notitie

U kunt opmerkingen toevoegen aan expressies voor gegevensstromen, maar niet in pijplijnexpressies.

Verwante inhoud

Raadpleeg Parameters voor Data Factory in Fabric voor instructies voor algemeen parametergebruik