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

Типи даних змінних

  • Стаття

Коли ви створюєте змінні в своїх потоках,перетворює Power Automate їх в певний тип на основі їх вмісту.

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

Прості типи даних

Прості типи даних представляють окремі значення, такі як тексти та числа. Ці типи даних можна використовувати окремо або для створення складніших структур даних, таких як списки та таблиці даних.

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

Це будь-який вид тексту, від адрес електронної пошти до текстового вмісту файлу .txt.

Властивості текстового типу даних

Щоб створити змінну «Текстове значення », скористайтеся дією «Встановити змінну » та заповніть параметр введення потрібним текстом без будь-яких позначень.

Знімок екрана дії Set variable, яка створює змінну Text value.

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

Числовий - це тип, що застосовується до чисел. Тільки цей тип даних може бути використаний в математичних операціях.

Τo створіть змінну числового значення , скористайтеся дією Set variable і заповніть вхідний параметр числом без будь-яких позначень.

За винятком жорстко закодованих числових значень, можна використовувати математичні вирази зі змінними у відсоткових знаках. Щоб отримати додаткові відомості про математичні вирази, перейдіть до розділу Використання змінних і позначення %.

Знімок екрана дії Set variable, яка створює змінну з числовим значенням.

Логічне значення

Значення може бути як True, так і False.

Τo створіть змінну логічного значення , скористайтеся дією Встановити змінну та заповніть вхідний параметр виразами %True% або %False%.

Крім того, ви можете створювати складні вирази за допомогою логічних операторів, змінних і відсоткового позначення. Щоб отримати додаткові відомості про логічні вирази, перейдіть до розділу Використання змінних і позначення %.

Знімок екрана дії Set variable, яка створює логічний значення.

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

Розширені типи даних представляють складні структури даних. Вони функціонують як набори інших типів даних, до яких можна отримати доступ як до однієї сутності.

Список

Списки – це набори предметів. Залежно від типів окремих елементів списку можуть бути списки текстових значень, списки числових значень і так далі. Тип даних списку є еквівалентом одновимірного масиву з точки зору програмування.

Ви можете створити список за допомогою дії Створити новий список і додати елемент до цього списку за допомогою дії Додати елемент до списку .

Скріншот ланцюжка, який створює список.

Ви також можете створити список за допомогою дій, які генерують списки на виході. Наприклад, дія « Прочитати текст із файлу » може повертати список текстових значень, а дія «Отримати файли в папці » повертає список файлів.

Щоб отримати конкретний елемент у списку, використовуйте наступне позначення: %VariableName[ItemNumber]%

У наведеному нижче прикладі ланцюжок зберігає перше число раніше відображеного списку новій змінній. Майте на увазі, що індекс повинен дорівнювати 0 для першого елемента списку.

Знімок екрана виразу, який отримує доступ до першого елемента списку.

Поширеною практикою є використання пункту Для кожної дії для переходу між елементами списку.

Якщо вам потрібно отримати доступ лише до певної частини списку, використовуйте %VariableName[StartIndex:StopIndex]% notation. Наприклад, вираз %List[2:4]%отримує третій і четвертий елементи списку. Елемент у позиції StopIndex є межею зрізу і не отримується.

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

Список властивостей типу даних

Таблиця даних

Таблиці даних містять дані в табличній формі і є еквівалентом двовимірних масивів в термінах програмування.

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

Скріншот вмісту змінної таблиці даних.

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

Скріншот візуального конструктора дії Створити нову таблицю даних.

Окрім дії Створити нову таблицю даних, ще три дії створюють таблиці даних для зберігання витягнутих даних: Читати з аркуша Excel, Виконати SQL-оператор і Витягнути дані з веб-сторінки .

Крім того, ви можете створити таблицю даних, використовуючи дію змінної Set та нотацію масиву програмування. Ця нотація складається з безлічі одновимірних масивів, розділених комами і взятих у фігурні дужки. Кінцевий вираз повинен мати такий вигляд: %{[’Product1’, ’10 USD’], [’Product2’, ’20 USD’]}%.

Скріншот дії

Якщо ви хочете додати заголовки стовпців під час створення нової таблиці даних за допомогою позначення масиву, використовуйте вираз^[’ColumnName1’, ’ColumnName2’] для першого рядка.

