Expressies en functies in Azure Data Factory en Azure Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Dit artikel bevat informatie over expressies en functies die worden ondersteund door Azure Data Factory en Azure Synapse Analytics.

Expressies

JSON-waarden in de definitie kunnen letterlijke waarden zijn of expressies die tijdens runtime worden geëvalueerd. Bijvoorbeeld:

"name": "value"

of

"name": "@pipeline().parameters.password"

Expressies kunnen overal in een JSON-tekenreekswaarde worden weergegeven en resulteren altijd in een andere JSON-waarde. Als een JSON-waarde een expressie is, wordt de body van de expressie geëxtraheerd door het at-sign () te @ verwijderen. Als u een letterlijke tekenreeks nodig hebt die begint met @ , moet u een escape-tekenreeks gebruiken met @ @ . De volgende voorbeelden laten zien hoe expressies worden geëvalueerd.

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

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

In de controlestroomactiviteiten, zoals ForEach-activiteit, kunt u een matrix bieden die moet worden iterated voor de eigenschapsitems en () gebruiken om één @item enumeratie in ForEach-activiteit te itereren. Als items bijvoorbeeld een matrix zijn: [1, 2, 3], () retourneert 1 in de eerste iteratie, 2 in de tweede iteratie en 3 in de derde @item iteratie. U kunt ook (0,10) zoals een expressie gebruiken om tien keer te itereren, te beginnen @range met 0 eindigend op 9.

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

Voorbeelden

Voorbeeld van complexe expressie

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

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

Het dynamisch maken van bestanden en het benoemen van bestanden is een veelvoorkomende patroon. Laten we enkele voorbeelden van dynamische bestandsnaamgeving bekijken.

1. Datum toevoegen aan een bestandsnaam: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

2. Datum/tijd in de tijdzone van de klant worden bijgewerkt: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

3. Triggertijd voor het appen: @concat('Test_', pipeline().TriggerTime)

4. Een aangepaste bestandsnaam in een toewijzingsgegevensbestand Flow uitvoer naar één bestand met de datum :'Test_' + toString(currentDate()) + '.csv'

In bovenstaande gevallen worden 4 dynamische bestandsnamen gemaakt, te beginnen met Test_.

Dynamische inhoudseditor

Dynamische inhoudseditor escapet automatisch tekens in uw inhoud wanneer u klaar bent met bewerken. De volgende inhoud in de inhoudseditor is bijvoorbeeld een tekenreeksinterpolatie met twee expressiefuncties.

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

Dynamische inhoudseditor converteert bovenstaande inhoud naar expressie "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}" . Het resultaat van deze expressie is een tekenreeks in JSON-indeling die hieronder wordt weergegeven.

{
  "type": "Table",
  "name": "MYDATA"
}

Een gegevensset met een parameter

In het volgende voorbeeld gebruikt de BlobDataset een parameter met de naam path. De waarde wordt gebruikt om een waarde in te stellen voor de eigenschap folderPath met behulp van de expressie : dataset().path .

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

Een pijplijn met een parameter

In het volgende voorbeeld gebruikt de pijplijn de parameters inputPath en outputPath. Het pad voor de geparameteriseerde blobgegevensset wordt ingesteld met behulp van de waarden van deze parameters. De syntaxis die hier wordt gebruikt, is: pipeline().parameters.parametername .

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

Speciale tekens vervangen

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

1. URL-codering op de oorspronkelijke tekenreekswaarde
2. Vervang de url-gecodeerde tekenreeks, bijvoorbeeld regelfeed (%0A), een regel retour (%0D), een horizontaal tabblad (%09).
3. URL-decoderen

Met de variabele companyName met een teken voor een nieuwe regel in de waarde kan de expressie @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) bijvoorbeeld het teken newline verwijderen.

Contoso-
Corporation

Escape-teken met één aangave

Expressiefuncties gebruiken enkele aangave voor tekenreekswaardeparameters. Gebruik twee enkele aanhalingstekens om een '-teken in tekenreeksfuncties te escapen. Met de expressie @concat('Baba', '''s ', 'book store') wordt bijvoorbeeld het onderstaande resultaat weergegeven.

Baba's book store

Zelfstudie

