Hành động XML

Power Automate cung cấp khả năng sử dụng các luồng máy tính để bàn để quản lý các thuộc tính và phần tử XML.

Để đọc tệp XML, hãy sử dụng tác vụ Đọc XML từ tệp . Chỉ định đường dẫn hoặc duyệt tìm tệp và chọn một trong các tùy chọn mã hóa.

Sau khi chọn tệp, hãy sử dụng hành động Thực thi XPath biểu thức để chạy truy vấn Xpath. Ví dụ sau đây sử dụng một biến được tạo ra từ hành động Đọc XML từ tệp để chỉ định tài liệu.

Ảnh chụp màn hình của hành động biểu thức Thực thi XPath .

Để truy xuất một thuộc tính từ tệp XML, hãy sử dụng hành động Nhận thuộc tính XML . Trong ví dụ sau, trạng thái là thuộc tính của khách hàng, là một phần tử của danh sách khách hàng. Giá trị sẽ được lấy dưới dạng giá trị văn bản.

Ảnh chụp màn hình của hành động Lấy thuộc tính XML.

Tương tự, để truy xuất các giá trị phần tử, hãy sử dụng hành động Nhận giá trị phần tử XML . Bạn có thể quản lý các phần tử và thuộc tính bằng hành động tương ứng để lấy, đặt hoặc xóa các thuộc tính hoặc phần tử XML.

Đọc XML từ tệp

Đọc nội dung của tệp XML thành một biến.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Đường dẫn tệp No Tài liệu Tệp chứa tài liệu XML cần đọc
Kiểu mã hóa Không có Mặc định hệ thống, ASCII, Unicode, Unicode big endian, UTF-8 Tùy chọn mặc định của hệ thống Kiểu mã hóa dùng cho tệp được chỉ định

Đã tạo biến

Đối số Loại Description
Tài liệu Xml Nút XML Biến chứa tài liệu XML được đọc

Ngoại lệ

Ngoại lệ Description
Không tìm thấy thư mục Cho biết rằng thư mục không tồn tại
Không tìm thấy tệp Cho biết rằng tệp không tồn tại
Không đọc được từ tệp Cho biết một sự cố khi đọc từ tệp
Tệp không chứa tài liệu XML hợp lệ Cho biết rằng tệp không chứa tài liệu XML hợp lệ

Ghi XML vào tệp

Ghi nội dung của một biến nút XML thành một tệp.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Đường dẫn tệp No Tài liệu Tệp sẽ ghi tài liệu XML vào đó
XML để ghi No Giá trị văn bản Tài liệu hoặc nút XML sẽ ghi vào tệp
Kiểu mã hóa Không có Mặc định hệ thống, ASCII, Unicode, Unicode big endian, UTF-8 Tùy chọn mặc định của hệ thống Kiểu mã hóa dùng cho tệp được chỉ định
Định dạng XML Không có Giá trị Boolean Đúng Chỉ định xem có định dạng XML hay không
Thụt lề ở mỗi cấp độ Có Giá trị số 2 Chỉ định số lượng dấu cách để thụt lề ở mỗi cấp độ của XML

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Thư mục được chỉ định không hợp lệ Cho biết rằng thư mục được chỉ định không hợp lệ
Không ghi được XML vào tệp Cho biết một sự cố khi ghi XML vào tệp

Thực thi biểu thức XPath

Trích xuất các giá trị từ tài liệu XML dựa trên truy vấn XPath được cung cấp.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML cần phân tích cú pháp No Giá trị văn bản XML dưới dạng văn bản hoặc một biến được xác định trước đó có chứa tài liệu XML cần phân tích cú pháp
XPath truy vấn No Giá trị văn bản Biểu thức XPath để thực thi đối với tài liệu XML
Chỉ lấy giá trị đầu tiên Không có Giá trị Boolean Sai Chỉ định truy xuất một giá trị (chỉ giá trị đầu tiên) hay tất cả các giá trị khớp với biểu thức XPath được cung cấp

Đã tạo biến

Đối số Loại Description
Kết quả XPath Nút XML (Các) nút đã trích xuất dưới dạng nút XML
Kết quả XPath Danh sách trong số nút XML (Các) nút đã trích xuất dưới dạng danh sách nút XML

Ngoại lệ

Ngoại lệ Description
Tài liệu XML được cung cấp không hợp lệ Cho biết rằng tài liệu XML đã cung cấp là không hợp lệ
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ

Lấy thuộc tính phần tử XML

Lấy giá trị thuộc tính của một phần tử XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML hoặc phần tử XML cần truy xuất thuộc tính
XPath truy vấn Có Giá trị văn bản Biểu thức XPath để xác định vị trí phần tử con và truy xuất thuộc tính của nó
Tên thuộc tính No Giá trị văn bản Tên của thuộc tính cần truy xuất giá trị
Lấy giá trị dưới dạng Không có Giá trị văn bản, Giá trị số, Giá trị ngày giờ, Giá trị Boolean Giá trị văn bản Chỉ định kiểu dữ liệu cho giá trị thuộc tính

