PBIP dosyalarını Power BI Desktop dışında düzenleme

Çalışmanızı bir Power BI Desktop projesi olarak kaydettiğinizde, Power BI Desktop rapor ve anlam modeli tanımlarını tek tek metin dosyaları olarak depolar. Proje Power BI Desktop'ta açık kalırken desteklenen dosyaları Visual Studio Code (VS Code) veya başka bir dış araçla düzenleyebilirsiniz. Power BI Desktop, kaydedilen dosya değişikliklerini algılar ve bunları uygulamanızı ister, böylece projeyi kapatıp yeniden açmak zorunda değilsiniz.

Önemli

Power BI Desktop projeleri (PBIP) ve Power BI gelişmiş rapor biçimi (PBIR) genel olarak kullanılabilir. Power BI Desktop'ta dış PBIP değişikliklerini algılama ve yeniden yükleme şu anda önizleme aşamasındadır.

Bu makalede şunları öğreneceksiniz:

  • Proje dosyalarını düzenlemek için kullanışlı bir başlangıç noktası olarak Visual Studio Code'u doğrudan Power BI Desktop'tan nasıl açabilirsiniz.
  • Açık Power BI Masaüstü oturumunda desteklenen rapor ve anlam modeli dosya değişikliklerini uygulama.
  • Power BI Desktop'ın Power BI Desktop'taki kaydedilmemiş değişikliklerle proje dosyalarındaki değişiklikler arasındaki çakışmaları işleme şekli.

PBIP dosyalarını harici olarak düzenleme önkoşulları

  • Windows makinenize Power BI Desktop'ın Ağustos 2026 veya sonraki sürümünü yükleyin.
  • Power BI Desktop'ta Dosya>Seçenekleri ve ayarlar>Seçenekler>Önizleme özellikleri'ni seçin, Dış PBIP değişikliklerini algıla ve yeniden yükle'yi etkinleştirin ve ardından Power BI Desktop'ı yeniden başlatın.
  • Visual Studio Code veya başka bir kod düzenleyicisini veya dış aracı yükleyin.
  • Power BI Desktop projelerini PBIP biçiminde kaydedin. Daha fazla bilgi için bkz. Power BI Desktop projeleri.
  • PBIP kök klasörünü, her proje dosyası yolunu Windows 260 karakterlik yol sınırı altında tutan bir konumda depolayın.

VS Code'da PBIP klasörünü açma

Power BI Desktop, proje klasörüne yerleşik bir giriş noktası sağlar. Başlık çubuğunda proje adını seçin ve ardından Visual Studio Code'ı seçin. VS Code, rapor ve anlam modeli tanım dosyalarına erişebileceğiniz etkin çalışma alanı olarak proje klasörünü açar.

VS Code kullanmanın ekran görüntüsü.

Uyarı

VS Code, projeyi açmak için kullandığınız ve .pbip ya da .pbir dosyası olabilecek dosyayı içeren klasörü açar.

Proje dosyalarını düzenleme ve değişiklikleri uygulama

Proje dosyalarını ve açık Power BI Masaüstü oturumunu eşitlenmiş tutmak için aşağıdaki iş akışını kullanın:

  1. Power BI Desktop'ta proje dosyalarını harici olarak düzenlemeye başlamadan önce Kaydet'i seçin. Power BI Desktop, siz kaydetmeden proje dosyalarına en son değişikliklerini yazmaz.
  2. VS Code'da veya başka bir dış araçta desteklenen bir raporu veya anlam modeli dosyasını düzenleyin.
  3. Dosyayı dış araçta kaydedin.
  4. Power BI Desktop'ta, görüntülenen başlıkta Dış değişiklikleri uygula'yı seçin.
  5. Power BI Desktop'ta güncelleştirilmiş raporu veya anlam modelini gözden geçirin ve ardından Power BI Desktop'ta yapılan sonraki değişiklikleri kalıcı hale getirmek için hazır olduğunuzda projeyi kaydedin.

Power BI Desktop etkilenen raporu, anlam modelini veya her ikisini de proje dosyalarından yeniden yükler. Tek tek dosyaları veya görselleri yeniden yüklemez.

Dış değişiklikleri uygula başlığının ekran görüntüsü.

Power BI Desktop'ta kaydedilmemiş değişiklikleri çözme

Power BI Desktop kaydedilmemiş değişiklikler içeriyorsa, Dış değişiklikleri uygula'yı seçtiğinizde bu değişikliklerin üzerine yazılacağına dair bir uyarı görüntülenir.

  • Power BI Desktop'ta kaydedilmemiş değişiklikleri atmak ve en son proje dosyalarını yeniden yüklemek için Dış değişiklikleri uygula'yı seçin.
  • Kaydedilmemiş değişiklikleri Power BI Desktop'ta tutmak için İptal'i seçin. Dış dosya değişiklikleri diskte kalır ancak açık oturuma uygulanmaz.

Üzerine yazma mesajının ekran görüntüsü.

Önemli

Power BI Desktop ve dış araçlar, birbirlerinin yaptığı değişikliklerin üzerine yazabilir. Bunlar arasında geçiş yapmadan önce, her iki araç da aynı proje tanımlarını kullanacak şekilde geçerli değişiklikleri kaydedin veya uygulayın.

Power BI Masaüstü Köprüsü'nü kullanarak dış değişiklikleri uygulama

Dış değişiklikleri Power BI Masaüstü Köprüsü'nü kullanarak program aracılığıyla da uygulayabilirsiniz.

Dikkat edilmesi gerekenler ve sınırlamalar

  • Dış PBIP değişikliklerini algılama ve yeniden yükleme ve Power BI Masaüstü Köprüsü şu anda önizleme aşamasındadır. Özellikler ve davranışlar genel kullanılabilirlik öncesinde değişebilir.
  • Dış düzenleme ve yeniden yükleme, dosyalara değil .pbix PBIP projelerine uygulanır.
  • Power BI Desktop yeniden yüklemiyorcache.abf.
  • Yeniden yükleme filtreleri ve bazı kullanıcı arabirimi öğelerini sıfırlar.
  • Tüm proje dosyaları dış düzenlemeyi desteklemez. Dış değişiklikleri yeniden yükleme önizlemesi sırasında, report.json, mobileState.json, semanticModelDiagramLayout.json veya definition.pbir öğelerini Power BI Desktop dışında düzenleyemezsiniz.
  • Bir proje içeriyorsa unappliedChanges.json, semantik model ifadelerini harici olarak düzenlemeden önce bu değişiklikleri uygulayın. Aksi halde, Power BI Desktop bekleyen değişiklikleri uyguladığında harici ifade değişikliklerini atar.

İlgili içerik

  • Son güncelleştirme: