Megosztás a következőn keresztül:


Útmutató az Azure Logic Apps és a Power Automate munkafolyamatainak kifejezéseiben található függvényekhez

A következőkre vonatkozik: Azure Logic Apps (Fogyasztás + Standard)

Az Azure Logic Apps és a Power Automate munkafolyamat-definícióihoz egyes kifejezések olyan futtatókörnyezeti műveletekből szerzik be az értékeiket, amelyek még nem léteznek a munkafolyamat futtatásakor. Az ezekben a kifejezésekben szereplő értékek hivatkozásához vagy feldolgozásához használhatja a munkafolyamat-definíció nyelve által biztosított kifejezésfüggvényeket.

Note

Ez a referencia-útmutató az Azure Logic Appsre és a Power Automate-ra is vonatkozik, de megtalálható az Azure Logic Apps dokumentációjában. Bár az útmutató kifejezetten a logikai alkalmazások munkafolyamataira vonatkozik, ezek a függvények a Power Automate folyamataiban és az Azure Logic Apps munkafolyamataiban is működnek. A Power Automate függvényeivel és kifejezéseivel kapcsolatos további információkért lásd: Kifejezések használata feltételekben.

Az értékeket például matematikai függvényekkel, például az add() függvénnyel is kiszámíthatja, ha egész számokból vagy lebegőpontos értékekből szeretné kiszámolni az összeget. Az alábbi példafeladatok függvényekkel végezhetők el:

Task Függvényszintaxis Result
Kicserélje a szöveges adatot kisbetűs formátumra. toLower('<'>)

Például: toLower('Hello')
"hello"
Globálisan egyedi azonosítót (GUID) ad vissza. guid() "c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Ha általános rendeltetésük alapján szeretne függvényeket keresni, tekintse át az alábbi táblázatokat. Vagy az egyes függvényekről további információt az ábécésorrendben talál.

Függvények a kifejezésekben

Ha be szeretné mutatni, hogyan használhat függvényt egy kifejezésben, ez a példa bemutatja, hogyan szerezheti be az értéket a customerName paraméterből, és hogyan rendelheti hozzá ezt az értéket a accountName tulajdonsághoz egy kifejezés paraméter() függvényének használatával:

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

Íme néhány további általános módszer a függvények kifejezésekben való használatára:

Task Függvényszintaxis egy kifejezésben
Ha az elemet egy függvénynek továbbítja, végezze el a munkát az elemekkel. "@<functionName>(<elem>)"
1. Kérje le a parameterName értékét a beágyazott parameters() függvény használatával.
2. Végezze el a munkát az eredménnyel úgy, hogy átadja az értéket a functionName függvénynek.
"@<functionName>(parameters('<parameterName>'))"
1. Az eredmény lekérése a beágyazott belső függvényFüggvényNév függvényéből.
2. Adja át az eredményt a Külső függvényNév2 függvénynek.
"@<functionName2>(<functionName>(<item>))"
1. Az eredmény lekérése a functionName függvényből.
2. Mivel az eredmény egy tulajdonságnév tulajdonságú objektum, kérje le a tulajdonság értékét.
"@<functionName>(<elem>).<propertyName>"

A függvény például concat() két vagy több sztringértéket vehet fel paraméterként. Ez a függvény egyesíti ezeket a sztringeket egy sztringben. Sztringkonstansokat, például "Sophia" és "Owen" karakterláncot is átadhat, hogy egy "SophiaOwen" kombinált sztringet kapjon:

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

Vagy sztringértékeket is lekérhet paraméterekből. Ez a példa az parameters() egyes concat() paraméterek és paraméterek függvényét firstNamelastName használja. Ezután átadja az eredményül kapott sztringeket a concat() függvénynek, hogy egy kombinált sztringet kapjon, például "SophiaOwen":

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

Mindkét példa hozzárendeli az eredményt a customerName tulajdonsághoz.

A függvények használatának szempontjai

  • A tervező nem értékeli ki a tervezési időben függvényparaméterként használt futtatókörnyezeti kifejezéseket. A tervező megköveteli, hogy az összes kifejezés teljes mértékben kiértékelhető legyen a tervezéskor.

  • A függvényparaméterek kiértékelése balról jobbra történik.

  • A paraméterdefiníciók szintaxisában a paraméter után megjelenő kérdőjel (?) azt jelenti, hogy a paraméter nem kötelező. Lásd például a getFutureTime()-t.

  • Az egyszerű szöveggel beágyazott függvénykifejezésekhez kapcsos zárójeleket ({}) kell csatolni a kifejezés interpolált formátumának használatához. Ez a formátum segít elkerülni a problémák elemzését. Ha a függvénykifejezés nem jelenik meg beágyazott szöveggel, nincs szükség kapcsos zárójelre.

    Az alábbi példa a helyes és helytelen szintaxist mutatja be:

    Helyes: "<text>/@{<function-name>('<parameter-name>')}/<text>"

    Helytelen: "<text>/@<function-name>('<parameter-name>')/<text>"

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

A következő szakaszok a függvényeket az általános rendeltetésük alapján rendezik, vagy betűrendben böngészhetők.

Karakterlánc függvények

Karakterláncokkal való munkához használhatja ezeket a karakterláncfüggvényeket, valamint néhány gyűjteményfüggvényt is. A karakterláncfüggvények csak karakterláncokon működnek.

Karakterlánc függvény Task
chunk Sztring vagy gyűjtemény felosztása egyenlő hosszúságú adattömbökre.
concat Két vagy több karakterlánc egyesítése és az egyesített karakterlánc visszaadása.
endsWith Ellenőrizze, hogy egy sztring a megadott részsztringgel végződik-e.
formatNumber Szám visszaadása sztringként a megadott formátum alapján
guid Hozzon létre egy globális egyedi azonosítót (GUID) karakterláncként.
indexOf Adja vissza egy részszöveg kezdőpozícióját.
isFloat Egy logikai értéket ad vissza, amely azt jelzi, hogy egy sztring lebegőpontos szám-e.
isInt Egy logikai értéket ad vissza, amely jelzi, hogy egy sztring egész szám-e.
lastIndexOf Adja meg a részszöveg utolsó előfordulásának kezdő pozícióját.
length Egy sztring vagy tömb elemeinek számát adja vissza.
nthIndexOf Adja vissza azt a kezdőpozíciót vagy indexértéket, amelyben egy sztringben megjelenik egy részsztring n. előfordulása.
replace Cserélje le az alsztringet a megadott sztringre, és adja vissza a frissített sztringet.
slice Részszúrást ad vissza a kezdő és záró pozíció vagy érték megadásával. Lásd még: részszűkítés.
split Olyan tömböt ad vissza, amely vesszővel elválasztott részsztringeket tartalmaz egy nagyobb sztringtől az eredeti sztring megadott elválasztó karaktere alapján.
startsWith Ellenőrizze, hogy egy sztring egy adott részsztringgel kezdődik-e.
substring Karaktereket ad vissza egy sztringből, a megadott pozíciótól kezdve. Lásd még : szelet.
toLower Kicserélje a szöveges adatot kisbetűs formátumra.
toUpper Karakterláncot ad vissza nagybetűs formátumban.
trim Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

Gyűjteményfüggvények

A gyűjtemények, általában tömbök, karakterláncok és néha szótárak kezeléséhez ezeket a gyűjteményfüggvényeket használhatja.

Gyűjtési függvény Task
chunk Sztring vagy gyűjtemény felosztása egyenlő hosszúságú adattömbökre.
contains Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet.
empty Ellenőrizze, hogy egy gyűjtemény üres-e.
first Egy gyűjtemény első elemének visszaadása.
intersection Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit.
item Ha ez a függvény egy tömbön ismétlődő műveletben jelenik meg, a művelet aktuális iterációja során adja vissza a tömb aktuális elemét.
join Olyan sztringet ad vissza, amely elemeket egy tömbből, a megadott karakterrel elválasztva.
last Egy gyűjtemény utolsó elemének visszaadása.
length Egy sztring vagy tömb elemeinek számát adja vissza.
reverse Egy tömb elemeinek sorrendjének megfordítása.
skip Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.
sort Gyűjtemény elemeinek rendezése.
take Visszaad elemeket egy gyűjtemény elejéről.
union Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények elemeit.

Logikai összehasonlító függvények

A feltételek használatához, az értékek és a kifejezések eredményeinek összehasonlításához, illetve a különböző típusú logika kiértékeléséhez használhatja ezeket a logikai összehasonlító függvényeket. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Note

Ha logikai függvényekkel vagy feltételekkel hasonlítja össze az értékeket, a null értékek üres sztringértékekké alakulnak"". A feltételek viselkedése akkor különbözik, ha null érték helyett üres sztringgel hasonlít össze. További információt a sztring() függvényben talál.

Logikai összehasonlító függvény Task
and Ellenőrizze, hogy az összes kifejezés igaz-e.
equals Ellenőrizze, hogy mindkét érték egyenértékű-e.
greater Ellenőrizze, hogy az első érték nagyobb-e a másodiknál.
greaterOrEquals Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték.
if Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.
isFloat Egy logikai értéket ad vissza, amely azt jelzi, hogy egy sztring lebegőpontos szám-e.
isInt Egy logikai értéket ad vissza, amely jelzi, hogy egy sztring egész szám-e.
less Ellenőrizze, hogy az első érték kisebb-e a másodiknál.
lessOrEquals Ellenőrizze, hogy az első érték kisebb-e, mint a második érték.
not Ellenőrizze, hogy egy kifejezés hamis-e.
or Ellenőrizze, hogy legalább egy kifejezés igaz-e.

Konverziós függvények

Egy érték típusának vagy formátumának módosításához használhatja ezeket a konvertálási függvényeket. Módosíthatja például egy logikai érték értékét egész számmá. További információ arról, hogy az Azure Logic Apps hogyan kezeli a tartalomtípusokat a konvertálás során, olvassa el a Tartalomtípusok kezelése című témakört. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Implicit adattípus-átalakítások.

Konvertálási függvény Task
array Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd createArray.
base64 Adja vissza egy karakterlánc base64-kódolt verzióját.
base64ToBinary Egy base64 kódolású sztring bináris verzióját adja vissza.
base64ToString A base64 kódolású karakterlánc szöveges változatát adja vissza.
binary Adja vissza egy bemeneti érték bináris verzióját.
bool Adja vissza egy bemeneti érték logikai verzióját.
createArray Több bemenetből származó tömböt ad vissza.
dataUri Adja vissza egy bemeneti érték adat-URI-ját.
dataUriToBinary Adja vissza egy adat URI bináris verzióját.
dataUriToString Addja vissza az adat URI karakterlánc változatát.
decimal Egy decimális sztring decimális számát adja vissza.
decodeBase64 A base64 kódolású karakterlánc szöveges változatát adja vissza.
decodeDataUri Adja vissza egy adat URI bináris verzióját.
decodeUriComponent Adjon vissza egy karakterláncot, amely az escape karaktereket dekódolt verziókra cseréli.
encodeUriComponent Olyan sztringet ad vissza, amely az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
float Egy bemeneti érték lebegőpontos számát adja vissza.
int A karakterlánc egész szám verziójának visszaadása.
json Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.
string Adja vissza egy bemeneti érték sztringverziójának értékét.
uriComponent Adja vissza egy bemeneti érték URI-kódolású verzióját úgy, hogy az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
uriComponentToBinary Adja vissza az URI-kódolt sztring bináris verzióját.
uriComponentToString Adja vissza az URI-kódolt karaktersorozat szöveges változatát.
xml Adja vissza a szöveg XML-verzióját.

Implicit adattípus-átalakítások

Az Azure Logic Apps automatikusan vagy implicit módon konvertál bizonyos adattípusok között, így nem kell manuálisan végrehajtania ezeket a konverziókat. Ha például nem sztringértékeket használ, ahol a sztringek bemenetként várhatók, az Azure Logic Apps automatikusan sztringekké alakítja a nem sztringértékeket.

Tegyük fel például, hogy egy eseményindító kimenetként numerikus értéket ad vissza:

triggerBody()?['123']

Ha ezt a numerikus kimenetet használja, ahol sztringbemenet várható (például URL-cím), az Azure Logic Apps automatikusan sztringgé alakítja az értéket a kapcsos zárójelek ({}) jelölésével:

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

Base64 kódolás és dekódolás

Az Azure Logic Apps automatikusan vagy implicit módon végzi el a Base64 kódolását vagy dekódolását, így nem kell manuálisan végrehajtania ezeket a konverziókat a megfelelő függvények használatával:

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

Note

Ha a tervező használata közben manuálisan adja hozzá ezeket a függvényeket, akár közvetlenül egy eseményindítóhoz vagy művelethez, akár a kifejezésszerkesztővel, navigáljon a tervezőtől, majd térjen vissza a tervezőhöz, a függvény eltűnik a tervezőből, és csak a paraméterértékeket hagyja hátra. Ez a viselkedés akkor is előfordul, ha kiválaszt egy eseményindítót vagy műveletet, amely ezt a függvényt használja a függvény paraméterértékeinek szerkesztése nélkül. Ez az eredmény csak a függvény láthatóságát befolyásolja, az effektust nem. Kódnézetben a függvény nincs hatással. Ha azonban szerkessze a függvény paraméterértékeit, a függvény és annak hatása is törlődik a kódnézetből, és csak a függvény paraméterértékeit hagyja hátra.

