Поделиться через


Типы данных переменных

Когда вы создаете переменные в своих потоках, Power Automate преобразует их в определенный тип на основе их содержимого.

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

Простые типы данных

Простые типы данных представляют отдельные значения, такие как тексты и числа. Вы можете использовать эти типы данных независимо друг от друга или использовать их для создания более сложных структур данных, таких как списки и таблицы данных.

Текстовое значение

Это любой вид текста, от адресов электронной почты до текстового содержимого файла .txt.

Свойства текстового типа данных

Чтобы создать переменную Текстовое значение, используйте действие Задать переменную и заполните входной параметр желаемым текстом без каких-либо обозначений.

Снимок экрана действия Задать переменную, которое создает переменную текстового значения.

Числовое значение

Тип "Числовое" применяется к числам. Только этот тип данных может использоваться в математических операциях.

Чтобы создать переменную Числовое значение, используйте действие Задать переменную и заполните входной параметр числом без каких-либо обозначений.

За исключением жестко заданных в коде числовых значений, вы можете использовать математические выражения с переменными между знаков процента. Дополнительные сведения о математических выражениях см. в статье Использование переменных и обозначения %.

Снимок экрана действия Задать переменную, которое создает переменную числового значения.

Логическое значение

Значение может быть либо Истина, либо Ложь.

Чтобы создать переменную Логическое значение, используйте действие Задать переменную и заполните входной параметр выражениями %True% или %False%.

Кроме того, вы можете создавать сложные выражения, используя логические операторы, переменные и процентную запись. Дополнительные сведения о логических выражениях см. в статье Использование переменных и обозначения %.

Снимок экрана действия Задать переменную, которое создает переменную логического значения.

Расширенные типы данных

Расширенные типы данных представляют сложные структуры данных. Они функционируют как коллекции других типов данных, к которым вы можете получить доступ как к одной сущности.

Список (List)

Списки — это коллекции элементов. В зависимости от типов отдельных элементов списка, могут быть списки текстовых значений, списки числовых значений и т. д. Тип данных списка с точки зрения программирования эквивалентен одномерному массиву.

Вы можете создать список через действие Создать новый список и добавить элемент в этот список с помощью действия Добавить элемент в список.

Снимок экрана потока, создающего список.

Вы также можете создать список с помощью действий, которые генерируют списки в качестве выводных данных. Например, действие Прочитать текст из файла может возвращать список текстовых значений, а действие Получить файлы в папке возвращает список файлов.

Чтобы получить определенный элемент в списке, используйте следующие обозначения: %VariableName[ItemNumber]%

В приведенном ниже примере поток сохраняет первое число ранее отображаемого списка в новую переменную. Имейте в виду, что индекс для первого элемента списка должен быть равен 0.

Снимок экрана выражения, которое обращается к первому элементу списка.

Обычной практикой является использование действия Для каждого для перебора элементов списка.

Если вам нужно получить доступ только к определенной части списка, используйте нотацию %VariableName[StartIndex:StopIndex]%. Например, выражение %List[2:4]% извлекает третий и четвертый элементы списка. Пункт в положении StopIndex является границей сегментации и не извлекается.

Чтобы сегментировать список от начала до определенного элемента, не устанавливайте значение StartIndex, например, %List[:4]%. Чтобы сегментировать список от определенного индекса и до конца, не устанавливайте значение StopIndex, например, %List[2:]%.

Свойства типа данных «Список»

Таблица данных (Datatable)

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

Таблица данных содержит строки и столбцы, которые однозначно описывают положение каждого элемента. Таблицы данных можно рассматривать как списки, содержащие строки данных как элементы.

Снимок экрана с содержимым переменной таблицы данных.

В Power Automate есть действие Создать новую таблицу данных для создания новых таблиц данных. После развертывания действия вы можете использовать визуальный конструктор для заполнения значений и переименования заголовков столбцов.

Снимок экрана с действием

Кроме действия Создать новую таблицу данных, есть три других действия для создания таблиц данных с целью хранения в них извлеченных данных: Прочитать из листа Excel, Выполнить инструкцию SQL и Извлечь данные с веб-страницы.

Кроме того, вы можете создать таблицу данных с помощью действия Задать переменную и обозначив нотацию массива программирования. Это обозначение состоит из нескольких одномерных массивов, разделенных запятыми и заключенных в фигурные скобки. Окончательное выражение должно иметь следующий вид: %{['Продукт1', '10 долларов США'], ['Продукт2', '20 долларов США']}%.

Снимок экрана действия Задать переменную, которое создает таблицу данных.

Если вы хотите добавить заголовки столбцов при создании новой таблицы данных с помощью нотации массива, используйте выражение ^['ColumnName1', 'ColumnName2'] для первой строки.

Снимок экрана действия Задать переменную, которое создает новую таблицу данных с заголовками столбцов.

Чтобы добавить новую строку в существующую таблицу, используйте действие Вставить строку в таблицу данных. Также можно создать выражение, содержащее имя переменной таблицы данных, знак плюса (+) и значения, которые вы хотите добавить, в скобках.

Снимок экрана действия Задать переменную, которое добавляет новую строку в таблицу данных.

Помимо вставки строк в таблицы данных, классические потоки предлагают различные действия, которые управляют таблицами данных. Вы можете найти полный список этих действий в справочнике по действиям переменных.

Чтобы получить определенный элемент таблицы данных, используйте следующие обозначения: %VariableName[RowNumber][ColumnNumber]% Имейте в виду, что RowNumber и ColumnNumber должен быть 0 для первого элемента (строки или столбца).

Например, предположим, что поток извлекает содержимое листа Excel и сохраняет его в переменной ExcelData. Чтобы получить доступ к первой ячейке второй строки полученной таблицы, используйте выражение, показанное ниже.

Снимок экрана выражения, которое получает доступ ко второй ячейке первой строки прочитанного файла Excel.

Заметка

Переменная ExcelData содержит таблицу значений, извлеченных из листа Excel с помощью действия Прочитать из листа Excel. Она содержит некоторые значения определенного листа, а не всего файла Excel.

Если вы хотите получить доступ к определенному столбцу в таблице данных, которая содержит заголовки столбцов, используйте нотацию %ExcelData[Номер_строки]['Имя_столбца']%.

Если перебирать таблицу данных с помощью действия For Each, переменная, содержащая данные текущей итерации, считается строкой данных.

Аналогично спискам, вы используете нотацию %VariableName[StartRow:StopRow]% для доступа к определенной части таблицы данных. Выражение извлекает только строки, определенные двумя индексами, в то время как позиция StopRow является границей сегментации и не извлекается.

Чтобы сегментировать таблицу данных от первой строки до определенной строки, не используйте значение StartRow, например, %Datatable[:4]%. Аналогично, чтобы сегментировать таблицу данных от определенной строки до конца, не используйте значение StopRow, например, %Datatable[2:]%.

Свойства типа данных «Таблица данных»

Строка данных

Строка данных содержит значения одной строки таблицы данных. Если вы прокрутите таблицу данных с помощью действия Для каждого, переменная, которая содержит данные текущей итерации, является строкой данных.

Чтобы получить определенный элемент строки данных, используйте следующие обозначения: %VariableName[ItemNumber]%

В качестве альтернативы вы можете использовать обозначение %VariableName['ColumnName']%. Имя каждого столбца определяется таблицей данных, из которой вы получили строку данных.

Свойства типа данных "Строка данных"

Снимок экрана с содержимым переменной строки данных.

Пользовательский объект

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

Чтобы создать новый пустой Пользовательский объект, используйте действие Задать переменную и заполните следующее выражение %{{ }}%. Чтобы создать новый Пользовательский объект и инициализировать его свойствами и значениями, используйте выражение следующей структуры: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Снимок экрана действия Задать переменную, которое создает новый настраиваемый объект.

Внимание

В качестве свойств пользовательских объектов нельзя использовать зарезервированные ключевые слова. Полный список зарезервированных ключевых слов см. в статье Зарезервированные ключевые слова в классических потоках.

Чтобы обновить значение существующего свойства или добавить новое, разверните действие Задать переменную, введите имя свойства в поле Задать и введите его значение в поле Для.

Снимок экрана действия Задать переменную, которое добавляет новое свойство в настраиваемый объект.

