Εξαγωγή σελιδοποιημένης αναφοράς Power BI σε XML (Power BI Εργαλείο δόμησης αναφορών)

  • Άρθρο

ΙΣΕΙ ΓΙΑ: Power BI Εργαλείο δόμησης αναφορών Power BI Desktop

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

Σημείωμα

Μπορείτε να δημιουργήσετε και να τροποποιήσετε αρχεία ορισμού σελιδοποιημένης αναφοράς (.rdl) στο Power BI Εργαλείο δόμησης αναφορών.

Στοιχεία αναφοράς

Ο παρακάτω πίνακας περιγράφει τον τρόπο απόδοσης των στοιχείων αναφοράς.

Στοιχείο Συμπεριφορά απόδοσης
Report Αποδίδεται ως το στοιχείο ανώτατου επιπέδου του εγγράφου XML.
Περιοχές δεδομένων Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του. Οι περιοχές δεδομένων περιλαμβάνουν πίνακες, μήτρες και λίστα που εμφανίζουν δεδομένα ως κείμενο και γράφημα, ράβδους δεδομένων, γραφήματα sparkline, μετρητές και δείκτες που απεικονίζουν δεδομένα.
Ενότητες ομάδας και λεπτομερειών Κάθε παρουσία αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ.
Text box Αποδίδεται ως χαρακτηριστικό ή στοιχείο μέσα στο κοντέινερ του.
Ορθογώνιο Αποδίδεται ως στοιχείο εντός του κοντέινερ του.
Ομάδες στηλών μήτρας Αποδίδεται ως στοιχεία εντός ομάδων γραμμών.
Χάρτης Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του. Τα επίπεδα χάρτη είναι θυγατρικά στοιχεία του χάρτη και κάθε επίπεδο χάρτη περιλαμβάνει στοιχεία για τα μέλη του χάρτη και τα χαρακτηριστικά των μελών χάρτη.
Γράφημα Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του. Οι σειρές είναι θυγατρικά στοιχεία του γραφήματος και οι κατηγορίες είναι θυγατρικό στοιχείο μιας σειράς. Αποδίδει όλες τις ετικέτες γραφήματος για κάθε τιμή γραφήματος. Οι ετικέτες και οι τιμές περιλαμβάνονται ως χαρακτηριστικά.
Γραμμή δεδομένων Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του, όμοια με ένα γράφημα. Συνήθως, μια γραμμή δεδομένων δεν περιλαμβάνει ιεραρχίες ή ετικέτες, μόνο τιμές.
Γράφημα sparkline Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του, όμοια με ένα γράφημα. Συνήθως, ένα sparkline δεν περιλαμβάνει ιεραρχίες ή ετικέτες, μόνο τιμές.
Μετρητής Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του. Αποδίδεται ως ένα μοναδικό στοιχείο με τις ελάχιστες και μέγιστες τιμές της κλίμακας, τις τιμές έναρξης και λήξης της περιοχής και την τιμή του δείκτη ως χαρακτηριστικά.
Ένδειξη Αποδίδεται ως στοιχείο εντός του στοιχείου για το κοντέινερ του, όμοια με έναν μετρητή. Αποδίδεται ως ένα μοναδικό στοιχείο με το ενεργό όνομα κατάστασης, τις διαθέσιμες καταστάσεις και την τιμή δεδομένων ως χαρακτηριστικά.

Οι αναφορές που αποδίδονται με χρήση της επέκτασης απόδοσης XML ακολουθούν επίσης τους εξής κανόνες:

  • Τα στοιχεία XML και χαρακτηριστικά αποδίδονται με τη σειρά που εμφανίζονται στον ορισμό αναφοράς.

  • Η σελιδοποίηση παραβλέπεται.

  • Οι κεφαλίδες και τα υποσέλιδα σελίδας δεν αποδίδονται.

  • Τα κρυφά στοιχεία που δεν είναι δυνατό να γίνουν ορατά με εναλλαγή δεν αποδίδονται. Αποδίδονται αρχικά ορατά στοιχεία και κρυφά στοιχεία που μπορούν να γίνουν ορατά μέσω ενός διακόπτη εναλλαγής.

  • Οι εικόνες, οι γραμμές και τα προσαρμοσμένα στοιχεία αναφοράς παραβλέπονται.

