Condividi tramite


Creare un report di Power BI in formato report avanzato

SI APPLICA A: Power BI Desktop Servizio Power BI

Il formato di report avanzato di Power BI (PBIR) per i file di progetto di Power BI (PBIP) rappresenta un'attività cardine per raggiungere l'obiettivo principale della modalità di sviluppo di Power BI Desktop. Fornisce formati di file compatibili con il controllo del codice sorgente per sbloccarne lo sviluppo e migliorare l'efficienza di sviluppo.

Diagramma del progetto Power BI con TMDL e PBIR.

Power BI Projects (PBIP) supporta il salvataggio del report e del modello semantico in una cartella usando formati compatibili con il controllo del codice sorgente:

  • PBIR per il report.
  • TMDL per il modello semantico.

Il formato di file PBIR semplifica il rilevamento delle modifiche e la risoluzione dei conflitti di unione. Usa codice JSON formattato correttamente e organizza ogni oggetto visivo, pagina, segnalibro e così via, in singoli file separati all'interno di una struttura di cartelle.

Screenshot della struttura di cartelle JSON visiva.

È possibile migliorare l'efficienza di sviluppo dei report in uno dei due modi seguenti:

  • Copiare e incollare oggetti visivi, pagine, segnalibri o file tra report.
  • Applicare modifiche batch manuali o a livello di codice ai file PBIR.

A differenza del formato PBIR legacy (report.json), PBIR è un formato documentato pubblicamente. Questo formato consente modifiche da applicazioni non Power BI. Ogni file ha uno schema JSON pubblico, che documenta ogni proprietà e consente agli editor di codice come Visual Studio Code di eseguire la convalida della sintassi durante l'editing. All'apertura, Power BI Desktop convalida i file PBIR modificati per garantire il corretto caricamento.

Abilitare PBIR

PBIR è attualmente in anteprima. È possibile creare o convertire file di progetto di Power BI esistenti in PBIR usando Power BI Desktop. È prima necessario abilitare la funzionalità nelle funzionalità di anteprima di Power BI Desktop.

  1. Selezionare File>Opzioni e impostazioni>Opzioni>Funzionalità di anteprima.
  2. Selezionare la casella accanto a Archiviare i report usando il formato di metadati avanzato (PBIR).

Durante l'anteprima, le API Fabric Git Integration e Fabric REST continuano a usare PBIR-legacy (report.json) durante l'esportazione delle definizioni dei report. Tuttavia, se il report viene importato in Fabric usando il formato PBIR, entrambe le funzionalità iniziano a esportare la definizione del report usando il formato PBIR. Alla disponibilità generale (GA), PBIR diventerà il formato del report predefinito.

Per ulteriori dettagli, consultare la documentazione PBIR.