Matematikai függvények

Az egész számok és a lebegőpontos függvények használatához használhatja ezeket a matematikai függvényeket. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Matematikai függvény Task
add Két szám hozzáadásának eredményét adja vissza.
div Két szám osztásából származó eredményt adja vissza.
max Számkészletből vagy tömbből a legmagasabb értéket adja vissza.
min A legkisebb értéket adja vissza számkészletből vagy tömbből.
mod Adja vissza a maradékot két szám osztásából.
mul Adja vissza a szorzatot két szám szorzásából.
rand Véletlenszerű egész számot ad vissza egy megadott tartományból.
range Adott egész számból induló egész tömböt ad vissza.
sub A második szám kivonásának eredményét adja vissza az első számból.

Dátum- és időfüggvények

A dátumok és időpontok használatához használhatja ezeket a dátum- és időfüggvényeket. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Dátum- vagy időfüggvény Task
addDays Napok hozzáadása időbélyeghez.
addHours Órák hozzáadása időbélyeghez.
addMinutes Percek hozzáadása időbélyeghez.
addSeconds Másodpercek hozzáadása időbélyeghez.
addToTime Adjon hozzá megadott időegységeket egy időbélyeghez. Lásd még getFutureTime.
convertFromUtc Az időbélyeget az univerzális idő szerint koordinált (UTC) időzónából konvertáljuk a cél időzónába.
convertTimeZone Időbélyeg konvertálása a forrás időzónából a cél időzónává.
convertToUtc Időbélyeg konvertálása a forrás időzónából univerzális idő koordinált (UTC) időzónává.
dateDifference Adja vissza a két dátum közötti különbséget időbélyegként.
dayOfMonth Adja vissza az időbélyeg hónapnapi komponensét.
dayOfWeek A hét napját adja vissza egy időbélyegből.
dayOfYear Az időbélyegből adja vissza az év napját.
formatDateTime Időbélyegből adja vissza a dátumot.
getFutureTime Adja vissza az aktuális időbélyeget és a megadott időegységeket. Lásd még addToTime.
getPastTime Az aktuális időbélyeget adja vissza a megadott időegységekkel együtt. Lásd még: kivonás az időből.
parseDateTime Az időbélyeget tartalmazó sztring időbélyegét adja vissza.
startOfDay Az időbélyeg napjának kezdetét adja vissza.
startOfHour Adja vissza az időbélyeghez tartozó óra elejét.
startOfMonth Adja meg a hónap kezdetét egy időbélyeg alapján.
subtractFromTime Vonjon ki több időegységet egy időbélyegből. Lásd még getPastTime.
ticks Adja vissza egy adott időbélyeg ticks tulajdonságértékét.
utcNow Add vissza az aktuális időbélyeget karakterláncként.

Munkafolyamat-függvények

Ezek a munkafolyamat-függvények a következőkben nyújtanak segítséget:

  • A munkafolyamat-példányok futásidejű részleteinek lekérése.
  • Használja a logikai alkalmazások vagy folyamatok példányosításához használt bemeneteket.
  • Hivatkozzon az eseményindítók és műveletek kimenetére.

Hivatkozhat például egy művelet kimenetére, és felhasználhatja az adatokat egy későbbi műveletben. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Munkafolyamat-függvény Task
action Adja vissza az aktuális művelet kimenetét futásidőben, vagy más JSON-név- és értékpárok értékeit. Lásd még a műveleteket.
actions Egy művelet kimenetét adja vissza futásidőben, vagy más JSON-név- és értékpárok értékeit. Lásd még : művelet.
body Egy művelet kimenetét body adja vissza futásidőben.
formDataMultiValues Hozzon létre egy tömböt az űrlapadatokban vagy űrlapkódolt műveletkimenetekben szereplő kulcsnévnek megfelelő értékekkel.
formDataValue Egyetlen értéket ad vissza, amely megfelel egy kulcsnévnek egy művelet űrlapadataiban vagy űrlapkódolt kimenetében.
item Ha ez a függvény egy tömbön ismétlődő műveletben jelenik meg, a művelet aktuális iterációja során adja vissza a tömb aktuális elemét.
items Ha ez a függvény egy Foreach vagy Until ciklusban jelenik meg, adja vissza az aktuális elemet a megadott ciklusból.
iterationIndexes Ha ez a függvény egy Until ciklusban jelenik meg, adja vissza az aktuális iteráció indexértékét. Ezt a függvényt a beágyazott Until hurkokban használhatja.
listCallbackUrl Adja vissza az eseményindítót vagy műveletet meghívó visszahívási URL-címet.
multipartBody Adja vissza egy adott rész törzsét egy művelet kimenetében, amely több részből áll.
outputs Egy művelet kimenetét adja vissza futásidőben.
parameters Adja vissza a munkafolyamat-definícióban leírt paraméter értékét.
result Adja vissza a megadott hatókörű művelet felső szintű műveleteinek bemeneteit és kimeneteit, például For_each: , Untilés Scope.
trigger Az eseményindító kimenetét futásidőben vagy más JSON-név- és értékpárokból adja vissza. Lásd még: triggerOutputs és triggerBody.
triggerBody Egy eseményindító kimenetét body adja vissza futásidőben. Lásd az eseményindítót.
triggerFormDataValue Egyetlen, kulcsnévnek megfelelő értéket ad vissza űrlapadatokban vagy űrlapkódolt triggerkimenetekben.
triggerMultipartBody Az eseményindító többrészes kimenetének egy adott részének törzsét adja vissza.
triggerFormDataMultiValues Hozzon létre egy tömböt, amelynek értékei megegyeznek egy kulcsnévvel az űrlapadatokban vagy az űrlapkódolt triggerkimenetekben.
triggerOutputs Egy eseményindító kimenetét adja vissza futásidőben, vagy más JSON-név- és értékpárok értékeit. Lásd az eseményindítót.
variables Egy megadott változó értékét adja vissza.
workflow Adja vissza a munkafolyamat minden részletét a futási idő alatt.

URI-elemzési függvények

Ha egységes erőforrás-azonosítókkal (URI-kkal) szeretne dolgozni, és különböző tulajdonságértékeket szeretne lekérni ezekhez az URI-khoz, használhatja ezeket az URI-elemzési függvényeket. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

URI-elemzési függvény Task
uriHost host Az egységes erőforrás-azonosító (URI) értékét adja vissza.
uriPath path Az egységes erőforrás-azonosító (URI) értékét adja vissza.
uriPathAndQuery path Az egységes erőforrás-azonosító (URI) értékeit adja query vissza.
uriPort port Az egységes erőforrás-azonosító (URI) értékét adja vissza.
uriQuery query Az egységes erőforrás-azonosító (URI) értékét adja vissza.
uriScheme scheme Az egységes erőforrás-azonosító (URI) értékét adja vissza.

Manipulációs függvények: JSON > XML

JSON-objektumok és XML-csomópontok használatához használhatja ezeket a kezelési függvényeket. Az egyes függvényekre vonatkozó teljes hivatkozásért tekintse meg az betűrendes listát.

Manipulációs függvény Task
addProperty Adjon hozzá egy tulajdonságot és annak értékét vagy név-érték párját egy JSON-objektumhoz, és adja vissza a frissített objektumot.
coalesce Az első nem null értéket adja vissza egy vagy több paraméterből.
removeProperty Távolítsa el a tulajdonságot egy JSON-objektumból, és adja vissza a frissített objektumot.
setProperty Állítsa be egy JSON-objektum tulajdonságának értékét, és adja vissza a frissített objektumot.
xpath Ellenőrizze az XML-ben az XPath (XML Path Language) kifejezésnek megfelelő csomópontokat vagy értékeket, és adja vissza az egyező csomópontokat vagy értékeket.

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

Minden függvény – betűrendes lista

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

A

művelet

Adja vissza az aktuális művelet kimenetét futásidőben, vagy más JSON-név- és értékpárok értékeit, amelyeket hozzárendelhet egy kifejezéshez. Ez a függvény alapértelmezés szerint a teljes műveleti objektumra hivatkozik, de megadhat egy tulajdonságot, amelynek értékét meg szeretné adni. Lásd még : műveletek().

A függvényt csak ezeken a action() helyeken használhatja:

  • A unsubscribe webhook-művelet tulajdonsága, amely lehetővé teszi az eredmény elérését az eredeti subscribe kérésből
  • Művelet trackedProperties tulajdonsága
  • A do-until művelet ciklusfeltétele
action()
action().outputs.body.<property>
Parameter Required Típus Description
< ingatlan> No String A műveletobjektum tulajdonságának neve, amelynek értékét meg szeretné adni: név, startTime, endTime, bemenetek, kimenetek, állapot, kód, trackingId és clientTrackingId. Az Azure Portalon ezeket a tulajdonságokat egy adott futtatási előzmények részleteinek áttekintésével találja meg. További információ: REST API – Munkafolyamat-futtatási műveletek.
Visszaadott érték Típus Description
< akció-kimenet> Object Az aktuális művelet vagy tulajdonság JSON-objektumkimenete

actions

Adja vissza egy művelet kimenetét futásidőben, vagy más JSON-név- és értékpárok értékeit, amelyeket hozzárendelhet egy kifejezéshez. A függvény alapértelmezés szerint a teljes műveletobjektumra hivatkozik, de megadhat egy tulajdonságot, amelynek értékét meg szeretné adni. A rövidített verziókról lásd: törzs(). Az aktuális műveletről lásd: művelet().

Note

Korábban használhatta a actions() függvényt vagy az conditions elemet, amikor megadhatja, hogy egy művelet egy másik művelet kimenete alapján futjon. A műveletek közötti explicit függőségek deklarálásához azonban a függő művelet tulajdonságát kell használnia runAfter . A tulajdonsággal kapcsolatos további információkért tekintse meg a runAfter runAfter tulajdonság hibáinak fogását és kezelését ismertető témakört.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parameter Required Típus Description
< akciónév> Yes String Annak a műveletobjektumnak a neve, amelynek kimenetét ki szeretné használni
< ingatlan> No String A műveletobjektum tulajdonságának neve, amelynek értékét meg szeretné adni: név, startTime, endTime, bemenetek, kimenetek, állapot, kód, trackingId és clientTrackingId. Az Azure Portalon ezeket a tulajdonságokat egy adott futtatási előzmények részleteinek áttekintésével találja meg. További információ: REST API – Munkafolyamat-futtatási műveletek.
Visszaadott érték Típus Description
< akció-kimenet> Object A megadott művelet vagy tulajdonság JSON-objektumkimenete

Example

Ez a példa lekéri a status tulajdonság értékét az X műveletből Get user futásidőben:

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

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

add

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

add(<summand_1>, <summand_2>)
Parameter Required Típus Description
< összegző_1>, <összegző_2> Yes Egész szám, lebegőpontos vagy vegyes A hozzáadni kívánt számok
Visszaadott érték Típus Description
< eredményösszeg> Egész szám vagy lebegőpontos A megadott számok hozzáadásának eredménye

Example

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

add(1, 1.5)

És ezt az eredményt adja vissza: 2.5

addDays

Napok hozzáadása időbélyeghez.

