Uttryck och funktioner i Azure Data Factory och Azure Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Den här artikeln innehåller information om uttryck och funktioner som stöds av Azure Data Factory och Azure Synapse Analytics.

Uttryck

JSON-värden i definitionen kan vara literaler eller uttryck som utvärderas vid körning. Exempel:

"name": "value"

eller

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

Uttryck kan visas var som helst i ett JSON-strängvärde och alltid resultera i ett annat JSON-värde. Om ett JSON-värde är ett uttryck extraheras uttryckets brödtext genom att at-sign tas bort ( @ ). Om en literalsträng behövs som börjar med @ måste den hoppas över med hjälp av @ @ . I följande exempel visas hur uttryck utvärderas.

Uttryck kan också visas inuti strängar med hjälp av en funktion som kallas stränginterpolation där uttryck är omslutna i @{ ... } . Exempelvis: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Med hjälp av stränginterpolation är resultatet alltid en sträng. Säg att jag har myNumber definierat som och som 42 myString foo :

I kontrollflödesaktiviteter som ForEach-aktivitet kan du ange en matris som ska itereras över för egenskapsobjekten och använda () för att iterera över en enskild uppräkning @item i ForEach-aktiviteten. Om objekt till exempel är en matris: [1, 2, 3], () returnerar 1 i den första iterationen, 2 i den andra iterationen och 3 i den tredje @item iterationen. Du kan också använda @range (0,10) liknande uttryck för att iterera tio gånger och börja med 0 som slutar med 9.

Du kan använda @activity (aktivitetsnamn) för att samla in utdata från aktiviteten och fatta beslut. Tänk dig en webbaktivitet som heter Web1. För att placera utdata för den första aktiviteten i brödtexten i den andra, ser uttrycket vanligtvis ut så här: @activity ('Web1').output eller ('Web1').output.data eller något liknande beroende på hur utdata från den första aktiviteten @activity ser ut.

Exempel

Exempel på komplexa uttryck

Exemplet nedan visar ett komplext exempel som refererar till ett djupt underfält med aktivitetsutdata. Om du vill referera till en pipelineparameter som utvärderas till ett underfält använder du [] syntax i stället för punkt(.)-operatorn (som i fallet med subfield1 och subfield2) som en del av en aktivitetsutdata.

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

Det är vanligt att skapa filer dynamiskt och namnge dem. Låt oss utforska några exempel på dynamisk namngivning av filer.

1. Lägg till datum i ett filnamn: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

2. Lägg till DateTime i kundens tidszon: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

3. Tid för tilläggsutlösare: @concat('Test_', pipeline().TriggerTime)

4. Mata ut ett anpassat filnamn i en mappningsdatafil Flow utdata till en enskild fil med datum :'Test_' + toString(currentDate()) + '.csv'

I ovanstående fall skapas 4 dynamiska filnamn från och med Test_.

Dynamisk innehållsredigerare

Dynamisk innehållsredigerare undviker automatiskt tecken i ditt innehåll när du är klar med redigeringen. Följande innehåll i innehållsredigeraren är till exempel en stränginterpolation med två uttrycksfunktioner.

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

Den dynamiska innehållsredigeraren konverterar ovanstående innehåll till uttrycket "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}" . Resultatet av det här uttrycket är en JSON-formatsträng som visas nedan.

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

En datauppsättning med en parameter

I följande exempel tar BlobDataset en parameter med namnet path. Värdet används för att ange ett värde för egenskapen folderPath med hjälp av uttrycket: dataset().path .

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

En pipeline med en parameter

I följande exempel tar pipelinen parametrarna inputPath och outputPath. Sökvägen till den parametriserade blobdatauppsättningen anges med hjälp av värdena för dessa parametrar. Syntaxen som används här är: 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"
            }
        }
    }
}

Ersätta specialtecken

Dynamisk innehållsredigerare undviker automatiskt tecken som dubbla citattecken, omstreck i innehållet när du är klar med redigeringen. Detta orsakar problem om du vill ersätta radflöde eller flik med hjälp \n, \t i replace() funktion. Du kan redigera dynamiskt innehåll i kodvyn för att ta bort extra \ i uttrycket, eller så kan du följa stegen nedan för att ersätta specialtecken med uttrycksspråk:

1. URL-kodning mot det ursprungliga strängvärdet
2. Ersätt URL-kodad sträng, till exempel radmatning (%0A), vagnretur(%0D), vågrät flik(%09).
3. URL-avkodning

