キャンバスアプリパッケージのエクスポートとインポート

[アーティクル]
04/09/2023

この記事では、キャンバスアプリをエクスポートおよびインポートする方法を学習します。

パッケージを使用して、キャンバスアプリをエクスポートおよびインポートできます。この機能を使用すると、ある環境からアプリをエクスポートし、別の環境にインポートできます。キャンバスアプリパッケージをエクスポートおよびインポートする場合は、使用可能なオプションに最適なシナリオを検討してください。例えば、場所を このコンピューター として選択すると、名前を付けて保存 オプションを使用してキャンバスアプリをローカルに保存できます。保存されたファイルにはファイル名の拡張子 .msapp が付きます。このファイルには、Power Automate で作成され、保存したアプリで使用されるフローなどの追加コンポーネントは含まれません。この方法を使用して既存のアプリのコピーを作成できますが、パッケージに追加リソースを含む、推奨されるエクスポートおよびインポート機能を使用できます。エクスポートとインポートパッケージのファイル形式は .zip です。

重要

キャンバスアプリパッケージは、パッケージの非互換性のため、Dataverse ソリューションパッケージでは使用できません。
フロー、接続参照など Dataverse 依存関係があるキャンバスアプリは、キャンバスアプリパッケージではサポートされていません。 Microsoft Power Platform 環境内の ALM 機能については、キャンバスアプリパッケージのエクスポートとインポートではなく、Microsoft Dataverse とソリューションを使用します。詳細: ALM の概要
App Insights インストルメンテーションキーは、インポートされたキャンバスアプリに存在する場合があります。アプリをインポートした後、インストルメンテーションキーを調べて、目的の App Insights リソースに対応していることを確認します。

パッケージに含まれるリソース

アプリは、さまざまなリソースを使用する可能性があります。たとえば、ほとんどのアプリは接続を使用します。他のアプリでは、Power Automate を使用したり、カスタムコネクタを準備したり、あるいはゲートウェイを使用してオンプレミスのリソースに接続したりできます。一部のアプリは Dataverse のカスタマイズを使用することもできます。

次の表では、さまざまなリソースタイプ、サポータビリティ、インポートオプションを説明します。

リソースの種類	サポートされています	インポートオプション
App	はい、キャンバスアプリの場合	環境にアプリをインポートするには、2 つのオプションがあります。新規作成: パッケージがインポートされた環境に新しいアプリとしてアプリが作成されます。更新: アプリが環境に既に存在し、このパッケージのインポート時に更新されます。
Power Automate	はい	環境にフローをインポートするには、2 つのオプションがあります。新規作成: パッケージがインポートされた環境に新しいフローとしてフローが作成されます。更新: フローが環境に既に存在し、このパッケージのインポート時に更新されます。注: フローが依存するすべてのリソースは、エクスポートされるアプリパッケージにも含まれますが、パッケージのインポート時に構成する必要があります。ソリューションを使用して、フローをエクスポートおよびインポートすることもできます。詳細: Power Automate のソリューション
カスタムコネクタ	いいえ	カスタムコネクタのエクスポートはサポートされていません。ターゲット環境でカスタムコネクタを再作成する必要があります。
接続	いいえ	接続のエクスポートはサポートされていません。ターゲット環境で接続を再作成する必要があります。
Dataverse のカスタマイズ	いいえ	キャンバスアプリパッケージの一部として Dataverse のカスタマイズのエクスポートはサポートされていません。 Dataverse ソリューションを代わりに使用する必要があります。詳細: Dataverse のソリューション
ゲートウェイ	いいえ	ゲートウェイをエクスポートまたはインポートすることはできません。ターゲット環境でゲートウェイを再作成する必要があります。

キャンバスアプリパッケージのエクスポートに必要な権限

アプリの 所有者 または 共同所有者 のみ、キャンバスアプリパッケージをエクスポートできます。アプリをインポートするには、環境メーカー アクセス許可が移行先の環境で必要です。

キャンバスアプリパッケージのエクスポート

