XML-toiminnot
Artikkeli 03/16/2023
8 avustajaa
Palaute
Tässä artikkelissa
Power Automate antaa mahdollisuuden käyttää työpöytätyönkulkuja XML-määritteiden ja -elementtien hallintaan.
Jos haluat lukea XML-tiedoston, käytä Lue XML tiedostosta -toimintoa. Määritä polku tai etsi tiedosto selaamalla. Valitse jokin koodausvaihtoehdoista.
Suorita Xpath-kysely tiedoston valinnan jälkeen käyttämällä Suorita XPath-lauseke -toimintoa. Seuraavassa esimerkissä asiakirja määritetään käyttämällä Lue XML tiedostosta -toiminnon lisämuuttujaa.
Voit hakea määritteen XML-tiedostosta käyttämällä Hae XML-määrite -toimintoa. Seuraavassa esimerkissä status on clientin määrite, joka on puolestaan clientlistin elementti. Arvo saadaan tekstiarvona.
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 hakemiseen, määrittämiseen tai poistamiseen.
Lue XML tiedostosta
Lue XML-tiedoston sisältö muuttujaan.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
Tiedostopolku
Ei
Tiedosto Tiedosto, joka sisältää luettavan XML-asiakirjan
Koodaus
–
Järjestelmäoletus, ASCII, Unicode, Unicode big endian, UTF-8
Järjestelmän oletusarvo
Koodaus, jota käytetään määritetyssä tiedostossa
Tuotetut muuttujat
Argumentti
Type
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
Tiedostopolku
Ei
Tiedosto Tiedosto, johon XML-asiakirja kirjoitetaan
XML kirjoitettavaksi
Ei
Tekstin arvo XML-solmu tai -asiakirja, joka kirjoitetaan tiedostoon
Koodaus
–
Järjestelmäoletus, ASCII, Unicode, Unicode big endian, UTF-8
Järjestelmän oletusarvo
Koodaus, jota käytetään määritetyssä tiedostossa
XML-osoitteen muotoilu
–
Totuusarvo Tosi
Määrittää, muotoillaanko XML
Sisennys tasoa kohti
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
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
Jäsennettävä XML-asiakirja
Ei
Tekstin arvo XML tekstinä tai aiemmin määritetty muuttuja, joka sisältää jäsennettävän XML-asiakirjan
XPath-kysely
Ei
Tekstiarvo XPath-lauseke, joka suoritetaan XML-asiakirjan perusteella
Hae vain ensimmäinen arvo
–
Totuusarvo Epätosi
Määrittää, haetaanko yksi arvo (vain ensimmäinen arvo) vai kaikki arvot, jotka vastaavat annettua XPath-lauseketta
Tuotetut muuttujat
Argumentti
Type
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja tai XML-elementti, jonka määrite noudetaan
XPath-kysely
Kyllä
Tekstiarvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen määritteen
Määritteen arvo
Ei
Tekstiarvo Sen määritteen nimi, jonka arvo noudetaan
Hae arvo muodossa
–
Tekstin arvo, Numeerinen arvo, Päivämäärä/aika-arvo, Totuusarvo
Tekstin arvo
Määrittää määritteen arvon tietotyypin
Tuotetut muuttujat
Argumentti
Type
Description
XmlAttributeValue
Totuusarvo XML-määritteen noudettu arvo
XmlAttributeValue
Päivämäärä/aika XML-määritteen noudettu arvo
XmlAttributeValue
Numeerinen arvo XML-määritteen noudettu arvo
XmlAttributeValue
Tekstin arvo XML-määritteen noudettu arvo
Poikkeukset
Poikkeus
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja tai XML-elementti, jonka määrite määritetään
XPath-kysely
Kyllä
Tekstiarvo XPath-lauseke, joka paikantaa alielementin ja määrittää sen määritteen
Määritteen arvo
Ei
Tekstiarvo Sen määritteen nimi, jonka arvo määritetään
Määritteen arvo
Ei
Tekstiarvo Määritteen uusi arvo
Tuotetut muuttujat
Tämä toiminto ei tuota muuttujia.
Poikkeukset
Poikkeus
Description
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
Poista määrite XML-elementistä.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja tai XML-elementti, jonka määrite poistetaan
XPath-kysely
Kyllä
Tekstiarvo XPath-lauseke, joka paikantaa alielementin ja poistaa sen määritteen
Määritteen arvo
Ei
Tekstiarvo Poistettavan määritteen nimi
Tuotetut muuttujat
Tämä toiminto ei tuota muuttujia.
Poikkeukset
Poikkeus
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja tai XML-elementti, jonka arvo noudetaan
XPath-kysely
Kyllä
Tekstiarvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen arvon
Hae arvo muodossa
–
Tekstin arvo, Numeerinen arvo, Päivämäärä/aika-arvo, Totuusarvo
Tekstin arvo
Määrittää XML-elementin arvon tietotyypin
Tuotetut muuttujat
Poikkeukset
Poikkeus
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja tai XML-elementti, jonka arvo noudetaan
XPath-kysely
Kyllä
Tekstiarvo XPath-lauseke, joka paikantaa alielementin ja noutaa sen arvon
XML-elementin arvo
Ei
Tekstiarvo XML-elementin uusi arvo
Tuotetut muuttujat
Tämä toiminto ei tuota muuttujia.
Poikkeukset
Poikkeus
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja, johon uusi XML-elementti lisätään
XPath-kysely
Ei
Tekstiarvo XPath-lauseke, joka etsii ylätason XML-elementin ja lisää siihen uuden elementin
Lisättävä XML-elementti
Ei
XML-solmu XML-elementti, joka lisätään XML-asiakirjaan
Tuotetut muuttujat
Tämä toiminto ei tuota muuttujia.
Poikkeukset
Poikkeus
Description
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.
Argumentti
Valinnainen
Hyväksyy
Oletusarvo
Description
XML-asiakirja
Ei
XML-solmu XML-asiakirja, joka sisältää poistettavat XML-elementit
XPath-kysely
Ei
Tekstiarvo XPath-lauseke, jota käytetään etsittäessä poistettavat elementit
Tuotetut muuttujat
Tämä toiminto ei tuota muuttujia.
Poikkeukset
Poikkeus
Description
Annettiin virheellinen XPath-lauseke
Osoittaa, että annettu XPath-lauseke on virheellinen
XML-elementin poistaminen epäonnistui
Osoittaa, että XML-elementin poistamisessa on ongelma
