Power BI の視覚化をパッケージ化する

[アーティクル]
03/23/2023

カスタムビジュアルを Power BI Desktop に読み込むことができるようにする、または Power BI ビジュアルギャラリーでコミュニティと共有できるようにするには、パッケージ化する必要があります。このチュートリアルを使用して、次のことを行います。

ビジュアルのメタデータとプロパティ値を指定します。
アイコンを更新します。
カスタムビジュアルをパッケージ化します。

プロパティ値を入力する

PowerShell で、そのビジュアルが実行中の場合は停止します。
VS Code で、ビジュアルプロジェクトのルートフォルダーに移動し、pbiviz.js ファイルを開きます。
visual オブジェクトの中の displayName の値を、ビジュアルの表示名に設定します。

ビジュアルの表示名は、Power BI の [視覚化] ペインでビジュアルのアイコンの上にカーソルを置いたときに表示されます。
pbiviz.json ファイル内の次のフィールドを入力または変更します。
- visualClassName
- description
visualClassName は省略可能ですが、description はパッケージコマンドを実行するために入力が必要です。
supportUrl と gitHubUrl に、ユーザーがサポートを受けるために、およびビジュアルの GitHub プロジェクトを閲覧するためにアクセスできる URL を入力します。

次のコードに supportUrl と gitHubUrl の例を示します。
```
{
    "supportUrl": "https://community.powerbi.com",
    "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
}
```
author オブジェクトに名前と電子メールを入力します。
pbiviz.json ファイルを保存します。

アイコンを更新する (省略可能)

pbiviz.json ファイルの中の assets オブジェクトで、ドキュメントによってアイコンへのパスが定義されていることに注目してください。このアイコンが、Power BI の[視覚化] ペインに表示される画像です。これは、PNG 形式ファイルで 20 x 20 ピクセルであることが必要です。
エクスプローラーで、使用したい icon.png ファイルをコピーしてから貼り付けることで、assets フォルダーにある既定の icon.png ファイルを置き換えます。
VS Code の [エクスプローラー] ペインで、assets フォルダーを展開してから、icon.png ファイルを選択します。
アイコンを確認します。

ビジュアルをパッケージ化する

VS Code で、すべてのファイルが保存されていることを確かめます。
PowerShell で、次のコマンドを入力して .pbiviz ファイルを生成します。
```
pbiviz package
```
このコマンドによって、pbiviz ファイルがビジュアルプロジェクトの /dist/ ディレクトリに作成され、以前の pbiviz ファイルが存在する場合は上書きされます。

パッケージはプロジェクトの /dist/ フォルダーに出力されます。パッケージには、カスタムビジュアルを Power BI サービスまたは Power BI Desktop レポートにインポートするために必要なものがすべて含まれています。カスタムビジュアルのパッケージ化が完了し、使用する準備が整いました。

次のステップ

Power BI ビジュアルをパートナーセンターに発行する

カスタム視覚化をインポートする