addDays('<timestamp>', <days>, '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< nap> Yes Integer A hozzáadandó napok pozitív vagy negatív száma
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyeg és a megadott számú nap

1. példa

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

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

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

2. példa

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

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

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

addHours

Órák hozzáadása időbélyeghez.

addHours('<timestamp>', <hours>, '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< óra> Yes Integer A hozzáadni kívánt órák pozitív vagy negatív száma
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyeg és a megadott számú óra

1. példa

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

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

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

2. példa

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

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

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

addMinutes

Percek hozzáadása időbélyeghez.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< perc> Yes Integer A hozzáadandó percek pozitív vagy negatív száma
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyeg és a megadott számú perc

1. példa

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

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

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

2. példa

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

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

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

addProperty

Adjon hozzá egy tulajdonságot és annak értékét vagy név-érték párját egy JSON-objektumhoz, és adja vissza a frissített objektumot. Ha a tulajdonság futásidőben már létezik, a függvény meghiúsul, és hibát jelez.

addProperty(<object>, '<property>', <value>)
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelyhez tulajdonságot szeretne hozzáadni
< ingatlan> Yes String A hozzáadni kívánt tulajdonság neve
< érték> Yes Any A tulajdonság értéke
Visszaadott érték Típus Description
< frissített-objektum> Object A frissített JSON-objektum a megadott tulajdonsággal

Ha szülőtulajdonságot szeretne hozzáadni egy meglévő tulajdonsághoz, használja a setProperty() függvényt, nem a függvényt addProperty() . Ellenkező esetben a függvény csak a gyermekobjektumot adja vissza kimenetként.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelyhez tulajdonságot szeretne hozzáadni
< Szülő-tulajdonság> Yes String Annak a szülőtulajdonságnak a neve, amelyhez hozzá szeretné adni a gyermektulajdonságot
< gyermektulajdonság> Yes String A hozzáadni kívánt gyermektulajdonság neve
< érték> Yes Any A megadott tulajdonsághoz beállított érték
Visszaadott érték Típus Description
< frissített-objektum> Object A frissített JSON-objektum, amelynek a tulajdonságát beállította

1. példa

Ez a példa hozzáadja a middleName tulajdonságot egy JSON-objektumhoz, amelyet egy sztringből JSON-ra konvertál a JSON() függvény használatával. Az objektum már tartalmazza a tulajdonságokat és firstName a surName tulajdonságokat. A függvény hozzárendeli a megadott értéket az új tulajdonsághoz, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

2. példa

Ez a példa hozzáadja a middleName gyermektulajdonságot egy JSON-objektum meglévő customerName tulajdonságához, amelyet egy sztringből JSON-ra konvertál a JSON() függvény használatával. A függvény hozzárendeli a megadott értéket az új tulajdonsághoz, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

addSeconds

Másodpercek hozzáadása időbélyeghez.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< másodperc> Yes Integer A hozzáadandó másodpercek pozitív vagy negatív száma
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyeg és a megadott számú másodperc

1. példa

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

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

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

2. példa

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

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

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

addToTime

Adja hozzá a megadott időegységeket egy időbélyeghez. Lásd még getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< intervallum> Yes Integer A hozzáadni kívánt időegységek száma
< időegység> Yes String A intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyeg és a megadott számú időegység

1. példa

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

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

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

2. példa

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

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

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

and

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

and(<expression1>, <expression2>, ...)
Parameter Required Típus Description
< kifejezés1>, <kifejezés2>, ... Yes logikai Az ellenőrizni kívánt kifejezések
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha az összes kifejezés igaz. Hamis értéket ad vissza, ha legalább egy kifejezés hamis.

1. példa

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

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

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

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

2. példa

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

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

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

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

tömb

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

array('<value>')
Parameter Required Típus Description
< érték> Yes String A tömb létrehozására szolgáló karakterlánc
Visszaadott érték Típus Description
[<érték>] Array Az egyetlen megadott bemenetet tartalmazó tömb

Example

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

array('hello')

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

B

base64

Adja vissza egy karakterlánc base64-kódolt verzióját.

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Base64 kódolás és dekódolás.

base64('<value>')
Parameter Required Típus Description
< érték> Yes String A bemeneti karakterlánc
Visszaadott érték Típus Description
< base64 karakterlánc> String A bemeneti sztring base64 kódolású verziója

Example

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

base64('hello')

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

base64ToBinary

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

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Base64 kódolás és dekódolás.

base64ToBinary('<value>')
Parameter Required Típus Description
< érték> Yes String A konvertálni kívánt base64 kódolású sztring
Visszaadott érték Típus Description
< bináris base64-karakterlánc> String A base64 kódolású sztring bináris verziója

Example

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

base64ToBinary('aGVsbG8=')

Tegyük fel például, hogy HTTP-műveletet használ egy kérés elküldéséhez. A base64ToBinary() base64 kódolású sztringeket bináris adatokká alakíthatja, és elküldheti ezeket az adatokat a application/octet-stream kérelemben szereplő tartalomtípussal.

base64ToString

Adja vissza a base64-kódolt karakterlánc szöveges verzióját, ezzel dekódolva a base64 karakterláncot. Használja ezt a függvényt az elavult DecodeBase64() helyett.

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Base64 kódolás és dekódolás.

base64ToString('<value>')
Parameter Required Típus Description
< érték> Yes String A dekódolni kívánt base64-kódolású sztring
Visszaadott érték Típus Description
< dekódolt base64 sztring> String A base64 kódolású sztring szöveges változata

Example

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

base64ToString('aGVsbG8=')

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

bináris

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

binary('<value>')
Parameter Required Típus Description
< érték> Yes String Az átalakítandó karakterlánc
Visszaadott érték Típus Description
< bináris bemeneti értékre> String A megadott sztring alap64 kódolású bináris verziója

Example

Például olyan HTTP-műveletet használ, amely egy képet vagy videofájlt ad vissza. Az értéket alapszintű 64-es kódolt tartalomburkoló modellté alakíthatja binary() . Ezután újra felhasználhatja a tartalomborítéket más műveletekben, például Compose. Ezzel a függvénykifejezéssel küldheti el a kérésben szereplő tartalomtípussal rendelkező application/octet-stream sztringbájtokat.

body

Egy művelet kimenetét body adja vissza futásidőben. Rövidítés a következőhöz actions('<actionName>').outputs.body: . Lásd : műveletek().

body('<actionName>')
Parameter Required Típus Description
< akciónév> Yes String A művelet kívánt kimenetének body neve
Visszaadott érték Típus Description
< művelettörzs kimenete> String A body megadott művelet kimenete

Example

Ez a példa lekéri az body X művelet kimenetét Get user :

body('Get_user')

És ezt az eredményt adja vissza:

"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

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

bool(<value>)
Parameter Required Típus Description
< érték> Yes Any A logikai értékké konvertálandó érték.

Ha objektumot használ bool() , az objektum értékének olyan sztringnek vagy egész számnak kell lennie, amely logikai értékké alakítható.

Visszaadott érték Típus Description
true vagy false logikai A megadott érték logikai verziója.

Outputs

Az alábbi példák a különböző támogatott bemenettípusokat mutatják be a következőhöz bool():

Bemeneti érték Típus Visszaadott érték
bool(1) Integer true
bool(0) Integer false
bool(-1) Integer true
bool('true') String true
bool('false') String false

C

chunk

Sztring vagy tömb felosztása egyenlő hosszúságú adattömbökre.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parameter Required Típus Description
< gyűjtemény> Yes Sztring vagy tömb A felosztandó gyűjtemény
< hossz> Yes Az egyes adattömbek hossza
Visszaadott érték Típus Description
< gyűjtemény> Array A megadott hosszúságú adattömbök tömbje

1. példa

Ez a példa egy sztringet 10 hosszúságú adattömbökre oszt:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

És ezt az eredményt adja vissza: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

2. példa

Ez a példa egy tömböt 5 hosszúságú tömbökre osztja fel.

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

És ezt az eredményt adja vissza: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

egyesít

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

coalesce(<object_1>, <object_2>, ...)
Parameter Required Típus Description
< >object_1, <object_2>, ... Yes Bármely, keverheti a típusokat Egy vagy több, null értéket ellenőrizni kívánt elem
Visszaadott érték Típus Description
< első nem null értékű> Any Az első elem vagy érték, amely nem null értékű. Ha minden paraméter null értékű, akkor a függvény null értéket ad vissza.

Example

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

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

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

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

concat

Két vagy több karakterlánc egyesítése és az egyesített karakterlánc visszaadása.

concat('<text1>', '<text2>', ...)
Parameter Required Típus Description
< szöveg1>, <szöveg2>, ... Yes String Legalább két karakterláncot kombinálni
Visszaadott érték Típus Description
< szöveg1szöveg2...> String A kombinált bemeneti sztringekből létrehozott sztring.



Megjegyzés: Az eredmény hossza nem haladhatja meg a 104 857 600 karaktert.

Note

Az Azure Logic Apps automatikusan vagy implicit módon végrehajtja a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konverziókat, ha a concat() függvényt kódolásra vagy dekódoláshoz szükséges adatokkal használja:

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

Ha azonban mégis ezt a függvényt használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvény láthatóságát befolyásolják, az effektust csak akkor, ha módosítja a függvény paraméterértékeit, ami eltávolítja a függvényt és az effektust a kódból. További információkért tekintse át a Base64 kódolását és dekódolását.

Example

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

concat('Hello', 'World')

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

contains

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

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

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

  • sztringrészszöveg megkereséséhez
  • Egy tömbérték kereséséhez
  • Egy szótár a kulcs megkereséséhez
Parameter Required Típus Description
< gyűjtemény> Yes Sztring, tömb vagy szótár Az ellenőrizni kívánt gyűjtemény
< érték> Yes Sztring, tömb vagy szótár A keresendő elem
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza az elem megtalálásakor. Hamis értéket ad vissza, ha nem található.

1. példa

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

contains('hello world', 'world')

2. példa

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

contains('hello world', 'universe')

convertFromUtc

Az időbélyeget az univerzális idő szerint koordinált (UTC) időzónából konvertáljuk a cél időzónába.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< célidőzóna> Yes String A cél időzóna neve. Az időzónák neveiért tekintse át a Microsoft Windows alapértelmezett időzónáit.
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< konvertált időbélyeg> String A cél időzónává konvertált időbélyeg az időzóna UTC-eltolása nélkül.

1. példa

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

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

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

2. példa

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

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

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

convertTimeZone

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

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< sourceTimeZone> Yes String A forrás időzóna neve. Az időzónanevekről a Microsoft Windows alapértelmezett időzónái című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< célidőzóna> Yes String A cél időzóna neve. Az időzónanevekről a Microsoft Windows alapértelmezett időzónái című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< konvertált időbélyeg> String A cél időzónára konvertált időbélyeg

1. példa

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

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

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

2. példa

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

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

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

convertToUtc

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

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< sourceTimeZone> Yes String A forrás időzóna neve. Az időzónanevekről a Microsoft Windows alapértelmezett időzónái című témakörben olvashat, de előfordulhat, hogy el kell távolítania az írásjeleket az időzóna nevéből.
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< konvertált időbélyeg> String Az időbélyeg UTC-vé konvertálva

1. példa

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

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

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

2. példa

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

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

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

createArray

Több bemenetből származó tömböt ad vissza. Az egyetlen bemeneti tömbökről lásd a következőt: tömb().

createArray('<object1>', '<object2>', ...)
Parameter Required Típus Description
< objektum1>, <objektum2>, ... Yes Bármely, de nem vegyes Legalább két elem a tömb létrehozásához
Visszaadott érték Típus Description
[<objektum1>, <tárgy2>, ...] Array Az összes bemeneti elemből létrehozott tömb

Example

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

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

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

D

dataUri

Adjon vissza egy karaktersorozat egységes erőforrás-azonosítóját (URI).

dataUri('<value>')
Parameter Required Típus Description
< érték> Yes String Az átalakítandó karakterlánc
Visszaadott érték Típus Description
< adat-azonosító> String A bemeneti sztring adat-URI-ja

Example

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')
Parameter Required Típus Description
< érték> Yes String Az átalakítandó adat URI-ja
Visszaadott érték Típus Description
< bináris adat-uri-hoz> String Az adat URI bináris verziója

Example

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

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')
Parameter Required Típus Description
< érték> Yes String Az átalakítandó adat URI-ja
Visszaadott érték Típus Description
< sztring for-data-uri> String Az adat URI karakterlánc verziója

Example

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

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

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

dateDifference

Adja vissza a két időbélyeg közötti különbséget időbélyegként. Ez a függvény kivonja startDate a függvényből endDate, és az eredményt sztringformátumban időbélyegként adja vissza.

dateDifference('<startDate>', '<endDate>')
Parameter Required Típus Description
< startDátum> Yes String Időbélyeget tartalmazó sztring
< végDátum> Yes String Időbélyeget tartalmazó sztring
Visszaadott érték Típus Description
< időbélyeg> String A két időbélyeg közötti különbség, amely egy sztringformátumú időbélyeg. Ha startDate újabb, mint endDate, akkor az eredmény negatív érték.

Example

Ez a példa kivonja az első értéket a második értékből:

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

És ezt az eredményt adja vissza: "1268.00:00:00"

dayOfMonth

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

dayOfMonth('<timestamp>')
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
Visszaadott érték Típus Description
< hónap napja> Integer A hónap napja a megadott időbélyegből

Example

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

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

És ezt az eredményt adja vissza: 15

dayOfWeek

Adja vissza a hét napját egy időbélyeg alapján.

dayOfWeek('<timestamp>')
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
Visszaadott érték Típus Description
< hét minden napján> Integer A hét napja a megadott időbélyegből, ahol a vasárnap 0, a hétfő 1, és így tovább

Example

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

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

És ezt az eredményt adja vissza: 4

dayOfYear

Az év napját adja vissza egy időbélyeg alapján.

dayOfYear('<timestamp>')
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
Visszaadott érték Típus Description
< év minden napján> Integer Az év napja a megadott időbélyegből

Example

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

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

És ezt az eredményt adja vissza: 74

decimális

Decimális számot ad vissza egy sztringben decimális számként. Ezt a függvényt akkor használhatja, ha decimális pontosságot igénylő adatokkal dolgozik, valamint a logikai összehasonlító függvények és matematikai függvények bemeneteként is. Ha a decimális() függvény eredményének használatakor szeretné rögzíteni és megőrizni a pontosságot, csomagolja be a decimális kimenetet a sztringfüggvénybe. Ez a használat az alábbi példákban látható, ahol elveszítheti a pontosságot, ha a decimális eredményt számként használja.

Note

A függvény környezetében és az Azure Logic Apps-futtatókörnyezetben tárgyalt decimális pontosság megegyezik a .NET decimális pontosságával.

decimal('<value>')
Parameter Required Típus Description
< érték> Yes String A sztring decimális száma
Visszaadott érték Típus Description
< tizedes> Tizedes tört szám A bemeneti sztring decimális száma

1. példa

Ez a példa egy számként használt tizedesjegyet hoz létre:

decimal('1.2345678912312131') // Returns 1.234567891231213.

2. példa

Ez a példa létrehoz egy decimális értéket, majd az eredményt sztringgé alakítja a pontosság megőrzése érdekében:

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

3. példa

Ez a példa egy matematikai függvényt használ két tizedesjegyen, és az eredményt számként használja:

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

4. példa

Ez a példa egy matematikai függvényt használ két tizedesjegyen, és az eredményt sztringgé alakítja a pontosság megőrzése érdekében:

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

decodeBase64 (elavult)

Ez a függvény elavult, ezért használja helyette a base64ToString() függvényt.

decodeDataUri

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

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Base64 kódolás és dekódolás.

decodeDataUri('<value>')
Parameter Required Típus Description
< érték> Yes String A dekódolni kívánt adat URI-sztringje
Visszaadott érték Típus Description
< bináris adat-uri-hoz> String Adat URI-sztring bináris verziója

Example

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

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

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

decodeUriComponent

Adjon vissza egy karakterláncot, amely az escape karaktereket dekódolt verziókra cseréli.

decodeUriComponent('<value>')
Parameter Required Típus Description
< érték> Yes String A kódolandó feloldó karaktereket tartalmazó sztring
Visszaadott érték Típus Description
< dekódolt uri> String A frissített karakterlánc a dekódolt escape karakterekkel

Example

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

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

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

div

Két szám osztásából származó eredményt adja vissza. A fennmaradó eredményért lásd mod().

div(<dividend>, <divisor>)
Parameter Required Típus Description
< osztalék> Yes Egész szám vagy lebegőpontos Az a szám, amelyet el kell osztani a osztóval-gyel.
< osztó> Yes Egész szám vagy lebegőpontos Az osztalékot megosztó szám, de nem lehet nulla
Visszaadott érték Típus Description
< hányadosos eredményű> Egész szám vagy lebegőpontos Az első szám és a második szám osztásának eredménye. Ha az osztalék vagy az osztó lebegőpontos típussal rendelkezik, az eredmény lebegőpontos típussal rendelkezik.



Megjegyzés: A lebegőpontos eredmény egész számmá alakításához próbáljon meg létrehozni és meghívni egy függvényt az Azure-ban a logikai alkalmazásból.

1. példa

Mindkét példa ezt az értéket adja vissza egész számtípussal: 2

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

2. példa

Mindkét példa ezt az értéket adja vissza lebegőpontos típussal: 2.2

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

E

encodeUriComponent

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

Note

Az Azure Logic Apps automatikusan vagy implicit módon elvégzi a Base64 kódolását és dekódolását, így nem kell manuálisan végrehajtania ezeket a konvertálásokat a kódolási és dekódolási függvények használatával. Ha azonban mégis ezeket a függvényeket használja a tervezőben, előfordulhat, hogy váratlan megjelenítési viselkedést tapasztal a tervezőben. Ezek a viselkedések csak a függvények láthatóságát befolyásolják, azok hatását csak akkor, ha módosítja a függvények paraméterértékeit, ami eltávolítja a függvényeket és azok hatásait a kódból. További információ: Base64 kódolás és dekódolás.

encodeUriComponent('<value>')
Parameter Required Típus Description
< érték> Yes String Az URI kódolású formátumba konvertálandó karakterlánc
Visszaadott érték Típus Description
< kódolt uri> String Az URI-kódolású sztring escape-karakterekkel

Example

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

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

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

empty

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

empty('<collection>')
empty([<collection>])
Parameter Required Típus Description
< gyűjtemény> Yes Sztring, tömb vagy objektum Az ellenőrizni kívánt gyűjtemény
Visszaadott érték Típus Description
igaz vagy hamis logikai Amikor a gyűjtemény üres, igaz értéket ad vissza. Hamis értéket ad vissza, ha nem üres.

Example

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

empty('')
empty('abc')

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

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

endsWith

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

endsWith('<text>', '<searchText>')
Parameter Required Típus Description
< szöveg> Yes String Az ellenőrizni kívánt karakterlánc
< keresési szöveg> Yes String A befejezési részstring a kereséshez
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha a záró részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1. példa

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

endsWith('hello world', 'world')

És ezt az eredményt adja vissza: true

2. példa

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

endsWith('hello world', 'universe')

És ezt az eredményt adja vissza: false

equals

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

equals('<object1>', '<object2>')
Parameter Required Típus Description
< objektum1>, <objektum2> Yes Various Az összehasonlítandó értékek, kifejezések vagy objektumok
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha mindkettő egyenértékű. Hamis értéket ad vissza, ha nem egyenértékű.

Example

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

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

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

  • Első példa: Mindkét érték egyenértékű, ezért a függvény truead vissza.
  • Második példa: Mindkét érték nem egyenértékű, ezért a függvény falsead vissza.

F

first

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

first('<collection>')
first([<collection>])
Parameter Required Típus Description
< gyűjtemény> Yes Sztring vagy tömb Az a gyűjtemény, ahol az első elem megtalálható
Visszaadott érték Típus Description
< első gyűjtemény elem> Any A gyűjtemény első eleme

Example

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

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

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

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

float

Konvertálja a lebegőpontos szám sztring változatát egy valódi lebegőpontos számmá. Ezt a függvényt csak akkor használhatja, ha egyéni paramétereket ad át egy alkalmazásnak, például egy logikai alkalmazás munkafolyamatának vagy a Power Automate-folyamatnak. A területileg meghatározott formátumokban ábrázolt lebegőpontos sztringek konvertálásához opcionálisan megadhat egy RFC 4646 területi kódot.

float('<value>', '<locale>'?)
Parameter Required Típus Description
< érték> Yes String A konvertálni kívánt érvényes lebegőpontos számmal rendelkező sztring. A minimális és maximális értékek megegyeznek a lebegőpontos adattípus korlátaival.
< színhely> No String A használni kívánt RFC 4646 területi kód.

Ha nincs megadva, a rendszer az alapértelmezett területi beállítást használja.

Ha a területi beállítás nem érvényes érték, hibaüzenet jelenik meg, amely szerint a megadott területi beállítás nem érvényes, vagy nem rendelkezik társított területi beállítással.
Visszaadott érték Típus Description
< lebegőpontos> Float A megadott sztring lebegőpontos száma. A minimális és maximális értékek megegyeznek a lebegőpontos adattípus korlátaival.

1. példa

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

float('10,000.333')

És ezt az eredményt adja vissza: 10000.333

2. példa

Ez a példa sztringverziót hoz létre ehhez a német stílusú lebegőpontos számhoz:

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

És ezt az eredményt adja vissza: 10000.333

3. példa

Példák váratlanul érvényes bemenetekre:

float('12,3,4,5678')  //Returns   12345678
float('1234567,8+')   //Returns   12345678
float('12345,6,78,-') //Returns  -12345678
float('-12,345,678,') //Returns  -12345678
float('12345678.-')   //Returns  -12345678
float('.12345678')    //Returns 0.12345678

formatDateTime

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

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.
< színhely> No String A használni kívánt területi beállítás. Ha nincs meghatározva, az érték .en-us Ha a területi beállítás nem érvényes érték, hiba jön létre.
Visszaadott érték Típus Description
< újraformált időbélyeg> String A frissített időbélyeg a megadott formátumban és területi beállításban, ha meg van adva.

Examples

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

Olyan tömböt ad vissza, amely egy művelet űrlapadataiban vagy űrlapkódolt kimenetében szereplő kulcsnévnek megfelelő értékeket tartalmaz.

formDataMultiValues('<actionName>', '<key>')
Parameter Required Típus Description
< akciónév> Yes String Az a művelet, amelynek kimenete rendelkezik a kívánt kulcsértékel
< kulcs> Yes String Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
[<tömb-kulcs-értékekkel>] Array A megadott kulcsnak megfelelő összes értékkel rendelkező tömb

Example

Ez a példa létrehoz egy tömböt a "Tárgy" kulcs értékéből a megadott művelet űrlapadataiban vagy űrlapkódolt kimenetében:

formDataMultiValues('Send_an_email', 'Subject')

És visszaadja a tárgy szövegét egy tömbben, például: ["Hello world"]

formDataValue

Egyetlen értéket ad vissza, amely megfelel egy kulcsnévnek egy művelet űrlapadataiban vagy űrlapkódolt kimenetében. Ha a függvény egynél több egyezést talál, a függvény hibát jelez.

formDataValue('<actionName>', '<key>')
Parameter Required Típus Description
< akciónév> Yes String Az a művelet, amelynek kimenete rendelkezik a kívánt kulcsértékel
< kulcs> Yes String Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
< kulcs-érték> String A megadott kulcs értéke

Example

Ez a példa létrehoz egy sztringet a "Tárgy" kulcs értékéből a megadott művelet űrlapadataiban vagy űrlapkódolt kimenetében:

formDataValue('Send_an_email', 'Subject')

És sztringként adja vissza a tárgyszöveget, például: "Hello world"

formatNumber

A megadott formátumon alapuló számot ad vissza sztringként.

formatNumber(<number>, <format>, <locale>?)
Parameter Required Típus Description
< szám> Yes Egész vagy dupla A formázni kívánt érték.
< formátum> Yes String A használni kívánt formátumot meghatározó összetett formátumsztring. A támogatott numerikus formátumú sztringek esetében lásd a Standard numerikus formátumú sztringeketnumber.ToString(<format>, <locale>), amelyeket a program támogat.
< színhely> No String Az a területi beállítás, amelyet number.ToString(<format>, <locale>)a program támogat. Ha nincs meghatározva, az érték .en-us Ha a területi beállítás nem érvényes érték, hiba jön létre.
Visszaadott érték Típus Description
< formázott szám> String A megadott szám sztringként a megadott formátumban. Ezt a visszatérési értéket egy vagy inttöbb értékre float is leadhatja.

1. példa

Tegyük fel, hogy formázni szeretné a számot 1234567890. Ez a példa "1 234 567 890,00" sztringként formázza a számot.

formatNumber(1234567890, '#,##0.00', 'en-US')

*2. példa"

Tegyük fel, hogy formázni szeretné a számot 1234567890. Ez a példa az "1.234.567.890,00" sztringre formázza a számot.

formatNumber(1234567890, '#,##0.00', 'is-IS')

3. példa

Tegyük fel, hogy formázni szeretné a számot 17.35. Ez a példa a számot "$17.35" sztringre formázza.

formatNumber(17.35, 'C2')

4. példa

Tegyük fel, hogy formázni szeretné a számot 17.35. Ez a példa a számot a "17,35 kr" sztringre formázza.

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

G

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)
Parameter Required Típus Description
< intervallum> Yes Integer A hozzáadni kívánt időegységek száma
< időegység> Yes String A intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< formátum> No String Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg, amely szerint a megadott formátum nem érvényes, és numerikus formázási sztringnek kell lennie.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az aktuális időbélyeg és a megadott számú időegység

1. példa

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

getFutureTime(5, 'Day')

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

2. példa

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

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

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

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)
Parameter Required Típus Description
< intervallum> Yes Integer A kivonáshoz megadott időegységek száma
< időegység> Yes String A intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< formátum> No String Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg, amely szerint a megadott formátum nem érvényes, és numerikus formázási sztringnek kell lennie.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az aktuális időpontból kivonva a megadott számú időegységet.