Variabeln companyName med ett tecken för nyrad i värdet kan till exempel ta @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) bort tecknet för nyrad.

Contoso-
Corporation

Undantag för enkelt citattecken

Uttrycksfunktioner använder enkelt citattecken för strängvärdesparametrar. Använd två enkla citattecken för att undvika ett -tecken i strängfunktioner. Till exempel returnerar @concat('Baba', '''s ', 'book store') uttrycket nedanstående resultat.

Baba's book store

Självstudie

Den här självstudien visar hur du skickar parametrar mellan en pipeline och aktivitet samt mellan aktiviteterna. Självstudien visar specifikt stegen för en Azure Data Factory även om stegen för en Synapse-arbetsyta är nästan likvärdiga men med ett något annorlunda användargränssnitt.

Functions

Du kan anropa funktioner i uttryck. Följande avsnitt innehåller information om de funktioner som kan användas i ett uttryck.

Datumfunktioner

Strängfunktioner

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

Samlingsfunktioner

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

Logiska funktioner

Dessa funktioner är användbara i villkor, de kan användas för att utvärdera alla typer av logik.

Konverteringsfunktioner

Dessa funktioner används för att konvertera mellan var och en av de interna typerna på språket:

• sträng
• heltal
• flyt
• boolean
• Matriser
• Ordböcker

Matematiska funktioner

Dessa funktioner kan användas för endera typer av tal: heltal och flyttal.

Funktionsreferens

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

add

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

add(<summand_1>, <summand_2>)

Exempel

I det här exemplet läggs de angivna talen till:

add(1, 1.5)

Och returnerar det här resultatet: 2.5

addDays

Lägg till ett antal dagar i en tidsstämpel.

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

Exempel 1

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

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

Och returnerar det här resultatet: "2018-03-25T00:00:0000000Z"

Exempel 2

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

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

Och returnerar det här resultatet: "2018-03-10T00:00:0000000Z"

addHours

Lägg till ett antal timmar till en tidsstämpel.

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

Exempel 1

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

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

Och returnerar det här resultatet: "2018-03-15T10:00:0000000Z"

Exempel 2

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

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

Och returnerar det här resultatet: "2018-03-15T10:00:0000000Z"

addMinutes

Lägg till ett antal minuter till en tidsstämpel.

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

Exempel 1

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

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

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

Exempel 2

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

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

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

addSeconds

Lägg till ett antal sekunder till en tidsstämpel.

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

Exempel 1

I det här exemplet läggs 10 sekunder till i den angivna tidsstämpeln:

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

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

Exempel 2

Det här exemplet subtraherar fem sekunder till den angivna tidsstämpeln:

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

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

addToTime

Lägg till ett antal tidsenheter i en tidsstämpel. Se även getFutureTime().

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

Exempel 1

I det här exemplet läggs en dag till i den angivna tidsstämpeln:

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

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

Exempel 2

I det här exemplet läggs en dag till i den angivna tidsstämpeln:

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

Och returnerar resultatet med det valfria "D"-formatet: "Tuesday, January 2, 2018"

och

Kontrollera om båda uttrycken är sanna. Returnera true när båda uttrycken är sanna eller returnera false när minst ett uttryck är falskt.

and(<expression1>, <expression2>)

Exempel 1

De här exemplen kontrollerar om båda de angivna booleska värdena är sanna:

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

Och returnerar följande resultat:

• Första exemplet: Båda uttrycken är sanna, så returnerar true .
• Andra exemplet: Ett uttryck är falskt, så returnerar false .
• Tredje exemplet: Båda uttrycken är false, så returnerar false .

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken båda är sanna:

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

Och returnerar följande resultat:

• Första exemplet: Båda uttrycken är sanna, så returnerar true .
• Andra exemplet: Ett uttryck är falskt, så returnerar false .
• Tredje exemplet: Båda uttrycken är false, så returnerar false .

matris

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

array('<value>')

Exempel

I det här exemplet skapas en matris från strängen "hello":

array('hello')

Och returnerar det här resultatet: ["hello"]

base64

Returnera den base64-kodade versionen för en sträng.

base64('<value>')

Exempel

I det här exemplet konverteras "hello"-strängen till en base64-kodad sträng:

base64('hello')

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

base64ToBinary

Returnera den binära versionen för en base64-kodad sträng.

base64ToBinary('<value>')

Exempel

I det här exemplet konverteras den base64-kodade strängen "aGVsbG8=" till en binär sträng:

base64ToBinary('aGVsbG8=')

Och returnerar det här resultatet:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Returnera strängversionen för en base64-kodad sträng som effektivt avkodar base64-strängen. Använd den här funktionen i stället för att avkodaBase64(). Även om båda funktionerna fungerar på samma sätt är base64ToString() det bättre.

base64ToString('<value>')

Exempel

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

base64ToString('aGVsbG8=')

Och returnerar det här resultatet: "hello"

binary

Returnera den binära versionen för en sträng.

binary('<value>')

Exempel

I det här exemplet konverteras "hello"-strängen till en binär sträng:

binary('hello')

Och returnerar det här resultatet:

"0110100001100101011011000110110001101111"

boolesk

Returnera den booleska versionen för ett värde.

bool(<value>)

Exempel

De här exemplen konverterar de angivna värdena till booleska värden:

bool(1)
bool(0)

Och returnerar följande resultat:

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

coalesce

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

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

Exempel

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

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

Och returnerar följande resultat:

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

Concat

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

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

Exempel

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

concat('Hello', 'World')

Och returnerar det här resultatet: "HelloWorld"

innehåller

Kontrollera om en samling har ett visst objekt. Returnera true när objektet hittas eller returnera false när det inte hittas. Den här funktionen är fallkänslig.

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

Mer specifikt fungerar den här funktionen på dessa samlingstyper:

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

Exempel 1

Det här exemplet kontrollerar strängen "hello world" för delsträngen "world" och returnerar true:

contains('hello world', 'world')

Exempel 2

Det här exemplet kontrollerar strängen "hello world" för delsträngen "universe" och returnerar false:

contains('hello world', 'universe')

convertFromUtc

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

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

Exempel 1

I det här exemplet konverteras en tidsstämpel till den angivna tidszonen:

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

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

Exempel 2

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

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

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

convertTimeZone

Konvertera en tidsstämpel från källtidszonen till måltidszonen.

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

Exempel 1

Det här exemplet konverterar källtidszonen till måltidszonen:

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

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

Exempel 2

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

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

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

convertToUtc

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

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

Exempel 1

I det här exemplet konverteras en tidsstämpel till UTC:

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

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

Exempel 2

I det här exemplet konverteras en tidsstämpel till UTC:

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

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

createArray

Returnera en matris från flera indata. För enskilda indatamatriser, se array().

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

Exempel

Det här exemplet skapar en matris från dessa indata:

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

Och returnerar det här resultatet: ["h", "e", "l", "l", "o"]

dataUri

Returnera en data-URI (Uniform Resource Identifier) för en sträng.

dataUri('<value>')

Exempel

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

dataUri('hello')

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

dataUriToBinary

Returnera den binära versionen för en URI (Data Uniform Resource Identifier). Använd den här funktionen i stället för decodeDataUri(). Även om båda funktionerna fungerar på samma sätt är dataUriBinary() det bättre.

dataUriToBinary('<value>')

Exempel

I det här exemplet skapas en binär version för den här data-URI:en:

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

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')

Exempel

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

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

Och returnerar det här resultatet: "hello"

dayOfMonth

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

dayOfMonth('<timestamp>')

Exempel

Det här exemplet returnerar talet för dagen i månaden från den här tidsstämpeln:

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

Och returnerar det här resultatet: 15

dayOfWeek

Returnera veckodagen från en tidsstämpel.

dayOfWeek('<timestamp>')

Exempel

Det här exemplet returnerar talet för veckodagen från den här tidsstämpeln:

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

Och returnerar det här resultatet: 3

dayOfYear

Returnera dagen på året från en tidsstämpel.

dayOfYear('<timestamp>')

Exempel

I det här exemplet returneras antalet dagar på året från den här tidsstämpeln:

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

Och returnerar det här resultatet: 74

decodeBase64

Returnera strängversionen för en base64-kodad sträng, vilket effektivt avkodar base64-strängen. Överväg att använda base64ToString() i stället för decodeBase64() . Även om båda funktionerna fungerar på samma sätt är base64ToString() det bättre.

decodeBase64('<value>')

Exempel

I det här exemplet skapas en sträng för en base64-kodad sträng:

decodeBase64('aGVsbG8=')

Och returnerar det här resultatet: "hello"

decodeDataUri

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

decodeDataUri('<value>')

Exempel

I det här exemplet returneras den binära versionen för den här data-URI:en:

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

Och returnerar det här resultatet:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')

Exempel

Det här exemplet ersätter escape-tecknen i den här strängen med avkodade versioner:

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

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

div

Returnera heltalsresultatet från division av två tal. För att få resten av resultatet, se mod().

div(<dividend>, <divisor>)

Exempel

Båda exemplen delar det första talet med det andra talet:

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

Och returnerar det här resultatet: 2

encodeUriComponent

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

encodeUriComponent('<value>')

Exempel

I det här exemplet skapas en URI-kodad version för den här strängen:

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

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

tomt

Kontrollera om en samling är tom. Returnera true när samlingen är tom eller returnera false när den inte är tom.

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

Exempel

De här exemplen kontrollerar om de angivna samlingarna är tomma:

empty('')
empty('abc')

Och returnerar följande resultat:

• Första exemplet: Skickar en tom sträng, så funktionen returnerar true .
• Andra exemplet: Skickar strängen "abc", så funktionen returnerar false .

endsWith

Kontrollera om en sträng slutar med en specifik delsträng. Returnera true när delsträngen hittas, eller returnera false när det inte går att hitta. Den här funktionen är inte fallkänslig.

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

Exempel 1

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

endsWith('hello world', 'world')

Och returnerar det här resultatet: true

Exempel 2

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

endsWith('hello world', 'universe')

Och returnerar det här resultatet: false

lika med

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

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

Exempel

De här exemplen kontrollerar om de angivna indata är likvärdiga.

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

Och returnerar följande resultat:

• Första exemplet: Båda värdena är likvärdiga, så funktionen returnerar true .
• Andra exemplet: Båda värdena är inte likvärdiga, så funktionen returnerar false .

Första

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

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

Exempel

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

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

Och returnerar följande resultat:

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

flyt

Konvertera en strängversion för ett flyttalsnummer till ett faktiskt flyttalsnummer.

float('<value>')

Exempel

I det här exemplet skapas en strängversion för det här flyttalsnumret:

float('10.333')

Och returnerar det här resultatet: 10.333

formatDateTime

Returnera en tidsstämpel i det angivna formatet.

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

Exempel

I det här exemplet konverteras en tidsstämpel till det angivna formatet:

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

Och returnerar det här resultatet: "2018-03-15T12:00:00"

getFutureTime

Returnera den aktuella tidsstämpeln plus de angivna tidsenheterna.

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

Exempel 1

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

getFutureTime(5, 'Day')

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

Exempel 2

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

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

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

getPastTime

Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna.

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

Exempel 1

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

getPastTime(5, 'Day')

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

Exempel 2

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

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

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

större än

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

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

Exempel

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

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

Och returnerar följande resultat:

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

större än eller lika med

Kontrollera om det första värdet är större än eller lika med det andra värdet. Returnera true när det första värdet är större eller lika med, eller returnera false när det första värdet är mindre.

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

Exempel

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

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

Och returnerar följande resultat:

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

guid

Generera en globalt unik identifierare (GUID) som en sträng, till exempel "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Du kan också ange ett annat format för GUID än standardformatet " D", som är 32 siffror avgränsade med bindestreck.

guid('<format>')

Exempel

Det här exemplet genererar samma GUID, men som 32 siffror, avgränsade med bindestreck och inom parentes:

guid('P')

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

om

Kontrollera om ett uttryck är sant eller falskt. Returnera ett angivet värde baserat på resultatet.

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

Exempel

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

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

indexOf

Returnera startpositionen eller indexvärdet för en delsträng. Den här funktionen är inte fallkänslig och index börjar med talet 0.

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

Exempel

Det här exemplet hittar startindexvärdet för delsträngen "world" i strängen "hello world":

indexOf('hello world', 'world')

Och returnerar det här resultatet: 6

int

Returnera heltalsversionen för en sträng.

int('<value>')

Exempel

I det här exemplet skapas en heltalsversion för strängen "10":

int('10')

Och returnerar det här resultatet: 10

json

Returnera värdet JavaScript Object Notation JSON-typ (JSON) för en sträng eller XML.

json('<value>')

Exempel 1

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

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

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

Exempel 2

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

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

Och returnerar det här resultatet:

{
  "fullName": "Sophia Owen"
}

Exempel 3

I det här exemplet konverteras xml-filen till JSON:

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

Och returnerar det här resultatet:

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

Korsningen

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

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

Exempel

Det här exemplet hittar vanliga objekt i dessa matriser:

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

Och returnerar en matris med endast dessa objekt: [1, 2]

join

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

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

Exempel

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

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

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

Senaste

Returnera det sista objektet från en samling.

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

Exempel

De här exemplen hittar det sista objektet i dessa samlingar:

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

Och returnerar följande resultat:

• Första exemplet: "d"
• Andra exemplet: 3

lastIndexOf

Returnera startpositionen eller indexvärdet för den sista förekomsten av en delsträng. Den här funktionen är inte fallkänslig och index börjar med talet 0.

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

Exempel

Det här exemplet hittar startindexvärdet för den sista förekomsten av "world"-delsträngen i "hello world"-strängen:

lastIndexOf('hello world', 'world')

Och returnerar det här resultatet: 6

length

Returnera antalet objekt i en samling.

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

Exempel

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

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

Och returnerar det här resultatet: 4

mindre än

Kontrollera om det första värdet är mindre än det andra värdet. Returnera true när det första värdet är mindre, eller returnera false när det första värdet är mer.

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

Exempel

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

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

Och returnerar följande resultat:

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

mindre än eller lika med

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

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

Exempel

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

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

Och returnerar följande resultat:

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

max

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

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

Exempel

De här exemplen hämtar det högsta värdet från uppsättningen tal och matrisen:

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

Och returnerar det här resultatet: 3

min

Returnera det lägsta värdet från en uppsättning tal eller en matris.

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

Exempel

De här exemplen får det lägsta värdet i uppsättningen tal och matrisen:

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

Och returnerar det här resultatet: 1

Mod

Returnera resten från divisionen av två tal. Information om hur du hämtar heltalsresultatet finns i div().

mod(<dividend>, <divisor>)

Exempel

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

mod(3, 2)

Och returnerar det här resultatet: 1

multi

Returnera produkten från att multiplicera två tal.

mul(<multiplicand1>, <multiplicand2>)

Exempel

De här exemplen är flera av de första talen med det andra talet:

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

Och returnerar följande resultat:

• Första exemplet: 2
• Andra exemplet 3

inte

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

not(<expression>)

Exempel 1

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

not(false)
not(true)

Och returnerar följande resultat:

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

Exempel 2

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

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

Och returnerar följande resultat:

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

eller

Kontrollera om minst ett uttryck är sant. Returnera true när minst ett uttryck är sant eller returnera false när båda är false.

or(<expression1>, <expression2>)

Exempel 1

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

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

Och returnerar följande resultat:

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

Exempel 2

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

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

Och returnerar följande resultat:

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

Rand

Returnera ett slumpmässigt heltal från ett angivet intervall, som endast är inkluderande i början.

rand(<minValue>, <maxValue>)

Exempel

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

rand(1, 5)

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

Utbud

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

range(<startIndex>, <count>)

Exempel

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

range(1, 4)

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

Ersätta

Ersätt en delsträng med den angivna strängen och returnera resultatsträngen. Den här funktionen är fallkänslig.

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

Exempel

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

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

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

hoppa över

Ta bort objekt framför en samling och returnera alla andra objekt.

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

Exempel

Det här exemplet tar bort ett objekt, talet 0, framför den angivna matrisen:

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

Och returnerar den här matrisen med återstående objekt: [1,2,3]

split

Returnera en matris som innehåller delsträngar, avgränsade med kommatecken, baserat på det angivna avgränsartecknet i den ursprungliga strängen.

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

Exempel

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

split('a_b_c', '_')

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

startOfDay

Returnera dagens början för en tidsstämpel.

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

Exempel

Det här exemplet hittar dagens start för den här tidsstämpeln:

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

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

startOfHour

Returnerar timmens start för en tidsstämpel.

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

Exempel

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

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

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

startOfMonth

Returnera början av månaden för en tidsstämpel.

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

Exempel

I det här exemplet returneras månadens start för den här tidsstämpeln:

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

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

startsWith

Kontrollera om en sträng börjar med en specifik delsträng. Returnera true när delsträngen hittas, eller returnera false när det inte går att hitta. Den här funktionen är inte fallkänslig.

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

Exempel 1

Det här exemplet kontrollerar om "hello world"-strängen börjar med delsträngen "hello":

startsWith('hello world', 'hello')

Och returnerar det här resultatet: true

Exempel 2

Det här exemplet kontrollerar om strängen "hello world" börjar med delsträngen "greetings":

startsWith('hello world', 'greetings')

Och returnerar det här resultatet: false

sträng

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

string(<value>)

Exempel 1

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

string(10)

Och returnerar det här resultatet: "10"

Exempel 2

I det här exemplet skapas en sträng för det angivna JSON-objektet och omsnedstreckstecknet ( ) används som ett \ escape-tecken för det dubbla citattecknet (").

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

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

Sub

Returnera resultatet från subtraktion av det andra talet från det första talet.

sub(<minuend>, <subtrahend>)

Exempel

Det här exemplet subtraherar det andra talet från det första talet:

sub(10.3, .3)

Och returnerar det här resultatet: 10

Delsträng

Returnera tecken från en sträng, med början från den angivna positionen eller indexet. Indexvärden börjar med talet 0.

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

Exempel

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

substring('hello world', 6, 5)

Och returnerar det här resultatet: "world"

subtractFromTime

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

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

Exempel 1

I det här exemplet subtraherar vi en dag från den här tidsstämpeln:

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

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

Exempel 2

I det här exemplet subtraherar vi en dag från den här tidsstämpeln:

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

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

take

Returnera objekt från en samlings framsida.

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

Exempel

De här exemplen hämtar det angivna antalet objekt framför dessa samlingar:

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

Och returnerar följande resultat:

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

Fästingar

Returnera ticks egenskapsvärdet för en angiven tidsstämpel. Ett tick är ett intervall på 100 nanosekunder.

ticks('<timestamp>')

toLower

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

toLower('<text>')

Exempel

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

toLower('Hello World')

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

toUpper

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

toUpper('<text>')

Exempel

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

toUpper('Hello World')

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

Trimma

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

trim('<text>')

Exempel

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

trim(' Hello World  ')

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

Unionen

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

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

Exempel

Det här exemplet hämtar alla objekt från dessa samlingar:

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

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

uriComponent

Returnera en URI-kodad version (Uniform Resource Identifier) för en sträng genom att ersätta URL-osäkra tecken med escape-tecken. Använd den här funktionen i stället för encodeUriComponent(). Även om båda funktionerna fungerar på samma sätt är uriComponent() det bättre.

uriComponent('<value>')

Exempel

I det här exemplet skapas en URI-kodad version för den här strängen:

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

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

uriComponentToBinary

Returnera den binära versionen för en URI-komponent (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Exempel

I det här exemplet skapas den binära versionen för den här URI-kodade strängen:

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

Och returnerar det här resultatet:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Returnera strängversionen för en URI-kodad sträng (Uniform Resource Identifier), vilket effektivt avkodar den URI-kodade strängen.

uriComponentToString('<value>')

Exempel

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

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

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

utcNow

Returnera den aktuella tidsstämpeln.

utcNow('<format>')

Du kan också ange ett annat format med <som> parameter.

Exempel 1

Anta att idag är den 15 april 2018 kl. 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln:

utcNow()

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

Exempel 2

Anta att idag är den 15 april 2018 kl. 13:00:00. I det här exemplet hämtar vi den aktuella tidsstämpeln med det valfria D-formatet:

utcNow('D')

Och returnerar det här resultatet: "Sunday, April 15, 2018"

xml

Returnera XML-versionen för en sträng som innehåller ett JSON-objekt.

xml('<value>')

Exempel 1

Det här exemplet skapar XML-versionen för den här strängen, som innehåller ett JSON-objekt:

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

Och returnerar den här resultat-XML:en:

<name>Sophia Owen</name>

Exempel 2

Anta att du har det här JSON-objektet:

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

I det här exemplet skapas XML för en sträng som innehåller det här JSON-objektet:

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

Och returnerar den här resultat-XML:en:

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

Xpath

Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden. Ett XPath-uttryck, eller bara "XPath", hjälper dig att navigera i en XML-dokumentstruktur så att du kan välja noder eller beräkningsvärden i XML-innehållet.

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

Exempel 1

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

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

Och returnerar det här resultatet: 30

Exempel 2

I det här exemplet hittar båda uttrycken noder som matchar <location></location> noden i de angivna argumenten, som innehåller XML med ett namnområde. Uttrycken använder omsnedstreck ( \ ) som ett escape-tecken för det dubbla citattecknet (").

• Uttryck 1

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

• Uttryck 2

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

Här är argumenten:

• Den här XML-filen, som innehåller XML-dokumentets namnområde, xmlns="http://contoso.com" :

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

• Antingen XPath-uttryck här:

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

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

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

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

Exempel 3

I exempel 3 hittar det här exemplet värdet i <location></location> noden:

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

Och returnerar det här resultatet: "Paris"

Nästa steg

En lista över systemvariabler som du kan använda i uttryck finns i Systemvariabler.