Типи даних змінних
Коли ви створюєте змінні в своїх потоках,перетворює Power Automate їх в певний тип на основі їх вмісту.
Деякі з цих типів даних широко використовуються в програмі, наприклад числа , тоді якінші, такі як екземпляри браузера, вимагають явних дій або груп дій.
Прості типи даних
Прості типи даних представляють окремі значення, такі як тексти та числа. Ці типи даних можна використовувати окремо або для створення складніших структур даних, таких як списки та таблиці даних.
Текстове значення
Це будь-який вид тексту, від адрес електронної пошти до текстового вмісту файлу .txt.
Властивості текстового типу даних
Щоб створити змінну «Текстове значення », скористайтеся дією «Встановити змінну » та заповніть параметр введення потрібним текстом без будь-яких позначень.
Числове значення
Числовий - це тип, що застосовується до чисел. Тільки цей тип даних може бути використаний в математичних операціях.
Τo створіть змінну числового значення , скористайтеся дією Set variable і заповніть вхідний параметр числом без будь-яких позначень.
За винятком жорстко закодованих числових значень, можна використовувати математичні вирази зі змінними у відсоткових знаках. Щоб отримати додаткові відомості про математичні вирази, перейдіть до розділу Використання змінних і позначення %.
Логічне значення
Значення може бути як True, так і False.
Τo створіть змінну логічного значення , скористайтеся дією Встановити змінну та заповніть вхідний параметр виразами %True% або %False%.
Крім того, ви можете створювати складні вирази за допомогою логічних операторів, змінних і відсоткового позначення. Щоб отримати додаткові відомості про логічні вирази, перейдіть до розділу Використання змінних і позначення %.
Розширені типи даних
Розширені типи даних представляють складні структури даних. Вони функціонують як набори інших типів даних, до яких можна отримати доступ як до однієї сутності.
Список
Списки – це набори предметів. Залежно від типів окремих елементів списку можуть бути списки текстових значень, списки числових значень і так далі. Тип даних списку є еквівалентом одновимірного масиву з точки зору програмування.
Ви можете створити список за допомогою дії Створити новий список і додати елемент до цього списку за допомогою дії Додати елемент до списку .
Ви також можете створити список за допомогою дій, які генерують списки на виході. Наприклад, дія « Прочитати текст із файлу » може повертати список текстових значень, а дія «Отримати файли в папці » повертає список файлів.
Щоб отримати конкретний елемент у списку, використовуйте наступне позначення: %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 . Щоб отримати доступ до першої клітинки в другому рядку отриманої таблиці, використовуйте вираз, що відображається нижче.
Нотатка
Змінна ExcelData містить таблицю значень, витягнутих із аркуша Excel за допомогою дії Читати з аркуша Excel. Він містить деякі значення певного аркуша, а не весь файл Excel.
Якщо ви хочете отримати доступ до певного стовпця в таблиці даних, яка містить заголовки стовпців, використовуйте %ExcelData[rowNumber][’ColumnName’]% notation.
Якщо ви переглядаєте таблицю даних із дією «Для кожного », змінна, яка містить дані поточної ітерації, вважається рядком даних.
Подібно до списків, ви використовуєте %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%notation . Наприклад, наведений нижче вираз повертає значення таблиці даних першого елемента змінної ExtractedPDFTables .
Відомі проблеми й обмеження
- Проблема: якщо клітинка таблиці даних або рядка даних містить багаторядковий запис, переглядач змінних відображає лише перший рядок із них.
- Обхідні шляхи: Немає.
Екземпляри
екземпляр веб-браузера– містить екземпляр браузера, створений за допомогою дій із запуску нового Internet Explorer або інших дій із запуску браузера.
Tекземпляр вікна– містить екземпляр вікна, створений за допомогою дії «Отримати вікно ».
екземпляр Excel– містить екземпляр Excel, створений за допомогою дії «Запустити Excel ».
екземпляр Outlook– містить екземпляр Outlook, створений за допомогою дії «Запустити Outlook ».
Зв’язки
З’єднання SQL– містить з’єднання з базою даних SQL, встановлене за допомогою дії Відкрити з’єднання SQL.
Підключення до Exchange– містить підключення до сервера Exchange, встановлене за допомогою дії Підключитися до сервера Exchange.
З’єднання FTP– містить з’єднання FTP, створене за допомогою дій Відкрити з’єднання FTP і Відкрити безпечне з’єднання FTP.
Інше
У цьому розділі представлені всі доступні типи даних, які не належать до жодної з попередніх категорій.
Загальне значення
- Загальне значення – цей тип даних використовується під час проектування, коли 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.
Azure
- Клієнт Azure– містить сеанс Azure, створений за допомогою дії Створити сеанс .
- Група ресурсів Azure– представляє отриману групу ресурсів Azure.
- Керований диск Azure– являє собою отриманий диск Azure.
- Azure знімок– являє собою знімок в Azure.
- Віртуальна машина Azure– являє собою отриману віртуальну машину Azure.
- Інформація про віртуальну машину Azure– містить інформацію про віртуальну машину Azure.
- Підписка Azure – являє собою отриману підписку Azure.
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
Оптичне розпізнавання символів
- Двигун OCR – містить механізм оптичного розпізнавання символів, створений за допомогою дії «Створити двигун оптичного розпізнавання символів».
Програма Outlook
- Поштове повідомлення Outlook– являє собою повідомлення електронної пошти Outlook. Дія Отримати повідомлення електронної пошти з Outlook заповнює ці змінні.
Властивості типу даних Outlook
Термінал
- Термінальний сеанс – містить сеанс терміналу, створений за допомогою дії Відкрити термінальний сеанс .
Властивості типу даних терміналу
XML
- Вузол XML– містить вміст XML-документа. Дія «Прочитати XML з файлу » заповнює ці змінні.
Помилка
- Помилка – містить інформацію про останню виниклу помилку в настільному циклі. Дія Отримати останню помилку створює змінну цього типу.