次の方法で共有


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

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

プロパティ値を入力する

  1. PowerShell で、そのビジュアルが実行中の場合は停止します。

  2. VS Code で、ビジュアル プロジェクトのルート フォルダーに移動し、pbiviz.js ファイルを開きます。

  3. visual オブジェクトの中の displayName の値を、ビジュアルの表示名に設定します。

    Screenshot of VS Code, which shows the display name value is set to Circle Card.

    ビジュアルの表示名は、Power BI の [視覚化] ペインでビジュアルのアイコンの上にカーソルを置いたときに表示されます。

  4. pbiviz.json ファイル内の次のフィールドを入力または変更します。

    • visualClassName
    • description

    visualClassName は省略可能ですが、description はパッケージ コマンドを実行するために入力が必要です。

  5. supportUrlgitHubUrl に、ユーザーがサポートを受けるために、およびビジュアルの GitHub プロジェクトを閲覧するためにアクセスできる URL を入力します。

    次のコードに supportUrlgitHubUrl の例を示します。

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. author オブジェクトに名前と電子メールを入力します。

  7. pbiviz.json ファイルを保存します。

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

  1. pbiviz.json ファイルの中の assets オブジェクトで、ドキュメントによってアイコンへのパスが定義されていることに注目してください。 このアイコンが、Power BI の[視覚化] ペインに表示される画像です。 これは、PNG 形式ファイルで 20 x 20 ピクセルであることが必要です。

  2. エクスプローラーで、使用したい icon.png ファイルをコピーしてから貼り付けることで、assets フォルダーにある既定の icon.png ファイルを置き換えます。

  3. VS Code の [エクスプローラー] ペインで、assets フォルダーを展開してから、icon.png ファイルを選択します。

  4. アイコンを確認します。

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

  1. VS Code で、すべてのファイルが保存されていることを確かめます。

  2. PowerShell で、次のコマンドを入力して .pbiviz ファイルを生成します。

    pbiviz package
    

    このコマンドによって、pbiviz ファイルがビジュアル プロジェクトの /dist/ ディレクトリに作成され、以前の pbiviz ファイルが存在する場合は上書きされます。

    Screenshot of Windows Explorer, which shows the folder hierarchy of the Power BI visual project. The dist folder is highlighted.

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

次のステップ