Ú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 firstName
lastName
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 eredetisubscribe
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 user
kimeneté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 user
kimeneté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 float tö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 user
kimeneté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
, 3
vagy 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
, Until
vagy 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 name
item
.
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: