Дії XML
Стаття
06/21/2023
Співавторів: 8
Зворотний зв’язок
Зміст статті
Power Automate надає можливість використовувати потоки робочого столу для керування атрибутами та елементами XML.
Щоб прочитати XML-файл, скористайтеся дією Read XML from file . Укажіть шлях або знайдіть файл і виберіть один із параметрів кодування.
Вибравши файл, скористайтеся дією Виконати XPath вираз , щоб виконати запит Xpath. У наведеному нижче прикладі для визначення документа використовується створена змінна з дії Read XML from file .
Щоб отримати атрибут із файлу XML, скористайтеся дією Отримати атрибут 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
Текстове значення Ім’я атрибута, значення якого потрібно отримати
Отримати значення як
Немає
Текстове значення, числове значення, дата-час, логічне значення
Текстове значення
Указує тип даних для значення атрибута
Змінні, які створюються
Винятки
Виняток
Опис
Надано неприпустимий 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
Змінні, які створюються
Винятки
Виняток
Опис
Надано неприпустимий 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
