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

Important

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

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

.pbi\
- localSettings.json
CustomVisuals\
StaticResources\
- RegisteredResources\
semanticModelDiagramLayout.json
definition.pbir¹
mobileState.json
report.json²
Ορισμός\ Φάκελος³
.platform

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

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

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

.pbi\localSettings.json

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

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

CustomVisuals\

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

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

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

RegisteredResources\

Ένας υποφάκελος που περιλαμβάνει αρχεία πόρων ειδικά για την αναφορά και φορτώνεται από τον χρήστη, όπως προσαρμοσμένα θέματα, εικόνες και προσαρμοσμένες απεικονίσεις (αρχεία 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:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    }    
  }
}

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

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

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

Έκδοση 2
Έκδοση 1

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

Property	Description
connectionString	Η συμβολοσειρά σύνδεσης που αναφέρεται στο σημασιολογικό μοντέλο σε ένα χώρο εργασίας Fabric.

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

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "Data Source=\"powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName]\";initial catalog=[SemanticModelName];access mode=readonly;integrated security=ClaimsToken;semanticmodelid=[SemanticModelId]"
    }
  }
}

Κατά την ανάπτυξη μιας αναφοράς μέσω του Fabric REST API, χρειάζεται μόνο να καθορίσετε την semanticmodelid ιδιότητα. Για παράδειγμα:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "semanticmodelid=[SemanticModelId]"
    }
  }
}

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

Property	Description
connectionString	Η συμβολοσειρά σύνδεσης που αναφέρεται στο σημασιολογικό μοντέλο σε ένα χώρο εργασίας Fabric.
pbiModelDatabaseName	Το αναγνωριστικό μοντέλου απομακρυσμένης σημασιολογίας.
connectionType	Τύπος σύνδεσης. Για το απομακρυσμένο σημασιολογικό μοντέλο υπηρεσίας, αυτή η τιμή πρέπει να είναι `pbiServiceXmlaStyleLive`.
pbiModelVirtualServerName	Μια εσωτερική ιδιότητα που πρέπει να έχει την τιμή , `sobe_wowvirtualserver`.
pbiServiceModelId	Μια εσωτερική ιδιότητα που πρέπει να έχει την τιμή , `null`.
name	Μια εσωτερική ιδιότητα που πρέπει να έχει την τιμή , `EntityDataSource`.

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

{
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/1.0.0/schema.json",
    "version": "4.0",
    "datasetReference": {  
      "byConnection": {
        "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName];Initial Catalog=[SemanticModelName];Integrated Security=ClaimsToken",
        "pbiServiceModelId": null,
        "pbiModelVirtualServerName": "sobe_wowvirtualserver",
        "pbiModelDatabaseName": "[Semantic Model Id]",
        "connectionType": "pbiServiceXmlaStyleLive",
        "name": "EntityDataSource"
      }
  }
}

Important

Κατά την ανάπτυξη μιας αναφοράς μέσω του REST API Fabric, πρέπει να χρησιμοποιήσετε byConnection αναφορές. Αυτό δεν πρέπει να συγχέεται με τη λειτουργία αποθήκευσης ενός σημασιολογικού μοντέλου όπως το DirectQuery. Η datasetReference στην αναφορά καθορίζει μόνο σε ποιο σημασιολογικό μοντέλο συνδέεται η αναφορά, δεν ορίζει τον τρόπο με τον οποίο αυτό το μοντέλο αποθηκεύει ή αποκτά πρόσβαση στα δεδομένα του.

Πολλαπλά αρχεία *.pbir

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

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

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

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

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

mobileState.json

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

report.json

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

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

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

.platform

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

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

Μορφή PBIR

Important

Εξετάστε όλους τους περιορισμούς 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:

Για αρχεία Power BI Project (PBIP):

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

Για αρχεία PBIX:

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

Η ενεργοποίηση του PBIR για PBIX εξασφαλίζει ότι η μορφή PBIR αποθηκεύεται και σε αρχεία PBIX, όχι μόνο σε αρχεία Power BI Project (PBIP).

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

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

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

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

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

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

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

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

Το Power BI Desktop δημιουργεί αυτόματα ένα αντίγραφο ασφαλείας της αναφοράς πριν από την αναβάθμιση σε PBIR. Αυτό το αντίγραφο ασφαλείας διατηρείται για 30 ημέρες σε μία από τις ακόλουθες θέσεις:
- Έκδοση του Microsoft Store: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
- Έκδοση εκτελέσιμου προγράμματος εγκατάστασης: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups

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

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

PBIR σε υπηρεσία

Οι νέες αναφορές που δημιουργούνται στην Υπηρεσία χρησιμοποιούν τη μορφή PBIR από προεπιλογή. Οι υπάρχουσες αναφορές που υποβάλλονται σε επεξεργασία θα μετατραπούν επίσης αυτόματα σε μορφή PBIR.

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

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

Important

Όταν το PBIR φτάσει στη Γενική Διαθεσιμότητα (GA), θα γίνει η μόνη υποστηριζόμενη μορφή αναφοράς και η μετατροπή θα είναι υποχρεωτική. Συνιστούμε στους πελάτες να αρχίσουν να προετοιμάζονται για αυτήν τη μετεγκατάσταση πριν από το GA.
Το PBIR στην υπηρεσία Power BI ενδέχεται να μην είναι ακόμα διαθέσιμο στον μισθωτή σας. Η ρύθμιση μισθωτή υπάρχει κυρίως για να σας επιτρέψει να εξαιρεθείτε πριν από την πλήρη ενεργοποίηση της δυνατότητας. Για τις πιο πρόσφατες ενημερώσεις, επισκεφθείτε το ιστολόγιο του Power BI.

Επαναφορά σε PBIR-Legacy

Όταν μια αναφορά μετατρέπεται σε PBIR στην Υπηρεσία, δημιουργείται αυτόματα ένα αντίγραφο ασφαλείας σε μορφή PBIR-Legacy και διατηρείται για 28 ημέρες. Μπορείτε να επαναφέρετε την αναφορά στην PBIR-Legacy της έκδοση, ανοίγοντας τις ρυθμίσεις αναφοράς από τον χώρο εργασίας και επιλέγοντας Επαναφορά ως PBIR-Legacy.

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

Μια αναφορά που έχει αποκατασταθεί δεν θα μετατραπεί αυτόματα σε PBIR. Για να ενεργοποιήσετε ξανά την αυτόματη μετατροπή, ανοίξτε τις ρυθμίσεις αναφοράς και επιλέξτε Ενεργοποίηση PBIR.

Important

Το αντίγραφο ασφαλείας της υπηρεσίας PBIR-παλαιού τύπου δημιουργείται μόνο για αναφορές που έχουν αναβαθμιστεί απευθείας στην υπηρεσία Power BI. Εάν αναβαθμίσετε την αναφορά σας δημοσιεύοντας από το Power BI Desktop ή αποστέλλοντας ένα αρχείο PBIX και πρέπει να επαναφέρετε την έκδοση PBIR-παλαιού τύπου , χρησιμοποιήστε το αντίγραφο ασφαλείας που δημιουργήθηκε από το Power BI Desktop.

Φάκελος και αρχεία 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

File/Folder	Required	Description
bookmarks\	No	Φάκελος που κρατά όλα τα αρχεία σελιδοδεικτών της αναφοράς.
── [bookmarkName].bookmark.json	No	Μετα-δεδομένα σελιδοδεικτών, όπως απεικονίσεις προορισμού και φίλτρα. Περισσότερες πληροφορίες στο σχήμα.
── bookmarks.json	No	Μετα-δεδομένα σελιδοδεικτών, όπως σειρά σελιδοδεικτών και ομάδες. Περισσότερες πληροφορίες στο σχήμα.
pages\	Yes	Φάκελος που κρατά όλες τις σελίδες της αναφοράς.
── [όνομα_σελίδας]\	Yes	Ένας φάκελος ανά σελίδα.
──── οπτικά\	No	Φάκελος που κρατά όλες τις απεικονίσεις της σελίδας.
────── [όνομα_εικόνας]\	No	Ένας φάκελος ανά απεικόνιση.
──────── mobile.json	No	Μετα-δεδομένα διάταξης για κινητές συσκευές, όπως θέση για κινητές συσκευές και μορφοποίηση. Περισσότερες πληροφορίες στο σχήμα.
──────── visual.json	Yes	Μετα-δεδομένα απεικόνισης, όπως η θέση και η μορφοποίηση, το ερώτημα. Περισσότερες πληροφορίες στο σχήμα.
──── page.json	Yes	Μετα-δεδομένα σελίδας, όπως φίλτρα επιπέδου σελίδας και μορφοποίηση. Περισσότερες πληροφορίες στο σχήμα.
── pages.json	No	Μετα-δεδομένα σελίδων, όπως η σειρά σελίδας και η ενεργή σελίδα. Περισσότερες πληροφορίες στο σχήμα.
version.json	Yes	Η έκδοση του αρχείου PBIR, μεταξύ άλλων παραγόντων, καθορίζει τα απαιτούμενα αρχεία που θα φορτωθούν. Περισσότερες πληροφορίες στο schema
reportExtensions.json	No	Επεκτάσεις αναφοράς, όπως μετρήσεις επιπέδου αναφοράς. Περισσότερες πληροφορίες στο schema
report.json	Yes	Μετα-δεδομένα αναφοράς, όπως φίλτρα επιπέδου αναφοράς και μορφοποίηση. Περισσότερες πληροφορίες στο schema

Important

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

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

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

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

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

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

Αντιγραφή ονόματος αντικειμένου αναφοράς

