Edit file PBIP di luar Power BI Desktop

Saat Anda menyimpan pekerjaan Anda sebagai proyek desktop Power BI, Power BI Desktop menyimpan laporan dan definisi model semantik sebagai file teks individual. Anda dapat mengedit file yang didukung dengan Visual Studio Code (Visual Studio Code) atau alat eksternal lainnya saat proyek tetap terbuka di Power BI Desktop. Power BI Desktop mendeteksi perubahan file yang disimpan dan meminta Anda untuk menerapkannya, sehingga Anda tidak perlu menutup dan membuka kembali proyek.

Important

proyek Power BI Desktop (PBIP) dan format laporan Power BI yang disempurnakan (PBIR) telah tersedia secara umum. Pendeteksian dan pemuatan ulang perubahan PBIP eksternal di Power BI Desktop saat ini masih dalam pratinjau.

Dalam artikel ini, Anda belajar tentang:

  • Cara membuka Visual Studio Code langsung dari Power BI Desktop sebagai titik masuk yang nyaman untuk mengedit file proyek.
  • Cara menerapkan perubahan pada laporan yang didukung dan file model semantik dalam sesi Power BI Desktop yang sedang terbuka.
  • Bagaimana Power BI Desktop menangani konflik antara perubahan yang tidak disimpan di Power BI Desktop dan perubahan dalam file proyek.

Prasyarat untuk mengedit file PBIP secara eksternal

  • Instal rilis Agustus 2026 atau yang lebih baru dari Power BI Desktop di komputer Windows Anda.
  • Di Power BI Desktop, pilih Opsi File>dan pengaturan>Opsi>Fitur pratinjau, aktifkan Deteksi dan muat ulang perubahan PBIP eksternal, lalu mulai ulang Power BI Desktop.
  • Instal Visual Studio Code atau editor kode lain atau alat eksternal.
  • Simpan proyek Power BI Desktop dalam format PBIP. Untuk informasi selengkapnya, lihat proyek Power BI Desktop.
  • Simpan folder akar PBIP di lokasi yang menyimpan setiap jalur file proyek di bawah batas jalur Windows 260 karakter.

Buka folder PBIP di Visual Studio Code

Power BI Desktop menyediakan titik masuk bawaan ke folder proyek. Pilih nama proyek di bilah judul, lalu pilih Visual Studio Code. Visual Studio Code membuka folder proyek sebagai ruang kerja aktif, tempat Anda dapat mengakses file definisi model semantik dan laporan.

Cuplikan layar menggunakan Visual Studio Code.

Note

Vs Code membuka folder yang berisi file yang Anda gunakan untuk membuka proyek, yang mungkin berupa .pbip file atau .pbir .

Mengedit file proyek dan menerapkan perubahan

Gunakan alur kerja berikut untuk menjaga file proyek dan sesi desktop Power BI terbuka disinkronkan:

  1. Di Power BI Desktop, pilih Simpan sebelum Anda mulai mengedit file proyek secara eksternal. Power BI Desktop tidak menulis perubahan terbarunya pada file proyek hingga Anda menyimpan.
  2. Edit laporan yang didukung atau file model semantik di Visual Studio Code atau alat eksternal lainnya.
  3. Simpan file di alat eksternal.
  4. Di Power BI Desktop, pilih Terapkan perubahan eksternal di banner yang muncul.
  5. Tinjau laporan atau model semantik yang diperbarui di Power BI Desktop, lalu simpan proyek saat Anda siap untuk mempertahankan perubahan berikutnya yang dibuat di Power BI Desktop.

Power BI Desktop memuat ulang laporan yang terpengaruh, model semantik, atau keduanya dari file proyek. Ini tidak memuat ulang file atau visual individual.

Cuplikan layar banner

Mengatasi perubahan yang tidak disimpan di Power BI Desktop

Jika Power BI Desktop berisi perubahan yang tidak disimpan, memilih Terapkan perubahan eksternal akan menampilkan peringatan bahwa perubahan tersebut akan ditimpa.

  • Pilih Terapkan perubahan eksternal untuk membuang perubahan yang tidak disimpan di Power BI Desktop dan muat ulang file proyek terbaru.
  • Pilih Batal untuk menyimpan perubahan yang tidak disimpan di Power BI Desktop. Perubahan file eksternal tetap ada di disk tetapi tidak diterapkan ke sesi terbuka.

Cuplikan layar pesan penimpaan.

Important

Power BI Desktop dan alat eksternal dapat menimpa perubahan satu sama lain. Sebelum Anda beralih di antara mereka, simpan atau terapkan perubahan saat ini sehingga kedua alat menggunakan definisi proyek yang sama.

Terapkan perubahan eksternal dengan menggunakan Power BI Desktop Bridge

Anda juga dapat menerapkan perubahan eksternal secara terprogram dengan menggunakan Power BI Desktop Bridge.

Pertimbangan dan keterbatasan

  • Mendeteksi dan memuat ulang perubahan PBIP eksternal serta Power BI Desktop Bridge saat ini masih dalam pratinjau. Fitur dan perilaku mungkin berubah sebelum ketersediaan umum.
  • Pengeditan dan pemuatan ulang eksternal berlaku untuk proyek PBIP, bukan .pbix file.
  • Power BI Desktop tidak memuat ulang cache.abf.
  • Memuat ulang akan mereset filter dan beberapa elemen antarmuka pengguna.
  • Tidak semua file proyek mendukung pengeditan eksternal. Selama pratinjau pemuatan ulang perubahan eksternal, Anda tidak dapat mengedit definition.pbir, , report.jsonmobileState.json, atau semanticModelDiagramLayout.json di luar Power BI Desktop.
  • Jika proyek berisi unappliedChanges.json, terapkan perubahan tersebut sebelum Anda mengedit ekspresi model semantik secara eksternal. Jika tidak, Power BI Desktop membuang perubahan ekspresi eksternal saat menerapkan perubahan yang tertunda.

Konten terkait

  • Terakhir diperbarui pada