Útmutató a munkafolyamat-kifejezésfüggvényekhez az Azure Logic Appsben és a Power Automate-ben

A következőkre vonatkozik: Azure Logic Apps (Használat + 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.

Megjegyzés:

Ez a referencialap az Azure Logic Appsre és a Power Automate-ra is vonatkozik, de megjelenik az Azure Logic Apps dokumentációjában. Bár ez a lap kifejezetten a logikaialkalmazás-munkafolyamatokra vonatkozik, ezek a függvények mind a folyamatok, mind a logikai alkalmazások munkafolyamatai esetében működnek. A Power Automate függvényeivel és kifejezéseivel kapcsolatos további információkért tekintse át a Kifejezések használata feltételekben című témakört.

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 Eredmény
Kisbetűs karakterláncot ad vissza. toLower('text>'<)

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

    OK: "@<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.

Sztringfüggvények

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

Sztringfüggvény Task
Darab Sztring vagy gyűjtemény felosztása egyenlő hosszúságú adattömbökre.
Concat Két vagy több sztring egyesítése és az egyesített sztring 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 Globálisan egyedi azonosító (GUID) létrehozása sztringként.
indexOf Egy részszúrás kezdőpozíciójának visszaadása.
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 vissza az alsztring utolsó előfordulásának kezdő pozícióját.
length (hossz) 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.
helyettesít Cserélje le az alsztringet a megadott sztringre, és adja vissza a frissített sztringet.
Szelet 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.
hasít 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 Kisbetűs karakterláncot ad vissza.
toUpper Karakterláncot ad vissza nagybetűs formátumban.
Berendezés Távolítsa el a kezdő és záró szóközt egy sztringből, és adja vissza a frissített sztringet.

Gyűjteményfüggvények

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

Gyűjteményfüggvény Task
Darab Sztring vagy gyűjtemény felosztása egyenlő hosszúságú adattömbökre.
Tartalmaz Ellenőrizze, hogy egy gyűjtemény tartalmaz-e egy adott elemet.
Üres Ellenőrizze, hogy egy gyűjtemény üres-e.
Első Egy gyűjtemény első elemének visszaadása.
Kereszteződés Olyan gyűjteményt ad vissza, amely csak a megadott gyűjtemények közös elemeit tartalmazza.
Cikk 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.
csatlakozás Olyan sztringet ad vissza, amely egy tömb összes elemét tartalmazza, a megadott karakterrel elválasztva.
Utolsó Egy gyűjtemény utolsó elemének visszaadása.
length (hossz) Egy sztring vagy tömb elemeinek számát adja vissza.
Fordított Egy tömb elemeinek sorrendjének megfordítása.
Ugrál Távolítsa el az elemeket a gyűjtemény elejéről, és adja vissza az összes többi elemet.
Rendezés Gyűjtemény elemeinek rendezése.
take Elemeket ad vissza a gyűjtemény elejéről.
Unió Olyan gyűjteményt ad vissza, amely a megadott gyűjtemények összes elemét tartalmazza.

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.

Megjegyzés:

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
És Ellenőrizze, hogy az összes kifejezés igaz-e.
Egyenlő Ellenőrizze, hogy mindkét érték egyenértékű-e.
Nagyobb Ellenőrizze, hogy az első érték nagyobb-e a másodiknál.
greaterOrEquals Ellenőrizze, hogy az első érték nagyobb-e, mint a második érték.
Ha Ellenőrizze, hogy egy kifejezés igaz vagy hamis-e. Az eredmény alapján adjon vissza egy megadott értéket.
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.
Kevesebb 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.
Nem Ellenőrizze, hogy egy kifejezés hamis-e.
vagy Ellenőrizze, hogy legalább egy kifejezés igaz-e.

Konverziós függvények

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.

Megjegyzés:

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
Tömb Tömb visszaadása egyetlen megadott bemenetből. Több bemenet esetén lásd: createArray.
base64 Visszaadja egy sztring base64 kódolású verzióját.
base64ToBinary Egy base64 kódolású sztring bináris verzióját adja vissza.
base64ToString Egy base64 kódolású sztring sztringverzióját adja vissza.
Bináris Adja vissza egy bemeneti érték bináris verzióját.
Bool Adja vissza egy bemeneti érték logikai verzióját.
createArray Több bemenetből származó tömböt ad vissza.
dataUri Adja vissza egy bemeneti érték adat URI-jának értékét.
dataUriToBinary Adja vissza egy adat URI bináris verzióját.
dataUriToString Az adat URI sztringverziójának visszaadása.
tizedes Egy decimális sztring decimális számát adja vissza.
decodeBase64 Egy base64 kódolású sztring sztringverzióját adja vissza.
decodeDataUri Adja vissza egy adat URI bináris verzióját.
decodeUriComponent Visszaad egy sztringet, amely a feloldó 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.
Úszó Egy bemeneti érték lebegőpontos számát adja vissza.
Int Egy sztring egész verziójának visszaadása.
Json Adja vissza egy sztring vagy XML JavaScript Object Notation (JSON) típusértékét vagy objektumát.
Karakterlánc Adja vissza egy bemeneti érték sztringverziójának értékét.
uriComponent Adja vissza egy bemeneti érték URI-kódolású verzióját úgy, hogy az URL-cím szempontjából nem biztonságos karaktereket feloldó karakterekre cseréli.
uriComponentToBinary Adja vissza az URI-kódolt sztring bináris verzióját.
uriComponentToString Adja vissza egy URI-kódolt sztring sztringverzióját.
xml Sztring XML-verzióját adja vissza.

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

Megjegyzés:

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
Hozzáadása 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 A maradékot adja vissza két szám felosztásátó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.
Tartomány Adott egész számból induló egész tömböt ad vissza.
Al 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 Időbélyeg konvertálása az univerzális idő szerint koordinált (UTC) időzónából a cél időzónába.
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 a hónap napját egy időbélyegből.
dayOfWeek A hét napját adja vissza egy időbélyegből.
dayOfYear Az év napját adja vissza egy időbélyegből.
formatDateTime 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 : subtractFromTime.
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 Az óra kezdetét adja vissza egy időbélyeghez.
startOfMonth Adja vissza a hónap kezdetét egy időbélyeghez.
subtractFromTime Vonjon ki több időegységet egy időbélyegből. Lásd még : getPastTime.
Kullancsok ticks Adott időbélyeg tulajdonságértékének visszaadása.
utcNow Az aktuális időbélyeg visszaadása sztringké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.
actionBody Egy művelet kimenetét body adja vissza futásidőben. Lásd még a törzset.
actionOutputs Egy művelet kimenetét adja vissza futásidőben. Lásd a kimeneteket és a műveleteket.
Műveletek 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.
Szervezet Egy művelet kimenetét body adja vissza futásidőben. Lásd még : actionBody.
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.
Cikk 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.
Elemek 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.
Kimenetek Egy művelet kimenetét adja vissza futásidőben.
paraméterek Adja vissza a munkafolyamat-definícióban leírt paraméter értékét.
Eredmény Adja vissza a megadott hatókörű művelet felső szintű műveleteinek bemeneteit és kimeneteit, például For_each: , Untilés Scope.
Ravaszt 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.
Változók Egy megadott változó értékét adja vissza.
Munkafolyamat 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

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, 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>
Paraméter Szükséges Type Description
<Tulajdonság> Nem Sztring 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 Type Description
<action-output> Sztring Az aktuális művelet vagy tulajdonság kimenete

actionBody

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 : törzs() és műveletek().

actionBody('<actionName>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring A művelet kívánt kimenetének body neve
Visszaadott érték Type Description
<művelettörzs kimenete> Sztring A body megadott művelet kimenete

Példa

Ez a példa lekéri a body Twitter-művelet Get userkimenetét:

actionBody('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"
}

actionOutputs

Egy művelet kimenetét adja vissza futásidőben. és rövidített for actions('<actionName>').outputs. Lásd: műveletek(). A actionOutputs() függvény feloldható outputs() a tervezőben, ezért inkább a kimenet()t érdemes használni.actionOutputs() Bár mindkét függvény ugyanúgy működik, outputs() előnyben részesítjük.

actionOutputs('<actionName>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring A művelet kívánt kimenetének neve
Visszaadott érték Type Description
<Kimeneti> Sztring A megadott művelet kimenete

Példa

Ez a példa lekéri a Twitter-művelet Get userkimenetét:

actionOutputs('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"
  }
}

műveletek

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ókért lásd: actionBody(), actionOutputs(), body (). Az aktuális műveletről lásd : művelet().

Tipp.

A actions() függvény a kimenetet sztringként adja vissza. Ha JSON-objektumként egy visszaadott értékkel kell dolgoznia, először konvertálnia kell a sztringértéket. A sztring értékét JSON-objektummá alakíthatja a JSON-elemzési művelet használatával.

Megjegyzés:

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>
Paraméter Szükséges Type Description
<actionName> Igen Sztring Annak a műveletobjektumnak a neve, amelynek kimenetét ki szeretné használni
<Tulajdonság> Nem Sztring 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 Type Description
<action-output> Sztring A megadott művelet vagy tulajdonság kimenete

Példa

Ez a példa lekéri a status tulajdonság értékét a Twitter-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>)
Paraméter Szükséges Type Description
<>summand_1, <summand_2> Igen Egész szám, lebegőpontos vagy vegyes A hozzáadni kívánt számok
Visszaadott érték Type Description
<eredmény-összeg> Egész szám vagy lebegőpontos A megadott számok hozzáadásának eredménye

Példa

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

add(1, 1.5)

És ezt az eredményt adja vissza: 2.5

addDays

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

addDays('<timestamp>', <days>, '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<Nap> Igen Egész A hozzáadandó napok pozitív vagy negatív száma
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Type Description
<frissített időbélyeg> Sztring 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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<hours> Igen Egész A hozzáadni kívánt órák pozitív vagy negatív száma
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

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

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

És ezt az eredményt adja vissza: "2018-03-15T10:00: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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<minutes> Igen Egész A hozzáadandó percek pozitív vagy negatív száma
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

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

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

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

2\. példa

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

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

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

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>)
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelyhez tulajdonságot szeretne hozzáadni
<Tulajdonság> Igen Sztring A hozzáadni kívánt tulajdonság neve
<value> Igen Any A tulajdonság értéke
Visszaadott érték Type Description
<updated-object> 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>)
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelyhez tulajdonságot szeretne hozzáadni
<parent-property> Igen Sztring Annak a szülőtulajdonságnak a neve, amelyhez hozzá szeretné adni a gyermektulajdonságot
<gyermektulajdonság> Igen Sztring A hozzáadni kívánt gyermektulajdonság neve
<value> Igen Any A megadott tulajdonsághoz beállított érték
Visszaadott érték Type Description
<updated-object> 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 surName a firstName 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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<Másodperc> Igen Egész A hozzáadandó másodpercek pozitív vagy negatív száma
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

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

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

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

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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<interval> Igen Egész A hozzáadni kívánt időegységek száma
<timeUnit> Igen Sztring Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

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

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

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

