Tindakan XML

Power Automate menyediakan keupayaan untuk menggunakan aliran desktop untuk menguruskan atribut dan unsur XML.

Untuk membaca fail XML, gunakan tindakan Baca XML daripada fail . Tentukan laluan atau semak lalu untuk fail dan pilih salah satu opsyen pengekodan.

Selepas memilih fail, gunakan tindakan Laksanakan XPath ungkapan untuk menjalankan pertanyaan Xpath. Contoh berikut menggunakan pemboleh ubah yang dihasilkan daripada tindakan Baca XML daripada fail untuk menentukan dokumen.

Untuk mendapatkan atribut daripada fail XML, gunakan tindakan Dapatkan atribut XML . Dalam contoh berikut,status adalah atribut pelanggan , yang merupakan elemen klien. Nilai akan diperolehi sebagai nilai teks.

Begitu juga, untuk mendapatkan semula nilai unsur, gunakan tindakan Dapatkan nilai unsur XML. Anda boleh menguruskan unsur dan atribut menggunakan tindakan masing-masing untuk mendapatkan, mengesetkan atau mengalih keluar atribut atau unsur XML.

Baca XML daripada fail

Baca kandungan fail XML ke dalam pemboleh ubah.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Laluan fail	No	Fail		Fail yang mengandungi dokumen XML untuk dibaca
Pengekodan	T/B	Lalai sistem, ASCII, Unicode, Unicode big endian, UTF-8	Lalai sistem	Pengekodan yang digunakan untuk fail yang ditentukan

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
XmlDocument	Nod XML	Pemboleh ubah yang memegang dokumen XML yang dibaca

Pengecualian

Pengecualian	Description
Direktori tidak ditemukan	Menunjukkan bahawa direktori tidak wujud
Fail tidak ditemukan	Menunjukkan bahawa fail tidak wujud
Gagal membaca daripada fail	Menunjukkan masalah semasa membaca daripada fail
Fail tidak mengandungi dokumen XML yang sah	Menunjukkan bahawa fail tidak mengandungi dokumen XML yang sah

Tulis XML kepada fail

Tulis kandungan pemboleh ubah nod XML ke dalam fail.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Laluan fail	No	Fail		Fail untuk dituliskan dokumen XML
XML untuk dituliskan	No	Nilai teks		Nod atau dokumen XML untuk dituliskan ke dalam fail
Pengekodan	T/B	Lalai sistem, ASCII, Unicode, Unicode big endian, UTF-8	Lalai sistem	Pengekodan yang digunakan untuk fail yang ditentukan
XML Format	T/B	Nilai Boolean	Benar	Menentukan sama ada untuk memformat XML
Inden setiap tahap	Ya	Nilai angka	2	Menentukan jumlah ruang untuk menginden setiap tahap XML

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Direktori tidak sah ditentukan	Menunjukkan direktori yang ditentukan tidak sah
Gagal menulis XML kepada fail	Menunjukkan masalah semasa menulis XML kepada fail

Melaksanakan XPath ungkapan

Menyarikan nilai daripada dokumen XML berdasarkan pertanyaan yang disediakan XPath .

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML untuk diurai	No	Nilai teks		XML sebagai teks atau pemboleh ubah yang ditakrifkan sebelumnya yang mengandungi dokumen XML untuk diurai
XPath Pertanyaan	No	Nilai teks		Ungkapan XPath untuk dilaksanakan terhadap dokumen XML
Dapatkan nilai pertama sahaja	T/B	Nilai Boolean	Salah	Menentukan sama ada untuk mendapatkan semula nilai tunggal (nilai pertama sahaja) atau semua nilai yang sepadan dengan ungkapan yang disediakan XPath

Pemboleh ubah yang dihasilkan

Argumen	Taip	Description
XPathResult	Nod XML	Nod diekstrak sebagai nod XML
XPathResults	Senarai nod XML	Nod diekstrak sebagai senarai nod XML

Pengecualian

Pengecualian	Description
Dokumen XML tidak sah diberikan	Menunjukkan bahawa dokumen XML yang diberikan tidak sah
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah

Dapatkan atribut elemen XML