Помимо литеральных значений вы можете использовать переменные для динамической установки свойств и значений настраиваемых объектов. Например, в следующем потоке используются две переменные для добавления нового свойства к новому пустому настраиваемому объекту.

Снимок экрана действия потока, которое использует переменные для добавления нового свойства в настраиваемый объект.

Объект соединителя

Объекты соединителя хранят информацию из облачных соединителей и работают аналогично пользовательским объектам. Их свойства обычно содержат списки других объектов соединителей. Доступ к значениям осуществляется так же, как и в пользовательских объектах, хотя для доступа к вложенным значениям могут потребоваться более сложные выражения.

Снимок экрана переменной пользовательского объекта в средстве просмотра переменных.

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

Переменная этого типа данных может быть получена только через действие Извлечь таблицы из PDF.

Каждый элемент в списке описывает извлеченную таблицу и предоставляет всю необходимую информацию о ней. Чтобы получить доступ к определенному информационному элементу с данными, используйте нотацию %VariableName[ItemNumber]%.

Снимок экрана со списком информации о таблице PDF.

Каждый элемент списка предоставляет четыре свойства, которые позволяют независимо получать конкретную информацию. Доступные свойства:

  • DataTable — возвращает извлеченную таблицу.
  • TableStartingPage — возвращает индекс страницы файла, содержащей начало таблицы.
  • TableEndingPage — возвращает индекс страницы файла, содержащей конец таблицы.
  • TableOrderInPage — возвращает порядок таблицы на странице.

Дополнительную информацию о свойствах этого типа данных можно найти в Свойства типов данных переменных.

Снимок экрана свойств списка информации о таблице PDF.

Чтобы получить доступ к значению определенного свойства, используйте нотацию %VariableName[ItemNumber].PropertyName%. Например, следующее выражение возвращает значение таблицы данных первого элемента переменной 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.
  • Управляемый диск Azure — представляет извлеченный диск Azure.
  • Снимок Azure — представляет моментальный снимок Azure.
  • Виртуальная машина Azure — представляет полученную виртуальную машину Azure.
  • Сведения о виртуальной машине Azure — содержит информацию о виртуальной машине Azure.
  • Подписка Azure — представляет полученную подписку Azure.

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

CMD

  • Сеанс CMD — содержит сеанс CMD, созданный с помощью действия Открыть сеанс CMD.

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

Даты и время

  • Дата и время — содержит информацию о дате и времени. Чтобы создать переменную даты и времени через действие Задать переменную, заполните входной параметр выражениями %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, где:

    Представление Описание
    yyyy Год
    MM Месяц
    dd день
    HH Час
    mm Минуты
    ss Секунды
    ff Миллисекунды
    zzz Смещение от UTC

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

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

Электронное письмо

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

Свойства типа данных сообщения электронной почты

Exchange

  • Сообщение электронной почты Exchange — представляет сообщение электронной почты, полученное с сервера Exchange Server. Действие Извлечь сообщения электронной почты Exchange заполняет эти переменные.

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

Файлы и папки

  • Файл — представляет файл.
  • Папка — представляет папку.
  • FileSystemObject — представляет либо папку, либо файл. Этот тип данных используется во входных параметрах, которые принимают папки и файлы.

Свойства типов данных файлов и папок

FTP

  • FTP-файл — представляет FTP-файл.
  • Каталог FTP — представляет каталог FTP

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

Распознать текст

  • Подсистема распознавания текста — содержит подсистему распознавания текста, созданную с помощью действия Создать подсистему распознавания текста.

Outlook

  • Сообщение электронной почты Outlook — представляет сообщение электронной почты Outlook. Действие Извлечь сообщения электронной почты из Outlook заполняет эти переменные.

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

Терминал

  • Сеанс терминала — содержит сеанс терминала, созданный с помощью действия Открыть сеанс терминала.

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

XML

  • Узел XML — содержит содержимое XML-документа. Действие Прочитать XML из файла заполняет эти переменные.

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

Error

  • Ошибка — содержит информацию о последней возникшей ошибке в классическом потоке. Действие Получить последнюю ошибку создает переменную этого типа.

Свойства ошибки