Κάθε αντικείμενο στην αναφορά αποθηκεύεται σε ξεχωριστό φάκελο ή αρχείο, αλλά το όνομα του φακέλου δεν είναι πάντα προφανές. Για να γίνει αυτό πιο εύκολο, μπορείτε να αντιγράψετε το όνομα οποιουδήποτε ονόματος αντικειμένου αναφοράς (συμπεριλαμβανομένων σελίδων, απεικονίσεων, σελιδοδεικτών και φίλτρων) απευθείας από το Power BI στο πρόχειρο.

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

Από την επιφάνεια εργασίας
Από την υπηρεσία

Μεταβείτε στη ρύθμιση Επιλογές αρχείου > και ρυθμίσεις > Ρυθμίσεις αναφοράς > Αντικείμενα αναφοράς και ενεργοποιήστε τη ρύθμιση Αντιγραφή ονομάτων αντικειμένων όταν κάνετε δεξί κλικ στη ρύθμιση αντικειμένων αναφοράς . Αυτό πρέπει να γίνει μόνο μία φορά.
Κάντε δεξί κλικ σε οποιοδήποτε αντικείμενο αναφοράς και επιλέξτε Αντιγραφή ονόματος αντικειμένου.

Με το όνομα αντικειμένου αντιγραπτικό στο πρόχειρο, μπορείτε εύκολα να το εισαγάγετε στη γραμμή αναζήτησης της εξερεύνησης των Windows ή του Visual Studio Code για να εντοπίσετε ή να αναγνωρίσετε το όνομα αντικειμένου μέσα στο φάκελο PBIR.

Σχήματα Json PBIR

Κάθε αρχείο PBIR JSON περιλαμβάνει μια δήλωση σχήματος 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 βρίσκεται επί του παρόντος σε προεπισκόπηση. Έχετε υπόψη τα εξής:

Το PBIR στα Sovereign Clouds δεν θα αναβαθμιστεί αυτόματα στην υπηρεσία πριν από τη Γενική Διαθεσιμότητα. Μέχρι τότε, οι πελάτες του Sovereign Cloud μπορούν να δοκιμάσουν τις αναφορές τους σε μορφή PBIR στο Power BI Desktop, ενεργοποιώντας τις δυνατότητες προεπισκόπησης PBIR.
Οι μεγάλες αναφορές με περισσότερα από 500 αρχεία ενδέχεται να αντιμετωπίσουν προβλήματα απόδοσης σύνταξης (η προβολή αναφοράς δεν επηρεάζεται).
Μετά τη μετατροπή μιας αναφοράς από PBIR-Legacy σε PBIR, δεν είναι δυνατή η επαναφορά της. Παρόλο που δημιουργείται ένα αντίγραφο ασφαλείας τη στιγμή της μετατροπής.
Η μετατροπή ενός αρχείου PBIP σε ένα αρχείο PBIX χρησιμοποιώντας τη δυνατότητα "Αποθήκευση ως" ενσωματώνει την αναφορά PBIR μέσα στο αρχείο PBIX, μεταφέροντας όλους τους περιορισμούς PBIR στο PBIX.
Τα αυτόματα φίλτρα απεικόνισης διατηρούνται στο αρχείο PBIR visual.json μόνο αφού το τμήμα παραθύρου φίλτρων έχει αναπτυχθεί τουλάχιστον μία φορά κατά την επεξεργασία της αναφοράς.
Δεν υποστηρίζεται σε χώρους εργασίας εφαρμογής προτύπου

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

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

Important

Εάν φτάσετε τα παραπάνω όρια, θα πρέπει να εξετάσετε το ενδεχόμενο βελτιστοποίησης της αναφοράς σας. Ανατρέξτε στο έγγραφο βελτιστοποίησης Power BI.

Οι αναφορές εξαγωγής των API Fabric Git Integration και Fabric REST εξάγονται χρησιμοποιώντας τη μορφή που εφαρμόζεται αυτή τη στιγμή στην υπηρεσία. Εάν μια αναφορά δημιουργηθεί ή εισαχθεί στο Fabric με τη μορφή PBIR, θα εξαχθεί σε PBIR. Παρομοίως, εάν μια αναφορά είναι PBIR-Legacy, θα εξαχθεί με PBIR-Legacy μορφή.

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2025-12-15

Κοινοποίηση μέσω

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

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

.pbi\localSettings.json

CustomVisuals\

RegisteredResources\

semanticModelDiagramLayout.json

definition.pbir

Πολλαπλά αρχεία *.pbir

mobileState.json

report.json

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

.platform

Μορφή PBIR

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

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

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

PBIR σε υπηρεσία

Επαναφορά σε PBIR-Legacy

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

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

Αντιγραφή ονόματος αντικειμένου αναφοράς

Σχήματα Json PBIR

Σχολιασμοί PBIR

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

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

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

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

Ανάδραση

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