Výrazy a funkce v Azure Data Factory a Azure synapse Analytics
PLATÍ PRO:
Azure Data Factory
Azure Synapse Analytics
Tento článek poskytuje podrobné informace o výrazech a funkcích, které podporuje Azure Data Factory a Azure synapse Analytics.
Výrazy
Hodnoty JSON v definici můžou být literály nebo výrazy, které se vyhodnocují za běhu. Například:
"name": "value"
nebo
"name": "@pipeline().parameters.password"
Výrazy se můžou objevit kdekoli v hodnotě řetězce JSON a vždycky mají za následek jinou hodnotu JSON. Pokud je hodnotou JSON výraz, tělo výrazu se extrahuje odebráním znaku při přihlášení ( @ ). Pokud je vyžadován řetězcový literál, který začíná @ , musí být uvozen pomocí @ @ . Následující příklady znázorňují, jak jsou výrazy vyhodnocovány.
| Hodnota JSON | Výsledek |
|---|---|
| ukazatelů | Vrátí se znaky Parameters. |
| "Parameters [1]" | Vrátí se znaky Parameters [1]. |
| "@@" | Vrátí se 1 řetězec znaků, který obsahuje znak @ . |
| " @" | Je vrácen 2 řetězec znaků, který obsahuje znak ' @ '. |
Výrazy lze také zobrazit uvnitř řetězců pomocí funkce s názvem interpolace řetězce , kde jsou výrazy zabaleny @{ ... } . Příklad: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"
Při použití řetězcové interpolace je výsledkem vždy řetězec. Řekněme, že jsem definoval (a) jako myNumber 42 myString foo :
| Hodnota JSON | Výsledek |
|---|---|
| " @ Pipeline (). Parameters. MyString" | Vrátí hodnotu foo jako řetězec. |
| " @ {Pipeline (). Parameters. MyString}" | Vrátí hodnotu foo jako řetězec. |
| " @ Pipeline (). Parameters. MyNumber" | Vrátí hodnotu 42 jako číslo. |
| " @ {Pipeline (). Parameters. MyNumber}" | Vrátí hodnotu 42 jako řetězec. |
| "Odpověď je: @ {Pipeline (). Parameters. myNumber}" | Vrátí řetězec Answer is: 42 . |
| " @ Concat (' Answer: '; String (Pipeline (). Parameters. MyNumber))" | Vrátí řetězec Answer is: 42 |
| "Odpověď je: @ @ {Pipeline (). Parameters. MyNumber}" | Vrátí řetězec Answer is: @{pipeline().parameters.myNumber} . |
V aktivitách toku řízení, jako je aktivita ForEach, můžete poskytnout pole, které se má iterovat pro položky vlastností a použít @item () pro iteraci v rámci jednoho výčtu v aktivitě foreach. Například pokud je položka pole: [1, 2, 3], @item () vrátí 1 v první iteraci, 2 v druhé iteraci a 3 v třetí iteraci. Můžete také použít @range výraz (0, 10) jako výraz pro iteraci desetkrát počínaje 0 končící hodnotou 9.
Můžete použít @activity (' Activity name ') k zachycení výstupu aktivity a rozhodování. Vezměte v úvahu aktivitu webu nazvanou WEB1. Pro vložení výstupu první aktivity do těla druhé by výraz vypadal obvykle takto: @activity (' WEB1 '). Output nebo @activity (' WEB1 '). Output. data nebo něco podobného, v závislosti na tom, jaký výstup první aktivity vypadá jako.
Příklady
Příklad komplexního výrazu
Následující příklad ukazuje komplexní příklad, který odkazuje na hloubkové dílčí pole výstupu aktivity. Chcete-li odkazovat na parametr kanálu, který je vyhodnocen jako dílčí pole, použijte syntaxi [] namísto operátoru tečka (.) (jako v případě dílčího pole1 a subfield2) jako součást výstupu aktivity.
@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*
Vytváření souborů dynamicky a jejich pojmenování je běžný vzor. Podíváme se na několik příkladů dynamického pojmenovávání souborů.
Datum připojení k názvu souboru:
@concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))Připojit datum a čas v časovém pásmu zákazníka:
@concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))Čas připojení triggeru:
@concat('Test_', pipeline().TriggerTime)výstup vlastního názvu souboru v mapování dat Flow při uvádění do jednoho souboru s datem:
'Test_' + toString(currentDate()) + '.csv'
Ve výše uvedených případech se 4 dynamické názvy souborů vytvářejí od Test_.
Editor dynamického obsahu
Editor dynamického obsahu automaticky řídí znaky v obsahu při dokončení úprav. Například následující obsah v Editoru obsahu je interpolace řetězce se dvěma funkcemi výrazu.
{
"type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
"name": "@{toUpper('myData')}"
}
Editor dynamického obsahu převádí obsah nad rámec na výraz "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}" . Výsledek tohoto výrazu je řetězec formátu JSON, který se zobrazil níže.
{
"type": "Table",
"name": "MYDATA"
}
Datová sada s parametrem
V následujícím příkladu převezme BlobDataset parametr s názvem path. Jeho hodnota se používá k nastavení hodnoty vlastnosti FolderPath pomocí výrazu: dataset().path .
{
"name": "BlobDataset",
"properties": {
"type": "AzureBlob",
"typeProperties": {
"folderPath": "@dataset().path"
},
"linkedServiceName": {
"referenceName": "AzureStorageLinkedService",
"type": "LinkedServiceReference"
},
"parameters": {
"path": {
"type": "String"
}
}
}
}
Kanál s parametrem
V následujícím příkladu kanál přijímá parametry inputPath a outputPath . Cesta pro parametrizovanou datovou sadu objektů BLOB je nastavena pomocí hodnot těchto parametrů. Zde použitá syntaxe je: 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"
}
}
}
}
Nahrazení speciálních znaků
Editor dynamického obsahu automaticky řídí znaky, jako jsou dvojité uvozovky, zpětné lomítko v obsahu při dokončení úprav. To způsobuje problémy, pokud chcete nahradit posun řádku nebo tabulátor pomocí \n, \t ve funkci Replace (). Můžete upravit dynamický obsah v zobrazení kódu pro odebrání nadbytečného výrazu ve výrazu, nebo můžete postupovat podle následujících kroků pro nahrazení speciálních znaků pomocí jazyka výrazů:
- Kódování adresy URL proti původní hodnotě řetězce
- Nahraďte řetězec kódovaný v adrese URL, například posun řádku (% 0A), znak návratu na začátek řádku (% 0D), horizontální kartu (%09).
- Dekódování adresy URL
Například proměnná CompanyName s znakem nového řádku ve své hodnotě, výraz @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) může odebrat znak nového řádku.
Contoso-
Corporation
Řídicí znak jednoduché uvozovky
Funkce výrazu používají jednoduché uvozovky pro parametry řetězcové hodnoty. Pomocí dvou jednoduchých uvozovek můžete v řetězcových funkcích řídicího znaku. Například výraz @concat('Baba', '''s ', 'book store') bude vrácen pod výsledek.
Baba's book store
Kurz
Tento kurz vás provede procesem předávání parametrů mezi kanálem a aktivitou a mezi aktivitami. V tomto kurzu se konkrétně předvádí postup pro Azure Data Factory, i když jsou kroky pro pracovní prostor synapse téměř ekvivalentní, ale s mírně odlišným uživatelským rozhraním.
Functions
Můžete volat funkce v rámci výrazů. Následující části obsahují informace o funkcích, které lze použít ve výrazu.
Datové funkce
| Funkce data a času | Úkol |
|---|---|
| addDays | Přidání počtu dní do časového razítka. |
| addHours | Přidejte do časového razítka několik hodin. |
| addMinutes | Přidejte do časového razítka počet minut. |
| addSeconds | Přidejte do časového razítka počet sekund. |
| addToTime | Přidání počtu časových jednotek k časovému razítku. Viz také getFutureTime. |
| convertFromUtc | Převeďte časové razítko ze koordinovaného světového času (UTC) na cílové časové pásmo. |
| convertTimeZone | Převede časové razítko ze zdrojového časového pásma na cílové časové pásmo. |
| convertToUtc | Převede časové razítko ze zdrojového časového pásma na koordinovaný světový čas (UTC). |
| dayOfMonth | Vrátí den v měsíci součásti z časového razítka. |
| dayOfWeek | Vrátí den v týdnu komponenty z časového razítka. |
| dayOfYear | Vrátí den komponenty v roce z časového razítka. |
| formatDateTime | Vrátí časové razítko jako řetězec v volitelném formátu. |
| getFutureTime | Vrátí aktuální časové razítko plus zadané časové jednotky. Viz také addToTime. |
| getPastTime | Vrátí aktuální časové razítko minus zadané časové jednotky. Viz také subtractFromTime. |
| startOfDay | Vrátí začátek dne pro časové razítko. |
| startOfHour | Vrátí začátek hodiny pro časové razítko. |
| startOfMonth | Vrátí začátek měsíce pro časové razítko. |
| subtractFromTime | Odečte počet časových jednotek od časového razítka. Viz také getPastTime. |
| Ticks | Vrátí ticks hodnotu vlastnosti pro zadané časové razítko. |
| utcNow | Vrátí aktuální časové razítko jako řetězec. |
Funkce řetězců
Chcete-li pracovat s řetězci, můžete použít tyto řetězcové funkce a také některé funkce kolekce. Funkce řetězce fungují pouze v řetězcích.
| Funkce String | Úkol |
|---|---|
| spojuje | Kombinací dvou nebo více řetězců a vrácení kombinovaného řetězce. |
| endsWith | Zkontroluje, zda řetězec končí zadaným podřetězcem. |
| guid | Vygeneruje globálně jedinečný identifikátor (GUID) jako řetězec. |
| indexOf | Vrátí počáteční pozici podřetězce. |
| lastIndexOf | Vrátí počáteční pozici pro poslední výskyt podřetězce. |
| náhrady | Nahraďte podřetězec zadaným řetězcem a vraťte aktualizovaný řetězec. |
| rozdělení | Vrátí pole, které obsahuje podřetězce oddělené čárkami, z většího řetězce na základě zadaného oddělovače v původním řetězci. |
| startsWith | Kontroluje, zda řetězec začíná konkrétním podřetězcem. |
| podřetězec | Vrátí znaky z řetězce počínaje od zadané pozice. |
| toLower | Vrátí řetězec ve formátu s malými písmeny. |
| toUpper | Vrátí řetězec ve formátu velkými písmeny. |
| sklon | Odstraňte úvodní a koncové mezery z řetězce a vraťte aktualizovaný řetězec. |
Funkce kolekcí
Chcete-li pracovat s kolekcemi, všeobecně se jedná o pole, řetězce a někdy slovníky, můžete použít tyto funkce kolekce.
| Funkce kolekce | Úkol |
|---|---|
| zobrazí | Kontroluje, zda kolekce obsahuje konkrétní položku. |
| empty | Zkontroluje, jestli je kolekce prázdná. |
| první | Vrátí první položku z kolekce. |
| průnik | Vrátí kolekci, která má v zadaných kolekcích jenom společné položky. |
| zúčastnit | Vrátí řetězec, který obsahuje všechny položky z pole oddělené zadaným znakem. |
| posledního | Vrátí poslední položku z kolekce. |
| length | Vrátí počet položek v řetězci nebo poli. |
| přímo | Odebere položky z přední části kolekce a vrátí všechny ostatní položky. |
| nezbytná | Vrátí položky od začátku kolekce. |
| sjednocovací | Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí. |
Logické funkce
Tyto funkce jsou užitečné v rámci podmínek, které je možné použít k vyhodnocení jakéhokoli typu logiky.
| Funkce logického porovnání | Úkol |
|---|---|
| and | Ověřte, zda jsou všechny výrazy pravdivé. |
| rovná | Zkontroluje, jestli jsou obě hodnoty ekvivalentní. |
| greater | Ověřte, zda je první hodnota větší než druhá hodnota. |
| greaterOrEquals | Ověřte, zda je první hodnota větší než nebo rovna druhé hodnotě. |
| Přestože | Zkontroluje, jestli je výraz pravdivý, nebo nepravdivý. Na základě výsledku vrátí zadanou hodnotu. |
| tolik | Ověřte, zda je první hodnota menší než druhá hodnota. |
| lessOrEquals | Ověřte, zda je první hodnota menší nebo rovna druhé hodnotě. |
| mění | Zkontroluje, jestli je výraz nepravdivý. |
| nebo | Ověřte, zda je alespoň jeden výraz pravdivý. |
Převodní funkce
Tyto funkce slouží k převodu mezi jednotlivými nativními typy v jazyku:
- řetězec
- integer
- float
- boolean
- řadách
- slovníky
| Převodní funkce | Úkol |
|---|---|
| array | Vrátí pole z jednoho zadaného vstupu. Více vstupů naleznete v tématu createArray. |
| base64 | Vrátí verzi kódovanou pro řetězec ve formátu base64. |
| base64ToBinary | Vrátí binární verzi řetězce zakódovaného ve formátu base64. |
| base64ToString | Vrátí verzi řetězce pro řetězec kódovaný v kódování Base64. |
| tvaru | Vrátí binární verzi pro vstupní hodnotu. |
| bool | Vrátí logickou verzi pro vstupní hodnotu. |
| COALESCE | Vrátí první hodnotu, která není null, z jednoho nebo více parametrů. |
| createArray | Vrátí pole z více vstupů. |
| dataUri | Vrátí identifikátor URI dat pro vstupní hodnotu. |
| dataUriToBinary | Vrátí binární verzi pro identifikátor URI dat. |
| dataUriToString | Vrátí verzi řetězce pro identifikátor URI dat. |
| decodeBase64 | Vrátí verzi řetězce pro řetězec kódovaný v kódování Base64. |
| decodeDataUri | Vrátí binární verzi pro identifikátor URI dat. |
| decodeURIComponent – | Vrátí řetězec, který nahradí řídicí znaky pomocí dekódování verzí. |
| encodeURIComponent – | Vrátí řetězec, který nahradí URL – nebezpečné znaky pomocí řídicích znaků. |
| float | Vrátí číslo s plovoucí desetinnou čárkou pro vstupní hodnotu. |
| int | Vrátí celočíselnou verzi řetězce. |
| JSON | Vrátí hodnotu nebo objekt typu JavaScript Object Notation (JSON) pro řetězec nebo XML. |
| řetězec | Vrátí verzi řetězce pro vstupní hodnotu. |
| uriComponent | Vrátí verzi kódovanou identifikátorem URI pro vstupní hodnotu nahrazením znaků, které nejsou bezpečné, pomocí řídicích znaků. |
| uriComponentToBinary | Vrátí binární verzi řetězce zakódovaného identifikátorem URI. |
| uriComponentToString | Vrátí verzi řetězce pro řetězec kódovaný pomocí identifikátoru URI. |
| XML | Vrátí verzi XML pro řetězec. |
| cestou | Zkontroluje XML pro uzly nebo hodnoty, které odpovídají výrazu XPath (XML Path Language), a vrátí odpovídající uzly nebo hodnoty. |
Matematické funkce
Tyto funkce lze použít pro oba typy čísel: celá čísla a Floaty.
| Funkce Math | Úkol |
|---|---|
| add | Vrátí výsledek z přidání dvou čísel. |
| div | Vrátí výsledek z dělení dvou čísel. |
| počet | Vrátí nejvyšší hodnotu ze sady čísel nebo pole. |
| min | Vrátí nejnižší hodnotu ze sady čísel nebo pole. |
| střední | Vrátí zbytek po dělení dvou čísel. |
| mul | Vrátí produkt pro vynásobení dvou čísel. |
| funkcí | Vrátí náhodné celé číslo ze zadaného rozsahu. |
| oblasti | Vrátí celočíselné pole, které začíná zadaným celým číslem. |
| jednotk | Vrátí výsledek odečtením druhého čísla od prvního čísla. |
Odkaz na funkci
V této části jsou uvedeny všechny dostupné funkce v abecedním pořadí.
add
Vrátí výsledek z přidání dvou čísel.
add(<summand_1>, <summand_2>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <summand_1> <summand_2> | Yes | Integer, float nebo mixed | Čísla, která mají být přidána |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <výsledek – součet> | Integer nebo float | Výsledek přidání zadaných čísel |
Příklad
V tomto příkladu se přidají zadaná čísla:
add(1, 1.5)
A vrátí tento výsledek: 2.5
addDays
Přidání počtu dní do časového razítka.
addDays('<timestamp>', <days>, '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <denní> | Yes | Integer | Kladný nebo záporný počet dní, které se mají přidat |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Časové razítko plus zadaný počet dní |
Příklad 1
Tento příklad přidá do zadaného časového razítka 10 dní:
addDays('2018-03-15T13:00:00Z', 10)
A vrátí tento výsledek: "2018-03-25T00:00:0000000Z"
Příklad 2
Tento příklad odečte pět dní od zadaného časového razítka:
addDays('2018-03-15T00:00:00Z', -5)
A vrátí tento výsledek: "2018-03-10T00:00:0000000Z"
addHours
Přidejte do časového razítka několik hodin.
addHours('<timestamp>', <hours>, '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <hodin> | Yes | Integer | Kladný nebo záporný počet hodin, které se mají přidat |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Časové razítko plus zadaný počet hodin |
Příklad 1
Tento příklad přidá 10 hodin do zadaného časového razítka:
addHours('2018-03-15T00:00:00Z', 10)
A vrátí tento výsledek: "2018-03-15T10:00:0000000Z"
Příklad 2
Tento příklad odečte pět hodin od zadaného časového razítka:
addHours('2018-03-15T15:00:00Z', -5)
A vrátí tento výsledek: "2018-03-15T10:00:0000000Z"
addMinutes
Přidejte do časového razítka počet minut.
addMinutes('<timestamp>', <minutes>, '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <minuty> | Yes | Integer | Kladný nebo záporný počet minut, který se má přidat |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Časové razítko plus zadaný počet minut |
Příklad 1
Tento příklad přidá do zadaného časového razítka 10 minut:
addMinutes('2018-03-15T00:10:00Z', 10)
A vrátí tento výsledek: "2018-03-15T00:20:00.0000000Z"
Příklad 2
Tento příklad odečte pět minut od zadaného časového razítka:
addMinutes('2018-03-15T00:20:00Z', -5)
A vrátí tento výsledek: "2018-03-15T00:15:00.0000000Z"
addSeconds
Přidejte do časového razítka počet sekund.
addSeconds('<timestamp>', <seconds>, '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <Second> | Yes | Integer | Kladný nebo záporný počet sekund, které se mají přidat |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Časové razítko plus zadaný počet sekund |
Příklad 1
Tento příklad přidá 10 sekund do zadaného časového razítka:
addSeconds('2018-03-15T00:00:00Z', 10)
A vrátí tento výsledek: "2018-03-15T00:00:10.0000000Z"
Příklad 2
Tento příklad odečte pět sekund na zadané časové razítko:
addSeconds('2018-03-15T00:00:30Z', -5)
A vrátí tento výsledek: "2018-03-15T00:00:25.0000000Z"
addToTime
Přidání počtu časových jednotek k časovému razítku. Viz také getFutureTime ().
addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <doba> | Yes | Integer | Počet zadaných časových jednotek, které se mají přidat |
| <timeUnit> | Ano | Řetězec | Jednotka času, která se má použít v intervalu: "druhé", "Minute", "hodina", "den", "týden", "měsíc", "rok" |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Časové razítko plus zadaný počet časových jednotek |
Příklad 1
Tento příklad přidá jeden den do zadaného časového razítka:
addToTime('2018-01-01T00:00:00Z', 1, 'Day')
A vrátí tento výsledek: "2018-01-02T00:00:00.0000000Z"
Příklad 2
Tento příklad přidá jeden den do zadaného časového razítka:
addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')
A vrátí výsledek pomocí volitelného formátu "D": "Tuesday, January 2, 2018"
a
Ověřte, zda jsou oba výrazy pravdivé. Vrátí hodnotu true, pokud mají oba výrazy hodnotu true, nebo vrátí hodnotu false, pokud je alespoň jeden výraz nepravdivý.
and(<expression1>, <expression2>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <výraz1>, <Výraz2> | Yes | Logická hodnota | Výrazy, které mají být zkontrolovány |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud jsou oba výrazy pravdivé. Vrátí hodnotu false, pokud je alespoň jeden výraz nepravdivý. |
Příklad 1
Tyto příklady kontrolují, zda jsou zadané logické hodnoty pravdivé:
and(true, true)
and(false, true)
and(false, false)
A vrátí tyto výsledky:
- První příklad: oba výrazy mají hodnotu true, takže se vrátí
true. - Druhý příklad: jeden výraz má hodnotu NEPRAVDA, takže se vrátí
false. - Třetí příklad: oba výrazy mají hodnotu false, takže se vrátí
false.
Příklad 2
V těchto příkladech se zkontroluje, jestli jsou zadané výrazy pravdivé:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
A vrátí tyto výsledky:
- První příklad: Oba výrazy jsou pravdivé, takže vrátí
true. - Druhý příklad: Jeden výraz je nepravdivý, proto vrátí
false. - Třetí příklad: Oba výrazy mají hodnotu false, proto vrátí
falsehodnotu .
array
Vrátí pole z jednoho zadaného vstupu. Více vstupů najdete v tématu createArray().
array('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Řetězec pro vytvoření pole |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| [<value>] | Pole | Pole, které obsahuje jeden zadaný vstup |
Příklad
Tento příklad vytvoří pole z řetězce "hello":
array('hello')
A vrátí tento výsledek: ["hello"]
base64
Vrátí pro řetězec verzi s kódováním base64.
base64('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Vstupní řetězec |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Řetězec base64> | Řetězec | Verze zakódovaná v kódování Base64 pro vstupní řetězec |
Příklad
Tento příklad převede řetězec "hello" na řetězec s kódováním base64:
base64('hello')
A vrátí tento výsledek: "aGVsbG8="
base64ToBinary
Vrátí binární verzi řetězce s kódováním base64.
base64ToBinary('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Řetězec s kódováním base64, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <binary-for-base64-string> | Řetězec | Binární verze řetězce s kódováním base64 |
Příklad
Tento příklad převede řetězec "aGVsbG8=" v kódování base64 na binární řetězec:
base64ToBinary('aGVsbG8=')
A vrátí tento výsledek:
"0110000101000111010101100111001101100010010001110011100000111101"
base64ToString
Vrátí verzi řetězce pro řetězec s kódováním base64 a efektivně dekóduje řetězec base64.
Tuto funkci použijte místo decodeBase64().
Přestože obě funkce fungují stejným způsobem, base64ToString() je upřednostňován.
base64ToString('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Řetězec s kódováním base64 pro dekódování |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <dekódovaný řetězec base64> | Řetězec | Verze řetězce pro řetězec s kódováním base64 |
Příklad
Tento příklad převede řetězec "aGVsbG8=" zakódovaný v kódování base64 na řetězec:
base64ToString('aGVsbG8=')
A vrátí tento výsledek: "hello"
binární
Vrátí binární verzi řetězce.
binary('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Řetězec, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <binary-for-input-value> | Řetězec | Binární verze zadaného řetězce |
Příklad
Tento příklad převede řetězec "Hello" na binární řetězec:
binary('hello')
A vrátí tento výsledek:
"0110100001100101011011000110110001101111"
bool
Vrátí logickou verzi pro hodnotu.
bool(<value>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Yes | Všechny | Hodnota, která se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Logická verze zadané hodnoty |
Příklad
Tyto příklady převádějí zadané hodnoty na logické hodnoty:
bool(1)
bool(0)
A vrátí tyto výsledky:
- První příklad:
true - Druhý příklad:
false
COALESCE
Vrátí první hodnotu, která není null, z jednoho nebo více parametrů. Prázdné řetězce, prázdné pole a prázdné objekty nejsou null.
coalesce(<object_1>, <object_2>, ...)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <object_1> <object_2>... | Yes | Libovolný, můžou kombinovat typy. | Jedna nebo více položek pro kontrolu hodnoty null |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <první položka, která není null,> | Všechny | První položka nebo hodnota, která není null. Pokud jsou všechny parametry null, tato funkce vrátí hodnotu null. |
Příklad
Tyto příklady vrátí první hodnotu jinou než null ze zadaných hodnot nebo hodnotu null, pokud jsou všechny hodnoty null:
coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)
A vrátí tyto výsledky:
- První příklad:
true - Druhý příklad:
"hello" - Třetí příklad:
null
concat
Kombinací dvou nebo více řetězců a vrácení kombinovaného řetězce.
concat('<text1>', '<text2>', ...)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <text1>, <Text2>,... | Ano | Řetězec | Aspoň dva řetězce, které se mají zkombinovat |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <text1text2...> | Řetězec | Řetězec vytvořený z kombinovaných vstupních řetězců |
Příklad
V tomto příkladu jsou kombinovány řetězce "Hello" a "World":
concat('Hello', 'World')
A vrátí tento výsledek: "HelloWorld"
obsahuje
Kontroluje, zda kolekce obsahuje konkrétní položku. Vrátí hodnotu true, pokud se položka najde, nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce rozlišuje velká a malá písmena.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
Konkrétně tato funkce funguje na těchto typech kolekcí:
- Řetězec pro vyhledání podřetězce
- Pole , ve kterém se má najít hodnota
- Slovník , ve kterém se má najít klíč
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Řetězec, pole nebo slovník | Kolekce, která má být zkontrolována |
| <osa> | Yes | Řetězec, pole nebo slovník, v uvedeném pořadí | Položka, která se má najít |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud se položka najde. Pokud se nenajde, vrátí se hodnota false. |
Příklad 1
Tento příklad zkontroluje řetězec "Hello World" pro podřetězec "World" a vrátí hodnotu true:
contains('hello world', 'world')
Příklad 2
Tento příklad zkontroluje řetězec "Hello World" pro podřetězec "Universe" a vrátí hodnotu false:
contains('hello world', 'universe')
convertFromUtc
Převeďte časové razítko ze koordinovaného světového času (UTC) na cílové časové pásmo.
convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec obsahující časové razítko |
| <Destinationtimezone> | Ano | Řetězec | Název cílového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci. |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <převedené časové razítko> | Řetězec | Časové razítko převedené na cílové časové pásmo |
Příklad 1
Tento příklad převede časové razítko na zadané časové pásmo:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')
A vrátí tento výsledek: "2018-01-01T00:00:00Z"
Příklad 2
Tento příklad převede časové razítko na zadané časové pásmo a formát:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')
A vrátí tento výsledek: "Monday, January 1, 2018"
convertTimeZone
Převeďte časové razítko ze zdrojového časového pásma na cílové časové pásmo.
convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec obsahující časové razítko |
| <Sourcetimezone> | Ano | Řetězec | Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci. |
| <Destinationtimezone> | Ano | Řetězec | Název cílového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci. |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <převedené časové razítko> | Řetězec | Časové razítko převedené na cílové časové pásmo |
Příklad 1
Tento příklad převede zdrojové časové pásmo na cílové časové pásmo:
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')
A vrátí tento výsledek: "2018-01-01T00:00:00.0000000"
Příklad 2
Tento příklad převede časové pásmo na zadané časové pásmo a formát:
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')
A vrátí tento výsledek: "Monday, January 1, 2018"
convertToUtc
Převeďte časové razítko ze zdrojového časového pásma na koordinovaný univerzální čas (UTC).
convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec obsahující časové razítko |
| <Sourcetimezone> | Ano | Řetězec | Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Hodnoty indexu časových pásem Microsoftu,ale možná budete muset z názvu časového pásma odebrat jakoukoli interpunkci. |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <převedené časové razítko> | Řetězec | Časové razítko převedené na UTC |
Příklad 1
Tento příklad převede časové razítko na UTC:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')
A vrátí tento výsledek: "2018-01-01T08:00:00.0000000Z"
Příklad 2
Tento příklad převede časové razítko na UTC:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')
A vrátí tento výsledek: "Monday, January 1, 2018"
createArray
Vrátí pole z více vstupů. Pro pole s jedním vstupem naleznete v tématu Array ().
createArray('<object1>', '<object2>', ...)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <objekt1> <objekt2>... | Yes | Libovolná, ale ne smíšená | Aspoň dvě položky pro vytvoření pole |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| [<objekt1>, <objekt2>,...] | Pole | Pole vytvořené ze všech vstupních položek |
Příklad
Tento příklad vytvoří pole z těchto vstupů:
createArray('h', 'e', 'l', 'l', 'o')
A vrátí tento výsledek: ["h", "e", "l", "l", "o"]
dataUri
Vrátí v řetězci datový identifikátor URI (Uniform Resource Identifier).
dataUri('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <identifikátor URI dat> | Řetězec | Identifikátor URI dat pro vstupní řetězec |
Příklad
Tento příklad vytvoří identifikátor URI dat pro řetězec "Hello":
dataUri('hello')
A vrátí tento výsledek: "data:text/plain;charset=utf-8;base64,aGVsbG8="
dataUriToBinary
Vrátí binární verzi pro datový identifikátor URI (Uniform Resource Identifier).
Použijte tuto funkci místo decodeDataUri ().
I když obě funkce fungují stejným způsobem, dataUriBinary() jsou upřednostňovány.
dataUriToBinary('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Identifikátor URI dat, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <binární data pro identifikátor URI> | Řetězec | Binární verze identifikátoru URI dat |
Příklad
Tento příklad vytvoří binární verzi pro tento identifikátor URI dat:
dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')
A vrátí tento výsledek:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
dataUriToString
Vrátí verzi řetězce pro datový identifikátor URI (Uniform Resource Identifier).
dataUriToString('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Identifikátor URI dat, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <řetězec pro datový identifikátor URI> | Řetězec | Verze řetězce pro identifikátor URI dat |
Příklad
Tento příklad vytvoří řetězec pro tento identifikátor URI dat:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
A vrátí tento výsledek: "hello"
dayOfMonth
Vrátí den v měsíci z časového razítka.
dayOfMonth('<timestamp>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <den měsíce> | Integer | Den v měsíci ze zadaného časového razítka |
Příklad
Tento příklad vrátí číslo dne v měsíci z tohoto časového razítka:
dayOfMonth('2018-03-15T13:27:36Z')
A vrátí tento výsledek: 15
dayOfWeek
Vrátí den v týdnu z časového razítka.
dayOfWeek('<timestamp>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <den týdne> | Integer | Den v týdnu ze zadaného časového razítka, kde neděle je 0, pondělí a tak dále |
Příklad
Tento příklad vrátí číslo pro den v týdnu z tohoto časového razítka:
dayOfWeek('2018-03-15T13:27:36Z')
A vrátí tento výsledek: 3
dayOfYear
Vrátí den v roce z časového razítka.
dayOfYear('<timestamp>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <den roku> | Integer | Den v roce ze zadaného časového razítka |
Příklad
Tento příklad vrátí číslo dne v roce z tohoto časového razítka:
dayOfYear('2018-03-15T13:27:36Z')
A vrátí tento výsledek: 74
decodeBase64
Vrátí verzi řetězce pro řetězec kódovaný v kódování Base64 a efektivně dekódování řetězce base64.
Zvažte použití base64ToString () spíše než decodeBase64() .
I když obě funkce fungují stejným způsobem, base64ToString() jsou upřednostňovány.
decodeBase64('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec kódovaný v kódování Base64 k dekódování |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <dekódované – řetězec base64> | Řetězec | Verze řetězce pro řetězec kódovaný v kódování Base64 |
Příklad
Tento příklad vytvoří řetězec pro řetězec kódovaný v kódování Base64:
decodeBase64('aGVsbG8=')
A vrátí tento výsledek: "hello"
decodeDataUri
Vrátí binární verzi pro datový identifikátor URI (Uniform Resource Identifier).
Zvažte použití dataUriToBinary ()místo decodeDataUri() .
I když obě funkce fungují stejným způsobem, dataUriToBinary() jsou upřednostňovány.
decodeDataUri('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec identifikátoru URI dat k dekódování |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <binární data pro identifikátor URI> | Řetězec | Binární verze řetězce identifikátoru URI dat |
Příklad
Tento příklad vrátí binární verzi pro tento identifikátor URI dat:
decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')
A vrátí tento výsledek:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
decodeURIComponent –
Vrátí řetězec, který nahradí řídicí znaky pomocí dekódování verzí.
decodeUriComponent('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec s řídicími znaky k dekódování |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Dekódovatelné – identifikátor URI> | Řetězec | Aktualizovaný řetězec s dekódovými řídicími znaky |
Příklad
Tento příklad nahrazuje řídicí znaky v tomto řetězci pomocí Dekódovatelné verze:
decodeUriComponent('http%3A%2F%2Fcontoso.com')
A vrátí tento výsledek: "https://contoso.com"
div
Vrátí celočíselný výsledek z vydělení dvou čísel. Chcete-li získat zbývající výsledek, viz mod ().
div(<dividend>, <divisor>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <podíl> | Yes | Integer nebo float | Číslo, které se má rozdělit dělitelem |
| <dělitel> | Yes | Integer nebo float | Číslo, které vydělí dividendy, ale nemůže být 0 |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <podíl – výsledek> | Integer | Celočíselný výsledek vydělení prvního čísla druhým číslem |
Příklad
Oba příklady vydělí první číslo druhým číslem:
div(10, 5)
div(11, 5)
A vrátí tento výsledek: 2
encodeURIComponent –
Nahrazením znaků, které nejsou v adrese URL, pomocí řídicích znaků vrátíte verzi kódovanou podle identifikátoru URI (Uniform Resource Identifier) pro řetězec.
Zvažte použití uriComponent ()místo encodeUriComponent() .
I když obě funkce fungují stejným způsobem, uriComponent() jsou upřednostňovány.
encodeUriComponent('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec, který se má převést na formát kódovaný identifikátorem URI |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <kódovaný identifikátor URI> | Řetězec | Řetězec kódovaný identifikátorem URI s řídicími znaky |
Příklad
Tento příklad vytvoří pro tento řetězec verzi kódovanou pomocí identifikátoru URI:
encodeUriComponent('https://contoso.com')
A vrátí tento výsledek: "http%3A%2F%2Fcontoso.com"
empty
Zkontroluje, jestli je kolekce prázdná. Vrátí hodnotu true, pokud je kolekce prázdná, nebo vrátí hodnotu false, pokud není prázdná.
empty('<collection>')
empty([<collection>])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Řetězec, pole nebo objekt | Kolekce, která má být zkontrolována |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu pravda, pokud je kolekce prázdná. Vrátí hodnotu false, pokud není prázdná. |
Příklad
Tyto příklady kontrolují, jestli jsou zadané kolekce prázdné:
empty('')
empty('abc')
A vrátí tyto výsledky:
- První příklad: předává prázdný řetězec, takže funkce vrátí hodnotu
true. - Druhý příklad: předá řetězec "ABC", takže funkce vrátí
false.
endsWith
Zkontroluje, jestli řetězec končí určitým podřetězcem. Vrátí hodnotu true, pokud se podřetězec najde, nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce nerozlišuje velká a malá písmena.
endsWith('<text>', '<searchText>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který má být zkontrolován |
| <Prohledávanýtext> | Ano | Řetězec | Koncový dílčí řetězec, který se má najít |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu pravda, pokud je nalezen poslední podřetězec. Pokud se nenajde, vrátí se hodnota false. |
Příklad 1
Tento příklad zkontroluje, jestli řetězec "Hello World" končí řetězcem "World":
endsWith('hello world', 'world')
A vrátí tento výsledek: true
Příklad 2
Tento příklad zkontroluje, jestli řetězec "Hello World" končí řetězcem "Universe":
endsWith('hello world', 'universe')
A vrátí tento výsledek: false
equals
Zkontroluje, jestli jsou hodnoty, výrazy nebo objekty ekvivalentní. Vrátí hodnotu true, pokud jsou obě ekvivalentní, nebo vrátí hodnotu false, pokud nejsou ekvivalentní.
equals('<object1>', '<object2>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <objekt1>, <objekt2> | Yes | Některé | Hodnoty, výrazy nebo objekty, které se mají porovnat |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud jsou obě ekvivalentní. Vrátí hodnotu false, pokud není ekvivalentní. |
Příklad
Tyto příklady kontrolují, zda jsou zadané vstupy ekvivalentní.
equals(true, 1)
equals('abc', 'abcd')
A vrátí tyto výsledky:
- První příklad: obě hodnoty jsou ekvivalentní, takže funkce vrátí
true. - Druhý příklad: obě hodnoty nejsou ekvivalentní, takže funkce vrátí
false.
první
Vrátí první položku z řetězce nebo pole.
first('<collection>')
first([<collection>])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Řetězec nebo pole | Kolekce, ve které se má najít první položka |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <první kolekce – položka> | Všechny | První položka v kolekci |
Příklad
Tyto příklady vyhledají první položku v těchto kolekcích:
first('hello')
first(createArray(0, 1, 2))
A vrátí tyto výsledky:
- První příklad:
"h" - Druhý příklad:
0
float
Převede verzi řetězce pro číslo s plovoucí desetinnou čárkou na skutečné číslo s plovoucí desetinnou čárkou.
float('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec, který má platné číslo s plovoucí desetinnou čárkou, které se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <float-Value> | Float | Číslo s plovoucí desetinnou čárkou pro zadaný řetězec |
Příklad
Tento příklad vytvoří verzi řetězce pro toto číslo s plovoucí desetinnou čárkou:
float('10.333')
A vrátí tento výsledek: 10.333
formatDateTime
Vrátí časové razítko v zadaném formátu.
formatDateTime('<timestamp>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <přeformátované – časové razítko> | Řetězec | Aktualizované časové razítko v zadaném formátu |
Příklad
Tento příklad převede časové razítko na určený formát:
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')
A vrátí tento výsledek: "2018-03-15T12:00:00"
getFutureTime
Vrátí aktuální časové razítko plus zadané časové jednotky.
getFutureTime(<interval>, <timeUnit>, <format>?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <doba> | Yes | Integer | Počet zadaných časových jednotek, které se mají přidat |
| <timeUnit> | Ano | Řetězec | Jednotka času, která se má použít v intervalu: "druhé", "Minute", "hodina", "den", "týden", "měsíc", "rok" |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizované časové razítko> | Řetězec | Aktuální časové razítko plus zadaný počet časových jednotek |
Příklad 1
Předpokládejme, že aktuální časové razítko je 2018-03-01T00:00:00.0000000Z. Tento příklad přidá do tohoto časového razítka pět dní:
getFutureTime(5, 'Day')
A vrátí tento výsledek: "2018-03-06T00:00:00.0000000Z"
Příklad 2
Předpokládejme, že aktuální časové razítko je 2018-03-01T00:00:00.0000000Z. Tento příklad přidá pět dní a převede výsledek do formátu "D":
getFutureTime(5, 'Day', 'D')
A vrátí tento výsledek: "Tuesday, March 6, 2018"
getPastTime
Vrátí aktuální časové razítko minus zadané časové jednotky.
getPastTime(<interval>, <timeUnit>, <format>?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Interval> | Yes | Integer | Počet zadaných časových jednotek, které se mají odečíst |
| <timeUnit> | Ano | Řetězec | Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year" |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizované časové razítko> | Řetězec | Aktuální časové razítko minus zadaný počet časových jednotek |
Příklad 1
Předpokládejme, že aktuální časové razítko je 2018-02-01T00:00:00.0000000Z. Tento příklad odečte od tohoto časového razítka pět dnů:
getPastTime(5, 'Day')
A vrátí tento výsledek: "2018-01-27T00:00:00.0000000Z"
Příklad 2
Předpokládejme, že aktuální časové razítko je 2018-02-01T00:00:00.0000000Z. Tento příklad odečte pět dní a převede výsledek do formátu "D":
getPastTime(5, 'Day', 'D')
A vrátí tento výsledek: "Saturday, January 27, 2018"
greater
Zkontrolujte, jestli je první hodnota větší než druhá hodnota. Vrátí hodnotu true, pokud je první hodnota větší, nebo vrátí hodnotu false, pokud je menší.
greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Integer, Float nebo String | První hodnota pro kontrolu, zda je větší než druhá hodnota |
| <Compareto> | Yes | Celé číslo, float nebo řetězec (v uvedeném pořadí) | Porovnávaná hodnota |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud je první hodnota větší než druhá hodnota. Vrátí hodnotu false, pokud je první hodnota rovna nebo menší než druhá hodnota. |
Příklad
V těchto příkladech se zkontroluje, jestli je první hodnota větší než druhá hodnota:
greater(10, 5)
greater('apple', 'banana')
A vraťte tyto výsledky:
- První příklad:
true - Druhý příklad:
false
greaterOrEquals
Zkontrolujte, jestli je první hodnota větší nebo rovna druhé hodnotě. Vrátí hodnotu true, pokud je první hodnota větší nebo rovna, nebo vrátí hodnotu false, pokud je první hodnota menší.
greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Integer, Float nebo String | První hodnota pro kontrolu, jestli je větší než nebo rovna druhé hodnotě |
| <Compareto> | Yes | Celé číslo, float nebo řetězec (v uvedeném pořadí) | Porovnávaná hodnota |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud je první hodnota větší nebo rovna druhé hodnotě. Vrátí hodnotu false, pokud je první hodnota menší než druhá hodnota. |
Příklad
V těchto příkladech se zkontroluje, jestli je první hodnota větší nebo rovna druhé hodnotě:
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
A vraťte tyto výsledky:
- První příklad:
true - Druhý příklad:
false
guid
Vygenerování globálně jedinečného identifikátoru (GUID) jako řetězce, například "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":
guid()
Můžete také zadat jiný formát identifikátoru GUID než výchozí formát "D", což je 32 číslic oddělených pomlčkami.
guid('<format>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Formát> | No | Řetězec | Jeden specifikátor formátu pro vrácený identifikátor GUID. Ve výchozím nastavení je formát "D", ale můžete použít "N", "D", "B", "P" nebo "X". |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Hodnota GUID> | Řetězec | Náhodně vygenerovaný identifikátor GUID |
Příklad
Tento příklad vygeneruje stejný identifikátor GUID, ale jako 32 číslic oddělených spojovníky a uzavřených v závorkách:
guid('P')
A vrátí tento výsledek: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"
if
Zkontrolujte, jestli je výraz pravdivý nebo nepravdivý. Na základě výsledku vrátí zadanou hodnotu.
if(<expression>, <valueIfTrue>, <valueIfFalse>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Výraz> | Yes | Logická hodnota | Výraz, který se má zkontrolovat |
| <hodnotaIfTrue> | Yes | Všechny | Hodnota, která se má vrátit, když je výraz pravdivý |
| <valueIfFalse> | Yes | Všechny | Hodnota, která se má vrátit, když je výraz nepravdivý |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <specified-return-value> | Všechny | Zadaná hodnota, která se vrátí na základě toho, jestli je výraz pravdivý nebo nepravdivý |
Příklad
Tento příklad vrátí "yes" hodnotu , protože zadaný výraz vrátí hodnotu true.
V opačném případě příklad vrátí "no" :
if(equals(1, 1), 'yes', 'no')
Indexof
Vrátí počáteční pozici nebo hodnotu indexu podřetězce. Tato funkce rozlišuje malá a velká písmena a indexy začínají číslem 0.
indexOf('<text>', '<searchText>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Text> | Ano | Řetězec | Řetězec, který má podřetězec, který se má najít |
| <searchText> | Ano | Řetězec | Podřetězec, který se má najít |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <index-value> | Integer | Počáteční pozice nebo hodnota indexu pro zadaný podřetězec. Pokud řetězec není nalezen, vrátí číslo -1. |
Příklad
Tento příklad vyhledá počáteční hodnotu indexu pro podřetězec "world" v řetězci "hello world":
indexOf('hello world', 'world')
A vrátí tento výsledek: 6
int
Vrátí celočíselnou verzi řetězce.
int('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Ano | Řetězec | Řetězec, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <celočíselný výsledek> | Integer | Celočíselná verze zadaného řetězce |
Příklad
Tento příklad vytvoří celočíselnou verzi řetězce "10":
int('10')
A vrátí tento výsledek: 10
json
Vrátí hodnotu JavaScript Object Notation (JSON) nebo objekt pro řetězec nebo XML.
json('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Řetězec nebo XML | Řetězec nebo XML, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Výsledek JSON> | Nativní typ nebo objekt JSON | Hodnota nebo objekt nativního typu JSON pro zadaný řetězec nebo XML. Pokud je řetězec null, funkce vrátí prázdný objekt. |
Příklad 1
Tento příklad převede tento řetězec na hodnotu JSON:
json('[1, 2, 3]')
A vrátí tento výsledek: [1, 2, 3]
Příklad 2
Tento příklad převede tento řetězec na formát JSON:
json('{"fullName": "Sophia Owen"}')
A vrátí tento výsledek:
{
"fullName": "Sophia Owen"
}
Příklad 3
Tento příklad převede tento kód XML na formát JSON:
json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
A vrátí tento výsledek:
{
"?xml": { "@version": "1.0" },
"root": {
"person": [ {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
} ]
}
}
průnik
Vrátí kolekci, která má v zadaných kolekcích jenom společné položky. Aby se položka zobrazila ve výsledku, musí se objevit ve všech kolekcích předaných této funkci. Pokud má jedna nebo více položek stejný název, zobrazí se ve výsledku poslední položka se stejným názvem.
intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <collection1> <Collection2>... | Yes | Pole nebo objekt, ale ne obojí | Kolekce, ze kterých mají být pouze běžné položky |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <společné položky> | Pole nebo objekt, v uvedeném pořadí | Kolekce, která má v zadaných kolekcích jenom společné položky |
Příklad
Tento příklad najde společné položky v těchto polích:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
A vrátí pole pouze s následujícími položkami: [1, 2]
join
Vrátí řetězec, který má všechny položky z pole a má každý znak oddělený oddělovačem.
join([<collection>], '<delimiter>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Pole | Pole, ve kterém se mají položky připojit |
| <oddělovač> | Ano | Řetězec | Oddělovač, který se zobrazí mezi jednotlivými znaky ve výsledném řetězci |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <CHAR1 >< oddělovač >< CHAR2 >< oddělovač>... | Řetězec | Výsledný řetězec vytvořený ze všech položek v zadaném poli |
Příklad
Tento příklad vytvoří řetězec ze všech položek v tomto poli se zadaným znakem jako oddělovač:
join(createArray('a', 'b', 'c'), '.')
A vrátí tento výsledek: "a.b.c"
poslední
Vrátí poslední položku z kolekce.
last('<collection>')
last([<collection>])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Řetězec nebo pole | Kolekce, ve které se má najít poslední položka |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Poslední kolekce – položka> | Řetězec nebo pole, v uvedeném pořadí | Poslední položka v kolekci |
Příklad
Tyto příklady vyhledají poslední položku v těchto kolekcích:
last('abcd')
last(createArray(0, 1, 2, 3))
A vrátí tyto výsledky:
- První příklad:
"d" - Druhý příklad:
3
lastIndexOf
Vrátí počáteční pozici nebo hodnotu indexu pro poslední výskyt podřetězce. Tato funkce nerozlišuje velká a malá písmena a indexy začínají číslem 0.
lastIndexOf('<text>', '<searchText>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který obsahuje dílčí řetězec, který se má najít |
| <Prohledávanýtext> | Ano | Řetězec | Dílčí řetězec, který se má najít |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <ending-index-value> | Integer | Počáteční pozice nebo hodnota indexu posledního výskytu zadaného podřetězce Pokud řetězec není nalezen, vrátí číslo -1. |
Příklad
Tento příklad vyhledá počáteční hodnotu indexu pro poslední výskyt podřetězce "world" v řetězci "hello world":
lastIndexOf('hello world', 'world')
A vrátí tento výsledek: 6
length
Vrátí počet položek v kolekci.
length('<collection>')
length([<collection>])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Kolekce> | Yes | Řetězec nebo pole | Kolekce s položkami, které se mají spočítat |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <length-or-count> | Integer | Počet položek v kolekci |
Příklad
Tyto příklady spočítá počet položek v těchto kolekcích:
length('abcd')
length(createArray(0, 1, 2, 3))
A vraťte tento výsledek: 4
less
Zkontrolujte, jestli je první hodnota menší než druhá hodnota. Vrátí hodnotu true, pokud je první hodnota menší, nebo vrátí hodnotu false, pokud je první hodnota větší.
less(<value>, <compareTo>)
less('<value>', '<compareTo>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Integer, Float nebo String | První hodnota pro kontrolu, jestli je menší než druhá hodnota |
| <Compareto> | Yes | Celé číslo, float nebo řetězec (v uvedeném pořadí) | Položka porovnání |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud je první hodnota menší než druhá hodnota. Vrátí hodnotu false, pokud je první hodnota rovna nebo větší než druhá hodnota. |
Příklad
Tyto příklady zkontrolují, jestli je první hodnota menší než druhá hodnota.
less(5, 10)
less('banana', 'apple')
A vraťte tyto výsledky:
- První příklad:
true - Druhý příklad:
false
lessOrEquals
Zkontrolujte, jestli je první hodnota menší nebo rovna druhé hodnotě. Vrátí hodnotu true, pokud je první hodnota menší nebo rovna, nebo vrátí hodnotu false, pokud je první hodnota větší.
lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Integer, Float nebo String | První hodnota pro kontrolu, jestli je menší než nebo rovna druhé hodnotě |
| <Compareto> | Yes | Celé číslo, float nebo řetězec (v uvedeném pořadí) | Položka porovnání |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud je první hodnota menší nebo rovna druhé hodnotě. Vrátí hodnotu false, pokud je první hodnota větší než druhá hodnota. |
Příklad
Tyto příklady zkontrolují, jestli je první hodnota menší nebo rovna druhé hodnotě.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
A vraťte tyto výsledky:
- První příklad:
true - Druhý příklad:
false
max
Vrátí nejvyšší hodnotu ze seznamu nebo pole s čísly, která jsou na obou koncích zahrnutá.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <number1>, <number2>, ... | Yes | Celé číslo, float nebo obojí | Sada čísel, ze kterých chcete nejvyšší hodnotu |
| [<number1>, <number2>, ...] | Yes | Pole – Integer, Float nebo obojí | Pole čísel, ze kterých chcete nejvyšší hodnotu |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <max-value (maximální hodnota)> | Integer nebo Float | Nejvyšší hodnota v zadaném poli nebo sadě čísel |
Příklad
Tyto příklady čítá nejvyšší hodnotu ze sady čísel a pole:
max(1, 2, 3)
max(createArray(1, 2, 3))
A vraťte tento výsledek: 3
min
Vrátí nejnižší hodnotu ze sady čísel nebo pole.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <number1>, <number2>, ... | Yes | Celé číslo, float nebo obojí | Sada čísel, ze kterých chcete nejnižší hodnotu |
| [<number1>, <number2>, ...] | Yes | Pole – Integer, Float nebo obojí | Pole čísel, ze kterých chcete nejnižší hodnotu |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <min-value (minimální hodnota)> | Integer nebo Float | Nejnižší hodnota v zadané sadě čísel nebo zadaném poli |
Příklad
V těchto příkladech je nejnižší hodnota v sadě čísel a v poli:
min(1, 2, 3)
min(createArray(1, 2, 3))
A vraťte tento výsledek: 1
Mod
Vrátí zbytek rozdělení dvou čísel. Pokud chcete získat výsledek celého čísla, podívejte se na div().
mod(<dividend>, <divisor>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Dividenda> | Yes | Integer nebo Float | Číslo, které se má dělit dělitelem |
| <Dělitel> | Yes | Integer nebo Float | Číslo, které dělí dělenec, ale nemůže být 0. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <modulo-result> | Integer nebo Float | Zbytek po vydělení prvního čísla druhým číslem |
Příklad
Tento příklad vydělí první číslo druhým číslem:
mod(3, 2)
A vraťte tento výsledek: 1
mul (více)
Vrátí součásek vynásobením dvou čísel.
mul(<multiplicand1>, <multiplicand2>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <násobenía1> | Yes | Integer nebo Float | Číslo, které se má vynásobit násobeníma2 |
| <násobenía2> | Yes | Integer nebo Float | Číslo, které násobí násobky1 |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <product-result> | Integer nebo Float | Produkt vynásobením prvního čísla druhým číslem |
Příklad
Tyto příklady násobí první číslo druhým číslem:
mul(1, 2)
mul(1.5, 2)
A vraťte tyto výsledky:
- První příklad:
2 - Druhý příklad
3
not
Zkontrolujte, jestli je výraz nepravdivý. Vrátí hodnotu true, pokud je výraz nepravdivý, nebo vrátí hodnotu false, pokud je true.
not(<expression>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Výraz> | Yes | Logická hodnota | Výraz, který se má zkontrolovat |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Pokud je výraz nepravdivý, vrátí hodnotu true. Pokud je výraz pravdivý, vrátí hodnotu false. |
Příklad 1
Tyto příklady zkontrolují, jestli jsou zadané výrazy nepravdivé:
not(false)
not(true)
A vraťte tyto výsledky:
- První příklad: Výraz má hodnotu false, takže funkce vrátí
true. - Druhý příklad: Výraz má hodnotu true, takže funkce vrátí
false.
Příklad 2
Tyto příklady kontrolují, zda jsou zadané výrazy nepravdivé:
not(equals(1, 2))
not(equals(1, 1))
A vrátí tyto výsledky:
- První příklad: výraz má hodnotu false, takže funkce vrátí hodnotu
true. - Druhý příklad: výraz má hodnotu true, takže funkce vrátí hodnotu
false.
nebo
Ověřte, zda je alespoň jeden výraz pravdivý. Vrátí hodnotu true, pokud má alespoň jeden výraz hodnotu true, nebo vrátí hodnotu false, pokud jsou obě hodnoty false.
or(<expression1>, <expression2>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <výraz1>, <Výraz2> | Yes | Logická hodnota | Výrazy, které mají být zkontrolovány |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud má alespoň jeden výraz hodnotu true. Vrátí hodnotu false, pokud jsou oba výrazy nepravdivé. |
Příklad 1
Tyto příklady kontrolují, zda alespoň jeden výraz má hodnotu true:
or(true, false)
or(false, false)
A vrátí tyto výsledky:
- První příklad: nejméně jeden výraz má hodnotu true, takže funkce vrátí hodnotu
true. - Druhý příklad: oba výrazy mají hodnotu false, takže funkce vrátí hodnotu
false.
Příklad 2
Tyto příklady kontrolují, zda alespoň jeden výraz má hodnotu true:
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
A vrátí tyto výsledky:
- První příklad: nejméně jeden výraz má hodnotu true, takže funkce vrátí hodnotu
true. - Druhý příklad: oba výrazy mají hodnotu false, takže funkce vrátí hodnotu
false.
rand
Vrátí náhodné celé číslo ze zadaného rozsahu, který je zahrnut pouze na počátečním konci.
rand(<minValue>, <maxValue>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <minValue> | Yes | Integer | Nejnižší celé číslo v rozsahu |
| <maxValue> | Yes | Integer | Celé číslo, které následuje po nejvyšší celé číslo v rozsahu, který může funkce vracet |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <náhodný výsledek> | Integer | Náhodné celé číslo vrácené ze zadaného rozsahu |
Příklad
Tento příklad získá náhodné celé číslo ze zadaného rozsahu s výjimkou maximální hodnoty:
rand(1, 5)
A vrátí jeden z těchto čísel jako výsledek: 1 , 2 , 3 nebo 4
range
Vrátí celočíselné pole, které začíná zadaným celým číslem.
range(<startIndex>, <count>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Indexu> | Yes | Integer | Celočíselná hodnota, která spouští pole jako první položku |
| <výpočtu> | Yes | Integer | Počet celých čísel v poli |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| [<Rozsah-> výsledků ] | Pole | Pole s celými čísly počínaje zadaným indexem |
Příklad
Tento příklad vytvoří celočíselné pole, které začíná od zadaného indexu a má zadaný počet celých čísel:
range(1, 4)
A vrátí tento výsledek: [1, 2, 3, 4]
náhrady
Nahraďte podřetězec zadaným řetězcem a vraťte výsledný řetězec. Tato funkce rozlišuje velká a malá písmena.
replace('<text>', '<oldText>', '<newText>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který má podřetězec, který má být nahrazen |
| <oldText> | Ano | Řetězec | Dílčí řetězec, který má být nahrazen |
| <newText> | Ano | Řetězec | Řetězec pro nahrazení |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizovaný text> | Řetězec | Aktualizovaný řetězec po nahrazení podřetězce Pokud dílčí řetězec nebyl nalezen, vrátí původní řetězec. |
Příklad
Tento příklad najde "starý" podřetězec v "starém řetězci" a nahradí "Old" novou:
replace('the old string', 'old', 'new')
A vrátí tento výsledek: "the new string"
Přeskočit
Odebere položky z přední části kolekce a vrátí všechny ostatní položky.
skip([<collection>], <count>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <kolekce> | Yes | Pole | Kolekce, jejíž položky chcete odebrat |
| <výpočtu> | Yes | Integer | Kladné celé číslo pro počet položek, které se mají odebrat na začátku |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| [<aktualizováno> kolekce ] | Pole | Aktualizovaná kolekce po odebrání zadaných položek |
Příklad
Tento příklad odebere jednu položku, číslo 0, od začátku zadaného pole:
skip(createArray(0, 1, 2, 3), 1)
A vrátí toto pole se zbývajícími položkami: [1,2,3]
split
Vrátí pole obsahující podřetězce oddělené čárkami na základě zadaného oddělovače v původním řetězci.
split('<text>', '<delimiter>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který se má oddělit k podřetězcům na základě zadaného oddělovače v původním řetězci |
| <oddělovač> | Ano | Řetězec | Znak v původním řetězci, který má být použit jako oddělovač |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| [<subřetězec1>, <subřetězec2>,...] | Pole | Pole, které obsahuje podřetězce z původního řetězce oddělené čárkami |
Příklad
Tento příklad vytvoří pole s podřetězci ze zadaného řetězce založeného na zadaném znaku jako oddělovač:
split('a_b_c', '_')
A vrátí toto pole jako výsledek: ["a","b","c"]
startOfDay
Vrátí začátek dne pro časové razítko.
startOfDay('<timestamp>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Zadané časové razítko, ale začíná nulovou časovou značkou dne |
Příklad
Tento příklad najde začátek dne pro toto časové razítko:
startOfDay('2018-03-15T13:30:30Z')
A vrátí tento výsledek: "2018-03-15T00:00:00.0000000Z"
startOfHour
Vrátí začátek hodiny pro časové razítko.
startOfHour('<timestamp>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <časové razítko> | Ano | Řetězec | Řetězec, který obsahuje časové razítko |
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Aktualizováno – časové razítko> | Řetězec | Zadané časové razítko, ale začíná na označení 0 minuta za hodinu |
Příklad
Tento příklad vyhledá začátek hodiny pro toto časové razítko:
startOfHour('2018-03-15T13:30:30Z')
A vrátí tento výsledek: "2018-03-15T13:00:00.0000000Z"
startOfMonth
Vrátí začátek měsíce pro časové razítko.
startOfMonth('<timestamp>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec obsahující časové razítko |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizované časové razítko> | Řetězec | Zadané časové razítko, ale začíná prvním dnem v měsíci se značkou nula hodin. |
Příklad
Tento příklad vrátí začátek měsíce pro toto časové razítko:
startOfMonth('2018-03-15T13:30:30Z')
A vrátí tento výsledek: "2018-03-01T00:00:00.0000000Z"
startsWith
Zkontrolujte, jestli řetězec začíná konkrétním dílčím řetězcem. Vrátí hodnotu true, pokud je nalezen podřetězec, nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce rozlišuje malá a velká písmena.
startsWith('<text>', '<searchText>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Text> | Ano | Řetězec | Řetězec, který se má zkontrolovat |
| <searchText> | Ano | Řetězec | Počáteční řetězec, který se má najít |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| true nebo false | Logická hodnota | Vrátí hodnotu true, pokud je nalezen počáteční podřetězec. Pokud se nenašla hodnota false, vrátí hodnotu false. |
Příklad 1
Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězci "hello":
startsWith('hello world', 'hello')
A vrátí tento výsledek: true
Příklad 2
Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězci "greetings":
startsWith('hello world', 'greetings')
A vrátí tento výsledek: false
řetězec
Vrátí verzi řetězce pro hodnotu.
string(<value>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Hodnotu> | Yes | Všechny | Hodnota, která se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <řetězcová hodnota> | Řetězec | Verze řetězce pro zadanou hodnotu |
Příklad 1
Tento příklad vytvoří verzi řetězce pro toto číslo:
string(10)
A vrátí tento výsledek: "10"
Příklad 2
Tento příklad vytvoří řetězec pro zadaný objekt JSON a použije znak zpětného lomítka ( ) jako řídicí znak pro dvojité \ uvozovky (").
string( { "name": "Sophie Owen" } )
A vrátí tento výsledek: "{ \\"name\\": \\"Sophie Owen\\" }"
Dílčí
Vrátí výsledek od odečtení druhého čísla od prvního čísla.
sub(<minuend>, <subtrahend>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <minuend (minuend)> | Yes | Integer nebo Float | Číslo, od kterého se má odečíst dílčí operátor |
| <subtrahend (subtrahend( subtrahend> | Yes | Integer nebo Float | Číslo, které se odečte od minuendu |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Výsledek> | Integer nebo Float | Výsledek odečtení druhého čísla od prvního čísla |
Příklad
Tento příklad odečte druhé číslo od prvního čísla:
sub(10.3, .3)
A vrátí tento výsledek: 10
Podřetězec
Vrátí znaky z řetězce, počínaje zadanou pozicí nebo indexem. Hodnoty indexu začínají číslem 0.
substring('<text>', <startIndex>, <length>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Text> | Ano | Řetězec | Řetězec, jehož znaky chcete |
| <Startindex> | Yes | Integer | Kladné číslo rovné nebo větší než 0, které chcete použít jako počáteční pozici nebo hodnotu indexu |
| <Délka> | Yes | Integer | Kladný počet znaků, které chcete mít v podřetězci |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <výsledek podřetězce> | Řetězec | Podřetězec se zadaným počtem znaků začínající na zadané pozici indexu ve zdrojovém řetězci |
Příklad
Tento příklad vytvoří z určeného řetězce podřetězec s pěti znaky počínaje hodnotou indexu 6:
substring('hello world', 6, 5)
A vrátí tento výsledek: "world"
subtractFromTime
Odečte od časového razítka počet časových jednotek. Viz také getPastTime.
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec obsahující časové razítko |
| <Interval> | Yes | Integer | Počet zadaných časových jednotek, které se mají odečíst |
| <timeUnit> | Ano | Řetězec | Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year" |
| <Formát> | No | Řetězec | Specifikátor jednoho formátu nebo vzor vlastního formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss:fffffffK), který vyhovuje standardu ISO 8601 a zachovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizované časové razítko> | Řetězec | Časové razítko minus zadaný počet časových jednotek |
Příklad 1
Tento příklad odečte jeden den od tohoto časového razítka:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')
A vrátí tento výsledek: "2018-01-01T00:00:00:0000000Z"
Příklad 2
Tento příklad odečte jeden den od tohoto časového razítka:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')
A vrátí tento výsledek pomocí volitelného formátu "D": "Monday, January, 1, 2018"
take
Vrátí položky zepředu kolekce.
take('<collection>', <count>)
take([<collection>], <count>)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Kolekce> | Yes | Řetězec nebo pole | Kolekce, jejíž položky chcete |
| <Počet> | Yes | Integer | Kladné celé číslo pro počet položek, které chcete zepředu |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <subset> nebo [<subset>] | String (Řetězec) nebo Array (Pole) | Řetězec nebo pole se zadaným počtem položek převzatých z přední části původní kolekce |
Příklad
Tyto příklady zadat počet položek z přední části těchto kolekcí:
take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)
A vraťte tyto výsledky:
- První příklad:
"abc" - Druhý příklad:
[0, 1, 2]
Klíšťata
Vrátí hodnotu ticks vlastnosti pro zadané časové razítko.
Odškrtá se interval 100 nanosekund.
ticks('<timestamp>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <Časové razítko> | Ano | Řetězec | Řetězec časového razítka |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <takty – číslo> | Integer | Počet tiků od zadaného časového razítka |
toLower
Vrátí řetězec ve formátu s malými písmeny. Pokud znak v řetězci nemá malá verze, tento znak zůstane ve vráceném řetězci beze změny.
toLower('<text>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který se má vrátit ve formátu malého písmene |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <malý text> | Řetězec | Původní řetězec ve formátu malými písmeny |
Příklad
Tento příklad převede tento řetězec na malá písmena:
toLower('Hello World')
A vrátí tento výsledek: "hello world"
toUpper
Vrátí řetězec ve formátu velkými písmeny. Pokud znak v řetězci nemá velké písmeno, tento znak zůstane ve vráceném řetězci beze změny.
toUpper('<text>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který se má vrátit ve formátu velkého písmene |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Velká písmena textu> | Řetězec | Původní řetězec ve formátu velkých písmen |
Příklad
Tento příklad převede tento řetězec na velká písmena:
toUpper('Hello World')
A vrátí tento výsledek: "HELLO WORLD"
sklon
Odstraňte úvodní a koncové mezery z řetězce a vraťte aktualizovaný řetězec.
trim('<text>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <textové> | Ano | Řetězec | Řetězec, který má počáteční a koncovou mezeru, která se má odebrat |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <updatedText> | Řetězec | Aktualizovaná verze původního řetězce bez počátečního nebo koncového znaku |
Příklad
Tento příklad odstraní úvodní a koncové mezery z řetězce "Hello World":
trim(' Hello World ')
A vrátí tento výsledek: "Hello World"
sjednocení
Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí. Aby se zobrazila ve výsledku, může se položka objevit v jakékoli kolekci předané této funkci. Pokud má jedna nebo více položek stejný název, zobrazí se ve výsledku poslední položka se stejným názvem.
union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <collection1> <Collection2>... | Yes | Pole nebo objekt, ale ne obojí | Kolekce, ze kterých chcete všechny položky |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktualizacecollection> | Pole nebo objekt, v uvedeném pořadí | Kolekce se všemi položkami ze zadané kolekce – žádné duplicity |
Příklad
Tento příklad načte všechny položky z těchto kolekcí:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
A vrátí tento výsledek: [1, 2, 3, 10, 101]
uriComponent
Nahrazením znaků, které nejsou v adrese URL, pomocí řídicích znaků vrátíte verzi kódovanou podle identifikátoru URI (Uniform Resource Identifier) pro řetězec.
Použijte tuto funkci místo encodeURIComponent – ().
I když obě funkce fungují stejným způsobem, uriComponent() jsou upřednostňovány.
uriComponent('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec, který se má převést na formát kódovaný identifikátorem URI |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <kódovaný identifikátor URI> | Řetězec | Řetězec kódovaný identifikátorem URI s řídicími znaky |
Příklad
Tento příklad vytvoří pro tento řetězec verzi kódovanou pomocí identifikátoru URI:
uriComponent('https://contoso.com')
A vrátí tento výsledek: "http%3A%2F%2Fcontoso.com"
uriComponentToBinary
Vrátí binární verzi součásti identifikátoru URI (Uniform Resource Identifier).
uriComponentToBinary('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec kódovaný identifikátorem URI, který se má převést |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <binární-pro kódovaný identifikátor URI> | Řetězec | Binární verze řetězce zakódovaného identifikátorem URI. Binární obsah je kódovaný v kódování Base64 a reprezentován $content . |
Příklad
Tento příklad vytvoří binární verzi pro tento řetězec kódovaný pomocí identifikátoru URI:
uriComponentToBinary('http%3A%2F%2Fcontoso.com')
A vrátí tento výsledek:
"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"
uriComponentToString
Vrátí verzi řetězce pro řetězec kódovaný v identifikátoru URI (Uniform Resource Identifier), který efektivně Dekóduje řetězec kódovaný identifikátorem URI.
uriComponentToString('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec kódovaný identifikátorem URI k dekódování |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <Dekódovatelné – identifikátor URI> | Řetězec | Dekódovaná verze řetězce zakódovaného identifikátorem URI |
Příklad
Tento příklad vytvoří dekódovanou verzi řetězce pro tento řetězec kódovaný pomocí identifikátoru URI:
uriComponentToString('http%3A%2F%2Fcontoso.com')
A vrátí tento výsledek: "https://contoso.com"
utcNow
Vrátí aktuální časové razítko.
utcNow('<format>')
Volitelně můžete zadat jiný formát s parametrem <formát>.
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <formátovat> | No | Řetězec | Buď jeden specifikátor formátu , nebo vlastní vzorek formátu. Výchozí formát pro časové razítko je "o" (RRRR-MM-DDThh: mm: SS: fffffffK), který vyhovuje normě ISO 8601 a uchovává informace o časovém pásmu. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <aktuální – časové razítko> | Řetězec | Aktuální datum a čas |
Příklad 1
Dnes Předpokládejme 15. dubna 2018 v 1:00:00 odp. Tento příklad získá aktuální časové razítko:
utcNow()
A vrátí tento výsledek: "2018-04-15T13:00:00.0000000Z"
Příklad 2
Dnes Předpokládejme 15. dubna 2018 v 1:00:00 odp. Tento příklad získá aktuální časové razítko pomocí volitelného formátu "D":
utcNow('D')
A vrátí tento výsledek: "Sunday, April 15, 2018"
xml
Vrátí verzi XML pro řetězec, který obsahuje objekt JSON.
xml('<value>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <osa> | Ano | Řetězec | Řetězec s objektem JSON, který se má převést Objekt JSON musí mít pouze jednu kořenovou vlastnost, která nemůže být polem. |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <verze XML> | Objekt | Kódovaný kód XML pro zadaný řetězec nebo objekt JSON |
Příklad 1
Tento příklad vytvoří verzi XML pro tento řetězec, který obsahuje objekt JSON:
xml(json('{ \"name\": \"Sophia Owen\" }'))
A vrátí tento výsledek XML:
<name>Sophia Owen</name>
Příklad 2
Předpokládejme, že máte tento objekt JSON:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
Tento příklad vytvoří XML pro řetězec, který obsahuje tento objekt JSON:
xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))
A vrátí tento výsledek XML:
<person>
<name>Sophia Owen</name>
<city>Seattle</city>
<person>
cestou
Zkontroluje XML pro uzly nebo hodnoty, které odpovídají výrazu XPath (XML Path Language), a vrátí odpovídající uzly nebo hodnoty. Výraz XPath, nebo pouze "XPath", vám pomůže přejít na strukturu dokumentu XML, abyste mohli vybrat uzly nebo výpočetní hodnoty v obsahu XML.
xpath('<xml>', '<xpath>')
| Parametr | Povinné | Typ | Description |
|---|---|---|---|
| <XML> | Yes | Všechny | Řetězec XML pro vyhledání uzlů nebo hodnot, které odpovídají hodnotě výrazu XPath |
| <cestou> | Yes | Všechny | Výraz XPath, který slouží k vyhledání odpovídajícího uzlu XML nebo hodnot |
| Vrácená hodnota | Typ | Description |
|---|---|---|
| <uzel XML> | XML | Uzel XML, pokud pouze jeden uzel odpovídá zadanému výrazu XPath |
| <osa> | Všechny | Hodnota z uzlu XML, pokud je pouze jedna hodnota shodná se zadaným výrazem XPath |
| [<XML-uzel1>, <xml-Uzel2>,...] -nebo- [<hodnota1>, <hodnota2>,...] | Pole | Pole s uzly XML nebo hodnotami, které odpovídají zadanému výrazu XPath |
Příklad 1
V příkladu 1 Tento příklad najde uzly, které odpovídají uzlu, <count></count> a přidá tyto hodnoty uzlů s sum() funkcí:
xpath(xml(parameters('items')), 'sum(/produce/item/count)')
A vrátí tento výsledek: 30
Příklad 2
V tomto příkladu oba výrazy vyhledají uzly, které odpovídají <location></location> uzlu, v zadaných argumentech, které obsahují XML s oborem názvů. Výrazy používají znak zpětného lomítka ( \ ) jako řídicí znak pro dvojité uvozovky (").
Výraz 1
xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')Výraz 2
xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')
Tady jsou argumenty:
Tento kód XML, který zahrnuje obor názvů dokumentu XML,
xmlns="http://contoso.com":<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>Buď výraz XPath tady:
/*[name()=\"file\"]/*[name()=\"location\"]/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]
Zde je výsledný uzel, který odpovídá <location></location> uzlu:
<location xmlns="https://contoso.com">Paris</location>
Příklad 3
Následující příklad v příkladu 3 najde hodnotu v <location></location> uzlu:
xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')
A vrátí tento výsledek: "Paris"
Další kroky
Seznam systémových proměnných, které můžete použít ve výrazech, najdete v tématu systémové proměnné.