Condividi tramite

Azioni per XML

  • Articolo

Power Automate fornisce la possibilità di utilizzare flussi desktop per gestire attributi ed elementi XML.

Per leggere un file XML, usare l'azione Leggi XML da file. Specificare il percorso oppure ricercare il file e selezionare una delle opzioni di codifica.

Dopo aver selezionato un file, usa l'azione Esegui espressione XPath per eseguire una query Xpath. L'esempio seguente utilizza una variabile prodotta dall'azione Leggi XML da file per specificare il documento.

Screenshot dell'azione Esegui espressione XPath.

Per recuperare un attributo da un file XML, usare l'azione Recupera attributo XML. Nell'esempio seguente, status è un attributo di client, che è un elemento di clientlist. Il valore verrà ottenuto come valore di testo.

Screenshot dell'azione Recupera attributo XML.

Allo stesso modo, per recuperare i valori degli elementi, usare l'azione Ottieni valore elemento XML. Puoi gestire elementi e attributi usando la rispettiva azione per recuperare, impostare o rimuovere elementi o attributi XML.

Leggi XML da file

Leggi il contenuto di un file XML in una variabile.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Percorso file No file File che contiene il documento XML da leggere
Codifica N/D Impostazione predefinita di sistema, ASCII, Unicode, Unicode (big-endian), UTF-8 Predefinito del sistema Codifica utilizzata per il file specificato

Variabili prodotte

Argomento Type Descrizione
XmlDocument Nodo XML Variabile che contiene il documento XML letto

Eccezioni

Eccezione Descrizione
Directory non trovata Indica che la directory non esiste
File non trovato Indica che il file non esiste
Impossibile leggere dal file Indica un problema durante la lettura dal file
Il file non contiene un documento XML valido Indica che il file non contiene un documento XML valido

Scrivi XML su file

Scrivi il contenuto della variabile di un nodo XML in un file.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Percorso file No file File in cui scrivere il documento XML
XML da scrivere No Valore di testo Documento o nodo XML da scrivere nel file
Codifica N/D Impostazione predefinita di sistema, ASCII, Unicode, Unicode (big-endian), UTF-8 Predefinito del sistema Codifica utilizzata per il file specificato
XML formato N/D Valore booleano Vero Specifica se formattare il codice XML
Rientro per livello Sì Valore numerico 2 Specifica di quanti spazi deve essere impostato il rientro di ogni livello del codice XML

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Directory non valida specificata Indica che la directory specificata non è valida
Impossibile scrivere XML su file Indica un problema durante la scrittura di codice XML su file

Eseguire l'espressione XPath

Estrai valori da un documento XML in base alla query XPath specificata.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML da analizzare No Valore di testo XML come testo o una variabile definita in precedenza che contiene il documento XML da analizzare
Query XPath No Valore di testo Espressione XPath da eseguire sul documento XML
Recupera solo il primo valore N/D Valore booleano False Specifica se recuperare un singolo valore (solo il primo valore) o tutti i valori corrispondenti all'espressione XPath specificata

Variabili prodotte

Argomento Tipo Descrizione
XPathResult Nodo XML I nodi estratti come nodo XML
XPathResults Elenco di nodi XML Nodi estratti come un elenco di nodi XML

Eccezioni

Eccezione Descrizione
Documento XML non valido fornito Indica che il documento XML fornito non è valido
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida

Recupera l'attributo dell'elemento XML

Recupera il valore di un attributo dell'elemento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Il documento XML o l'elemento XML di cui recuperare il relativo attributo
Query XPath Sì Valore di testo Espressione XPath per individuare l'elemento secondario e recuperarne l'attributo
Attribute name No Valore di testo Nome dell'attributo di cui recuperare il valore
Recupera valore come N/D Valore di testo, Valore numerico, Valore datetime, Valore booleano Valore di testo Specifica il tipo di dati per il valore dell'attributo

Variabili prodotte

