Referenční příručka k funkcím výrazů pracovních postupů ve službě Azure Logic Apps a Power Automate

Článek
12/15/2023

Platí pro: Azure Logic Apps (Consumption + Standard)

U definic pracovních postupů v Azure Logic Apps a Power Automate získají některé výrazy hodnoty z akcí modulu runtime, které ještě nemusí existovat při spuštění pracovního postupu. K odkazování nebo zpracování hodnot v těchto výrazech můžete použít funkce výrazů poskytované jazykem definice pracovního postupu.

Poznámka:

Tato referenční stránka se vztahuje na Azure Logic Apps i Power Automate, ale zobrazuje se v dokumentaci k Azure Logic Apps. I když tato stránka odkazuje konkrétně na pracovní postupy aplikace logiky, tyto funkce fungují pro toky i pracovní postupy aplikace logiky. Další informace o funkcích a výrazech v Power Automate najdete v tématu Použití výrazů v podmínkách.

Hodnoty můžete například vypočítat pomocí matematických funkcí, jako je například funkce add(), pokud chcete součet z celých čísel nebo plovoucích hodnot. Tady jsou další ukázkové úlohy, které můžete s funkcemi provádět:

Úloha	Syntaxe funkce	Výsledek
Vrátí řetězec ve formátu malými písmeny.	toLower('<text>') Příklad: toLower('Hello')	"hello"
Vrátí globálně jedinečný identifikátor (GUID).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Pokud chcete najít funkce založené na jejich obecném účelu, projděte si následující tabulky. Nebo podrobné informace o jednotlivých funkcích najdete v abecedním seznamu.

Funkce ve výrazech

Chcete-li ukázat, jak použít funkci ve výrazu, tento příklad ukazuje, jak můžete získat hodnotu z parametru customerName a přiřadit tuto hodnotu vlastnosti accountName pomocí funkce parameters() ve výrazu:

"accountName": "@parameters('customerName')"

Tady jsou některé další obecné způsoby použití funkcí ve výrazech:

Úloha	Syntaxe funkce ve výrazu
Proveďte práci s položkou předáním této položky do funkce.	"@<functionName>(<item>)"
1. Získejte hodnotu parametrName pomocí vnořené `parameters()` funkce. 2. Proveďte práci s výsledkem předáním této hodnoty do functionName.	@functionName>(parameters('<parameterName>'))<
1. Získá výsledek z vnořené vnitřní funkce functionName. 2. Předejte výsledek do vnější funkce functionName2.	"@<functionName2>(<functionName>(<item>))"
1. Získá výsledek z functionName. 2. Vzhledem k tomu, že výsledkem je objekt s vlastností propertyName, získejte hodnotu této vlastnosti.	"@<functionName>(<item).<>propertyName>"

Funkce může například concat() jako parametry vzít dvě nebo více řetězcových hodnot. Tato funkce kombinuje tyto řetězce do jednoho řetězce. Můžete předat řetězcové literály, například "Sophia" a "Owen", abyste získali kombinovaný řetězec "SophiaOwen":

"customerName": "@concat('Sophia', 'Owen')"

Nebo můžete získat řetězcové hodnoty z parametrů. Tento příklad používá parameters() funkci v každém concat() parametru a parametrechfirstName.lastName Výsledné řetězce concat() pak předáte funkci, abyste získali kombinovaný řetězec, například "SophiaOwen":

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

V obou případech oba příklady přiřazují výsledek vlastnosti customerName .

Důležité informace o používání funkcí

Návrhář nevyhodnocuje výrazy modulu runtime, které se v době návrhu používají jako parametry funkce. Návrhář vyžaduje, aby všechny výrazy mohly být plně vyhodnoceny v době návrhu.
Parametry funkce se vyhodnocují zleva doprava.
V syntaxi definic parametrů otazník (?), který se zobrazí za parametrem, znamená, že parametr je nepovinný. Příklad: getFutureTime().
Výrazy funkcí, které se zobrazují jako vložené s prostým textem, vyžadují uzavření složených závorek ({}) k použití interpolovaného formátu výrazu. Tento formát pomáhá předcházet problémům při analýze. Pokud se výraz funkce nezobrazuje jako vložený s prostým textem, nejsou potřeba žádné složené závorky.

Následující příklad ukazuje správnou a nesprávnou syntaxi:

Správně: "<text>/@{<function-name>('<parameter-name>')}/<text>"

Nesprávná odpověď: "<text>/@<function-name>('<parameter-name>')/<text>"

OK: "@<function-name>('<parameter-name>')"

Následující části uspořádají funkce na základě jejich obecného účelu nebo můžete tyto funkce procházet v abecedním pořadí.

Funkce řetězců

Pro práci s řetězci můžete použít tyto řetězcové funkce a také některé funkce kolekce. Řetězcové funkce fungují jenom na řetězcích.

Řetězcová funkce	Úloha
chunk	Rozdělte řetězec nebo kolekci na bloky stejné délky.
Concat	Zkombinujte dva nebo více řetězců a vraťte sloučený řetězec.
Endswith	Zkontrolujte, jestli řetězec končí zadaným podřetězcem.
formatNumber	Vrátí číslo jako řetězec na základě zadaného formátu.
Identifikátor guid	Vygenerujte globálně jedinečný identifikátor (GUID) jako řetězec.
Indexof	Vrátí počáteční pozici podřetězdce.
isFloat	Vrátí logickou hodnotu, která určuje, jestli je řetězec číslo s plovoucí desetinnou čárkou.
isInt	Vrátí logickou hodnotu, která určuje, jestli je řetězec celé číslo.
Lastindexof	Vrátí počáteční pozici posledního výskytu podřetězdce.
length	Vrátí počet položek v řetězci nebo poli.
nthIndexOf	Vrátí počáteční pozici nebo hodnotu indexu, kde se v řetězci zobrazí n. výskyt podřetězce.
replace	Nahraďte podřetězce zadaným řetězcem a vraťte aktualizovaný řetězec.
slice	Vrátí podřetěc zadáním počáteční a koncové pozice nebo hodnoty. Viz také podřetěžce.
split	Vrátí pole, které obsahuje podřetězce oddělené čárkami, od většího řetězce založeného na zadaném znaku oddělovače v původním řetězci.
Startswith	Zkontrolujte, jestli řetězec začíná určitým podřetězcem.
Podřetězec	Vrátí znaky z řetězce počínaje zadanou pozicí. Viz také řez.
Tolower	Vrátí řetězec ve formátu malými písmeny.
Toupper	Vrátí řetězec ve formátu velkými písmeny.
Trim	Odeberte počáteční a koncové prázdné znaky z řetězce a vraťte aktualizovaný řetězec.

Funkce kolekcí

Pokud chcete pracovat s kolekcemi, obecně polemi, řetězci a někdy slovníky, můžete tyto funkce kolekce používat.

Funkce Kolekce	Úloha
chunk	Rozdělte řetězec nebo kolekci na bloky stejné délky.
Obsahuje	Zkontrolujte, jestli kolekce obsahuje konkrétní položku.
empty	Zkontrolujte, jestli je kolekce prázdná.
První	Vrátí první položku z kolekce.
Průsečíku	Vrátí kolekci, která obsahuje pouze společné položky v zadaných kolekcích.
Položky	Pokud se tato funkce zobrazí uvnitř opakující se akce nad polem, vrátí aktuální položku v poli během aktuální iterace akce.
join	Vrátí řetězec, který obsahuje všechny položky z pole oddělené zadaným znakem.
Poslední	Vrátí poslední položku z kolekce.
length	Vrátí počet položek v řetězci nebo poli.
reverse	Obrácení pořadí položek v poli
Přeskočit	Odeberte položky z přední části kolekce a vraťte všechny ostatní položky.
sort	Seřaďte položky v kolekci.
vzít	Vrátí položky z přední části kolekce.
Unie	Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí.

Logické srovnávací funkce

Pokud chcete pracovat s podmínkami, porovnávat hodnoty a výsledky výrazů nebo vyhodnocovat různé druhy logiky, můžete použít tyto logické porovnávací funkce. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Poznámka:

Pokud k porovnání hodnot používáte logické funkce nebo podmínky, hodnoty null se převedou na prázdné hodnoty řetězce (""). Chování podmínek se liší při porovnávání s prázdným řetězcem místo hodnoty null. Další informace najdete v řetězcové funkci.

Logická funkce porovnání	Úloha
and	Zkontrolujte, jestli jsou všechny výrazy pravdivé.
equals	Zkontrolujte, jestli jsou obě hodnoty ekvivalentní.
greater	Zkontrolujte, jestli je první hodnota větší než druhá hodnota.
greaterOrEquals	Zkontrolujte, jestli je první hodnota větší nebo rovna druhé hodnotě.
Pokud	Zkontrolujte, jestli je výraz pravdivý nebo nepravda. Na základě výsledku vrátí zadanou hodnotu.
isFloat	Vrátí logickou hodnotu, která určuje, jestli je řetězec číslo s plovoucí desetinnou čárkou.
isInt	Vrátí logickou hodnotu, která určuje, jestli je řetězec celé číslo.
less	Zkontrolujte, jestli je první hodnota menší než druhá hodnota.
lessOrEquals	Zkontrolujte, jestli je první hodnota menší nebo rovna druhé hodnotě.
not	Zkontrolujte, jestli je výraz nepravda.
nebo	Zkontrolujte, jestli je alespoň jeden výraz pravdivý.

Převodní funkce

Pokud chcete změnit typ nebo formát hodnoty, můžete použít tyto převodní funkce. Můžete například změnit hodnotu z logické hodnoty na celé číslo. Další informace o tom, jak Azure Logic Apps zpracovává typy obsahu během převodu, najdete v tématu Zpracování typů obsahu. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Poznámka:

Azure Logic Apps automaticky nebo implicitně provádí kódování a dekódování base64, takže tyto převody nemusíte provádět ručně pomocí funkcí kódování a dekódování. Pokud však tyto funkce přesto použijete v návrháři, může docházet k neočekávaným chování vykreslování v návrháři. Toto chování má vliv pouze na viditelnost funkcí a ne na jejich účinek, pokud neupravíte hodnoty parametrů funkcí, které z kódu odeberou funkce a jejich efekty. Další informace naleznete v tématu Implicitní převody datových typů.

Převodní funkce	Úloha
Pole	Vrátí pole z jednoho zadaného vstupu. Více vstupů naleznete v tématu createArray.
base64	Vrátí verzi zakódovanou v base64 pro řetězec.
base64ToBinary	Vrátí binární verzi řetězce s kódováním base64.
base64ToString	Vrátí verzi řetězce pro řetězec kódovaný v base64.
Binární	Vrátí binární verzi pro vstupní hodnotu.
bool	Vrátí logickou verzi pro vstupní hodnotu.
createArray	Vrátí pole z více vstupů.
identifikátor dataURI	Vrátí identifikátor URI dat pro vstupní hodnotu.
dataUriToBinary	Vrátí binární verzi identifikátoru URI dat.
dataUriToString	Vrátí verzi řetězce pro identifikátor URI dat.
decimal	Vrátí desetinné číslo pro desetinný řetězec.
decodeBase64	Vrátí verzi řetězce pro řetězec kódovaný v base64.
decodeDataUri	Vrátí binární verzi identifikátoru URI dat.
decodeUriComponent	Vrátí řetězec, který nahradí řídicí znaky dekódovanými verzemi.
encodeUriComponent	Vrátí řetězec, který nahradí nebezpečné znaky adresy URL řídicími znaky.
float	Vrátí číslo s plovoucí desetinou čárkou pro vstupní hodnotu.
int	Vrátí celočíselnou verzi řetězce.
Json	Vrátí hodnotu typu JSON (JavaScript Object Notation) nebo objekt pro řetězec nebo XML.
string	Vrátí verzi řetězce pro vstupní hodnotu.
uriComponent	Vrátí verzi zakódovanou identifikátorem URI pro vstupní hodnotu nahrazením nebezpečných znaků adresy URL řídicími znaky.
uriComponentToBinary	Vrátí binární verzi řetězce kódovaného identifikátorem URI.
uriComponentToString	Vrátí verzi řetězce pro řetězec kódovaný identifikátorem URI.
xml	Vrátí verzi XML pro řetězec.

Implicitní převody datových typů

Azure Logic Apps automaticky nebo implicitně převádí mezi některými datovými typy, takže tyto převody nemusíte provádět ručně. Pokud například použijete neřetězcové hodnoty, u kterých se řetězce očekávají jako vstupy, Azure Logic Apps automaticky převede neřetězcové hodnoty na řetězce.

Předpokládejme například, že trigger vrátí číselnou hodnotu jako výstup:

triggerBody()?['123']

Pokud použijete tento číselný výstup, ve kterém se očekává zadání řetězce, jako je adresa URL, Azure Logic Apps automaticky převede hodnotu na řetězec pomocí zápisu složených závorek ({}):

@{triggerBody()?['123']}

Kódování a dekódování Base64

Azure Logic Apps automaticky nebo implicitně provádí kódování nebo dekódování base64, takže tyto převody nemusíte provádět ručně pomocí odpovídajících funkcí:

base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)

Poznámka:

Pokud při použití návrháře ručně přidáte některou z těchto funkcí, ať už přímo k triggeru nebo akci, nebo pomocí editoru výrazů, přejdete od návrháře a pak se vrátíte k návrháři, funkce zmizí z návrháře a zůstane za pouze hodnotami parametrů. K tomuto chování dochází také v případě, že vyberete trigger nebo akci, která tuto funkci používá bez úprav hodnot parametrů funkce. Tento výsledek ovlivní jenom viditelnost funkce a ne efekt. V zobrazení kódu nemá tato funkce vliv. Pokud ale upravíte hodnoty parametrů funkce, funkce i její účinek se odeberou ze zobrazení kódu, takže zůstane za pouze hodnotami parametrů funkce.

Matematické funkce

Pokud chcete pracovat s celými čísly a plovoucími hodnotami, můžete použít tyto matematické funkce. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Matematické funkce	Úloha
add	Vrátí výsledek sčítání dvou čísel.
div	Vrátí výsledek dělení dvou čísel.
Max	Vrátí nejvyšší hodnotu ze sady čísel nebo pole.
Min	Vrátí nejnižší hodnotu ze sady čísel nebo pole.
Mod	Vrátí zbytek od dělení dvou čísel.
mul	Vrátí součin od vynásobení dvou čísel.
rand	Vrátí náhodné celé číslo ze zadaného rozsahu.
range	Vrátí celočíselnou matici, která začíná zadaným celočíselnou hodnotou.
Dílčí	Vrátí výsledek od odečtení druhého čísla od prvního čísla.

Funkce pro datum a čas

K práci s daty a časy můžete použít tyto funkce data a času. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Funkce data nebo času	Úloha
Adddays	Přidejte dny do časového razítka.
addHours	Přidejte hodiny do časového razítka.
Addminutes	Přidejte minuty do časového razítka.
addSeconds	Přidejte sekundy do časového razítka.
addToTime	Přidejte zadané časové jednotky do časového razítka. Viz také getFutureTime.
convertFromUtc	Převeďte časové razítko z standardu UTC (Universal Time Coordinated) na cílové časové pásmo.
convertTimeZone	Převeďte časové razítko ze zdrojového časového pásma na cílové časové pásmo.
convertToUtc	Převeďte časové razítko ze zdrojového časového pásma na standard UTC (Universal Time Coordinated).
dateDifference	Vrátí rozdíl mezi dvěma kalendářními daty jako časovým rozpětím.
denOfMonth	Vrátí den součásti měsíce z časového razítka.
Dayofweek	Vrátí součást dne v týdnu z časového razítka.
Dayofyear	Vrátí den v roce z časového razítka.
formatDateTime	Vrátí datum z časového razítka.
getFutureTime	Vrátí aktuální časové razítko a zadané časové jednotky. Viz také addToTime.
getPastTime	Vrátí aktuální časové razítko minus zadané časové jednotky. Viz také odečítáníFromTime.
parseDateTime	Vrátí časové razítko z řetězce, který obsahuje časové razítko.
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.
odečístFromTime	Odečte počet časových jednotek od časového razítka. Viz také getPastTime.
Klíšťata	`ticks` Vrátí hodnotu vlastnosti pro zadané časové razítko.
UtcNow	Vrátí aktuální časové razítko jako řetězec.

Funkce pracovních postupů

Tyto funkce pracovního postupu vám můžou pomoct:

Získejte podrobnosti o instanci pracovního postupu za běhu.
Pracujte se vstupy používanými k vytváření instancí aplikací logiky nebo toků.
Odkazujte na výstupy z triggerů a akcí.

Můžete například odkazovat na výstupy z jedné akce a tato data použít v pozdější akci. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Funkce pracovních postupů	Úloha
action	Vrátí výstup aktuální akce za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON. Viz také akce.
actionBody	Vrátí výstup akce `body` za běhu. Viz také tělo.
ActionOutputs	Vrátí výstup akce za běhu. Podívejte se na výstupy a akce.
Akce	Vrátí výstup akce za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON. Viz také akce.
tělo	Vrátí výstup akce `body` za běhu. Viz také actionBody.
formDataMultiValues	Vytvořte pole s hodnotami, které odpovídají názvu klíče ve výstupech akcí s daty formuláře nebo kódovanými formulářem.
formDataValue	Vrátí jednu hodnotu, která odpovídá názvu klíče ve výstupu s daty formuláře nebo kódovaným formulářem akce.
Položky	Pokud se tato funkce zobrazí uvnitř opakující se akce nad polem, vrátí aktuální položku v poli během aktuální iterace akce.
Položky	Pokud se tato funkce zobrazí uvnitř smyčky Foreach nebo Until, vrátí aktuální položku ze zadané smyčky.
iterationIndexes	Pokud se tato funkce zobrazí uvnitř smyčky Until, vrátí hodnotu indexu pro aktuální iteraci. Tuto funkci můžete použít uvnitř vnořených smyček Until.
listCallbackUrl	Vrátí adresu URL zpětného volání, která volá trigger nebo akci.
multipartBody	Vrátí tělo pro určitou část ve výstupu akce, který má více částí.
Výstupy	Vrátí výstup akce za běhu.
parameters	Vrátí hodnotu parametru popsaného v definici pracovního postupu.
Výsledek	Vrátí vstupy a výstupy z akcí nejvyšší úrovně uvnitř zadané akce s vymezeným oborem, například `For_each`, `Until`a `Scope`.
Aktivační událost	Vrátí výstup triggeru za běhu nebo z jiných dvojic názvů a hodnot JSON. Viz také triggerOutputs a triggerBody.
triggerBody	Vrátí výstup triggeru `body` za běhu. Viz trigger.
triggerFormDataValue	Vrátí jednu hodnotu odpovídající názvu klíče ve výstupech aktivačních událostí s daty formuláře nebo kódovanými formulářem.
triggerMultipartBody	Vrátí tělo pro určitou část ve výstupu vícedílné části triggeru.
triggerFormDataMultiValues	Vytvořte pole, jehož hodnoty odpovídají názvu klíče ve výstupech aktivačních událostí zakódovaných ve formulářových datech nebo ve formátu.
triggerOutputs	Vrátí výstup triggeru za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON. Viz trigger.
Proměnné	Vrátí hodnotu pro zadanou proměnnou.
Pracovního postupu	Vrátí všechny podrobnosti o samotném pracovním postupu během běhu.

Funkce analýzy identifikátorů URI

Pokud chcete pracovat s identifikátory URI (Uniform Resource Identifier) a získat různé hodnoty vlastností pro tyto identifikátory URI, můžete použít tyto funkce analýzy identifikátorů URI. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Funkce analýzy identifikátoru URI	Úloha
uriHost	`host` Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).
uriPath	`path` Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).
uriPathAndQuery	`path` Vrátí hodnoty identifikátoru `query` URI (Uniform Resource Identifier).
uriPort	`port` Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).
uriQuery	`query` Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).
uriScheme	`scheme` Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

Manipulační funkce: JSON a XML

Pokud chcete pracovat s objekty JSON a uzly XML, můžete použít tyto funkce pro manipulaci. Úplný odkaz na jednotlivé funkce najdete v abecedním seznamu.

Funkce manipulace	Úloha
addProperty	Přidejte vlastnost a její hodnotu nebo dvojici name-value do objektu JSON a vraťte aktualizovaný objekt.
Coalesce	Vrátí první hodnotu, která není null, z jednoho nebo více parametrů.
removeProperty	Odeberte vlastnost z objektu JSON a vraťte aktualizovaný objekt.
Setproperty	Nastavte hodnotu vlastnosti objektu JSON a vraťte aktualizovaný objekt.
Xpath	Zkontrolujte kód XML pro uzly nebo hodnoty, které odpovídají výrazu XPath (XML Path Language) a vrátí odpovídající uzly nebo hodnoty.

---------------------------------

Všechny funkce – abecední seznam

V této části jsou uvedeny všechny dostupné funkce v abecedním pořadí.

A

action

Vrátí výstup aktuální akce za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON, které můžete přiřadit k výrazu. Ve výchozím nastavení tato funkce odkazuje na celý objekt akce, ale volitelně můžete zadat vlastnost, jejíž hodnotu chcete. Viz také akce().

Funkci můžete použít action() pouze na těchto místech:

Vlastnost unsubscribe akce webhooku, abyste k výsledku získali přístup z původního subscribe požadavku.
Vlastnost trackedProperties akce
Podmínka do-until smyčky pro akci

action()
action().outputs.body.<property>

Parametr	Požaduje se	Type	Popis
<vlastnost>	No	String	Název vlastnosti objektu akce, jehož hodnotu chcete: name, startTime, endTime, vstupy, výstupy, stav, kód, trackingId a clientTrackingId. Na webu Azure Portal najdete tyto vlastnosti tak, že si projdete podrobnosti konkrétní historie spuštění. Další informace najdete v tématu REST API – Akce spuštění pracovního postupu.

Vrácená hodnota	Typ	Popis
<action-output>	String	Výstup z aktuální akce nebo vlastnosti

actionBody

Vrátí výstup akce body za běhu. Zkratka pro actions('<actionName>').outputs.body. Viz body() a actions().

actionBody('<actionName>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název požadovaného `body` výstupu akce

Vrácená hodnota	Typ	Popis
<action-body-output>	String	Výstup `body` ze zadané akce

Příklad

Tento příklad získá body výstup z akce Get userTwitteru:

actionBody('Get_user')

A vrátí tento výsledek:

"body": {
  "FullName": "Contoso Corporation",
  "Location": "Generic Town, USA",
  "Id": 283541717,
  "UserName": "ContosoInc",
  "FollowersCount": 172,
  "Description": "Leading the way in transforming the digital workplace.",
  "StatusesCount": 93,
  "FriendsCount": 126,
  "FavouritesCount": 46,
  "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

ActionOutputs

Vrátí výstup akce za běhu. a je zkratka pro actions('<actionName>').outputs. Viz actions(). Funkce actionOutputs() se v návrháři přeloží outputs() , proto zvažte použití výstupů() místo actionOutputs(). I když obě funkce fungují stejným způsobem, outputs() preferuje se.

actionOutputs('<actionName>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název požadovaného výstupu akce

Vrácená hodnota	Typ	Popis
<Výstup>	String	Výstup ze zadané akce

Příklad

Tento příklad získá výstup z akce Get userTwitteru:

actionOutputs('Get_user')

A vrátí tento výsledek:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

akce

Vrátí výstup akce za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON, které můžete přiřadit k výrazu. Ve výchozím nastavení funkce odkazuje na celý objekt akce, ale volitelně můžete zadat vlastnost, jejíž hodnotu chcete. Zkrácené verze naleznete v části actionBody(), actionOutputs() a body(). Aktuální akci naleznete v části action().

Tip

Funkce actions() vrátí výstup jako řetězec. Pokud potřebujete pracovat s vrácenou hodnotou jako objekt JSON, musíte nejprve převést řetězcovou hodnotu. Hodnotu řetězce můžete transformovat na objekt JSON pomocí akce Parsovat JSON.

Poznámka:

Dříve můžete použít actions() funkci nebo conditions prvek při určení, že akce běžela na základě výstupu jiné akce. Chcete-li však deklarovat explicitní závislosti mezi akcemi, musíte nyní použít vlastnost závislé akce runAfter . Další informace o runAfter vlastnosti naleznete v tématu Catch a handle selhání pomocí runAfter vlastnost.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název objektu akce, jehož výstup chcete
<vlastnost>	No	String	Název vlastnosti objektu akce, jehož hodnotu chcete: name, startTime, endTime, vstupy, výstupy, stav, kód, trackingId a clientTrackingId. Na webu Azure Portal najdete tyto vlastnosti tak, že si projdete podrobnosti konkrétní historie spuštění. Další informace najdete v tématu REST API – Akce spuštění pracovního postupu.

Vrácená hodnota	Typ	Popis
<action-output>	String	Výstup ze zadané akce nebo vlastnosti

Příklad

Tento příklad získá status hodnotu vlastnosti z akce Get user Twitteru za běhu:

actions('Get_user').outputs.body.status

A vrátí tento výsledek: "Succeeded"

add

Vrátí výsledek sčítání dvou čísel.

add(<summand_1>, <summand_2>)

Parametr	Požaduje se	Type	Popis
<>summand_1, <summand_2>	Ano	Celé číslo, plovoucí nebo smíšené	Čísla, která se mají sčítat

Vrácená hodnota	Typ	Popis
<result-sum>	Celé číslo nebo plovoucí číslo	Výsledek sčítání zadaných čísel

Příklad

Tento příklad sečte zadaná čísla:

add(1, 1.5)

A vrátí tento výsledek: 2.5

Adddays

Přidejte dny do časového razítka.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<Dní>	Ano	Celé číslo	Počet kladných nebo záporných dnů, které se mají přidat
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Časové razítko plus zadaný počet dnů

Příklad 1

Tento příklad přidá 10 dní do zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-25T00:00: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:00.0000000Z"

addHours

Přidejte hodiny do časového razítka.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<hours>	Ano	Celé číslo	Počet kladných nebo záporných hodin, které se mají přidat
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Č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: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:00.0000000Z"

Addminutes

Přidejte minuty do časového razítka.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<minutes>	Ano	Celé číslo	Počet kladných nebo záporných minut, které se mají přidat
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Časové razítko plus zadaný počet minut

Příklad 1

Tento příklad přidá 10 minut do zadaného časového razítka:

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"

addProperty

Přidejte vlastnost a její hodnotu nebo dvojici name-value do objektu JSON a vraťte aktualizovaný objekt. Pokud vlastnost již existuje za běhu, funkce selže a vyvolá chybu.

addProperty(<object>, '<property>', <value>)

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, do kterého chcete přidat vlastnost
<vlastnost>	Ano	String	Název vlastnosti, která se má přidat
<value>	Ano	Všechny	Hodnota vlastnosti

Vrácená hodnota	Typ	Popis
<updated-object>	Object	Aktualizovaný objekt JSON se zadanou vlastností

Chcete-li přidat nadřazenou vlastnost do existující vlastnosti, použijte setProperty() funkci, nikoli addProperty() funkci. V opačném případě vrátí funkce jako výstup pouze podřízený objekt.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, do kterého chcete přidat vlastnost
<parent-property>	Ano	String	Název nadřazené vlastnosti, do které chcete přidat podřízenou vlastnost
<child-property>	Ano	String	Název podřízené vlastnosti, která se má přidat
<value>	Ano	Všechny	Hodnota nastavená pro zadanou vlastnost

Vrácená hodnota	Typ	Popis
<updated-object>	Object	Aktualizovaný objekt JSON, jehož vlastnost jste nastavili

Příklad 1

Tento příklad přidá middleName vlastnost do objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON(). Objekt již obsahuje firstName vlastnosti a surName vlastnosti. Funkce přiřadí zadanou hodnotu nové vlastnosti a vrátí aktualizovaný objekt:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

Tady je aktuální objekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Tady je aktualizovaný objekt JSON:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Příklad 2

Tento příklad přidá podřízenou middleName vlastnost do existující customerName vlastnosti v objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON(). Funkce přiřadí zadanou hodnotu nové vlastnosti a vrátí aktualizovaný objekt:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

Tady je aktuální objekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

Tady je aktualizovaný objekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

Přidejte sekundy do časového razítka.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<Sekund>	Ano	Celé číslo	Počet kladných nebo záporných sekund, které se mají přidat
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Č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 od zadaného časového razítka:

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

A vrátí tento výsledek: "2018-03-15T00:00:25.0000000Z"

addToTime

Přidejte zadané časové jednotky do časového razítka. Viz také getFutureTime().

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<interval>	Ano	Celé číslo	Počet zadaných časových jednotek, které se mají přidat
<timeUnit>	Ano	String	Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Č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

Zkontrolujte, jestli jsou všechny výrazy pravdivé. Vrátí hodnotu true, pokud jsou všechny výrazy pravdivé, nebo vrátí hodnotu false, pokud je alespoň jeden výraz false.

and(<expression1>, <expression2>, ...)

Parametr	Požaduje se	Type	Popis
<výraz1>, <výraz2>, ...	Ano	Logická hodnota	Výrazy ke kontrole

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true, pokud jsou splněny všechny výrazy. Vrátí hodnotu false, pokud je alespoň jeden výraz false.

Příklad 1

Tyto příklady kontrolují, jestli 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 jsou pravdivé, takže vrátí true.
Druhý příklad: Jeden výraz je false, takže vrátí false.
Třetí příklad: Oba výrazy jsou false, takže vrátí false.

Příklad 2

Tyto příklady kontrolují, 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 false, takže vrátí false.
Třetí příklad: Oba výrazy jsou false, takže vrátí false.

pole

Vrátí pole z jednoho zadaného vstupu. Více vstupů najdete v tématu createArray().

array('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec pro vytvoření pole

Vrácená hodnota	Typ	Popis
[<hodnota>]	Pole	Pole obsahující jeden zadaný vstup

Příklad

Tento příklad vytvoří pole z řetězce "hello":

array('hello')

A vrátí tento výsledek: ["hello"]

T

base64

Vrátí verzi zakódovanou v base64 pro řetězec.

Poznámka:

Azure Logic Apps automaticky nebo implicitně provádí kódování a dekódování base64, takže tyto převody nemusíte provádět ručně pomocí funkcí kódování a dekódování. Pokud ale tyto funkce přesto používáte, může dojít k neočekávanému chování vykreslování v návrháři. Toto chování má vliv pouze na viditelnost funkcí a ne na jejich účinek, pokud neupravíte hodnoty parametrů funkcí, které z kódu odeberou funkce a jejich efekty. Další informace naleznete v tématu Kódování a dekódování Base64.

base64('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Vstupní řetězec

Vrácená hodnota	Typ	Popis
<base64-string>	String	Verze kódovaná v 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.

Poznámka:

base64ToBinary('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec s kódováním base64 pro převod

Vrácená hodnota	Typ	Popis
<binary-for-base64-string>	String	Binární verze řetězce s kódováním base64

Příklad

Tento příklad převede řetězec s kódováním base64 "aGVsbG8=" na binární řetězec:

base64ToBinary('aGVsbG8=')

Předpokládejme například, že k odeslání požadavku používáte akci HTTP. Můžete použít base64ToBinary() k převodu řetězce s kódováním base64 na binární data a odeslání dat pomocí application/octet-stream typu obsahu v požadavku.

base64ToString

Vrátí verzi řetězce pro řetězec s kódováním base64 a dekóduje řetězec base64. Tuto funkci použijte místo dekódováníBase64(), která je zastaralá.

Poznámka:

base64ToString('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec kódovaný v base64 pro dekódování

Vrácená hodnota	Typ	Popis
<dekódovaný řetězec base64>	String	Verze řetězce pro řetězec kódovaný v base64

Příklad

Tento příklad převede řetězec s kódováním base64 "aGVsbG8=" na pouze řetězec:

base64ToString('aGVsbG8=')

A vrátí tento výsledek: "hello"

binární

Vrátí binární verzi řetězce s kódováním base64.

binary('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec, který se má převést

Vrácená hodnota	Typ	Popis
<binary-for-input-value>	String	Binární verze s kódováním base64 pro zadaný řetězec

Příklad

Například používáte akci HTTP, která vrací obrázek nebo videosoubor. Tuto hodnotu můžete použít binary() k převodu hodnoty na model obálky obsahu s kódováním base-64. Pak můžete obálku obsahu znovu použít v jiných akcích, například Compose. Tento výraz funkce můžete použít k odeslání bajtů řetězců s typem application/octet-stream obsahu v požadavku.

text

Vrátí výstup akce body za běhu. Zkratka pro actions('<actionName>').outputs.body. Viz actionBody() a actions().

body('<actionName>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název požadovaného `body` výstupu akce

Vrácená hodnota	Typ	Popis
<action-body-output>	String	Výstup `body` ze zadané akce

Příklad

Tento příklad získá body výstup z akce Twitteru Get user :

body('Get_user')

A vrátí tento výsledek:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

bool

Vrátí logickou verzi hodnoty.

bool(<value>)

Parametr	Požaduje se	Type	Popis
<value>	Ano	Všechny	Hodnota, která se má převést na logickou hodnotu.

Pokud používáte bool() s objektem, hodnota objektu musí být řetězec nebo celé číslo, které lze převést na logickou hodnotu.

Vrácená hodnota	Typ	Popis
`true` nebo `false`	Logická hodnota	Logická verze zadané hodnoty.

Výstupy

Tyto příklady ukazují různé podporované typy vstupu pro bool():

Vstupní hodnota	Typ	Vrácená hodnota
`bool(1)`	Celé číslo	`true`
`bool(0)`	Celé číslo	`false`
`bool(-1)`	Celé číslo	`true`
`bool('true')`	String	`true`
`bool('false')`	Řetězcové	`false`

C

chunk

Rozdělte řetězec nebo pole na bloky se stejnou délkou.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec nebo pole	Kolekce, která se má rozdělit
<length>	Ano	Délka každého bloku dat

Vrácená hodnota	Typ	Popis
<Kolekce>	Pole	Pole bloků dat se zadanou délkou

Příklad 1

Tento příklad rozdělí řetězec na bloky o délce 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

A vrátí tento výsledek: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Příklad 2

Tento příklad rozdělí pole na bloky o délce 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

A vrátí tento výsledek: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

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 nemají hodnotu null.

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

Parametr	Požaduje se	Type	Popis
<>object_1, <object_2>, ...	Ano	Libovolná, můžou kombinovat typy	Jedna nebo více položek ke kontrole hodnoty null

Vrácená hodnota	Typ	Popis
<first-non-null-item>	Všechny	První položka nebo hodnota, která nemá hodnotu null. Pokud jsou všechny parametry null, vrátí tato funkce hodnotu null.

Příklad

Tyto příklady vrátí první hodnotu, která není null ze zadaných hodnot, nebo 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

Zkombinujte dva nebo více řetězců a vraťte sloučený řetězec.

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

Parametr	Požaduje se	Type	Popis
<text1>, <text2>, ...	Ano	String	Aspoň dva řetězce ke kombinování

Vrácená hodnota	Typ	Popis
<text1text2...>	String	Řetězec vytvořený z kombinovaných vstupních řetězců. Poznámka: Délka výsledku nesmí překročit 104 857 600 znaků.

Poznámka:

Azure Logic Apps automaticky nebo implicitně provádí kódování a dekódování base64, takže při použití concat() funkce s daty, která potřebují kódování nebo dekódování, nemusíte tyto převody provádět ručně:

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

Pokud však tuto funkci přesto použijete v návrháři, může dojít k neočekávanému chování vykreslování v návrháři. Toto chování má vliv pouze na viditelnost funkce, a ne na efekt, pokud neupravíte hodnoty parametrů funkce, která funkci a efekt z kódu odebere. Další informace najdete v tématu Kódování a dekódování Base64.

Příklad

Tento příklad kombinuje řetězce "Hello" a "World":

concat('Hello', 'World')

A vrátí tento výsledek: "HelloWorld"

obsahuje

Zkontrolujte, jestli kolekce obsahuje konkrétní položku. Vrátí hodnotu true při nalezení položky nebo vrátí hodnotu false, pokud nebyla nalezena. Tato funkce rozlišují malá a velká 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 pro vyhledání hodnoty
Slovník pro vyhledání klíče

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	String, Array nebo Dictionary	Kolekce, která se má zkontrolovat
<value>	Ano	String, Array nebo Dictionary	Položka, která se má najít

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true, když se položka najde. Vrátí hodnotu false, pokud nebyla nalezena.

Příklad 1

Tento příklad zkontroluje řetězec "hello world" pro podřetězce "world" a vrátí hodnotu true:

contains('hello world', 'world')

Příklad 2

Tento příklad zkontroluje řetězec "hello world" pro podřetězce "universe" a vrátí hodnotu false:

contains('hello world', 'universe')

convertFromUtc

Převeďte časové razítko z standardu UTC (Universal Time Coordinated) na cílové časové pásmo.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<Destinationtimezone>	Ano	String	Název cílového časového pásma. Názvy časových pásem najdete v části Výchozí časová pásma systému Microsoft Windows.
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<převedené časové razítko>	String	Časové razítko se převedlo na cílové časové pásmo bez posunu UTC.

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:00.0000000"

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	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<Sourcetimezone>	Ano	String	Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Výchozí časová pásma systému Microsoft Windows, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<Destinationtimezone>	Ano	String	Název cílového časového pásma. Názvy časových pásem najdete v tématu Výchozí časová pásma systému Microsoft Windows, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<převedené časové razítko>	String	Č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-01T80: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 standard UTC (Universal Time Coordinated).

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<Sourcetimezone>	Ano	String	Název zdrojového časového pásma. Názvy časových pásem najdete v tématu Výchozí časová pásma systému Microsoft Windows, ale možná budete muset odebrat jakoukoli interpunkci z názvu časového pásma.
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<převedené časové razítko>	String	Časové razítko se převedlo 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ů. Informace o jednotlivých vstupních polích najdete v části array().

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

Parametr	Požaduje se	Type	Popis
<object1>, <object2>, ...	Ano	Libovolná, ale ne smíšená	Vytvoření pole nejméně dvěma položkami

Vrácená hodnota	Typ	Popis
[<object1>, <object2>, ...]	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"]

D

identifikátor dataURI

Vrátí identifikátor URI (Uniform Resource Identifier) dat pro řetězec.

dataUri('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec, který se má převést

Vrácená hodnota	Typ	Popis
<data-uri>	String	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 identifikátoru URI (Data Uniform Resource Identifier). Tuto funkci použijte místo dekódováníDataUri(). I když obě funkce fungují stejným způsobem, dataUriBinary() preferuje se.

dataUriToBinary('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Identifikátor URI dat, který se má převést

Vrácená hodnota	Typ	Popis
<binary-for-data-uri>	String	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 identifikátor URI (Uniform Resource Identifier) dat.

dataUriToString('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Identifikátor URI dat, který se má převést

Vrácená hodnota	Typ	Popis
<string-for-data-uri>	String	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"

dateDifference

Vrátí rozdíl mezi dvěma časovými razítky jako časovým rozpětím. Tato funkce odečte startDate od endDatefunkce a vrátí výsledek jako časové razítko ve formátu řetězce.

dateDifference('<startDate>', '<endDate>')

Parametr	Požaduje se	Type	Popis
<startDate>	Ano	String	Řetězec obsahující časové razítko
<endDate>	Ano	String	Řetězec obsahující časové razítko

Vrácená hodnota	Typ	Popis
<Timespan>	String	Rozdíl mezi dvěma časovými razítky, což je časové razítko ve formátu řetězce. Pokud `startDate` je novější než `endDate`, výsledek je záporná hodnota.

Příklad

Tento příklad odečte první hodnotu od druhé hodnoty:

dateDifference('2015-02-08', '2018-07-30')

A vrátí tento výsledek: "1268.00:00:00"

denOfMonth

Vrátí den v měsíci z časového razítka.

dayOfMonth('<timestamp>')

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko

Vrácená hodnota	Typ	Popis
<den v měsíci>	Celé číslo	Den v měsíci ze zadaného časového razítka

Příklad

Tento příklad vrátí číslo pro den 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	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko

Vrácená hodnota	Typ	Popis
<den v týdnu>	Celé číslo	Den v týdnu od zadaného časového razítka, kde je neděle 0, pondělí je 1 atd.

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: 4

Dayofyear

Vrátí den v roce z časového razítka.

dayOfYear('<timestamp>')

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko

Vrácená hodnota	Typ	Popis
<day-of-year>	Celé číslo	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

decimal

Vrátí desetinné číslo v řetězci jako desítkové číslo. Tuto funkci můžete použít při práci s daty vyžadujícími desetinnou přesnost a také jako vstup pro logické porovnávací funkce a matematické funkce. Pokud chcete zachytit a zachovat přesnost při použití výsledku funkce decimal(), zabalte libovolný desetinný výstup s řetězcovou funkcí. Toto použití je znázorněno v následujících příkladech, kde můžete ztratit přesnost, pokud použijete desetinný výsledek jako číslo.

Poznámka:

Desetinná přesnost popisovaná v kontextu pro tuto funkci a modul runtime Azure Logic Apps je stejný jako desetinná přesnost .NET.

decimal('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Desetinné číslo v řetězci

Vrácená hodnota	Typ	Popis
<decimal>	Desetinné číslo	Desetinné číslo vstupního řetězce

Příklad 1

Tento příklad vytvoří desítkové číslo, které se použije jako číslo:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Příklad 2

Tento příklad vytvoří desítkové číslo a pak převede výsledek na řetězec pro zachování přesnosti:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

Příklad 3

Tento příklad používá matematickou funkci na dvou desetinných číslech a výsledek použije jako číslo:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

Příklad 4

Tento příklad používá matematickou funkci na dvou desetinných číslech a převede výsledek na řetězec pro zachování přesnosti:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64 (zastaralé)

Tato funkce je zastaralá, proto místo toho použijte base64ToString().

decodeDataUri

Vrátí binární verzi identifikátoru URI (Data Uniform Resource Identifier). Zvažte použití dataUriToBinary() místo decodeDataUri(). I když obě funkce fungují stejným způsobem, dataUriToBinary() preferuje se.

Poznámka:

decodeDataUri('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec identifikátoru URI dat pro dekódování

Vrácená hodnota	Typ	Popis
<binary-for-data-uri>	String	Binární verze řetězce identifikátoru URI dat

Příklad

Tento příklad vrátí binární verzi tohoto identifikátoru URI dat:

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

A vrátí tento výsledek:

decodeUriComponent

Vrátí řetězec, který nahradí řídicí znaky dekódovanými verzemi.

decodeUriComponent('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec s řídicími znaky pro dekódování

Vrácená hodnota	Typ	Popis
<dekódovaný identifikátor URI>	String	Aktualizovaný řetězec s dekódovanými řídicími znaky

Příklad

Tento příklad nahradí řídicí znaky v tomto řetězci dekódovanými verzemi:

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

A vrátí tento výsledek: "https://contoso.com"

div

Vrátí výsledek dělení dvou čísel. Pokud chcete získat výsledek zbytku, podívejte se na mod().

div(<dividend>, <divisor>)

Parametr	Požaduje se	Type	Popis
<Dividenda>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které se má dělit dělitelem
<Dělitel>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které dělí dividendu, ale nemůže být nula

Vrácená hodnota	Typ	Popis
<quotient-result>	Celé číslo nebo plovoucí číslo	Výsledek vydělení prvního čísla druhým číslem. Pokud má dělitel dělitel typ Float, výsledek má typ Float. Poznámka: Pokud chcete převést výsledek float na celé číslo, zkuste vytvořit a volat funkci v Azure z aplikace logiky.

Příklad 1

Obě příklady vrátí tuto hodnotu s celočíselnou hodnotou: 2

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

Příklad 2

Oba příklady vrátí tuto hodnotu s typem Float: 2.2

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

Vrácení verze zakódovaného identifikátoru URI (Uniform Resource Identifier) pro řetězec nahrazením nebezpečných znaků ADRESY URL řídicími znaky. Zvažte použití funkce uriComponent() místo encodeUriComponent(). I když obě funkce fungují stejným způsobem, uriComponent() preferuje se.

Poznámka:

encodeUriComponent('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec pro převod na formát kódovaný identifikátorem URI

Vrácená hodnota	Typ	Popis
<encoded-uri>	String	Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

Tento příklad vytvoří verzi kódovanou identifikátorem URI pro tento řetězec:

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

A vrátí tento výsledek: "https%3A%2F%2Fcontoso.com"

empty

Zkontrolujte, 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	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec, pole nebo objekt	Kolekce, která se má zkontrolovat

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true, 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á prázdný řetězec, takže funkce vrátí true.
Druhý příklad: Předá řetězec "abc", takže funkce vrátí false.

Endswith

Zkontrolujte, jestli řetězec končí určitým podřetězcem. Vrátí hodnotu true při nalezení podřetětěce nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce nerozlišuje malá a velká písmena.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který chcete zkontrolovat
<searchText>	Ano	String	Koncový podřetětěc, který se má najít

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true při nalezení koncového podřetětěce. Vrátí hodnotu false, pokud nebyla nalezena.

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

rovná se

Zkontrolujte, jestli jsou obě 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	Požaduje se	Type	Popis
<object1>, <object2>	Ano	Různé	Hodnoty, výrazy nebo objekty pro porovnání

Vrácená hodnota	Typ	Popis
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í, jestli 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.

F

1\.

Vrátí první položku z řetězce nebo pole.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec nebo pole	Kolekce, kde najít první položku

Vrácená hodnota	Typ	Popis
<first-collection-item>	Všechny	První položka v kolekci

Příklad

V těchto příkladech najdete 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 (číslo s plovoucí řádovou čárkou)

Převede verzi řetězce čísla s plovoucí desetinnou čárkou na skutečné číslo s plovoucí desetinnou čárkou. Tuto funkci můžete použít jenom při předávání vlastních parametrů do aplikace, například pracovního postupu aplikace logiky nebo toku Power Automate. Pokud chcete převést řetězce s plovoucí desetinnou čárkou reprezentované ve formátech specifických pro národní prostředí, můžete volitelně zadat kód národního prostředí RFC 4646.

float('<value>', '<locale>'?)

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec, který má platné číslo s plovoucí desetinnou čárkou pro převod. Minimální a maximální hodnoty jsou stejné jako limity pro datový typ float.
<locale>	No	String	Kód národního prostředí RFC 4646, který se má použít. Pokud není zadáno, použije se výchozí národní prostředí. Pokud národní prostředí není platná hodnota, vygeneruje se chyba, že zadané národní prostředí není platné nebo nemá přidružené národní prostředí.

Vrácená hodnota	Typ	Popis
<float-value>	Float	Číslo s plovoucí desetinnou čárkou pro zadaný řetězec. Minimální a maximální hodnoty jsou stejné jako limity pro datový typ float.

Příklad 1

Tento příklad vytvoří verzi řetězce pro toto číslo s plovoucí desetinnou čárkou:

float('10,000.333')

A vrátí tento výsledek: 10000.333

Příklad 2

Tento příklad vytvoří verzi řetězce pro toto číslo s plovoucí desetinnou čárkou ve stylu němčiny:

float('10.000,333', 'de-DE')

A vrátí tento výsledek: 10000.333

formatDateTime

Vrátí časové razítko v zadaném formátu.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.
<locale>	No	String	Národní prostředí, které se má použít Pokud není zadáno, hodnota je `en-us`. Pokud národní prostředí není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<přeformátované časové razítko>	String	Aktualizované časové razítko v zadaném formátu a národním prostředí, pokud je zadané.

Příklady

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

Vrátí pole s hodnotami, které odpovídají názvu klíče ve výstupu s daty formuláře nebo kódovanými formuláři akce.

formDataMultiValues('<actionName>', '<key>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Akce, jejíž výstup má požadovanou hodnotu klíče.
<key>	Ano	String	Název klíče, jehož hodnotu chcete použít

Vrácená hodnota	Typ	Popis
[<array-with-key-values>]	Pole	Pole se všemi hodnotami, které odpovídají zadanému klíči

Příklad

Tento příklad vytvoří pole z hodnoty klíče předmětu ve výstupu formuláře nebo zakódovaného formuláře zadané akce:

formDataMultiValues('Send_an_email', 'Subject')

A vrátí text předmětu v poli, například: ["Hello world"]

formDataValue

Vrátí jednu hodnotu, která odpovídá názvu klíče ve výstupu s daty formuláře nebo kódovaným formulářem akce. Pokud funkce najde více než jednu shodu, vyvolá funkce chybu.

formDataValue('<actionName>', '<key>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Akce, jejíž výstup má požadovanou hodnotu klíče.
<key>	Ano	String	Název klíče, jehož hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<klíč-hodnota>	String	Hodnota v zadaném klíči

Příklad

Tento příklad vytvoří řetězec z hodnoty klíče Předmět ve výstupu zadané akce s daty formuláře nebo kódovanými formulářem:

formDataValue('Send_an_email', 'Subject')

A vrátí text předmětu jako řetězec, například: "Hello world"

formatNumber

Vrátí číslo jako řetězec založený na zadaném formátu.

formatNumber(<number>, <format>, <locale>?)

Parametr	Požaduje se	Type	Popis
<Číslo>	Ano	Celé číslo nebo Double	Hodnota, kterou chcete formátovat.
<format>	Ano	String	Složený formátovací řetězec, který určuje formát, který chcete použít. Podporované řetězce číselného formátu naleznete v tématu Standardní řetězce číselného formátu, které jsou podporovány`number.ToString(<format>, <locale>)` .
<locale>	No	String	Národní prostředí, které má být podporováno `number.ToString(<format>, <locale>)`. Pokud není zadáno, hodnota je `en-us`. Pokud národní prostředí není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<formátované číslo>	String	Zadané číslo jako řetězec ve formátu, který jste zadali. Tuto návratovou hodnotu můžete přetypovat na hodnotu nebo `intfloat`.

Příklad 1

Předpokládejme, že chcete číslo naformátovat 1234567890. Tento příklad naformátuje toto číslo jako řetězec "1 234 567 890,00".

formatNumber(1234567890, '0,0.00', 'en-us')

*Příklad 2"

Předpokládejme, že chcete číslo naformátovat 1234567890. Tento příklad naformátuje číslo na řetězec 1.234.567.890 00.

formatNumber(1234567890, '0,0.00', 'is-is')

Příklad 3

Předpokládejme, že chcete číslo naformátovat 17.35. Tento příklad naformátuje číslo na řetězec "$17,35".

formatNumber(17.35, 'C2')

Příklad 4

Předpokládejme, že chcete číslo naformátovat 17.35. Tento příklad naformátuje číslo na řetězec "17,35 kr".

formatNumber(17.35, 'C2', 'is-is')

G

getFutureTime

Vrátí aktuální časové razítko a zadané časové jednotky.

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

Parametr	Požaduje se	Type	Popis
<interval>	Ano	Celé číslo	Počet časových jednotek, které se mají přidat
<timeUnit>	Ano	String	Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba, že zadaný formát není platný a musí to být řetězec číselného formátu.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	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.000000Z". 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.000000Z". Tento příklad přidá pět dnů a převede výsledek na formát "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	Požaduje se	Type	Popis
<interval>	Ano	Celé číslo	Počet zadaných časových jednotek, které se mají odečíst
<timeUnit>	Ano	String	Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Buď specifikátor jednoho formátu, nebo vlastní vzor formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba, že zadaný formát není platný a musí to být řetězec číselného formátu.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	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.000000Z". Tento příklad odečte pět dnů od tohoto časového razítka:

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.000000Z". Tento příklad odečte pět dnů a převede výsledek na formát "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	Požaduje se	Type	Popis
<value>	Ano	Celé číslo, float nebo řetězec	První hodnota, která zkontroluje, jestli je větší než druhá hodnota
<Compareto>	Ano	Celé číslo, Float nebo String	Porovnávací hodnota

Vrácená hodnota	Typ	Popis
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

Tyto příklady kontrolují, jestli je první hodnota větší než druhá hodnota:

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

A vrátí 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	Požaduje se	Type	Popis
<value>	Ano	Celé číslo, float nebo řetězec	První hodnota, která zkontroluje, jestli je větší nebo rovna druhé hodnotě
<Compareto>	Ano	Celé číslo, Float nebo String	Porovnávací hodnota

Vrácená hodnota	Typ	Popis
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

Tyto příklady kontrolují, jestli je první hodnota větší nebo rovna druhé hodnotě:

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

A vrátí tyto výsledky:

První příklad: true
Druhý příklad: false

guid

Vygenerujte globálně jedinečný identifikátor (GUID) jako řetězec, 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	Požaduje se	Type	Popis
<format>	No	String	Specifikátor jednoho 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	Popis
<Hodnota GUID>	String	Náhodně vygenerovaný identifikátor GUID

Příklad

Tento příklad vygeneruje stejný identifikátor GUID, ale jako 32 číslic oddělených pomlčkami a uzavřených v závorkách:

guid('P')

A vrátí tento výsledek: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Zkontrolujte, jestli je výraz pravdivý nebo nepravda. Na základě výsledku vrátí zadanou hodnotu. Parametry se vyhodnocují zleva doprava.

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

Parametr	Požaduje se	Type	Popis
<Výraz>	Ano	Logická hodnota	Výraz, který se má zkontrolovat
<valueIfTrue>	Ano	Všechny	Hodnota, která se má vrátit, když je výraz pravdivý
<valueIfFalse>	Ano	Všechny	Hodnota, která se má vrátit, když je výraz nepravda

Vrácená hodnota	Typ	Popis
<zadaná návratová hodnota>	Všechny	Zadaná hodnota, která se vrátí na základě toho, jestli je výraz pravdivý nebo nepravda

Příklad

Tento příklad vrátí hodnotu "yes" , protože zadaný výraz vrátí hodnotu true. V opačném případě vrátí "no"příklad:

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

Indexof

Vrátí počáteční pozici nebo hodnotu indexu podřetězdce. Tato funkce nerozlišuje malá a velká písmena a indexy začínají číslem 0.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec s podřetězcem, který se má najít
<searchText>	Ano	String	Podřetětěr, který se má najít

Vrácená hodnota	Typ	Popis
<index-value>	Celé číslo	Počáteční pozice nebo hodnota indexu pro zadaný podřetězdec. Pokud se řetězec nenajde, vraťte číslo -1.

Příklad

Tento příklad najde počáteční hodnotu indexu pro podřetězce "world" v řetězci "hello world":

indexOf('hello world', 'world')

A vrátí tento výsledek: 6

int

Převeďte verzi řetězce pro celé číslo na skutečné celé číslo.

int('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězcová verze celého čísla, která se má převést. Minimální a maximální hodnoty jsou stejné jako limity pro datový typ celé číslo.

Vrácená hodnota	Typ	Popis
<integer-result>	Celé číslo	Celočíselná verze zadaného řetězce. Minimální a maximální hodnoty jsou stejné jako limity pro datový typ celé číslo.

Příklad

Tento příklad vytvoří celočíselnou verzi řetězce "10":

int('10')

A vrátí tento výsledek: 10

isFloat

Vrátí logickou hodnotu označující, jestli je řetězec číslo s plovoucí desetinnou čárkou. Ve výchozím nastavení tato funkce používá neutrální jazykovou verzi pro formát s plovoucí desetinnou čárkou. Pokud chcete identifikovat čísla s plovoucí desetinou čárkou reprezentovaná v jiných formátech specifických pro národní prostředí, můžete volitelně zadat kód národního prostředí RFC 4646.

isFloat('<string>', '<locale>'?)

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec, který chcete prozkoumat
<locale>	No	String	Kód národního prostředí RFC 4646, který se má použít

Vrácená hodnota	Typ	Popis
<boolean-result>	Logická hodnota	Logická hodnota označující, jestli je řetězec číslo s plovoucí desetinnou čárkou

Příklad 1

Tento příklad zkontroluje, jestli je řetězec číslo s plovoucí desetinnou čárkou v invariantní jazykové verzi:

isFloat('10,000.00')

A vrátí tento výsledek: true

Příklad 2

Tento příklad zkontroluje, jestli je řetězec číslo s plovoucí desetinnou čárkou v německém národním prostředí:

isFloat('10.000,00', 'de-DE')

A vrátí tento výsledek: true

isInt

Vrátí logickou hodnotu, která určuje, jestli je řetězec celé číslo.

isInt('<string>')

Parametr	Požaduje se	Type	Description
<string>	Ano	String	Řetězec, který chcete prozkoumat

Vrácená hodnota	Typ	Popis
<boolean-result>	Logická hodnota	Logická hodnota označující, jestli je řetězec celé číslo

Příklad

Tento příklad zkontroluje, jestli je řetězec celé číslo:

isInt('10')

A vrátí tento výsledek: true

položka

Při použití uvnitř opakující se akce nad polem vraťte aktuální položku v poli během aktuální iterace akce. Můžete také získat hodnoty z vlastností dané položky.

item()

Vrácená hodnota	Typ	Popis
<current-array-item>	Všechny	Aktuální položka v poli pro aktuální iteraci akce

Příklad

Tento příklad získá body prvek z aktuální zprávy pro akci "Send_an_email" uvnitř aktuální iterace smyčky for-each:

item().body

položky

Vrátí aktuální položku z každého cyklu ve smyčce pro každou smyčku. Tuto funkci použijte uvnitř smyčky for-each.

items('<loopName>')

Parametr	Požaduje se	Type	Popis
<loopName>	Ano	String	Název smyčky for-each

Vrácená hodnota	Typ	Popis
<Položky>	Všechny	Položka z aktuálního cyklu v zadané smyčce pro každou smyčku

Příklad

Tento příklad získá aktuální položku ze zadané smyčky pro každou smyčku:

items('myForEachLoopName')

iterationIndexes

Vrátí hodnotu indexu pro aktuální iteraci uvnitř smyčky Until. Tuto funkci můžete použít uvnitř vnořených smyček Until.

iterationIndexes('<loopName>')

Parametr	Požaduje se	Type	Popis
<loopName>	Ano	String	Název smyčky Until

Vrácená hodnota	Typ	Popis
<Index>	Celé číslo	Hodnota indexu pro aktuální iteraci uvnitř zadané smyčky Until

Příklad

Tento příklad vytvoří proměnnou čítače a během každé iterace ve smyčce Until ji zvýší o jednu, dokud hodnota čítače nedosáhne pěti. Příklad také vytvoří proměnnou, která sleduje aktuální index pro každou iteraci. Během každé iterace ve smyčce Until příklad zvýší hodnotu čítače a pak přiřadí hodnotu čítače aktuální hodnotě indexu a pak zvýší hodnotu čítače. V této smyčce odkazuje tento příklad na aktuální index iterace pomocí iterationIndexes funkce:

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

Vrátí hodnotu typu JSON (JavaScript Object Notation), objekt nebo pole objektů pro řetězec nebo XML.

json('<value>')
json(xml('value'))

Důležité

Bez schématu XML, které definuje strukturu výstupu, může funkce vracet výsledky, kde se struktura výrazně liší od očekávaného formátu v závislosti na vstupu.

Díky tomuto chování tato funkce není vhodná pro scénáře, ve kterých musí výstup vyhovovat dobře definovanému kontraktu, například v důležitých obchodních systémech nebo řešeních.

Parametr	Požaduje se	Type	Popis
<value>	Ano	Řetězec nebo XML	Řetězec nebo XML pro převod

Vrácená hodnota	Typ	Popis
<Výsledek JSON>	Nativní typ, objekt nebo pole JSON	Hodnota nativního typu JSON, objekt nebo pole objektů ze vstupního řetězce nebo XML. - Pokud předáte XML, který má jeden podřízený prvek v kořenovém elementu, vrátí funkce jeden objekt JSON pro tento podřízený prvek. - Pokud předáte XML, který má v kořenovém elementu více podřízených prvků, vrátí funkce pole obsahující objekty JSON pro tyto podřízené prvky. – Pokud je řetězec null, vrátí funkce 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 JSON:

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

A vrátí tento výsledek:

{
  "fullName": "Sophia Owen"
}

Příklad 3

Tento příklad používá funkce a xml() funkce k převodu json() XML, který má jeden podřízený prvek v kořenovém elementu do objektu JSON pojmenovaného person pro tento podřízený element:

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

Příklad 4

Tento příklad používá funkce a xml() funkce k převodu json() XML s více podřízenými elementy v kořenovém elementu na pole s názvemperson, které obsahuje objekty JSON pro tyto podřízené elementy:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</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"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

Průsečíku

Vrátí kolekci, která obsahuje pouze společné položky v zadaných kolekcích. Aby se položka zobrazila ve výsledku, musí se zobrazit 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 s tímto názvem.

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

Parametr	Požaduje se	Type	Popis
<collection1>, <collection2>, ...	Ano	Matice nebo objekt, ale ne obojí	Kolekce, ze kterých chcete jenom společné položky

Vrácená hodnota	Typ	Popis
<společné položky>	Pole nebo objekt, v uvedeném pořadí	Kolekce, která obsahuje pouze společné položky v zadaných kolekcích

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 těmito položkami:[1, 2]

join

Vrátí řetězec, který obsahuje všechny položky z pole a má každý znak oddělený oddělovačem.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Pole	Pole, které obsahuje položky ke spojení
<Oddělovač>	Ano	String	Oddělovač, který se zobrazí mezi jednotlivými znaky ve výsledném řetězci

Vrácená hodnota	Typ	Popis
<znak 1><oddělovač><char2...>><	String	Výsledný řetězec vytvořený ze všech položek v zadaném poli. Poznámka: Délka výsledku nesmí překročit 104 857 600 znaků.

Příklad

Tento příklad vytvoří řetězec ze všech položek v tomto poli se zadaným znakem jako oddělovačem:

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

A vrátí tento výsledek: "a.b.c"

L

Poslední

Vrátí poslední položku z kolekce.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec nebo pole	Kolekce, kde najít poslední položku

Vrácená hodnota	Typ	Popis
<last-collection-item>	Řetězec nebo pole v uvedeném pořadí	Poslední položka v kolekci

Příklad

V těchto příkladech najdete 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ězdce. Tato funkce nerozlišuje malá a velká písmena a indexy začínají číslem 0.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec s podřetězcem, který se má najít
<searchText>	Ano	String	Podřetětěr, který se má najít

Vrácená hodnota	Typ	Popis
<end-index-value>	Celé číslo	Počáteční pozice nebo hodnota indexu pro poslední výskyt zadaného podřetězdce.

Pokud je hodnota řetězce nebo podřetězce prázdná, dojde k následujícímu chování:

Pokud je hodnota řetězce prázdná, vrátí -1funkce .
Pokud jsou hodnoty řetězce i podřetězce prázdné, vrátí 0funkce hodnotu .
Pokud je hodnota podřetězce prázdná, vrátí funkce délku řetězce minus 1.

Příklady

Tento příklad najde počáteční hodnotu indexu pro poslední výskyt podřetězce podřetězce world v řetězci hello world hello world. Vrácený výsledek je 18:

lastIndexOf('hello world hello world', 'world')

V tomto příkladu chybí parametr podřetězce a vrátí hodnotu 22 , protože hodnota vstupního řetězce (23) minus 1 je větší než 0.

lastIndexOf('hello world hello world', '')

length

Vrátí počet položek v kolekci.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec nebo pole	Kolekce s položkami, které se mají spočítat

Vrácená hodnota	Typ	Popis
<délka nebo počet>	Celé číslo	Počet položek v kolekci

Příklad

Tyto příklady spočítají počet položek v těchto kolekcích:

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

A vrátit 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	Požaduje se	Type	Popis
<value>	Ano	Celé číslo, float nebo řetězec	První hodnota, která zkontroluje, jestli je menší než druhá hodnota
<Compareto>	Ano	Celé číslo, Float nebo String	Položka porovnání

Vrácená hodnota	Typ	Popis
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 kontrolují, jestli je první hodnota menší než druhá hodnota.

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

A vrátí 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íce.

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

Parametr	Požaduje se	Type	Popis
<value>	Ano	Celé číslo, float nebo řetězec	První hodnota, která zkontroluje, zda je menší než nebo rovna druhé hodnotě
<Compareto>	Ano	Celé číslo, Float nebo String	Položka porovnání

Vrácená hodnota	Typ	Popis
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 kontrolují, jestli je první hodnota menší nebo rovna druhé hodnotě.

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

A vrátí tyto výsledky:

První příklad: true
Druhý příklad: false

listCallbackUrl

Vrátí adresu URL zpětného volání, která volá trigger nebo akci. Tato funkce funguje pouze s triggery a akcemi pro typy konektorů HttpWebhook a Api Připojení ionWebhook, ale ne s typy Ruční, Opakování, HTTP a API Připojení ion.

listCallbackUrl()

Vrácená hodnota	Typ	Popis
<adresa URL zpětného volání>	String	Adresa URL zpětného volání pro trigger nebo akci

Příklad

Tento příklad ukazuje ukázkovou adresu URL zpětného volání, kterou tato funkce může vrátit:

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

max

Vrátí nejvyšší hodnotu ze seznamu nebo pole s čísly, která jsou na obou koncích inkluzivní.

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

Parametr	Požaduje se	Type	Popis
<číslo1>, <číslo2>, ...	Ano	Celé číslo, Float nebo obojí	Sada čísel, ze kterých chcete získat nejvyšší hodnotu
[<číslo1>, <číslo2>, ...]	Ano	Matice – celé číslo, float nebo obojí	Matice čísel, ze kterých chcete získat nejvyšší hodnotu

Vrácená hodnota	Typ	Popis
<max-value>	Celé číslo nebo plovoucí číslo	Nejvyšší hodnota v zadané matici nebo množině čísel

Příklad

Tyto příklady získají nejvyšší hodnotu ze sady čísel a pole:

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

A vrátit tento výsledek: 3

min

Vrátí nejnižší hodnotu ze sady čísel nebo pole.

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

Parametr	Požaduje se	Type	Popis
<číslo1>, <číslo2>, ...	Ano	Celé číslo, Float nebo obojí	Množina čísel, ze kterých chcete nejnižší hodnotu
[<číslo1>, <číslo2>, ...]	Ano	Matice – celé číslo, float nebo obojí	Matice čísel, ze kterých chcete nejnižší hodnotu

Vrácená hodnota	Typ	Popis
<min-value>	Celé číslo nebo plovoucí číslo	Nejnižší hodnota v zadané sadě čísel nebo zadané matice

Příklad

Tyto příklady získají nejnižší hodnotu v sadě čísel a matici:

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

A vrátit tento výsledek: 1

mod

Vrátí zbytek od dělení dvou čísel. Pokud chcete získat celočíselnou hodnotu, podívejte se na div().

mod(<dividend>, <divisor>)

Parametr	Požaduje se	Type	Popis
<Dividenda>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které se má dělit dělitelem
<Dělitel>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které dělí dividendu, ale nemůže být nula

Vrácená hodnota	Typ	Popis
<modulo-result>	Celé číslo nebo plovoucí číslo	Zbytek od vydělení prvního čísla druhým číslem

Příklad 1

Tento příklad vydělí první číslo druhým číslem:

mod(3, 2)

A vrátí tento výsledek: 1

Příklad 2

Tento příklad ukazuje, že pokud jedna nebo obě hodnoty jsou záporné, výsledek odpovídá znaménku dividendy:

mod(-5, 2)
mod(4, -3)

Příklad vrátí tyto výsledky:

První příklad: -1
Druhý příklad: 1

mul

Vrátí součin od vynásobení dvou čísel.

mul(<multiplicand1>, <multiplicand2>)

Parametr	Požaduje se	Type	Popis
<multiplikand1>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které se má vynásobit násobením2
<multiplicand2>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které násobí násobek1

Vrácená hodnota	Typ	Popis
<výsledek produktu>	Celé číslo nebo plovoucí číslo	Součin od vynásobení 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 vrátí tyto výsledky:

První příklad: 2
Druhý příklad 3

multipartBody

Vrátí tělo pro určitou část ve výstupu akce, který má více částí.

multipartBody('<actionName>', <index>)

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název akce, která má výstup s více částmi
<Index>	Ano	Celé číslo	Hodnota indexu požadované části

Vrácená hodnota	Typ	Popis
<tělo>	String	Tělo pro zadanou část

N

not

Zkontrolujte, jestli je výraz nepravda. Vrátí hodnotu true, pokud je výraz nepravda, nebo vrátí hodnotu false, pokud je true.

not(<expression>)

Parametr	Požaduje se	Type	Popis
<Výraz>	Ano	Logická hodnota	Výraz, který se má zkontrolovat

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true, pokud je výraz false. Vrátí hodnotu false, pokud je výraz pravdivý.

Příklad 1

Tyto příklady kontrolují, jestli jsou zadané výrazy nepravdivé:

not(false)
not(true)

A vrátí tyto výsledky:

První příklad: Výraz je false, takže funkce vrátí true.
Druhý příklad: Výraz je pravdivý, takže funkce vrátí false.

Příklad 2

Tyto příklady kontrolují, jestli jsou zadané výrazy nepravdivé:

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

A vrátí tyto výsledky:

První příklad: Výraz je false, takže funkce vrátí true.
Druhý příklad: Výraz je pravdivý, takže funkce vrátí false.

nthIndexOf

Vrátí počáteční pozici nebo hodnotu indexu, kde se v řetězci zobrazí n. výskyt podřetězce.

nthIndexOf('<text>', '<searchText>', <occurrence>)

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec obsahující podřetězce, který se má najít
<searchText>	Ano	String	Podřetětěr, který se má najít
<Výskyt>	Ano	Celé číslo	Číslo určující n. výskyt podřetězce, který se má najít. Pokud je výskyt záporný, začněte hledat od konce.

Vrácená hodnota	Typ	Popis
<index-value>	Celé číslo	Počáteční pozice nebo hodnota indexu pro n. výskyt zadaného podřetězce. Pokud podřetězce není nalezen nebo menší než n výskytů podřetězce existuje, vraťte `-1`.

Příklady

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

nebo

Zkontrolujte, jestli je alespoň jeden výraz pravdivý. Vrátí hodnotu True, pokud je alespoň jeden výraz pravdivý, nebo vrátí hodnotu false, pokud jsou všechny hodnoty false.

or(<expression1>, <expression2>, ...)

Parametr	Požaduje se	Type	Popis
<výraz1>, <výraz2>, ...	Ano	Logická hodnota	Výrazy ke kontrole

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true, pokud je alespoň jeden výraz pravdivý. Vrátí hodnotu false, pokud jsou všechny výrazy false.

Příklad 1

Tyto příklady kontrolují, jestli je alespoň jeden výraz pravdivý:

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

A vrátí tyto výsledky:

První příklad: Alespoň jeden výraz je pravdivý, takže funkce vrátí true.
Druhý příklad: Oba výrazy jsou false, takže funkce vrátí false.

Příklad 2

Tyto příklady kontrolují, jestli je alespoň jeden výraz pravdivý:

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

A vrátí tyto výsledky:

První příklad: Alespoň jeden výraz je pravdivý, takže funkce vrátí true.
Druhý příklad: Oba výrazy jsou false, takže funkce vrátí false.

Výstupy

Vrátí výstupy akce za běhu. Tuto funkci použijte místo actionOutputs()toho, aby se v návrháři přeložil outputs() na tuto funkci. I když obě funkce fungují stejným způsobem, outputs() preferuje se.

outputs('<actionName>')

Parametr	Požaduje se	Type	Popis
<Actionname>	Ano	String	Název požadovaného výstupu akce

Vrácená hodnota	Typ	Popis
<Výstup>	String	Výstup ze zadané akce

Příklad

Tento příklad získá výstup z akce Get userTwitteru:

outputs('Get_user')

A vrátí tento výsledek:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

parametry

Vrátí hodnotu parametru popsaného v definici pracovního postupu.

parameters('<parameterName>')

Parametr	Požaduje se	Type	Popis
<Parametername>	Ano	String	Název parametru, jehož hodnotu chcete

Vrácená hodnota	Typ	Popis
<parameter-value>	Všechny	Hodnota zadaného parametru

Příklad

Předpokládejme, že máte tuto hodnotu JSON:

{
  "fullName": "Sophia Owen"
}

Tento příklad získá hodnotu pro zadaný parametr:

parameters('fullName')

A vrátí tento výsledek: "Sophia Owen"

parseDateTime

Vrátí časové razítko z řetězce, který obsahuje časové razítko.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<locale>	No	String	Národní prostředí, které se má použít Pokud není zadáno, výchozí národní prostředí je `en-us`. Pokud národní prostředí není platná hodnota, vygeneruje se chyba.
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud není zadaný formát, zkuste analyzovat více formátů, které jsou kompatibilní se zadaným národním prostředím. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<parsed-timestamp>	String	Analyzované časové razítko ve formátu "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu.

Příklady

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

rand

Vrátí náhodné celé číslo ze zadaného rozsahu, které je inkluzivní pouze na počátečním konci.

rand(<minValue>, <maxValue>)

Parametr	Požaduje se	Type	Popis
<Minvalue>	Ano	Celé číslo	Nejnižší celé číslo v rozsahu
<Maxvalue>	Ano	Celé číslo	Celé číslo, které následuje za nejvyšším celočíselnou oblastí, kterou může funkce vrátit

Vrácená hodnota	Typ	Popis
<náhodný výsledek>	Celé číslo	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í jedno z těchto čísel jako výsledek: 1, 2, 3, nebo 4

range

Vrátí celočíselnou matici, která začíná zadaným celočíselnou hodnotou.

range(<startIndex>, <count>)

Parametr	Požaduje se	Type	Popis
<Startindex>	Ano	Celé číslo	Celočíselná hodnota, která spouští matici jako první položku
<count>	Ano	Celé číslo	Počet celých čísel v matici Hodnota `count` parametru musí být kladné celé číslo, které nepřesahuje 100 000. Poznámka: Součet `startIndex` hodnot `count` nesmí překročit 2 147 483 647.

Vrácená hodnota	Typ	Popis
[<range-result>]	Pole	Pole s celými čísly počínaje zadaným indexem

Příklad

Tento příklad vytvoří celočíselnou matici, která začíná zadaným indexem a má zadaný počet celých čísel:

range(1, 4)

A vrátí tento výsledek: [1, 2, 3, 4]

removeProperty

Odeberte z objektu vlastnost a vraťte aktualizovaný objekt. Pokud vlastnost, kterou se pokusíte odebrat, neexistuje, vrátí funkce původní objekt.

removeProperty(<object>, '<property>')

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, ze kterého chcete odebrat vlastnost
<vlastnost>	Ano	String	Název vlastnosti, která se má odebrat

Vrácená hodnota	Typ	Popis
<updated-object>	Object	Aktualizovaný objekt JSON bez zadané vlastnosti

Chcete-li odebrat podřízenou vlastnost z existující vlastnosti, použijte tuto syntaxi:

removeProperty(<object>['<parent-property>'], '<child-property>')

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, jehož vlastnost chcete odebrat
<parent-property>	Ano	String	Název nadřazené vlastnosti s podřízenou vlastností, kterou chcete odebrat
<child-property>	Ano	String	Název podřízené vlastnosti, která se má odebrat

Vrácená hodnota	Typ	Popis
<updated-object>	Object	Aktualizovaný objekt JSON, jehož podřízenou vlastnost jste odebrali

Příklad 1

Tento příklad odebere middleName vlastnost z objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON() a vrátí aktualizovaný objekt:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

Tady je aktuální objekt JSON:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Tady je aktualizovaný objekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Příklad 2

Tento příklad odebere middleName podřízenou customerName vlastnost z nadřazené vlastnosti v objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON() a vrátí aktualizovaný objekt:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

Tady je aktuální objekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

Tady je aktualizovaný objekt JSON:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

replace

Nahraďte podřetězce zadaným řetězcem a vraťte výsledný řetězec. Tato funkce rozlišují malá a velká písmena.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který má podřetězce nahradit
<oldText>	Ano	String	Podřetětět, který se má nahradit
<newText>	Ano	String	Náhradní řetězec

Vrácená hodnota	Typ	Popis
<aktualizovaný text>	String	Aktualizovaný řetězec po nahrazení podřetězce Pokud se podřetězce nenajde, vraťte původní řetězec.

Příklad

Tento příklad najde podřetězce "starý" v "starém řetězci" a nahradí "old" slovem "new":

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

A vrátí tento výsledek: "the new string"

result

Vrátí výsledky z akcí nejvyšší úrovně v zadané akci s vymezeným oborem, například z For_eachakce , Untilnebo Scope akce. Funkce result() přijímá jeden parametr, což je název oboru, a vrátí pole, které obsahuje informace z akcí první úrovně v daném oboru. Tyto objekty akce zahrnují stejné atributy jako atributy vrácené actions() funkcí, jako je počáteční čas akce, čas ukončení, stav, vstupy, ID korelace a výstupy.

Poznámka:

Tato funkce vrací informace pouze z akcí první úrovně v akci s vymezeným oborem, a ne z hlubších vnořených akcí, jako jsou akce přepínače nebo podmínky.

Pomocí této funkce můžete například získat výsledky neúspěšných akcí, abyste mohli diagnostikovat a zpracovávat výjimky. Další informace najdete v tématu Získání kontextu a výsledků selhání.

result('<scopedActionName>')

Parametr	Požaduje se	Type	Popis
<scopedActionName>	Ano	String	Název akce s vymezeným oborem, ve které chcete vstupy a výstupy z akcí nejvyšší úrovně v daném oboru

Vrácená hodnota	Typ	Popis
<array-object>	Maticový objekt	Pole, které obsahuje pole vstupů a výstupů z každé akce nejvyšší úrovně uvnitř zadaného oboru

Příklad

Tento příklad vrátí vstupy a výstupy z každé iterace akce HTTP uvnitř For_each smyčky pomocí result() funkce v Compose akci:

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

Tady je postup, jak může vrácené pole vypadat, kde vnější outputs objekt obsahuje vstupy a výstupy z každé iterace akcí uvnitř For_each akce.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

reverse

Obrácení pořadí položek v kolekci Při použití této funkce s funkcí sort() můžete seřadit kolekci v sestupném pořadí.

reverse([<collection>])

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Pole	Kolekce, která se má vrátit zpět

Vrácená hodnota	Typ	Popis
[<updated-collection>]	Pole	Obrácená kolekce

Příklad

Tento příklad obrátí pole celých čísel:

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

A vrátí toto pole: [3,2,1,0]

S

Setproperty

Nastavte hodnotu vlastnosti objektu JSON a vraťte aktualizovaný objekt. Pokud vlastnost, kterou se pokusíte nastavit, neexistuje, vlastnost se přidá do objektu. Pokud chcete přidat novou vlastnost, použijte funkci addProperty().

setProperty(<object>, '<property>', <value>)

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, jehož vlastnost chcete nastavit
<vlastnost>	Ano	String	Název existující nebo nové vlastnosti, která se má nastavit
<value>	Ano	Všechny	Hodnota nastavená pro zadanou vlastnost

Chcete-li nastavit podřízenou vlastnost v podřízeného objektu, použijte místo toho vnořené setProperty() volání. V opačném případě vrátí funkce jako výstup pouze podřízený objekt.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

Parametr	Požaduje se	Type	Popis
<object>	Ano	Object	Objekt JSON, jehož vlastnost chcete nastavit
<parent-property>	Ano	String	Název nadřazené vlastnosti s podřízenou vlastností, kterou chcete nastavit
<child-property>	Ano	String	Název podřízené vlastnosti, která se má nastavit
<value>	Ano	Všechny	Hodnota nastavená pro zadanou vlastnost

Vrácená hodnota	Typ	Popis
<updated-object>	Object	Aktualizovaný objekt JSON, jehož vlastnost jste nastavili

Příklad 1

Tento příklad nastaví surName vlastnost v objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON(). Funkce přiřadí zadanou hodnotu vlastnosti a vrátí aktualizovaný objekt:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

Tady je aktuální objekt JSON:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Tady je aktualizovaný objekt JSON:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

Příklad 2

Tento příklad nastaví podřízenou surName vlastnost customerName nadřazené vlastnosti v objektu JSON, který se převede z řetězce na JSON pomocí funkce JSON(). Funkce přiřadí zadanou hodnotu vlastnosti a vrátí aktualizovaný objekt:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

Tady je aktuální objekt JSON:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

Tady je aktualizovaný objekt JSON:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

skip

Odeberte položky z přední části kolekce a vraťte všechny ostatní položky.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Pole	Kolekce, jejíž položky chcete odebrat
<count>	Ano	Celé číslo	Kladné celé číslo pro počet položek, které se mají odebrat na přední straně

Vrácená hodnota	Typ	Popis
[<updated-collection>]	Pole	Aktualizovaná kolekce po odebrání zadaných položek

Příklad

Tento příklad odebere jednu položku, číslo 0, zepředu 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]

slice

Vrátí podřetěc zadáním počáteční a koncové pozice nebo hodnoty. Viz také podřetěžce().

slice('<text>', <startIndex>, <endIndex>?)

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec obsahující podřetězce, který se má najít
<Startindex>	Ano	Celé číslo	Počáteční pozice nebo hodnota založená na nule, kde začít hledat podřetězdce - Pokud je hodnota startIndex větší než délka řetězce, vrátí prázdný řetězec. - Pokud je hodnota startIndex záporná, začněte hledat na hodnotě indexu, která je součtem délky řetězce a parametru startIndex.
<endIndex>	No	Celé číslo	Koncová pozice nebo hodnota založená na nule, kde se má ukončit hledání podřetědce. Znak umístěný na koncové hodnotě indexu není součástí hledání. – Pokud endIndex není zadán nebo větší než délka řetězce, vyhledejte až na konec řetězce. - Pokud je hodnota endIndex záporná, ukončete vyhledávání na hodnotě indexu, kterou součet délky řetězce a endIndex.

Vrácená hodnota	Typ	Popis
<výsledek řezu>	String	Nový řetězec obsahující nalezený podřetězce

Příklady

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sort

Seřaďte položky v kolekci. Objekty kolekce můžete seřadit pomocí libovolného klíče, který obsahuje jednoduchý typ.

sort([<collection>], <sortBy>?)

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Pole	Kolekce s položkami, které se mají seřadit
<sortBy>	No	String	Klíč, který se má použít k řazení objektů kolekce

Vrácená hodnota	Typ	Popis
[<updated-collection>]	Pole	Seřazená kolekce

Příklad 1

Tento příklad seřadí pole celých čísel:

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

A vrátí toto pole: [0,1,2,3]

Příklad 2

Tento příklad seřadí pole objektů podle klíče:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

A vrátí toto pole: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

split

Vrátí pole obsahující podřetězce oddělené čárkami na základě zadaného znaku oddělovače v původním řetězci.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který se má oddělit do podřetězců na základě zadaného oddělovače v původním řetězci
<Oddělovač>	Ano	String	Znak v původním řetězci, který se má použít jako oddělovač

Vrácená hodnota	Typ	Popis
[<podřetěžk1,podřetěžk2>><,...]	Pole	Pole obsahující podřetězce z původního řetězce oddělené čárkami

Příklad 1

Tento příklad vytvoří pole s podřetězci ze zadaného řetězce na základě zadaného znaku jako oddělovače:

split('a_b_c', '_')

A vrátí toto pole jako výsledek: ["a","b","c"]

Příklad 2

Tento příklad vytvoří pole s jedním prvkem, pokud v řetězci neexistuje žádný 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	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Zadané časové razítko, ale začíná na nulové hodině pro daný den.

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	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Zadané časové razítko, ale počínaje značkou nula minut pro hodinu

Příklad

Tento příklad najde 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	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Zadané časové razítko, ale začíná prvním dnem v měsíci na nulové hodině

Příklad 1

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"

Příklad 2

Tento příklad vrátí začátek měsíce v zadaném formátu pro toto časové razítko:

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

A vrátí tento výsledek: "2018-03-01"

Startswith

Zkontrolujte, jestli řetězec začíná určitým podřetězcem. Vrátí hodnotu true při nalezení podřetětěce nebo vrátí hodnotu false, pokud nebyl nalezen. Tato funkce nerozlišuje malá a velká písmena.

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který chcete zkontrolovat
<searchText>	Ano	String	Počáteční řetězec, který se má najít

Vrácená hodnota	Typ	Popis
true nebo false	Logická hodnota	Vrátí hodnotu true při nalezení počátečního podřetězdce. Vrátí hodnotu false, pokud nebyla nalezena.

Příklad 1

Tento příklad zkontroluje, jestli řetězec "hello world" začíná podřetězcem "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ězcem "greetings":

startsWith('hello world', 'greetings')

A vrátí tento výsledek: false

string

Vrátí verzi řetězce pro hodnotu.

string(<value>)

Parametr	Požaduje se	Type	Popis
<value>	Ano	Všechny	Hodnota, kterou chcete převést. Pokud je tato hodnota null nebo je vyhodnocena jako null, hodnota se převede na prázdnou hodnotu řetězce (`""`). Pokud například přiřadíte řetězcovou proměnnou neexistující vlastnosti, ke které můžete přistupovat pomocí operátoru `?` , hodnota null se převede na prázdný řetězec. Porovnání hodnoty null ale není stejné jako porovnání prázdného řetězce.

Vrácená hodnota	Typ	Popis
<řetězcová hodnota>	String	Verze řetězce pro zadanou hodnotu. Pokud je parametr hodnoty null nebo se vyhodnotí jako null, vrátí se tato hodnota jako prázdná hodnota řetězce (`""`).

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 zpětné lomítko (\) jako řídicí znak pro uvozovky (").

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

A vrátí tento výsledek: "{ \\"name\\": \\"Sophie Owen\\" }"

předmět

Vrátí výsledek od odečtení druhého čísla od prvního čísla.

sub(<minuend>, <subtrahend>)

Parametr	Požaduje se	Type	Popis
<minuend>	Ano	Celé číslo nebo plovoucí číslo	Číslo, od kterého se má odečíst subtrahend
<subtrahend>	Ano	Celé číslo nebo plovoucí číslo	Číslo, které se má odečíst od minuendu

Vrácená hodnota	Typ	Description
<Výsledek>	Celé číslo nebo plovoucí číslo	Výsledek od 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. Viz také řez().

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

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, jehož znaky chcete
<Startindex>	Ano	Celé číslo	Kladné číslo, které se rovná nebo větší než 0, které chcete použít jako počáteční pozici nebo hodnotu indexu
<length>	No	Celé číslo	Požadovaný počet znaků v podřetědci

Poznámka:

Ujistěte se, že součet z přidání hodnot parametru startIndex a length je menší než délka řetězce, který zadáte pro textový parametr. V opačném případě se zobrazí chyba, na rozdíl od podobných funkcí v jiných jazycích, kde je výsledkem podřetězce od startIndex na konec řetězce. Parametr length je volitelný a pokud není zadaný, funkce substring() přebírá všechny znaky začínající od startIndex na konec řetězce.

Vrácená hodnota	Typ	Popis
<výsledek podřetědce>	String	Podřetězce se zadaným počtem znaků počínaje zadaným umístěním indexu ve zdrojovém řetězci

Příklad

Tento příklad vytvoří podřetězec s pěti znaky ze zadaného řetězce počínaje hodnotou indexu 6:

substring('hello world', 6, 5)

A vrátí tento výsledek: "world"

odečístFromTime

Odečte počet časových jednotek od časového razítka. Viz také getPastTime.

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

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec obsahující časové razítko
<interval>	Ano	Celé číslo	Počet zadaných časových jednotek, které se mají odečíst
<timeUnit>	Ano	String	Jednotka času, která se má použít s intervalem: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<aktualizované časové razítko>	String	Č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"

T

take

Vrátí položky z přední části kolekce.

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

Parametr	Požaduje se	Type	Popis
<Kolekce>	Ano	Řetězec nebo pole	Kolekce, jejíž položky chcete
<count>	Ano	Celé číslo	Kladné celé číslo pro počet požadovaných položek z přední části

Vrácená hodnota	Typ	Popis
<podmnožina nebo [podmnožina>>]<	Řetězec nebo pole v uvedeném pořadí	Ř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 získají zadaný počet položek z přední části těchto kolekcí:

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

A vrátí tyto výsledky:

První příklad: "abc"
Druhý příklad: [0, 1, 2]

Klíšťata

Vrátí počet od 1. ledna 0001 12:00:00 půlnoci (neboli DateTime.Ticks v jazyce C#) od 12. ledna 001 až do zadaného časového razítka. Další informace naleznete v tomto tématu: DateTime.Ticks – vlastnost (Systém).

ticks('<timestamp>')

Parametr	Požaduje se	Type	Popis
<Časové razítko>	Ano	String	Řetězec pro časové razítko

Vrácená hodnota	Typ	Popis
<ticks-number>	Celé číslo	Počet záškrtů od zadaného časového razítka

Tolower

Vrátí řetězec ve formátu malými písmeny. Pokud znak v řetězci nemá malá písmena verze, zůstane tento znak ve vráceném řetězci beze změny.

toLower('<text>')

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který se má vrátit malými písmeny

Vrácená hodnota	Typ	Popis
<malá písmena>	String	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á velkou verzi, zůstane tento znak ve vráceném řetězci beze změny.

toUpper('<text>')

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec, který se má vrátit velkými písmeny

Vrácená hodnota	Typ	Popis
<velká písmena – text>	String	Původní řetězec ve formátu velkými písmeny

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"

Aktivační událost

Vrátí výstup triggeru za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON, které můžete přiřadit k výrazu.

Uvnitř vstupů triggeru tato funkce vrátí výstup z předchozího spuštění.
Uvnitř podmínky triggeru vrátí tato funkce výstup z aktuálního spuštění.

Ve výchozím nastavení funkce odkazuje na celý objekt triggeru, ale volitelně můžete zadat vlastnost, jejíž hodnotu chcete. Tato funkce má také k dispozici zkrácené verze, viz triggerOutputs() a triggerBody().

trigger()

Vrácená hodnota	Typ	Popis
<trigger-output>	String	Výstup triggeru za běhu

triggerBody

Vrátí výstup triggeru body za běhu. Zkratka pro trigger().outputs.body. Viz trigger().

triggerBody()

Vrácená hodnota	Typ	Popis
<trigger-body-output>	String	Výstup `body` z triggeru

triggerFormDataMultiValues

Vrátí pole s hodnotami, které odpovídají názvu klíče ve výstupu s daty formuláře nebo kódovanými formulářem triggeru.

triggerFormDataMultiValues('<key>')

Parametr	Požaduje se	Type	Popis
<key>	Ano	String	Název klíče, jehož hodnotu chcete použít

Vrácená hodnota	Typ	Popis
[<array-with-key-values>]	Pole	Pole se všemi hodnotami, které odpovídají zadanému klíči

Příklad

Tento příklad vytvoří pole z hodnoty klíče feedUrl ve výstupu formuláře nebo ve výstupu s kódováním formuláře triggeru RSS:

triggerFormDataMultiValues('feedUrl')

A vrátí toto pole jako příklad výsledku: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Vrátí řetězec s jednou hodnotou, která odpovídá názvu klíče ve výstupu formuláře nebo ve výstupu s kódováním formuláře triggeru. Pokud funkce najde více než jednu shodu, vyvolá funkce chybu.

triggerFormDataValue('<key>')

Parametr	Požaduje se	Type	Popis
<key>	Ano	String	Název klíče, jehož hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<klíč-hodnota>	String	Hodnota v zadaném klíči

Příklad

Tento příklad vytvoří řetězec z hodnoty klíče feedUrl ve výstupu formuláře nebo výstupu s kódováním formuláře triggeru RSS:

triggerFormDataValue('feedUrl')

A vrátí tento řetězec jako příklad výsledku: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Vrátí tělo pro určitou část ve výstupu triggeru, který má více částí.

triggerMultipartBody(<index>)

Parametr	Požaduje se	Type	Popis
<Index>	Ano	Celé číslo	Hodnota indexu požadované části

Vrácená hodnota	Typ	Popis
<tělo>	String	Tělo pro zadanou část ve výstupu více částí triggeru

triggerOutputs

Vrátí výstup triggeru za běhu nebo hodnoty z jiných dvojic názvů a hodnot JSON. Zkratka pro trigger().outputs. Viz trigger().

triggerOutputs()

Vrácená hodnota	Typ	Popis
<trigger-output>	String	Výstup triggeru za běhu

Trim

Odeberte počáteční a koncové prázdné znaky z řetězce a vraťte aktualizovaný řetězec.

trim('<text>')

Parametr	Požaduje se	Type	Popis
<text>	Ano	String	Řetězec s počátečním a koncovým prázdným znakem, který se má odebrat

Vrácená hodnota	Typ	Popis
<updatedText>	String	Aktualizovaná verze původního řetězce bez počátečního nebo koncového prázdného znaku

Příklad

Tento příklad odebere úvodní a koncové prázdné znaky z řetězce "Hello World":

trim(' Hello World  ')

A vrátí tento výsledek: "Hello World"

U

sjednocení

Vrátí kolekci, která obsahuje všechny položky ze zadaných kolekcí. Chcete-li se zobrazit ve výsledku, může se položka zobrazit v libovolné 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 s tímto názvem.

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

Parametr	Požaduje se	Type	Popis
<collection1>, <collection2>, ...	Ano	Matice nebo objekt, ale ne obojí	Kolekce, ze kterých chcete všechny položky

Vrácená hodnota	Typ	Popis
<updatedCollection>	Pole nebo objekt, v uvedeném pořadí	Kolekce se všemi položkami ze zadaných kolekcí – žádné duplicity

Příklad

Tento příklad získá 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

Vrácení verze zakódovaného identifikátoru URI (Uniform Resource Identifier) pro řetězec nahrazením nebezpečných znaků ADRESY URL řídicími znaky. Místo kódováníUriComponent()použijte tuto funkci. I když obě funkce fungují stejným způsobem, uriComponent() preferuje se.

uriComponent('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec pro převod na formát kódovaný identifikátorem URI

Vrácená hodnota	Typ	Popis
<encoded-uri>	String	Řetězec kódovaný identifikátorem URI s řídicími znaky

Příklad

Tento příklad vytvoří verzi kódovanou identifikátorem URI pro tento řetězec:

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

A vrátí tento výsledek: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Vrátí binární verzi pro součást identifikátoru URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec kódovaný identifikátorem URI pro převod

Vrácená hodnota	Typ	Popis
<binary-for-encoded-uri>	String	Binární verze řetězce kódovaného identifikátorem URI. Binární obsah je kódován base64 a reprezentován `$content`.

Příklad

Tento příklad vytvoří binární verzi pro tento řetězec kódovaný identifikátorem URI:

uriComponentToBinary('https%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ý identifikátorem URI (Uniform Resource Identifier), který efektivně dekóduje řetězec kódovaný identifikátorem URI.

uriComponentToString('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec kódovaný identifikátorem URI pro dekódování

Vrácená hodnota	Typ	Popis
<dekódovaný identifikátor URI>	String	Dekódovaná verze řetězce kódovaného identifikátorem URI

Příklad

Tento příklad vytvoří dekódovanou verzi řetězce pro tento řetězec kódovaný identifikátorem URI:

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

A vrátí tento výsledek: "https://contoso.com"

uriHost

host Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

uriHost('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `host` hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<hodnota hostitele>	String	Hodnota `host` zadaného identifikátoru URI

Příklad

Tento příklad najde hodnotu tohoto identifikátoru host URI:

uriHost('https://www.localhost.com:8080')

A vrátí tento výsledek: "www.localhost.com"

uriPath

path Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

uriPath('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `path` hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<path-value>	String	Hodnota `path` zadaného identifikátoru URI. Pokud `path` nemá hodnotu, vraťte znak "/".

Příklad

Tento příklad najde hodnotu tohoto identifikátoru path URI:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

A vrátí tento výsledek: "/catalog/shownew.htm"

uriPathAndQuery

path Vrátí hodnoty identifikátoru query URI (Uniform Resource Identifier).

uriPathAndQuery('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `path` a `query` hodnoty chcete

Vrácená hodnota	Typ	Popis
<path-query-value>	String	Hodnoty `path` zadaného identifikátoru URI a `query` hodnoty. Pokud `path` nezadáte hodnotu, vrátí znak "/".

Příklad

Tento příklad najde path a query hodnoty pro tento identifikátor URI:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

A vrátí tento výsledek: "/catalog/shownew.htm?date=today"

uriPort

port Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

uriPort('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `port` hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<hodnota portu>	Celé číslo	Hodnota `port` zadaného identifikátoru URI. Pokud `port` nezadáte hodnotu, vraťte výchozí port protokolu.

Příklad

Tento příklad vrátí hodnotu tohoto identifikátoru port URI:

uriPort('https://www.localhost:8080')

A vrátí tento výsledek: 8080

uriQuery

query Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

uriQuery('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `query` hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<query-value>	String	Hodnota `query` zadaného identifikátoru URI

Příklad

Tento příklad vrátí hodnotu tohoto identifikátoru query URI:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

A vrátí tento výsledek: "?date=today"

uriScheme

scheme Vrátí hodnotu pro identifikátor URI (Uniform Resource Identifier).

uriScheme('<uri>')

Parametr	Požaduje se	Type	Popis
<Uri>	Ano	String	Identifikátor URI, jehož `scheme` hodnotu chcete použít

Vrácená hodnota	Typ	Popis
<scheme-value>	String	Hodnota `scheme` zadaného identifikátoru URI

Příklad

Tento příklad vrátí hodnotu tohoto identifikátoru scheme URI:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

A vrátí tento výsledek: "http"

UtcNow

Vrátí aktuální časové razítko.

utcNow('<format>')

Volitelně můžete zadat jiný formát pomocí parametru <formátu> .

Parametr	Požaduje se	Type	Popis
<format>	No	String	Řetězec číselného formátu, který je specifikátorem jednoho formátu nebo vlastním vzorem formátu. Výchozí formát časového razítka je "o" (rrrr-MM-ddTHH:mm:ss.fffffffK), který odpovídá normě ISO 8601 a zachovává informace o časovém pásmu. Pokud formát není platná hodnota, vygeneruje se chyba.

Vrácená hodnota	Typ	Popis
<current-timestamp>	String	Aktuální datum a čas

Příklad 1

Předpokládejme, že dnes je 15. dubna 2018 v 13:00:00. 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

Předpokládejme, že dnes je 15. dubna 2018 v 13:00:00. 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"

V

proměnné

Vrátí hodnotu pro zadanou proměnnou.

variables('<variableName>')

Parametr	Požaduje se	Type	Popis
<variableName>	Ano	String	Název proměnné, jejíž hodnotu chcete použít.

Vrácená hodnota	Typ	Popis
<proměnná-hodnota>	Všechny	Hodnota pro zadanou proměnnou

Příklad

Předpokládejme, že aktuální hodnota proměnné "numItems" je 20. Tento příklad získá celočíselnou hodnotu pro tuto proměnnou:

variables('numItems')

A vrátí tento výsledek: 20

S

pracovní postup

Vrátí všechny podrobnosti o samotném pracovním postupu během běhu.

workflow().<property>

Parametr	Požaduje se	Type	Popis
<vlastnost>	No	String	Název vlastnosti pracovního postupu, jejíž hodnotu chcete Ve výchozím nastavení má objekt pracovního postupu tyto vlastnosti: `name`, `type`, `id`, `location`, `run`, a `tags`. - Hodnota `run` vlastnosti je objekt JSON, který obsahuje tyto vlastnosti: `name`, `type`a `id`. – Vlastnost `tags` je objekt JSON, který obsahuje značky přidružené k vaší aplikaci logiky v Azure Logic Apps nebo tok v Power Automate a hodnoty těchto značek. Další informace o značkách v prostředcích Azure najdete v tématu Označování prostředků, skupin prostředků a předplatných pro logickou organizaci v Azure. Poznámka: Ve výchozím nastavení nemá aplikace logiky žádné značky, ale tok Power Automate má značky `flowDisplayName` a `environmentName` značky.

Příklad 1

Tento příklad vrátí název aktuálního spuštění pracovního postupu:

workflow().run.name

Příklad 2

Pokud používáte Power Automate, můžete vytvořit @workflow() výraz, který pomocí tags výstupní vlastnosti získá hodnoty z vlastnosti nebo environmentName vlastnosti tokuflowDisplayName.

Můžete například posílat vlastní e-mailová oznámení ze samotného toku, která odkazují zpět na váš tok. Tato oznámení můžou obsahovat odkaz HTML, který obsahuje zobrazované jméno toku v názvu e-mailu a následující syntaxi:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Vrátí verzi XML pro řetězec, který obsahuje objekt JSON.

xml('<value>')

Parametr	Požaduje se	Type	Popis
<value>	Ano	String	Řetězec s objektem JSON pro převod Objekt JSON musí mít pouze jednu kořenovou vlastnost, což nemůže být pole. Zpětné lomítko (\) použijte jako řídicí znak uvozovek (").

Vrácená hodnota	Typ	Popis
<xml-version>	Object	Kódovaný kód XML pro zadaný řetězec nebo objekt JSON

Příklad 1

Tento příklad převede řetězec na XML:

xml('<name>Sophia Owen</name>')

A vrátí tento výsledek XML:

<name>Sophia Owen</name>

Příklad 2

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 3

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>

Xpath

Zkontrolujte kód 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 jen XPath vám pomůže procházet strukturu dokumentu XML, abyste mohli vybrat uzly nebo výpočetní hodnoty v obsahu XML.

Poznámka:

V aplikacích logiky Consumption a Standard používají všechny výrazy funkcí knihovnu .NET XPath. Výrazy XPath jsou kompatibilní s podkladovou knihovnou .NET a podporují pouze výraz, který podporuje podkladová knihovna .NET.

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

Parametr	Požaduje se	Type	Popis
<xml>	Ano	Všechny	Řetězec XML pro vyhledávání uzlů nebo hodnot, které odpovídají hodnotě výrazu XPath
<Xpath>	Ano	Všechny	Výraz XPath použitý k vyhledání odpovídajících uzlů NEBO hodnot XML

Vrácená hodnota	Typ	Popis
<xml-node>	XML	Uzel XML, pokud pouze jeden uzel odpovídá zadanému výrazu XPath
<value>	Všechny	Hodnota z uzlu XML, pokud pouze jedna hodnota odpovídá zadanému výrazu XPath
[<xml-node1>, <xml-node2>, ...] -or- [<hodnota1>, <hodnota2>, ...]	Pole	Pole s uzly XML nebo hodnotami, které odpovídají zadanému výrazu XPath

Příklad 1

Předpokládejme, že máte tento 'items' řetězec XML:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Tento příklad předá výraz XPath, aby našel uzly, '/produce/item/name/text()'které odpovídají <name></name> uzlu v 'items' řetězci XML, a vrátí pole s těmito hodnotami uzlu:

xpath(xml(parameters('items')), '/produce/item/name/text()')

Příklad také používá funkci parameters() k získání řetězce 'items' XML a převodu řetězce do formátu XML pomocí funkce xml().

Tady je pole výsledků naplněné hodnotami uzlů, které odpovídají <name></name>:

[ Gala, Honeycrisp ]

Příklad 2

Následující v příkladu 1 tento příklad předává ve výrazu XPath , '/produce/item/name[1]'aby našel první name prvek, který je podřízený element.item

xpath(xml(parameters('items')), '/produce/item/name[1]')

Tady je výsledek: Gala

Příklad 3

Následující v příkladu 1 tento příklad předá výraz XPath , '/produce/item/name[last()]'najít poslední name prvek, který je podřízený element.item

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Tady je výsledek: Honeycrisp

Příklad 4

V tomto příkladu předpokládejme, že items řetězec XML obsahuje také atributy a expired='true'expired='false':

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Tento příklad předá výraz XPath a '//name[@expired]'vyhledá všechny name prvky, které mají expired atribut:

xpath(xml(parameters('items')), '//name[@expired]')

Tady je výsledek: [ Gala, Honeycrisp ]

Příklad 5

V tomto příkladu předpokládejme, že řetězec items XML obsahuje pouze tento atribut: expired = 'true'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Tento příklad předá ve výrazu XPath, '//name[@expired = 'true']'a vyhledá všechny elementy name , které mají atribut, expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Tady je výsledek: [ Gala ]

Příklad 6

V tomto příkladu předpokládejme, že items řetězec XML obsahuje také tyto atributy:

expired='true' price='12'
expired='false' price='40'

<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Tento příklad předá výraz XPath, aby se zjistily name všechny prvky, '//name[@price>35]'které majíprice > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Tady je výsledek: Honeycrisp

Příklad 7

V tomto příkladu předpokládejme, že items váš řetězec XML je stejný jako v příkladu 1:

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Tento příklad najde uzly, které odpovídají <count></count> uzlu, a přidá tyto hodnoty uzlů pomocí sum() funkce:

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

Tady je výsledek: 30

Příklad 8

V tomto příkladu předpokládejme, že máte tento řetězec XML, který obsahuje obor názvů dokumentu XML: xmlns="https://contoso.com"

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

Tyto výrazy používají buď výraz XPath, /*[name()="file"]/*[name()="location"] nebo /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], k vyhledání uzlů, které odpovídají <location></location> uzlu. Tyto příklady ukazují syntaxi, kterou používáte v návrháři nebo v editoru výrazů:

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

Tady je výsledný uzel, který odpovídá <location></location> uzlu:

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

Důležité

Pokud pracujete v zobrazení kódu, uvozovky uvozovky (") použijte znak zpětného lomítka (\). Pokud například serializujete výraz jako řetězec JSON, musíte použít řídicí znaky. Pokud ale pracujete v návrháři nebo editoru výrazů, nemusíte uvozovky uvozovky uvozovek přidávat automaticky do podkladové definice, například:

Zobrazení kódu: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Editor výrazů: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Příklad 9

V příkladu 8 tento příklad používá výraz XPath k 'string(/*[name()="file"]/*[name()="location"])'vyhledání hodnoty v <location></location> uzlu:

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

Tady je výsledek: Paris

Další kroky

Další informace o jazyce definice pracovního postupu