Споделяне чрез

Типове на данните за променливи

  • Статия

Когато създавате променливи във вашите потоци, Power Automate ги преобразува в определен тип въз основа на тяхното съдържание.

Някои от тези типове данни се използват широко в приложението, като числа, докато други, като например екземпляри на браузъра, изискват изрични действия или групи от действия.

Прости типове данни

Простите типове данни представляват единични стойности, като например текстове и числа. Можете да използвате тези типове данни самостоятелно или да ги използвате за създаване на по-сложни структури от данни, като например списъци и таблици с данни.

Текстова стойност

Това е всякакъв вид текст, от имейл адреси до текстово съдържание на .txt файл.

Свойства на текстовия тип данни

За да създадете променлива с текстова стойност , използвайте действието Задаване на променлива и попълнете входния параметър с желания текст без никаква нотация.

Екранна снимка на действие Задаване на променлива, което създава променлива Текстова стойност.

Числова стойност

Числов е типът, приложен към числата. Само този тип данни може да се използва в математически операции.

За да създадете променлива с числова стойност , използвайте действието Задаване на променлива и попълнете входния параметър с число без никаква нотация.

С изключение на твърдо кодирани числови стойности, можете да използвате математически изрази с променливи в рамките на процентните знаци. За повече информация относно математическите изрази отидете на Използване на променливи и нотацията %.

Екранна снимка на действие Задаване на променлива, което създава променлива с числова стойност.

Булева стойност

Стойността може да бъде True или False.

За да създадете булева променлива стойност , използвайте действието Задаване на променлива и попълнете входния параметър с изразите %True% или %False%.

Освен това можете да създавате сложни изрази с помощта на логически оператори, променливи и процентна нотация. За повече информация относно логическите изрази отидете на Използване на променливи и % нотацията.

Екранна снимка на действие Задаване на променлива, което създава булева променлива стойност.

Разширени типове данни

Разширените типове данни представляват сложни структури от данни. Те функционират като колекции от други типове данни, до които можете да получите достъп като един обект.

Списък

Списъците са колекции от предмети. В зависимост от типовете на отделните елементи от списъка може да има списъци с текстови стойности, списъци с числови стойности и т.н. Типът данни на списъка е еквивалентен на едномерен масив от гледна точка на програмирането.

Можете да създадете списък чрез действието Създаване на нов списък и да добавите елемент към този списък чрез действието Добавяне на елемент към списък .

Екранна снимка на поток, който създава списък.

Можете също да създадете списък чрез действия, които генерират списъци като изход. Например действието Четене на текст от файл може да върне списък със стойности на текста, а действието Получаване на файлове в папка връща списък с файлове.

За да извлечете конкретен елемент в списък, използвайте следната нотация: %VariableName[ItemNumber]%

В примера по-долу потокът съхранява първото число от показания по-рано списък в нова променлива. Имайте предвид, че индексът трябва да бъде 0 за първия елемент от списъка.

Екранна снимка на израз, който осъществява достъп до първия елемент от списък.

Често срещана практика е да използвате действие For every за итерация през елементите на списъка.

Ако трябва да получите достъп само до определена част от списък, използвайте %VariableName[StartIndex:StopIndex]% notation. Например изразът %List[2:4]% извлича третия и четвъртия елемент от списъка. Елементът в позицията StopIndex е границата на нарязването и не се извлича.

За да разрежете списък от началото до конкретен елемент, не задавайте стойност на StartIndex , например %List[:4]%. За да отрежете списък от конкретен индекс до края, не задавайте стойност на StopIndex , например %List[2:]%.

Списък със свойства на типа данни

Таблица с данни

Таблиците с данни съдържат данни в таблична форма и са еквивалентни на двуизмерни масиви от гледна точка на програмирането.

Таблицата с данни съдържа редове и колони, които описват позицията на всеки елемент по уникален начин. Таблиците с данни могат да се разглеждат като списъци, които съдържат редове с данни като елементи.

