Φάκελος αναφοράς έργου Power BI Desktop

Άρθρο
08/13/2024

Σημαντικό

Τα έργα του Power BI Desktop βρίσκονται αυτήν τη στιγμή σε προεπισκόπηση.

Αυτό το άρθρο περιγράφει τα αρχεία και τους υποφακέλους σε έναν φάκελο Αναφορά ενός έργου του Microsoft Power BI Desktop. Τα αρχεία και οι υποφάκελοι εδώ αντιπροσωπεύουν μια αναφορά Power BI. Ανάλογα με το έργο σας, ο φάκελος αναφοράς μπορεί να περιλαμβάνει:

.pbi\
- localSettings.json
Προσαρμοσμένες ρυθμίσεις\
StaticResources\
- Καταχωρημένοι πόροι\
semanticModelDiagramLayout.json
definition.pbir¹
mobileState.json
^{report.json 2}
ορισμός\ φάκελος³
.πλατφόρμα

1 - Αυτό το αρχείο είναι υποχρεωτικό.
2 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση σε μορφή PBIR-Legacy.
3 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση σε μορφή PBIR.

Δεν περιλαμβάνουν όλοι οι φάκελοι αναφοράς έργου όλα τα αρχεία και τους υποφακέλους που περιγράφονται εδώ.

Αρχεία αναφοράς

.pbi\localSettings.json

Περιέχει ρυθμίσεις αναφοράς που ισχύουν μόνο για τον τρέχοντα χρήστη και τον τοπικό υπολογιστή. Θα πρέπει να περιλαμβάνεται στο gitIgnore ή σε άλλες εξαιρέσεις στοιχείων ελέγχου προέλευσης. Από προεπιλογή, το Git αγνοεί αυτό το αρχείο.

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο localSettings.json σχήματος.

Προσαρμοσμένες ρυθμίσεις\

Ένας υποφάκελος που περιέχει μετα-δεδομένα για προσαρμοσμένες απεικονίσεις στην αναφορά. Το Power BI υποστηρίζει τρία είδη προσαρμοσμένων απεικονίσεων:

Απεικονίσεις χώρου αποθήκευσης οργανισμού - Οι οργανισμοί μπορούν να εγκρίνουν και να αναπτύξουν προσαρμοσμένες απεικονίσεις στο Power BI για τον οργανισμό τους. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Χώρος αποθήκευσης οργανισμού.
Απεικονίσεις Power BI AppSource - Γνωστές και ως "Δημόσιες προσαρμοσμένες απεικονίσεις". Αυτές οι απεικονίσεις είναι διαθέσιμες από το Microsoft AppSource. Οι προγραμματιστές αναφορών μπορούν να εγκαταστήσουν αυτές τις απεικονίσεις απευθείας από το Power BI Desktop.
Αρχεία προσαρμοσμένων απεικονίσεων - γνωστά και ως "Ιδιωτικές προσαρμοσμένες απεικονίσεις". Τα αρχεία μπορούν να φορτωθούν στην αναφορά με την αποστολή ενός πακέτου pbiviz.

Μόνο ιδιωτικές προσαρμοσμένες απεικονίσεις φορτώνονται στον φάκελο CustomVisuals. Οι απεικονίσεις AppSource και Οργανισμού φορτώνονται αυτόματα από το Power BI Desktop.

Καταχωρημένοι πόροι\

Ένας υποφάκελος που περιλαμβάνει αρχεία πόρων ειδικά για την αναφορά και φορτώνεται από τον χρήστη, όπως προσαρμοσμένα θέματα, εικόνες και προσαρμοσμένες απεικονίσεις (αρχεία pbiviz).

Οι προγραμματιστές είναι υπεύθυνοι για τα αρχεία που βρίσκονται εδώ και οι αλλαγές υποστηρίζονται. Για παράδειγμα, μπορείτε να αλλάξετε ένα αρχείο και μετά από μια επανεκκίνηση του Power BI Desktop, το νέο αρχείο φορτώνεται στην αναφορά. Αυτός ο φάκελος μπορεί να καταργήσει τον αποκλεισμό ορισμένων χρήσιμων σεναρίων, όπως:

