Kifejezések és függvények az Azure Data Factoryben és az Azure Synapse Analyticsben

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk részletesen ismerteti az Azure Data Factory és az Azure Synapse Analytics által támogatott kifejezéseket és függvényeket.

Kifejezések

A definíció JSON-értékei lehetnek konstansok vagy futásidőben kiértékelt kifejezések. Példa:

"name": "value"

vagy

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

A kifejezések bárhol megjelenhetnek egy JSON-sztringértékben, és mindig egy másik JSON-értéket eredményeznek. Ha egy JSON-érték kifejezés, a rendszer az at-sign (@) eltávolításával nyeri ki a kifejezés törzsét. Ha @-val kezdődő literális sztringre van szükség, akkor a @@használatával kell megszabadulnia. Az alábbi példák a kifejezések kiértékelésének módját mutatják be.

JSON-érték	Eredmény
"paraméterek"	A rendszer visszaadja a "paraméterek" karaktereit.
"paraméterek[1]"	A rendszer a "parameters[1]" karaktereket adja vissza.
"@@"	A függvény egy 1 karakteres sztringet ad vissza, amely "@" karaktert tartalmaz.
" @"	A függvény egy 2 karakteres sztringet ad vissza, amely a "@" karaktert tartalmazza.

A kifejezések megjelenhetnek sztringeken belül is, egy "sztring interpoláció" nevű funkció segítségével, ahol a kifejezések @{ ... } jelek közé vannak ágyazva. Például: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Sztring interpolációval az eredmény mindig szöveg. Tegyük fel, hogy a myNumber-t definiáltam 42-ként, és a myString-t foo-ként:

JSON-érték	Eredmény
"@pipeline().parameters.myString"	Sztringként ad foo vissza.
"@{pipeline().parameters.myString}"	Sztringként ad foo vissza.
"@pipeline().parameters.myNumber"	A 42 egy számként adja vissza.
"@{pipeline().parameters.myNumber}"	42 visszaadja sztringként.
"Válasz: @{pipeline().parameters.myNumber}"	A sztringet Answer is: 42adja vissza.
@concat('Válasz: ', string(pipeline().parameters.myNumber))	Visszaadja a karakterláncot Answer is: 42
"Válasz: @@{pipeline().parameters.myNumber}"	Visszaadja a szöveget Answer is: @{pipeline().parameters.myNumber}.

Az olyan vezérlőfolyamat-tevékenységekben, mint a ForEach-tevékenység, megadhat egy tömböt, amelyen végig iterálnak a tulajdonságelemek számára, és a ForEach-tevékenység egyetlen enumerálásán a @item() segítségével iterálhat. Ha például az elemek tömbök: [1, 2, 3], az első iterációban 1, @item() a második iterációban 2, a harmadik iterációban pedig 3 értéket ad vissza. Használhatja a @range(0,10) kifejezést is arra, hogy tízszer iteráljon, 0-val kezdve és 9-cel végződve.

A "tevékenység neve" használatával @activity(rögzítheti a tevékenység kimenetét, és döntéseket hozhat. Fontolja meg a Web1 nevű webes tevékenységet. Az első tevékenység kimenetének a második törzsben való elhelyezéséhez a kifejezés általában a következőképpen néz ki: @activity('Web1').output vagy @activity('Web1').output.data vagy valami hasonló attól függően, hogy az első tevékenység kimenete hogyan néz ki.

Példák

Összetett kifejezési példa

Az alábbi példa egy összetett példát mutat be, amely a tevékenység kimenetének egy mély almezőjére hivatkozik. Ha egy almezőre kiértékelt folyamatparaméterre szeretne hivatkozni, használja a [] szintaxist pont(.) operátor helyett (mint az almező1 és az almező2 esetében), egy tevékenységkimenet részeként.

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

A fájlok dinamikus létrehozása és elnevezése gyakori minta. Tekintsünk át néhány dinamikus fájlelnevezési példát.

1. Dátum hozzáfűzése fájlnévhez: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

2. Dátum/idő hozzáfűzése az ügyfél időzónájában: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

3. Hozzáfűzési eseményindító ideje: @concat('Test_', pipeline().TriggerTime)

4. Egyéni fájlnevet ad ki egy leképezési Adatfolyam, amikor egyetlen fájlra ad ki dátumot:'Test_' + toString(currentDate()) + '.csv'

A fenti esetekben 4 dinamikus fájlnév jön létre a Test_ kezdve.

Dinamikus tartalomszerkesztő

A dinamikus tartalomszerkesztő automatikusan kikerüli a tartalom karaktereit a szerkesztés befejezésekor. A tartalomszerkesztőben például a következő tartalom egy string interpolációja két kifejezésfüggvénnyel.

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

A dinamikus tartalomszerkesztő a fenti tartalmat kifejezéssé "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}"alakítja. Ennek a kifejezésnek az eredménye egy alább bemutatott JSON formátumú sztring.

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

Paraméterrel rendelkező adatkészlet

Az alábbi példában a BlobDataset egy elérési út nevű paramétert vesz fel. Az érték a folderPath tulajdonság értékének beállítására szolgál a következő kifejezéssel: dataset().path.

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

Egy adatfolyam egy paraméterrel

A következő példában a folyamat inputPath- és outputPath-paramétereket vesz fel. A paraméteres blobadatkészlet elérési útja ezen paraméterek értékeinek használatával van beállítva. Az itt használt szintaxis a következő: 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"
            }
        }
    }
}

Speciális karakterek cseréje

A dinamikus tartalomszerkesztő automatikusan eltávolítja a karaktereket, például a dupla idézőjelet, a fordított perjelet a tartalomban a szerkesztés befejezésekor. Ez problémát okoz, ha az újsort vagy a tabulátort a \n, \t karakterekkel szeretné lecserélni a replace() függvény használatával. A dinamikus tartalmat kódnézetben szerkesztheti, hogy eltávolítsa az extra \ karaktert a kifejezésből, vagy az alábbi lépéseket követve lecserélheti a speciális karaktereket a kifejezés nyelvével:

1. URL-kódolás az eredeti szövegérték ellen
2. Cserélje le az URL-kódolt sztringet, például a vonalcsatornát (%0A), a kocsi visszatérését (%0D), a vízszintes lapot (%09).
3. URL-dekódolás

Például a változó companyName tulajdonsága, amelynek értéke egy újsoros karakter, a kifejezés @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) eltávolíthatja az újsoros karaktert.

Contoso-
Corporation

Egyetlen idézőjel karakter 'escape'-elése

A kifejezésfüggvények az egyszeres idézőjelet (') használják a sztringérték paramétereinek körülvételekor. Sztringkifejezésekben két egymást követő egy idézőjel karaktert használjon egyetlen idézőjel hozzáadásához. Íme egy példa: a kifejezés @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') a következő eredményt adja vissza:

Here is a double quote character: ". And here is a single quote character all within the same string: '.

Az adatfolyam-kifejezésekben azonban ez a szintaxis nem támogatott. Ehelyett az adatfolyam-kifejezéseket egyetlen vagy dupla idézőjelek is körülvehetik. A sztringfüggvényeken belül a szöveget, amely egyetlen idézőjelet igényel, foglaljuk dupla idézőjelek közé, és a szöveget, amely dupla idézőjelet igényel, foglaljuk egyetlen idézőjelek közé. Ha olyan sztringre van szüksége, amely mind egyes, mind kettős idézőjeleket tartalmaz, két részsztringet egyesíthet concat(), amelyek külön-külön tartalmaznak egyes vagy kettős idézőjeleket. Az előző folyamatkifejezési példa adatfolyam-megfelelője a következő lenne concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."): . Egy adatfolyamban ez a kifejezés ugyanazt az eredményt adja vissza, mint a folyamatkifejezések előző példáját.

Tutorial

Ez az oktatóanyag bemutatja, hogyan adhat át paramétereket egy folyamat és tevékenység, valamint a tevékenységek között. Az oktatóanyag kifejezetten az Azure Data Factory lépéseit mutatja be, bár a Synapse-munkaterület lépései szinte egyenértékűek, de kissé eltérő felhasználói felülettel.

Függvények

Függvényeket a kifejezéseken belül is meghívhat. A következő szakaszok a kifejezésekben használható függvényekről nyújtanak információkat.

Dátumfüggvények