Екранна снимка на съдържанието на променлива с таблица с данни.

Power Automate предоставя действието Създаване на нова таблица с данни за генериране на нови таблици с данни. След като разположите действието, можете да използвате визуалния конструктор, за да попълните стойности и да преименувате заглавките на колоните.

Екранна снимка на визуалния конструктор на действието Създаване на нова таблица с данни.

Освен действието Създаване на нова таблица с данни, още три действия създават таблици с данни за съхраняване на извлечени данни: работен лист Четенеот Excel, Изпълнение на SQL команда и Извличане на данни от действия на уеб страница .

Освен това можете да създадете таблица с данни, като използвате действието Задаване на променлива и нотацията на програмния масив. Тази нотация се състои от множество едномерни масиви, разделени със запетаи и затворени във къдрави скоби. Крайният израз трябва да има следната форма: %{['Продукт1', '10 USD'], ['Продукт2', '20 USD']}%.

Екранна снимка на действието Задаване на променлива, което създава таблица с данни.

Ако искате да добавите заглавки на колони, докато създавате нова таблица с данни с помощта на нотацията на масива, използвайте ^['ColumnName1', 'ColumnName2'] израза за първия ред.

Екранна снимка на действие Задаване на променлива, което създава нова таблица с данни със заглавки на колони.

За да добавите нов ред към съществуваща таблица, използвайте действието Вмъкване на ред в таблица с данни. Друга възможност е да създадете израз, съдържащ името на променливата на таблицата с данни, знак плюс (+) и стойностите, които искате да добавите в скоби.

Екранна снимка на действие Задаване на променлива, което добавя нов ред към таблица с данни.

Освен вмъкване на редове в таблици с данни, потоците на работния плот предлагат различни действия, които манипулират таблиците с данни. Можете да намерите пълен списък с тези действия в справката запроменливи действия.

За да извлечете конкретен елемент от таблица с данни, използвайте следната нотация: %VariableName[RowNumber][ColumnNumber]%. Имайте предвид, че RowNumber и ColumnNumber трябва да са 0 за първия елемент (ред или колона).

Да предположим например, че поток извлича съдържанието на работен лист на Excel и го съхранява в променливата ExcelData . За достъп до първата клетка на втория ред на извлечената таблица използвайте израза, показан по-долу.

Екранна снимка на израз, който осъществява достъп до втората клетка на първия ред на прочетен файл на Excel.

Бележка

Променливата ExcelData съдържа таблица със стойности, извлечени от работен лист на Excel с помощта на действието Четене от работен лист на Excel. Той съдържа някои стойности на конкретен работен лист, а не целия файл на Excel.

Ако искате да получите достъп до конкретна колона в датируема, която съдържа заглавки на колони, използвайте %ExcelData[rowNumber]['ColumnName']% notation.

Ако преминете през таблица с данни с действие "За всеки ", променливата, която съдържа данните на текущата итерация, се счита за ред с данни.

Подобно на списъците, вие използвате %VariableName[StartRow:StopRow]% notation за достъп до определена част от таблица с данни. Изразът извлича само редовете, дефинирани от двата индекса, докато позицията StopRow е границата на нарязването и не се извлича.

За да разделите таблица с данни от първия ред на конкретен ред, не използвайте стойност на StartRow , например %Datatable[:4]%. По същия начин, за да отрежете таблица с данни от конкретен ред до края, не използвайте стойност на StopRow , например %Datatable[2:]%.

Свойства на типа данни на таблица с данни

Ред с данни

Редът с данни съдържа стойностите на един ред от таблица с данни. Когато преминавате през таблица с данни с действие "За всеки ", променливата, която съдържа данните на текущата итерация, е ред с данни.

За да извлечете конкретен елемент от ред данни, използвайте следната нотация: %Име на[ItemNumber] променливата%

Като алтернатива можете да използвате %VariableName['ColumnName']% notation. Името на всяка колона се определя от таблицата с данни, от която сте извлекли реда с данни.

