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

Действия с XML

  • Статья

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

Чтобы прочитать файл XML, используйте действие Прочитать XML из файла. Укажите путь или найдите файл и выберите один из вариантов кодирования.

После выбора файла используйте действие Выполнить выражение XPath для выполнения запроса Xpath. В следующем примере для указания документа используется созданная переменная из действия Считать XML из файла .

Снимок экрана с действием

Чтобы получить атрибут из файла XML, используйте действие Получить атрибут XML. В следующем примере status — это атрибут элемента client, который является элементом в clientlist. Значение будет получено как текстовое значение.

Снимок экрана действия Получить атрибут XML.

Точно так же, чтобы получить значения элементов, используйте действие Получить значение XML-элемента. Элементами и атрибутами можно управлять, используя соответствующее действие для получения, установки или удаления атрибутов или элементов XML.

Прочитать XML из файла

Считывает содержимое XML-файла в переменную.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Путь к файлу Нет Файл Файл, содержащий XML-документ для считывания.
Кодировка Неприменимо Системное значение по умолчанию, ASCII, Unicode, Unicode с обратным порядком байтов, UTF-8 По умолчанию Кодировка, используемая для указанного файла.

Создаваемые переменные

Аргумент Type Description
XmlDocument Узел XML Переменная, содержащая прочитанный XML-документ.

Исключения

Исключение Описание
Каталог не найден Указывает, что каталог не существует.
Файл не найден Указывает, что файл не существует.
Не удалось прочитать файл. Указывает на проблему при чтении файла.
Файл не содержит допустимый XML-документ. Указывает, что файл не содержит допустимый XML-документ.

Записать XML в файл

Записывает содержимое переменной узла XML в файл.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Путь к файлу Нет Файл Файл, в который требуется записать XML-документ.
XML для записи Нет Текстовое значение Узел XML или XML-документ, который требуется записать в файл.
Кодировка Неприменимо Системное значение по умолчанию, ASCII, Unicode, Unicode с обратным порядком байтов, UTF-8 По умолчанию Кодировка, используемая для указанного файла.
Формат XML Неприменимо Логическое значение Истина Указывает, следует ли форматировать XML.
Отступ на уровень Да Числовое значение 2 Указывает, сколько пробелов необходимо использовать для отступа каждого уровня XML.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Description
Указан недопустимый каталог. Указывает, что заданный каталог недопустим.
Не удалось выполнить запись XML в файл. Указывает на проблему при записи XML в файл.

Выполнить выражение XPath

Извлечение значений из XML-документа на основе предоставленного запроса XPath.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ для анализа Нет Текстовое значение XML в виде текста или ранее определенной переменной, содержащей XML-документ для анализа.
Запрос XPath Нет Текстовое значение Выражение XPath, которое требуется выполнить для XML-документа
Получить только первое значение Неприменимо Логическое значение False Указывает, следует ли извлечь одно значение (только первое значение) или все значения, которые соответствуют предоставленному выражению XPath

Создаваемые переменные

Аргумент Type Описание:
XPathResult Узел XML Извлеченный узел (узлы) в виде узла XML.
XPathResults Списокузлов XML Извлеченный узел (узлы) в виде списка узлов XML.

Исключения

Исключение Описание
Предоставлен недопустимый XML-документ. Указывает, что предоставленный XML-документ недопустим.
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо

Получить атрибут XML-элемента

Получает значение атрибута XML-элемента.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ или XML-элемент, атрибут которого требуется извлечь.
Запрос XPath Да Текстовое значение Выражение XPath для поиска подэлемента и извлечения его атрибута
Attribute name Нет Текстовое значение Имя атрибута, значение которого требуется извлечь.
Получить значение как Неприменимо Текстовое значение, Числовое значение, Значение даты и времени, Логическое значение Текстовое значение Указывает тип данных для значения атрибута.

Создаваемые переменные

Аргумент Type Description
XmlAttributeValue Логическое значение Извлеченное значение атрибута XML.
XmlAttributeValue Дата и время Извлеченное значение атрибута XML.
XmlAttributeValue Числовое значение Извлеченное значение атрибута XML.
XmlAttributeValue Текстовое значение Извлеченное значение атрибута XML.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Атрибут не найден в элементе. Указывает, что атрибут не существует в элементе.
Не удалось преобразовать значение атрибута в запрошенный тип данных. Указывает на проблему при преобразовании значения атрибута в запрошенный тип данных.

Задать атрибут XML-элемента

Задает значение атрибута XML-элемента.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ или XML-элемент, атрибут которого требуется задать.
Запрос XPath Да Текстовое значение Выражение XPath для поиска подэлемента и задания его атрибута
Attribute name Нет Текстовое значение Имя атрибута, значение которого требуется задать.
Значение атрибута Нет Текстовое значение Новое значение для атрибута.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Не удалось задать атрибут XML Указывает на проблему при задании атрибута XML

Удалить атрибут XML-элемента

Удаляет атрибут из XML-элемента.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ или XML-элемент, атрибут которого требуется удалить.
Запрос XPath Да Текстовое значение Выражение XPath для поиска подэлемента и удаления его атрибута
Attribute name Нет Текстовое значение Имя атрибута, который требуется удалить.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Атрибут не найден в элементе. Указывает, что атрибут не существует в элементе.
Не удалось удалить атрибут XML Указывает на проблему при удалении атрибута XML

Получить значение XML-элемента

Получает значение XML-элемента.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ или XML-элемент, значение которого требуется извлечь.
Запрос XPath Да Текстовое значение Выражение XPath для поиска подэлемента и извлечения его значения
Получить значение как Неприменимо Текстовое значение, Числовое значение, Значение даты и времени, Логическое значение Текстовое значение Указывает тип данных для значения XML-элемента.

Создаваемые переменные

Аргумент Type Description
XmlElementValue Логическое значение Значение XML-элемента.
XmlElementValue Дата и время Значение XML-элемента.
XmlElementValue Числовое значение Значение XML-элемента.
XmlElementValue Текстовое значение Значение XML-элемента.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Не удалось преобразовать значение элемента в запрошенный тип данных. Указывает на проблему при преобразовании значения элемента в запрошенный тип данных.

Задать значение XML-элемента

Задает значение XML-элемента.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ или XML-элемент, значение которого требуется извлечь.
Запрос XPath Да Текстовое значение Выражение XPath для поиска подэлемента и извлечения его значения
Значение XML-элемента Нет Текстовое значение Новое значение для XML-элемента.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Не удалось задать значение элемента. Указывает на проблему при задании значения элемента.

Вставить XML-элемент

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

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ, в который требуется вставить новый XML-элемент.
Запрос XPath Нет Текстовое значение Выражение XPath для поиска родительского XML-элемента и вставки в него нового элемента
XML-элемент для вставки Нет Узел XML Новый XML-элемент, который требуется вставить в XML-документ.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Выражение XPath не вернуло элемент Указывает, что выражение XPath не возвращает элемент
Не удалось вставить XML-элемент. Указывает на проблему при вставке XML-элемента.

Удалить XML-элемент

Удаляет один или несколько XML-элементов из XML-документа.

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
XML-документ Нет Узел XML XML-документ, содержащий один или несколько XML-элементов, которые требуется удалить.
Запрос XPath Нет Текстовое значение Выражение XPath для поиска одного или нескольких элементов, которые требуется удалить

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение Описание:
Предоставлено недопустимое выражение XPath Указывает, что предоставленное выражение XPath недопустимо
Не удалось удалить XML-элемент. Указывает на проблему при удалении XML-элемента.