1. példa

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

getPastTime(5, 'Day')

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

2. példa

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

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

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

greater

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

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter Required Típus Description
< érték> Yes Egész szám, lebegőpontos vagy karaktersorozat Az első érték, amely ellenőrzi, hogy nagyobb-e a második értéknél
< összehasonlítással> Yes Egész szám, lebegőpontos szám vagy karakterlánc Az összehasonlító érték
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha az első érték nagyobb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy kisebb, mint a második érték.

Example

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

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

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

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

greaterOrEquals

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

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter Required Típus Description
< érték> Yes Egész szám, lebegőpontos vagy karaktersorozat Az első érték, amely ellenőrzi, hogy nagyobb vagy egyenlő-e a második értéknél
< összehasonlítással> Yes Egész szám, lebegőpontos szám vagy karakterlánc Az összehasonlító érték
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha az első érték nagyobb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték kisebb, mint a második érték.

Example

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

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

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

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

guid

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

guid()

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

guid('<format>')
Parameter Required Típus Description
< formátum> No String Egyetlen formátumkijelölő a visszaadott GUID-azonosítóhoz. Alapértelmezés szerint a formátum "D", de használhatja az "N", a "D", a "B", a "P" vagy az "X" formátumot.
Visszaadott érték Típus Description
< GUID-érték> String Véletlenszerűen létrehozott GUID

Example

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

guid('P')

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

I

if

Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket. A paraméterek kiértékelése balról jobbra történik.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter Required Típus Description
< kifejezés> Yes logikai Az ellenőrizni kívánt kifejezés
< értékIgazEsetén> Yes Any Az érték, amelyet visszaadunk, amikor a kifejezés igaz.
< értékHaHamis> Yes Any A visszaadandó érték, ha a kifejezés hamis
Visszaadott érték Típus Description
< megadott visszatérési érték> Any A megadott érték, amely attól függően ad vissza, hogy a kifejezés igaz vagy hamis

Example

Ez a példa "yes" ad vissza, mert a megadott kifejezés igaz értéket ad vissza. Ellenkező esetben a példa "no"ad vissza:

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

indexOf

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

indexOf('<text>', '<searchText>')
Parameter Required Típus Description
< szöveg> Yes String Az a karakterlánc, amely tartalmazza a keresendő részsztringet
< keresési szöveg> Yes String A keresendő alsztring
Visszaadott érték Típus Description
< indexérték> Integer A megadott részsztring kezdőpozíciója vagy indexértéke.

Ha a sztring nem található, adja vissza a -1 számot.

Example

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

indexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

int

