Akce XML
Článek 01/30/2024
Přispěvatelé: 8
Váš názor
V tomto článku
Power Automate poskytuje možnost používat desktopové toky ke správě atributů a prvků XML.
Chcete-li číst soubor XML, použijte akci Číst XML ze souboru . Určete cestu nebo vyhledejte soubor a vyberte jednu z možností kódování.
Po výběru souboru, použijte akci Spustit výraz XPath ke spuštění dotazu Xpath. Následující příklad používá k určení dokumentu vytvořenou proměnnou z akce Číst XML ze souboru .
Chcete-li načíst atribut ze souboru XML, použijte akci Získat atribut XML . V následujícím příkladu je status atribut pro client , což je prvek pro cleintlist . Hodnota bude získána jako textová hodnota.
Podobně pro načtení hodnot prvků použijte akci Získat hodnotu prvku XML . Prvky a atributy můžete spravovat pomocí příslušné akce k získání, nastavení nebo odebrání atributů nebo prvků XML.
Číst XML ze souboru
Načíst obsah souboru XML do proměnné.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Cesta k souboru
Ne
Soubor
Soubor, který obsahuje dokument XML ke čtení
Kódování
–
Výchozí nastavení systému, ASCII, Unicode big endian, UTF-8
Výchozí systém
Kódování použité pro zadaný soubor
Vytvořené proměnné
Argument
Type
Popis
XmlDocument
Uzel XML
Proměnná obsahující čtený dokument XML
Výjimky
Výjimka
Popis
Adresář nenalezen
Označuje, že adresář neexistuje
Soubor nenalezen
Označuje, že soubor neexistuje
Čtení ze souboru se nezdařilo
Označuje problém se čtením ze souboru
Soubor neobsahuje platný dokument XML
Označuje, že soubor neobsahuje platný dokument XML
Zapsat XML do souboru
Zapsat obsah proměnné uzlu XML do souboru.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Cesta k souboru
Ne
Soubor
Soubor, do kterého se má zapsat dokument XML
XML k zápisu
Ne
Textová hodnota
Uzel nebo dokument XML, který se má zapsat do souboru
Kódování
–
Výchozí nastavení systému, ASCII, Unicode big endian, UTF-8
Výchozí systém
Kódování použité pro zadaný soubor
Formát adresy XML
–
Logická hodnota
True
Určuje, zda se má formátovat XML
Odsazení na úroveň
Ano
Číselná hodnota
2
Určuje, o kolik mezer se má odsadit každá úroveň XML
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný adresář
Označuje, že zadaný adresář je neplatný
Zápis XML do souboru se nezdařil
Označuje problém se zápisem XML do souboru
Provést výraz XPath
Extrahovat hodnoty z dokumentu XML na základě zadaného dotazu XPath.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML k analýze
Ne
Textová hodnota
XML jako text nebo dříve definovaná proměnná, která obsahuje dokument XML k analýze
Dotaz XPath
Ne
Textová hodnota
Výraz XPath, který se má provést proti dokumentu XML
Získat pouze první hodnotu
–
Logická hodnota
False
Určuje, zda načíst jednu hodnotu (pouze první hodnota), nebo všechny hodnoty, které odpovídají zadanému výrazu XPath
Vytvořené proměnné
Argument
Type
Popis
XPathResult
Uzel XML
Extrahované uzly jako uzel XML
XPathResults
Seznam uzlů XML
Extrahované uzly jako seznam uzlů XML
Výjimky
Výjimka
Popis
Zadán neplatný dokument XML
Označuje, že zadaný dokument XML je neplatný
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Získat atribut prvku XML
Získat hodnotu atributu prvku XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML nebo prvek XML, jehož atribut se má načíst
Dotaz XPath
Ano
Textová hodnota
Výraz XPath k vyhledání dílčího prvku a načtení jeho atributu
Attribute name
Ne
Textová hodnota
Název atributu, jehož hodnota se má načíst
Získat hodnotu jako
–
Textová hodnota, číselná hodnota, hodnota datetime, logická hodnota
Textová hodnota
Určuje datový typ pro hodnotu atributu
Vytvořené proměnné
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Atribut nebyl v prvku nalezen
Označuje, že atribut v prvku neexistuje
Nepodařilo se převést hodnotu atributu na požadovaný datový typ
Označuje problém při převodu hodnoty atributu na požadovaný datový typ
Nastavit atribut prvku XML
Nastavit hodnotu atributu prvku XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML nebo prvek XML, jehož atribut se má nastavit
Dotaz XPath
Ano
Textová hodnota
Výraz XPath k vyhledání dílčího prvku a nastavení jeho atributu
Attribute name
Ne
Textová hodnota
Název pole atributu, jehož hodnota se má nastavit
Hodnota atributu
Ne
Textová hodnota
Nová hodnota atributu
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Atribut XML se nepodařilo nastavit
Označuje problém s nastavením atributu XML
Odebrat atribut prvku XML
Odebrat atribut z prvku XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML nebo prvek XML, jehož atribut se má odebrat
Dotaz XPath
Ano
Textová hodnota
Výraz XPath k vyhledání dílčího prvku a odebrání jeho atributu
Attribute name
Ne
Textová hodnota
Název atributu, který se má odebrat
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Atribut nebyl v prvku nalezen
Označuje, že atribut v prvku neexistuje
Atribut XML se nepodařilo odstranit
Označuje problém s odstraněním atributu XML
Získat hodnotu prvku XML
Získat hodnotu prvku XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML nebo prvek XML, jehož hodnota se má načíst
Dotaz XPath
Ano
Textová hodnota
Výraz XPath k vyhledání dílčího prvku a načtení jeho hodnoty
Získat hodnotu jako
–
Textová hodnota, číselná hodnota, hodnota datetime, logická hodnota
Textová hodnota
Určuje datový typ pro hodnotu prvku XML
Vytvořené proměnné
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Nepodařilo se převést hodnotu prvku na požadovaný datový typ
Označuje problém při převodu hodnoty prvku na požadovaný datový typ
Nastavit hodnotu prvku XML
Nastavit hodnotu prvku XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML nebo prvek XML, jehož hodnota se má načíst
Dotaz XPath
Ano
Textová hodnota
Výraz XPath k vyhledání dílčího prvku a načtení jeho hodnoty
Hodnota prvku XML
Ne
Textová hodnota
Nová hodnota prvku XML
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Nepodařilo se nastavit hodnotu prvku
Označuje problém s nastavením hodnoty prvku
Vložit prvek XML
Vložit nový prvek XML do dokumentu XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML, do kterého se má vložit nový prvek XML
Dotaz XPath
Ne
Textová hodnota
Výraz XPath k vyhledání nadřazeného prvku XML, do kterého se má vložit nový prvek
Prvek XML, který se má vložit
Ne
Uzel XML
Nový prvek XML, který se má vložit do dokumentu XML
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Výraz XPath nevrací žádný prvek
Označuje, že výraz XPath nevrací žádný prvek
Vložení prvku XML se nezdařilo
Označuje problém s vložením prvku XML
Odebrat prvek XML
Odebrat jeden nebo více prvků XML z dokumentu XML.
Argument
Volitelné
Přijímá
Výchozí hodnota
Popis
Dokument XML
Ne
Uzel XML
Dokument XML, který obsahuje prvky XML k odebrání
Dotaz XPath
Ne
Textová hodnota
Výraz XPath k vyhledání prvků, které se mají odebrat
Vytvořené proměnné
Tato akce nevytváří žádné proměnné.
Výjimky
Výjimka
Popis
Zadán neplatný výraz XPath
Označuje, že zadaný výraz XPath je neplatný
Prvek XML se nepodařilo odstranit
Označuje problém s odstraněním prvku XML