XML 動作
Power Automate 提供使用桌面流程管理 XML 屬性和元素的功能。
若要讀取 XML 檔案，請使用從檔案讀取 XML 動作。 指定路徑或瀏覽檔案，然後選取其中一種編碼選項。
選取檔案後，請使用執行 XPath 運算式動作來執行 Xpath 查詢。 下列範例使用來自從檔案讀取 XML 動作所產生的變數來指定文件。
若要從 XML 檔案擷取屬性，請使用取得 XML 屬性動作。 在下列範例中，狀態是用戶端的屬性，屬於用戶端清單的元素。 該值將做為文字值取得。
![[取得 XML 屬性] 動作的螢幕擷取畫面。](media/xml/get-xml-attribute-example.png)
同樣地，若要擷取元素值，請使用取得 XML 元素值動作。 您可以管理元素或屬性，使用相應動作來取得、設定或移除 XML 屬性或元素。
從檔案讀取 XML
將 XML 檔案的內容讀取至變數中。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| 檔案路徑 |
否 |
檔案 |
|
包含要讀取的 XML 文件的檔案 |
| 編碼 |
N/A |
系統預設、ASCII、Unicode、Unicode big-endian、UTF-8 |
系統預設 |
指定的檔案所使用的編碼 |
變數已產生
| 引數 |
類型 |
描述 |
| XmlDocument |
XML 節點 |
包含所讀取 XML 文件的變數 |
例外狀況
| 例外 |
描述 |
| 找不到目錄 |
指出目錄不存在 |
| 找不到檔案 |
指示檔案不存在 |
| 無法從檔案讀取 |
指出從檔案讀取時發生問題 |
| 檔案未包含有效的 XML 文件 |
指出檔案未包含有效的 XML 文件 |
將 XML 寫入檔案中
將 XML 節點變數的內容寫入檔案中。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| 檔案路徑 |
否 |
檔案 |
|
要在其中寫入 XML 文件的檔案 |
| 要寫入的 XML |
否 |
文字值 |
|
要寫入檔案中的 XML 節點或文件 |
| 編碼 |
N/A |
系統預設、ASCII、Unicode、Unicode big-endian、UTF-8 |
系統預設 |
指定的檔案所使用的編碼 |
| 格式化 XML |
N/A |
布林值 |
True |
指定是否要格式化 XML |
| 每個層級的縮排 |
是 |
數值 |
2 |
指定每一個 XML 層級要縮排的空間 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
描述 |
| 指定的目錄無效 |
指出指定的目錄無效 |
| 無法將 XML 寫入檔案 |
指出將 XML 寫入檔案時發生問題 |
執行 XPath 運算式
根據所提供的 XPath 查詢，從 XML 文件擷取值。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| 要剖析的 XML 文件 |
否 |
文字值 |
|
文字形式的 XML，或先前定義的變數，該變數中包含要剖析的 XML 文件 |
| XPath 查詢 |
否 |
文字值 |
|
要對 XML 文件執行的 XPath 運算式 |
| 只取得第一個值 |
N/A |
布林值 |
False |
指定要檢索單一值 (僅第一個值)，或檢索所有符合所提供 XPath 運算式的值 |
變數已產生
| 引數 |
類型 |
名描述 |
| XPathResult |
XML 節點 |
以 XML 節點形式擷取的節點 |
| XPathResults |
XML 節點的清單 |
以 XML 節點清單形式擷取的節點 |
例外狀況
| 例外 |
描述 |
| 提供的 XML 文件無效 |
指出提供的 XML 文件無效 |
| 提供的 XPath 運算式無效 |
指出提供的 XPath 運算式無效 |
取得 XML 元素屬性
取得 XML 元素的屬性值。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| XML 文件 |
否 |
XML 節點 |
|
要擷取其屬性的 XML 文件或 XML 元素 |
| XPath 查詢 |
是 |
文字值 |
|
要尋找子元素並檢索其屬性的 XPath 運算式 |
| Attribute name |
否 |
文字值 |
|
要擷取其值的屬性名稱 |
| 取得以下形式的值 |
N/A |
文字值、數值、日期時間值、布林值 |
文字值 |
指定屬性值的資料類型 |
變數已產生
| 引數 |
類型 |
描述 |
| 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 元素時發生問題 |