Τύποι δεδομένων

Στο στοιχείο ή χαρακτηριστικό του πλαισίου κειμένου εκχωρείται ένας τύπος δεδομένων XSD με βάση τις τιμές που εμφανίζει το πλαίσιο κειμένου.

Εάν όλες οι τιμές του πλαισίου κειμένου είναι Ο τύπος δεδομένων που έχει αντιστοιχιστεί είναι
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Δεκαδικά στοιχεία (ή Δεκαδικά και οποιοσδήποτε ακέραιος τύπος δεδομένων ή byte) xsd:decimal
Κινητή υποδιαστολή (ή Δεκαδικός και οποιοσδήποτε τύπος δεδομένων ακέραιου ή byte) xsd:float
Διπλή (ή Δεκαδική και οποιοσδήποτε ακέραιος τύπος δεδομένων ή byte) xsd:double
Μετατόπιση ημερομηνίας/ώρας ή ημερομηνίας/ώρας xsd:dateTime
Time xsd:string
Δυαδική τιμή xsd:boolean
Συμβολοσειρά, Char xsd:string
Άλλες xsd:string

Κανόνες απόδοσης xml

Οι παρακάτω ενότητες περιγράφουν τον τρόπο με τον οποίο οι επεκτάσεις απόδοσης XML ερμηνεύουν τα στοιχεία εντός της αναφοράς.

Σώμα αναφοράς

Μια αναφορά αποδίδεται ως το ριζικό στοιχείο του εγγράφου XML. Το όνομα του στοιχείου προέρχεται από την ιδιότητα DataElementName που έχει οριστεί στο τμήμα παραθύρου Ιδιότητες.

Οι ορισμοί χώρου ονομάτων XML και τα χαρακτηριστικά αναφοράς σχήματος περιλαμβάνονται επίσης στο στοιχείο αναφοράς. Οι μεταβλητές σημειώνονται με έντονη γραφή στον τύπο προσώπου:

<Report xmlns="SchemaName" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaNameReportURL&rc%3aSchema=true" Name="ReportName">

Οι τιμές για τις μεταβλητές είναι οι εξής:

Πλήρες όνομα Τιμή
Report Report.DataElementName
Διεύθυνση URL αναφοράς URLΕνωδικευμένες απόλυτες διευθύνσεις URL για την αναφορά στο διακομιστή.
Όνομα σχήματος Report.SchemaName. Εάν είναι null, τότε Report.Name. Εάν χρησιμοποιείται Report.Name, κωδικοποιείται πρώτα με XmlConvert.EncodeLocalName.
Όνομα αναφοράς Το όνομα της αναφοράς.

Πλαίσια κειμένου

Τα πλαίσια κειμένου αποδίδονται ως στοιχεία ή χαρακτηριστικά σύμφωνα με την ιδιότητα DataElementStyle RDL. Το όνομα του στοιχείου ή χαρακτηριστικού προέρχεται από την ιδιότητα TextBox.DataElementName RDL.

Γραφήματα, ράβδοι δεδομένων και γραφήματα sparkline

Τα γραφήματα, οι ράβδοι δεδομένων και τα γραφήματα sparkline αποδίδονται σε XML. Τα δεδομένα είναι δομημένα.

Μετρητές και δείκτες

Οι μετρητές και οι δείκτες αποδίδονται σε XML. Τα δεδομένα είναι δομημένα.

Δευτερεύουσες αναφορές