Deze zelfstudie laat u zien hoe u parameters kunt doorgeven tussen een pijplijn en activiteit, evenals tussen de activiteiten. De zelfstudie demonstreert specifiek de stappen voor een Azure Data Factory hoewel de stappen voor een Synapse-werkruimte bijna gelijkwaardig zijn, maar met een iets andere gebruikersinterface.

Functions

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

Datumfuncties

Tekenreeksfuncties

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

Verzamelingsfuncties

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

Logische functies

Deze functies zijn nuttig binnen voorwaarden. Ze kunnen worden gebruikt om elk type logica te evalueren.

Conversiefuncties

Deze functies worden gebruikt om te converteren tussen elk van de systeemeigen typen in de taal:

• tekenreeks
• geheel getal
• float
• booleaans
• Arrays
• Woordenboeken

Wiskundige functies

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

Functieverwijzing

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

add

Het resultaat van het toevoegen van twee getallen retourneren.

add(<summand_1>, <summand_2>)

Voorbeeld

In dit voorbeeld worden de opgegeven getallen toegevoegd:

add(1, 1.5)

En retourneert dit resultaat: 2.5

addDays

Voeg een aantal dagen toe aan een tijdstempel.

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

Voorbeeld 1

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

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

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

Voorbeeld 2

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

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

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

addHours

Voeg een aantal uren toe aan een tijdstempel.

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

Voorbeeld 1

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

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

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

Voorbeeld 2

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

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

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

addMinutes

Voeg een aantal minuten toe aan een tijdstempel.

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

Voorbeeld 1

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

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

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

Voorbeeld 2

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

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

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

addSeconds

Voeg een aantal seconden toe aan een tijdstempel.

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

Voorbeeld 1

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

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

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

Voorbeeld 2

In dit voorbeeld worden 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 een aantal tijdseenheden toe aan een tijdstempel. Zie ook getFutureTime().

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

Voorbeeld 1

In dit voorbeeld wordt één dag toegevoegd aan het 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 het opgegeven tijdstempel:

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

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

en

Controleer of beide expressies waar zijn. Retourneert true wanneer beide expressies waar zijn of onwaar retourneren wanneer ten minste één expressie onwaar is.

and(<expression1>, <expression2>)

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 true, dus retourneert true .
• Tweede voorbeeld: Eén expressie is onwaar, dus retourneert false .
• Derde voorbeeld: Beide expressies zijn onwaar, dus retourneert false .

Voorbeeld 2

Deze voorbeelden controleren 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 true, dus retourneert true .
• Tweede voorbeeld: Eén 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 invoer.

array('<value>')

Voorbeeld

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

array('hello')

En retourneert dit resultaat: ["hello"]

base64

Retourneerde de met base64 gecodeerde versie voor een tekenreeks.

base64('<value>')

Voorbeeld

In dit voorbeeld wordt de hello-tekenreeks ge converteerd naar een tekenreeks met base64-codering:

base64('hello')

En retourneert dit resultaat: "aGVsbG8="

base64ToBinary

Retourneerde de binaire versie voor een tekenreeks met base64-codering.

base64ToBinary('<value>')

Voorbeeld

In dit voorbeeld wordt de tekenreeks met base64-codering 'aGVsbG8=' ge converteerd naar een binaire tekenreeks:

base64ToBinary('aGVsbG8=')

En retourneert dit resultaat:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Retourneert de tekenreeksversie voor een tekenreeks met base64-codering, die de base64-tekenreeks effectief decodeert. Gebruik deze functie in plaats van decoderenBase64(). Hoewel beide functies op dezelfde manier werken, base64ToString() heeft de voorkeur.

base64ToString('<value>')

Voorbeeld

In dit voorbeeld wordt de met base64 gecodeerde tekenreeks 'aGVsbG8=' ge converteerd naar slechts een tekenreeks:

base64ToString('aGVsbG8=')

En retourneert dit resultaat: "hello"

binair

De binaire versie voor een tekenreeks retourneren.

binary('<value>')

Voorbeeld

In dit voorbeeld wordt de hello-tekenreeks ge converteert naar een binaire tekenreeks:

binary('hello')

En retourneert dit resultaat:

"0110100001100101011011000110110001101111"

booleaans

Retourneert de Booleaanse versie voor een waarde.

bool(<value>)

Voorbeeld

In deze voorbeelden worden de opgegeven waarden ge converteerd naar Booleaanse waarden:

bool(1)
bool(0)

En retourneert deze resultaten:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

