Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
Čí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 %.
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 %.
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.
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.
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.
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ů.
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']}%.
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.
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.
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.
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
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' }%.
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.
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.
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.
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]%.
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.
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.
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
Instance webového prohlížeče – Obsahuje instanci prohlížeče vytvořenou prostřednictvím Spustit nový Internet Explorer nebo jiných akcí spuštění prohlížeče.
Instance okna – Obsahuje instanci okna vytvořenou prostřednictvím akce Získat okno.
Instance aplikace Excel – Obsahuje instanci aplikace Excel vytvořenou prostřednictvím akce Spustit Excel.
Instance aplikace Outlook – Obsahuje instanci aplikace Outlook vytvořenou prostřednictvím akce Spustit Outlook.
Propojení
SQL připojení – Obsahuje připojení k databázi SQL vytvořené prostřednictvím akce Otevřít připojení SQL.
Připojení k Exchange – Obsahuje připojení k serveru Exchange vytvořené prostřednictvím akce Připojit se k serveru Exchange.
FTP připojení – Obsahuje připojení FTP vytvořené prostřednictvím akcí Otevřít připojení FTP a Otevřít zabezpečené připojení FTP.
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.
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.
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
- 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.
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é.
Chyba
- Chyba – Obsahuje informace o poslední chybě v desktopovém toku. Tento typ proměnné vytváří akce Získat poslední chybu.