2\. példa

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

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

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

and

Ellenőrizze, hogy 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>, ...)
Paraméter Szükséges Type Description
<kifejezés1>, <kifejezés2>, ... Igen Logikai Az ellenőrizni kívánt kifejezések
Visszaadott érték Type 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.

array

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

array('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring A tömb létrehozására szolgáló sztring
Visszaadott érték Type Description
[<érték>] Tömb Az egyetlen megadott bemenetet tartalmazó tömb

Példa

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

array('hello')

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

h

base64

Visszaadja egy sztring base64 kódolású verzióját.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A bemeneti sztring
Visszaadott érték Type Description
<base64-sztring> Sztring A bemeneti sztring base64 kódolású verziója

Példa

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

base64('hello')

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

base64ToBinary

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

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A konvertálni kívánt base64 kódolású sztring
Visszaadott érték Type Description
<binary-for-base64-string> Sztring A base64 kódolású sztring bináris verziója

Példa

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

base64ToBinary('aGVsbG8=')

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 egy base64 kódolású sztring sztringverzióját, amely hatékonyan dekódolja a base64 sztringet. Használja ezt a függvényt az elavult DecodeBase64() helyett.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A dekódolni kívánt base64-kódolású sztring
Visszaadott érték Type Description
<dekódolt-base64-sztring> Sztring A base64 kódolású sztringek sztringverziója

Példa

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

base64ToString('aGVsbG8=')

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

Bináris

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

binary('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az átalakítandó sztring
Visszaadott érték Type Description
<bináris-for-input-value> Sztring A megadott sztring alap64 kódolású bináris verziója

Példa

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.

törzs

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: actionBody() és actions().

body('<actionName>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring A művelet kívánt kimenetének body neve
Visszaadott érték Type Description
<művelettörzs kimenete> Sztring A body megadott művelet kimenete

Példa

Ez a példa lekéri a body Twitter-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"
}

logikai

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

bool(<value>)
Paraméter Szükséges Type Description
<value> Igen 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 Type Description
true vagy false Logikai A megadott érték logikai verziója.

Kimenetek

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) Egész true
bool(0) Egész false
bool(-1) Egész true
bool('true') Sztring true
bool('false') Sztring false

K

Darab

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

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring vagy tömb A felosztandó gyűjtemény
<length> (hossz) Igen Az egyes adattömbek hossza
Visszaadott érték Type Description
<Gyűjtemény> Tömb 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] ]