Свойства на типа данни на ред данни

Екранна снимка на съдържанието на променлива на ред данни.

Персонализиран обект

Съдържа двойки свойства и стойности, които могат лесно да бъдат преобразувани във формат JSON.

За да създадете нов празен обект по избор, използвайте действието Задаване на променлива и попълнете следния израз %{{ }}%. За да създадете нов Custom обект и да го инициализирате със свойства и стойности, използвайте израз със следната структура: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Екранна снимка на действие Задаване на променлива, което създава нов персонализиран обект.

Важно

Запазените ключови думи не могат да се използват като свойства на персонализиран обект. За пълния списък със запазени ключови думи отидете на Запазени ключови думи в потоци на работния плот.

За да актуализирате стойността на съществуващо свойство или да добавите ново, разположете действие Задаване на променлива , попълнете името на свойството в полето Задаване и въведете стойността му в полето До .

Екранна снимка на действие Задаване на променлива, което добавя ново свойство към персонализиран обект.

Освен литерални стойности, можете да използвате променливи за динамично задаване на свойствата и стойностите на персонализирани обекти. Например следният поток използва две променливи, за да добави ново свойство към нов празен персонализиран обект.

Екранна снимка на поток, който използва променливи за добавяне на ново свойство към персонализиран обект.

Обект конектор

Конекторните обекти съхраняват информация от облачните конектори и работят подобно на персонализираните обекти. Техните свойства обикновено съдържат списъци с други свързващи обекти. Достъпът до стойности работи като в персонализирани обекти, въпреки че достъпът до вложени стойности може да изисква по-сложни изрази.

Екранна снимка на персонализирана обектна променлива във визуализатора на променливи.

Списък на информацията за PDF таблицата

Променлива от този тип данни може да бъде създадена само чрез действието Извличане на таблици от PDF .

Всеки елемент от списъка описва извлечена таблица и предоставя цялата важна информация за нея. За достъп до конкретен информационен елемент на таблица с данни използвайте %VariableName[ItemNumber]% notation.

Екранна снимка на списък с информация за PDF таблица.

Всеки елемент от списъка предоставя четири свойства, които ви позволяват да получите конкретен детайл независимо. Наличните имоти са следните:

  • DataTable – Връща извлечената таблица.
  • TableStartingPage – Връща индекса на файловата страница, която съдържа началото на таблицата.
  • TableEndingPage – Връща индекса на файловата страница, която съдържа края на таблицата.
  • TableOrderInPage – Връща реда на таблицата на страницата.

Можете да намерите повече информация относно свойствата на този тип данни в Свойства на типа данни Променливи.

Екранна снимка на свойствата на списък с информация за PDF таблица.

За достъп до стойността на конкретно свойство използвайте %VariableName[ItemNumber]. PropertyName% notation. Например следният израз връща стойността на таблицата с данни на първия елемент от променливата ExtractedPDFTables .

Екранна снимка на таблицата с данни, съдържаща се в списък с информационни променливи на PDF таблица.

Известни проблеми и ограничения

  • Проблем: Когато таблица с данни или клетка от ред данни съдържа многоредов запис, визуализаторът на променливата показва само първия ред от него.
  • Заобиколни решения: Няма.

Екземпляри

Връзки

Други

Този раздел представя всички налични типове данни, които не принадлежат към нито една от предишните категории.

Обща стойност

  • Обща стойност – Този тип данни се използва по време на проектиране, когато Power Automate не може да се дефинира типът данни на променлива или входен параметър. Общите стойности се преобразуват в други типове данни по време на изпълнение въз основа на техните данни.

Active Directory

  • Запис в Active Directory– Съдържа връзка към сървър на Active Directory, създадена чрез действието Свързване към сървъра .
  • Информация за групата– Съдържа името, показваното име, описание и членовете на определена група в Active Directory.
  • Член на група– Представлява член на определена група на Active Directory.
  • Информация за потребителя – Съдържа информация за определен потребител на Active Directory, като име и фамилно име, инициали и отличително име, подробности за работата (фирма, отдел и длъжност), информация за контакт (телефонен номер, вътрешен номер и имейл) и местоположение (държава/регион, град, щат, уличен адрес и пощенски код).