coalesce

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

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

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 retourner de gecombineerde tekenreeks.

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

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. Retourneren waar wanneer het item wordt gevonden of onwaar retourneren wanneer het niet wordt gevonden. Deze functie is casegevoelig.

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

Deze functie werkt specifiek voor deze verzamelingstypen:

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

Voorbeeld 1

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd voor de subtekenreeks 'world' en wordt 'true' retourneren:

contains('hello world', 'world')

Voorbeeld 2

In dit voorbeeld wordt de tekenreeks 'hallo wereld' gecontroleerd op de subtekenreeks 'universe' en wordt false (onwaar) retourneren:

contains('hello world', 'universe')

convertFromUtc

Convert a timestamp from Universal Time Coordinated (UTC) to the target time zone.

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

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel ge converteerd naar de opgegeven tijdzone:

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

En retourneert dit resultaat: "2018-01-01T00:00:00Z"

Voorbeeld 2

In dit voorbeeld wordt een tijdstempel ge converteerd 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

Converteert een tijdstempel van de brontijdzone naar de doeltijdzone.

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

Voorbeeld 1

In dit voorbeeld wordt de brontijdzone ge converteert 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 ge converteerd naar de opgegeven tijdzone en indeling:

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

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

convertToUtc

Convert a timestamp from the source time zone to Universal Time Coordinated (UTC).

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

Voorbeeld 1

In dit voorbeeld wordt een tijdstempel ge converteert 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 ge converteert 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 invoer. Zie array() voor enkele invoer matrices.

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

Voorbeeld

In dit voorbeeld wordt een matrix gemaakt op basis van deze invoer:

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

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

dataUri

Een URI (Data Uniform Resource Identifier) voor een tekenreeks retourneren.

dataUri('<value>')

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

De binaire versie voor een URI (Data Uniform Resource Identifier) retourneren. Gebruik deze functie in plaats van decodeDataUri(). Hoewel beide functies op dezelfde manier werken, dataUriBinary() heeft de voorkeur.

dataUriToBinary('<value>')

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

De tekenreeksversie voor een URI (Data Uniform Resource Identifier) retourneren.

dataUriToString('<value>')

Voorbeeld

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

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

En retourneert dit resultaat: "hello"

dayOfMonth

Retourneerde de dag van de maand uit een tijdstempel.

dayOfMonth('<timestamp>')

Voorbeeld

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

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

En retourneert dit resultaat: 15

dayOfWeek

Retourneerde de dag van de week uit een tijdstempel.

dayOfWeek('<timestamp>')

Voorbeeld

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

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

En retourneert dit resultaat: 3

dayOfYear

Retourneerde de dag van het jaar uit een tijdstempel.

dayOfYear('<timestamp>')

Voorbeeld

In dit voorbeeld wordt het nummer van de dag van het jaar uit deze tijdstempel:

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

En retourneert dit resultaat: 74

decoderenBase64

Retourneert de tekenreeksversie voor een met base64 gecodeerde tekenreeks, en decodeert de base64-tekenreeks effectief. Overweeg het gebruik van base64ToString() in plaats van decodeBase64() . Hoewel beide functies op dezelfde manier werken, base64ToString() heeft de voorkeur.

decodeBase64('<value>')

Voorbeeld

In dit voorbeeld wordt een tekenreeks gemaakt voor een tekenreeks met base64-codering:

decodeBase64('aGVsbG8=')

En retourneert dit resultaat: "hello"

decodeDataUri

Retourneren van de binaire versie voor een URI (Data Uniform Resource Identifier). Overweeg het gebruik van dataUriToBinary()in plaats van decodeDataUri() . Hoewel beide functies op dezelfde manier werken, dataUriToBinary() heeft de voorkeur.

decodeDataUri('<value>')

Voorbeeld

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

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

Voorbeeld

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

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

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

div

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

div(<dividend>, <divisor>)

Voorbeeld

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

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

En dit resultaat retourneren: 2

encodeUriComponent

Retourneert een met uniform resource identifier (URI) gecodeerde versie voor een tekenreeks door URL-onveilige tekens te vervangen door escape-tekens. Overweeg het gebruik van uriComponent()in plaats van encodeUriComponent() . Hoewel beide functies op dezelfde manier werken, uriComponent() heeft de voorkeur.

encodeUriComponent('<value>')

Voorbeeld

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

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

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