coalesce

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

coalesce(<object_1>, <object_2>, ...)
Paraméter Szükséges Type Description
<>object_1, <object_2>, ... Igen Bármelyik, keverheti a típusokat Egy vagy több, null értéket ellenőrizni kívánt elem
Visszaadott érték Type Description
<első nem null értékű elem> 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.

Példa

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

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

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

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

összefűzés

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

concat('<text1>', '<text2>', ...)
Paraméter Szükséges Type Description
<szöveg1>, <szöveg2>, ... Igen Sztring Legalább két egyesítendő sztring
Visszaadott érték Type Description
<text1text2...> Sztring A kombinált bemeneti sztringekből létrehozott sztring.



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

Megjegyzés:

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.

Példa

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

concat('Hello', 'World')

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

contains

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

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

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

  • Sztring az alsztring kereséséhez
  • Egy tömb, amely egy értéket keres
  • Szótár a kulcs megkereséséhez
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring, tömb vagy szótár Az ellenőrizni kívánt gyűjtemény
<value> Igen Sztring, tömb vagy szótár A keresendő elem
Visszaadott érték Type 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 a "világegyetem" részláncában, és hamis értéket ad vissza:

contains('hello world', 'universe')

convertFromUtc

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

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<destinationTimeZone> Igen Sztring 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.
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Type Description
<konvertált időbélyeg> Sztring 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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<sourceTimeZone> Igen Sztring 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.
<destinationTimeZone> Igen Sztring 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.
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

Ez a példa 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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<sourceTimeZone> Igen Sztring 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.
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Type Description
<konvertált időbélyeg> Sztring 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. Egyetlen bemeneti tömb esetén lásd a tömb()-et.

createArray('<object1>', '<object2>', ...)
Paraméter Szükséges Type Description
<object1>, <object2>, ... Igen Bármely, de nem vegyes Legalább két elem a tömb létrehozásához
Visszaadott érték Type Description
[<object1>, <object2>, ...] Tömb Az összes bemeneti elemből létrehozott tömb

Példa

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

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

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

D

dataUri

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

