Κοινή χρήση μέσω

Ενέργειες XML

  • Άρθρο

Το Power Automate παρέχει τη δυνατότητα χρήσης ροών επιφάνειας εργασίας για τη διαχείριση χαρακτηριστικών και στοιχείων XML.

Για να διαβάσετε ένα αρχείο XML, χρησιμοποιήστε την ενέργεια Ανάγνωση XML από αρχείο. Καθορίστε τη διαδρομή ή αναζητήστε το αρχείο και επιλέξτε μία από τις επιλογές κωδικοποίησης.

Αφού επιλέξετε ένα αρχείο, χρησιμοποιήστε την ενέργεια Εκτέλεση παράστασης XPath για να εκτελέσετε ένα ερώτημα Xpath. Στο παρακάτω παράδειγμα χρησιμοποιείται μια παραγόμενη μεταβλητή από την ενέργεια Ανάγνωση XML από το αρχείο για τον καθορισμό του εγγράφου.

Στιγμιότυπο οθόνης της ενέργειας Εκτέλεση παράστασης XPath.

Για να ανακτήσετε ένα χαρακτηριστικό από ένα αρχείο XML, χρησιμοποιήστε την ενέργεια Λήψη χαρακτηριστικού XML. Στο παρακάτω παράδειγμα, η κατάσταση είναι ένα χαρακτηριστικό του προγράμματος-πελάτη, το οποίο είναι ένα στοιχείο της λίστας πελατών. Η τιμή θα ληφθεί ως τιμή κειμένου.

Στιγμιότυπο οθόνης της ενέργειας Λήψη χαρακτηριστικού XML.

Ομοίως, για την ανάκτηση τιμών στοιχείου, χρησιμοποιήστε την ενέργεια Λήψη τιμής στοιχείου XML. Μπορείτε να διαχειριστείτε στοιχεία και χαρακτηριστικά με τη χρήση της αντίστοιχης ενέργειας για λήψη, ορισμό ή κατάργηση χαρακτηριστικών ή στοιχείων XML.

Ανάγνωση XML από αρχείο

Ανάγνωση των περιεχομένων ενός αρχείου XML σε μια μεταβλητή.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Διαδρομή αρχείου Όχι Αρχείο Το αρχείο που περιέχει το έγγραφο XML για ανάγνωση
Κωδικοποίηση ΔΙ Προεπιλογή συστήματος, ASCII, Unicode, Unicode big endian, UTF-8 Προεπιλογή συστήματος Η κωδικοποίηση που χρησιμοποιήθηκε για το καθορισμένο αρχείο

Μεταβλητές που δημιουργήθηκαν

Όρισμα Type Description
XmlDocument Κόμβος XML Η μεταβλητή που περιέχει το έγγραφο XML ανάγνωσης

Εξαιρέσεις

Εξαίρεση Περιγραφή
Ο κατάλογος δεν βρέθηκε Υποδεικνύει ότι ο κατάλογος δεν υπάρχει
Το αρχείο δεν βρέθηκε Υποδεικνύει ότι το αρχείο δεν υπάρχει
Η ανάγνωση από το αρχείο απέτυχε Υποδεικνύει πρόβλημα ανάγνωσης από το αρχείο
Το αρχείο δεν περιέχει ένα έγκυρο έγγραφο XML Υποδεικνύει ότι το αρχείο δεν περιέχει ένα έγκυρο έγγραφο XML

Εγγραφή XML στο αρχείο

Εγγραφή των περιεχομένων μιας μεταβλητής κόμβου XML σε ένα αρχείο.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Διαδρομή αρχείου Όχι Αρχείο Το αρχείο στο οποίο θα γίνει η εγγραφή του εγγράφου XML
XML για εγγραφή Όχι Τιμή κειμένου Ο κόμβος ή το έγγραφο XML για εγγραφή στο αρχείο
Κωδικοποίηση ΔΙ Προεπιλογή συστήματος, ASCII, Unicode, Unicode big endian, UTF-8 Προεπιλογή συστήματος Η κωδικοποίηση που χρησιμοποιήθηκε για το καθορισμένο αρχείο
Μορφοποίηση XML ΔΙ Δυαδική τιμή Ενεργή Καθορίζει αν θα μορφοποιηθεί το XML
Δημιουργία εσοχής ανά επίπεδο Ναι Αριθμητική τιμή 2 Καθορίζει από πόσα κενά διαστήματα θα δημιουργηθεί εσοχή σε κάθε επίπεδο του XML

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Έχει καθοριστεί μη έγκυρος κατάλογος Υποδεικνύει ότι ο καθορισμένος κατάλογος δεν είναι έγκυρος
Απέτυχε η εγγραφή XML στο αρχείο Υποδεικνύει πρόβλημα εγγραφής XML στο αρχείο