leeg

Controleer of een verzameling leeg is. Retourner true wanneer de verzameling leeg is of als false wordt retourneren wanneer deze niet leeg is.

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

Voorbeeld

Deze voorbeelden controleren of de opgegeven verzamelingen leeg zijn:

empty('')
empty('abc')

En retourneert deze resultaten:

• Eerste voorbeeld: Geeft een lege tekenreeks door, zodat de functie true retourneert.
• Tweede voorbeeld: geeft de tekenreeks 'abc' door, zodat de functie false retourneert.

endsWith

Controleer of een tekenreeks eindigt met een specifieke subtekenreeks. Retourneert true wanneer de subtekenreeks wordt gevonden of retourneert false als deze niet is gevonden. Deze functie is niet casegevoelig.

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

Voorbeeld 1

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

endsWith('hello world', 'world')

En retourneert dit resultaat: true

Voorbeeld 2

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

endsWith('hello world', 'universe')

En retourneert dit resultaat: false

is gelijk aan

Controleer of beide waarden, expressies of objecten gelijkwaardig zijn. True retourneren wanneer beide gelijkwaardig zijn, of onwaar retourneren wanneer ze niet gelijkwaardig zijn.

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

Voorbeeld

Deze voorbeelden controleren of de opgegeven invoer gelijk 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 equivalent, dus de functie retourneert false .

Eerste

Het eerste item uit een tekenreeks of matrix retourneren.

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

Voorbeeld

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

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

En deze resultaten retourneren:

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

float

Converteert een tekenreeksversie voor een drijvende-puntnummer naar een werkelijk drijvende-puntnummer.

float('<value>')

Voorbeeld

In dit voorbeeld wordt een tekenreeksversie gemaakt voor dit drijvende-puntnummer:

float('10.333')

En retourneert dit resultaat: 10.333

formatDateTime

Retourneert een tijdstempel in de opgegeven indeling.

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

Voorbeeld

In dit voorbeeld wordt een tijdstempel ge converteerd naar de opgegeven indeling:

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

En retourneert dit resultaat: "2018-03-15T12:00:00"

getFutureTime

Retourneert de huidige tijdstempel plus de opgegeven tijdeenheden.

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

Voorbeeld 1

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

getFutureTime(5, 'Day')

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 ge converteert naar D-indeling:

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

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

getPastTime

Retourneert de huidige tijdstempel min de opgegeven tijdeenheden.

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

Voorbeeld 1

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

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 worden vijf dagen afgetrokken en wordt het resultaat ge converteert naar D-indeling:

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 true wanneer de eerste waarde meer is, of retourneert false wanneer deze kleiner is.

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

Voorbeeld

Deze voorbeelden controleren of de eerste waarde groter is dan de tweede waarde:

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

En deze resultaten retourneren:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

greaterOrEquals

Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneert true wanneer de eerste waarde groter of gelijk is of false retourneert wanneer de eerste waarde kleiner is.

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

Voorbeeld

Deze voorbeelden controleren of de eerste waarde groter of gelijk is aan de tweede waarde:

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

En deze resultaten retourneren:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

guid

Genereer een globally unique identifier (GUID) als een tekenreeks, bijvoorbeeld 'c2ecc88d-88c8-4096-912c-d6f2e2b138ce':

guid()

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

guid('<format>')

Voorbeeld

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

guid('P')

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

if

Controleer of een expressie waar of onwaar is. Retourneert op basis van het resultaat een opgegeven waarde.

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

Voorbeeld

Dit voorbeeld "yes" retourneert 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 hoofdgevoelig en indexen beginnen met het getal 0.

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

Voorbeeld

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

indexOf('hello world', 'world')

En retourneert dit resultaat: 6

int

Retourner de geheel getal-versie voor een tekenreeks.

int('<value>')

Voorbeeld

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

int('10')

En retourneert dit resultaat: 10

json

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

json('<value>')

Voorbeeld 1

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

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

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

Voorbeeld 2

In dit voorbeeld wordt deze tekenreeks ge converteert naar JSON:

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

En retourneert dit resultaat:

{
  "fullName": "Sophia Owen"
}

Voorbeeld 3

In dit voorbeeld wordt deze XML ge converteert naar JSON:

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

Snijpunt

Retourneert een verzameling die alleen de algemene items in de opgegeven verzamelingen bevat. Om in het resultaat te worden weergegeven, 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 in het resultaat weergegeven.

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

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

