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

Дії XML

  • Стаття

Power Automate надає можливість використовувати потоки робочого столу для керування атрибутами та елементами XML.

Щоб прочитати XML-файл, скористайтеся дією Read XML from file . Укажіть шлях або знайдіть файл і виберіть один із параметрів кодування.

Вибравши файл, скористайтеся дією Виконати XPath вираз , щоб виконати запит Xpath. У наведеному нижче прикладі для визначення документа використовується створена змінна з дії Read XML from file .

Скріншот дії Виконати XPath вираз.

Щоб отримати атрибут із файлу XML, скористайтеся дією Отримати атрибут XML. У наступному прикладі статус є атрибутом клієнта , який є елементомсписку клієнтів. Значення буде отримано у вигляді текстового значення.

Знімок екрана дії Get XML attribute (Отримати атрибут XML).

Аналогічно, щоб отримати значення елементів, використовуйте дію Отримати значення елемента XML. Ви можете керувати елементами та атрибутами за допомогою відповідної дії, щоб отримувати, встановлювати або видаляти атрибути або елементи XML.

Зчитати XML-дані з файлу

Зчитування вмісту XML-файлу в змінну.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Шлях до файлу No Файл Файл, який містить документ XML для зчитування
Кодування Немає Типове значення системи, ASCII, Unicode, Unicode big endian, UTF-8 За замовчуванням Кодування, яке використовується для вказаного файлу

Змінні, які створюються

Аргумент Ввести Опис
XmlDocument Вузол XML Змінна, яка містить прочитаний документ XML

Винятки

Виняток Опис
Каталог не знайдено Указує, що каталог не існує
Файл не знайдено Указує, що файл не існує
Не вдалося зчитати дані з файлу Указує на проблему під час зчитування даних із файлу
Файл не містить припустимий документ XML Указує, що файл не містить припустимий документ XML

Записати XML у файл

Запис вмісту змінної вузла XML у файлі.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Шлях до файлу No Файл Файл, який потрібно записати в документ XML
XML, який потрібно записати No Текстове значення Вузол або документ XML, який потрібно записати у файл
Кодування Немає Типове значення системи, ASCII, Unicode, Unicode big endian, UTF-8 За замовчуванням Кодування, яке використовується для вказаного файлу
Формат XML Немає Логічне значення Так Указує, чи потрібно форматувати XML
Відступ на рівень Так Числове значення 2 Указує кількість пробілів для відступу кожного рівня XML

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Указано неприпустимий каталог Указує, що зазначено неприпустимий каталог
Не вдалося записати XML у файл Указує на проблему під час записування XML у файл

Виконати XPath вираз

Витягти значення з XML-документа на основі наданого XPath запиту.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML, який потрібно проаналізувати No Текстове значення XML як текст або раніше визначена змінна, яка містить документ XML для аналізу
XPath запит No Текстове значення Вираз XPath , який потрібно виконати з XML-документом
Отримати лише перше значення Немає Логічне значення Ні Визначає, чи потрібно отримати одне значення (лише перше значення) або всі значення, які відповідають наданому XPath виразу

Змінні, які створюються

Аргумент Ввести Опис
XPathResult Вузол XML Видобуті вузли у форматі вузла XML
XPathРезультати Списоквузлів XML Видобуті вузли у форматі списку вузлів XML

Винятки

Виняток Опис
Надано неприпустимий документ XML Указує, що надано неприпустимий документ XML
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний

Отримати атрибут елемента XML

Отримання значення атрибута елемента XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ або елемент XML, атрибут якого потрібно отримати
XPath запит Так Текстове значення Вираз XPath для пошуку піделемента та отримання його атрибуту
Ім’я атрибута No Текстове значення Ім’я атрибута, значення якого потрібно отримати
Отримати значення як Немає Текстове значення, числове значення, дата-час, логічне значення Текстове значення Указує тип даних для значення атрибута

Змінні, які створюються

Аргумент Ввести Опис
XmlAttributeValue Логічне значення Отримане значення атрибута XML
XmlAttributeValue Дата-час Отримане значення атрибута XML
XmlAttributeValue Числове значення Отримане значення атрибута XML
XmlAttributeValue Текстове значення Отримане значення атрибута XML

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Атрибут не знайдено в елементі Указує, що атрибут не існує в елементі
Не вдалося перетворити значення атрибута на запитаний тип даних Указує на проблему під час перетворення значення атрибута на запитаний тип даних

Установити атрибут елемента XML

Встановлення значення атрибута елемента XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ або елемент XML, атрибут якого потрібно встановити
XPath запит Так Текстове значення Вираз XPath для пошуку піделемента та встановлення його атрибуту
Ім’я атрибута No Текстове значення Ім’я атрибута, значення якого потрібно встановити
Значення атрибута No Текстове значення Нове значення для атрибута

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Не вдалося встановити атрибут XML Вказує на проблему з налаштуванням атрибута XML

Видалити атрибут елемента XML

Видалення атрибута з елемента XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ або елемент XML, атрибут якого потрібно видалити
XPath запит Так Текстове значення Вираз XPath для пошуку піделемента та видалення його атрибута
Ім’я атрибута No Текстове значення Ім’я атрибута, який потрібно видалити

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Атрибут не знайдено в елементі Указує, що атрибут не існує в елементі
Не вдалося видалити атрибут XML Вказує на проблему з видаленням атрибута XML

Отримати значення елемента XML

Отримання значення елемента XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ або елемент XML, значення якого потрібно отримати
XPath запит Так Текстове значення Вираз XPath для пошуку піделемента та отримання його значення
Отримати значення як Немає Текстове значення, числове значення, дата-час, логічне значення Текстове значення Указує тип даних для значення елемента XML

Змінні, які створюються

Аргумент Ввести Опис
XmlElementValue Логічне значення Значення елемента XML
XmlElementValue Дата-час Значення елемента XML
XmlElementValue Числове значення Значення елемента XML
XmlElementValue Текстове значення Значення елемента XML

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Не вдалося перетворити значення елемента на запитаний тип даних Указує на проблему під час перетворення значення елемента на запитаний тип даних

Установити значення елемента XML

Встановлення значення елемента XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ або елемент XML, значення якого потрібно отримати
XPath запит Так Текстове значення Вираз XPath для пошуку піделемента та отримання його значення
Значення елемента XML No Текстове значення Нове значення для елемента XML

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Не вдалося встановити значення елемента Указує на проблему під час встановлення значення елемента

Вставити елемент XML

Вставлення нового елемента XML у документ XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ XML, у який потрібно вставити новий елемент XML
XPath запит No Текстове значення Вираз XPath для пошуку батьківського елемента XML і вставки в нього нового елемента
Елемент XML, який потрібно вставити No Вузол XML Новий елемент XML, який потрібно вставити в документ XML

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
XPath вираз не повертає жодного елемента Вказує на XPath те, що вираз не повертає жодного елемента
Не вдалося вставити елемент XML Указує на проблему під час вставлення елемента XML

Видалити елемент XML

Видалення одного або кількох елементів XML із документа XML.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Документ XML No Вузол XML Документ XML, який містить елементи XML для видалення
XPath запит No Текстове значення Вираз XPath для пошуку елементів, які потрібно вилучити

Змінні, які створюються

Ця дія не створює жодних змінних.

Винятки

Виняток Опис
Надано неприпустимий XPath вираз Вказує на XPath те, що наданий вираз некоректний
Не вдалося видалити елемент XML Указує на проблему під час видалення елемента XML