Dapatkan nilai atribut elemen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML atau elemen XML untuk mendapatkan atributnya
XPath Pertanyaan	Ya	Nilai teks		Ungkapan XPath untuk mencari subunsur dan mendapatkan semula atributnya
Nama atribut	No	Nilai teks		Nama atribut untuk mendapatkan nilainya
Dapatkan nilai sebagai	T/B	Nilai teks, nilai angka, nilai Datetime, nilai Boolean	Nilai teks	Menentukan jenis data untuk nilai atribut

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
XmlAttributeValue	Nilai Boolean	Nilai atribut XML yang didapatkan
XmlAttributeValue	Masa tarikh	Nilai atribut XML yang didapatkan
XmlAttributeValue	Nilai angka	Nilai atribut XML yang didapatkan
XmlAttributeValue	Nilai teks	Nilai atribut XML yang didapatkan

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Atribut tidak ditemui dalam elemen	Menunjukkan bahawa atribut tidak wujud dalam elemen
Gagal menukar nilai atribut kepada jenis data yang diminta	Menunjukkan masalah semasa menukar nilai atribut kepada jenis data yang diminta

Tetapkan atribut elemen XML

Tetapkan nilai atribut elemen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML atau elemen XML untuk ditetapkan atributnya
XPath Pertanyaan	Ya	Nilai teks		Ungkapan XPath untuk mencari subunsur dan mengesetkan atributnya
Nama atribut	No	Nilai teks		Nama atribut untuk ditetapkan nilainya
Nilai atribut	No	Nilai teks		Nilai baharu untuk atribut

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Gagal mengesetkan atribut XML	Menunjukkan masalah mengesetkan atribut XML

Alih keluar atribut elemen XML

Alih keluar atribut daripada elemen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML atau elemen XML untuk dialih keluar atributnya
XPath Pertanyaan	Ya	Nilai teks		Ungkapan XPath untuk mencari subunsur dan mengalih keluar atributnya
Nama atribut	No	Nilai teks		Nama atribut untuk dialih keluar

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Atribut tidak ditemui dalam elemen	Menunjukkan bahawa atribut tidak wujud dalam elemen
Gagal mengalih keluar atribut XML	Menunjukkan masalah mengalih keluar atribut XML

Dapatkan nilai elemen XML

Dapatkan nilai elemen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML atau elemen XML untuk mendapatkan nilainya
XPath Pertanyaan	Ya	Nilai teks		Ungkapan XPath untuk mencari subunsur dan mendapatkan semula nilainya
Dapatkan nilai sebagai	T/B	Nilai teks, nilai angka, nilai Datetime, nilai Boolean	Nilai teks	Menentukan jenis data untuk nilai elemen XML

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
XmlElementValue	Nilai Boolean	Nilai elemen XML
XmlElementValue	Masa tarikh	Nilai elemen XML
XmlElementValue	Nilai angka	Nilai elemen XML
XmlElementValue	Nilai teks	Nilai elemen XML

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Gagal menukar nilai elemen kepada jenis data yang diminta	Menunjukkan masalah semasa menukar nilai elemen kepada jenis data yang diminta

Tetapkan nilai elemen XML

Tetapkan nilai elemen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML atau elemen XML untuk didapatkan nilainya
XPath Pertanyaan	Ya	Nilai teks		Ungkapan XPath untuk mencari subunsur dan mendapatkan semula nilainya
Nilai elemen XML	No	Nilai teks		Nilai baharu untuk elemen XML

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Gagal menetapkan nilai elemen	Menunjukkan masalah semasa menetapkan nilai elemen

Masukkan elemen XML

Masukkan elemen XML baharu ke dalam dokumen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML untuk memasukkan elemen XML yang baharu
XPath Pertanyaan	No	Nilai teks		Ungkapan XPath untuk mencari unsur XML induk dan menyelitkan unsur baru ke dalamnya
Elemen XML untuk dimasukkan	No	Nod XML		Elemen XML yang baharu untuk dimasukkan ke dalam dokumen XML

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
XPath ungkapan mengembalikan tiada unsur	Menunjukkan bahawa ungkapan tidak XPath mengembalikan unsur
Gagal memasukkan elemen XML	Menunjukkan masalah semasa memasukkan elemen XML

Alih keluar elemen XML

Alih keluar satu atau lebih elemen XML daripada dokumen XML.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Dokumen XML	No	Nod XML		Dokumen XML yang mengandungi elemen XML untuk dialih keluar
XPath Pertanyaan	No	Nilai teks		Ungkapan XPath untuk mencari unsur untuk dialih keluar

Pemboleh ubah yang dihasilkan

Tindakan ini tidak menghasilkan sebarang pembolehubah.

Pengecualian

Pengecualian	Description
Ungkapan tidak sah XPath disediakan	Menunjukkan bahawa ungkapan yang XPath diberikan tidak sah
Gagal mengalih keluar elemen XML	Menunjukkan masalah semasa mengalih keluar elemen XML