Bagikan melalui

Membuat laporan Power BI dalam format laporan yang disempurnakan

BERLAKU UNTUK: Power BI Desktop layanan Power BI

Format laporan yang disempurnakan Power BI (PBIR) untuk file Proyek Power BI (PBIP) menandai tonggak pencapaian dalam mencapai tujuan utama mode pengembang Power BI Desktop. Ini menyediakan format file ramah kontrol sumber untuk membuka blokir kemiringan kode dan meningkatkan efisiensi pengembangan.

Diagram Proyek Power BI dengan TMDL dan PBIR.

Power BI Projects (PBIP) mendukung penyimpanan laporan dan model semantik ke dalam folder menggunakan format ramah kontrol sumber:

  • PBIR untuk laporan.
  • TMDL untuk model semantik.

Format file PBIR menyederhanakan pelacakan perubahan dan mengatasi konflik penggabungan. Ini menggunakan JSON yang diformat dengan benar dan mengatur setiap visual, halaman, marka buku, dan sebagainya, dalam file individual terpisah dalam struktur folder.

Cuplikan layar struktur folder json visual.

Anda dapat meningkatkan efisiensi pengembangan laporan dengan salah satu dari dua cara:

  • Salin dan tempel visual, halaman, marka buku, atau file di antara laporan.
  • Terapkan perubahan batch manual atau terprogram ke file PBIR.

Tidak seperti format warisan PBIR (report.json), PBIR adalah format yang didokumenkan secara publik. Format ini memungkinkan modifikasi dari aplikasi non-Power BI. Setiap file memiliki skema JSON publik, yang mendokuensikan setiap properti dan memungkinkan editor kode seperti Visual Studio Code melakukan validasi sintaks saat mengedit. Saat terbuka, Power BI Desktop memvalidasi file PBIR yang diubah untuk menjamin keberhasilan pemuatan.

Cara mengaktifkannya

PBIR saat ini dalam pratinjau. Anda hanya bisa membuat atau mengonversi file proyek Power BI yang sudah ada ke PBIR dengan menggunakan Power BI Desktop. Anda harus terlebih dahulu mengaktifkan fitur di fitur pratinjau Power BI Desktop.

  1. Buka Opsi File>dan pengaturan>Fitur Pratinjau Opsi.>
  2. Centang kotak di samping Simpan laporan menggunakan format metadata yang disempurnakan (PBIR).

Selama pratinjau, Fabric Git Integration dan Fabric REST API terus menggunakan PBIR-legacy (report.json) saat mengekspor definisi laporan. Namun, jika laporan diimpor ke Fabric menggunakan format PBIR, kedua fitur mulai mengekspor definisi laporan menggunakan format PBIR. Pada ketersediaan umum (GA), PBIR akan menjadi format laporan default.

Batasan

Awalnya, format PBIR memiliki beberapa batasan layanan, seperti ini:

  • Anda tidak dapat menggunakan langganan.
  • Tampilan seluler tidak ditampilkan di Aplikasi Power BI.
  • Tidak dapat disebarkan dengan alur penyebaran.
  • Laporan besar dengan lebih dari 500 file mengalami masalah performa penulisan (tampilan laporan tidak terpengaruh), termasuk:
    • Menyimpan dalam Power BI Desktop
    • Sinkronisasi dalam Integrasi Fabric Git

Lihat dokumentasi PBIR untuk detail selengkapnya.

Langkah berikutnya