Đã tạo biến

Đối số Loại Description
XmlAttributionValue Giá trị Boolean Giá trị đã truy xuất của thuộc tính XML
XmlAttributionValue Ngày giờ Giá trị đã truy xuất của thuộc tính XML
XmlAttributionValue Giá trị số Giá trị đã truy xuất của thuộc tính XML
XmlAttributionValue Giá trị văn bản Giá trị đã truy xuất của thuộc tính XML

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không tìm thấy thuộc tính trong phần tử Cho biết rằng thuộc tính không tồn tại trong phần tử
Không thể chuyển đổi giá trị thuộc tính thành kiểu dữ liệu được yêu cầu Cho biết một sự cố khi chuyển đổi giá trị thuộc tính thành kiểu dữ liệu được yêu cầu

Đặt thuộc tính phần tử XML

Đặt giá trị thuộc tính của một phần tử XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML hoặc phần tử XML cần đặt thuộc tính
XPath truy vấn Có Giá trị văn bản Biểu thức XPath để xác định vị trí phần tử con và đặt thuộc tính của nó
Tên thuộc tính No Giá trị văn bản Tên của thuộc tính cần đặt giá trị
Giá trị thuộc tính No Giá trị văn bản Giá trị mới cho thuộc tính

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không thể đặt thuộc tính XML Cho biết có vấn đề khi thiết lập thuộc tính XML

Loại bỏ thuộc tính phần tử XML

Loại bỏ một thuộc tính khỏi phần tử XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML hoặc phần tử XML cần loại bỏ thuộc tính
XPath truy vấn Có Giá trị văn bản Biểu thức XPath để xác định vị trí phần tử con và xóa thuộc tính của nó
Tên thuộc tính No Giá trị văn bản Tên của thuộc tính cần loại bỏ

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không tìm thấy thuộc tính trong phần tử Cho biết rằng thuộc tính không tồn tại trong phần tử
Không thể xóa thuộc tính XML Cho biết có vấn đề khi xóa thuộc tính XML

Lấy giá trị phần tử XML

Lấy giá trị của một phần tử XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML hoặc phần tử XML cần truy xuất giá trị
XPath truy vấn Có Giá trị văn bản Biểu thức XPath để xác định vị trí phần tử con và truy xuất giá trị của nó
Lấy giá trị dưới dạng Không có Giá trị văn bản, Giá trị số, Giá trị ngày giờ, Giá trị Boolean Giá trị văn bản Chỉ định kiểu dữ liệu cho giá trị phần tử XML

Đã tạo biến

Đối số Loại Description
Giá trị phần tử Xml Giá trị Boolean Giá trị phần tử XML
Giá trị phần tử Xml Ngày giờ Giá trị phần tử XML
Giá trị phần tử Xml Giá trị số Giá trị phần tử XML
Giá trị phần tử Xml Giá trị văn bản Giá trị phần tử XML

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không thể chuyển đổi giá trị phần tử thành kiểu dữ liệu được yêu cầu Cho biết một sự cố khi chuyển đổi giá trị phần tử thành kiểu dữ liệu được yêu cầu

Đặt giá trị phần tử XML

Đặt giá trị của một phần tử XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML hoặc phần tử XML cần truy xuất giá trị
XPath truy vấn Có Giá trị văn bản Biểu thức XPath để xác định vị trí phần tử con và truy xuất giá trị của nó
Giá trị phần tử XML No Giá trị văn bản Giá trị mới cho phần tử XML

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không đặt được giá trị phần tử Cho biết một sự cố khi đặt giá trị phần tử

Chèn phần tử XML

Chèn một phần tử XML mới vào tài liệu XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML cần chèn phần tử XML mới
XPath truy vấn No Giá trị văn bản Biểu thức XPath để định vị phần tử XML gốc và chèn phần tử mới vào đó
Phần tử XML sẽ chèn No Nút XML Phần tử XML mới sẽ chèn vào tài liệu XML

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
XPath biểu thức không trả về phần tử nào Cho biết rằng biểu thức XPath không trả về phần tử nào
Không chèn được phần tử XML Cho biết một sự cố khi chèn phần tử XML

Loại bỏ phần tử XML

Loại bỏ một hoặc nhiều phần tử XML khỏi tài liệu XML.

Tham số đầu vào

Đối số Không bắt buộc Chấp nhận Giá trị mặc định Description
Tài liệu XML No Nút XML Tài liệu XML có chứa (các) phần tử XML cần loại bỏ
XPath truy vấn No Giá trị văn bản Biểu thức XPath để xác định vị trí các phần tử cần loại bỏ

Đã tạo biến

Hành động này không tạo ra bất kỳ biến nào.

Ngoại lệ

Ngoại lệ Description
Đã cung cấp biểu thức XPath không hợp lệ Cho biết rằng biểu thức XPath được cung cấp không hợp lệ
Không loại bỏ được phần tử XML Cho biết một sự cố khi loại bỏ phần tử XML