Εκτέλεση παράστασης XPath

Εξαγωγή τιμών από ένα έγγραφο XML με βάση το παρεχόμενο ερώτημα XPath.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML για ανάλυση Όχι Τιμή κειμένου Το XML ως κείμενο ή μια προηγουμένως ορισμένη μεταβλητή που περιέχει το έγγραφο XML για ανάλυση
Ερώτημα XPath Όχι Τιμή κειμένου Η παράσταση XPath για εκτέλεση έναντι του εγγράφου XML
Λήψη μόνο της πρώτης τιμής ΔΙ Δυαδική τιμή Ανενεργή Καθορίζει εάν θα ανακτηθεί μια μεμονωμένη τιμή (μόνο η πρώτη τιμή) ή όλες οι τιμές που ταιριάζουν με την παρεχόμενη παράσταση XPath

Μεταβλητές που δημιουργήθηκαν

Όρισμα Type Description
XPathResult Κόμβος XML Οι κόμβοι που εξήχθησαν ως κόμβοι XML
XPathResults Λίστακόμβων XML Οι κόμβοι που εξήχθησαν ως λίστα κόμβων XML

Εξαιρέσεις

Εξαίρεση Περιγραφή
Καθορίστηκε μη έγκυρο έγγραφο XML Υποδεικνύει ότι το παρεχόμενο έγγραφο XML δεν είναι έγκυρο
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη

Λήψη χαρακτηριστικού του στοιχείου XML

Λάβετε την τιμή ενός χαρακτηριστικού ενός στοιχείου XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML ή το στοιχείο XML για την ανάκτηση του χαρακτηριστικού του
Ερώτημα XPath Ναι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του δευτερεύοντος στοιχείου και την ανάκτηση του χαρακτηριστικού του
Attribute name Όχι Τιμή κειμένου Το όνομα του χαρακτηριστικού για ανάκτηση της τιμής του
Λήψη τιμής ως ΔΙ Τιμή κειμένου, Αριθμητική τιμή, τιμή Datetime, δυαδική τιμή Τιμή κειμένου Καθορίζει τον τύπο δεδομένων για την τιμή του χαρακτηριστικού

Μεταβλητές που δημιουργήθηκαν

Όρισμα Type Description
XmlAttributeValue Δυαδική τιμή Η ανακτημένη τιμή του χαρακτηριστικού XML
XmlAttributeValue Ημερομηνία/ώρα Η ανακτημένη τιμή του χαρακτηριστικού XML
XmlAttributeValue Αριθμητική τιμή Η ανακτημένη τιμή του χαρακτηριστικού XML
XmlAttributeValue Τιμή κειμένου Η ανακτημένη τιμή του χαρακτηριστικού XML

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Το χαρακτηριστικό δεν βρέθηκε στο στοιχείο Υποδεικνύει ότι το χαρακτηριστικό δεν υπάρχει στο στοιχείο
Απέτυχε η μετατροπή της τιμής του χαρακτηριστικού στον τύπο δεδομένων που ζητήθηκε Υποδεικνύει ένα πρόβλημα μετατροπής της τιμής του χαρακτηριστικού στον τύπο δεδομένων που ζητήθηκε

Ορισμός χαρακτηριστικού του στοιχείου XML

Ορίστε την τιμή ενός χαρακτηριστικού ενός στοιχείου XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML ή το στοιχείο XML για τον ορισμό του χαρακτηριστικού του
Ερώτημα XPath Ναι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του δευτερεύοντος στοιχείου και τον ορισμό του χαρακτηριστικού του
Attribute name Όχι Τιμή κειμένου Το όνομα του χαρακτηριστικού για τον ορισμό της τιμής του
Τιμή χαρακτηριστικού Όχι Τιμή κειμένου Η νέα τιμή για το χαρακτηριστικό

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Απέτυχε η ρύθμιση του χαρακτηριστικού XML Υποδεικνύει πρόβλημα κατά τη ρύθμιση του χαρακτηριστικού XML

Κατάργηση χαρακτηριστικού του στοιχείου XML