Dátum- vagy időfüggvény	Feladat
addDays	Adjon hozzá néhány napot egy időbélyeghez.
addHours	Adjon hozzá több órát egy időbélyeghez.
addMinutes	Adjon hozzá néhány percet egy időbélyeghez.
addSeconds	Adjon hozzá néhány másodpercet egy időbélyeghez.
addToTime	Adjon hozzá több időegységet egy időbélyeghez. Lásd még : getFutureTime.
convertFromUtc	Konvertáljon egy időbélyeget az univerzális koordinált idő (UTC) szerinti időzónából a cél időzónába.
convertTimeZone	Időbélyeg konvertálása a forrás időzónából a cél időzónává.
convertToUtc	Időbélyeg konvertálása a forrás időzónából univerzális idő koordinált (UTC) időzónává.
dayOfMonth	Adja vissza az időbélyeg hónapnapi komponensét.
dayOfWeek	A hét napját adja vissza egy időbélyegből.
dayOfYear	Az év napját adja vissza egy időbélyegből.
formatDateTime	Az időbélyeget sztringként adja vissza opcionális formátumban.
getFutureTime	Adja vissza az aktuális időbélyeget és a megadott időegységeket. Lásd még : addToTime.
getPastTime	Az aktuális időbélyeget adja vissza a megadott időegységekkel együtt. Lásd még : subtractFromTime.
startOfDay	Az időbélyeg napjának kezdetét adja vissza.
startOfHour	Az óra kezdetét adja vissza egy időbélyeghez.
startOfMonth	Adja meg a hónap kezdetét egy adott időbélyeghez tartozóan.
subtractFromTime	Vonjon ki több időegységet egy időbélyegből. Lásd még : getPastTime.
Kullancsok	ticks Adott időbélyeg tulajdonságértékének visszaadása.
utcNow	Az aktuális időbélyeg visszaadása karakterláncként.

Sztringfüggvények

A sztringek használatához használhatja ezeket a sztringfüggvényeket és néhány gyűjteményfüggvényt is. A sztringfüggvények csak sztringeken működnek.

Sztringfüggvény	Feladat
összefűzés	Két vagy több karakterlánc egyesítése és az egyesített karakterlánc visszaadása.
végződik-e	Ellenőrizze, hogy egy sztring a megadott részsztringgel végződik-e.
GUID	Hozzon létre egy globális egyedi azonosítót (GUID) karakterláncként.
indexOf	Egy részszúrás kezdőpozíciójának visszaadása.
lastIndexOf	Adja meg az utolsó alsztring előfordulás kezdőpozícióját.
helyettesít	Cserélje le az alsztringet a megadott sztringre, és adja vissza a frissített sztringet.
hasít	Ossza fel a sztringet egy megadott elválasztó minden előfordulásánál, és adja vissza az eredményül kapott részsztringeket egy tömb elemeiként.
startsWith	Ellenőrizze, hogy egy sztring egy adott részsztringgel kezdődik-e.
Substring	Karaktereket ad vissza egy sztringből, a megadott pozíciótól kezdve.
toLower	Adjon vissza egy kisbetűs karakterláncot.
toUpper	Karakterláncot ad vissza nagybetűs formátumban.
igazítás	Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

Gyűjteményfüggvények

Gyűjtemények, általában tömbök, sztringek és néha szótárak használatához használhatja ezeket a gyűjteményfüggvényeket.

Gyűjteményfüggvény	Feladat
Tartalmaz	Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet.
üres	Ellenőrizze, hogy egy gyűjtemény üres-e.
első	Egy gyűjtemény első elemének visszaadása.
útkereszteződés	Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit tartalmazza.
csatlakozás	Olyan sztringet ad vissza, amely egy tömb összes elemét tartalmazza, a megadott karakterrel elválasztva.
utolsó	Egy gyűjtemény utolsó elemének visszaadása.
length (hossz)	Egy sztring vagy tömb elemeinek számát adja vissza.
Kihagyás	Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.
vesz	Visszaad elemeket egy gyűjtemény elejéről.
unió	Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények összes elemét tartalmazza.

Logikai függvények

Ezek a függvények a feltételeken belül hasznosak, bármilyen típusú logika kiértékelésére használhatók.

Logikai összehasonlító függvény	Feladat
és	Ellenőrizze, hogy az összes kifejezés igaz-e.
Egyenlő	Ellenőrizze, hogy mindkét érték egyenértékű-e.
Nagyobb	Ellenőrizze, hogy az első érték nagyobb-e a másodiknál.
nagyobb vagy egyenlő	Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték.
ha	Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.
kevesebb	Ellenőrizze, hogy az első érték kisebb-e a másodiknál.
kisebb vagy egyenlő	Ellenőrizze, hogy az első érték kisebb-e, mint a második érték.
nem	Ellenőrizze, hogy egy kifejezés hamis-e.
vagy	Ellenőrizze, hogy legalább egy kifejezés igaz-e.

Konverziós függvények

Ezek a függvények a nyelv natív típusai közötti konvertálásra szolgálnak:

• karakterlánc
• egész szám
• lebeg
• Logikai
• Tömbök
• Szótárak

Konvertálási függvény	Feladat
tömb	Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd: createArray.
base64	Visszaadja egy karakterlánc base64-kódolású verzióját.
base64ToBinary	Egy base64 kódolású sztring bináris verzióját adja vissza.
base64ToString	A base64 kódolású karakterlánc szöveges változatát adja vissza.
bináris	Adja vissza egy bemeneti érték bináris verzióját.
Bool	Adja vissza egy bemeneti érték logikai verzióját.
összenő	Az első nem null értéket adja vissza egy vagy több paraméterből.
createArray	Több bemenetből származó tömböt ad vissza.
dataUri	Adja vissza egy bemeneti érték adat URI-jának értékét.
dataUriToBinary	Adja vissza egy adat URI bináris verzióját.
dataUriToString	Addja vissza az adat URI karakterlánc változatát.
decodeBase64	Egy base64 kódolású karakterlánc karakterlánc verzióját adja vissza.
decodeDataUri	Adja vissza egy adat URI bináris verzióját.
decodeUriComponent	Adjon vissza egy karakterláncot, amely az escape karaktereket dekódolt verziókra cseréli.
encodeUriComponent	Olyan sztringet ad vissza, amely az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
úszik	Egy bemeneti érték lebegőpontos számát adja vissza.
Int	Egy sztring egész verziójának visszaadása.
json	Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.
karakterlánc	Adja vissza egy bemeneti érték sztringverziójának értékét.
uriComponent	Adja vissza egy bemeneti érték URI-kódolású verzióját úgy, hogy az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
uriComponentToBinary	Adja vissza az URI-kódolt sztring bináris verzióját.
uriComponentToString	Adja vissza az URI-kódolt szöveg szövegverzióját.
xml	Adja vissza a szöveg XML-verzióját.
xpath	Ellenőrizze az XML-ben az XPath (XML Path Language) kifejezésnek megfelelő csomópontokat vagy értékeket, és adja vissza az egyező csomópontokat vagy értékeket.

Matematikai függvények

Ezek a függvények bármilyen típusú számhoz használhatók: egész számokhoz és lebegőpontosakhoz.

Matematikai függvény	Feladat
hozzáad	Két szám hozzáadásának eredményét adja vissza.
div	Egy szám egy másik számmal való felosztásának eredményét adja vissza.
max	Számkészletből vagy tömbből a legmagasabb értéket adja vissza.
Min	A legkisebb értéket adja vissza számkészletből vagy tömbből.
Mod	Adja meg a maradékot, amikor egy számot eloszt egy másik számmal.
mul	Adja vissza a szorzatot két szám szorzásából.
Rand	Véletlenszerű egész számot ad vissza egy megadott tartományból.
tartomány	Adott egész számból induló egész tömböt ad vissza.
helyettesít	Egy szám kivonásának eredményét adja vissza egy másik számból.

Függvényreferencia

Ez a szakasz az összes elérhető függvényt betűrendben sorolja fel.

add

Két szám hozzáadásának eredményét adja vissza.

add(<summand_1>, <summand_2>)

Paraméter	Kötelező	Típus	Leírás
< >summand_1, <summand_2>	Igen	Egész szám, lebegőpontos vagy vegyes	A hozzáadni kívánt számok

Visszaadott érték	Típus	Leírás
< eredmény-összeg>	Egész szám vagy lebegőpontos	A megadott számok hozzáadásának eredménye

Példa

Ez a példa a megadott számokat adja hozzá:

add(1, 1.5)

És ezt az eredményt adja vissza: 2.5

addDays

Adjon hozzá néhány napot egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< napok>	Igen	Egész szám	A hozzáadandó napok pozitív vagy negatív száma
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú nap

Példa 1

Ez a példa 10 napot ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-25T00:00:0000000Z"

2\. példa

Ez a példa öt napot von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-10T00:00:0000000Z"

addHours

Adjon hozzá több órát egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< órák>	Igen	Egész szám	A hozzáadni kívánt órák pozitív vagy negatív száma
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú óra

1\. példa

Ez a példa 10 órát ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T10:00:0000000Z"

2. példa

Ez a példa öt órát von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T10:00:0000000Z"

addMinutes

Adjon hozzá néhány percet egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< percek>	Igen	Egész	A hozzáadandó percek pozitív vagy negatív száma
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú perc

1\. példa

Ez a példa 10 percet ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T00:20:00.0000000Z"

2. példa

Ez a példa öt percet von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T00:15:00.0000000Z"

addSeconds

Adjon hozzá néhány másodpercet egy időbélyeghez.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< másodpercek>	Igen	Egész	A hozzáadandó másodpercek pozitív vagy negatív száma
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú másodperc

1\. példa

Ez a példa 10 másodpercet ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:10.0000000Z"

Példa 2

Ez a példa öt másodpercet von ki a megadott időbélyegből:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:25.0000000Z"

addToTime