Argomento Type Descrizione
XmlAttributeValue Valore booleano Valore recuperato dell'attributo XML
XmlAttributeValue Datetime Valore recuperato dell'attributo XML
XmlAttributeValue Valore numerico Valore recuperato dell'attributo XML
XmlAttributeValue Valore di testo Valore recuperato dell'attributo XML

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Attributo non trovato nell'elemento Indica che l'attributo non esiste nell'elemento
Impossibile convertire il valore dell'attributo nel tipo di dati richiesto Indica un problema durante la conversione del valore dell'attributo nel tipo di dati richiesto

Imposta attributo elemento XML

Imposta il valore di un attributo dell'elemento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Il documento XML o l'elemento XML di cui impostare l'attributo
Query XPath Sì Valore di testo Espressione XPath per individuare l'elemento secondario e impostarne l'attributo
Attribute name No Valore di testo Nome dell'attributo di cui impostare il valore
Valore attributo No Valore di testo Nuovo valore per l'attributo

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Impossibile impostare attributo XML Indica un problema durante l'impostazione dell'attributo XML

Rimuovi attributo elemento XML

Rimuovi un attributo da un elemento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Il documento XML o l'elemento XML di cui rimuovere l'attributo
Query XPath Sì Valore di testo Espressione XPath per individuare l'elemento secondario e rimuoverne l'attributo
Attribute name No Valore di testo Nome dell'attributo da rimuovere

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Attributo non trovato nell'elemento Indica che l'attributo non esiste nell'elemento
Impossibile rimuovere l'attributo XML Indica un problema durante la rimozione dell'attributo XML

Recupera valore elemento XML

Recupera il valore di un elemento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Il documento XML o l'elemento XML di cui recuperare il relativo valore
Query XPath Sì Valore di testo Espressione XPath per individuare l'elemento secondario e recuperarne il valore
Recupera valore come N/A Valore di testo, Valore numerico, Valore datetime, Valore booleano Valore di testo Specifica il tipo di dati per il valore dell'elemento XML

Variabili prodotte

Argomento Type Descrizione
XmlElementValue Valore booleano Valore elemento XML
XmlElementValue Datetime Valore elemento XML
XmlElementValue Valore numerico Valore elemento XML
XmlElementValue Valore di testo Valore elemento XML

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Impossibile convertire il valore dell'elemento nel tipo di dati richiesto Indica un problema durante la conversione del valore dell'elemento nel tipo di dati richiesto

Imposta valore elemento XML

Imposta il valore di un elemento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Il documento XML o l'elemento XML di cui recuperare il relativo valore
Query XPath Sì Valore di testo Espressione XPath per individuare l'elemento secondario e recuperarne il valore
Valore elemento XML No Valore di testo Nuovo valore per l'elemento XML

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Impossibile impostare il valore dell'elemento Indica un problema durante l'impostazione del valore dell'elemento

Inserisci elemento XML

Inserisci un nuovo elemento XML in un documento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Documento XML in cui inserire il nuovo elemento XML
Query XPath No Valore di testo Espressione XPath per individuare l'elemento XML padre e inserirvi il nuovo elemento
Elemento XML da inserire No Nodo XML Nuovo elemento XML da inserire nel documento XML

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
L'espressione XPath non restituisce alcun elemento Indica che l'espressione XPath non restituisce alcun elemento
Impossibile inserire l'elemento XML Indica un problema durante l'inserimento dell'elemento XML

Rimuovi elemento XML

Rimuovi uno o più elementi XML da un documento XML.

Parametri di input

Argomento Facoltativo Accetta Valore predefinito Descrizione
Documento XML No Nodo XML Documento XML che contiene gli elementi XML da rimuovere
Query XPath No Valore di testo Espressione XPath per individuare gli elementi da rimuovere

Variabili prodotte

Questa azione non produce variabili.

Eccezioni

Eccezione Descrizione
Espressione XPath non valida specificata Indica che l'espressione XPath specificata non è valida
Impossibile rimuovere elemento XML Indica un problema durante la rimozione dell'elemento XML