XML 操作
Power Automate 提供了使用桌面流管理 XML 属性和元素的功能。
要读取 XML 文件，请使用从文件中读取 XML 操作。 指定路径或浏览文件，然后选择编码选项之一。
选择文件后，使用执行 XPath 表达式操作运行 Xpath 查询。 以下示例使用从文件中读取 XML 操作中生成的变量指定文档。
若要从 XML 文件中检索属性，请使用获取 XML 属性操作。 在以下示例中，状态是客户端的一个属性，此属性是客户端列表的一个元素。 该值将获取为文本值。
同样，若要检索元素值，请使用获取 XML 元素值操作。 您可以使用相应的操作来获取、设置或删除 XML 属性或元素来管理元素和属性。
从文件中读取 XML
将 XML 文件的内容读取到变量中。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| 文件路径 |
否 |
文件 |
|
包含要读取的 XML 文档的文件 |
| 编码 |
不适用 |
系统默认值、ASCII、Unicode、Unicode big endian、UTF-8 |
系统默认值 |
用于所指定文件的编码 |
生成的变量
| 参数 |
类型 |
说明 |
| XmlDocument |
XML 节点 |
保存所读取 XML 文档的变量 |
异常
| 例外 |
描述 |
| 找不到目录 |
指示目录不存在 |
| 未找到文件 |
指示文件不存在 |
| 无法从文件中读取 |
指示从文件中读取时出现问题 |
| 文件不包含有效的 XML 文档 |
指示该文件不包含有效的 XML 文档 |
将 XML 写入文件
将 XML 节点变量的内容写入文件中。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| 文件路径 |
否 |
文件 |
|
要将 XML 文档写入到其中的文件 |
| 要写入的 XML |
否 |
文本值 |
|
要写入文件中的 XML 节点或文档 |
| 编码 |
不适用 |
系统默认值、ASCII、Unicode、Unicode big endian、UTF-8 |
系统默认值 |
用于所指定文件的编码 |
| 格式 XML |
不适用 |
布尔值 |
TRUE |
指定是否设置 XML 的格式 |
| 每个级别的缩进 |
是 |
数值 |
2 |
指定要对 XML 的每个级别缩进的空格数 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 指定的目录无效 |
指示所指定的目录无效 |
| 无法将 XML 写入文件 |
指示将 XML 写入文件时出现问题 |
执行 XPath 表达式
基于所提供的 XPath 查询从 XML 文档中提取值。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| 要分析的 XML 文档 |
否 |
文本值 |
|
文本形式的 XML 或以前定义的变量，包含要分析的 XML 文档 |
| XPath 查询 |
否 |
文本值 |
|
要针对 XML 文档执行的 XPath 表达式 |
| 仅获取第一个值 |
不适用 |
布尔值 |
False |
指定要检索与所提供的 XPath 表达式匹配的单个值（仅第一个值）还是所有值 |
生成的变量
| 参数 |
类型 |
说明 |
| XPathResult |
XML 节点 |
作为 XML 节点的已提取节点 |
| XPathResults |
XML 节点列表 |
作为 XML 节点列表的已提取节点 |
异常
| 例外 |
描述 |
| 提供的 XML 文档无效 |
指示所提供的 XML 文档无效 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
获取 XML 元素属性
获取 XML 元素的属性的值。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要检索其属性的 XML 文档或 XML 元素 |
| XPath 查询 |
是 |
文本值 |
|
用于查找子元素并检索其属性的 XPath 表达式 |
| Attribute name |
否 |
文本值 |
|
要检索其值的属性的名称 |
| 获取值用作 |
不适用 |
文本值、数值、日期/时间值、布尔值 |
文本值 |
指定属性值的数据类型 |
生成的变量
| 参数 |
类型 |
说明 |
| XmlAttributeValue |
布尔值 |
检索到的 XML 属性的值 |
| XmlAttributeValue |
日期/时间 |
检索到的 XML 属性的值 |
| XmlAttributeValue |
数值 |
检索到的 XML 属性的值 |
| XmlAttributeValue |
文本值 |
检索到的 XML 属性的值 |
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 未在元素中找到属性 |
指示元素中不存在该属性 |
| 无法将属性值转换为所请求的数据类型 |
指示将属性值转换为所请求的数据类型时出现问题 |
设置 XML 元素属性
设置 XML 元素的属性的值。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要设置其属性的 XML 文档或 XML 元素 |
| XPath 查询 |
是 |
文本值 |
|
用于查找子元素并设置其属性的 XPath 表达式 |
| Attribute name |
否 |
文本值 |
|
要设置其值的属性的名称 |
| 属性值 |
否 |
文本值 |
|
属性的新值 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 无法设置 XML 属性 |
指示设置 XML 属性时出现问题 |
删除 XML 元素属性
从 XML 元素中删除属性。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要删除其属性的 XML 文档或 XML 元素 |
| XPath 查询 |
是 |
文本值 |
|
用于查找子元素并删除其属性的 XPath 表达式 |
| Attribute name |
否 |
文本值 |
|
要删除的属性的名称 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 未在元素中找到属性 |
指示元素中不存在该属性 |
| 无法删除 XML 属性 |
指示删除 XML 属性时出现问题 |
获取 XML 元素值
获取 XML 元素的值。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要检索其值的 XML 文档或 XML 元素 |
| XPath 查询 |
是 |
文本值 |
|
用于查找子元素并检索其值的 XPath 表达式 |
| 获取值用作 |
不可用 |
文本值、数值、日期/时间值、布尔值 |
文本值 |
指定 XML 元素值的数据类型 |
生成的变量
| 参数 |
类型 |
说明 |
| XmlElementValue |
布尔值 |
XML 元素值 |
| XmlElementValue |
日期/时间 |
XML 元素值 |
| XmlElementValue |
数值 |
XML 元素值 |
| XmlElementValue |
文本值 |
XML 元素值 |
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 无法将元素值转换为所请求的数据类型 |
指示将元素值转换为所请求的数据类型时出现问题 |
设置 XML 元素值
设置 XML 元素的值。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要检索其值的 XML 文档或 XML 元素 |
| XPath 查询 |
是 |
文本值 |
|
用于查找子元素并检索其值的 XPath 表达式 |
| XML 元素值 |
否 |
文本值 |
|
XML 元素的新值 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 无法设置元素值 |
指示设置元素值时出现问题 |
插入 XML 元素
在 XML 文档中插入新的 XML 元素。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
要插入新 XML 元素的 XML 文档 |
| XPath 查询 |
否 |
文本值 |
|
用于查找父 XML 元素并将新元素插入到其中的 XPath 表达式 |
| 要插入的 XML 元素 |
否 |
XML 节点 |
|
要插入到 XML 文档中的新 XML 元素 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| XPath 表达式未返回任何元素 |
指示 XPath 表达式未返回任何元素 |
| 无法插入 XML 元素 |
指示插入 XML 元素时出现问题 |
删除 XML 元素
从 XML 文档中删除一个或多个 XML 元素。
| 参数 |
可选 |
接受 |
默认值 |
说明 |
| XML 文档 |
否 |
XML 节点 |
|
包含要删除的 XML 元素的 XML 文档 |
| XPath 查询 |
否 |
文本值 |
|
用于查找要删除的元素的 XPath 表达式 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 |
说明 |
| 提供的 XPath 表达式无效 |
指示所提供的 XPath 表达式无效 |
| 无法删除 XML 元素 |
指示删除 XML 元素时出现问题 |