Знімок екрана дії

Щоб додати новий рядок до наявної таблиці, скористайтеся дією Вставити рядок у таблицю даних. Або створіть вираз, що містить ім’я змінної таблиці даних, символ плюс (+) і значення, які ви хочете додати в дужках.

Знімок екрана дії

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

Щоб отримати конкретний елемент таблиці даних, використовуйте наступне позначення: %VariableName[RowNumber][ColumnNumber]%. Майте на увазі, що RowNumber і ColumnNumber повинні дорівнювати 0 для першого елемента (рядка або стовпця).

Наприклад, припустимо, що потік отримує вміст аркуша Excel і зберігає його в змінній ExcelData . Щоб отримати доступ до першої клітинки в другому рядку отриманої таблиці, використовуйте вираз, що відображається нижче.

Знімок екрана виразу, який отримує доступ до другої клітинки першого рядка прочитаного файлу Excel.

Нотатка

Змінна ExcelData містить таблицю значень, витягнутих із аркуша Excel за допомогою дії Читати з аркуша Excel. Він містить деякі значення певного аркуша, а не весь файл Excel.

Якщо ви хочете отримати доступ до певного стовпця в таблиці даних, яка містить заголовки стовпців, використовуйте %ExcelData[rowNumber][’ColumnName’]% notation.

Якщо ви переглядаєте таблицю даних із дією «Для кожного », змінна, яка містить дані поточної ітерації, вважається рядком даних.

Подібно до списків, ви використовуєте %VariableName[StartRow:StopRow]% для доступу до певної частини таблиці даних. Вираз отримує лише рядки, визначені двома індексами, тоді як позиція StopRow є межею зрізу і не отримується.

Щоб розділити таблицю даних з першого рядка на певний рядок, не використовуйте значення StartRow , наприклад, %Datatable[:4]%. Аналогічно, щоб зрізати таблицю даних від певного рядка до кінця, не використовуйте значення StopRow , наприклад, %Datatable[2:]%.

Властивості типу даних таблиці даних

Рядок даних

Рядок даних містить значення одного рядка таблиці даних. Коли ви переглядаєте таблицю даних за допомогою дії «Для кожного », змінна, яка містить дані поточної ітерації, є рядком даних.

Щоб отримати конкретний елемент рядка даних, використовуйте наступне позначення: %VariableName[ItemNumber]%

Крім того, ви можете використовувати % VariableName[’ColumnName’]% . Ім’я кожного стовпця визначається таблицею даних, з якої отримано рядок даних.

Властивості типу даних рядка даних

Скріншот вмісту змінної datarow.

Настроюваний об’єкт

Містить пари властивостей і значень, які можна легко конвертувати в формат JSON.

Щоб створити новий порожній користувацький об’єкт, скористайтеся дією Встановити змінну та заповніть наступний вираз {{ }}%%. Щоб створити новий користувацький об’єкт та ініціалізувати його властивостями та значеннями, використовуйте вираз наступної структури: %{ ’Property1’: ’Value1’, ’Property2’: ’Value2’, ’Property3’: ’Value2’ }%.

Скріншот дії Set variable, яка створює новий користувацький об’єкт.

Важливо

Зарезервовані ключові слова не можна використовувати як властивості користувацького об’єкта. Щоб переглянути повний список зарезервованих ключових слів, перейдіть до розділу Зарезервовані ключові слова в десктопних ланцюжках.

Щоб оновити значення наявної властивості або додати нову, розгорніть дію Встановити змінну , заповніть ім’я властивості в полі Набір і введіть його значення в поле Кому .

Знімок екрана дії Set variable, яка додає нову властивість до користувацького об’єкта.

Окрім літеральних значень, ви можете використовувати змінні для динамічного встановлення властивостей та значень користувацьких об’єктів. Наприклад, наведений нижче ланцюжок використовує дві змінні для додавання нової властивості до нового порожнього користувацького об’єкта.

Скріншот потоку, який використовує змінні для додавання нової властивості до кастомного об’єкта.

Об’єкт з’єднувача

Об’єкти-з’єднувачі зберігають інформацію з хмарних конекторів і працюють аналогічно користувацьким об’єктам. Їх властивості зазвичай містять списки інших об’єктів сполучника. Доступ до значень працює так само, як і в користувацьких об’єктах, хоча доступ до вкладених значень може вимагати складніших виразів.