キャンバスアプリパッケージをエクスポートするには、アプリを選択してから、エクスポートパッケージ を選択します。

エクスポートチュートリアルの例を含むエクスポートパッケージの GIF デモ。

キャンバスアプリが使用するリソースごとに既定の インポートアクション を変更できます。アプリを含むキャンバスアプリパッケージ内のリソースの既定のアクションは、更新です。インポート中に 新規として作成 を選択して、既存のリソースを更新する代わりに、インポート中にリソースを作成できます。ただし、選択したインポートアクションは、アプリのインポート中の既定のアクションになります。

重要

エクスポートされたパッケージのみインポートできます。エクスポートされたパッケージファイルへの変更はサポートされていません。

キャンバスアプリパッケージをエクスポートするには

Power Apps にサインインします。
左側のウィンドウから、アプリを選択します。
エクスポートするアプリを選択します。
エクスポートパッケージ を選択します。
パッケージの名前と説明を入力します。必要に応じて環境名も変更できます。
更新を選択して、アプリパッケージリソースのインポートアクションを選択します。
インポート中にアプリを作成する必要がある場合は 新規として作成 を選択し、既存のアプリを更新するには更新を選択します。

注意

インポート設定 アクションテキストは、新しい選択に応じて変化します。
アプリパッケージの追加リソースごとに、前の手順を繰り返します。
(オプション) を選択して (コメントアイコン) 各リソースにコメントを挿入します。
エクスポート を選択して、パッケージをエクスポートします。

パッケージは、ブラウザーの既定のダウンロードフォルダーにダウンロードされます。

キャンバスアプリパッケージのインポート

キャンバスアプリパッケージをインポートするには、キャンバスアプリのインポート を選択します。アプリパッケージリソースごとに正しいアクションを選択してください—たとえば、アプリまたはフローの新しいインスタンスを作成します。アプリパッケージのエクスポート中に入力されたコメントの追加情報を読むこともできます。

エクスポートチュートリアルの例を含むインポートパッケージの GIF デモ。

既存のアプリまたはリソースを更新する場合は、必ずアプリを公開して、ユーザーが変更を確認できるようにします。

ヒント

各リソースの種類のアイコンの変更を表示することで、アプリパッケージをインポートする前に選択内容をすばやく確認できます。

アイコン	内容
	新規として作成: 新しいリソースが作成されます。
	インポートアクションが変更されました: リソースのインポートアクションが変更されました。
	必要なアクション: アプリパッケージをインポートする前に、インポートアクションを選択する必要があります。

キャンバスアプリパッケージをインポートするには

Power Apps にサインインします。
左側のウィンドウから、アプリを選択します。
キャンバスアプリをインポートします。
アップロード を選択して、インポートするアプリパッケージファイルを選択します。
リソースの インポート設定 アクション、またはを選択します。
- 新規として作成 を選択すると、リソース名を変更できます。
- 更新を選択した場合は、インポート中に更新するアプリを選択します。
アプリパッケージの追加リソースごとに、前の手順を繰り返します。
(オプション) アプリパッケージに接続への参照が含まれている場合、使用可能な接続リストから接続を選択できます。

インポート中に選択 を選択し、適切な接続を選択します。

注意

使用可能な接続がない場合、または必要な接続がリストにない場合は、新規作成 を選択して、新しいブラウザータブで新しい接続を作成します。必ず正しいリソースの種類の接続を作成してください。接続を作成したら、インポートアプリのブラウザータブに戻り、リストの更新 を選択し、新しく作成された接続を反映して選択します。
(オプション) アプリパッケージのエクスポート中にリソースにコメントが入力された場合、コメントアイコンが塗りつぶされて表示され、カーソルを合わせるとテキスト コメントあり が表示されます。コメントを選択して表示します。
アプリパッケージをインポートするには、インポート を選択します。

重要

既存のアプリの更新を選択すると、新しい変更はアプリのドラフトとして保存されます。ユーザーが変更を確認できるようにアプリを公開する必要があります。