Változó adattípusok

Amikor változókat hoz létre a folyamatokban, a Power Automate a tartalmuk alapján meghatározott típussá alakítja át őket.

Ezen adattípusok némelyikét széles körben használják az alkalmazásban, például a számokat, míg mások, például a böngészőpéldányok, explicit műveleteket vagy műveletcsoportokat igényelnek.

Egyszerű adattípusok

Az egyszerű adattípusok egyetlen értéket képviselnek, például szövegeket és számokat. Ezeket az adattípusokat egymástól függetlenül is használhatja, vagy összetettebb adatstruktúrák, például listák és adattáblák létrehozására is használhatja őket.

Szöveges érték

Ez bármilyen szöveg, az e-mail címektől a .txt fájl szöveges tartalmáig.

Szöveg adattípus tulajdonságai

Szövegérték-változó létrehozásához használja a Változó beállítása műveletet, és töltse fel a bemeneti paramétert a kívánt szöveggel jelölés nélkül.

Képernyőkép egy Változó beállítása műveletről, amely létrehoz egy Szöveg értékváltozót.

Numerikus érték

A numerikus a számokra alkalmazott típus. A matematikai műveletekben csak ez az adattípus használható.

Hozzon létre egy numerikus érték változót, használja a Változó beállítása műveletet, és töltse fel a bemeneti paramétert egy számmal jelölés nélkül.

A kódolt numerikus értékek kivételével a matematikai kifejezések használhatók százalékjelek között lévő változókkal. A matematikai kifejezésekkel kapcsolatos további információkért olvassa el a Változók és a % jelölés használata című témakört.

Képernyőkép egy Változó beállítása műveletről, amely numerikus érték változót hoz létre.

Logikai érték

Az érték lehet Igaz vagy Hamis.

Ha logikai értékváltozót hoz létre, használja a Változó beállítása műveletet, és töltse fel a bemeneti paramétert a kifejezésekkel %True% vagy %False%.

Emellett összetett kifejezéseket is létrehozhat logikai operátorok, változók és százalékos jelöléssel. A logikai kifejezésekkel kapcsolatos további információkért tekintse meg a Változók és a % jelölés használata című témakört.

Képernyőkép egy változó beállítása műveletről, amely logikai értékváltozót hoz létre.

Speciális adattípusok

A speciális adattípusok összetett adatstruktúrákat képviselnek. Más adattípusok gyűjteményeként működnek, amelyeket egy entitásként érhet el.

List

A listák elemek gyűjteményei. Az egyes listaelemek típusától függően lehet szó szöveges értékek, numerikus értékek stb. listáiról. A lista adattípusa programozási szempontból egyenértékű egy egydimenziós tömbbel.

Listát az Új lista létrehozása művelettel hozhat létre, és hozzáadhat egy elemet a listához az Elem hozzáadása a listához művelettel.

Képernyőkép egy listát létrehozó folyamatról.

Listát olyan műveletekkel is létrehozhat, amelyek listákat adnak kimenetként. A Szöveg olvasása fájlból művelet például szöveges értékek listáját, a Fájlok beolvasása mappába művelet pedig a fájlok listáját adja vissza.

Egy lista egy adott elemének beolvasásához használja a következő jelölést: %VariableName[ItemNumber]%

A következő példában a folyamat a korábban megjelenített lista első számát egy új változóban tárolja. Ne feledje, hogy a lista első eleme esetében az indexnek 0-nak kell lennie.

Képernyőkép egy kifejezésről, amely egy lista első eleméhez fér hozzá.

Gyakori gyakorlat a For each művelet használata a lista elemeinek iterálásához.

Ha a listának csak egy adott részét kell elérnie, használja a %VariableName[StartIndex:StopIndex]%jelölést . A kifejezés %List[2:4]%lekéri például a lista harmadik és negyedik elemét. A StopIndex pozícióban lévő elem a szeletelés határa, és nem lesz lekérve.

Ha egy listát az elejétől egy adott elemre szeretne szeletelni, ne állítson be StartIndex értéket, például: %List[:4]%. Ha egy listát egy adott indexből a végére szeretne szeletelni, ne állítson be StopIndex értéket, például, %List[2:]%.

Adattípus-tulajdonságok listázása

Adattábla

Az adattáblák táblázatos formában tartalmazzák az adatokat, és programozási szempontból a kétdimenziós tömböknek felelnek meg.

Az adattábla olyan sorokat és oszlopokat tartalmaz, amelyek egyedileg írják le az egyes elemek helyzetét. Az adattáblák olyan listáknak tekinthetők, amelyek adatsorokat tartalmaznak elemként.