Знімок екрана користувацької змінної об’єкта в переглядачі змінних.

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

Змінну цього типу даних можна створити лише за допомогою дії Витягнути таблиці з PDF .

Кожен елемент списку описує витягнуту таблицю та надає всю необхідну інформацію про неї. Щоб отримати доступ до певного елемента інформації про таблицю даних, використовуйте позначення % VariableName[ItemNumber]% .

Знімок екрана списку інформації про таблицю 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 (AWS)

  • Клієнт EC2– містить сеанс EC2, створений за допомогою дії Створити сеанс EC2.
  • Tекземпляр EC2– представляє отриманий екземпляр EC2.
  • Інформація про екземпляри EC2– містить інформацію про екземпляр EC2.
  • Зміна стану– містить інформацію про екземпляр EC2, який було запущено або зупинено.
  • Tзнімок EBS – являє собою знімок EBS.
  • Об’єм EBS – являє собою обсяг EBS.

Властивості типу даних AWS

Azure

  • Клієнт Azure– містить сеанс Azure, створений за допомогою дії Створити сеанс .
  • Група ресурсів Azure– представляє отриману групу ресурсів Azure.
  • Керований диск Azure– являє собою отриманий диск Azure.
  • Azure знімок– являє собою знімок в Azure.
  • Віртуальна машина Azure– являє собою отриману віртуальну машину Azure.
  • Інформація про віртуальну машину Azure– містить інформацію про віртуальну машину Azure.
  • Підписка Azure – являє собою отриману підписку Azure.

Властивості типу даних Azure

CMD

  • Сеанс CMD– містить сеанс CMD, створений за допомогою дії Відкрити сеанс CMD.

Властивості типу даних CMD

Облікові дані

  • Облікові дані– містять облікові дані, отримані за допомогою дії «Отримати облікові дані (підготовча версія)».

Властивості типу облікових даних

Дати та час

  • Datetime – містить інформацію про дату та час. Щоб створити змінну datetime за допомогою дії Set Variable , заповніть вхідний параметр виразами %d "yyyy-MM-dd HH:mm:ss.ff+zzz"%, де:

    Позначення Опис
    рррр Рік
    ММ Місяць
    Дд день
    Г.Г. година
    Мм Хвилинах
    Сс Секундах
    ФФ Мілісекундах
    ЗЗЗ Часовий пояс

    Наприклад, %d"2022-03-25"% призначає дату 25 березня 2022 року цільовій змінній.

Властивості типу даних «Дати й час»

Повідомлення електронної пошти

  • Поштове повідомлення – являє собою повідомлення електронної пошти. Дія «Отримати електронні листи» заповнює ці змінні.

Властивості типу даних електронної пошти

Exchange

  • Поштове повідомлення Exchange– являє собою повідомлення електронної пошти, отримане із сервера Exchange. Дія «Отримати повідомлення електронної пошти Exchange» заповнює ці змінні.

Властивості типу даних Exchange

Файли та папки

  • File – представляє файл.
  • Папка – представляє папку.
  • FileSystemObject – представляє папку або файл. Цей тип даних використовується у вхідних параметрах, які приймають папки та файли.

Властивості типу даних файлів і папок

FTP

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

Властивості типу даних FTP

Оптичне розпізнавання символів

  • Двигун OCR – містить механізм оптичного розпізнавання символів, створений за допомогою дії «Створити двигун оптичного розпізнавання символів».

Програма Outlook

  • Поштове повідомлення Outlook– являє собою повідомлення електронної пошти Outlook. Дія Отримати повідомлення електронної пошти з Outlook заповнює ці змінні.

Властивості типу даних Outlook

Термінал

  • Термінальний сеанс – містить сеанс терміналу, створений за допомогою дії Відкрити термінальний сеанс .

Властивості типу даних терміналу

XML

  • Вузол XML– містить вміст XML-документа. Дія «Прочитати XML з файлу » заповнює ці змінні.

Властивості типу даних XML

Помилка

  • Помилка – містить інформацію про останню виниклу помилку в настільному циклі. Дія Отримати останню помилку створює змінну цього типу.

Властивості помилки