dataUri('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az átalakítandó sztring
Visszaadott érték Type Description
<data-uri> Sztring A bemeneti sztring adat-URI-ja

Példa

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az átalakítandó adat URI-ja
Visszaadott érték Type Description
<binary-for-data-uri> Sztring Az adat URI bináris verziója

Példa

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

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Adja vissza az egységes adaterőforrás-azonosító (URI) sztringverzióját.

dataUriToString('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az átalakítandó adat URI-ja
Visszaadott érték Type Description
<sztring for-data-uri> Sztring Az adat URI sztringverziója

Példa

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

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

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

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>')
Paraméter Szükséges Type Description
<startDate> Igen Sztring Időbélyeget tartalmazó sztring
<endDate> Igen Sztring Időbélyeget tartalmazó sztring
Visszaadott érték Type Description
<időbélyeg> Sztring 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.

Példa

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>')
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
Visszaadott érték Type Description
<hónap napja> Egész A hónap napja a megadott időbélyegből

Példa

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

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

És ezt az eredményt adja vissza: 15

dayOfWeek

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

dayOfWeek('<timestamp>')
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
Visszaadott érték Type Description
<hét napja> Egész A hét napja a megadott időbélyegből, ahol a vasárnap 0, a hétfő 1, és így tovább

Példa

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

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

És ezt az eredményt adja vissza: 4

dayOfYear

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

dayOfYear('<timestamp>')
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
Visszaadott érték Type Description
<év napja> Egész Az év napja a megadott időbélyegből

Példa

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

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

És ezt az eredményt adja vissza: 74

tizedes

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.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A sztring decimális száma
Visszaadott érték Type Description
<tizedes> Tizedes tört 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 a dataUriToBinary() használatát ahelyett, hogy decodeDataUri(). Bár mindkét függvény ugyanúgy működik, dataUriToBinary() előnyben részesítjük.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A dekódolni kívánt adat URI-sztringje
Visszaadott érték Type Description
<binary-for-data-uri> Sztring Adat URI-sztring bináris verziója

Példa

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

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

És ezt az eredményt adja vissza:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Visszaad egy sztringet, amely a feloldó karaktereket dekódolt verziókra cseréli.

decodeUriComponent('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring A kódolandó feloldó karaktereket tartalmazó sztring
Visszaadott érték Type Description
<dekódolt-uri> Sztring A frissített sztring a dekódolt escape karakterekkel

Példa

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 lekéréséhez lásd a mod()-t.

div(<dividend>, <divisor>)
Paraméter Szükséges Type Description
<Osztalék> Igen Egész szám vagy lebegőpontos Az osztó által elosztandó szám
<Osztó> Igen Egész szám vagy lebegőpontos Az osztalékot megosztó szám, de nem lehet nulla
Visszaadott érték Type Description
<hányados-eredmény> Egész szám vagy lebegőpontos Az első szám és a második szám osztásának eredménye. 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 sztring egységes erőforrás-azonosító (URI) kódolt verzióját adja vissza az URL-cím szempontjából nem biztonságos karakterek feloldó karakterekre való lecserélésével. Fontolja meg az uriComponent() használatát ahelyett, hogy encodeUriComponent(). Bár mindkét függvény ugyanúgy működik, uriComponent() előnyben részesítjük.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az URI kódolású formátumba konvertálandó sztring
Visszaadott érték Type Description
<kódolt-uri> Sztring Az URI-kódolású sztring escape karakterekkel

Példa

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

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

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

üres

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

empty('<collection>')
empty([<collection>])
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring, tömb vagy objektum Az ellenőrizni kívánt gyűjtemény
Visszaadott érték Type Description
igaz vagy hamis Logikai Igaz értéket ad vissza, ha a gyűjtemény üres. Hamis értéket ad vissza, ha nem üres.

Példa

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

empty('')
empty('abc')

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

  • Első példa: Egy üres sztringet ad át, így a függvény visszaadja a függvényt 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>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az ellenőrizni kívánt sztring
<searchText> Igen Sztring A befejezési részstring a kereséshez
Visszaadott érték Type 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 "világ" 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" sztring a "világegyetem" sztringgel végződik-e:

endsWith('hello world', 'universe')

És ezt az eredményt adja vissza: false

egyenlő

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

equals('<object1>', '<object2>')
Paraméter Szükséges Type Description
<object1>, <object2> Igen Különböző Az összehasonlítandó értékek, kifejezések vagy objektumok
Visszaadott érték Type 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ű.

Példa

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

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

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

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

F

első

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

first('<collection>')
first([<collection>])
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring vagy tömb Az a gyűjtemény, ahol az első elem megtalálható
Visszaadott érték Type Description
<első gyűjteményelem> Any A gyűjtemény első eleme

Példa

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

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

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

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

float

Lebegőpontos szám sztringverziójának konvertálása tényleges lebegőpontos számmá. 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>'?)
Paraméter Szükséges Type Description
<value> Igen Sztring 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.
<Locale> Nem Sztring 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 Type Description
<lebegőpontos érték> Lebegőpontos értékek 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

formatDateTime

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

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.
<Locale> Nem Sztring 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 Type Description
<újraformált időbélyeg> Sztring A frissített időbélyeg a megadott formátumban és területi beállításban, ha meg van adva.

Példák

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>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring Az a művelet, amelynek kimenete rendelkezik a kívánt kulcsértékel
<key> Igen Sztring Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
[<tömb-kulcs-értékekkel>] Tömb A megadott kulcsnak megfelelő összes értékkel rendelkező tömb

Példa

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>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring Az a művelet, amelynek kimenete rendelkezik a kívánt kulcsértékel
<key> Igen Sztring Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
<kulcs-érték> Sztring A megadott kulcs értéke

Példa

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>?)
Paraméter Szükséges Type Description
<Szám> Igen Egész vagy dupla A formázni kívánt érték.
<format> Igen Sztring 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.
<Locale> Nem Sztring 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 Type Description
<formázott szám> Sztring A megadott szám sztringként a megadott formátumban. Ezt a visszatérési értéket egy vagy floattöbb értékre int 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,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,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>?)
Paraméter Szükséges Type Description
<interval> Igen Egész A hozzáadni kívánt időegységek száma
<timeUnit> Igen Sztring Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Nem Sztring Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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 Type Description
<frissített időbélyeg> Sztring Az aktuális időbélyeg és a megadott számú időegység

1\. példa

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

getFutureTime(5, 'Day')

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

2\. példa

Tegyük fel, hogy az aktuális időbé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>?)
Paraméter Szükséges Type Description
<interval> Igen Egész A kivonáshoz megadott időegységek száma
<timeUnit> Igen Sztring Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Nem Sztring Egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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 Type Description
<frissített időbélyeg> Sztring Az aktuális időbélyeg mínusz a megadott számú időegység

1\. példa

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

getPastTime(5, 'Day')

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

2\. példa

Tegyük fel, hogy az aktuális időbélyeg "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"

Nagyobb

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

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Paraméter Szükséges Type Description
<value> Igen Egész szám, lebegőpontos vagy sztring Az első érték, amely ellenőrzi, hogy nagyobb-e a második értéknél
<compareTo> Igen Egész szám, lebegőpontos vagy sztring Az összehasonlító érték
Visszaadott érték Type 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.

Példa

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

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

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

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

greaterOrEquals

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

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Paraméter Szükséges Type Description
<value> Igen Egész szám, lebegőpontos vagy sztring Az első érték, amely ellenőrzi, hogy nagyobb vagy egyenlő-e a második értéknél
<compareTo> Igen Egész szám, lebegőpontos vagy sztring Az összehasonlító érték
Visszaadott érték Type 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.

Példa

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

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

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

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

guid

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

guid()

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

guid('<format>')
Paraméter Szükséges Type Description
<format> Nem Sztring A visszaadott GUID egyetlen formátumkijelölője . 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 Type Description
<GUID-érték> Sztring Véletlenszerűen létrehozott GUID

Példa

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

guid('P')

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

d

Ha

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>)
Paraméter Szükséges Type Description
<Kifejezés> Igen Logikai Az ellenőrizni kívánt kifejezés
<valueIfTrue> Igen Any A kifejezés igaz értékének visszaadása
<valueIfFalse> Igen Any A visszaadandó érték, ha a kifejezés hamis
Visszaadott érték Type 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

Példa

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

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

indexOf

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