Adjon hozzá több időegységet egy időbélyeghez. Lásd még : getFutureTime().

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< interval>	Igen	Egész	A hozzáadni kívánt időegységek száma
< timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyeg és a megadott számú időegység

1\. példa

Ez a példa egy napot ad hozzá a megadott időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-01-02T00:00:00.0000000Z"

2. példa

Ez a példa egy napot ad hozzá a megadott időbélyeghez:

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

Az eredményt az opcionális "D" formátummal adja vissza: "Tuesday, January 2, 2018"

and

Ellenőrizze, hogy mindkét kifejezés igaz-e. Igaz értéket ad vissza, ha mindkét kifejezés igaz, vagy hamis értéket ad vissza, ha legalább egy kifejezés hamis.

and(<expression1>, <expression2>)

Paraméter	Kötelező	Típus	Leírás
< kifejezés1>, <kifejezés2>	Igen	logikai érték	Az ellenőrizni kívánt kifejezések

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Boolean	Igaz értéket ad vissza, ha mindkét kifejezés igaz. Hamis értéket ad vissza, ha legalább egy kifejezés hamis.

1\. példa

Ezek a példák ellenőrzik, hogy a megadott logikai értékek egyaránt igazak-e:

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

És a következő eredményeket adja vissza:

• Első példa: Mindkét kifejezés igaz, ezért visszaadja true.
• Második példa: Az egyik kifejezés hamis, ezért visszaadja false.
• Harmadik példa: Mindkét kifejezés hamis, ezért visszaadja false.

2\. példa

Ezek a példák ellenőrzik, hogy a megadott kifejezések mindegyike igaz-e:

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

És a következő eredményeket adja vissza:

• Első példa: Mindkét kifejezés igaz, ezért visszaadja true.
• Második példa: Az egyik kifejezés hamis, ezért visszaadja false.
• Harmadik példa: Mindkét kifejezés hamis, ezért visszaadja false.

array

Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd: createArray().