Σύνταξη προσαρμοσμένων θεμάτων εκτός του Power BI Desktop με χρήση του δημόσιου σχήματος.
Εφαρμογή αλλαγών δέσμης αλλάζοντας το αρχείο πόρου σε πολλές αναφορές. Για παράδειγμα, μπορείτε να αλλάξετε το εταιρικό προσαρμοσμένο θέμα, να αλλάξετε μεταξύ ανοιχτόχρωμων και σκουρόχρωμων θεμάτων και να αλλάξετε εικόνες λογοτύπου.

Κάθε αρχείο πόρου πρέπει να έχει μια αντίστοιχη καταχώρηση στο αρχείο report.json, το οποίο κατά τη διάρκεια της προεπισκόπησης δεν υποστηρίζει την επεξεργασία. Οι αλλαγές σε αρχεία RegisteredResources υποστηρίζονται μόνο για ήδη φορτωμένους πόρους που προκαλούν την καταχώρηση του πόρου από το Power BI Desktop στον report.json.

semanticModelDiagramLayout.json

Περιέχει διαγράμματα μοντέλου δεδομένων που περιγράφουν τη δομή του μοντέλου σημασιολογίας που σχετίζεται με την αναφορά. Κατά τη διάρκεια της προεπισκόπησης, αυτό το αρχείο δεν υποστηρίζει εξωτερική επεξεργασία.

definition.pbir

Περιέχει τον συνολικό ορισμό μιας αναφοράς και των βασικών ρυθμίσεων. Αυτό το αρχείο περιέχει επίσης την αναφορά στο μοντέλο σημασιολογίας που χρησιμοποιείται από την αναφορά. Το Power BI Desktop μπορεί να ανοίξει ένα αρχείο pbir απευθείας, ακριβώς το ίδιο όπως εάν η αναφορά ανοίχτηκε από ένα αρχείο pbip. Εάν ανοίξετε ένα pbir, ανοίγει επίσης το σημασιολογικό μοντέλο παράλληλα, εάν υπάρχει μια σχετική αναφορά που χρησιμοποιεί .byPath

Παράδειγμα definition.pbir:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    },
    "byConnection": null
  }
}

Ο ορισμός περιλαμβάνει την datasetReference ιδιότητα, η οποία αναφέρεται στο μοντέλο σημασιολογίας που χρησιμοποιείται στην αναφορά. Η αναφορά μπορεί να είναι είτε:

byPath - Καθορίζει μια σχετική διαδρομή προς τον φάκελο μοντέλου σημασιολογίας προορισμού. Δεν υποστηρίζονται απόλυτες διαδρομές. Μια κάθετος (/) χρησιμοποιείται ως διαχωριστικό φακέλου. Όταν χρησιμοποιείται, το Power BI Desktop ανοίγει επίσης το μοντέλο σημασιολογίας σε πλήρη λειτουργία επεξεργασίας.

byConnection - Καθορίζει ένα απομακρυσμένο σημασιολογικό μοντέλο στην υπηρεσία Power BI χρησιμοποιώντας μια συμβολοσειρά σύνδεσης. Όταν χρησιμοποιείται μια byConnection αναφορά, το Power BI Desktop δεν ανοίγει το μοντέλο σημασιολογίας σε λειτουργία επεξεργασίας.

Χρησιμοποιώντας μια byConnection αναφορά, πρέπει να καθοριστούν οι ακόλουθες ιδιότητες:

Ιδιότητα	Περιγραφή
connectionString	Η συμβολοσειρά σύνδεσης που αναφέρεται στο απομακρυσμένο μοντέλο σημασιολογίας.
pbiModelDatabaseName	Το αναγνωριστικό μοντέλου απομακρυσμένης σημασιολογίας.
τύπος σύνδεσης	Τύπος σύνδεσης. Για το απομακρυσμένο σημασιολογικό μοντέλο υπηρεσίας, αυτή η τιμή πρέπει να είναι `pbiServiceXmlaStyleLive`.
pbiModelVirtualServerName	Μια εσωτερική ιδιότητα που πρέπει να έχει την τιμή , `sobe_wowvirtualserver`.

Παράδειγμα με χρήση του byConnection:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[Workspace Name];Initial Catalog=[Semantic Model Name];Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "[Semantic Model Id]",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": "EntityDataSource"
    }
  }
}

Σημαντικό

Κατά την ανάπτυξη μιας αναφοράς μέσω του REST API Fabric, πρέπει να χρησιμοποιήσετε αναφορές.

Όταν το σημασιολογικό μοντέλο και η αναφορά μοιράζονται τον ίδιο χώρο εργασίας, η Ενοποίηση Git Fabric χρησιμοποιεί πάντα μια byPath αναφορά στο μοντέλο σημασιολογίας. Εάν θέλετε να εξαναγκάσετε την αναφορά να ανοίγει σε δυναμική σύνδεση (για παράδειγμα, για να εργαστείτε με μετρήσεις επιπέδου αναφοράς), μπορείτε να έχετε πολλά αρχεία definition*.pbir, όπως ένα με μια σύνδεση byPath και ένα άλλο με μια σύνδεση byConnection. Ωστόσο, μόνο το αρχείο definition.pbir δεν παραβλέπεται κατά την εισαγωγή του ορισμού μέσω του Fabric Git.

  ├── definition\
  ├── StaticResources\
  ├── .platform
  ├── definition-liveConnect.pbir
  └── definition.pbir

Αυτό το αρχείο καθορίζει επίσης τις υποστηριζόμενες μορφές ορισμού αναφοράς μέσω της ιδιότητας "έκδοση".

Έκδοση	Υποστηριζόμενες μορφές
1.0	Ο ορισμός αναφοράς πρέπει να αποθηκευτεί ως PBIR-Legacy στο αρχείο report.json.
4.0 ή νεότερη έκδοση	Ο ορισμός αναφοράς μπορεί να αποθηκευτεί ως PBIR-Legacy (αρχείο report.json) ή PBIR (φάκελος\ορισμών).

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο definition.pbir schema.

mobileState.json

Περιέχει ρυθμίσεις εμφάνισης και συμπεριφοράς αναφοράς κατά την απόδοση σε μια κινητή συσκευή. Αυτό το αρχείο δεν υποστηρίζει εξωτερική επεξεργασία.

report.json

Αυτό το αρχείο περιέχει τον ορισμό αναφοράς στη μορφή παλαιού τύπου αναφοράς του Power BI (PBIR-Legacy) και δεν υποστηρίζει εξωτερική επεξεργασία.

ορισμός\ φάκελος

Αυτός ο φάκελος είναι διαθέσιμος μόνο εάν το έργο Power BI αποθηκεύεται χρησιμοποιώντας τη βελτιωμένη μορφή αναφοράς του Power BI (PBIR). Αντικαθιστά το αρχείο report.json .

.πλατφόρμα

Αρχείο πλατφόρμας Fabric που περιέχει ιδιότητες ζωτικής σημασίας για τον καθορισμό και τη διατήρηση της σύνδεσης μεταξύ των στοιχείων Fabric και του Git.

Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Η ενοποίηση Git δημιουργείται αυτόματα από αρχεία συστήματος.

Μορφή PBIR

Σημαντικό

Εξετάστε όλους τους περιορισμούς PBIR κατά τη διάρκεια της φάσης προεπισκόπησης.

Η αποθήκευση των αρχείων σας Power BI Project (PBIP) με χρήση της βελτιωμένης μορφής αναφοράς του Power BI (PBIR) βελτιώνει σημαντικά την παρακολούθηση αλλαγών και την επίλυση διένεξης συγχώνευσης, χρησιμοποιώντας σωστά μορφοποιημένα αρχεία JSON.

Στιγμιότυπο οθόνης φιλικών διαφορών PBIR.

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

Στιγμιότυπο οθόνης του φιλικού φακέλου PBIR.

Σε αντίθεση με την έκδοση PBIR-Legacy (report.json), η PBIR είναι μια δημόσια τεκμηριωμένη μορφή που υποστηρίζει τροποποιήσεις από εφαρμογές που δεν είναι Power BI. Κάθε αρχείο έχει ένα δημόσιο σχήμα JSON, το οποίο όχι μόνο καταγράφει το αρχείο, αλλά επιτρέπει επίσης στα προγράμματα επεξεργασίας κώδικα, όπως το Visual Studio Code, να εκτελούν επικύρωση σύνταξης κατά την επεξεργασία.

Ορισμένα από τα πιθανά σενάρια που είναι τώρα διαθέσιμα με το PBIR περιλαμβάνουν τα εξής:

Αντιγραφή σελίδων/απεικονίσεων/σελιδοδεικτών μεταξύ αναφορών.
Εξασφαλίστε τη συνέπεια ενός συνόλου απεικονίσεων σε όλες τις σελίδες, με αντιγραφή και επικόλληση των αρχείων απεικόνισης.
Εύκολη εύρεση και αντικατάσταση σε πολλά αρχεία αναφορών.
Εφαρμογή επεξεργασίας δέσμης σε όλες τις απεικονίσεις με χρήση μιας δέσμης ενεργειών (για παράδειγμα, απόκρυψη φίλτρων επιπέδου απεικόνισης)

Ενεργοποίηση δυνατότητας προεπισκόπησης μορφής PBIR

Η αποθήκευση ως έργου Power BI με χρήση του PBIR είναι προς το παρόν σε προεπισκόπηση. Πριν από τη χρήση του, ενεργοποιήστε το στις δυνατότητες προεπισκόπησης του Power BI Desktop:

Μεταβείτε στις επιλογές αρχείου > Επιλογές και ρυθμίσεις > Επιλογές Δυνατότητες > προεπισκόπησης και επιλέξτε το πλαίσιο δίπλα στο στοιχείο Αποθήκευση αναφορών χρησιμοποιώντας βελτιωμένη μορφή μετα-δεδομένων (PBIR).

Αποθήκευση ως έργου με χρήση PBIR

Με ενεργοποιημένη τη δυνατότητα προεπισκόπησης PBIR, όταν αποθηκεύετε ένα έργο, η αναφορά σας αποθηκεύεται μέσα σε έναν φάκελο με το όνομα \definition μέσα στον φάκελο αναφοράς:

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

Μάθετε περισσότερα σχετικά με τη δομή φακέλων PBIR.

Μετατροπή υπάρχοντος PBIP σε PBIR

Εάν έχετε ήδη ένα PBIP χρησιμοποιώντας τη μορφή PBIR-Legacy, μπορείτε να το μετατρέψετε σε PBIR ως εξής:

Ανοίξτε το PBIP στο Power BI Desktop.
Βεβαιωθείτε ότι είναι ενεργοποιημένη η δυνατότητα προεπισκόπησης.
Αποθηκεύστε το έργο. Εμφανίζεται μια προτροπή που σας ζητά να κάνετε αναβάθμιση σε PBIR.
Επιλέξτε Αναβάθμιση.

Σημαντικό

Μετά την αναβάθμιση σε PBIR, δεν μπορείτε να επιστρέψετε στο PBIR-Legacy. Εάν πιστεύετε ότι μπορεί να θέλετε να επιστρέψετε στο PBIR-Legacy, αποθηκεύστε πρώτα ένα αντίγραφο των αρχείων σας PBIP.

Το υπάρχον αρχείο PBIR-Legacy (report.json) αντικαθίσταται με έναν φάκελο \definition που περιέχει την αναπαράσταση PBIR της αναφοράς.

Εάν επιλέξετε Διατήρηση τρέχουσας μορφής, το Desktop δεν ζητά ξανά αναβάθμιση.

Δημοσίευση αναφοράς PBIR στην υπηρεσία

Κατά τη διάρκεια της φάσης προεπισκόπησης , ο μόνος τρόπος για να δημοσιεύσετε μια αναφορά με τη μορφή PBIR είναι μέσω της Ενοποίησης Fabric Git. Αυτό περιλαμβάνει τη σύνδεση του χώρου εργασίας σε ένα αποθετήριο Git και την προώθηση της αναφοράς PBIR σε αυτόν, το οποίο μπορεί, στη συνέχεια, να συγχρονιστεί με τον χώρο εργασίας υπηρεσίας σε μεταγενέστερο στάδιο.

Εάν θέλετε να μετατρέψετε μια υπάρχουσα αναφορά σε PBIR στην υπηρεσία, ακολουθήστε τα εξής βήματα:

Συνδέστε τον χώρο εργασίας σας στο Git.
Κλωνοποιήστε το αποθετήριο Git στο τοπικό σύστημα αρχείων σας.
Ανοίξτε την αναφορά στο Power BI Desktop ανοίγοντας το definition.pbir αρχείο.
Αποθηκεύστε την αναφορά και επιλέξτε αναβάθμιση σε PBIR.
Δέσμευση και συγχρονισμός των αλλαγών στο Git.
Ενημερώστε τον χώρο εργασίας με τις τελευταίες αλλαγές από το Git.

Φάκελος και αρχεία PBIR

Ο ορισμός αναφοράς αποθηκεύεται μέσα στον definition\ φάκελο με την ακόλουθη δομή:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json

Αρχείο/Φάκελος	Απαραίτητο	Περιγραφή
Σελιδοδείκτες\	Όχι	Φάκελος που κρατά όλα τα αρχεία σελιδοδεικτών της αναφοράς.
── [σελιδοδείκτηςName].bookmark.json	Όχι	Μετα-δεδομένα σελιδοδεικτών, όπως απεικονίσεις προορισμού και φίλτρα. Περισσότερες πληροφορίες στο σχήμα.
── bookmarks.json	Όχι	Μετα-δεδομένα σελιδοδεικτών, όπως σειρά σελιδοδεικτών και ομάδες. Περισσότερες πληροφορίες στο σχήμα.
Σελίδες\	Όχι	Φάκελος που κρατά όλες τις σελίδες της αναφοράς.
── [pageName]\	Όχι	Ένας φάκελος ανά σελίδα.
──── visuals\	Όχι	Φάκελος που κρατά όλες τις απεικονίσεις της σελίδας.
────── [visualName]\	Όχι	Ένας φάκελος ανά απεικόνιση.
──────── mobile.json	Όχι	Μετα-δεδομένα διάταξης για κινητές συσκευές, όπως θέση για κινητές συσκευές και μορφοποίηση. Περισσότερες πληροφορίες στο σχήμα.
──────── visual.json	Όχι	Μετα-δεδομένα απεικόνισης, όπως η θέση και η μορφοποίηση, το ερώτημα. Περισσότερες πληροφορίες στο σχήμα.
──── page.json	Όχι	Μετα-δεδομένα σελίδας, όπως φίλτρα επιπέδου σελίδας και μορφοποίηση. Περισσότερες πληροφορίες στο σχήμα.
── pages.json	Όχι	Μετα-δεδομένα σελίδων, όπως η σειρά σελίδας και η ενεργή σελίδα. Περισσότερες πληροφορίες στο σχήμα.
version.json	Όχι	Η έκδοση του αρχείου PBIR, μεταξύ άλλων παραγόντων, καθορίζει τα απαιτούμενα αρχεία που θα φορτωθούν. Περισσότερες πληροφορίες στο σχήμα
reportExtensions.json	Όχι	Επεκτάσεις αναφοράς, όπως μετρήσεις επιπέδου αναφοράς. Περισσότερες πληροφορίες στο σχήμα
report.json	Όχι	Μετα-δεδομένα αναφοράς, όπως φίλτρα επιπέδου αναφοράς και μορφοποίηση. Περισσότερες πληροφορίες στο σχήμα

Σημαντικό

Ορισμένα αρχεία μετα-δεδομένων αναφοράς, όπως visual.json ή bookmarks.json, μπορεί να αποθηκευτούν με τιμές δεδομένων από το μοντέλο σημασιολογίας. Για παράδειγμα, εάν εφαρμόσετε ένα φίλτρο σε μια απεικόνιση για το πεδίο "Εταιρεία" = "Contoso", η τιμή "Contoso" θα διατηρηθεί ως μέρος των μετα-δεδομένων. Αυτό ισχύει και για άλλες ρυθμίσεις παραμέτρων, όπως επιλογές αναλυτή, πλάτος προσαρμοσμένων στηλών μήτρας και μορφοποίηση για συγκεκριμένες σειρές.

Σύμβαση ονομασίας PBIR

Όλα τα ονόματα μέσα στις αγκύλες ([]) στον προηγούμενο πίνακα ακολουθούν μια προεπιλεγμένη σύμβαση ονοματοθεσίας, αλλά μπορούν να μετονομαστούν σε πιο φιλικά προς τον χρήστη ονόματα. Από προεπιλογή, οι σελίδες, οι απεικονίσεις και οι σελιδοδείκτες χρησιμοποιούν το όνομα αντικειμένου αναφοράς τους ως το όνομα αρχείου ή φακέλου τους. Αυτά τα ονόματα αντικειμένων είναι αρχικά ένα μοναδικό αναγνωριστικό 20 χαρακτήρων, όπως '90c2e07d8e84e7d5c026'.

Στιγμιότυπο οθόνης της ιδιότητας ονόματος PBIR.

Η μετονομασία της ιδιότητας "name" σε κάθε αρχείο JSON υποστηρίζεται, αλλά μπορεί να διακόψει τις εξωτερικές αναφορές τόσο εντός όσο και εκτός της αναφοράς. Το όνομα αντικειμένου ή/και το όνομα αρχείου/φακέλου πρέπει να αποτελούνται από έναν ή περισσότερους χαρακτήρες λέξεων (γράμματα, ψηφία, χαρακτήρες υπογράμμισης) ή ενωτικά.

Μετά τη μετονομασία οποιωνδήποτε αρχείων ή φακέλων PBIR, πρέπει να επανεκκινήσετε το Power BI Desktop. Κατά την επανεκκίνηση, το Power BI Desktop θα διατηρήσει τα αρχικά ονόματα αρχείων ή φακέλων κατά την αποθήκευση.

Σχήματα Json PBIR

Κάθε αρχείο JSON PBIR περιλαμβάνει μια δήλωση σχήματος JSON στο επάνω μέρος του εγγράφου. Αυτή η διεύθυνση URL σχήματος είναι δημόσια προσβάσιμη και μπορεί να χρησιμοποιηθεί για να μάθετε περισσότερα σχετικά με τις διαθέσιμες ιδιότητες και αντικείμενα για κάθε αρχείο. Επιπλέον, παρέχει ενσωματωμένο IntelliSense και επικύρωση κατά την επεξεργασία με προγράμματα επεξεργασίας κώδικα όπως το Visual Studio Code.

Στιγμιότυπο οθόνης της επεξήγησης εργαλείου σχήματος PBIR JSON.

Η διεύθυνση URL σχήματος ορίζει επίσης την έκδοση του εγγράφου, η οποία αναμένεται να αλλάξει καθώς εξελίσσεται ο ορισμός της αναφοράς.

Όλα τα σχήματα JSON δημοσιεύονται εδώ.

Σχόλια PBIR

Μπορείτε να συμπεριλάβετε σχόλια ως ζεύγη ονόματος-τιμής στον ορισμό αναφοράς για κάθε visualκαι pagereport . Παρόλο που το Power BI Desktop θα παραβλέψει αυτά τα σχόλια, μπορεί να είναι πολύτιμα για εξωτερικές εφαρμογές, όπως δέσμες ενεργειών.

Για παράδειγμα, μπορείτε να καθορίσετε την προεπιλεγμένη Σελίδα για την αναφορά στο αρχείο, το report.json οποίο μπορεί έπειτα να χρησιμοποιηθεί από μια δέσμη ενεργειών ανάπτυξης.

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json",
  "themeCollection": {
    "baseTheme": {
      "name": "CY24SU06",
      "reportVersionAtImport": "5.55",
      "type": "SharedResources"
    }
  },
  ...
  "annotations": [
    {
      "name": "defaultPage",
      "value": "c2d9b4b1487b2eb30e98"
    }
  ]
}

Εξωτερικές αλλαγές σε αρχεία PBIR

Μπορείτε να επεξεργαστείτε τα αρχεία PBIR JSON χρησιμοποιώντας ένα πρόγραμμα επεξεργασίας κώδικα όπως Visual Studio Code ή ένα εξωτερικό εργαλείο, εφόσον το αρχείο υπακούει στο σχήμα JSON. Η χρήση εσφαλμένου ονόματος ιδιότητας ή τύπου μπορεί να εντοπιστεί εύκολα απευθείας στον κώδικα Visual Studio:

Στιγμιότυπο οθόνης της επικύρωσης σχήματος PBIR JSON.

Οι εξωτερικές αλλαγές σε περιεχόμενο PBIR μπορεί να οδηγήσουν σε σφάλματα κατά το άνοιγμα των αρχείων στο Power BI Desktop. Αυτά τα σφάλματα μπορεί να είναι δύο τύπων:

Τα σφάλματα αποκλεισμού αποτρέπουν το Power BI Desktop από το άνοιγμα της αναφοράς. Αυτά τα σφάλματα βοηθούν στην αναγνώριση του ζητήματος και του προσβλητικού αρχείου που πρέπει να διορθωθεί πριν από την εκ νέου άνοιγμα:

Στιγμιότυπο οθόνης του σφάλματος αποκλεισμού της προτροπής PBIR.

Σφάλματα όπως ένα μη έγκυρο σχήμα ή οι απαιτούμενες ιδιότητες που απουσιάζουν θεωρούνται σφάλματα αποκλεισμού. Αυτά τα σφάλματα μπορούν να αναγνωριστούν εύκολα, ανοίγοντας το αρχείο στο Visual Studio Code και ελέγχοντας τα σφάλματα σχήματος.

Τα σφάλματα που δεν αποκλείουν την αναφορά δεν εμποδίζουν το Power BI Desktop να ανοίξει την αναφορά και επιλύονται αυτόματα.

Στιγμιότυπο οθόνης του σφάλματος μη αποκλεισμού της προτροπής PBIR.

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

Συνήθη σφάλματα PBIR

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

Λύση: Επαληθεύστε εάν το όνομα συμμορφώνεται με τη σύμβαση ονοματοθεσιών. Εάν όχι, το Power BI Desktop αγνοεί το αρχείο ή τον φάκελο και το αντιμετωπίζει ως ιδιωτικά αρχεία χρηστών.

Σενάριο:Τα νέα αντικείμενα αναφοράς ονομάζονται διαφορετικά από άλλα. Για παράδειγμα, οι περισσότεροι φάκελοι σελίδων ονομάζονται "ReportSection0e71dafbc949c0853608", ενώ μερικοί ονομάζονται "1b3c2ab12b603618070b".

Λύση: Η PBIR υιοθέτησε μια νέα σύμβαση ονομασίας για κάθε αντικείμενο, αλλά ισχύει μόνο για νέα αντικείμενα. Όταν αποθηκεύετε μια υπάρχουσα αναφορά ως PBIP, τα τρέχοντα ονόματα πρέπει να διατηρηθούν για να αποτρέψετε τη διακοπή αναφορών. Εάν θέλετε συνέπεια, επιτρέπεται μια δέσμη ενεργειών μετονομασίας δέσμης.

Σενάριο:Αντιγράψαμε ένα αρχείο σελιδοδείκτη και, κατά την αποθήκευση, οι περισσότερες ρυθμίσεις παραμέτρων σελιδοδεικτών διαγράφηκαν.

Λύση: Αυτή η συμπεριφορά είναι σκόπιμη, οι σελιδοδείκτες αναφοράς καταγράφουν την κατάσταση μιας σελίδας αναφοράς μαζί με όλες τις απεικονίσεις της. Δεδομένου ότι η καταγεγραμμένη κατάσταση προέρχεται από μια άλλη σελίδα αναφοράς με διαφορετικές απεικονίσεις, τυχόν μη έγκυρες απεικονίσεις καταργούνται από τη ρύθμιση παραμέτρων του σελιδοδείκτη. Εάν αντιγράψετε επίσης τις εξαρτώμενες απεικονίσεις και τη σελίδα, ο σελιδοδείκτης διατηρεί τη ρύθμιση παραμέτρων.

Σενάριο:Αντιγράψαμε έναν φάκελο σελίδας από μια άλλη αναφορά και παρουσιάστηκε ένα σφάλμα που αναφέρει" Οι τιμές για την ιδιότητα "pageBinding.name" πρέπει να είναι μοναδικές."

Λύση: Το αντικείμενο pageBinding είναι απαραίτητο για την υποστήριξη συμβουλών εργαλείων άντλησης και σελίδας. Δεδομένου ότι μπορεί να αναφέρονται από άλλες σελίδες, το όνομα πρέπει να είναι μοναδικό μέσα στην αναφορά. Στη σελίδα που αντιγράψατε πρόσφατα, αντιστοιχίστε μια μοναδική τιμή για να επιλύσετε το σφάλμα. Μετά τον Ιούνιο του 2024, αυτή η κατάσταση δεν αποτελεί πλέον πρόβλημα, επειδή το όνομα pageBinding είναι GUID από προεπιλογή.

Ζητήματα και περιορισμοί PBIR

Το PBIR είναι αυτήν τη στιγμή σε προεπισκόπηση. Λάβετε υπόψη σας τα εξής:

Περιορισμοί υπηρεσιών/σφάλματα
- Δεν είναι δυνατή η ανάπτυξη με διοχετεύσεις ανάπτυξης.
- Δεν είναι δυνατή η αποθήκευή τους ως αντίγραφο.
- Δεν είναι δυνατή η χρήση των API αναφοράς του Power BI: κλωνοποίησης αναφορών , ενημέρωση περιεχομένου αναφοράς
Οι μεγάλες αναφορές με περισσότερα από 500 αρχεία αντιμετωπίζουν ζητήματα επιδόσεων σύνταξης (η προβολή αναφοράς δεν επηρεάζεται), όπως:
- Αποθήκευση στο Power BI Desktop
- Συγχρονισμός στην ενοποίηση Fabric Git
Μετά τη μετατροπή μιας αναφοράς από PBIR-Legacy σε PBIR, δεν είναι δυνατή η επαναφορά της.
Η μετατροπή ενός αρχείου PBIP σε ένα αρχείο PBIX χρησιμοποιώντας τη δυνατότητα "Αποθήκευση ως" ενσωματώνει την αναφορά PBIR μέσα στο αρχείο PBIX, μεταφέροντας όλους τους περιορισμούς PBIR στο PBIX.

Περιορισμοί μεγέθους PBIR που επιβάλλονται από την υπηρεσία:

1.000 σελίδες το πολύ ανά αναφορά.
300 απεικονίσεις το πολύ ανά σελίδα.
Έως 5 mb για κάθε αρχείο σελιδοδείκτη.
1mb το πολύ για κάθε αρχείο.
1.000 αρχεία πακέτου πόρων το πολύ ανά αναφορά.
Μέγιστο μέγεθος 300 mb για όλα τα αρχεία πακέτου πόρων.
Μέγιστο μέγεθος 20 mb για όλα τα αρχεία αναφοράς.

Κατά τη διάρκεια της δημόσιας προεπισκόπησης, τα API REST Ενοποίηση Fabric Git και Fabric συνεχίζουν να χρησιμοποιούν PBIR-Legacy (report.json) κατά την εξαγωγή των ορισμών αναφοράς. Ωστόσο, εάν η αναφορά εισαχθεί στο Fabric με τη μορφή PBIR, τότε και οι δύο δυνατότητες ξεκινούν την εξαγωγή του ορισμού αναφοράς χρησιμοποιώντας τη μορφή PBIR.

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

Φάκελος αναφοράς έργου Power BI Desktop

Αρχεία αναφοράς

.pbi\localSettings.json

Προσαρμοσμένες ρυθμίσεις\

Καταχωρημένοι πόροι\

semanticModelDiagramLayout.json

definition.pbir

mobileState.json

report.json

ορισμός\ φάκελος

.πλατφόρμα

Μορφή PBIR

Ενεργοποίηση δυνατότητας προεπισκόπησης μορφής PBIR

Αποθήκευση ως έργου με χρήση PBIR

Μετατροπή υπάρχοντος PBIP σε PBIR

Δημοσίευση αναφοράς PBIR στην υπηρεσία

Φάκελος και αρχεία PBIR

Σύμβαση ονομασίας PBIR

Σχήματα Json PBIR

Σχόλια PBIR

Εξωτερικές αλλαγές σε αρχεία PBIR

Συνήθη σφάλματα PBIR

Ζητήματα και περιορισμοί PBIR

Σχόλια

Πρόσθετοι πόροι

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

Φάκελος αναφοράς έργου Power BI Desktop

Αρχεία αναφοράς

.pbi\localSettings.json

Προσαρμοσμένες ρυθμίσεις\

Καταχωρημένοι πόροι\

semanticModelDiagramLayout.json

definition.pbir

mobileState.json

report.json

ορισμός\ φάκελος

.πλατφόρμα

Μορφή PBIR

Ενεργοποίηση δυνατότητας προεπισκόπησης μορφής PBIR

Αποθήκευση ως έργου με χρήση PBIR

Μετατροπή υπάρχοντος PBIP σε PBIR

Δημοσίευση αναφοράς PBIR στην υπηρεσία

Φάκελος και αρχεία PBIR

Σύμβαση ονομασίας PBIR

Σχήματα Json PBIR

Σχόλια PBIR

Εξωτερικές αλλαγές σε αρχεία PBIR

Συνήθη σφάλματα PBIR

Ζητήματα και περιορισμοί PBIR

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

Σχόλια

Πρόσθετοι πόροι