Egy egész szám sztringverziójának konvertálása tényleges egész számmá.

int('<value>')
Parameter Required Típus Description
< érték> Yes String Az átalakítandó egész szám sztringverziója. A minimális és maximális értékek megegyeznek az egész szám adattípusának korlátaival.
Visszaadott érték Típus Description
< egész szám eredmény> Integer A megadott sztring egész verziója. A minimális és maximális értékek megegyeznek az egész szám adattípusának korlátaival.

Example

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

int('10')

És ezt az eredményt adja vissza: 10

isFloat

Logikai értéket ad vissza, amely jelzi, hogy egy sztring lebegőpontos szám-e. Ez a függvény alapértelmezés szerint az invariáns kultúrát használja a lebegőpontos formátumhoz. Az egyéb területi beállításokban szereplő lebegőpontos számok azonosításához opcionálisan megadhat egy RFC 4646 területi kódot.

isFloat('<string>', '<locale>'?)
Parameter Required Típus Description
< érték> Yes String A vizsgálandó sztring
< színhely> No String A használni kívánt RFC 4646 területi kód
Visszaadott érték Típus Description
< logikai eredmény> logikai Logikai érték, amely azt jelzi, hogy a sztring lebegőpontos szám-e

1. példa

Ez a példa ellenőrzi, hogy egy sztring lebegőpontos szám-e az invariáns kultúrában:

isFloat('10,000.00')

És ezt az eredményt adja vissza: true

2. példa

Ez a példa azt ellenőrzi, hogy egy sztring lebegőpontos szám-e a német területi beállításban:

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

És ezt az eredményt adja vissza: true

isInt

Egy logikai értéket ad vissza, amely jelzi, hogy egy sztring egész szám-e.

isInt('<string>')
Parameter Required Típus Description
< húr> Yes String A vizsgálandó sztring
Visszaadott érték Típus Description
< logikai eredmény> logikai Logikai érték, amely azt jelzi, hogy a sztring egész szám-e

Example

Ez a példa azt ellenőrzi, hogy egy sztring egész szám-e:

isInt('10')

És ezt az eredményt adja vissza: true

elem

Ha egy tömbön ismétlődő műveletben használják, a művelet aktuális iterációja során adja vissza a tömb aktuális elemét. Az elemek tulajdonságaiból is lekérheti az értékeket.

item()
Visszaadott érték Típus Description
< current-array-item> Any A művelet aktuális iterációjának aktuális eleme a tömbben

Example

Ez a példa lekéri az body elemet a "Send_an_email" művelet aktuális üzenetéből az egyes ciklusok aktuális iterációjában:

item().body

items

Adja vissza az aktuális elemet minden ciklusból egy for-each ciklusban. Használja ezt a függvényt az egyes hurkokhoz.

items('<loopName>')
Parameter Required Típus Description
< loopName> Yes String Az egyes hurkok neve
Visszaadott érték Típus Description
< cikk> Any Az elem az aktuális ciklusból az egyes ciklusokhoz megadott ciklusban

Example

Ez a példa lekéri az aktuális elemet a megadott ciklusból:

items('myForEachLoopName')

iterationIndexes

Az aktuális iteráció indexértékét adja vissza egy Until cikluson belül. Ezt a függvényt a beágyazott Until hurkokban használhatja.

iterationIndexes('<loopName>')
Parameter Required Típus Description
< loopName> Yes String A Until ciklus neve
Visszaadott érték Típus Description
< index> Integer Az aktuális iteráció indexértéke a megadott Ig cikluson belül

Example

Ez a példa létrehoz egy számlálóváltozót, és egyenként növeli a változót egy Until ciklus minden iterációja során, amíg a számláló értéke el nem éri az ötöt. A példa egy változót is létrehoz, amely nyomon követi az egyes iterációk aktuális indexét. A Until ciklus minden iterációja során a példa növeli a számláló értékét, majd hozzárendeli a számláló értékét az aktuális indexértékhez, majd növeli a számláló értékét. A ciklusban ez a példa az aktuális iterációs indexre hivatkozik a iterationIndexes függvény használatával:

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

Visszaadja a JavaScript Object Notation (JSON) típusértéket, objektumot vagy objektumtömböt egy sztringhez vagy XML-hez.

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

Important

A kimenet szerkezetét meghatározó XML-séma nélkül a függvény olyan eredményeket adhat vissza, amelyekben a struktúra a bemenettől függően jelentősen eltér a várt formátumtól.

Ez a viselkedés alkalmatlanná teszi ezt a függvényt olyan helyzetekben, amikor a kimenetnek egy jól meghatározott szerződésnek kell megfelelnie, például kritikus üzleti rendszerekben vagy megoldásokban.

Parameter Required Típus Description
< érték> Yes Sztring vagy XML Az átalakítandó karakterlánc vagy XML
Visszaadott érték Típus Description
< JSON-eredmény> JSON natív típus, objektum vagy tömb A JSON natív típusú értéke, objektuma vagy tömbje a bemeneti sztringből vagy AZ XML-ből.



- Ha olyan XML-fájlt ad át, amelynek egyetlen gyermekeleme van a gyökérelemben, a függvény egyetlen JSON-objektumot ad vissza a gyermekelemhez.

- Ha olyan XML-t ad át, amely több gyermekelemet tartalmaz a gyökérelemben, a függvény egy olyan tömböt ad vissza, amely JSON-objektumokat tartalmaz az adott gyermekelemekhez.

- Ha a sztring null értékű, a függvény egy üres objektumot ad vissza.

1. példa

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

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

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

2. példa

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

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

És ezt az eredményt adja vissza:

{
  "fullName": "Sophia Owen"
}

3. példa

Ez a példa az és json() a függvények használatával konvertálja a xml() gyökérelem egyetlen gyermekelemét tartalmazó XML-t egy JSON-objektummá, amely az adott gyermekelemhez tartozikperson:

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

És ezt az eredményt adja vissza:

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

4. példa

Ez a példa az és json() a függvények használatával konvertálja a xml() gyökérelemben több gyermekelemet tartalmazó XML-t egy olyan tömbreperson, amely JSON-objektumokat tartalmaz az adott gyermekelemekhez:

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

És ezt az eredményt adja vissza:

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

intersection

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

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter Required Típus Description
< gyűjtemény1>, <gyűjtemény2>, ... Yes Tömb vagy objektum, de nem mindkettő Azok a gyűjtemények, amelyekből csak a közös elemeket szeretné
Visszaadott érték Típus Description
< gyakori elemek> Tömb vagy objektum, egyenként Olyan gyűjtemény, amely csak a megadott gyűjtemények gyakori elemeit tartalmazza

Example

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

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

Olyan tömböt ad vissza, amely csak ezeket az elemeket tartalmazza:[1, 2]

csatlakozás

Olyan sztringet ad vissza, amely egy tömb összes elemét tartalmazza, és minden karaktert egy elválasztóválaszt el.

join([<collection>], '<delimiter>')
Parameter Required Típus Description
< gyűjtemény> Yes Array Az összekapcsolni kívánt elemeket tartalmazó tömb
< elválasztó> Yes String Az eredményül kapott sztringben szereplő karakterek között megjelenő elválasztó
Visszaadott érték Típus Description
< karakter1><elválasztó><karakter2><elválasztó>... String A megadott tömb összes eleméből létrehozott eredményül kapott sztring.



Megjegyzés: Az eredmény hossza nem haladhatja meg a 104 857 600 karaktert.

Example

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

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

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

L

last

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

last('<collection>')
last([<collection>])
Parameter Required Típus Description
< gyűjtemény> Yes Sztring vagy tömb Az a gyűjtemény, amelyben az utolsó elem található
Visszaadott érték Típus Description
< utolsó gyűjteményi elem> Sztring vagy tömb, illetve A gyűjtemény utolsó eleme

Example

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

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

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

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

lastIndexOf

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

lastIndexOf('<text>', '<searchText>')
Parameter Required Típus Description
< szöveg> Yes String Az a karakterlánc, amely tartalmazza a keresendő részsztringet
< keresési szöveg> Yes String A keresendő alsztring
Visszaadott érték Típus Description
< záróindex-érték> Integer A megadott részstring utolsó előfordulásának kezdőpozíciója vagy indexértéke.

Ha a sztring vagy az alsztring értéke üres, a következő viselkedés következik be:

  • Ha csak a sztring értéke üres, a függvény ad vissza -1.

  • Ha a sztring és az alsztring értéke is üres, a függvény visszaadja a függvényt 0.

  • Ha csak az alsztring értéke üres, a függvény a sztring hosszát mínusz 1 értéket adja vissza.

Examples

Ez a példa megkeresi a sztringben az alsztring world utolsó előfordulásának kezdő indexértékét hello world hello world. A visszaadott eredmény a következő 18:

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

Ez a példa hiányzik az alsztringparaméterből, és egy értéket 22 ad vissza, mert a bemeneti sztring (23) mínusz 1 értéke nagyobb, mint 0.

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

length

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

length('<collection>')
length([<collection>])
Parameter Required Típus Description
< gyűjtemény> Yes Sztring vagy tömb A megszámlálandó elemeket tartalmazó gyűjtemény
Visszaadott érték Típus Description
< hossz vagy darabszám> Integer A gyűjtemény elemeinek száma

Example

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

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

És adja vissza ezt az eredményt: 4

less

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

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter Required Típus Description
< érték> Yes Egész szám, lebegőpontos vagy karaktersorozat Az első érték, amely ellenőrzi, hogy a második értéknél kisebb-e
< összehasonlítással> Yes Egész szám, lebegőpontos szám vagy karakterlánc Az összehasonlító elem
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha az első érték kisebb, mint a második érték. Hamis értéket ad vissza, ha az első érték egyenlő vagy nagyobb, mint a második érték.

Example

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

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

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

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

lessOrEquals

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

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter Required Típus Description
< érték> Yes Egész szám, lebegőpontos vagy karaktersorozat Az első érték, amely ellenőrzi, hogy a második érték kisebb vagy egyenlő-e
< összehasonlítással> Yes Egész szám, lebegőpontos szám vagy karakterlánc Az összehasonlító elem
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha az első érték kisebb vagy egyenlő a második értéknél. Hamis értéket ad vissza, ha az első érték nagyobb, mint a második érték.

Example

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

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

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

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

listCallbackUrl

Adja vissza az eseményindítót vagy műveletet meghívó visszahívási URL-címet. Ez a függvény csak a HttpWebhook - és ApiConnectionWebhook-összekötőtípusok eseményindítóival és műveleteivel működik, a Manuális, Az ismétlődés, a HTTP és az APIConnection típussal azonban nem.

listCallbackUrl()
Visszaadott érték Típus Description
< visszahívási URL-cím> String Eseményindító vagy művelet visszahívási URL-címe

Example

Ez a példa egy visszahívási MINTA URL-címet mutat be, amelyet a függvény visszaadhat:

"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

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

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter Required Típus Description
< szám1>, <szám2>, ... Yes Egész szám, lebegőpontos vagy mindkettő Az a számkészlet, amelyből a legmagasabb értéket szeretné megkapni
[<szám1>, <szám2>, ...] Yes Tömb – Egész szám, lebegőpontos vagy mindkettő Az a számtömb, amelyből a legmagasabb értéket szeretné megkapni
Visszaadott érték Típus Description
< maximális érték> Egész szám vagy lebegőpontos A megadott tömb vagy számkészlet legnagyobb értéke

Example

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

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

És adja vissza ezt az eredményt: 3

min

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter Required Típus Description
< szám1>, <szám2>, ... Yes Egész szám, lebegőpontos vagy mindkettő Az a számkészlet, amelyből a legalacsonyabb értéket szeretné megadni
[<szám1>, <szám2>, ...] Yes Tömb – Egész szám, lebegőpontos vagy mindkettő Az a számtömb, amelyből a legalacsonyabb értéket szeretné megkapni
Visszaadott érték Típus Description
< minimális érték> Egész szám vagy lebegőpontos A megadott számkészlet vagy megadott tömb legalacsonyabb értéke

Example

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

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

És adja vissza ezt az eredményt: 1

mod

Adja vissza a maradékot két szám osztásából. Az egész szám eredményének lekéréséhez lásd: div().

mod(<dividend>, <divisor>)
Parameter Required Típus Description
< osztalék> Yes Egész szám vagy lebegőpontos Az a szám, amelyet el kell osztani a osztóval-gyel.
< osztó> Yes Egész szám vagy lebegőpontos Az osztalékot megosztó szám, de nem lehet nulla
Visszaadott érték Típus Description
modulo-eredmény< Egész szám vagy lebegőpontos Az első szám és a második szám osztásának fennmaradó része

1. példa

Ez a példa az első számot a második számmal osztja el:

mod(3, 2)

És ezt az eredményt adja vissza: 1

2. példa

Ez a példa azt mutatja, hogy ha az egyik vagy mindkét érték negatív, az eredmény megegyezik az osztalék jelével:

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

A példa a következő eredményeket adja vissza:

  • Első példa: -1
  • Második példa: 1

mul

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

mul(<multiplicand1>, <multiplicand2>)
Parameter Required Típus Description
< szorzód1> Yes Egész szám vagy lebegőpontos A szám, amelyet meg kell szorozni szorzóval szám2
< szorzás2> Yes Egész szám vagy lebegőpontos Az a szám, amely szorzata.
Visszaadott érték Típus Description
< termékeredmény-> Egész szám vagy lebegőpontos Az első szám és a második szám szorzásából származó szorzat