indexOf('<text>', '<searchText>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az a sztring, amely a keresendő részsztringgel rendelkezik
<searchText> Igen Sztring A keresendő alsztring
Visszaadott érték Type Description
<index-érték> Egész A megadott részsztring kezdőpozíciója vagy indexértéke.

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

Példa

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

indexOf('hello world', 'world')

És ezt az eredményt adja vissza: 6

egész

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

int('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring 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 Type Description
<egész szám eredménye> Egész 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.

Példa

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

int('10')

És ezt az eredményt adja vissza: 10

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>'?)
Paraméter Szükséges Type Description
<value> Igen Sztring A vizsgálandó sztring
<Locale> Nem Sztring A használni kívánt RFC 4646 területi kód
Visszaadott érték Type 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>')
Paraméter Szükséges Type Description
<Karakterlánc> Igen Sztring A vizsgálandó sztring
Visszaadott érték Type Description
<logikai eredmény> Logikai Logikai érték, amely azt jelzi, hogy a sztring egész szám-e

Példa

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

Cikk

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 Type Description
<current-array-item> Any A művelet aktuális iterációjának aktuális eleme a tömbben

Példa

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

elem

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>')
Paraméter Szükséges Type Description
<loopName> Igen Sztring Az egyes hurkok neve
Visszaadott érték Type Description
<Cikk> Any Az elem az aktuális ciklusból az egyes ciklusokhoz megadott ciklusban

Példa

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>')
Paraméter Szükséges Type Description
<loopName> Igen Sztring A Until ciklus neve
Visszaadott érték Type Description
<Index> Egész Az aktuális iteráció indexértéke a megadott Ig cikluson belül

Példa

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

Fontos

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.

Paraméter Szükséges Type Description
<value> Igen Sztring vagy XML Az átalakítandó sztring vagy XML
Visszaadott érték Type 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 xml() a függvények használatával konvertálja a json() 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 xml() a függvények használatával konvertálja a json() 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"
         }
      ]
   }
}

Kereszteződés

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

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Paraméter Szükséges Type Description
<gyűjtemény1>, <gyűjtemény2>, ... Igen Tömb vagy objektum, de nem mindkettő Azok a gyűjtemények, amelyekből csak a gyakori elemeket szeretné használni
Visszaadott érték Type Description
<gyakori elemek> Tömb vagy objektum, illetve Olyan gyűjtemény, amely csak a megadott gyűjtemények gyakori elemeit tartalmazza

Példa

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

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

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

Csatlakozás

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

join([<collection>], '<delimiter>')
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Tömb Az összekapcsolni kívánt elemeket tartalmazó tömb
<Határoló> Igen Sztring Az eredményül kapott sztringben szereplő karakterek között megjelenő elválasztó
Visszaadott érték Type Description
<char1><elválasztó><karakter2><elválasztó...> Sztring 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.

Példa

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

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

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

L

utolsó

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

last('<collection>')
last([<collection>])
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring vagy tömb Az a gyűjtemény, amelyben az utolsó elem található
Visszaadott érték Type Description
<last-collection-item> Sztring vagy tömb, illetve A gyűjtemény utolsó eleme

Példa

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

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

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

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

lastIndexOf

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

lastIndexOf('<text>', '<searchText>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az a sztring, amely a keresendő részsztringgel rendelkezik
<searchText> Igen Sztring A keresendő alsztring
Visszaadott érték Type Description
<end-index-value> Egész 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.

Példák

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 (hossz)

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

length('<collection>')
length([<collection>])
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring vagy tömb A megszámlálandó elemeket tartalmazó gyűjtemény
Visszaadott érték Type Description
<hossz vagy darabszám> Egész A gyűjtemény elemeinek száma

Példa

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

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

És adja vissza ezt az eredményt: 4

Kevesebb

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

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Paraméter Szükséges Type Description
<value> Igen Egész szám, lebegőpontos vagy sztring Az első érték, amely ellenőrzi, hogy a második értéknél kisebb-e
<compareTo> Igen Egész szám, lebegőpontos vagy sztring Az összehasonlító elem
Visszaadott érték Type 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.

Példa

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

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

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

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

lessOrEquals

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

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Paraméter Szükséges Type Description
<value> Igen Egész szám, lebegőpontos vagy sztring Az első érték, amely ellenőrzi, hogy a második érték kisebb vagy egyenlő-e
<compareTo> Igen Egész szám, lebegőpontos vagy sztring Az összehasonlító elem
Visszaadott érték Type 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.

Példa

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

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

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

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

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 api Csatlakozás ionWebhook ö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 API Csatlakozás ion típusokkal azonban nem.

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

Példa

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

H

max.

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

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Paraméter Szükséges Type Description
<szám1>, <szám2>, ... Igen Egész szám, lebegőpontos vagy mindkettő Az a számkészlet, amelyből a legmagasabb értéket szeretné megkapni
[<szám1>, <szám2>, ...] Igen Tömb – Egész szám, lebegőpontos vagy mindkettő Az a számtömb, amelyből a legmagasabb értéket szeretné megkapni
Visszaadott érték Type Description
<maximális érték> Egész szám vagy lebegőpontos A megadott tömb vagy számkészlet legnagyobb értéke

Példa

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

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

És adja vissza ezt az eredményt: 3

min.

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Paraméter Szükséges Type Description
<szám1>, <szám2>, ... Igen Egész szám, lebegőpontos vagy mindkettő Az a számkészlet, amelyből a legalacsonyabb értéket szeretné megadni
[<szám1>, <szám2>, ...] Igen Tömb – Egész szám, lebegőpontos vagy mindkettő Az a számtömb, amelyből a legalacsonyabb értéket szeretné megkapni
Visszaadott érték Type Description
<minimális érték> Egész szám vagy lebegőpontos A megadott számkészlet vagy megadott tömb legalacsonyabb értéke

Példa

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

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

És adja vissza ezt az eredményt: 1

Mod

A maradékot adja vissza két szám felosztásától. Az egész szám eredményének lekéréséhez lásd : div().

mod(<dividend>, <divisor>)
Paraméter Szükséges Type Description
<Osztalék> Igen Egész szám vagy lebegőpontos Az osztó által elosztandó szám
<Osztó> Igen Egész szám vagy lebegőpontos Az osztalékot megosztó szám, de nem lehet nulla
Visszaadott érték Type 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>)
Paraméter Szükséges Type Description
<multiplicand1> Igen Egész szám vagy lebegőpontos A szorzattal szorzandó szám2
<multiplicand2> Igen Egész szám vagy lebegőpontos A többszörös szorzást és 1-et tartalmazó szám
Visszaadott érték Type Description
<termék eredménye> Egész szám vagy lebegőpontos Az első szám és a második szám szorzásából származó szorzat

Példa

Ezek a példák az első számot a második számmal többszörösre iktatjá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>)
Paraméter Szükséges Type Description
<actionName> Igen Sztring A több részből álló kimenetet tartalmazó művelet neve
<Index> Igen Egész A kívánt rész indexértéke
Visszaadott érték Type Description
<Szervezet> Sztring A megadott rész törzse

N

Nem

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

not(<expression>)
Paraméter Szükséges Type Description
<Kifejezés> Igen Logikai Az ellenőrizni kívánt kifejezés
Visszaadott érték Type 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 visszaadja a függvényt true.
  • Második példa: A kifejezés igaz, ezért a függvény visszaadja a függvényt false.

2\. példa

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

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

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

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

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>)
Paraméter Szükséges Type Description
<text> Igen Sztring A keresendő alsztringet tartalmazó sztring
<searchText> Igen Sztring A keresendő alsztring
<Előfordulása> Igen Egész 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 Type Description
<index-érték> Egész 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.

Példák

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

vagy

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>, ...)
Paraméter Szükséges Type Description
<kifejezés1>, <kifejezés2>, ... Igen Logikai Az ellenőrizni kívánt kifejezések
Visszaadott érték Type 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 visszaadja a függvényt true.
  • Második példa: Mindkét kifejezés hamis, ezért a függvény visszaadja a függvényt false.

2\. példa

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

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

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

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

Kimenetek

Egy művelet kimeneteit adja vissza futásidőben. Használja ezt a függvényt ahelyett, actionOutputs()hogy outputs() azt a tervezőben oldja fel. Bár mindkét függvény ugyanúgy működik, outputs() előnyben részesítjük.

outputs('<actionName>')
Paraméter Szükséges Type Description
<actionName> Igen Sztring A művelet kívánt kimenetének neve
Visszaadott érték Type Description
<Kimeneti> Sztring A megadott művelet kimenete

Példa

Ez a példa lekéri a Twitter-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>')
Paraméter Szükséges Type Description
<parameterName> Igen Sztring Annak a paraméternek a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
<paraméter-érték> Any A megadott paraméter értéke

Példa

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>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<Locale> Nem Sztring 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.
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait. 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 Type Description
<parsed-timestamp> Sztring 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.

Példák

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

R

Rand

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

rand(<minValue>, <maxValue>)
Paraméter Szükséges Type Description
<minValue> Igen Egész A tartomány legalacsonyabb egésze
<maxValue> Igen Egész A függvény által visszaadható tartomány legmagasabb egészét követő egész szám
Visszaadott érték Type Description
<véletlenszerű eredmény> Egész A megadott tartományból visszaadott véletlenszerű egész szám

Példa

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

rand(1, 5)

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

Tartomány

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

range(<startIndex>, <count>)
Paraméter Szükséges Type Description
<startIndex> Igen Egész Egész szám, amely első elemként indítja el a tömböt
<count> Igen Egész A tömb egész számainak száma. 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 count értékek összege nem haladhatja meg a startIndex 2 147 483 647-et.
Visszaadott érték Type Description
[<tartomány-eredmény>] Tömb A megadott indextől kezdődő egész számokat tartalmazó tömb

Példa

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

range(1, 4)

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

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>')
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelyről el szeretné távolítani a tulajdonságot
<Tulajdonság> Igen Sztring Az eltávolítani kívánt tulajdonság neve
Visszaadott érték Type Description
<updated-object> 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>')
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelynek a tulajdonságát el szeretné távolítani
<parent-property> Igen Sztring Az eltávolítani kívánt gyermektulajdonság szülőtulajdonságának neve
<gyermektulajdonság> Igen Sztring Az eltávolítani kívánt gyermektulajdonság neve
Visszaadott érték Type Description
<updated-object> 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"
   }
}

helyettesít

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

replace('<text>', '<oldText>', '<newText>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az a sztring, amely a lecserélendő részsztringgel rendelkezik
<oldText> Igen Sztring A lecserélendő részszúrás
<newText> Igen Sztring A helyettesítő sztring
Visszaadott érték Type Description
<frissített szöveg> Sztring Az alsztring cseréje után frissített sztring

Ha az alsztring nem található, adja vissza az eredeti sztringet.

Példa

Ez a példa megkeresi a "régi" részsztringet a "régi sztringben" és a "régi" helyett az "új" szöveget:

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

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

eredmény

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.

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<scopedActionName> Igen Sztring 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 Type 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

Példa

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

Fordított

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>])
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Tömb A megfordítandó gyűjtemény
Visszaadott érték Type Description
[<frissített gyűjtemény>] Tömb A fordított gyűjtemény

Példa

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]

V

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>)
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelynek a tulajdonságát be szeretné állítani
<Tulajdonság> Igen Sztring A beállítandó meglévő vagy új tulajdonság neve
<value> Igen 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>))
Paraméter Szükséges Type Description
<Objektum> Igen Object Az a JSON-objektum, amelynek a tulajdonságát be szeretné állítani
<parent-property> Igen Sztring A szülőtulajdonság neve a beállítani kívánt gyermektulajdonságtal
<gyermektulajdonság> Igen Sztring A beállítandó gyermektulajdonság neve
<value> Igen Any A megadott tulajdonsághoz beállított érték
Visszaadott érték Type Description
<updated-object> 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ás

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