Κατάργηση ενός χαρακτηριστικού από ένα στοιχείο XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML ή το στοιχείο XML για την κατάργηση του χαρακτηριστικού του
Ερώτημα XPath Ναι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του δευτερεύοντος στοιχείου και την κατάργηση του χαρακτηριστικού του
Attribute name Όχι Τιμή κειμένου Το όνομα του χαρακτηριστικού προς κατάργηση

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Το χαρακτηριστικό δεν βρέθηκε στο στοιχείο Υποδεικνύει ότι το χαρακτηριστικό δεν υπάρχει στο στοιχείο
Η κατάργηση του χαρακτηριστικού XML Υποδεικνύει πρόβλημα κατά την κατάργηση του χαρακτηριστικού XML

Λήψη της τιμής του στοιχείου XML

Λάβετε την τιμή ενός στοιχείου XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML ή το στοιχείο XML για την ανάκτηση της τιμής του
Ερώτημα XPath Ναι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του δευτερεύοντος στοιχείου και την ανάκτηση της τιμής του
Λήψη τιμής ως ΔΙ Τιμή κειμένου, Αριθμητική τιμή, τιμή Datetime, δυαδική τιμή Τιμή κειμένου Καθορίζει τον τύπο δεδομένων για την τιμή του στοιχείου XML

Μεταβλητές που δημιουργήθηκαν

Όρισμα Type Description
XmlElementValue Δυαδική τιμή Η τιμή του στοιχείου XML
XmlElementValue Ημερομηνία/ώρα Η τιμή του στοιχείου XML
XmlElementValue Αριθμητική τιμή Η τιμή του στοιχείου XML
XmlElementValue Τιμή κειμένου Η τιμή του στοιχείου XML

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Απέτυχε η μετατροπή της τιμής του στοιχείου στον τύπο δεδομένων που ζητήθηκε Υποδεικνύει ένα πρόβλημα μετατροπής της τιμής του στοιχείου στον τύπο δεδομένων που ζητήθηκε

Ορισμός της τιμής του στοιχείου XML

Ορίστε την τιμή ενός στοιχείου XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML ή το στοιχείο XML για την ανάκτηση της τιμής του
Ερώτημα XPath Ναι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του δευτερεύοντος στοιχείου και την ανάκτηση της τιμής του
Τιμή στοιχείου XML Όχι Τιμή κειμένου Η νέα τιμή για το στοιχείο XML

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Ο ορισμός της τιμής του στοιχείου απέτυχε Υποδεικνύει πρόβλημα κατά τη ρύθμιση της τιμής του στοιχείου

Εισαγωγή στοιχείου XML

Εισαγωγή ενός νέου στοιχείου XML σε ένα έγγραφο XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML για την εισαγωγή του νέου στοιχείου XML
Ερώτημα XPath Όχι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό του γονικού στοιχείου XML και την εισαγωγή του νέου στοιχείου σε αυτό
Στοιχείο XML για εισαγωγή Όχι Κόμβος XML Το νέο στοιχείο XML για εισαγωγή στο έγγραφο XML

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Η παράσταση XPath δεν επιστρέφει κανένα στοιχείο Υποδεικνύει ότι η παράσταση XPath δεν επιστρέφει κανένα στοιχείο
Απέτυχε η εισαγωγή του στοιχείου XML Υποδεικνύει πρόβλημα κατά την εισαγωγή του στοιχείου XML

Κατάργηση στοιχείου XML

Κατάργηση ενός ή περισσότερων στοιχείων XML από ένα έγγραφο XML.

Παράμετροι εισόδου

Όρισμα Προαιρετικές Αποδοχή Προεπιλεγμένη τιμή Description
Έγγραφο XML Όχι Κόμβος XML Το έγγραφο XML που περιέχει τα στοιχεία XML προς κατάργηση
Ερώτημα XPath Όχι Τιμή κειμένου Η παράσταση XPath για τον εντοπισμό των στοιχείων προς κατάργηση

Μεταβλητές που δημιουργήθηκαν

Αυτή η ενέργεια δεν παράγει μεταβλητές.

Εξαιρέσεις

Εξαίρεση Description
Καθορίστηκε μη έγκυρη παράσταση XPath Υποδεικνύει ότι η παρεχόμενη παράσταση XPath δεν είναι έγκυρη
Απέτυχε η κατάργηση του στοιχείου XML Υποδεικνύει πρόβλημα κατά την κατάργηση του στοιχείου XML