Example

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

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

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

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

multipartBody

Adja vissza egy adott rész törzsét egy művelet kimenetében, amely több részből áll.

multipartBody('<actionName>', <index>)
Parameter Required Típus Description
< akciónév> Yes String A több részből álló kimenetet tartalmazó művelet neve
< index> Yes Integer A kívánt rész indexértéke
Visszaadott érték Típus Description
< test> String A megadott rész törzse

N

not

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

not(<expression>)
Parameter Required Típus Description
< kifejezés> Yes logikai Az ellenőrizni kívánt kifejezés
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha a kifejezés hamis. Hamis értéket ad vissza, ha a kifejezés igaz.

1. példa

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

not(false)
not(true)

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

  • Első példa: A kifejezés hamis, ezért a függvény truead vissza.
  • Második példa: A kifejezés igaz, ezért a függvény falsead vissza.

2. példa

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

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

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

  • Első példa: A kifejezés hamis, ezért a függvény truead vissza.
  • Második példa: A kifejezés igaz, ezért a függvény falsead vissza.

nthIndexOf

Adja vissza azt a kezdőpozíciót vagy indexértéket, amelyben egy sztringben megjelenik egy részsztring n. előfordulása.

nthIndexOf('<text>', '<searchText>', <occurrence>)
Parameter Required Típus Description
< szöveg> Yes String A keresendő alsztringet tartalmazó sztring
< keresési szöveg> Yes String A keresendő alsztring
< előfordulás> Yes Integer Egy szám, amely megadja a keresendő részszúrás n. előfordulását. Ha az előfordulás negatív, kezdjen el keresni a végéről.
Visszaadott érték Típus Description
< indexérték> Integer A megadott részstring n-edikelőfordulásának kezdőpozíciója vagy indexértéke. Ha az alsztring nem található, vagy az alsztring n-nél kevesebb előfordulása létezik, adja vissza -1.

Examples

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

or

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

or(<expression1>, <expression2>, ...)
Parameter Required Típus Description
< kifejezés1>, <kifejezés2>, ... Yes logikai Az ellenőrizni kívánt kifejezések
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha legalább egy kifejezés igaz. Hamis értéket ad vissza, ha az összes kifejezés hamis.

1. példa

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

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

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

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

2. példa

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

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

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

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

outputs

Egy művelet kimeneteit adja vissza futásidőben.

outputs('<actionName>')
Parameter Required Típus Description
< akciónév> Yes String A művelet kívánt kimenetének neve
Visszaadott érték Típus Description
< hozam> String A megadott művelet kimenete

Example

Ez a példa lekéri az X művelet Get userkimenetét:

outputs('Get_user')

És ezt az eredményt adja vissza:

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

parameters

Adja vissza a munkafolyamat-definícióban leírt paraméter értékét.

parameters('<parameterName>')
Parameter Required Típus Description
< paraméternév> Yes String Annak a paraméternek a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
< paraméter-érték> Any A megadott paraméter értéke

Example

Tegyük fel, hogy rendelkezik ezzel a JSON-értékkel:

{
  "fullName": "Sophia Owen"
}

Ez a példa lekéri a megadott paraméter értékét:

parameters('fullName')

És ezt az eredményt adja vissza: "Sophia Owen"

parseDateTime

Az időbélyeget tartalmazó sztring időbélyegét adja vissza.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< színhely> No String A használni kívánt területi beállítás.

Ha nincs megadva, az alapértelmezett területi beállítás a következő en-us.

Ha a területi beállítás nem érvényes érték, hiba jön létre.
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait. Ha a formátum nincs megadva, próbálja meg elemezni a megadott területi beállítással kompatibilis több formátumot. Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< parzált időbélyeg> String Az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK) formátumú elemzési időbélyeg, amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Examples

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('20190521', 'fr-fr', 'yyyyMMdd') // 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

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

rand(<minValue>, <maxValue>)
Parameter Required Típus Description
< minimum érték> Yes Integer A tartományban található legkisebb egész szám
< maxValue> Yes Integer A függvény által visszaadható tartomány legmagasabb egészét követő egész szám
Visszaadott érték Típus Description
< véletlen eredmény> Integer A megadott tartományból visszaadott véletlenszerű egész szám

Example

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

rand(1, 5)

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

tartomány

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

range(<startIndex>, <count>)
Parameter Required Típus Description
< kezdőIndex> Yes Integer Egész szám, amely első elemként indítja el a tömböt
< darabszám> Yes Integer A tömb egész számainak száma. A count paraméterértéknek pozitív egész számnak kell lennie, amely nem haladja meg a 100 000 értéket.



Megjegyzés: Az értékek és startIndex értékek összege nem haladhatja meg a count 2 147 483 647-et.
Visszaadott érték Típus Description
[<tartományeredmény>] Array A megadott indextől kezdődő egész számokat tartalmazó tömb

Example

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

range(1, 4)

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

removeProperty

Távolítsa el a tulajdonságot egy objektumból, és adja vissza a frissített objektumot. Ha az eltávolítani kívánt tulajdonság nem létezik, a függvény az eredeti objektumot adja vissza.

removeProperty(<object>, '<property>')
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelyről el szeretné távolítani a tulajdonságot
< ingatlan> Yes String Az eltávolítani kívánt tulajdonság neve
Visszaadott érték Típus Description
< frissített-objektum> Object A frissített JSON-objektum a megadott tulajdonság nélkül

Gyermektulajdonság meglévő tulajdonságból való eltávolításához használja a következő szintaxist:

removeProperty(<object>['<parent-property>'], '<child-property>')
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelynek a tulajdonságát el szeretné távolítani
< Szülő-tulajdonság> Yes String Az eltávolítani kívánt gyermektulajdonság szülőtulajdonságának neve
< gyermektulajdonság> Yes String Az eltávolítani kívánt gyermektulajdonság neve
Visszaadott érték Típus Description
< frissített-objektum> Object A frissített JSON-objektum, amelynek gyermektulajdonságát eltávolította

1. példa

Ez a példa eltávolítja a middleName tulajdonságot egy JSON-objektumból, amelyet egy sztringből JSON-ra konvertál a JSON() függvény használatával, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

2. példa

Ez a példa eltávolítja a middleName gyermektulajdonságot egy customerName JSON-objektum szülőtulajdonságából, amelyet egy sztringből JSON-ra konvertál a JSON() függvény használatával, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

cserél

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

replace('<text>', '<oldText>', '<newText>')
Parameter Required Típus Description
< szöveg> Yes String Az a karakterlánc, amely tartalmazza a lecserélendő részsztringet
< oldText> Yes String A lecserélendő karakterláncrész
< új szöveg> Yes String A helyettesítő karakterlánc
Visszaadott érték Típus Description
< frissített szöveg> String A részszöveg cseréje után frissített szöveg

Ha a részszöveg nem található, adja vissza az eredeti szöveget.

Example

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

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

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

result

Adja vissza a megadott hatókörű művelet legfelső szintű műveleteinek eredményeit, például egy For_each, Untilvagy Scope egy műveletet. A result() függvény egyetlen paramétert fogad el, amely a hatókör neve, és egy tömböt ad vissza, amely az adott hatókör első szintű műveleteiből származó információkat tartalmazza. Ezek a műveleti objektumok ugyanazokat az attribútumokat tartalmazzák, mint a függvény által actions() visszaadott attribútumok, például a művelet kezdő időpontja, a befejezési idő, az állapot, a bemenetek, a korrelációs azonosítók és a kimenetek.

Note

Ez a függvény csak a hatókörrel rendelkező művelet első szintű műveleteiből ad vissza információt, nem pedig mélyebb beágyazott műveletekből, például kapcsoló- vagy feltételműveletekből.

Ezzel a függvénnyel például lekérheti a sikertelen műveletek eredményeit, így diagnosztizálhatja és kezelheti a kivételeket. További információt a hibák kontextusának és eredményeinek lekérése című témakörben talál.

result('<scopedActionName>')
Parameter Required Típus Description
< scopedActionName> Yes String Annak a hatókörön belüli műveletnek a neve, amelyben a felső szintű műveletek bemeneteit és kimeneteit az adott hatókörön belül szeretné használni
Visszaadott érték Típus Description
< tömb-objektum> Tömbobjektum Egy tömb, amely a megadott hatókörön belüli minden felső szintű műveletből származó bemenetekből és kimenetekből álló tömböket tartalmaz

Example

Ez a példa egy ciklusban lévő For_each HTTP-művelet minden iterációjának bemeneteit és kimeneteit adja vissza a result() műveletben lévő Compose függvény használatával:

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

A visszaadott példatömb így jelenhet meg, ahol a külső outputs objektum a műveleten belüli For_each műveletek minden iterációjának bemeneteit és kimeneteit tartalmazza.

