Delen via

XML-acties

  • Artikel

Power Automate biedt de mogelijkheid om bureaubladstromen te gebruiken om XML-kenmerken en -elementen te beheren.

Als u een XML-bestand wilt lezen, gebruikt u de actie XML uit bestand lezen. Geef het pad op of blader naar het bestand en selecteer een van de coderingsopties.

Na het selecteren van een bestand gebruikt u de actie XPath-expressie uitvoeren om een Xpath-query uit te voeren. In het volgende voorbeeld wordt een geproduceerde variabele uit de actie XML-bestand uit bestand lezen gebruikt om het document te specificeren.

Schermopname van de actie XPath-expressie uitvoeren.

Als u een kenmerk uit een XML-bestand wilt ophalen, gebruikt u de actie XML-kenmerk ophalen. In het volgende voorbeeld is status een kenmerk van client, dat een element is van clientlist. De waarde wordt verkregen als een tekstwaarde.

Schermopname van de actie XML-kenmerk ophalen.

Gebruik op dezelfde manier de actie XML-elementwaarde ophalen om elementwaarden op te halen. U kunt elementen en kenmerken beheren door de respectievelijke actie te gebruiken om XML-kenmerken of -elementen op te halen, in te stellen of te verwijderen.

XML-bestand uit bestand lezen

Hiermee wordt de inhoud van een XML-bestand ingelezen in een variabele.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
Bestandspad Nee Bestand Het bestand dat het XML-document bevat dat moet worden gelezen
Codering N.v.t. Systeemstandaard, ASCII, Unicode, Unicode big endian, UTF-8 Systeemstandaard De codering die wordt gebruikt voor het opgegeven bestand

Variabelen gemaakt

Argument Type Omschrijving
XmlDocument XML-knooppunt De variabele die het gelezen XML-document bevat

Uitzonderingen

Uitzondering Beschrijving
Map niet gevonden Geeft aan dat de map niet bestaat
Bestand niet gevonden Geeft aan dat het bestand niet bestaat
Lezen uit bestand mislukt Geeft een probleem aan bij het lezen uit bestand
Bestand bevat geen geldig XML-document Geeft aan dat het bestand geen geldig XML-document bevat

XML naar bestand schrijven

Hiermee wordt de inhoud van een variabele van een XML-knooppunt naar een bestand geschreven.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
Bestandspad Nee Bestand Het bestand waar het XML-document naar wordt geschreven
Te schrijven XML Nee Tekstwaarde Het XML-knooppunt of -document dat naar het bestand moet worden geschreven
Codering N.v.t. Systeemstandaard, ASCII, Unicode, Unicode big endian, UTF-8 Systeemstandaard De codering die wordt gebruikt voor het opgegeven bestand
XML opmaken N.v.t. Booleaanse waarde True Hiermee wordt opgegeven of de XML moet worden ingedeeld
Inspringing per niveau Ja Numerieke waarde 2 Geeft aan hoeveel spaties elk niveau van de XML moet inspringen

Variabelen gemaakt

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Omschrijving
Ongeldige map opgegeven Geeft aan dat de opgegeven map ongeldig is
Kan XML niet naar bestand schrijven Geeft een probleem aan bij het schrijven van XML naar bestand

XPath-expressie uitvoeren

Waarden extraheren uit een XML-document op basis van de opgegeven XPath-query.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document om te parseren Nee Tekstwaarde De XML als tekst of een eerder gedefinieerde variabele die het te parseren XML-document bevat
XPath-query Nee Tekstwaarde De XPath-expressie die moet worden uitgevoerd op basis van het XML-document
Alleen eerste waarde ophalen N.v.t. Booleaanse waarde False Hiermee wordt aangegeven of een enkele waarde moet worden opgehaald (alleen de eerste waarde) of alle waarden die overeenkomen met de opgegeven XPath-expressie

Geproduceerde variabelen

Argument Type Beschrijving
XPathResult XML-knooppunt De geëxtraheerde knooppunten als een XML-knooppunt
XPathResults Lijst met XML-knooppunten De geëxtraheerde knooppunten als een lijst met XML-knooppunten

Uitzonderingen

Uitzondering Beschrijving
Ongeldig XML-document opgegeven Hiermee wordt aangegeven dat het opgegeven XML-document ongeldig is
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is

Kenmerk van XML-element ophalen

Hiermee wordt de waarde van een kenmerk van een XML-element opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document of XML-element om het kenmerk ervan op te halen
XPath-query Ja Tekstwaarde De XPath-expressie om het subelement te vinden en het kenmerk ervan op te halen
Naam van kenmerk Nee Tekstwaarde De naam van het kenmerk om de waarde ervan op te halen
Waarde ophalen als N.v.t. Tekstwaarde, Numerieke waarde, Datum-/tijdwaarde, Booleaanse waarde Tekstwaarde Geeft het gegevenstype aan van de kenmerkwaarde