array('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A tömb létrehozására szolgáló karakterlánc

Visszaadott érték	Típus	Leírás
[<érték>]	Tömb	Az egyetlen megadott bemenetet tartalmazó tömb

Példa

Ez a példa létrehoz egy tömböt a "hello" sztringből:

array('hello')

És ezt az eredményt adja vissza: ["hello"]

base64

Adja vissza egy karakterlánc base64-kódolású verzióját.

base64('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A bemeneti karaktersorozat

Visszaadott érték	Típus	Leírás
< base64-string>	Sztring	A bemeneti sztring base64 kódolású verziója

Példa

Ez a példa a "hello" sztringet base64 kódolású sztringgé alakítja:

base64('hello')

És ezt az eredményt adja vissza: "aGVsbG8="

base64ToBinary

Egy base64 kódolású sztring bináris verzióját adja vissza.

base64ToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A konvertálni kívánt base64 kódolású sztring

Visszaadott érték	Típus	Leírás
< binary-for-base64-string>	Sztring	A base64 kódolású sztring bináris verziója

Példa

Ez a példa az "aGVsbG8=" base64 kódolású sztringet bináris sztringgé alakítja:

base64ToBinary('aGVsbG8=')

És ezt az eredményt adja vissza:

"0110000101000111010101100111001101100010010001110011100000111101"

base64 sztringgé alakítás

Adja vissza a base64-kódolt karakterlánc szöveges verzióját, ezzel dekódolva a base64 karakterláncot. Használja ezt a függvényt a decodeBase64() helyett. Bár mindkét függvény ugyanúgy működik, base64ToString() előnyben részesítjük.

base64ToString('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A dekódolni kívánt base64-kódolású sztring

Visszaadott érték	Típus	Leírás
< dekódolt-base64-karakterlánc>	Sztring	A base64 kódolású sztring szöveges változata

Példa

Ez a példa az "aGVsbG8=" base64 kódolású sztringet csak egy sztringgé alakítja:

base64ToString('aGVsbG8=')

És ezt az eredményt adja vissza: "hello"

binary

Adja vissza egy szöveg bináris változatát.

binary('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az átalakítandó karakterlánc

Visszaadott érték	Típus	Leírás
< bemeneti érték binárisa>	Sztring	A megadott sztring bináris verziója

Példa

Ez a példa bináris sztringgé alakítja a "hello" sztringet:

binary('hello')

És ezt az eredményt adja vissza:

"0110100001100101011011000110110001101111"

bool

Egy érték logikai verzióját adja vissza.

bool(<value>)

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Bármely	Az átalakítandó érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Bóoleai	A megadott érték logikai verziója

Példa

Ezek a példák a megadott értékeket logikai értékekké alakítják át:

bool(1)
bool(0)

És a következő eredményeket adja vissza:

• Első példa: true
• Második példa: false

coalesce

Az első nem null értéket adja vissza egy vagy több paraméterből. Az üres sztringek, üres tömbök és üres objektumok nem null értékűek.

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

Paraméter	Kötelező	Típus	Leírás
< >object_1, <object_2>, ...	Igen	Bármely, keverheti a típusokat	Egy vagy több, null értéket ellenőrizni kívánt elem

Visszaadott érték	Típus	Leírás
< első nem null értékű elem>	Bármely	Az első elem vagy érték, amely nem null értékű. Ha minden paraméter null értékű, akkor a függvény null értéket ad vissza.

Példa

Ezek a példák a megadott értékek közül az első nem null értéket, vagy null értéket adnak vissza, ha az összes érték null:

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

És a következő eredményeket adja vissza:

• Első példa: true
• Második példa: "hello"
• Harmadik példa: null

concat

Egyesítsen két vagy több karakterláncot, és adja vissza az egyesített karakterláncot.

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

Paraméter	Kötelező	Típus	Leírás
< szöveg1>, <szöveg2>, ...	Igen	Sztring	Legalább két karakterláncot összefűzni

Visszaadott érték	Típus	Leírás
< text1text2...>	Sztring	A kombinált bemeneti sztringekből létrehozott sztring

Példa

Ez a példa egyesíti a "Hello" és a "World" sztringeket:

concat('Hello', 'World')

És ezt az eredményt adja vissza: "HelloWorld"

contains

Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet. Igaz értéket ad vissza az elem megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Ez a függvény az alábbi gyűjteménytípusokon működik:

• Egy karakterlánc, amelyben megtalálható egy részkarakterlánc
• Egy tömb, amely egy értéket keres
• Egy szótár egy kulcs megkereséséhez

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring, tömb vagy szótár	Az ellenőrizni kívánt gyűjtemény
< value>	Igen	Sztring, tömb vagy szótár	A keresendő elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Boolean típus	Igaz értéket ad vissza az elem megtalálásakor. Hamis értéket ad vissza, ha nem található.

1. példa

Ez a példa ellenőrzi a "hello world" sztringet a "világ" részsztringnél, és igaz értéket ad vissza:

contains('hello world', 'world')

Példa 2

Ez a példa ellenőrzi a "hello world" sztringet, hogy tartalmazza-e a "világegyetem" részláncot, és hamis értéket ad vissza:

contains('hello world', 'universe')

convertFromUtc

Időbélyeg konvertálása az univerzális idő szerint koordinált (UTC) időzónából a cél időzónába.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< destinationTimeZone>	Igen	Sztring	A cél időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< konvertált időbélyeg>	Sztring	A cél időzónává konvertált időbélyeg

1\. példa

Ez a példa az időbélyeget a megadott időzónává alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00Z"

2. példa

Ez a példa az időbélyeget a megadott időzónává és formátummá alakítja:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

convertTimeZone

Időbélyeg konvertálása a forrás időzónából a cél időzónává.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< sourceTimeZone>	Igen	Sztring	A forrás időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< destinationTimeZone>	Igen	Sztring	A cél időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< konvertált időbélyeg>	Sztring	Az időbélyeg a cél időzónára konvertálva

1\. példa

Ez a példa a forrás időzónát a cél időzónává alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00.0000000"

2. példa

Ez a példa átalakít egy időzónát a megadott időzónává és formátumba:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

convertToUtc

Időbélyeg konvertálása a forrás időzónából univerzális idő koordinált (UTC) időzónává.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< sourceTimeZone>	Igen	Sztring	A forrás időzóna neve. Az időzónanevekről a Microsoft időzóna-értékei című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< konvertált időbélyeg>	Sztring	Az időbélyeg UTC-vé konvertálva

Példa 1

Ez a példa az időbélyeget UTC-vé alakítja:

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

És ezt az eredményt adja vissza: "2018-01-01T08:00:00.0000000Z"

2\. példa

Ez a példa az időbélyeget UTC-vé alakítja:

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

És ezt az eredményt adja vissza: "Monday, January 1, 2018"

createArray

Több bemenetből származó tömböt ad vissza. Egyetlen bemeneti tömb esetén lásd a tömb()-et.

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

Paraméter	Kötelező	Típus	Leírás
< object1>, <object2>, ...	Igen	Bármely, de nem vegyes	Legalább két elem a tömb létrehozásához

Visszaadott érték	Típus	Leírás
[<object1>, <object2>, ...]	Tömb	Az összes bemeneti elemből létrehozott tömb

Példa

Ez a példa a következő bemenetekből hoz létre tömböt:

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

És ezt az eredményt adja vissza: ["h", "e", "l", "l", "o"]

dataUri

Egy karakterlánc egységes erőforrás-azonosítóját (URI) adja vissza.

dataUri('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az átalakítandó karakterlánc

Visszaadott érték	Típus	Leírás
< data-uri>	Sztring	A bemeneti sztring adat-URI-ja

Példa

Ez a példa létrehoz egy adat URI-t a "hello" sztringhez:

dataUri('hello')

És ezt az eredményt adja vissza: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Adja vissza az egységes adaterőforrás-azonosító (URI) bináris verzióját. Használja ezt a függvényt a decodeDataUri() helyett. Bár mindkét függvény ugyanúgy működik, dataUriBinary() előnyben részesítjük.

dataUriToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az átalakítandó adat URI-ja

Visszaadott érték	Típus	Leírás
< binary-for-data-uri>	Sztring	Az adat URI bináris verziója

Példa

Ez a példa létrehoz egy bináris verziót az adat URI-hoz:

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Adja vissza az egységes adaterőforrás-azonosító (URI) szöveges változatát.

dataUriToString('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az átalakítandó adat URI-ja

Visszaadott érték	Típus	Leírás
< string-for-data-uri>	Sztring	Az adat URI karakterlánc verziója

Példa

Ez a példa létrehoz egy sztringet ehhez az adat URI-hoz:

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

És ezt az eredményt adja vissza: "hello"

dayOfMonth

Adja vissza a hónap napját egy időbélyegből.

dayOfMonth('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc

Visszaadott érték	Típus	Leírás
< hónap napja>	Egész	A hónap napja a megadott időbélyegből

Példa

Ez a példa a hónap napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 15

dayOfWeek

Adja vissza a hét napját egy időbélyegből.

dayOfWeek('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc

Visszaadott érték	Típus	Leírás
< hét napja>	Egész	A hét napja a megadott időbélyegből, ahol a vasárnap 0, a hétfő 1, és így tovább

Példa

Ez a példa a hét napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 3

dayOfYear

Az év napját adja vissza egy időbélyegből.

dayOfYear('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc

Visszaadott érték	Típus	Leírás
< év napja>	Egész	Az év napja a megadott időbélyegből

Példa

Ez a példa az év napjának számát adja vissza ebből az időbélyegből:

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

És ezt az eredményt adja vissza: 74

decodeBase64

Adja vissza a szövegverziót egy base64 kódolt szöveg számára, ezzel dekódolva a base64 szöveget. Fontolja meg a base64ToString() használatát ahelyett, hogy decodeBase64(). Bár mindkét függvény ugyanúgy működik, base64ToString() előnyben részesítjük.

decodeBase64('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A dekódolni kívánt base64-kódolású sztring

Visszaadott érték	Típus	Leírás
< dekódolt-base64-karakterlánc>	Sztring	A base64 kódolású sztringek sztringverziója

Példa

Ez a példa létrehoz egy sztringet egy base64 kódolású sztringhez:

decodeBase64('aGVsbG8=')

És ezt az eredményt adja vissza: "hello"

decodeDataUri

Adja vissza az egységes adaterőforrás-azonosító (URI) bináris verzióját. Fontolja meg a dataUriToBinary() használatát ahelyett, hogy decodeDataUri(). Bár mindkét függvény ugyanúgy működik, dataUriToBinary() előnyben részesítjük.

decodeDataUri('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A dekódolni kívánt adat URI-sztringje

Visszaadott érték	Típus	Leírás
< binary-for-data-uri>	Sztring	Adat URI-sztring bináris verziója

Példa

Ez a példa az adat URI bináris verzióját adja vissza:

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Egy olyan karakterláncot ad vissza, amely az escape karaktereket dekódolt verziókra cseréli.

decodeUriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A kódolandó feloldó karaktereket tartalmazó sztring

Visszaadott érték	Típus	Leírás
< dekódolt-uri>	Sztring	A frissített karakterlánc a kibontott escape karakterekkel

Példa

Ez a példa a sztringben szereplő feloldó karaktereket dekódolt verziókra cseréli:

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

És ezt az eredményt adja vissza: "https://contoso.com"

div

Egy szám egy másik számmal való felosztásának eredményét adja eredményül.

div(<dividend>, <divisor>)

A függvény pontos visszatérési típusa a paraméterek típusától függ – lásd a részletes példákat.

Paraméter	Kötelező	Típus	Leírás
< osztalék>	Igen	Egész szám vagy lebegőpontos	Az osztó által elosztandó szám
< osztó>	Igen	Egész szám vagy lebegőpontos	Az osztalékot megosztó szám. A nulla osztóérték futásidőben hibát okoz.

Visszaadott érték	Típus	Leírás
< hányados-eredmény>	Egész szám vagy lebegőpontos	Az első szám és a második szám osztásának eredménye

1\. példa

Ezek a példák a 9-es számot 2-vel osztják el:

div(9, 2.0)
div(9.0, 2)
div(9.0, 2.0)

És minden visszaadja ezt az eredményt: 4.5

2. példa

Ez a példa a 9-es számot is 2-vel osztja el, de mivel mindkét paraméter egész szám, a többit elveti (egész számosztás):

div(9, 2)

A kifejezés az eredményt 4adja vissza. A maradék értékének lekéréséhez használja a mod() függvényt.

encodeUriComponent

Egy karakterlánc egységes erőforrás-azonosító (URI) kódolású verzióját adja vissza az URL-cím szempontjából nem biztonságos karakterek kiváltó karakterekre való lecserélésével. Fontolja meg az uriComponent() használatát ahelyett, hogy encodeUriComponent(). Bár mindkét függvény ugyanúgy működik, uriComponent() előnyben részesítjük.

encodeUriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az URI kódolású formátumba konvertálandó karakterlánc

Visszaadott érték	Típus	Leírás
< kódolt-uri>	Sztring	Az URI-kódolású sztring escape karakterekkel

Példa

Ez a példa egy URI-kódolású verziót hoz létre ehhez a sztringhez:

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

És ezt az eredményt adja vissza: "http%3A%2F%2Fcontoso.com"

empty

Ellenőrizze, hogy egy gyűjtemény üres-e. Igaz értéket ad vissza, ha a gyűjtemény üres, vagy hamis értéket ad vissza, ha nem üres.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring, tömb vagy objektum	Az ellenőrizni kívánt gyűjtemény

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Akkor ad vissza igazat, ha a gyűjtemény üres. Hamis értéket ad vissza, ha nem üres.

Példa

Ezek a példák ellenőrzik, hogy a megadott gyűjtemények üresek-e:

empty('')
empty('abc')

És a következő eredményeket adja vissza:

• Első példa: Egy üres karakterláncot ad át, így a függvény visszaadja true.
• Második példa: Adja át az "abc" sztringet, így a függvény visszaadja false.

endsWith

Ellenőrizze, hogy egy sztring egy adott részsztringgel végződik-e. Igaz értéket ad vissza az alsztring megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény nem tesz különbséget a kis- és nagybetűk között.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az ellenőrizni kívánt karakterlánc
< searchText>	Igen	Sztring	A befejezési részstring a kereséshez

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a záró részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring a "world" sztringgel végződik-e.

endsWith('hello world', 'world')

És ezt az eredményt adja vissza: true

2. példa

Ez a példa ellenőrzi, hogy a "hello world" karakterlánc a "universe" karakterlánccal végződik-e.

endsWith('hello world', 'universe')

És ezt az eredményt adja vissza: false

equals

Ellenőrizze, hogy mindkét érték, kifejezés vagy objektum egyenértékű-e. Igaz értéket ad vissza, ha mindkettő egyenértékű, vagy hamis értéket ad vissza, ha azok nem egyenértékűek.

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

Paraméter	Kötelező	Típus	Leírás
< object1>, <object2>	Igen	Különböző	Az összehasonlítandó értékek, kifejezések vagy objektumok

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Boolei	Igaz értéket ad vissza, ha mindkettő egyenértékű. Hamis értéket ad vissza, ha nem egyenértékű.

Példa

Ezek a példák ellenőrzik, hogy a megadott bemenetek egyenértékűek-e.

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

És a következő eredményeket adja vissza:

• Első példa: Mindkét érték egyenértékű, ezért a függvény visszaadja a függvényt true.
• Második példa: Mindkét érték nem egyezik meg, ezért a függvény visszaadja a függvényt false.

first

Sztringből vagy tömbből az első elemet adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring vagy tömb	Az a gyűjtemény, ahol az első elem megtalálható

Visszaadott érték	Típus	Leírás
< első gyűjteményelem>	Bármely	A gyűjtemény első eleme

Példa

Az alábbi példák az alábbi gyűjtemények első elemét keresik:

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

És adja vissza az alábbi eredményeket:

• Első példa: "h"
• Második példa: 0

float

Lebegőpontos szám sztringverziójának konvertálása tényleges lebegőpontos számmá.

float('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A konvertálni kívánt érvényes lebegőpontos számmal rendelkező sztring

Visszaadott érték	Típus	Leírás
< lebegőpontos érték>	Lebegőpontos értékek	A megadott sztring lebegőpontos száma

Példa

Ez a példa sztringverziót hoz létre ehhez a lebegőpontos számhoz:

float('10.333')

És ezt az eredményt adja vissza: 10.333

formatDateTime

Időbélyeget ad vissza a megadott formátumban.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< újraformált időbélyeg>	Sztring	A megadott formátumban frissített időbélyeg

Példa

Ez a példa egy időbélyeget a megadott formátumra konvertál:

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

És ezt az eredményt adja vissza: "2018-03-15T12:00:00"

getFutureTime

Adja vissza az aktuális időbélyeget és a megadott időegységeket.

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

Paraméter	Kötelező	Típus	Leírás
< interval>	Igen	Egész	A hozzáadni kívánt időegységek száma
< timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az aktuális időbélyeg és a megadott számú időegység

1. példa

Tegyük fel, hogy az aktuális időbélyeg "2018-03-01T00:00:00.0000000Z". Ez a példa öt napot ad hozzá az időbélyeghez:

getFutureTime(5, 'Day')

És ezt az eredményt adja vissza: "2018-03-06T00:00:00.0000000Z"

2. Példa

Tegyük fel, hogy az aktuális időbélyegző "2018-03-01T00:00:00.0000000Z". Ez a példa öt napot ad hozzá, és az eredményt "D" formátumba alakítja:

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

És ezt az eredményt adja vissza: "Tuesday, March 6, 2018"

getPastTime

Az aktuális időbélyeget adja vissza a megadott időegységekkel együtt.

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

Paraméter	Kötelező	Típus	Leírás
< interval>	Igen	Egész	A kivonáshoz megadott időegységek száma
< timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az aktuális időpont mínusz a megadott számú időegység

1. példa

Tegyük fel, hogy a jelenlegi időpont "2018-02-01T00:00:00.0000000Z". Ez a példa öt napot von ki az időbélyegből:

getPastTime(5, 'Day')

És ezt az eredményt adja vissza: "2018-01-27T00:00:00.0000000Z"

2\. példa

Tegyük fel, hogy az aktuális időpont "2018-02-01T00:00:00.0000000Z". Ez a példa kivon öt napot, és az eredményt "D" formátumba konvertálja:

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

És ezt az eredményt adja vissza: "Saturday, January 27, 2018"

greater

Ellenőrizze, hogy az első érték nagyobb-e a másodiknál. Igaz értéket ad vissza, ha az első érték nagyobb, vagy hamis értéket ad vissza, ha kisebb.

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

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Egész szám, lebegőpontos szám vagy szöveg	Az első érték, amely ellenőrzi, hogy nagyobb-e a második értéknél
< compareTo>	Igen	Egész szám, lebegőpontos vagy karakterlánc, sorrendben	Az összehasonlító érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték nagyobb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy kisebb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték nagyobb-e, mint a második érték:

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

És adja vissza az alábbi eredményeket:

• Első példa: true
• Második példa: false

greaterOrEquals

Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték. Igaz értéket ad vissza, ha az első érték nagyobb vagy egyenlő, vagy hamis értéket ad vissza, ha az első érték kisebb.

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

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Egész szám, lebegőpontos vagy karakterlánc	Az első érték, amely ellenőrzi, hogy nagyobb vagy egyenlő-e a második értéknél
< compareTo>	Igen	Egész szám, lebegőpontos szám, vagy karakterlánc	Az összehasonlító érték

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték nagyobb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték kisebb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték nagyobb vagy egyenlő-e, mint a második érték:

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

És adja vissza az alábbi eredményeket:

• Első példa: true
• Második példa: false

guid

Hozzon létre egy globálisan egyedi azonosítót (GUID) sztringként, például "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Emellett az alapértelmezett formátumtól (D) eltérő formátumot is megadhat a GUID számára, amely kötőjelekkel elválasztott 32 számjegyből áll.

guid('<format>')

Paraméter	Kötelező	Típus	Leírás
< format>	Nem	Sztring	A formátumkijelölő az egyetlen a visszaadott GUID számára. Alapértelmezés szerint a formátum "D", de használhatja az "N", a "D", a "B", a "P" vagy az "X" formátumot.

Visszaadott érték	Típus	Leírás
< GUID-érték>	Sztring	Véletlenszerűen létrehozott GUID

Példa

Ez a példa ugyanazt a GUID-t hozza létre, de 32 számjegyet, kötőjelekkel elválasztva, zárójelben:

guid('P')

És ezt az eredményt adja vissza: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.

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

Paraméter	Kötelező	Típus	Leírás
< kifejezés>	Igen	Logikai	Az ellenőrizni kívánt kifejezés
< valueIfTrue>	Igen	Bármely	Az érték, amelyet visszaad, ha a kifejezés igaz.
< valueIfFalse>	Igen	Bármely	A visszaadandó érték, ha a kifejezés hamis

Visszaadott érték	Típus	Leírás
< megadott visszatérési érték>	Bármely	A megadott érték, amely attól függően ad vissza, hogy a kifejezés igaz vagy hamis

Példa

Ez a példa azért ad "yes" vissza, mert a megadott kifejezés igaz értéket ad vissza. Ellenkező esetben a példa a következőt adja "no"vissza:

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

indexOf

Egy részszűkítés kezdő pozícióját vagy indexértékét adja vissza. Ez a függvény nem megkülönbözteti a kis- és nagybetűt, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az a karakterlánc, amely tartalmazza a keresendő részsztringet
< searchText>	Igen	Sztring	A keresendő alsztring

Visszaadott érték	Típus	Leírás
< index-érték>	Egész	A megadott részsztring kezdőpozíciója vagy indexértéke. Ha a sztring nem található, adja vissza a -1 számot.

Példa

Ez a példa a "hello world" sztringben megkeresi a "világ" részsztring kezdő indexértékét:

indexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

int

Az egész szám verziójának visszaadása egy sztringből.

int('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az átalakítandó karakterlánc

Visszaadott érték	Típus	Leírás
< egész szám eredménye>	Egész	A megadott sztring egész verziója

Példa

Ez a példa létrehoz egy egész verziót a "10" sztringhez:

int('10')

És ezt az eredményt adja vissza: 10

json

Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.

json('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring vagy XML	Az átalakítandó karakterlánc vagy XML

Visszaadott érték	Típus	Leírás
< JSON-eredmény>	JSON natív típus vagy objektum	A megadott sztring vagy XML JSON-natív típusértéke vagy objektuma. Ha a sztring null értékű, a függvény egy üres objektumot ad vissza.

1\. példa

Ez a példa jSON-értékké alakítja a sztringet:

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

És ezt az eredményt adja vissza: [1, 2, 3]

2. Példa

Ez a példa jSON-ra konvertálja ezt a sztringet:

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

És ezt az eredményt adja vissza:

{
  "fullName": "Sophia Owen"
}

3. példa

Ez a példa ezt az XML-t JSON-ra konvertálja:

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

És ezt az eredményt adja vissza:

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

intersection

Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit tartalmazza. Az eredményben való megjelenéshez egy elemnek meg kell jelennie a függvénynek átadott összes gyűjteményben. Ha egy vagy több elem neve megegyezik, az eredményben az utolsó ilyen nevű elem jelenik meg.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény1>, <gyűjtemény2>, ...	Igen	Tömb vagy objektum, de nem mindkettő	Azok a gyűjtemények, amelyekből csak a gyakori elemeket szeretné használni

Visszaadott érték	Típus	Leírás
< gyakori elemek>	Tömb vagy objektum, illetve	Olyan gyűjtemény, amely csak a megadott gyűjtemények gyakori elemeit tartalmazza

Példa

Ez a példa az alábbi tömbök gyakori elemeit találja meg:

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

És egy olyan tömböt ad vissza, amely csak az alábbi elemeket tartalmazza:[1, 2]

join

Olyan sztringet adjon vissza, amely a tömb összes elemét tartalmazza, és ahol az elemeket egy elválasztó választja el egymástól.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Tömb	Az összekapcsolni kívánt elemeket tartalmazó tömb
< Határoló>	Igen	Sztring	Az eredményül kapott sztringben szereplő karakterek között megjelenő elválasztó

Visszaadott érték	Típus	Leírás
< char1><elválasztó><karakter2><elválasztó>...	Sztring	Az összes megadott tömbelem összefűzésekor kapott eredményszöveg

Példa

Ez a példa egy sztringet hoz létre a tömb összes eleméből a megadott karakterrel elválasztóként:

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

És ezt az eredményt adja vissza: "a.b.c"

last

Egy gyűjtemény utolsó elemének visszaadása.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring vagy tömb	Az a gyűjtemény, amelyben az utolsó elem található

Visszaadott érték	Típus	Leírás
< utolsó-gyűjtemény-tétel>	Sztring vagy tömb, illetve	A gyűjtemény utolsó eleme

Példa

Az alábbi példák az alábbi gyűjtemények utolsó elemét keresik:

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

És a következő eredményeket adja vissza:

• Első példa: "d"
• Második példa: 3

lastIndexOf

Egy részszűkítés utolsó előfordulásának kezdő pozícióját vagy indexértékét adja vissza. Ez a függvény nem megkülönbözteti a kis- és nagybetűt, és az indexek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az a karakterlánc, amely a keresendő részkarakterlánccal rendelkezik
< searchText>	Igen	Sztring	A keresendő részszöveg

Visszaadott érték	Típus	Leírás
< vég-index-érték>	Egész	A megadott részstring utolsó előfordulásának kezdőpozíciója vagy indexértéke. Ha a sztring nem található, adja vissza a -1 számot.

Példa

Ez a példa a "hello world" sztringben a "világ" sztring utolsó előfordulásának kezdő indexértékét keresi meg:

lastIndexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

length

A gyűjtemény elemeinek számát adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring vagy tömb	A megszámlálandó elemeket tartalmazó gyűjtemény

Visszaadott érték	Típus	Leírás
< hossz vagy darabszám>	Egész	A gyűjtemény elemeinek száma

Példa

Az alábbi példák megszámolják a gyűjtemények elemeinek számát:

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

És adja vissza ezt az eredményt: 4

less

Ellenőrizze, hogy az első érték kisebb-e a másodiknál. Igaz értéket ad vissza, ha az első érték kisebb, vagy hamis értéket ad vissza, ha az első érték nagyobb.

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

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Egész szám, lebegőpontos vagy karakterlánc	Az első érték, amely ellenőrzi, hogy a második értéknél kisebb-e
< compareTo>	Igen	Egész szám, lebegőpontos vagy karakterlánc, illetve	Az összehasonlító elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Boole	Igaz értéket ad vissza, ha az első érték kisebb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy nagyobb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték kisebb-e, mint a második érték.

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

És adja vissza az alábbi eredményeket:

• Első példa: true
• Második példa: false

lessOrEquals

Ellenőrizze, hogy az első érték kisebb-e, mint a második érték. Igaz értéket ad vissza, ha az első érték kisebb vagy egyenlő, vagy hamis értéket ad vissza, ha az első érték nagyobb.

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

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Egész szám, lebegőpontos vagy sztring	Az első érték, amely ellenőrzi, hogy a második érték kisebb vagy egyenlő-e
< compareTo>	Igen	Egész szám, lebegőpontos szám, vagy karakterlánc	Az összehasonlító elem

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha az első érték kisebb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték nagyobb, mint a második érték.

Példa

Ezek a példák ellenőrzik, hogy az első érték kisebb vagy egyenlő-e, mint a második érték.

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

És adja vissza az alábbi eredményeket:

• Első példa: true
• Második példa: false

max

A legmagasabb értéket adja vissza egy olyan listából vagy tömbből, amely mindkét végén számokat tartalmaz.

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

Paraméter	Kötelező	Típus	Leírás
< szám1>, <szám2>, ...	Igen	Egész szám, lebegőpontos vagy mindkettő	Az a számkészlet, amelyből a legmagasabb értéket szeretné megkapni
[<szám1>, <szám2>, ...]	Igen	Tömb – Egész szám, lebegőpontos vagy mindkettő	Az a számtömb, amelyből a legmagasabb értéket szeretné megkapni

Visszaadott érték	Típus	Leírás
< maximális érték>	Egész szám vagy lebegőpontos	A megadott tömb vagy számkészlet legnagyobb értéke

Példa

Ezek a példák a számhalmazból és a tömbből kapják meg a legmagasabb értéket:

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

És adja vissza ezt az eredményt: 3

min

A legkisebb értéket adja vissza számkészletből vagy tömbből.

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

Paraméter	Kötelező	Típus	Leírás
< szám1>, <szám2>, ...	Igen	Egész szám, lebegőpontos vagy mindkettő	Az a számkészlet, amelyből a legalacsonyabb értéket szeretné megadni
[<szám1>, <szám2>, ...]	Igen	Tömb – Egész szám, lebegőpontos vagy mindkettő	Az a számtömb, amelyből a legalacsonyabb értéket szeretné megkapni

Visszaadott érték	Típus	Leírás
< minimális érték>	Egész szám vagy lebegőpontos	A megadott számkészlet vagy megadott tömb legalacsonyabb értéke

Példa

Ezek a példák a számhalmaz és a tömb legalacsonyabb értékét kapják meg:

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

És adja vissza ezt az eredményt: 1

mod

Adja vissza egy szám másik számmal való osztásának maradékát. Az egész számok osztását lásd: div().

mod(<dividend>, <divisor>)

Paraméter	Kötelező	Típus	Leírás
< osztalék>	Igen	Egész szám vagy lebegőpontos	Az osztó által elosztandó szám
< osztó>	Igen	Egész szám vagy lebegőpontos	Az osztalékot megosztó szám. A nulla osztóérték futásidőben hibát okoz.

Visszaadott érték	Típus	Leírás
< modulo-eredmény>	Egész szám vagy lebegőpontos	Az első szám és a második szám osztásának fennmaradó része

Példa

Ez a példa kiszámítja a maradékot, ha az első szám el van osztva a második számmal:

mod(3, 2)

És ezt az eredményt adja vissza: 1

mul

Adja vissza a szorzatot két szám szorzásából.

mul(<multiplicand1>, <multiplicand2>)

Paraméter	Kötelező	Típus	Leírás
< multiplicand1>	Igen	Egész szám vagy lebegőpontos	A szorzattal szorzandó szám2
< multiplicand2>	Igen	Egész szám vagy lebegőpontos	Az a szám, amely tényező1-t megszoroz

Visszaadott érték	Típus	Leírás
< termék eredménye>	Egész szám vagy lebegőpontos	Az első szám és a második szám szorzásából származó szorzat

Példa

Az alábbi példák megszorozzák az első számot a második számmal:

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

És adja vissza az alábbi eredményeket:

• Első példa: 2
• Második példa 3

not

Ellenőrizze, hogy egy kifejezés hamis-e. Hamis értéket ad vissza, ha a kifejezés igaz, vagy igaz értéket ad vissza, ha hamis.

not(<expression>)

Paraméter	Kötelező	Típus	Leírás
< kifejezés>	Igen	Logikai	Az ellenőrizni kívánt kifejezés

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Boolean	Igaz értéket ad vissza, ha a kifejezés hamis. Hamis értéket ad vissza, ha a kifejezés igaz.

Példa 1

Ezek a példák ellenőrzik, hogy a megadott kifejezések hamisak-e:

not(false)
not(true)

És adja vissza az alábbi eredményeket:

• Első példa: A kifejezés hamis, ezért a függvény visszaadja a függvényt true.
• Második példa: A kifejezés igaz, ezért a függvény visszaadja a függvényt false.

2\. példa

Ezek a példák ellenőrzik, hogy a megadott kifejezések hamisak-e:

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

És adja vissza az alábbi eredményeket:

• Első példa: A kifejezés hamis, ezért a függvény visszaadja a függvényt true.
• Második példa: A kifejezés igaz, ezért a függvény visszaadja a függvényt false.

or

Ellenőrizze, hogy legalább egy kifejezés igaz-e. Igaz értéket ad vissza, ha legalább egy kifejezés igaz, vagy hamis értéket ad vissza, ha mindkettő hamis.

or(<expression1>, <expression2>)

Paraméter	Kötelező	Típus	Leírás
< kifejezés1>, <kifejezés2>	Igen	Boolen	Az ellenőrizni kívánt kifejezések

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha legalább egy kifejezés igaz. Hamis értéket ad vissza, ha mindkét kifejezés hamis.

1. példa

Ezek a példák ellenőrzik, hogy legalább egy kifejezés igaz-e:

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

És adja vissza az alábbi eredményeket:

• Első példa: Legalább egy kifejezés igaz, ezért a függvény visszaadja a függvényt true.
• Második példa: Mindkét kifejezés hamis, ezért a függvény visszaadja a függvényt false.

2. példa

Ezek a példák ellenőrzik, hogy legalább egy kifejezés igaz-e:

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

És adja vissza az alábbi eredményeket:

• Első példa: Legalább egy kifejezés igaz, ezért a függvény visszaadja a függvényt true.
• Második példa: Mindkét kifejezés hamis, ezért a függvény visszaadja a függvényt false.

rand

Véletlenszerű egész számot ad vissza egy megadott tartományból, amely csak a kezdő végén inkluzív.

rand(<minValue>, <maxValue>)

Paraméter	Kötelező	Típus	Leírás
< minValue>	Igen	Egész	A tartomány legalacsonyabb egész száma
< maxValue>	Igen	Egész	A függvény által visszaadható tartomány legmagasabb egészét követő egész szám

Visszaadott érték	Típus	Leírás
< véletlenszerű eredmény>	Egész	A megadott tartományból visszaadott véletlenszerű egész szám. Vegye figyelembe, hogy minden meghívás rand() egyedi eredményt fog eredményezni, ami azt jelenti, hogy a kimeneti monitorozás során megfigyelt érték nem lehet ugyanaz a tényleges futási időpontban.

Példa

Ez a példa véletlenszerű egész számot kap a megadott tartományból, a maximális érték kivételével:

rand(1, 5)

A következő számok egyikét adja eredményül: 1, 2, 3vagy 4

range

Adott egész számból induló egész tömböt ad vissza.

range(<startIndex>, <count>)

Paraméter	Kötelező	Típus	Leírás
< startIndex>	Igen	Egész	Egész szám, amely első elemként indítja el a tömböt
< count>	Igen	Egész	A tömb egész számainak száma

Visszaadott érték	Típus	Leírás
[<tartomány-eredmény>]	Tömb	A megadott indextől kezdődő egész számokat tartalmazó tömb

Példa

Ez a példa létrehoz egy egész számot tartalmazó tömböt, amely a megadott indexből indul ki, és a megadott számú egész számmal rendelkezik:

range(1, 4)

És ezt az eredményt adja vissza: [1, 2, 3, 4]

replace

Cserélje le az alsztringet a megadott sztringre, és adja vissza az eredménysztringet. Ez a függvény megkülönbözteti a kis- és nagybetűk megkülönböztetettségét.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az a karakterlánc, amely tartalmazza a lecserélendő részsztringet.
< oldText>	Igen	Sztring	A lecserélendő karakterláncrész
< newText>	Igen	Sztring	A helyettesítő karakterlánc

Visszaadott érték	Típus	Leírás
< frissített szöveg>	Sztring	A részszöveg cseréje után frissített szöveg Ha a részszöveg nem található, térjen vissza az eredeti szöveggel.

Példa

Ez a példa megkeresi a "régi" részsztringet a "régi karakterláncban", és a "régi" helyett az "új"-at helyettesíti.

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

És ezt az eredményt adja vissza: "the new string"

skip

Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Tömb	Az a gyűjtemény, amelynek elemeit el szeretné távolítani
< count>	Igen	Egész	Az elöl eltávolítandó elemek számát jelentő pozitív egész szám.

Visszaadott érték	Típus	Leírás
[<frissített gyűjtemény>	Tömb	A megadott elemek eltávolítása után frissített gyűjtemény

Példa

Ez a példa eltávolít egy elemet, a szám 0-t a megadott tömb elejéről:

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

És visszaadja ezt a tömböt a fennmaradó elemekkel: [1,2,3]

split

Osszon fel egy sztringet minden előforduló adott elválasztónál, és a kapott részsztringeket a tömb elemeiként adja vissza. Az elválasztó jellemzően egyetlen karakter, de a többkarakteres elválasztójelek támogatottak.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	A karakterlánc, amelyet alsztringekre kell bontani
< Határoló>	Igen	Sztring	A határolóként használni kívánt sztring

Visszaadott érték	Típus	Leírás
[<substring1>,<substring2>,...]	Tömb	Az eredeti sztring részsztringeit tartalmazó tömb

Példa

Ez a példa egy tömböt ad vissza, amely a "a_b_c" sztring részsztringeit tartalmazza a "_" elválasztó alapján:

split('a_b_c', '_')

A visszaadott tömb a következő: ["a","b","c"]

startOfDay

Az időbélyeg napjának kezdetét adja vissza.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	A megadott időbélyeg, a nap nulla órájától kezdve

Példa

Ez a példa az időbélyeg napjának kezdetét találja:

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

És ezt az eredményt adja vissza: "2018-03-15T00:00:00.0000000Z"

startOfHour

Az óra kezdetét adja vissza egy időbélyeg alapján.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	A megadott időbélyeg, de az óra nulla percjelétől kezdve

Példa

Ez a példa az óra elejét keresi ennél az időbélyegnél.

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

És ezt az eredményt adja vissza: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Adja vissza a hónap kezdetét egy időbélyegből.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	A megadott időbélyeggel, de a hónap első napján és a nulladik óránál kezdve.

Példa

Ez a példa a hónap kezdetét adja vissza ehhez az időbélyeghez:

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

És ezt az eredményt adja vissza: "2018-03-01T00:00:00.0000000Z"

startsWith

Ellenőrizze, hogy egy sztring egy adott részsztringgel kezdődik-e. Igaz értéket ad vissza az alsztring megtalálásakor, vagy hamis értéket ad vissza, ha nem található. Ez a függvény nem tesz különbséget a kis- és nagybetűk között.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az ellenőrizni kívánt karakterlánc
< searchText>	Igen	Sztring	A keresendő kezdő karakterlánc

Visszaadott érték	Típus	Leírás
igaz vagy hamis	Logikai	Igaz értéket ad vissza, ha a kezdő részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1. példa

Ez a példa ellenőrzi, hogy a "hello world" karaktersorozat a "hello" részkaraktersorozattal kezdődik-e.

startsWith('hello world', 'hello')

És ezt az eredményt adja vissza: true

2\. példa

Ez a példa ellenőrzi, hogy a "hello world" sztring az "üdvözlés" részsztringgel kezdődik-e:

startsWith('hello world', 'greetings')

És ezt az eredményt adja vissza: false

string

Egy érték sztringverziójának visszaadása.

string(<value>)

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Bármely	Az átalakítandó érték

Visszaadott érték	Típus	Leírás
< karakterlánc-érték>	Sztring	A megadott érték sztringverziója

1\. példa

Ez a példa a sztringverziót hozza létre ehhez a számhoz:

string(10)

És ezt az eredményt adja vissza: "10"

2. példa

Ez a példa létrehoz egy sztringet a megadott JSON-objektumhoz, és a visszaper (\) karaktert használja a kettős idézőjel (") karakterként való megjelöléséhez.

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

És ezt az eredményt adja vissza: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Egy szám kivonásának eredményét adja vissza egy másik számból.

sub(<minuend>, <subtrahend>)

Paraméter	Kötelező	Típus	Leírás
< kisebbítendő>	Igen	Egész szám vagy lebegőpontos	Az a szám, amelyből kivonja a részösszeget
< kivonandó>	Igen	Egész szám vagy lebegőpontos	A minuendből kivonandó számot

Visszaadott érték	Típus	Leírás
< eredmény>	Egész szám vagy lebegőpontos	A második szám kivonásának eredménye az első számból

Példa

Ez a példa kivonja a második számot az első számból:

sub(10.3, .3)

És ezt az eredményt adja vissza: 10

substring

Egy sztringből karaktereket ad vissza, a megadott pozíciótól vagy indextől kezdve. Az indexértékek a 0 számmal kezdődnek.

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

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az a sztring, amelynek a karaktereit meg szeretné adni
< startIndex>	Igen	Egész	0-nál egyenlő vagy annál nagyobb pozitív szám, amelyet kiindulási pozícióként vagy indexértékként szeretne használni
< length> (hossz)	Igen	Egész	Az alsztringben használni kívánt karakterek pozitív száma

Visszaadott érték	Típus	Leírás
< részszűrési eredmény>	Sztring	A megadott számú karakterből álló részsztring, amely a forrássztring megadott indexpozíciójával kezdődik

Példa

Ez a példa a megadott sztringből létrehoz egy ötkarakteres részszúrást a 6-os indexértéktől kezdve:

substring('hello world', 6, 5)

És ezt az eredményt adja vissza: "world"

subtractFromTime

Vonjon ki több időegységet egy időbélyegből. Lásd még : getPastTime.

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

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeget tartalmazó karakterlánc
< interval>	Igen	Egész	A kivonáshoz megadott időegységek száma
< timeUnit>	Igen	Sztring	Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< frissített időbélyeg>	Sztring	Az időbélyegző csökkentve a megadott számú időegységgel

Példa 1

Ez a példa egy napot von ki ebből az időbélyegből:

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

És ezt az eredményt adja vissza: "2018-01-01T00:00:00:0000000Z"

2\. példa

Ez a példa egy napot von ki ebből az időbélyegből:

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

Ezt az eredményt az opcionális "D" formátummal adja vissza: "Monday, January, 1, 2018"

take

Elemeket ad vissza a gyűjtemény elejéről.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény>	Igen	Sztring vagy tömb	A gyűjtemény, amelynek elemeit szeretné
< count>	Igen	Egész	Pozitív egész szám az elölről kívánt elemek számához

Visszaadott érték	Típus	Leírás
< részelem> vagy [<részelem>]	Sztring vagy tömb, illetve	Olyan sztring vagy tömb, amely az eredeti gyűjtemény elejéről vett elemek megadott számát tartalmazza

Példa

Ezek a példák a megadott számú elemet veszik ki a gyűjtemények elejéről.

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

És adja vissza az alábbi eredményeket:

• Első példa: "abc"
• Második példa: [0, 1, 2]

ticks

ticks Adott időbélyeg tulajdonságértékének visszaadása. A tikk egy 100 nanoszekundumos intervallum.

ticks('<timestamp>')

Paraméter	Kötelező	Típus	Leírás
< Időbélyeg>	Igen	Sztring	Az időbélyeg karakterlánca

Visszaadott érték	Típus	Leírás
< ticks-number>	Egész szám	A Gergely-naptárban 0001. január 1-je éjfél óta eltelt időegységek száma a megadott időbélyeghez képest

toLower

Kisbetűs karakterláncot ad vissza. Ha a sztring egyik karakterének nincs kisbetűs verziója, az a visszaadott sztringben változatlan marad.

toLower('<text>')

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	A kisbetűs formátumban visszaadandó karakterlánc

Visszaadott érték	Típus	Leírás
< kisbetűs szöveg>	Sztring	Az eredeti karakterlánc kisbetűs formátumban

Példa

Ez a példa kisbetűssé alakítja a karakterláncot:

toLower('Hello World')

És ezt az eredményt adja vissza: "hello world"

toUpper

Karakterláncot ad vissza nagybetűs formátumban. Ha a sztring egyik karakterének nincs nagybetűs verziója, az a visszaadott sztringben változatlan marad.

toUpper('<text>')

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Visszaadandó karakterlánc nagybetűs formátumban

Visszaadott érték	Típus	Leírás
< nagybetűs szöveg>	Sztring	Az eredeti karakterlánc nagybetűs alakban

Példa

Ez a példa a karakterláncot nagybetűssé alakítja át.

toUpper('Hello World')

És ezt az eredményt adja vissza: "HELLO WORLD"

trim

Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

trim('<text>')

Paraméter	Kötelező	Típus	Leírás
< text>	Igen	Sztring	Az a karakterlánc, amely vezető és záró szóköz eltávolítására szolgál.

Visszaadott érték	Típus	Leírás
< frissített szöveg>	Sztring	Az eredeti karakterlánc frissített verziója kezdő és záró szóköz nélkül.

Példa

Ez a példa eltávolítja a kezdő és záró szóközöket a " Hello World " sztringből.

trim(' Hello World  ')

És ezt az eredményt adja vissza: "Hello World"

union

Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények összes elemét tartalmazza. Annak érdekében, hogy megjelenjen az eredményben, egy elem megjelenhet bármely gyűjteményben, amely át lett adva ennek a függvénynek. Ha egy vagy több elem neve megegyezik, az eredményben az utolsó ilyen nevű elem jelenik meg.

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

Paraméter	Kötelező	Típus	Leírás
< gyűjtemény1>, <gyűjtemény2>, ...	Igen	Tömb vagy objektum, de nem mindkettő	Azok a gyűjtemények, amelyekből az összes elemet meg szeretné kapni

Visszaadott érték	Típus	Leírás
< frissítettGyűjtemény>	Tömb vagy objektum, illetve	Gyűjtemény a megadott gyűjtemények összes elemével – nincs ismétlődés

Példa

Ez a példa lekéri ezeknek a gyűjteményeknek az összes elemét.

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

És ezt az eredményt adja vissza: [1, 2, 3, 10, 101]

uriComponent

Egy sztring egységes erőforrás-azonosító (URI) kódolású változatát adja vissza az URL-cím szempontjából nem biztonságos karakterek escape karakterekre való lecserélésével. Használja ezt a függvényt a kódoltUriComponent() helyett. Bár mindkét függvény ugyanúgy működik, uriComponent() előnyben részesítjük.

uriComponent('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	Az URI-kódolású formátumba konvertálandó karakterlánc

Visszaadott érték	Típus	Leírás
< kódolt-uri>	Sztring	Az URI-kódolású karakterlánc escape karakterekkel

Példa

Ez a példa egy URI-kódolású verziót hoz létre ehhez a sztringhez:

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

És ezt az eredményt adja vissza: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Adja vissza az egységes erőforrás-azonosító (URI) összetevő bináris verzióját.

uriComponentToBinary('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A konvertálni kívánt URI-kódolt sztring

Visszaadott érték	Típus	Leírás
< binary-for-encoded-uri>	Sztring	Az URI-kódolt sztring bináris verziója. A bináris tartalom base64-kódolású, és azt a $content jelzi.

Példa

Ez a példa létrehozza az URI-kódolt sztring bináris verzióját:

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

És ezt az eredményt adja vissza:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Az egységes erőforrás-azonosító (URI) kódolt sztring sztringverzióját adja vissza, amely hatékonyan dekódolja az URI-kódolt sztringet.

uriComponentToString('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A dekódolni kívánt URI-kódolt karakterlánc

Visszaadott érték	Típus	Leírás
< dekódolt-uri>	Sztring	Az URI kódolású sztring dekódolt verziója

Példa

Ez a példa létrehozza a dekódolt sztringverziót ehhez az URI-kódolt sztringhez:

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

És ezt az eredményt adja vissza: "https://contoso.com"

utcNow

Adja vissza az aktuális időbélyeget.

utcNow('<format>')

Alternatívaként megadhat egy másik formátumot a <formátum> paraméter segítségével.

Paraméter	Kötelező	Típus	Leírás
< format>	Nem	Sztring	Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Visszaadott érték	Típus	Leírás
< aktuális időbélyeg>	Sztring	Az aktuális dátum és idő

1\. példa

Tegyük fel, hogy ma 2018. április 15-én 13:00:00-kor van. Ez a példa az aktuális időbélyeget kapja:

utcNow()

És ezt az eredményt adja vissza: "2018-04-15T13:00:00.0000000Z"

2\. példa

Tegyük fel, hogy ma 2018. április 15-én 13:00:00-kor van. Ez a példa az aktuális időbélyeget a választható "D" formátummal kapja meg:

utcNow('D')

És ezt az eredményt adja vissza: "Sunday, April 15, 2018"

xml

JSON-objektumot tartalmazó sztring XML-verzióját adja vissza.

xml('<value>')

Paraméter	Kötelező	Típus	Leírás
< érték>	Igen	Sztring	A sztring, amely tartalmazza az átalakítandó JSON-objektumot A JSON-objektumnak csak egy gyökértulajdonságúnak kell lennie, amely nem lehet tömb. Használja a fordított perjelet (\) a kettős idézőjel (").

Visszaadott érték	Típus	Leírás
< xml-verzió>	Objektum	A megadott sztringhez vagy JSON-objektumhoz tartozó kódolt XML

1. példa

Ez a példa létrehozza a sztring XML-verzióját, amely egy JSON-objektumot tartalmaz:

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

És visszaadja ezt az eredmény XML-t:

<name>Sophia Owen</name>

2. Példa

Tegyük fel, hogy rendelkezik ezzel a JSON-objektummal:

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

Ez a példa létrehoz egy XML-fájlt egy olyan sztringhez, amely a következő JSON-objektumot tartalmazza:

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

Az eredmény XML-ének visszaadása:

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

xpath

Ellenőrizze az XML-ben az XPath (XML Path Language) kifejezésnek megfelelő csomópontokat vagy értékeket, és adja vissza az egyező csomópontokat vagy értékeket. Egy XPath-kifejezés vagy csak "XPath" segít navigálni egy XML-dokumentumstruktúra között, hogy kijelölhesse a csomópontokat vagy számítási értékeket az XML-tartalomban.

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

Paraméter	Kötelező	Típus	Leírás
< xml>	Igen	Bármely	Az XPath-kifejezésértéknek megfelelő csomópontok vagy értékek keresésére szolgáló XML-sztring
< xpath>	Igen	Bármely	Az egyező XML-csomópontok vagy -értékek megkeresésére használt XPath-kifejezés

Visszaadott érték	Típus	Leírás
< xml-node>	XML	XML-csomópont, ha csak egyetlen csomópont felel meg a megadott XPath-kifejezésnek
< érték>	Bármely	Xml-csomópont értéke, ha csak egyetlen érték felel meg a megadott XPath-kifejezésnek
[<xml-node1>, <xml-node2>, ...] -or- [<érték1>, <érték2>, ...]	Tömb	A megadott XPath-kifejezésnek megfelelő XML-csomópontokat vagy értékeket tartalmazó tömb

1. példa

Az 1. példában ez a példa megkeresi a <count></count> csomópontnak megfelelő csomópontokat, és hozzáadja ezeket a csomópontértékeket a sum() függvényhez:

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

És ezt az eredményt adja vissza: 30

2. példa

Ebben a példában mindkét kifejezés megkeresi a <location></location> csomópontnak megfelelő csomópontokat a megadott argumentumokban, amelyek névtérrel rendelkező XML-t tartalmaznak. A kifejezések a fordított perjel (\) karaktert használják menekülési karakterként a kettős idézőjel (") esetén.

• 1. kifejezés

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

• Expression 2

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

Az alábbi argumentumok:

• Ez az XML,amely tartalmazza az XML-dokumentum névterét: xmlns="http://contoso.com"

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

• Itt bármelyik XPath-kifejezés:

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

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

Az alábbi eredménycsomópont felel meg a csomópontnak <location></location> :

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

3. példa

Az előző 3. példához kapcsolódva ez a példa megkeresi a <location></location> csomópont értékét.

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

És ezt az eredményt adja vissza: "Paris"

Feljegyzés

Megjegyzéseket fűzhet az adatfolyam-kifejezésekhez, a folyamatkifejezésekhez azonban nem.

Kapcsolódó tartalom

A kifejezésekben használható rendszerváltozók listáját a Rendszerváltozók című témakörben találja.