Γλώσσα ορισμού αναφοράς (RDL)
ΙΣΕΙ ΓΙΑ:
Power BI Εργαλείο δόμησης αναφορών 
Power BI Desktop
Η Γλώσσα ορισμού αναφοράς (RDL) είναι μια αναπαράσταση XML ενός ορισμού σελιδοποιημένης αναφοράς. Ένας ορισμός αναφοράς περιέχει πληροφορίες ανάκτησης δεδομένων και διάταξης για μια αναφορά. Το RDL αποτελείται από στοιχεία XML που αντιστοιχούν σε γραμματική XML που δημιουργήθηκε για το Power BI. Μπορείτε να προσθέσετε τις δικές σας προσαρμοσμένες συναρτήσεις για τον έλεγχο τιμών στοιχείων αναφοράς, στυλ και μορφοποίησης, αποδόμησης μπλοκ κώδικα σε αρχεία ορισμού αναφοράς.
Η RDL προωθεί τη διαλειτουργικότητα των προϊόντων εμπορικής αναφοράς, καθορίζοντας ένα κοινό σχήμα που επιτρέπει την ανταλλαγή ορισμών αναφοράς. Οποιοδήποτε πρωτόκολλο ή προγραμματική διασύνδεση που λειτουργεί με XML μπορεί να χρησιμοποιηθεί με το RDL. Η RDL είναι:
- Ένα σχήμα XML για ορισμούς αναφοράς.
- Μια μορφή ανταλλαγής για επιχειρήσεις και τρίτα μέρη.
- Ένα επεκτάσιμο και ανοιχτό σχήμα που υποστηρίζει πρόσθετους χώρους ονομάτων και προσαρμοσμένα στοιχεία.
Προδιαγραφές RDL
Για να κάνετε λήψη προδιαγραφών για συγκεκριμένες εκδόσεις σχήματος, ανατρέξτε στο θέμα Προδιαγραφή γλώσσας ορισμού αναφοράς.
Ορισμός σχήματος RDL XML
Το αρχείο γλώσσας ορισμού αναφοράς (RDL) επικυρώνεται χρησιμοποιώντας ένα αρχείο ορισμού σχήματος XML (XSD). Το σχήμα ορίζει τους κανόνες για το πού μπορούν να προκύψουν στοιχεία RDL σε ένα αρχείο .rdl. Ένα στοιχείο περιλαμβάνει τον τύπο δεδομένων και την πληθικότητα, δηλαδή τον αριθμό των εμφανίσεων που επιτρέπονται. Ένα στοιχείο μπορεί να είναι απλό ή σύνθετο. Ένα απλό στοιχείο δεν διαθέτει θυγατρικά στοιχεία ή χαρακτηριστικά. Ένα σύνθετο στοιχείο έχει θυγατρικά στοιχεία και, προαιρετικά, χαρακτηριστικά.
Για παράδειγμα, το σχήμα περιλαμβάνει το στοιχείο RDL ReportParameters, το οποίο είναι ο σύνθετος τύπος ReportParametersType. Κατά σύμβαση, ένας σύνθετος τύπος για ένα στοιχείο είναι το όνομα του στοιχείου που ακολουθείται από τη λέξη Τύπος. Ένα στοιχείο ReportParameters μπορεί να περιέχεται από το στοιχείο Αναφορά (ένας σύνθετος τύπος) και μπορεί να περιέχει στοιχεία ReportParameter . Ένα ReportParameterType είναι ένας απλός τύπος που μπορεί να είναι μόνο μία από τις ακόλουθες τιμές: Δυαδική τιμή, DateTime, Ακέραιος, Κινητή υποδιαστολή ή Συμβολοσειρά. Για περισσότερες πληροφορίες σχετικά με τους τύπους δεδομένων σχήματος XML, ανατρέξτε στο θέμα Σχήμα XML Μέρος 2: Τύποι δεδομένων Δεύτερη έκδοση.
Δημιουργία RDL
Λόγω της ανοιχτής και επεκτάσιμης φύσης της RDL, μπορεί να δημιουργηθεί μια ποικιλία εργαλείων και εφαρμογών που δημιουργούν RDL με βάση το σχήμα XML.
Το Power BI Εργαλείο δόμησης αναφορών είναι ο προτιμώμενος τρόπος σύνταξης σελιδοποιημένων αναφορών που βασίζονται σε RDL.
Ένας από τους ευκολότερους τρόπους για να δημιουργήσετε RDL από μια εφαρμογή είναι να χρησιμοποιήσετε τις κλάσεις Microsoft .NET Framework του χώρου ονομάτων και System.Linq του System.Xml χώρου ονομάτων. Μία κλάση ειδικότερα, η κλάση XmlTextWriter , μπορεί να χρησιμοποιηθεί για τη σύνταξη RDL. Με το XmlTextWriter, μπορείτε να δημιουργήσετε έναν πλήρη ορισμό αναφοράς από την αρχή έως το τέλος σε οποιαδήποτε εφαρμογή .NET Framework. Οι προγραμματιστές μπορούν επίσης να επεκτείνουν το RDL, προσθέτοντας προσαρμοσμένα στοιχεία αναφοράς με προσαρμοσμένες ιδιότητες. Για περισσότερες πληροφορίες σχετικά με την κλάση XmlTextWriter και τον System.Xml χώρο ονομάτων, ανατρέξτε στο θέμα Οδηγός προγραμματιστών του Microsoft .NET Framework. Για περισσότερες πληροφορίες σχετικά με το ενοποιημένο ερώτημα γλώσσας (LINQ), κάντε αναζήτηση για "LINQ σε XML" στο MSDN.
Η τυπική επέκταση αρχείου για αρχεία ορισμού αναφοράς είναι .rdl. Ο τύπος MIME είναι κείμενο/xml.
Τύποι RDL
Ο παρακάτω πίνακας παραθέτει τύπους που χρησιμοποιούνται σε στοιχεία και χαρακτηριστικά RDL.
| Τύπος | Description |
|---|---|
| Δυαδική | Μια ιδιότητα με μια κωδικοποιημένη δυαδική τιμή base-64. |
| Δυαδική τιμή | Μια ιδιότητα με τιμή true ή false ως τιμή του αντικειμένου. Εκτός εάν ορίζεται διαφορετικά, η τιμή ενός προαιρετικού δυαδικού αντικειμένου που παραλείπεται είναι False. |
| Ημερομηνία | Μια ιδιότητα με μια πλήρως καθορισμένη τιμή ημερομηνίας ή ημερομηνίας/ώρας που καθορίζεται σε ISO8601 μορφή ημερομηνίας: ΕΕΕΕ-ΜΜ-ΗΗ[THH:ΜΜ[:SS[. S]]]. |
| Απαρίθμηση | Μια ιδιότητα με μια τιμή κειμένου συμβολοσειράς που πρέπει να είναι μία από μια λίστα καθορισμένων τιμών. |
| Επιπλέουν | Μια ιδιότητα με τιμή κινητής υποδιαστολής. Χρησιμοποιείται μια τελεία (.) ως προαιρετικό διαχωριστικό δεκαδικών. |
| Ακέραιος | Μια ιδιότητα με τιμή ακέραιου (int32). |
| Γλώσσα | Μια ιδιότητα με μια τιμή κειμένου που περιέχει έναν κωδικό γλώσσας και κουλτούρας, όπως "en-us" για τα Αγγλικά Η.Π.Α. Η τιμή πρέπει να είναι είτε μια συγκεκριμένη γλώσσα είτε μια ουδέτερη γλώσσα για την οποία έχει οριστεί μια προεπιλεγμένη γλώσσα στο Microsoft .NET Framework. |
| Όνομα. | Μια ιδιότητα με μια τιμή κειμένου συμβολοσειράς. Τα ονόματα πρέπει να είναι μοναδικά εντός του χώρου ονομάτων του στοιχείου. Εάν δεν καθοριστεί, ο χώρος ονομάτων για ένα στοιχείο είναι το εσωτερικό αντικείμενο που περιέχει ένα όνομα. |
| Κανονικοποιημένη συμβολοσειρά | Μια ιδιότητα με μια τιμή κειμένου συμβολοσειράς που έχει κανονικοποιηθεί. |
| Μέγεθος | Ένα στοιχείο μεγέθους πρέπει να περιέχει έναν αριθμό (με έναν χαρακτήρα περιόδου που χρησιμοποιείται ως προαιρετικό διαχωριστικό δεκαδικών). Ο αριθμός πρέπει να ακολουθείται από ένα προσαυξητή για μια μονάδα μήκους CSS όπως cm, mm, in, pt ή pc. Ένα διάστημα μεταξύ του αριθμού και του προσαυξητή είναι προαιρετικό. Για περισσότερες πληροφορίες σχετικά με τους σχεδιαστές μεγέθους, ανατρέξτε στο θέμα Τιμές CSS και Αναφορά μονάδων. Στην RDL, η μέγιστη τιμή για το Μέγεθος είναι 160 in. Το ελάχιστο μέγεθος είναι 0 in. |
| Συμβολοσειρά | Μια ιδιότητα με μια τιμή κειμένου συμβολοσειράς. |
| UnsignedInt | Μια ιδιότητα με τιμή ακέραιου χωρίς υπογραφή (uint32). |
| Παραλλαγή | Μια ιδιότητα με οποιονδήποτε απλό τύπο XML. |
Τύποι δεδομένων RDL
Η απαρίθμηση DataType ορίζει τον τύπο δεδομένων ενός χαρακτηριστικού, παράστασης ή παραμέτρου στο RDL. Ο παρακάτω πίνακας δείχνει πώς οι τύποι δεδομένων κοινού χρόνου εκτέλεσης γλώσσας (CLR) αντιστοιχούν στους τύπους δεδομένων RDL.
| Τύποι CLR | Αντίστοιχος τύπος δεδομένων |
|---|---|
| Boolean | Boolean |
| DateTime, DateTimeOffset | DateTime |
| Int16, Int32, UInt16, Byte, SByte | Integer |
| Μονή, Διπλή | Επιπλέουν |
| Συμβολοσειρά, Char, GUID, Χρονικό διάστημα | Συμβολοσειρά |