XML

Hallinnoi ja muokkaa XML-tiedostoja

Lue XML tiedostosta
Kirjoita XML tiedostoon
Suorita XPath-lauseke
Hae XML-elementin määrite
Määritä XML-elementin määrite
Poista XML-elementin määrite
Hae XML-elementin arvo
Määritä XML-elementin arvo
Lisää XML-elementti
Poista XML-elementti

XML-toimintojen käytön aloittaminen

Power Automate tarjoaa mahdollisuuden käyttää työnkulkuja XML-attribuuttien ja -elementtien hallinnan automatisoimiseen XML-toimintojen avulla.

Jos haluat lukea XML-tiedoston, käytä Lue XML tiedostosta -toimintoa. Määritä polku tai etsi tiedosto selaamalla. Valitse jokin koodausvaihtoehdoista.

Kun olet valinnut tiedoston, suorita Xpath-kysely valitsemalla Suorita XPath-lauseke -toiminto. Seuraavassa esimerkissä asiakirja määritetään muuttujaksi Lue XML tiedostosta -toiminnon muuttujana ja syötetään XPath-kysely.

näyttökuva xpath-lausekkeen suorittavan toiminnon ominaisuuksista.

Voit hakea määritteen XML-tiedostosta käyttämällä Hae XML-määrite -toimintoa. Ota huomioon esimerkki, joka seuraa XPath-kyselyä ja muotoilee sitä. XML-tiedostossa status on client-kohdan määrite. Tämä puolestaan on clientlist-kohdan elementti. Arvo saadaan tekstiarvona.

näyttökuva xpath-lausekkeen suorittavan toiminnon ominaisuuksista.

Jos haluat hakea elementin arvot, käytä vastaavasti Hae XML-elementin arvo -toimintoa. Elementtejä ja määritteitä voi hallita käyttämällä vastaavaa toimintoa XML-määritteiden tai -elementtien hakemiseksi, määrittämiseksi tai poistamiseksi.

XML-toiminnot

Lue XML tiedostosta

Lue XML-tiedoston sisältö muuttujaan

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
File path: Ei File Tiedosto, joka sisältää luettavan XML-asiakirjan
Encoding: Oletus, ANSI, Unicode, Unicode big-endian, UTF-8 Oletus Koodaus, jota käytetään määritetyssä tiedostossa
Tuotetut muuttujat
Argumentti Laji Kuvaus
XmlDocument XML-solmu Muuttuja, joka sisältää luettavan XML-asiakirjan
Poikkeukset
Poikkeus Kuvaus
Hakemistoa ei löydy Osoittaa, että hakemistoa ei ole
Tiedostoa ei löydy Osoittaa, että tiedostoa ei ole
Tiedostosta lukeminen epäonnistui Osoittaa, että tiedoston lukemisessa on ongelma
Tiedostossa ei ole sallittua XML-asiakirjaa Osoittaa, että tiedostossa ei ole sallittua XML-asiakirjaa

Kirjoita XML tiedostoon

Kirjoita XML-solmun muuttujan sisältö tiedostoon

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
File path: Ei File Tiedosto, johon XML-asiakirja kirjoitetaan
XML to write: Ei Tekstin arvo XML-solmu tai -asiakirja, joka kirjoitetaan tiedostoon
Encoding: Oletus, ANSI, Unicode, Unicode big-endian, UTF-8 Oletus Koodaus, jota käytetään määritetyssä tiedostossa
Format XML: Totuusarvo Oikein Määrittää, muotoillaanko XML
Indentation per level: Kyllä Numeerinen arvo 2 Määrittää, miten monen välilyönnin verran XML:n kutakin tasoa sisennetään
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Määritettiin virheellinen hakemisto Osoittaa, että määritetty hakemisto on virheellinen
XML:n kirjoittaminen tiedostoon epäonnistui Osoittaa, että XML:n kirjoittamisessa tiedostoon on ongelma

Suorita XPath-lauseke

Poimi arvot XML-asiakirjasta annetun XPath-kyselyn perusteella

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document to parse: Ei Tekstin arvo XML tekstinä tai aiemmin määritetty muuttuja, joka sisältää jäsennettävän XML-asiakirjan
XPath query: Ei Tekstin arvo XPath-lauseke, joka suoritetaan XML-asiakirjalle
Get first value only: Totuusarvo Väärin Määrittää, haetaanko yksi arvo (vain ensimmäinen arvo) vai kaikki arvot, jotka vastaavat määritettyä XPath-lauseketta
Tuotetut muuttujat
Argumentti Laji Kuvaus
XPathResult XML-solmu Poimitut solmut XML-solmuna
XPathResults XML-solmujen luettelo Poimitut solmut XML-solmuluettelona
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XML-asiakirja Osoittaa, että annettu XML-asiakirja on virheellinen
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen

Hae XML-elementin määrite