Variabelen gemaakt

Argument Type Omschrijving
XmlAttributeValue Booleaanse waarde De opgehaalde waarde van het XML-kenmerk
XmlAttributeValue Datum/tijd De opgehaalde waarde van het XML-kenmerk
XmlAttributeValue Numerieke waarde De opgehaalde waarde van het XML-kenmerk
XmlAttributeValue Tekstwaarde De opgehaalde waarde van het XML-kenmerk

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kenmerk niet gevonden in element Geeft aan dat het kenmerk niet bestaat in het element
Kan kenmerkwaarde niet converteren naar het aangevraagde gegevenstype Duidt op een probleem bij het converteren van de kenmerkwaarde naar het aangevraagde gegevenstype

Kenmerk van XML-element instellen

Hiermee wordt de waarde van een kenmerk van een XML-element ingesteld.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document of XML-element om het kenmerk ervan in te stellen
XPath-query Ja Tekstwaarde De XPath-expressie om het subelement te vinden en het kenmerk ervan in te stellen
Naam van kenmerk Nee Tekstwaarde De naam van het kenmerkveld om de waarde ervan in te stellen
Kenmerkwaarde Nee Tekstwaarde De nieuwe waarde voor het kenmerk

Variabelen gemaakt

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kan XML-kenmerk niet instellen Geeft een probleem aan bij het instellen van het XML-kenmerk

Kenmerk van XML-element verwijderen

Hiermee wordt een kenmerk uit een XML-element verwijderd.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document of XML-element om het kenmerk ervan te verwijderen
XPath-query Ja Tekstwaarde De XPath-expressie om het subelement te vinden en het kenmerk ervan te verwijderen
Naam van kenmerk Nee Tekstwaarde De naam van het kenmerk dat moet worden verwijderd

Variabelen gemaakt

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kenmerk niet gevonden in element Geeft aan dat het kenmerk niet bestaat in het element
Kan XML-kenmerk niet verwijderen Geeft een probleem aan bij het verwijderen van het XML-kenmerk

Waarde van XML-element ophalen

Hiermee wordt de waarde van een XML-element opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document of XML-element om de waarde ervan op te halen
XPath-query Ja Tekstwaarde De XPath-expressie om het subelement te vinden en de waarde ervan op te halen
Waarde ophalen als N.v.t. Tekstwaarde, Numerieke waarde, Datum-/tijdwaarde, Booleaanse waarde Tekstwaarde Geeft het gegevenstype aan van de waarde van het XML-element

Variabelen gemaakt

Argument Type Omschrijving
XmlElementValue Booleaanse waarde De waarde van het XML-element
XmlElementValue Datum/tijd De waarde van het XML-element
XmlElementValue Numerieke waarde De waarde van het XML-element
XmlElementValue Tekstwaarde De waarde van het XML-element

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kan elementwaarde niet converteren naar het aangevraagde gegevenstype Duidt op een probleem bij het converteren van de elementwaarde naar het aangevraagde gegevenstype

Waarde van XML-element instellen

Hiermee wordt de waarde van een XML-element ingesteld.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document of XML-element om de waarde ervan op te halen
XPath-query Ja Tekstwaarde De XPath-expressie om het subelement te vinden en de waarde ervan op te halen
Waarde van XML-element Nee Tekstwaarde De nieuwe waarde voor het XML-element

Variabelen gemaakt

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kan elementwaarde niet instellen Geeft een probleem aan bij het instellen van de elementwaarde

XML-element invoegen

Hiermee wordt een nieuw XML-element ingevoegd in een XML-document.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document waarin het nieuwe XML-element moet worden ingevoegd
XPath-query Nee Tekstwaarde De XPath-expressie om het bovenliggende XML-element te vinden, en het nieuwe element hierin invoegen
In te voegen XML-element Nee XML-knooppunt Het nieuwe XML-element dat in het XML-document moet worden ingevoegd

Variabelen gemaakt

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
XPath-expressie retourneert geen element Hiermee wordt aangegeven dat de XPath-expressie geen element retourneert
Kan XML-element niet invoegen Geeft een probleem aan bij het invoegen van het XML-element

XML-element verwijderen

Hiermee worden een of meer XML-elementen uit een XML-document verwijderd.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
XML-document Nee XML-knooppunt Het XML-document dat de XML-elementen bevat die moeten worden verwijderd
XPath-query Nee Tekstwaarde De XPath-expressie om de elementen te vinden die moeten worden verwijderd

Geproduceerde variabelen

Deze actie levert geen variabelen op.

Uitzonderingen

Uitzondering Beschrijving
Ongeldige XPath-expressie opgegeven Hiermee wordt aangegeven dat de opgegeven XPath-expressie ongeldig is
Kan XML element niet verwijderen Geeft een probleem aan bij het verwijderen van het XML-element