Μια δευτερεύουσα αναφορά αποδίδεται ως στοιχείο. Το όνομα του στοιχείου λαμβάνεται από την ιδιότητα RDL DataElementName. Η ρύθμιση ιδιότητας TextBoxesAsElements της αναφοράς παρακάμπτει εκείνη της δευτερεύουσας αναφοράς. Ο χώρος ονομάτων και τα χαρακτηριστικά XSLT δεν προστίθενται στο στοιχείο δευτερεύουσας αναφοράς.

Ορθογώνια

Ένα ορθογώνιο αποδίδεται ως στοιχείο. Το όνομα του στοιχείου λαμβάνεται από την ιδιότητα RDL DataElementName.

Προσαρμοσμένα στοιχεία αναφοράς

Το CustomReportItems (CRI) δεν είναι ορατό στην επέκταση απόδοσης. Εάν υπάρχει ένα προσαρμοσμένο στοιχείο αναφοράς στην αναφορά, η επέκταση απόδοσης το αποδίδει ως συμβατικό στοιχείο αναφοράς.

Εικόνες

Οι εικόνες δεν αποδίδονται.

Γραμμές

Οι γραμμές δεν αποδίδονται.

Πίνακες, μήτρες και λίστες

Οι πίνακες, οι μήτρες και οι λίστες αποδίδονται ως στοιχείο. Το όνομα του στοιχείου προέρχεται από την ιδιότητα RDL Tablix DataElementName.

Γραμμές και στήλες

Οι στήλες αποδίδονται μέσα σε γραμμές.

Γωνία Tablix

Η γωνία δεν αποδίδεται. Αποδίδονται μόνο τα περιεχόμενα της γωνίας.

Κελιά Tablix

Τα κελιά Tablix αποδίδονται ως στοιχεία. Το όνομα του στοιχείου λαμβάνεται από την ιδιότητα RDL DataElementName του κελιού.

Αυτόματα μερικά αθροίσματα

Τα αυτόματα μερικά αθροίσματα Tablix δεν αποδίδονται.

Στοιχεία γραμμών και στηλών που δεν επαναλαμβάνονται με μια ομάδα

Τα στοιχεία που δεν επαναλαμβάνονται με μια ομάδα, όπως ετικέτες, μερικά αθροίσματα και σύνολα, αποδίδονται ως στοιχεία. Το όνομα του στοιχείου προέρχεται από την ιδιότητα RDL TablixMember.DataElementName.

Η ιδιότητα TablixMember.DataElementOutput RDL ελέγχει εάν αποδίδεται ένα μη επαναλαμβανόμενο στοιχείο.

Εάν δεν παρέχεται η ιδιότητα DataElementName του μέλους Tablix, δημιουργείται δυναμικά ένα όνομα για το μη επαναλαμβανόμενο στοιχείο σε αυτήν τη φόρμα:

RowX Για μη επαναλαμβανόμενες γραμμές, όπου X είναι ένας δείκτης γραμμής με βάση το μηδέν εντός του τρέχοντος γονικού στοιχείου.

ColumnY Για μη επαναλαμβανόμενες στήλες, όπου Y ix ένας δείκτης στήλης με βάση το μηδέν εντός του τρέχοντος γονικού στοιχείου.

Μια μη επαναλαμβανόμενη κεφαλίδα αποδίδεται ως θυγατρικό στοιχείο της γραμμής ή στήλης που δεν επαναλαμβάνεται με μια ομάδα.

Εάν ένα μη επαναλαμβανόμενο μέλος δεν έχει αντίστοιχα κελιά Tablix, δεν αποδίδεται. Αυτό μπορεί να συμβεί στην περίπτωση ενός κελιού Tablix στο οποίο εκτείνεται σε περισσότερες από μία στήλες.

Γραμμές και στήλες που επαναλαμβάνονται με μια ομάδα

Οι γραμμές και οι στήλες που επαναλαμβάνονται μέσα σε μια ομάδα αποδίδονται σύμφωνα με τους κανόνες Tablix.DataElementOutput. Το όνομα για το στοιχείο λαμβάνεται από την ιδιότητα DataElementName.