Retourneren een tekenreeks die alle items uit een matrix heeft en elk teken door een scheidingsteken heeft gescheiden.

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

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"

Laatste

Het laatste item uit een verzameling retourneren.

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

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 hoofdgevoelig en indexen beginnen met het getal 0.

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

Voorbeeld

In dit voorbeeld wordt de beginindexwaarde gevonden voor het laatste exemplaar van de subtekenreeks 'world' in de 'hallo wereld'-tekenreeks:

lastIndexOf('hello world', 'world')

En retourneert dit resultaat: 6

lengte

Het aantal items in een verzameling retourneren.

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

Voorbeeld

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

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

En dit resultaat retourneren: 4

less

Controleer of de eerste waarde kleiner is dan de tweede waarde. Retourneert true wanneer de eerste waarde kleiner is of retourneert false wanneer de eerste waarde meer is.

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

Voorbeeld

Deze voorbeelden controleren of de eerste waarde kleiner is dan de tweede waarde.

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

En deze resultaten retourneren:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

lessOrEquals

Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneert true wanneer de eerste waarde kleiner is dan of gelijk is, of false retourneert wanneer de eerste waarde meer is.

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

Voorbeeld

Deze voorbeelden controleren of de eerste waarde kleiner of gelijk is aan de tweede waarde.

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

En deze resultaten retourneren:

• Eerste voorbeeld: true
• Tweede voorbeeld: false

max

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

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

Voorbeeld

Deze voorbeelden krijgen de hoogste waarde uit de set getallen en de matrix:

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

En dit resultaat retourneren: 3

min.

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

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

Voorbeeld

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

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

En dit resultaat retourneren: 1

Mod

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

mod(<dividend>, <divisor>)

Voorbeeld

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

mod(3, 2)

En dit resultaat retourneren: 1

Mul

Retourneert het product door twee getallen te vermenigvuldigen.

mul(<multiplicand1>, <multiplicand2>)

Voorbeeld

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

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

En deze resultaten retourneren:

• Eerste voorbeeld: 2
• Tweede voorbeeld 3

not

Controleer of een expressie onwaar is. Retourner true wanneer de expressie onwaar is, of retourner false wanneer true.

not(<expression>)

Voorbeeld 1

Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:

not(false)
not(true)

En deze resultaten retourneren:

• Eerste voorbeeld: De expressie is onwaar, dus de functie retourneert true .
• Tweede voorbeeld: De expressie is true, 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 deze resultaten retourneren:

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

of

Controleer of ten minste één expressie waar is. Retourneren waar wanneer ten minste één expressie waar is of onwaar retourneren wanneer beide onwaar zijn.

or(<expression1>, <expression2>)

Voorbeeld 1

Deze voorbeelden controleren of ten minste één expressie waar is:

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

En deze resultaten retourneren:

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

Voorbeeld 2

Deze voorbeelden controleren of ten minste één expressie waar is:

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

En deze resultaten retourneren:

• Eerste voorbeeld: Ten minste één expressie is true, 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, dat alleen aan het begin is inbegrepen.

rand(<minValue>, <maxValue>)

Voorbeeld

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

rand(1, 5)

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

Bereik

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

range(<startIndex>, <count>)

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]

vervangen

Vervang een subtekenreeks door de opgegeven tekenreeks en retourneert de resultaattekenreeks. Deze functie is casegevoelig.

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

Voorbeeld

In dit voorbeeld vindt u de 'oude' subtekenreeks in 'de oude tekenreeks' en vervangt u 'old' door 'new':

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

En retourneert dit resultaat: "the new string"

skip

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

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

Voorbeeld

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

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

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

split

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

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

Voorbeeld

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 het resultaat: ["a","b","c"]

startOfDay

Retourneerde het begin van de dag voor een tijdstempel.

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

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

Retourneerde het begin van het uur voor een tijdstempel.

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

Voorbeeld

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

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

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

startOfMonth

Retourneerde het begin van de maand voor een tijdstempel.

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

Voorbeeld

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

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

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

startsWith

Controleer of een tekenreeks begint met een specifieke subtekenreeks. Retourneert true wanneer de subtekenreeks wordt gevonden of retourneert false als deze niet is gevonden. Deze functie is niet casegevoelig.

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

Voorbeeld 1

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