Képernyőkép egy adattábla-változó tartalmáról.

Power Automate az Új adattábla létrehozása műveletet biztosít új adattáblák létrehozásához. A művelet üzembe helyezése után a vizualizációszerkesztővel feltöltheti az értékeket, és átnevezheti az oszlopfejléceket.

Képernyőkép az Új adattábla létrehozása művelet vizualizációszerkesztőjéről.

Az Új adattábla létrehozása műveleten kívül három további művelet hoz létre adattáblákat a kinyert adatok tárolására: az Olvasás Excel-munkalapról , az SQL végrehajtása utasítás és azAdatok kinyerése weblapról műveletek.

Emellett létrehozhat egy adattáblát a Változó beállítása művelettel és a programozási tömb jelölésével. Ez a jelölés több, vesszővel elválasztott és kapcsos zárójelbe tett egydimenziós tömbből áll. A végső kifejezésnek a következő formájúnak kell lennie: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Képernyőkép a Változó beállítása műveletről, amely létrehoz egy adattáblát.

Ha oszlopfejléceket szeretne hozzáadni egy új adattábla létrehozásakor a tömbjelöléssel, használja a ^['ColumnName1', 'ColumnName2'] kifejezést az első sorhoz.

Képernyőkép egy Változó beállítása műveletről, amely új adattáblát hoz létre oszlopfejlécekkel.

Ha új sort szeretne hozzáadni egy meglévő táblához, használja a Sor beszúrása adattáblába műveletet. Másik lehetőségként hozzon létre egy kifejezést, amely tartalmazza az adattábla változónevét, egy pluszkaraktert (+) és a szögletes zárójelben hozzáadni kívánt értékeket.

Képernyőkép egy Változó beállítása műveletről, amely új sort ad hozzá egy adattáblához.

A sorok adattáblákba való beszúrása mellett az asztali folyamatok különböző műveleteket kínálnak az adattáblák manipulálására. Ezeknek a műveleteknek a teljes listáját a változóműveletek referenciájában találja.

Egy adattábla egy adott elemének lekéréséhez használja a következő jelölést: %VariableName[RowNumber][ColumnNumber]%. Ne feledje, hogy a Sorszám és a ColumnNumber értéknek 0-nak kell lennie az első elemhez (sorhoz vagy oszlophoz).

Tegyük fel például, hogy egy folyamat lekéri egy Excel-munkalap tartalmát, és az ExcelData változóban tárolja azt. Ha hozzá szeretne férni a lekért tábla második sorának első cellájához, használja az alábbi kifejezést.

Képernyőkép egy olyan kifejezésről, amely egy olvasott Excel-fájl első sorának második cellájához fér hozzá.

Feljegyzés

Az ExcelData változó egy Excel-munkalapról az Olvasás Excel-munkalapról művelettel kinyert értékeket tartalmazó táblázatot tartalmaz. Egy adott munkalap bizonyos értékeit tartalmazza, nem pedig a teljes Excel-fájlból származó értékeket.

Ha egy oszlopfejléceket tartalmazó datáló tábla egy adott oszlopát szeretné elérni, használja a %ExcelData[rowNumber]['ColumnName']% jelölést.

Ha egy For Each művelettel hurkol át egy adattáblát , az aktuális iteráció adatait tartalmazó változó adatsornak minősül.

A listákhoz hasonlóan a %VariableName[StartRow:StopRow]%jelölést használja az adattábla egy adott részének eléréséhez. A kifejezés csak a két index által meghatározott sorokat kéri le, míg a StopRow pozíció a szeletelés határa, és nem lesz lekérve.

Ha egy adattáblát az első sorból egy adott sorba szeretne szeletelni, ne használjon StartRow értéket, például, %Datatable[:4]%. Hasonlóképpen, ha egy adattáblát egy adott sorból a végéig szeretne szeletelni, ne használjon StopRow értéket, például, %Datatable[2:]%.

Adattábla adattípus-tulajdonságok

Adatsor

Az adatsor egy adattábla egyetlen sorának értékeit tartalmazza. Ha egy For Each művelettel hurkol át egy adattáblát , az aktuális iteráció adatait tartalmazó változó egy adatsor.

Egy adatsor egy adott elemének lekéréséhez használja a következő jelölést: %VariableName[ItemNumber]%

Alternatív megoldásként használhatja a %VariableName['ColumnName']% jelölés. Az egyes oszlopok nevét az az adattábla határozza meg, amelyből az adattárat lekérte.

Adatsor adattípus tulajdonságai

Képernyőkép egy adatsorváltozó tartalmáról.

Custom object

