Φάκελος αναφοράς έργου 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

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

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

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

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

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

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

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

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

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

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

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

Φάκελος και αρχεία 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	Φάκελος που κρατά όλα τα αρχεία σελιδοδεικτών της αναφοράς.
── [σελιδοδείκτηςName].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 ή κάποιο άλλο εξωτερικό εργαλείο, ενώ το έργο παραμένει ανοιχτό στο Power BI Desktop. Όταν αποθηκεύετε τα αρχεία, το Power BI Desktop εντοπίζει τις αλλαγές και εμφανίζει το πλαίσιο Εφαρμογή εξωτερικών αλλαγών. Επιλέξτε Εφαρμογή εξωτερικών αλλαγών για να φορτώσετε εκ νέου τον ορισμό αναφοράς χωρίς να κλείσετε και ανοίξετε ξανά το έργο.

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

Τα αρχεία PBIR πρέπει να συμμορφώνονται με τα σχήματα JSON. Ο κώδικας VS αναγνωρίζει ζητήματα όπως ένα μη υποστηριζόμενο όνομα ιδιότητας ή έναν λανθασμένο τύπο ιδιότητας:

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

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

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

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

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

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

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

Μια μη έγκυρη activePageName ρύθμιση παραμέτρων είναι ένα παράδειγμα ενός μη αποκλεισμού σφάλματος που διορθώνεται αυτόματα Power BI Desktop. Η προειδοποίηση σάς δίνει τη δυνατότητα να εξετάσετε τη διόρθωση προτού αποθηκεύσετε την αναφορά και αντικαταστήσετε τον εξωτερικό ορισμό.

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

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

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

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

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

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

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

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

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

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

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

Πριν από τη μετατροπή, Power BI δημιουργεί ένα αντίγραφο ασφαλείας της αναφοράς:

Power BI Desktop διατηρεί το αντίγραφο ασφαλείας για 30 ημέρες σε μία από τις ακόλουθες θέσεις:
- Έκδοση του Microsoft Store: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
- Έκδοση εκτελέσιμου προγράμματος εγκατάστασης: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups
Το Υπηρεσία Power BI διατηρεί το αντίγραφο ασφαλείας του PBIR-Legacy για 28 ημέρες. Για να την επαναφέρετε, ανοίξτε τις Ρυθμίσεις αναφοράς από τον χώρο εργασίας και επιλέξτε Επαναφορά ως PBIR-Παλαιού τύπου. Αυτό το αντίγραφο ασφαλείας δημιουργείται μόνο για αναφορές που έχουν μετατραπεί απευθείας στην Υπηρεσία Power BI.

Η επαναφορά ενός αντιγράφου ασφαλείας PBIR-Legacy δεν αποτρέπει μια άλλη μετατροπή. Για να διατηρήσετε μια αναφορά σε PBIR-Legacy μορφή, μην την επεξεργαστείτε στο Υπηρεσία Power BI ή χρησιμοποιήστε μια έκδοση του Power BI Desktop που κυκλοφόρησε πριν από τον Σεπτέμβριο του 2026.

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

Λάβετε υπόψη τα παρακάτω ζητήματα και περιορισμούς:

Τα αυτόματα φίλτρα απεικόνισης διατηρούνται στο αρχείο PBIR visual.json μόνο αφού το τμήμα παραθύρου φίλτρων έχει αναπτυχθεί τουλάχιστον μία φορά κατά την επεξεργασία της αναφοράς.
Εάν Power BI δεν μετατρέπει μια PBIR-Legacy αναφορά σε PBIR κατά την επεξεργασία και αποθήκευσή της, η μετατροπή αντιμετώπισε ένα πρόβλημα προϊόντος. Δημιουργήστε μια αίτηση υποστήριξης για να αναφέρετε το πρόβλημα.

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

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

Important

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

Fabric ενοποίησης Git και Fabric API REST εξαγάγουν ορισμούς αναφοράς με χρήση PBIR.

Σχόλια

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

Τελευταία ενημέρωση στις 2026-09-29

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

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

.pbi\localSettings.json

CustomVisuals\

RegisteredResources\

semanticModelDiagramLayout.json

definition.pbir

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

mobileState.json

report.json

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

.platform

Μορφή PBIR

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

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

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

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

Σχήματα Json PBIR

Σχολιασμοί PBIR

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

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

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

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

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

Σχόλια

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