startsWith('hello world', 'hello')

En retourneert dit resultaat: true

Voorbeeld 2

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

startsWith('hello world', 'greetings')

En retourneert dit resultaat: false

tekenreeks

Retourneert de tekenreeksversie voor een waarde.

string(<value>)

Voorbeeld 1

In dit voorbeeld wordt de tekenreeksversie voor dit nummer 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>)

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.

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

Voorbeeld

In dit voorbeeld wordt een subtekenreeks van vijf tekens gemaakt op basis van de opgegeven tekenreeks, beginnend bij de indexwaarde 6:

substring('hello world', 6, 5)

En retourneert dit resultaat: "world"

subtractFromTime

Een aantal tijdseenheden van een tijdstempel aftrekken. Zie ook getPastTime.

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

Voorbeeld 1

In dit voorbeeld wordt één dag afgetrokken van dit 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 dit tijdstempel:

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

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

take

Items retourneren vanaf het voorste deel van een verzameling.

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

Voorbeeld

In deze voorbeelden wordt het opgegeven aantal items aan de voorzijde van deze verzamelingen opgeslagen:

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

En deze resultaten retourneren:

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

Teken

ticksRetourneert de eigenschapswaarde voor een opgegeven tijdstempel. Een tick is een interval van 100 nanoseconden.

ticks('<timestamp>')

toLower

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

toLower('<text>')

Voorbeeld

In dit voorbeeld wordt deze tekenreeks ge converteert naar kleine letters:

toLower('Hello World')

En retourneert dit resultaat: "hello world"

Toupper

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

toUpper('<text>')

Voorbeeld

In dit voorbeeld wordt deze tekenreeks ge converteert naar hoofdletters:

toUpper('Hello World')

En retourneert dit resultaat: "HELLO WORLD"

Trim

Verwijder vooraan en achter elkaar witruimte uit een tekenreeks en retourneert de bijgewerkte tekenreeks.

trim('<text>')

Voorbeeld

In dit voorbeeld wordt de vooraanstaande en aaneen volgende witruimte verwijderd uit de tekenreeks " Hallo wereld ":

trim(' Hello World  ')

En retourneert dit resultaat: "Hello World"

Unie

Retourneert een verzameling die alle items uit de opgegeven verzamelingen bevat. Om in het resultaat te worden weergegeven, kan een item worden weergegeven in elke verzameling die aan deze functie wordt doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam in het resultaat weergegeven.

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

Voorbeeld

In dit voorbeeld worden alle items uit deze verzamelingen ophalen:

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

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

uriComponent

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

uriComponent('<value>')

Voorbeeld

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')

Voorbeeld

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

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

En retourneert dit resultaat:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retourneert de tekenreeksversie voor een met uniform resource identifier (URI) gecodeerde tekenreeks, en decodeert de met URI gecodeerde tekenreeks effectief.

uriComponentToString('<value>')

Voorbeeld

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

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

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

utcNow

Retourneerde de huidige tijdstempel.

utcNow('<format>')

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

Voorbeeld 1

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

utcNow()

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

Voorbeeld 2

Stel dat het vandaag 15 april 2018 is om 13:00:00 uur. In dit voorbeeld wordt de huidige tijdstempel met de optionele indeling 'D' gebruikt:

utcNow('D')

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

xml

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

xml('<value>')

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 deze 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 deze 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 retourneert de overeenkomende knooppunten of waarden. Met een XPath-expressie, of gewoon 'XPath', kunt u door een XML-documentstructuur navigeren, zodat u knooppunten of rekenwaarden in de XML-inhoud kunt selecteren.

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

Voorbeeld 1

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

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

En retourneert dit resultaat: 30

Voorbeeld 2

In dit voorbeeld zoeken beide expressies knooppunten die overeenkomen met het knooppunt, in de opgegeven argumenten, die XML met een <location></location> naamruimte bevatten. De expressies gebruiken het backslash-teken ( ) als \ een escape-teken 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>
  

• Een van de volgende XPath-expressies:

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

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

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

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

Voorbeeld 3

In voorbeeld 3 wordt in dit voorbeeld de waarde in het <location></location> knooppunt gevonden:

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

En retourneert dit resultaat: "Paris"

Volgende stappen

Zie Systeemvariabelen voor een lijst met systeemvariabelen die u in expressies kunt gebruiken.