Datové typy proměnných

Když ve svých tocích vytvoříte proměnné, Power Automate je převede na konkrétní typ na základě jejich obsahu.

Některé z těchto datových typů jsou široce používány v celé aplikaci, například čísla, zatímco jiné, jako např. instance prohlížeče, vyžadují explicitní akce nebo skupiny akcí.

Jednoduché datové typy

Jednoduché datové typy představují jednotlivé hodnoty, jako jsou texty a čísla. Tyto datové typy můžete používat samostatně nebo je využít k vytváření složitějších datových struktur, jako jsou seznamy a datové tabulky.

Textová hodnota

Tento datový typ představuje jakýkoli druh textu, od e-mailových adres po textový obsah .txt souboru.

Vlastnosti textového datového typu

Chcete-li vytvořit proměnnou textové hodnoty, použijte akci Nastavit proměnnou a zadejte požadovaný text bez jakékoli notace.

Snímek obrazovky akce Nastavit proměnnou, která vytváří textovou proměnnou.

Číselná hodnota

Numeric je typ používaný pro čísla. Pouze tento datový typ lze použít v matematických operacích.

Chcete-li vytvořit číselnou proměnnou, použijte akci Nastavit proměnnou a zadejte číslo bez jakéhokoli zápisu.

Kromě pevně zakódovaných číselných hodnot můžete používat matematické výrazy s proměnnými mezi znaky %. Další informace o matematických výrazech najdete v tématu Použití proměnných a zápisu %.

Snímek obrazovky akce Nastavit proměnnou, která vytváří proměnnou s číselnou hodnotou.

Logická hodnota

Hodnota může být buď True nebo False.

Chcete-li vytvořit booleovskou proměnnou, použijte akci Nastavit proměnnou a zadejte výrazy %True% nebo %False% do vstupního parametru.

Komplexní výrazy můžete vytvořit také pomocí logických operátorů, proměnných a procentní notace. Další informace o logických výrazech najdete v tématu Použití proměnných a zápisu %.

Snímek obrazovky akce Nastavit proměnnou, která vytváří proměnnou logická hodnota.

Pokročilé datové typy

Pokročilé datové typy představují složité datové struktury. Fungují jako kolekce jiných datových typů, ke kterým můžete přistupovat jako k jedné entitě.

Seznam

Seznamy jsou kolekce položek. V závislosti na typech jednotlivých položek seznamu mohou existovat seznamy textových hodnot, seznamy číselných hodnot atd. Datový typ seznamu je ekvivalentem jednorozměrného pole z hlediska programování.

Seznam můžete vytvořit pomocí akce Vytvořit nový seznam a přidat položku do tohoto seznamu prostřednictvím akce Přidat položku do seznamu.

Snímek obrazovky toku, který vytváří seznam.

Seznam můžete také vytvořit pomocí akcí, které generují seznamy jako výstup. Například akce Číst text ze souboru může vrátit seznam textových hodnot a akce Získat soubory ve složce vrací seznam souborů.

Chcete-li načíst konkrétní položku v seznamu, použijte následující zápis: %VariableName[ItemNumber]%

V následujícím příkladu tok ukládá první číslo dříve zobrazeného seznamu do nové proměnné. Pamatujte, že index by měl být pro první položku seznamu 0.

Snímek obrazovky výrazu, který přistupuje k první položce seznamu.

Běžnou praxí je použití akce For each k iteraci přes položky seznamu.

Pokud potřebujete přístup pouze k určité části seznamu, použijte notaci %VariableName[StartIndex:StopIndex]%. Například výraz %List[2:4]% načte třetí a čtvrtou položku v seznamu. Položka na pozici StopIndex je hranicí řezu a není vrácena.

Chcete-li vybrat podseznam od začátku po konkrétní položku, nenastavujte hodnotu StartIndex, např. %List[:4]%. Chcete-li vytvořit řez seznamu od konkrétního indexu do konce, nenastavujte hodnotu StopIndex, např. %List[2:]%.

Vlastnosti datového typu Seznam

Datatable

Datové tabulky obsahují data v tabulkové podobě a z hlediska programování jsou ekvivalentem dvourozměrných polí.

Datová tabulka obsahuje řádky a sloupce, které jednoznačně popisují pozici každé položky. Datové tabulky můžete považovat za seznamy, které obsahují datové řádky jako položky.

Snímek obrazovky obsahu proměnné datové tabulky.

Power Automate poskytuje akci Vytvořte novou datovou tabulku pro generování nových datových tabulek. Po nasazení akce můžete použít vizuální tvůrce k naplnění hodnot a přejmenování záhlaví sloupců.

Snímek obrazovky vizuálního tvůrce akce Vytvořit novou datovou tabulku.

Kromě akce Vytvořit novou tabulku dat vytvoří tři další akce datové tabulky pro ukládání extrahovaných dat: Číst z excelového listu, Spustit příkaz SQL a Extrahovat data z webové stránky.

Datovou tabulku můžete vytvořit také pomocí akce Nastavit proměnnou a zápisu pole v programování. Tento zápis se skládá z několika jednorozměrných polí oddělených čárkami a uzavřených do složených závorek. Konečný výraz musí mít následující podobu: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Snímek obrazovky akce Nastavit proměnnou, která vytváří datovou tabulku.

Pokud chcete přidat záhlaví sloupců při vytváření nové datové tabulky pomocí zápisu pole, použijte výraz ^['ColumnName1', 'ColumnName2'] pro první řádek.

Snímek obrazovky akce Nastavit proměnnou, která vytvoří novou datovou tabulku se záhlavími sloupců.

Chcete-li přidat nový řádek do existující tabulky, použijte akci Vložit řádek do datové tabulky. Případně vytvořte výraz obsahující název proměnné datové tabulky, znak plus (+) a hodnoty, které chcete přidat, v závorkách.

Snímek obrazovky akce Nastavit proměnnou, která přidá nový řádek do datové tabulky.

Kromě vkládání řádků do datových tabulek nabízejí desktopové toky různé akce, které s datovými tabulkami manipulují. Úplný seznam těchto akcí najdete v referenci akcí proměnných.

Pokud chcete načíst konkrétní položku z datové tabulky, použijte následující zápis: %VariableName[RowNumber][ColumnNumber]%. Mějte na paměti, že RowNumber a ColumnNumber musí být 0 pro první položku (řádek nebo sloupec).

Předpokládejme například, že tok načte obsah listu aplikace Excel a uloží jej do proměnné ExcelData. Pokud chcete získat přístup k první buňce na druhém řádku načtené tabulky, použijte výraz zobrazený na následujícím obrázku.

Screenshot výrazu pro přístup k druhé buňce prvního řádku čteného souboru Excel.

Poznámka

Proměnná ExcelData obsahuje tabulku hodnot extrahovaných z Excel listu pomocí akce Číst z Excel listu. Obsahuje některé hodnoty konkrétního listu a ne celý soubor aplikace Excel.

Pokud chcete získat přístup ke konkrétnímu sloupci v datové tabulce, která obsahuje záhlaví sloupců, použijte notaci %ExcelData[rowNumber]['ColumnName']%.

Pokud procházíte datovou tabulkou pomocí akce For Each, považuje se proměnná obsahující data aktuální iterace za datový řádek.

Podobně jako v seznamech použijete %VariableName[StartRow:StopRow]% zápis pro přístup ke konkrétní části datové tabulky. Výraz načte pouze řádky definované dvěma indexy, zatímco pozice StopRow je hranicí ořezu a řádky na této hranici se nenačtou.

Chcete-li vybrat část datové tabulky od prvního řádku po konkrétní řádek, nepoužívejte hodnotu StartRow, např. %Datatable[:4]%. Podobně pro oříznutí datové tabulky z konkrétního řádku na konec nepoužívejte hodnotu StopRow, například %Datatable[2:]%.

Vlastnosti datového typu Datatable

Datový řádek

datarow obsahuje hodnoty jednoho řádku datatable. Když procházíte datovou tabulku pomocí akce For Each, proměnná, která obsahuje data aktuální iterace, je datarow.

Chcete-li načíst konkrétní položku datového řádku, použijte následující zápis: %VariableName[ItemNumber]%

Případně můžete použít zápis %VariableName['ColumnName']%. Název každého sloupce je definován datatable, ze které jste načetl/a datarow.

Vlastnosti datového typu datarow

Snímek obrazovky obsahu proměnné DataRow.

Vlastní objekt

Obsahuje dvojice vlastností a hodnot, které můžete snadno převést na formát JSON.

Pokud chcete vytvořit nový prázdný vlastní objekt, použijte akci Nastavit proměnnou a zadejte výraz %{{ }}%. Chcete-li vytvořit nový vlastní objekt a inicializovat jej s vlastnostmi a hodnotami, použijte výraz s následující strukturou: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Snímek obrazovky akce Nastavit proměnnou, která vytváří nový vlastní objekt.

Důležité

Rezervovaná klíčová slova nemůžete použít jako vlastnosti vlastního objektu. Úplný seznam rezervovaných klíčových slov najdete v tématu Vyhrazená klíčová slova v desktopových tocích.

Chcete-li aktualizovat hodnotu existující vlastnosti nebo přidat novou, přidejte akci Nastavit proměnnou, zadejte název vlastnosti do pole Nastavit a zadejte její hodnotu do pole Na.

Snímek obrazovky akce Nastavit proměnnou, která přidá novou vlastnost k vlastnímu objektu.

Kromě hodnot literálů můžete pomocí proměnných dynamicky nastavit vlastnosti a hodnoty vlastních objektů. Například následující postup používá dvě proměnné k přidání nové vlastnosti do nového prázdného vlastního objektu.

Snímek obrazovky toku, který používá proměnné k přidání nové vlastnosti k vlastnímu objektu.

Objekt konektoru

Objekty konektoru ukládají informace z cloudových konektorů a fungují podobně jako vlastní objekty. Jejich vlastnosti obvykle obsahují seznamy dalších objektů konektoru. Přístup k hodnotám funguje jako u vlastních objektů, i když přístup k vnořeným hodnotám může vyžadovat složitější výrazy.

Screenshot proměnné vlastního objektu v prohlížeči proměnných.

Seznam informací o PDF tabulkách

Proměnnou tohoto datového typu můžete vytvořit pouze prostřednictvím akce Extrahovat tabulky z PDF .

Každá položka v seznamu popisuje extrahovanou tabulku a poskytuje o ní všechny podstatné informace. Pro přístup ke konkrétní položce informací o datové tabulce použijte notaci %VariableName[ItemNumber]%.

Snímek obrazovky seznamu informací o PDF tabulce.

Každá položka seznamu obsahuje čtyři vlastnosti, které můžete použít k získání konkrétních podrobností. Dostupné vlastnosti jsou následující:

  • DataTable – vrátí extrahovanou tabulku.
  • TableStartingPage – vrátí index stránky souboru, která obsahuje začátek tabulky.
  • TableEndingPage – vrátí index stránky souboru, která obsahuje konec tabulky.
  • TableOrderInPage – vrátí pořadí tabulky na stránce.

Další informace o vlastnostech tohoto datového typu naleznete v tématu Proměnné vlastnosti datového typu.

Snímek obrazovky vlastností seznamu informací o PDF tabulce.

Chcete-li získat přístup k hodnotě konkrétní vlastnosti, použijte notaci %VariableName[ItemNumber].PropertyName%. Například následující výraz vrátí hodnotu datatable první položky proměnné ExtractedPDFTables.

Snímek obrazovky datové tabulky v seznamu proměnných s informacemi o tabulce PDF.

Známé problémy a omezení

  • Problém: Pokud datová tabulka nebo buňka datového řádku obsahuje víceřádkovou položku, prohlížeč proměnných zobrazí pouze první řádek.
  • Alternativní řešení: Žádné.

Instance

Propojení

Jiné datové typy

Tato sekce představuje všechny dostupné datové typy, které nepatří do žádné z předchozích kategorií.

Obecná hodnota

  • Obecná hodnota – tento datový typ použijte v době návrhu, když Power Automate nemůže definovat datový typ proměnné nebo vstupního parametru. Obecné hodnoty se v běhu převedou na jiné datové typy podle své hodnoty.

služba služba Active Directory

  • Záznam služby služba Active Directory – Obsahuje připojení k serveru služba Active Directory vytvořenému prostřednictvím akce Připojit k serveru.
  • Informace o skupině – Obsahuje název, zobrazovaný název, popis a členy zadané skupiny služba Active Directory.
  • Člen skupiny – Představuje člena zadané skupiny služba Active Directory.
  • Informace o uživateli – Obsahuje informace o zadaném uživateli služby služba Active Directory, například jméno a příjmení, iniciály a rozlišovací jméno, pracovní údaje (společnost, oddělení a titul), kontaktní informace (telefonní číslo, interní číslo a e-mail) a umístění (země/oblast, město, stát, adresa ulice a poštovní směrovací číslo).

Vlastnosti datového typu služby služba Active Directory

Amazon Web Services (AWS)

  • Klient EC2 – Obsahuje relaci EC2 vytvořenou prostřednictvím akce Vytvořit relaci EC2.
  • Instance EC2 – Představuje načtenou instanci EC2.
  • Informace o instancích EC2 – Obsahuje informace o instanci EC2.
  • Změna stavu instance – Obsahuje informace o instanci EC2, která byla spuštěna nebo zastavena.
  • Snímek EBS – Představuje snímek EBS.
  • Svazek EBS – Představuje svazek EBS.

Vlastnosti datového typu AWS

Azure

  • Klient Azure – Obsahuje relaci Azure vytvořenou prostřednictvím akce Vytvořit relaci.
  • Skupina prostředků Azure – Představuje načtenou skupinu prostředků Azure.
  • Spravovaný disk Azure – Představuje načtený disk Azure.
  • Snímek Azure – Představuje snímek Azure.
  • Virtuální počítač Azure – Představuje načtený virtuální počítač Azure.
  • Informace o virtuálním počítači Azure – Obsahuje informace o virtuálním počítači Azure.
  • Předplatné Azure – Představuje načtené předplatné Azure.

Vlastnosti datového typu Azure

CMD

  • Relace CMD – Obsahuje relaci CMD vytvořenou prostřednictvím akce Otevřít relaci CMD.

Vlastnosti datového typu CMD

Přihlašovací údaje

  • Přihlašovací údaje – Obsahuje přihlašovací údaje načtené prostřednictvím akce Získat přihlašovací údaje .

Vlastnosti datového typu přihlašovacích údajů

Datum a čas

  • Datetime – Obsahuje informace o datu a čase. Pokud chcete vytvořit proměnnou datetime prostřednictvím akce Nastavit proměnnou , zadejte vstupní parametr s výrazy %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, kde:

    Notace Popis
    yyyy Rok
    MM Měsíc
    dd Den
    HH Hodina
    mm Minuty
    ss Sekundy
    ff Milisekundy
    zzz Posun od UTC

    Například %d"2022-03-25"% přiřadí cílové proměnné datum 25. března 2022.

Vlastnosti datových typů dat a času

Email

  • E-mailová zpráva – Představuje e-mailovou zprávu. Akce Načíst e-maily naplní tyto proměnné.

Vlastnosti datového typu e-mail

Výměna

  • E-mailová zpráva Exchange – Představuje e-mailovou zprávu načtenou ze serveru Exchange. Akce Načíst e-mailové zprávy Exchange vyplňuje tyto proměnné.

Vlastnosti datového typu Exchange

Soubory a složky

  • Soubor – Představuje soubor.
  • Složka – Představuje složku.
  • FileSystemObject – Představuje složku nebo soubor. Tento datový typ se používá ve vstupních parametrech, které přijímají složky a soubory.

Vlastnosti datového typu Soubory a složky

protokol FTP

  • Soubor FTP – Představuje soubor FTP.
  • Adresář FTP – Představuje adresář FTP.

Vlastnosti datového typu FTP

OCR

  • OCR engine – Obsahuje OCR engine vytvořený prostřednictvím akce Vytvořit OCR engine.

Outlook

  • E-mailová zpráva Outlook – Představuje e-mailovou zprávu Outlook. Akce Načíst e-mailové zprávy z Outlooku vyplňuje tyto proměnné.

Vlastnosti datového typu Outlook

Citlivé hodnoty

  • SensitiveValue – obsahuje textovou hodnotu, která musí být označena jako citlivá. Tajná proměnná prostředí nebo vlastnost Password proměnné přihlašovacích údajů jsou typu SensitiveValue.

Terminál

  • Relace terminálu – Obsahuje relaci terminálu vytvořenou prostřednictvím akce Otevřít relaci terminálu.

Vlastnosti datového typu terminálu

jazyk XML

  • Uzel XML – Obsahuje obsah dokumentu XML. Akce Přečíst XML ze souboru naplní tyto proměnné.

Vlastnosti datového typu XML

Chyba

  • Chyba – Obsahuje informace o poslední chybě v desktopovém toku. Tento typ proměnné vytváří akce Získat poslední chybu.

Vlastnosti chyby