Power BI Desktop の外部で PBIP ファイルを編集する

作業内容を Power BI Desktop プロジェクトとして保存すると、Power BI Desktop はレポートとセマンティック モデルの定義を個々のテキスト ファイルとして格納します。 サポートされているファイルは、Visual Studio Code (VS Code) または別の外部ツールを使用して編集できますが、プロジェクトは Power BI Desktop で開いたままです。 Power BI Desktop は、保存されたファイルの変更を検出し、それらを適用するように求めるメッセージを表示するため、プロジェクトを閉じて再度開く必要はありません。

Important

Power BI デスクトップ プロジェクト (PBIP) とPower BI拡張レポート形式 (PBIR) が一般公開されています。 Power BI Desktop での外部 PBIP 変更の検出と再読み込みは現在プレビュー段階です。

この記事では、次の内容について解説します:

  • プロジェクト ファイルを編集するための便利なエントリ ポイントとして、Power BI Desktop から直接Visual Studio Codeを開く方法。
  • サポートされているレポートとセマンティック モデル ファイルの変更を、開いている Power BI Desktop セッションに適用する方法。
  • Power BI Desktop で、Power BI Desktop の未保存の変更とプロジェクト ファイル内の変更の間の競合をどのように処理するか。

PBIP ファイルを外部で編集するための前提条件

  • Windows コンピューターに、Power BI Desktop の August 2026 リリース以降をインストールします。
  • Power BI Desktop で、File>オプションと設定>オプション>プレビュー機能 を選択し、外部 PBIP の変更を検出して再読み込みする を有効にしてから、Power BI Desktop を再起動します。
  • Visual Studio Codeまたはその他のコード エディターまたは外部ツールをインストールします。
  • Power BI デスクトップ プロジェクトを PBIP 形式で保存します。 詳細については、「Power BI デスクトップ プロジェクト」を参照してください。
  • PBIP ルート フォルダーを、Windows 260 文字のパス制限の下に各プロジェクト ファイル パスを保持する場所に格納します。

VS Code で PBIP フォルダーを開く

Power BI Desktop には、プロジェクト フォルダーへの組み込みのエントリ ポイントが用意されています。 タイトル バーでプロジェクト名を選択し、Visual Studio Codeを選択します。 VS Code は、プロジェクト フォルダーをアクティブなワークスペースとして開き、レポートおよびセマンティック モデル定義ファイルにアクセスできます。

VS Code の使用のスクリーンショット。

Note

VS Code は、プロジェクトを開くために使用したファイルを含むフォルダーを開きます。これは、 .pbip または .pbir ファイルである可能性があります。

プロジェクト ファイルを編集して変更を適用する

次のワークフローを使用して、プロジェクト ファイルと開いている Power BI Desktop セッションの同期を維持します。

  1. Power BI デスクトップで、プロジェクト ファイルの外部編集を開始する前に [保存] を選択します。 Power BI Desktop では、保存するまで、最新の変更はプロジェクト ファイルに書き込まれません。
  2. VS Code または別の外部ツールで、サポートされているレポートまたはセマンティック モデル ファイルを編集します。
  3. ファイルを外部ツールに保存します。
  4. Power BI デスクトップで、表示されるバナーで [外部の変更を適用] を選択します。
  5. Power BI Desktop で更新されたレポートまたはセマンティック モデルを確認し、Power BI Desktop で行われた後続の変更を保持する準備ができたら、プロジェクトを保存します。

Power BI Desktop は、影響を受けるレポート、セマンティック モデル、またはその両方をプロジェクト ファイルから再読み込みします。 個々のファイルやビジュアルは再読み込みされません。

[外部変更の適用] バナーのスクリーンショット。

Power BI Desktop で保存されていない変更を解決する

Power BIデスクトップに未保存の変更が含まれている場合は、[外部変更の適用] を選択すると、それらの変更が上書きされることを示す警告が表示されます。

  • [外部変更の適用] を選択して、Power BI デスクトップで未保存の変更を破棄し、最新のプロジェクト ファイルを再読み込みします。
  • [キャンセル] を選択すると、Power BI デスクトップで未保存の変更が保持されます。 外部ファイルの変更はディスク上に残りますが、開いているセッションには適用されません。

上書きメッセージのスクリーンショット。

Important

Power BIデスクトップツールと外部ツールは、お互いの変更を上書きできます。 これらの変更を切り替える前に、両方のツールで同じプロジェクト定義が使用されるように、現在の変更を保存または適用します。

Power BI デスクトップ ブリッジを使用して外部の変更を適用する

Power BI デスクトップ ブリッジを使用して、外部の変更をプログラムで適用することもできます。

考慮事項と制限事項

  • 外部 PBIP 変更と Power BI デスクトップ ブリッジの検出と再読み込みは現在プレビュー段階です。 機能と動作は、一般公開前に変更される可能性があります。
  • 外部編集と再読み込みは PBIP プロジェクトに適用され、 .pbix ファイルには適用されません。
  • Power BIデスクトップはcache.abfを再読み込みしません。
  • 再読み込みすると、フィルターと一部のユーザー インターフェイス要素がリセットされます。
  • すべてのプロジェクト ファイルが外部編集をサポートしているわけではありません。 外部の変更の再読み込みプレビュー中は、definition.pbir、report.json、mobileState.json、またはsemanticModelDiagramLayout.jsonをPower BI Desktop の外部で編集することはできません。
  • プロジェクトに unappliedChanges.jsonが含まれている場合は、セマンティック モデル式を外部で編集する前に、それらの変更を適用します。 それ以外の場合、Power BI Desktop は、保留中の変更を適用すると、外部式の変更を破棄します。

関連するコンテンツ

  • Last updated on