Hae XML-elementin määritteen arvo

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja tai XML-elementti, jonka määrite noudetaan
XPath query Kyllä Tekstin arvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen määritteen
Attribute name: Ei Tekstin arvo Sen määritteen nimi, jonka arvo noudetaan
Get value as: Tekstin arvo, Numeerinen arvo, Päivämäärä/aika-arvo, Totuusarvo Tekstin arvo Määrittää määritteen arvon tietotyypin
Tuotetut muuttujat
Argumentti Laji Kuvaus
XmlAttributeValue Totuusarvo XML-määritteen noudettu arvo
XmlAttributeValue Datetime XML-määritteen noudettu arvo
XmlAttributeValue Numeerinen arvo XML-määritteen noudettu arvo
XmlAttributeValue Tekstin arvo XML-määritteen noudettu arvo
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
Määritettä ei löydy elementistä Osoittaa, että elementti ei sisällä määritettä
Määritteen arvon muuntaminen pyydetyksi tietotyypiksi epäonnistui Osoittaa, että määritteen arvon muuntamisessa pyydetyksi tietotyypiksi on ongelma

Määritä XML-elementin määrite

Määritä XML-elementin määritteen arvo

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja tai XML-elementti, jonka määrite määritetään
XPath query: Kyllä Tekstin arvo XPath-lauseke, jonka avulla etsitään alielementti ja määritetään sen määrite
Attribute name: Ei Tekstin arvo Sen määritteen nimi, jonka arvo määritetään
Attribute value: Ei Tekstin arvo Määritteen uusi arvo
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
XML-määritteen määrittäminen epäonnistui Osoittaa, että XML-määritteen määrittämisessä on ongelma

Poista XML-elementin määrite

Määritteen poistaminen XML-elementistä

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja tai XML-elementti, jonka määrite poistetaan
XPath query: Kyllä Tekstin arvo XPath-lauseke, jonka avulla etsitään alielementti ja poistetaan sen määrite
Attribute name: Ei Tekstin arvo Poistettavan määritteen nimi
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
Määritettä ei löydy elementistä Osoittaa, että elementti ei sisällä määritettä
XML-määritteen poistaminen epäonnistui Osoittaa, että XML-määritteen poistamisessa on ongelma

Hae XML-elementin arvo

Hae XML-elementin arvo

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja tai XML-elementti, jonka arvo noudetaan
XPath query: Kyllä Tekstin arvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen arvon
Get value as: Tekstin arvo, Numeerinen arvo, Päivämäärä/aika-arvo, Totuusarvo Tekstin arvo Määrittää XML-elementin arvon tietotyypin
Tuotetut muuttujat
Argumentti Laji Kuvaus
XmlElementValue Totuusarvo XML-elementin arvo
XmlElementValue Datetime XML-elementin arvo
XmlElementValue Numeerinen arvo XML-elementin arvo
XmlElementValue Tekstin arvo XML-elementin arvo
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
Elementin arvon muuntaminen pyydetyksi tietotyypiksi epäonnistui Osoittaa, että elementin arvon muuntamisessa pyydetyksi tietotyypiksi on ongelma

Määritä XML-elementin arvo

Määritä XML-elementin arvo

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja tai XML-elementti, jonka arvo noudetaan
XPath query: Kyllä Tekstin arvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen arvon
XML element value: Ei Tekstin arvo XML-elementin uusi arvo
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
Elementin arvon määrittäminen epäonnistui Osoittaa, että elementin arvon määrittämisessä on ongelma

Lisää XML-elementti

Lisää uusi XML-elementti XML-asiakirjaan

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja, johon uusi XML-elementti lisätään
XPath query: Ei Tekstin arvo XPath-lauseke, joka etsii ylätason XML-elementin ja lisää siihen uuden elementin
XML element to insert: Ei XML-solmu XML-elementti, joka lisätään XML-asiakirjaan
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XPath-lauseke ei palauta elementtiä Osoittaa, että XPath-lauseke ei palauta elementtiä
XML-elementin lisääminen epäonnistui Osoittaa, että XML-elementin lisäämisessä on ongelma

Poista XML-elementti

Poista vähintään yksi XML-elementti XML-asiakirjasta

Syöteparametrit
Argumentti Valinnainen Hyväksymiset Oletusarvo Kuvaus
XML document: Ei XML-solmu XML-asiakirja, joka sisältää poistettavat XML-elementit
XPath query: Ei Tekstin arvo XPath-lauseke, jota käytetään etsittäessä poistettavat elementit
Tuotetut muuttujat
  • Tämä toiminto ei tuota muuttujia
Poikkeukset
Poikkeus Kuvaus
Annettiin virheellinen XPath-lauseke Osoittaa, että annettu XPath-lauseke on virheellinen
XML-elementin poistaminen epäonnistui Osoittaa, että XML-elementin poistamisessa on ongelma