Типы данных переменных
Когда вы создаете переменные в своих потоках, 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. Чтобы получить доступ к первой ячейке второй строки полученной таблицы, используйте выражение, показанное ниже.
Заметка
Переменная 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]%.
Каждый элемент списка предоставляет четыре свойства, которые позволяют независимо получать конкретную информацию. Доступные свойства:
- DataTable — возвращает извлеченную таблицу.
- TableStartingPage — возвращает индекс страницы файла, содержащей начало таблицы.
- TableEndingPage — возвращает индекс страницы файла, содержащей конец таблицы.
- TableOrderInPage — возвращает порядок таблицы на странице.
Дополнительную информацию о свойствах этого типа данных можно найти в Свойства типов данных переменных.
Чтобы получить доступ к значению определенного свойства, используйте нотацию %VariableName[ItemNumber].PropertyName%. Например, следующее выражение возвращает значение таблицы данных первого элемента переменной ExtractedPDFTables.
Известные проблемы и ограничения
- Проблема: когда ячейка таблицы данных или строки данных содержит многострочную запись, средство просмотра переменных отображает только первую ее строку.
- Обходные пути: нет.
Экземпляры
Экземпляр веб-браузера — содержит экземпляр браузера, созданный с помощью действия Запустить новый Internet Explorer или другие действия запуска браузера.
Экземпляр окна — содержит экземпляр окна, созданный с помощью действия Получить окно.
Экземпляр Excel — содержит экземпляр Excel, созданный с помощью действия Запустить Excel.
Экземпляр Outlook — содержит экземпляр Outlook, созданный с помощью действия Запустить Outlook.
Связи
Подключение SQL — содержит подключение к базе данных SQL, установленное через действие Открыть подключение SQL.
Подключение к Exchange — содержит подключение к серверу Exchange Server, установленное через действие Подключиться к серверу Exchange Server.
Подключение FTP — Содержит подключение FTP, созданное с помощью действий Открыть подключение FTP и Отрыть защищенное подключение FTP.
Прочее
В этом разделе представлены все доступные типы данных, которые не принадлежат ни к одной из предыдущих категорий.
Общее значение
- Общее значение — этот тип данных используется во время разработки, когда 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.
Azure
- Клиент Azure — содержит сеанс Azure, созданный с помощью действия Создать сеанс Azure.
- Группа ресурсов Azure — представляет полученную группу ресурсов Azure.
- Управляемый диск Azure — представляет извлеченный диск Azure.
- Снимок Azure — представляет моментальный снимок Azure.
- Виртуальная машина Azure — представляет полученную виртуальную машину Azure.
- Сведения о виртуальной машине Azure — содержит информацию о виртуальной машине Azure.
- Подписка Azure — представляет полученную подписку Azure.
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 заполняет эти переменные.
Файлы и папки
- Файл — представляет файл.
- Папка — представляет папку.
- FileSystemObject — представляет либо папку, либо файл. Этот тип данных используется во входных параметрах, которые принимают папки и файлы.
Свойства типов данных файлов и папок
FTP
- FTP-файл — представляет FTP-файл.
- Каталог FTP — представляет каталог FTP
Распознать текст
- Подсистема распознавания текста — содержит подсистему распознавания текста, созданную с помощью действия Создать подсистему распознавания текста.
Outlook
- Сообщение электронной почты Outlook — представляет сообщение электронной почты Outlook. Действие Извлечь сообщения электронной почты из Outlook заполняет эти переменные.
Терминал
- Сеанс терминала — содержит сеанс терминала, созданный с помощью действия Открыть сеанс терминала.
Свойства типа данных терминала
XML
- Узел XML — содержит содержимое XML-документа. Действие Прочитать XML из файла заполняет эти переменные.
Error
- Ошибка — содержит информацию о последней возникшей ошибке в классическом потоке. Действие Получить последнюю ошибку создает переменную этого типа.