skip([<collection>], <count>)
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Tömb Az a gyűjtemény, amelynek elemeit el szeretné távolítani
<count> Igen Egész Pozitív egész szám az elöl eltávolítandó elemek számához
Visszaadott érték Type Description
[<frissített gyűjtemény>] Tömb A megadott elemek eltávolítása után frissített gyűjtemény

Példa

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

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

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

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>?)
Paraméter Szükséges Type Description
<text> Igen Sztring A keresendő alsztringet tartalmazó sztring
<startIndex> Igen Egész 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> Nem Egész 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 Type Description
<szelet-eredmény> Sztring Új sztring, amely a talált részsztringet tartalmazza

Példák

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és

Gyűjtemény elemeinek rendezése. A gyűjteményobjektumokat bármilyen egyszerű típust tartalmazó kulccsal rendezheti.

sort([<collection>], <sortBy>?)
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Tömb A rendezendő elemeket tartalmazó gyűjtemény
<rendezés> Nem Sztring A gyűjteményobjektumok rendezéséhez használandó kulcs
Visszaadott érték Type Description
[<frissített gyűjtemény>] Tömb 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" }')]

hasít

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>')
Paraméter Szükséges Type Description
<text> Igen Sztring A sztring, amely az eredeti sztringben megadott elválasztó alapján elválasztható részsztringekre
<Határoló> Igen Sztring Az eredeti sztring elválasztó karaktere
Visszaadott érték Type Description
[<substring1,substring2><>,...] Tömb Az eredeti sztring részsztringeket tartalmazó tömbje, vesszővel elválasztva

1\. példa

Ez a példa egy tömböt hoz létre, amely a megadott sztringből származó részsztringeket tartalmazza a megadott karakter alapján elválasztóként:

split('a_b_c', '_')

Ezt a tömböt adja eredményül: ["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 eredményül: ["a_b_c"]

startOfDay

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

startOfDay('<timestamp>', '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Type Description
<frissített időbélyeg> Sztring A megadott időbélyeg, de a napi nulla órajeltől kezdve

Példa

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

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

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

startOfHour

Az óra kezdetét adja vissza egy időbélyeghez.

startOfHour('<timestamp>', '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

Példa

Ez a példa az óra kezdetét találja az időbélyeghez:

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

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

startOfMonth

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

startOfMonth('<timestamp>', '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

Ha a formátum nem érvényes érték, hibaüzenet jelenik meg.
Visszaadott érték Type Description
<frissített időbélyeg> Sztring A megadott időbélyeg, de a hónap első napján kezdődik a nullaórás jelöléssel

1\. példa

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

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

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

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>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az ellenőrizni kívánt sztring
<searchText> Igen Sztring A keresendő kezdő sztring
Visszaadott érték Type 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" sztring a "hello" sztringgel 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

sztring

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

string(<value>)
Paraméter Szükséges Type Description
<value> Igen 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 Type Description
<sztring-érték> Sztring 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 sztringet a megadott JSON-objektumhoz, és a fordított perjel (\) karaktert használja a kettős idézőjel (").

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

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

Al

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

sub(<minuend>, <subtrahend>)
Paraméter Szükséges Type Description
<Kisebbítendő> Igen Egész szám vagy lebegőpontos Az a szám, amelyből kivonja a részösszeget
<Kivonandó> Igen Egész szám vagy lebegőpontos A minuendből kivonandó szám
Visszaadott érték Type 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

Példa

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

sub(10.3, .3)

És ezt az eredményt adja vissza: 10

Substring

A megadott pozícióból vagy indexből származó karaktereket ad vissza egy sztringből. Az indexértékek a 0 számmal kezdődnek. Lásd még : szelet().

substring('<text>', <startIndex>, <length>)
Paraméter Szükséges Type Description
<text> Igen Sztring Az a sztring, amelynek a karaktereit meg szeretné adni
<startIndex> Igen Egész 0-nál egyenlő vagy annál nagyobb pozitív szám, amelyet kiindulási pozícióként vagy indexértékként szeretne használni
<length> (hossz) Nem Egész Az alsztringben használni kívánt karakterek pozitív száma

Megjegyzés:

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őla sztring végéig minden karaktert figyelembe vesz.

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

Példa

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

substring('hello world', 6, 5)

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

subtractFromTime

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

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeget tartalmazó sztring
<interval> Igen Egész A kivonáshoz megadott időegységek száma
<timeUnit> Igen Sztring Az intervallummal használandó időegység: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

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

Elvétel

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

take('<collection>', <count>)
take([<collection>], <count>)
Paraméter Szükséges Type Description
<Gyűjtemény> Igen Sztring vagy tömb A gyűjtemény, amelynek elemeit szeretné
<count> Igen Egész Pozitív egész szám az elölről kívánt elemek számához
Visszaadott érték Type Description
<alkészlet 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

Példa

Ezek a példák a megadott számú elemet kapják meg a gyűjtemények elejéről:

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

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

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

Kullancsok

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>')
Paraméter Szükséges Type Description
<Időbélyeg> Igen Sztring Az időbélyeg sztringje
Visszaadott érték Type Description
<ticks-number> Egész A megadott időbélyeg óta eltelt időbélyegek száma

toLower

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

toLower('<text>')
Paraméter Szükséges Type Description
<text> Igen Sztring A kisbetűs formátumban visszaadandó sztring
Visszaadott érték Type Description
<kisbetűs szöveg> Sztring Az eredeti sztring kisbetűs formátumban

Példa

Ez a példa kisbetűssé alakítja a sztringet:

toLower('Hello World')

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

toUpper

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

toUpper('<text>')
Paraméter Szükséges Type Description
<text> Igen Sztring A nagybetűs formátumban visszaadandó sztring
Visszaadott érték Type Description
<nagybetűs szöveg> Sztring Az eredeti sztring nagybetűs formátumban

Példa

Ez a példa a sztringet nagybetűssé alakítja:

toUpper('Hello World')

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

Ravaszt

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 Type Description
<trigger-output> Sztring 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 Type Description
<trigger-body-output> Sztring 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>')
Paraméter Szükséges Type Description
<key> Igen Sztring Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
[<tömb-kulcs-értékekkel>] Tömb A megadott kulcsnak megfelelő összes értékkel rendelkező tömb

Példa

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>')
Paraméter Szükséges Type Description
<key> Igen Sztring Annak a kulcsnak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
<kulcs-érték> Sztring A megadott kulcs értéke

Példa

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>)
Paraméter Szükséges Type Description
<Index> Igen Egész A kívánt rész indexértéke
Visszaadott érték Type Description
<Szervezet> Sztring 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 Type Description
<trigger-output> Sztring Eseményindító kimenete futásidőben

Berendezés

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

trim('<text>')
Paraméter Szükséges Type Description
<text> Igen Sztring Az a sztring, amely az eltávolítandó kezdő és záró szóközt tartalmazza
Visszaadott érték Type Description
<frissített szöveg> Sztring Az eredeti sztring frissített verziója kezdő vagy záró szóköz nélkül

Példa

Ez a példa eltávolítja a kezdő és záró szóközt a ""Helló világ!" alkalmazás": 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 összes elemét tartalmazza. Az eredményben való megjelenéshez egy elem jelenhet meg a függvénynek átadott gyűjteményekben. Ha egy vagy több elem neve megegyezik, az eredményben az utolsó ilyen nevű elem jelenik meg.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Paraméter Szükséges Type Description
<gyűjtemény1>, <gyűjtemény2>, ... Igen Tömb vagy objektum, de nem mindkettő Azok a gyűjtemények, amelyekből az összes elemet meg szeretné kapni
Visszaadott érték Type Description
<updatedCollection> Tömb vagy objektum, illetve Gyűjtemény a megadott gyűjtemények összes elemével – nincs ismétlődés

Példa

Ez a példa a gyűjtemények összes elemét lekéri:

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

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

uriComponent

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

uriComponent('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az URI kódolású formátumba konvertálandó sztring
Visszaadott érték Type Description
<kódolt-uri> Sztring Az URI-kódolású sztring escape karakterekkel

Példa

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

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring A konvertálni kívánt URI-kódolt sztring
Visszaadott érték Type Description
<binary-for-coded-uri> Sztring Az URI-kódolt sztring bináris verziója. A bináris tartalom base64 kódolású, és az .$content

Példa

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:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

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

uriComponentToString('<value>')
Paraméter Szükséges Type Description
<value> Igen Sztring A dekódolni kívánt URI-kódolt sztring
Visszaadott érték Type Description
<dekódolt-uri> Sztring Az URI kódolású sztring dekódolt verziója

Példa

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

uriComponentToString('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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek host értékét meg szeretné adni
Visszaadott érték Type Description
<gazdagép-érték> Sztring A host megadott URI értéke

Példa

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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek path értékét meg szeretné adni
Visszaadott érték Type Description
<elérési út-érték> Sztring A path megadott URI értéke. Ha path nincs értéke, adja vissza a "/" karaktert.

Példa

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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek path értékeit és query értékeit
Visszaadott érték Type Description
<path-query-value> Sztring A path megadott URI értékei és query értékei. Ha path nem ad meg értéket, adja vissza a "/" karaktert.

Példa

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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek port értékét meg szeretné adni
Visszaadott érték Type Description
<port-érték> Egész A port megadott URI értéke. Ha port nem ad meg értéket, adja vissza a protokoll alapértelmezett portját.

Példa

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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek query értékét meg szeretné adni
Visszaadott érték Type Description
<lekérdezés-érték> Sztring A query megadott URI értéke

Példa

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>')
Paraméter Szükséges Type Description
<Uri> Igen Sztring Az URI, amelynek scheme értékét meg szeretné adni
Visszaadott érték Type Description
<séma-érték> Sztring A scheme megadott URI értéke

Példa

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

Másik formátumot is megadhat a <formátumparaméterrel>.

Paraméter Szükséges Type Description
<format> Nem Sztring Numerikus formázási sztring , amely egyetlen formátumkijelölő vagy egyéni formátumminta. Az időbélyeg alapértelmezett formátuma az "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), amely megfelel az ISO 8601 szabványnak, és megőrzi az időzóna adatait.

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

1\. példa

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

utcNow()

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

2\. példa

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

utcNow('D')

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

V

változók

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

variables('<variableName>')
Paraméter Szükséges Type Description
<variableName> Igen Sztring Annak a változónak a neve, amelynek értékét meg szeretné adni
Visszaadott érték Type Description
<változó-érték> Any A megadott változó értéke

Példa

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>
Paraméter Szükséges Type Description
<Tulajdonság> Nem Sztring 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 environmentName a tulajdonság értékeinek lekéréséhezflowDisplayName.

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>')
Paraméter Szükséges Type Description
<value> Igen Sztring Az átalakítandó JSON-objektummal rendelkező sztring

A JSON-objektumnak csak egy gyökértulajdonságúnak kell lennie, amely nem lehet tömb.
Használja a fordított perjelet (\) a kettős idézőjel (").
Visszaadott érték Type 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>')

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

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

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

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

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

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

Xpath

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

Megjegyzés:

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>')
Paraméter Szükséges Type Description
<xml> Igen Any Az XPath-kifejezésértéknek megfelelő csomópontok vagy értékek keresésére szolgáló XML-sztring
<Xpath> Igen Any Az egyező XML-csomópontok vagy -értékek megkeresésére használt XPath-kifejezés
Visszaadott érték Type Description
<xml-node> XML XML-csomópont, ha csak egyetlen csomópont felel meg a megadott XPath-kifejezésnek
<value> 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>, ...] Tömb 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 'items' megfelelő <name></name> 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ő expired összes name 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 összes olyan elemet, '//name[@price>35]'amely 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 csomópontnak megfelelő <location></location> eredménycsomópont:

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

Fontos

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

További lépések

Tudnivalók a munkafolyamat-definíció nyelvéről