Tulajdonságok és értékek párjait tartalmazza, amelyek könnyen konvertálhatók JSON formátumba.

Új üres egyéni objektum létrehozásához használja a Változó beállítása műveletet, és töltse ki a következő kifejezést %{{ }}%. Új egyéni objektum létrehozásához és tulajdonságokkal és értékekkel való inicializálásához használja a következő szerkezetű kifejezést: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Képernyőkép a Változó beállítása műveletről, amely új egyéni objektumot hoz létre.

Fontos

A fenntartott kulcsszavak nem használhatók egyéni objektumtulajdonságokként. A fenntartott kulcsszavak teljes listáját az asztali folyamatok fenntartott kulcsszavai című témakörbentalálja.

Meglévő tulajdonság értékének frissítéséhez vagy új hozzáadásához telepítsen egy Változó beállítása műveletet, töltse ki a tulajdonság nevét a Beállítás mezőbe, és adja meg az értékét a Címzett mezőben.

Képernyőkép egy Változó beállítása műveletről, amely új tulajdonságot ad hozzá egy egyéni objektumhoz.

A konstans értékeken kívül változók segítségével dinamikusan beállíthatja az egyéni objektumok tulajdonságait és értékeit. A következő folyamat például két változót használ egy új tulajdonság hozzáadásához egy új üres egyéni objektumhoz.

Képernyőkép egy folyamatról, amely változók használatával új tulajdonságot ad hozzá egy egyéni objektumhoz.

Összekötő objektuma

Az összekötőobjektumok a felhőbeli összekötőkből származó információkat tárolják, és az egyéni objektumokhoz hasonlóan működnek. Tulajdonságaik általában más összekötőobjektumok listáját tartalmazzák. Az értékek elérése ugyanúgy működik, mint az egyéni objektumokban, bár a beágyazott értékek eléréséhez bonyolultabb kifejezésekre lehet szükség.

Képernyőkép egy egyéni objektumváltozóról a változók megjelenítőjében.

PDF táblázat információk listája

Az ilyen adattípusú változó csak a Táblázatok kivonása PDF-ből művelettel állítható elő.

A lista minden eleme egy kinyert táblázatot ír le, és minden lényeges információt megad róla. Egy adott adattábla-információelem eléréséhez használja a %VariableName[ItemNumber]%jelölést .

Képernyőkép a PDF-táblázat adatainak listájáról.

Minden listaelem négy tulajdonsággal rendelkezik, amelyek lehetővé teszik egy adott részlet független lekérését. A rendelkezésre álló tulajdonságok a következők:

  • DataTable – A kibontott táblát adja vissza.
  • TableStartingPage – A tábla elejét tartalmazó fájloldal indexét adja vissza.
  • TableEndingPage – A tábla végét tartalmazó fájloldal indexét adja vissza.
  • TableOrderInPage – A tábla sorrendjét adja vissza az oldalon.

Az adattípus tulajdonságairól a Változók adattípus-tulajdonságok című témakörbentalál további információt.

Képernyőkép a PDF-táblázat információinak listájáról.

Egy adott tulajdonság értékének eléréséhez használja a %VariableName[ItemNumber]. PropertyName%notation . A következő kifejezés például az ExtractedPDFTables változó első elemének adattábla értékét adja vissza.

Képernyőkép a PDF-táblázat információs változóinak listájában található adattábláról.

Ismert problémák és korlátozások

  • Probléma: Ha egy adattábla vagy adatsorcella többsoros bejegyzést tartalmaz, a változómegjelenítő csak az első sorát jeleníti meg.
  • Megkerülő megoldások: Nincs.

Példányok

Kapcsolatok

Egyebek

Ez a szakasz az összes olyan elérhető adattípust bemutatja, amely nem tartozik az előző kategóriák egyikébe sem.

Általános érték

  • Általános érték – Ezt az adattípust a tervezés során használják, amikor Power Automate nem lehet meghatározni egy változó vagy egy bemeneti paraméter adattípusát. Az általános értékek futásidőben más adattípusokká lesznek konvertálva az adataik alapján.

Active Directory

  • Active Directory bejegyzés– A Csatlakozás kiszolgálóhoz művelettel létrehozott Active Directory-kiszolgálóval létesített kapcsolatot tartalmaz.
  • Csoportinformáció– Tartalmazza a megadott Active Directory csoport nevét, megjelenítendő nevét, leírását és tagjait.
  • Csoporttag – Egy megadott Active Directory csoport tagját jelöli.
  • Felhasználói adatok – Egy adott Active Directory-felhasználó adatait tartalmazza, például vezeték- és utónevet, kezdőbetűket és megkülönböztető nevet, munkahelyi adatokat (vállalat, részleg és beosztás), kapcsolattartási adatokat (telefonszám, mellék és e-mail-cím) és helyet (ország/régió, város, állam, utcai cím és irányítószám).

Active Directory adattípus-tulajdonságok

Amazon webszolgáltatások (AWS)

  • EC2 kliens – Az EC2 munkamenet létrehozása művelettel létrehozott EC2 munkamenetet tartalmaz.
  • EC2 példány– Egy lekért EC2 példányt jelöl.
  • EC2 példányok információ– Egy EC2 példányra vonatkozó információkat tartalmaz.
  • Példányállapot változása – Információkat tartalmaz egy elindított vagy leállított EC2 példányról.
  • EBS pillanatkép– EBS pillanatképet képvisel.
  • EBS kötet– EBS-kötetet jelöl.

AWS adattípus tulajdonságai

Azure

  • Azure-ügyfél – A Munkamenet létrehozása művelettel létrehozott Azure-munkamenetet tartalmaz.
  • Azure-erőforráscsoport – Egy lekért Azure-erőforráscsoportot jelöl.
  • Azure felügyelt lemez– Egy lekért Azure-lemezt jelöl.
  • Azure pillanatkép– Egy Azure-pillanatképet jelöl.
  • Azure-beli virtuális gép – Egy lekért Azure-beli virtuális gépet jelöl.
  • Azure-beli virtuális gép adatai – Egy Azure-beli virtuális gépről tartalmaz információkat.
  • Azure-előfizetés – Egy lekért Azure-előfizetést jelöl.

Azure-adattípus-tulajdonságok

CMD

  • CMD munkamenet– A CMD-munkamenet megnyitása művelettel létrehozott CMD-munkamenetet tartalmaz.

CMD adattípus tulajdonságai

Hitelesítő adatok

  • Hitelesítő adatok – A Hitelesítő adatok lekérése (előzetes verzió) művelettel lekért hitelesítő adatokat tartalmaz.

Hitelesítő adatok adattípusának tulajdonságai

Dátumok és idő

  • Datetime – Dátum- és időinformációkat tartalmaz. Ha datetime változót szeretne létrehozni a Változó beállítása művelettel, töltse fel a bemeneti paramétert a következő kifejezésekkel %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, ahol:

    Jelölés Ismertetés
    éé Év
    MM Hónap
    Dd nap
    HH Óra
    Mm perc
    Ss Másodperc
    Ff Ezredmásodperc
    Zzz UTC-időeltolódás

    Például," %d2022-03-25"% 2022. március 25-i dátumot rendel a célváltozóhoz.

Dátum és idő adattípus tulajdonságai

Email

  • E-mail üzenet – Egy e-mail üzenetet jelöl. Az E-mailek lekérése művelet feltölti ezeket a változókat.

E-mail adattípus tulajdonságai

Exchange

  • Exchange e-mail üzenet – Egy Exchange-kiszolgálóról letöltött e-mail üzenetet jelöl. Az Exchange e-mail-üzenetek lekérése művelet feltölti ezeket a változókat.

Exchange adattípus tulajdonságai

Fájlok és mappák

  • Fájl – Egy fájlt képvisel.
  • Mappa – Egy mappát jelöl.
  • FileSystemObject – Egy mappát vagy egy fájlt jelöl. Ez az adattípus a mappákat és fájlokat fogadó bemeneti paraméterekben használatos.

Fájlok és mappák adattípus-tulajdonságai

FTP

  • FTP fájl – FTP fájlt jelöl.
  • FTP könyvtár– FTP-könyvtárat jelöl

FTP adattípus tulajdonságai

OCR

  • OCR-motor– Az OCR-motor létrehozása művelettel létrehozott OCR-motort tartalmaz.

Outlook

  • Outlook e-mail üzenet – Egy e-mail Outlook-üzenetet jelent. Az E-mailek lekérése az Outlookból művelet feltölti ezeket a változókat.

Az Outlook adattípus tulajdonságai

Terminál

  • Terminál munkamenet– A Terminálmunkamenet megnyitása művelettel létrehozott terminálmunkamenetet tartalmaz.

Terminál adattípus tulajdonságai

XML

  • XML csomópont – Egy XML-dokumentum tartalmát tartalmazza. Az XML olvasása fájlból művelet feltölti ezeket a változókat.

XML adattípus tulajdonságai

Hiba

  • Hiba – Az asztali folyamat legutóbb előfordult hibájával kapcsolatos információkat tartalmaz. Az Utolsó hiba lekérése művelet létrehozza az ilyen típusú változót.

Hiba tulajdonságai