Свойства на типа данни на Active Directory

Amazon Web Services (AWS)

  • EC2 клиент – Съдържа EC2 сесия, създадена чрез действието Създаване на EC2 сесия .
  • EC2 екземпляр – Представлява извлечен EC2 екземпляр.
  • Информация за екземпляри на EC2 – Съдържа информация за екземпляр EC2.
  • Промяна на състоянието на екземпляра– Съдържа информация за EC2 екземпляр, който е стартиран или спрян.
  • EBS моментна снимка – Представлява EBS моментна снимка.
  • Обем на EBS– Представлява обем на EBS.

Свойства на типа данни на AWS

Azure

  • Клиент на Azure– Съдържа сесия на Azure, създадена чрез действието Създаване на сесия .
  • Група ресурси на Azure– Представлява извлечена група ресурси на Azure.
  • Azure managed disk – Представлява извлечен диск на Azure.
  • Azure моментна снимка – Представлява моментна снимка на Azure.
  • Виртуална машина Azure– Представлява извлечена виртуална машина на Azure.
  • Информация за виртуална машина на Azure– Съдържа информация за виртуална машина на Azure.
  • Абонамент за Azure– Представлява извлечен абонамент за Azure.

Свойства на типа данни на Azure

CMD

  • CMD сесия – Съдържа CMD сесия, създадена чрез действието Отваряне на CMD сесия .

Свойства на типа данни на CMD

Идентификационни данни

  • Идентификационни данни – Съдържа идентификационни данни, извлечени чрез действието Получаване на идентификационни данни (преглед ).

Свойства на типа данни за идентификационни данни

Дати и час

  • Datetime – Съдържа информация за дата и час. За да създадете променлива за дата и час чрез действието Задаване на променлива , попълнете входния параметър с изразите %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, където:

    Нотация Описание
    гггг Година
    ММ Месец
    дд Ден
    HH Час
    Мм Минути
    СС Секунди
    ff Милисекунди
    zzz UTC часова разлика

    Например %d "2022-03-25"% присвоява датата 25 март 2022 г. на целевата променлива.

Свойства на типа данни за дати и час

Имейл адрес

  • Имейл съобщение – Представлява имейл съобщение. Действието Извличане на имейли попълва тези променливи.

Свойства на типа данни за имейл

Exchange

  • Имейл съобщение на Exchange – Представлява имейл съобщение, извлечено от сървър на Exchange. Действието Извличане на имейл съобщения на Exchange попълва тези променливи.

Свойства на типа данни на Exchange

Файлове и папки

  • Файл – Представлява файл.
  • Папка – Представлява папка.
  • FileSystemObject – Представлява папка или файл. Този тип данни се използва във входни параметри, които приемат папки и файлове.

Свойства на типа данни за файлове и папки

FTP

  • FTP файл – Представлява FTP файл.
  • FTP директория – Представлява FTP директория

Свойства на типа данни на FTP

OCR

  • OCR двигател – Съдържа OCR двигател, създаден чрез действието Създаване на OCR двигател .

Outlook

  • Имейл съобщение на Outlook – Представлява имейл съобщение на Outlook. Действието Извличане на имейл съобщения от Outlook попълва тези променливи.

Свойства на типа данни на Outlook

Терминал

  • Терминална сесия – Съдържа терминална сесия, създадена чрез действието Отваряне на терминалната сесия .

Свойства на типа данни на терминала

XML

  • XML възел – Съдържа съдържанието на XML документ. Действието Четене на XML от файл попълва тези променливи.

Свойства на типа данни на XML

Грешка

  • Грешка – Съдържа информация за последната възникнала грешка в потока за работен плот. Действието Получаване на последна грешка създава този тип променлива.

Свойства на грешка