Κάθε μοναδική τιμή μέσα σε μια ομάδα αποδίδεται ως θυγατρικό στοιχείο της ομάδας. Το όνομα για το στοιχείο λαμβάνεται από την ιδιότητα Group.DataElementName.

Εάν η τιμή ιδιότητας DataElementOutput ισούται με Output, η κεφαλίδα ενός επαναλαμβανόμενου στοιχείου αποδίδεται ως θυγατρικό στοιχείο του στοιχείου λεπτομερειών.

Προσαρμοσμένες μορφές και μετασχηματισμοί XSL

Τα αρχεία XML που παράγονται από την επέκταση απόδοσης XML μπορούν να μετατραριστούν σχεδόν σε οποιαδήποτε μορφή χρησιμοποιώντας μετασχηματισμούς XSL (XSLT). Αυτή η λειτουργικότητα μπορεί να χρησιμοποιηθεί για την παραγωγή δεδομένων σε μορφές που δεν υποστηρίζονται ήδη από υπάρχουσες επεκτάσεις απόδοσης. Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε την επέκταση απόδοσης XML και το XSLT προτού επιχειρήσετε να δημιουργήσετε τη δική σας επέκταση απόδοσης.

Διπλότυπα ονόματα

Εάν υπάρχουν διπλότυπα ονόματα στοιχείων δεδομένων εντός της ίδιας εμβέλειας, η απόδοση εμφανίζει ένα μήνυμα σφάλματος.

Μετασχηματισμοί XSLT

Η απόδοση XML μπορεί να εφαρμόσει έναν μετασχηματισμό XSLT στην πλευρά του διακομιστή στα αρχικά δεδομένα XML. Όταν εφαρμόζεται ένα XSLT, η απόδοση εξάγει το μετασχηματισμένο περιεχόμενο αντί για τα αρχικά δεδομένα XML. Ο μετασχηματισμός πραγματοποιείται στον διακομιστή, όχι στον υπολογιστή-πελάτη.

Το XSLT που θα εφαρμοστεί στην έξοδο ορίζεται είτε στο αρχείο ορισμού αναφοράς με την ιδιότητα DataTransform της αναφοράς είτε με την παράμετρο XSLT DeviceInfo . Εάν οποιαδήποτε από αυτές τις τιμές οριστεί, ο μετασχηματισμός πραγματοποιείται κάθε φορά που χρησιμοποιείται η απόδοση XML. Όταν χρησιμοποιείτε συνδρομές, το XSLT πρέπει να ορίζεται στην ιδιότητα RDL DataTransform.

Εάν καθοριστεί ένα αρχείο XSLT, τόσο με την ιδιότητα ορισμού DataTransform όσο και με τη ρύθμιση πληροφοριών συσκευής, θα προκύψει πρώτα το XSLT που καθορίζεται στην DataTransform, ακολουθούμενο από το XSLT που ορίζεται από τις ρυθμίσεις πληροφοριών συσκευής.

Ρυθμίσεις πληροφοριών συσκευής

Μπορείτε να αλλάξετε ορισμένες προεπιλεγμένες ρυθμίσεις για αυτή την απόδοση αλλάζοντας τις ρυθμίσεις πληροφοριών συσκευής, συμπεριλαμβανομένων των εξής:

  • Ένας μετασχηματισμός (XSLT) που θα εφαρμοστεί στο XML.

  • Ο τύπος MIME του εγγράφου XML.

  • Εάν θα εφαρμοστούν συμβολοσειρές μορφοποίησης σε δεδομένα.

  • Εάν θέλετε να εσοχή στην έξοδο XML.

  • Εάν θέλετε να συμπεριλάβετε το όνομα σχήματος XML.

  • Η κωδικοποίηση για το έγγραφο XML.

  • Η επέκταση αρχείου του εγγράφου XML.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ρυθμίσεις πληροφοριών συσκευής XML.

Σχετικό περιεχόμενο