発行したテンプレート アプリを管理する

運用環境に Power BI テンプレート アプリがある場合、アプリに変更を加えたい場合は、運用環境のアプリを妨げることなく、テスト フェーズで最初から開始できます。

アプリを更新する

テンプレート アプリ ワークスペースに移動します。 その後、Power BI Desktop で変更を行った場合は、ステップ 1 から始めます。 Power BI Desktop で変更を行わなかった場合は、ステップ 2 から始めます。

  1. 更新されたセマンティック モデルをアップロード、既存のセマンティック モデルを上書きしてください

    • アップロードする .pbix ファイルの名前が、アプリで使用されているセマンティック モデルおよびレポートと同じ場合、アップロードによって既存のセマンティック モデルが上書きされます。

    • アプリで使用されているセマンティック モデルとレポートの名前を変更し、アップロードする .pbix ファイルの名前が、アプリで使用されているセマンティック モデルやレポートと異なる場合は、次のようにします:

      • 更新された .pbix ファイルの名前と正確に一致するように、アプリで使用されているセマンティック モデルとレポートの名前を変更します。
      • .pbix ファイルをアップロードし、作成し、名前を変更した既存のセマンティック モデルとレポートを上書きします。

      どちらの場合も、ローカルの .pbix ファイルをサービスにアップロードするには、[アップロード]>[参照] の順に選択し、ファイルに移動して [開く] を選択します。 アプリで使用されるセマンティック モデルを上書きするアクセス許可を求めるダイアログが表示されます。 既存のセマンティック モデルを上書きしない場合、顧客は更新されたアプリをインストールできません。

    Screenshot that shows the dialog requesting permission to overwrite the semantic model with the same name.

    重要

    アプリが使用するセマンティック モデルは削除しないでください。 セマンティック モデルを削除すると、顧客が自身のアプリを更新できなくなります。

  2. アプリの [リリース管理] ペインで [アプリの作成] を選択します。

  3. アプリの作成プロセスを繰り返します。 アプリで使用されているセマンティック モデルとレポートの名前を変更した場合は、アプリの名前も変更できます。

  4. [ブランド化][ナビゲーション][コントロール][パラメーター][認証][アクセス] を設定したら、もう一度 [アプリの作成] を選択して変更を保存し、[閉じる] を選択します。

  5. [リリース管理] をもう一度選択します。

    [リリース管理] ウィンドウに、アプリの 2 つのバージョン (運用のバージョンとテストの新しいバージョン) が表示されます。

    Screenshot that shows two versions of a template app.

  6. アプリを実稼働前ステージに昇格させ、テナントの外でテストする準備ができたら、[リリース管理] ウィンドウに戻り、[テスト] の隣にある [アプリの昇格] を選択します。

    これで運用にバージョンが 1 つ、運用前にバージョンが 1 つ用意されました。

    Screenshot that shows two versions of a template app with Promote app greyed out.

    これでリンクはライブになります。

    Note

    運用前ステージの [アプリの昇格] ボタンが無効になっています。 このボタンを無効にすると、Cloud パートナー ポータル (CPP) が新しいアプリバージョンを検証して承認する前に、ライブ運用リンクが現在のアプリ バージョンで誤って上書きされるのを防ぐことができます。

  7. Power BI アプリ オファーの更新に関する記事の手順に従って、CPP にリンクを再び送信します。 CPP で、オファーをもう一度公開し、検証し、承認する必要があります。 アプリの名前を変更した場合は、CPP でもその名前を必ず変更してください。 オファーが承認されると、[アプリの昇格] ボタンが再び有効になります。

  8. 運用ステージにアプリを昇格させます。

動作を更新する

  • アプリを更新すると、テンプレート アプリ インストーラーは、接続構成を失うことなく、既にインストールされているワークスペース内のテンプレート アプリを更新できます。

  • セマンティック モデルの変更がインストール済みのテンプレート アプリにどのように影響するかについては、「上書きの動作」を参照してください。

  • テンプレート アプリが上書きされて更新されると、最初にサンプル データに戻り、インストーラーの構成パラメーターと認証を使用して自動的に再接続します。 更新が完了するまで、レポート、ダッシュボード、組織のアプリにはサンプル データ バナーが表示されます。

  • 更新されたセマンティック モデルにユーザーによる入力を必要とする新しいクエリ パラメーターを追加した場合は、[必須] チェック ボックスをオンにする必要があります。 この選択により、アプリの更新後に、インストーラーに接続文字列が表示されます。

    Screenshot that shows Required under Parameters.

ワークスペースの抽出

抽出機能を使うと、以前のバージョンのテンプレート アプリに簡単にロールバックすることができます。 次の手順では、リリースの段階から新しいワークスペースに特定のアプリ バージョンを抽出します。

  1. [リリース管理] ペインで、アプリのバージョンの横にある [その他のオプション] を選択し、[抽出] を選択します。

    Screenshot that shows the Release Management pane with Extract selected.

  2. 確認ダイアログ ボックスで、抽出したワークスペースの名前を入力し、[抽出] を選択します。 Power BI によって、抽出されたアプリの新しいワークスペースが追加されます。

    Screenshot that shows the confirmation message to Extract this app.

新しいワークスペースのバージョン管理がリセットされ、新しく抽出されたワークスペースからテンプレート アプリの開発および配布を続行できます。

テンプレート アプリのバージョンの削除

テンプレート アプリ ワークスペースは、アクティブな配布済みテンプレート アプリのソースです。 テンプレート アプリのユーザーを保護するために、まずワークスペース内の作成済みのアプリ バージョンをすべて削除しなければ、テンプレート アプリ ワークスペースを削除することはできません。 アプリのバージョンを削除すると、機能しなくなるアプリ URL も削除されます。

  1. [リリース管理] ウィンドウで、削除したいアプリのバージョンの横にある [その他のオプション] を選択し、[削除] を選択します。

    Screenshot that shows the Release Management pane with Delete selected.

  2. 確認ダイアログ ボックスで、削除 を選択します。

    Screenshot that shows confirmation message to Delete this app.

Note

顧客や AppSource によって使用されているアプリのバージョンを削除しないようにしてください。そうしないと、それらは機能しなくなります。