[
   {
      "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

A gyűjtemény elemeinek sorrendjének megfordítása. Ha ezt a függvényt rendezéssel() használja, csökkenő sorrendbe rendezheti a gyűjteményeket.

reverse([<collection>])
Parameter Required Típus Description
< gyűjtemény> Yes Array A megfordítandó gyűjtemény
Visszaadott érték Típus Description
[<frissített gyűjtemény>] Array A fordított gyűjtemény

Example

Ez a példa egész számokat tartalmazó tömböt fordít vissza:

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

És ezt a tömböt adja vissza: [3,2,1,0]

S

setProperty

Állítsa be a JSON-objektum tulajdonságának értékét, és adja vissza a frissített objektumot. Ha a beállítani kívánt tulajdonság nem létezik, a tulajdonság hozzá lesz adva az objektumhoz. Új tulajdonság hozzáadásához használja az addProperty() függvényt.

setProperty(<object>, '<property>', <value>)
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelynek a tulajdonságát be szeretné állítani
< ingatlan> Yes String A beállítandó meglévő vagy új tulajdonság neve
< érték> Yes Any A megadott tulajdonsághoz beállított érték

Ha gyermekobjektumban szeretné beállítani a gyermektulajdonságot, használjon beágyazott setProperty() hívást. Ellenkező esetben a függvény csak a gyermekobjektumot adja vissza kimenetként.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parameter Required Típus Description
< tárgy> Yes Object Az a JSON-objektum, amelynek a tulajdonságát be szeretné állítani
< Szülő-tulajdonság> Yes String A szülőtulajdonság neve a beállítani kívánt gyermektulajdonságtal
< gyermektulajdonság> Yes String A beállítandó gyermektulajdonság neve
< érték> Yes Any A megadott tulajdonsághoz beállított érték
Visszaadott érték Típus Description
< frissített-objektum> Object A frissített JSON-objektum, amelynek a tulajdonságát beállította

1. példa

Ez a surName példa egy JSON-objektum tulajdonságát állítja be, amelyet egy sztringből JSON-ra konvertál a JSON() függvény használatával. A függvény hozzárendeli a megadott értéket a tulajdonsághoz, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

2. példa

Ez a példa egy surName JSON-objektum szülőtulajdonságának gyermektulajdonságát customerName állítja be, amelyet a JSON() függvény használatával sztringből JSON-ra konvertál. A függvény hozzárendeli a megadott értéket a tulajdonsághoz, és visszaadja a frissített objektumot:

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

Az aktuális JSON-objektum:

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

A frissített JSON-objektum:

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

kihagy

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

skip([<collection>], <count>)
Parameter Required Típus Description
< gyűjtemény> Yes Array Az a gyűjtemény, amelynek elemeit el szeretné távolítani
< darabszám> Yes Integer Az elöl eltávolítandó elemek számát jelentő pozitív egész szám.
Visszaadott érték Típus Description
[<frissített gyűjtemény>] Array A megadott elemek eltávolítása után frissített gyűjtemény

Example

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

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

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

szelet

Részszúrást ad vissza a kezdő és záró pozíció vagy érték megadásával. Lásd még : substring().

slice('<text>', <startIndex>, <endIndex>?)
Parameter Required Típus Description
< szöveg> Yes String A keresendő alsztringet tartalmazó sztring
< kezdőIndex> Yes Integer A nullán alapuló kezdő pozíció vagy érték annak a helynek, ahol az alsztringet keresni kell

- Ha a startIndex nagyobb, mint a sztring hossza, egy üres sztringet ad vissza.

- Ha a startIndex negatív, kezdjen el keresni a sztringhossz és a startIndex összegét tartalmazó indexértéken.
< endIndex> No Integer Az alsztring keresésének befejezéséhez használt nullaalapú záró pozíció vagy érték. A záró indexértéken található karakter nem szerepel a keresésben.

- Ha az endIndex nincs megadva, vagy nagyobb, mint a sztring hossza, keressen a sztring végéig.

- Ha az endIndex negatív, akkor a sztringhossz és az endIndex összegét tartalmazó indexértéken végezzen keresést.
Visszaadott érték Típus Description
< szelet-eredmény> String Új sztring, amely a talált részsztringet tartalmazza

Examples

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

rendez

Gyűjtemény elemeinek rendezése. A gyűjtemény objektumokat bármely olyan kulcs segítségével rendezheted, amely egy primitív adattípust tartalmaz, amelyet a Workflow Definition Language támogat, például int, float, string vagy bool.

sort([<collection>], <sortBy>?)
Parameter Required Típus Description
< gyűjtemény> Yes Array A rendezendő elemeket tartalmazó gyűjtemény
< rendezés> No String A gyűjteményobjektumok rendezéséhez használandó kulcs
Visszaadott érték Típus Description
[<frissített gyűjtemény>] Array A rendezett gyűjtemény

1. példa

Ez a példa egész számokat tartalmazó tömböt rendez:

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

És ezt a tömböt adja vissza: [0,1,2,3]

2. példa

Ez a példa egy objektumtömböt rendez kulcs szerint:

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

És ezt a tömböt adja vissza: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

kettéoszt

Olyan tömböt ad vissza, amely az eredeti sztringben megadott elválasztó karakter alapján vesszővel elválasztott részsztringeket tartalmaz.

split('<text>', '<delimiter>')
Parameter Required Típus Description
< szöveg> Yes String A karakterlánc, amely az eredeti láncban megadott elválasztó alapján felosztható részkarakterláncokra
< elválasztó> Yes String Az eredeti sztringben használandó elválasztó karakter
Visszaadott érték Típus Description
[<substring1,substring2><>,...] Array Egy tömb, amely az eredeti sztring részsztringjeit tartalmazza, vesszőkkel elválasztva

1. példa

Ebben a példában egy tömb jön létre, amely a megadott elválasztó karakter alapján a megadott sztringből származó részsztringeket tartalmazza.

split('a_b_c', '_')

Ezt a tömböt adja vissza a következő eredményként: ["a","b","c"]

2. példa

Ez a példa egyetlen elemet tartalmazó tömböt hoz létre, ha a sztringben nincs elválasztójel:

split('a_b_c', ' ')

Ezt a tömböt adja vissza a következő eredményként: ["a_b_c"]

startOfDay

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

startOfDay('<timestamp>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String A megadott időbélyeg, a nap nulla órájától kezdve

Example

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

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

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

startOfHour

Adja vissza az időbélyeghez tartozó óra elejét.

startOfHour('<timestamp>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String A megadott időbélyeg, de az óra nulla percjelétől kezdve

Example

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

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

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

startOfMonth

Adja meg a hónap kezdetét egy időbélyeg alapján.

startOfMonth('<timestamp>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String A megadott időbélyeggel, de a hónap első napján és a nulladik óránál kezdve.

1. példa

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

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

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

2. példa

Ez a példa a hónap kezdetét adja vissza az időbélyeg megadott formátumában:

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

És ezt az eredményt adja vissza: "2018-03-01"

startsWith

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

startsWith('<text>', '<searchText>')
Parameter Required Típus Description
< szöveg> Yes String Az ellenőrizni kívánt karakterlánc
< keresési szöveg> Yes String A keresendő kezdő karakterlánc
Visszaadott érték Típus Description
igaz vagy hamis logikai Igaz értéket ad vissza, ha a kezdő részstring megtalálható. Hamis értéket ad vissza, ha nem található.

1. példa

Ez a példa ellenőrzi, hogy a "hello world" szöveg a "hello" szövegrésszel kezdődik-e.

startsWith('hello world', 'hello')

És ezt az eredményt adja vissza: true

2. példa

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

startsWith('hello world', 'greetings')

És ezt az eredményt adja vissza: false

karakterlánc

Adja vissza egy érték szöveges változatát.

string(<value>)
Parameter Required Típus Description
< érték> Yes Any Az átalakítandó érték. Ha ez az érték null értékű vagy null értékű, akkor az érték üres sztring ("") értékké lesz konvertálva.



Ha például egy nem létező tulajdonsághoz rendel sztringváltozót, amelyet az ? operátorral érhet el, a null érték üres sztringgé lesz konvertálva. A null érték összehasonlítása azonban nem ugyanaz, mint egy üres sztring összehasonlítása.
Visszaadott érték Típus Description
< karakterlánc érték> String A megadott érték sztringverziója. Ha az értékparaméter null értékű, vagy null értékre van kiértékelve, a függvény üres sztring ("") értékként adja vissza.

1. példa

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

string(10)

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

2. példa

Ez a példa létrehoz egy karakterláncot a megadott JSON-objektumhoz, és a fordított perjel (\) karaktert használja a kettős idézőjel (") kikerülésére.

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

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

sub

A második szám kivonásának eredményét adja vissza az első számból.

sub(<minuend>, <subtrahend>)
Parameter Required Típus Description
< kisebbítendő> Yes Egész szám vagy lebegőpontos Az a szám, amelyből kivonja a
< szubtrahend> Yes Egész szám vagy lebegőpontos A szám, amit a -ból kivonunk, a minuend
Visszaadott érték Típus Description
< eredmény> Egész szám vagy lebegőpontos A második szám kivonásának eredménye az első számból

Example

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

sub(10.3, .3)

És ezt az eredményt adja vissza: 10

substring

Egy sztringből karaktereket ad vissza, a megadott pozíciótól vagy indextől kezdve. Az indexértékek a 0 számmal kezdődnek. Lásd még : szelet().

substring('<text>', <startIndex>, <length>)
Parameter Required Típus Description
< szöveg> Yes String Az a sztring, amelynek a karaktereit meg szeretné adni
< kezdőIndex> Yes Integer 0-nál egyenlő vagy annál nagyobb pozitív szám, amelyet kiindulási pozícióként vagy indexértékként szeretne használni
< hossz> No Integer Az alsztringben használni kívánt karakterek pozitív száma

Note

Győződjön meg arról, hogy a startIndex és a hossz paraméter értékeinek hozzáadásából származó összeg kisebb, mint a szöveges paraméterhez megadott sztring hossza. Ellenkező esetben hibaüzenet jelenik meg, ellentétben más nyelvek hasonló függvényeivel, ahol az eredmény a startIndextől a sztring végéig történő összevonás. A hosszparaméter megadása nem kötelező, és ha nincs megadva, a substring() függvény a kezdőindextől a sztring végéig minden karaktert figyelembe vesz.

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

Example

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

substring('hello world', 6, 5)

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

subtractFromTime

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

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeget tartalmazó karakterlánc
< intervallum> Yes Integer A kivonáshoz megadott időegységek száma
< időegység> Yes String A intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< frissített időbélyeg> String Az időbélyegző csökkentve a megadott számú időegységgel

1. példa

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

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

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

2. példa

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

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

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

T

take

Visszaad elemeket egy gyűjtemény elejéről.

take('<collection>', <count>)
take([<collection>], <count>)
Parameter Required Típus Description
< gyűjtemény> Yes Sztring vagy tömb A gyűjtemény, amelynek elemeit szeretné
< darabszám> Yes Integer A kívánt elemek számának megadása elölről pozitív egész számként
Visszaadott érték Típus Description
< részhalmaz> vagy [<részhalmaz>] Sztring vagy tömb, illetve Olyan sztring vagy tömb, amely az eredeti gyűjtemény elejéről vett elemek megadott számát tartalmazza

Example

A példák megadott számú elemet vesznek a gyűjtemények elejéből.

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

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

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

ticks

A 100 nanoszekundumos intervallumú kullancsok számát adja vissza 0001. január 1-től éjfélig (vagy DateTime.Ticks a C#-ban) a megadott időbélyegig. További információ: DateTime.Ticks tulajdonság (System).

ticks('<timestamp>')
Parameter Required Típus Description
< időbélyeg> Yes String Az időbélyeg karakterlánca
Visszaadott érték Típus Description
< kattanás-szám> Integer A megadott időbélyeg óta eltelt időbélyegek száma

toLower

Kicserélje a szöveges adatot kisbetűs formátumra. Ha a sztring egyik karakterének nincs kisbetűs verziója, az a visszaadott sztringben változatlan marad.

toLower('<text>')
Parameter Required Típus Description
< szöveg> Yes String A kisbetűs formátumban visszaadandó szöveg
Visszaadott érték Típus Description
< kisbetűs> String Az eredeti karakterlánc kisbetűs formátumban

Example

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

toLower('Hello World')

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

toUpper

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

toUpper('<text>')
Parameter Required Típus Description
< szöveg> Yes String Visszaadandó karakterlánc nagybetűs formátumban
Visszaadott érték Típus Description
< nagybetűs> String Az eredeti karakterlánc nagybetűs alakban

Example

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

toUpper('Hello World')

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

aktivál

Az eseményindító kimenetét futásidőben adja vissza, vagy más JSON-név- és értékpárokból származó értékeket, amelyeket hozzárendelhet egy kifejezéshez.

  • Az eseményindító bemenetén belül ez a függvény az előző végrehajtás kimenetét adja vissza.

  • Egy eseményindító feltételén belül ez a függvény az aktuális végrehajtás kimenetét adja vissza.

Alapértelmezés szerint a függvény a teljes eseményindító objektumra hivatkozik, de megadhat egy tulajdonságot, amelynek értékét meg szeretné adni. Ez a függvény rövidített verziókkal is rendelkezik, lásd: triggerOutputs() és triggerBody()..

trigger()
Visszaadott érték Típus Description
< Trigger-output> String Eseményindító kimenete futásidőben

triggerBody

Egy eseményindító kimenetét body adja vissza futásidőben. Rövidítés a következőhöz trigger().outputs.body: . Lásd : trigger().

triggerBody()
Visszaadott érték Típus Description
< Trigger-test-kimenet> String Az body eseményindító kimenete

triggerFormDataMultiValues

Olyan tömböt ad vissza, amely egy kulcsnévnek felel meg az eseményindító űrlapadataiban vagy űrlapkódolt kimenetében.

triggerFormDataMultiValues('<key>')
Parameter Required Típus Description
< kulcs> Yes String Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
[<tömb-kulcs-értékekkel>] Array A megadott kulcsnak megfelelő összes értékkel rendelkező tömb

Example

Ez a példa létrehoz egy tömböt az RSS-eseményindító űrlapadataiban vagy űrlapkódolt kimenetében lévő "feedUrl" kulcsértékből:

triggerFormDataMultiValues('feedUrl')

És ezt a tömböt adja vissza példaként: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Egyetlen értékkel rendelkező sztringet ad vissza, amely megfelel az eseményindító űrlapadataiban vagy űrlapkódolt kimenetében szereplő kulcsnévnek. Ha a függvény egynél több egyezést talál, a függvény hibát jelez.

triggerFormDataValue('<key>')
Parameter Required Típus Description
< kulcs> Yes String Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
< kulcs-érték> String A megadott kulcs értéke

Example

Ez a példa létrehoz egy sztringet az RSS-eseményindító űrlapadataiban vagy űrlapkódolt kimenetében található "feedUrl" kulcsértékből:

triggerFormDataValue('feedUrl')

Ezt a sztringet pedig példaeredményként adja vissza: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Adja vissza egy eseményindító kimenetének egy adott részének törzsét, amely több részből áll.

triggerMultipartBody(<index>)
Parameter Required Típus Description
< index> Yes Integer A kívánt rész indexértéke
Visszaadott érték Típus Description
< test> String Az eseményindító többrészes kimenetében megadott rész törzse

triggerOutputs

Egy eseményindító kimenetét adja vissza futásidőben, vagy más JSON-név- és értékpárok értékeit. Rövidítés a következőhöz trigger().outputs: . Lásd : trigger().

triggerOutputs()
Visszaadott érték Típus Description
< Trigger-output> String Eseményindító kimenete futásidőben

vág

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

trim('<text>')
Parameter Required Típus Description
< szöveg> Yes String Az a karakterlánc, amely vezető és záró szóköz eltávolítására szolgál.
Visszaadott érték Típus Description
< frissítettSzöveg> String Az eredeti karakterlánc frissített verziója kezdő és záró szóköz nélkül.

Example

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

trim(' Hello World  ')

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

U

unió

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

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter Required Típus Description
< gyűjtemény1>, <gyűjtemény2>, ... Yes Tömb vagy objektum, de nem mindkettő Azok a gyűjtemények, ahonnan szeretnéd az összes elemet.
Visszaadott érték Típus Description
< frissített Gyűjtemény> Tömb vagy objektum, egyenként Gyűjtemény a megadott gyűjtemények összes elemével – nincs ismétlődés

Example

Ez a példa összegyűjti az összes elemet ezekből a gyűjteményekből:

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

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

uriComponent

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

uriComponent('<value>')
Parameter Required Típus Description
< érték> Yes String Az URI kódolású formátumba konvertálandó karakterlánc
Visszaadott érték Típus Description
< kódolt uri> String Az URI-kódolású sztring escape-karakterekkel

Example

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')
Parameter Required Típus Description
< érték> Yes String A konvertálni kívánt URI-kódolt sztring
Visszaadott érték Típus Description
< bináris kódolt URI> String Az URI-kódolt sztring bináris verziója. A bináris tartalom base64-kódolású, és azt a $content jelzi.

Example

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

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

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

uriComponentToString

Az egységes erőforrás-azonosító (URI) kódolt karakterlánc szöveges változatát adja vissza, amely eredményesen dekódolja az URI-kódolt karakterláncot.

uriComponentToString('<value>')
Parameter Required Típus Description
< érték> Yes String A dekódolni kívánt URI-kódolt karakterlánc
Visszaadott érték Típus Description
< dekódolt uri> String Az URI kódolású sztring dekódolt verziója

Example

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

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

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

uriHost

host Az egységes erőforrás-azonosító (URI) értékét adja vissza.

uriHost('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek host értékét meg szeretné adni
Visszaadott érték Típus Description
< gazdagép-érték> String A host megadott URI értéke

Example

Ez a példa megkeresi az host URI értékét:

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

És ezt az eredményt adja vissza: "www.localhost.com"

uriPath

path Az egységes erőforrás-azonosító (URI) értékét adja vissza.

uriPath('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek path értékét meg szeretné adni
Visszaadott érték Típus Description
< elérési út-érték> String A path megadott URI értéke. Ha path nincs értéke, adja vissza a "/" karaktert.

Example

Ez a példa megkeresi az path URI értékét:

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

És ezt az eredményt adja vissza: "/catalog/shownew.htm"

uriPathAndQuery

path Az egységes erőforrás-azonosító (URI) értékeit adja query vissza.

uriPathAndQuery('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek path értékeit és query értékeit
Visszaadott érték Típus Description
< path-query-value> String A path megadott URI értékei és query értékei. Ha path nem ad meg értéket, adja vissza a "/" karaktert.

Example

Ez a példa megkeresi az path URI értékeit:query

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

És ezt az eredményt adja vissza: "/catalog/shownew.htm?date=today"

uriPort

port Az egységes erőforrás-azonosító (URI) értékét adja vissza.

uriPort('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek port értékét meg szeretné adni
Visszaadott érték Típus Description
< port-érték> Integer A port megadott URI értéke. Ha port nem ad meg értéket, adja vissza a protokoll alapértelmezett portját.

Example

Ez a példa az port URI értékét adja vissza:

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

És ezt az eredményt adja vissza: 8080

uriQuery

query Az egységes erőforrás-azonosító (URI) értékét adja vissza.

uriQuery('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek query értékét meg szeretné adni
Visszaadott érték Típus Description
< lekérdezés-érték> String A query megadott URI értéke

Example

Ez a példa az query URI értékét adja vissza:

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

És ezt az eredményt adja vissza: "?date=today"

uriScheme

scheme Az egységes erőforrás-azonosító (URI) értékét adja vissza.

uriScheme('<uri>')
Parameter Required Típus Description
< Uri> Yes String Az URI, amelynek scheme értékét meg szeretné adni
Visszaadott érték Típus Description
< séma-érték> String A scheme megadott URI értéke

Example

Ez a példa az scheme URI értékét adja vissza:

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

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

utcNow

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

utcNow('<format>')

Opcionálisan megadhat egy másik formátumot is a <formátum> paraméterrel.

Parameter Required Típus Description
< formátum> No String Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel ISO 8601 és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Típus Description
< aktuális időbélyeg> String Az aktuális dátum és idő

Examples

utcNow()                  // Returns 2025-09-25T05:18:31.3384797Z
utcNow('u')               // Returns 2025-09-25 05:18:31Z
utcNow('U')               // Returns Thursday, September 25, 2025 5:18:31 AM
utcNow('d')               // Returns 9/25/2025
utcNow('D')               // Returns Thursday, September 25, 2025
utcNow('t')               // Returns 5:18 AM
utcNow('T')               // Returns 5:18:31 AM
utcNow('y')               // Returns September 2025
utcNow('yyyy')            // Returns 2025
utcNow('ddd, d MMM yyyy') // Returns Thu, 25 Sep 2025

V

variables

Egy megadott változó értékét adja vissza.

variables('<variableName>')
Parameter Required Típus Description
< variableName> Yes String Annak a változónak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Típus Description
< változó-érték> Any A megadott változó értéke

Example

Tegyük fel, hogy a "numItems" változó aktuális értéke 20. Ez a példa lekéri a változó egész értékét:

variables('numItems')

És ezt az eredményt adja vissza: 20

W

munkafolyamat

Adja vissza a munkafolyamat minden részletét a futási idő alatt.

workflow().<property>
Parameter Required Típus Description
< ingatlan> No String Annak a munkafolyamat-tulajdonságnak a neve, amelynek értékét meg szeretné adni



A munkafolyamat-objektumok alapértelmezés szerint a következő tulajdonságokkal rendelkeznek: name, type, id, location, runés tags.



- A run tulajdonság értéke egy JSON-objektum, amely a következő tulajdonságokat tartalmazza: name, typeés id.



– A tags tulajdonság egy JSON-objektum, amely az Azure Logic Appsben a logikai alkalmazáshoz vagy a Power Automate folyamatához társított címkéket és a címkék értékeit tartalmazza. Az Azure-erőforrások címkéivel kapcsolatos további információkért tekintse át az Azure-beli logikai szervezet címkéinek erőforrásait, erőforráscsoportjait és előfizetéseit.



Megjegyzés: A logikai alkalmazások alapértelmezés szerint nem tartalmaznak címkéket, de a Power Automate-folyamatokban vannak címkék flowDisplayName és environmentName címkék.

1. példa

Ez a példa egy munkafolyamat aktuális futtatásának nevét adja vissza:

workflow().run.name

2. példa

Ha a Power Automate-t használja, létrehozhat egy @workflow() kifejezést, amely a tags kimeneti tulajdonságot használja a folyamat vagy flowDisplayName a tulajdonság értékeinek lekéréséhezenvironmentName.

Küldhet például egyéni e-mail-értesítéseket magáról a folyamatról, amely visszakapcsol a folyamathoz. Ezek az értesítések tartalmazhatnak egy HTML-hivatkozást, amely tartalmazza a folyamat megjelenítendő nevét az e-mail címében, és a következő szintaxist követi:

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

X

xml

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

xml('<value>')
Parameter Required Típus Description
< érték> Yes String A sztring, amely tartalmazza az átalakítandó JSON-objektumot

A JSON-objektumnak csak egy gyökértulajdonságúnak kell lennie, amely nem lehet tömb.
Használja a fordított perjelet (\) mint escape karakter a kettős idézőjel (") előtt.
Visszaadott érték Típus Description
< xml-verzió> Object A megadott sztringhez vagy JSON-objektumhoz tartozó kódolt XML

1. példa

Ez a példa xml-fájllá alakítja a sztringet:

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

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

<name>Sophia Owen</name>

2. példa

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

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

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

<name>Sophia Owen</name>

3. példa

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

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

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

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

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

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

4. példa

A xml() függvény egy érvényes XML-t tartalmazó objektumot vagy sztringet vár. A függvény nem fogad el nyers tömböt bemenetként.

Ha az adatok JSON-sztringek, a json() függvény használatával JSON-objektummá alakíthatja a sztringet, mielőtt átadja az eredményt a xml() függvénynek, például:

xml(
  json('{"root":{"array":[
    { "ID": 1, "Name": "James" },
    { "ID": 2, "Name": "John" },
    { "ID": 3, "Name": "Sam" }
  ]}}')
)

Ha JSON-tömbje van, például az alábbi példában, három lehetőség közül választhat.

[
  { "ID": 1, "Name": "James" },
  { "ID": 2, "Name": "John" },
  { "ID": 3, "Name": "Sam" }
]

1. lehetőség: Tárolja a JSON-tömböt egy Compose1 nevű Compose műveletet. Ezután a outputs() függvény használatával JSON-objektumot ad vissza a Compose1-ből.

{
  "root": { "array": @{outputs('Compose1')} }
}

Tárolja a visszaadott JSON-objektumot egy másik , Compose2 nevű műveletben. Ezután a xml() függvényekkel outputs() xml-t hozhat létre a Compose2 JSON-objektumkimenetéből, például:

xml(outputs('Compose2'))

2. lehetőség: Tárolja a JSON-tömböt egy Compose1 nevű Compose műveletet. Ezután a outputs(), concat(), json()és xml() függvényekkel hozzon létre XML-t a JSON-objektum kimenetéből, például:

xml(
  json(
    concat(
      '{"root":{"array":',
      outputs('Compose1'),
      '}}'
    )
  )
)

3. lehetőség: Tárolja a JSON-tömböt egy Compose1 nevű Compose műveletet. Ezután a outputs(), json(), addProperty()és xml() függvényekkel létrehozhat XML-t a JSON-objektum kimenetéből, például:

xml(
  addProperty(
    json('{}'),
    'root',
    addProperty(
      json('{}'),
      'array',
      outputs('Compose1')
    )
  )
)

Az összes példa, amely tartalmazza a JSON-sztring adat példáját és az 1–3. lehetőséget, a következő XML-eredményt adja vissza:

<root>
  <array>
    <ID>1</ID>
    <Name>James</Name>
  </array>
  <array>
    <ID>2</ID>
    <Name>John</Name>
  </array>
  <array>
    <ID>3</ID>
    <Name>Sam</Name>
  </array>
</root>

xpath

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

Note

A Consumption és a Standard logikai alkalmazásokban minden függvénykifejezés a .NET XPath kódtárat használja. Az XPath-kifejezések kompatibilisek az alapul szolgáló .NET-kódtárakkal, és csak a mögöttes .NET-kódtár által támogatott kifejezést támogatják.

xpath('<xml>', '<xpath>')
Parameter Required Típus Description
< xml> Yes Any Az XPath-kifejezésértéknek megfelelő csomópontok vagy értékek keresésére szolgáló XML-sztring
< xpath> Yes Any Az egyező XML-csomópontok vagy -értékek megkeresésére használt XPath-kifejezés
Visszaadott érték Típus Description
< xml-csomópont> XML XML-csomópont, ha csak egyetlen csomópont felel meg a megadott XPath-kifejezésnek
< érték> Any Xml-csomópont értéke, ha csak egyetlen érték felel meg a megadott XPath-kifejezésnek
[<xml-node1>, <xml-node2>, ...] -or- [<érték1>, <érték2>, ...] Array A megadott XPath-kifejezésnek megfelelő XML-csomópontokat vagy értékeket tartalmazó tömb

1. példa

Tegyük fel, hogy rendelkezik ezzel az XML-sztringgel 'items' :

<?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>

Ez a példa az XPath kifejezésben halad át az '/produce/item/name/text()'XML-sztring csomópontjának <name></name> megfelelő 'items' csomópontok megkereséséhez, és egy tömböt ad vissza a csomópontértékekkel:

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

A példa a parameters() függvénnyel is lekéri az XML-sztringet 'items' , és xml() formátumba konvertálja a sztringet az xml() függvény használatával.

Az eredménytömb az egyező <name></name>csomópontok értékeivel van feltöltve:

[ Gala, Honeycrisp ]

2. példa

Az 1. példát követve ez a példa az XPath kifejezésben halad át, '/produce/item/name[1]'és megkeresi az elem gyermekelemét nameitem .

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

Az eredmény a következő: Gala

3. példa

Az 1. példát követve ez a példa az XPath kifejezésben jelenik meg, '/produce/item/name[last()]'és megkeresi az elem gyermekelemének utolsó name elemét item .

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

Az eredmény a következő: Honeycrisp

4. példa

Ebben a példában tegyük fel, hogy az XML-sztring items az attribútumokat is tartalmazza, expired='true' és 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>

Ez a példa az XPath kifejezésben halad át az '//name[@expired]'attribútummal rendelkező name összes expired elem megkereséséhez:

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

Az eredmény a következő: [ Gala, Honeycrisp ]

5. példa

Ebben a példában tegyük fel, hogy az XML-sztring items csak ezt az attribútumot tartalmazza: 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>

Ez a példa az XPath kifejezésben halad át az '//name[@expired = 'true']'attribútummal rendelkező összes name elem megkereséséhez: expired = 'true'

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

Az eredmény a következő: [ Gala ]

6. példa

Ebben a példában tegyük fel, hogy az XML-sztring items az alábbi attribútumokat is tartalmazza:

  • 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>

Ez a példa az XPath kifejezésben halad át, és megkeresi az '//name[@price>35]' összes olyan elemet, nameamely a következőt tartalmazzaprice > 35:

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

Az eredmény a következő: Honeycrisp

7. példa

Ebben a példában tegyük fel, hogy az XML-sztring items ugyanaz, mint az 1. példában:

<?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>

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

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

Az eredmény a következő: 30

8. példa

Ebben a példában tegyük fel, hogy rendelkezik ezzel az XML-sztringgel, amely tartalmazza az XML-dokumentum névterét: xmlns="https://contoso.com"

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

Ezek a kifejezések XPath-kifejezést /*[name()="file"]/*[name()="location"] vagy /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]a csomópontnak megfelelő csomópontok megkeresésére <location></location> használhatók. Az alábbi példák a tervezőben vagy a kifejezésszerkesztőben használt szintaxist mutatják be:

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

A <location></location> csomópontnak megfelelő eredménycsomópont:

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

Important

Ha kódnézetben dolgozik, a fordított perjel (\) használatával meneküljön el a kettős idézőjel (") elől. Ha például JSON-sztringként szerializál egy kifejezést, a feloldó karaktereket kell használnia. Ha azonban a tervezőben vagy a kifejezésszerkesztőben dolgozik, nem kell kikerülnie a kettős idézőjelet, mert a fordított perjel karakter automatikusan hozzáadódik a mögöttes definícióhoz, például:

  • Kódnézet: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

  • Kifejezésszerkesztő: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

9. példa

A 8. példában ez a példa az XPath kifejezést 'string(/*[name()="file"]/*[name()="location"])'használja az érték megkereséséhez a <location></location> csomópontban:

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

Az eredmény a következő: Paris

Következő lépések

Tudnivalók a munkafolyamat-definíció nyelvéről