Power Apps からキャンバスアプリを埋め込む

[アーティクル]
11/15/2023

重要

Human Resources を使用している顧客の場合、この記事で説明した機能は、現在、スタンドアロン Dynamics 365 Human Resources とマージした Finance インフラストラクチャの両方で利用できます。更新中は、記載されたナビゲーションと異なる場合があります。特定のページを検索する場合は、検索を使用できます。

Microsoft Power Apps は開発者と技術者以外のユーザーがコードを記述せずにモバイルデバイス、タブレット、および Web 用のカスタムビジネスアプリを構築できるようにするサービスです。財務と運用アプリでは Power Apps との統合をサポートしています。ユーザー、組織、またはより幅広いエコシステムが開発するキャンバスアプリは、製品の機能を拡張するために財務と運用アプリに組み込むことができます。たとえば、別のシステムから取得した情報で財務と運用アプリを補完するために、Power Apps からキャンバスアプリを構築できます。

キャンバスアプリの埋め込みに関する詳細については、キャンバスアプリを組み込む方法のショートビデオをご覧ください。

埋め込みキャンバスアプリを Power Apps からページに追加する

Power Apps からクライアントにキャンバスアプリを埋め込む前に、目的のビジュアルまたは機能を備えたアプリを見つけるか構築する必要があります。この記事には、アプリを構築するプロセスの詳細な説明は含まれていません。初めて Power Apps を使用する場合は、Power Apps ドキュメントを参照してください。

財務と運用アプリにキャンバスアプリを埋め込むには 3 つの方法があります。シナリオに最適なアプローチを使用できます。

ページの標準アクションペインの Power Apps ボタンにキャンバスアプリを埋め込む。この方法で追加したアプリは Power Apps メニューボタンの項目として表示され、アプリはサイドペインに開きます。
既存のページに、キャンバスアプリを新しいタブページ (ピボットタブ、クイックタブ、ブレード、またはワークスペースのセクション) として埋め込む。
ダッシュボードから、キャンバスアプリの新しいフルページエクスペリエンスを作成する。

埋め込みキャンバスアプリを構成するときに、アプリへのコンテキストとして送信する単一のフィールドを選択できます。この手順により、現在表示しているデータに基づいてアプリが応答できるようになります。

メモ

このメカニズムを使用してモデル駆動型アプリを埋め込むことはできません。

既存のページにキャンバスアプリを埋め込む

次の手順では、Power Apps から既存のページにキャンバスアプリを埋め込む方法を示します。

キャンバスアプリを埋め込むページに移動します。このページは、入力としてアプリに渡す必要があるデータを含むページです。
Power Apps からアプリを追加ウィンドウを開きます。
- ページにアプリを直接埋め込む場合は、オプション>このページのパーソナライズ>詳細を選択し、次のいずれかの手順に従います:
  - フルページアプリ機能が有効になっている場合は、ページの追加を選択し、アプリを追加したい地域を選択します。 Power Apps メニューボタンにアプリを埋め込むには、アクションペインを選択します。ページに直接アプリを埋め込むには、適切なタブ、クイックタブ、ブレード、またはセクション (ワークスペースにいる場合) を選択します。次に、アプリを追加ペインで、Power Apps を選択します。
  - フルページアプリ機能が無効になっている場合は、Power Apps からアプリを追加を選択し、アプリを追加したい地域を選択します。 Power Apps メニューボタンにアプリを埋め込むには、アクションペインを選択します。ページに直接アプリを埋め込むには、適切なタブ、クイックタブ、ブレード、またはセクション (ワークスペースにいる場合) を選択します。
- Power Apps メニューボタンを使用してアプリにアクセスする場合、標準のアクションペインの Power Apps メニューボタンをクリックし、アプリの追加を選択します。
埋め込み型アプリを構成します。詳細については、この記事後述のキャンバスアプリを構成するを参照してください。
構成が正しいことを確認した後、挿入を選択します。
- 保存されたビュー機能を無効にした場合、埋め込みアプリを表示するためにブラウザを更新するよう求められます。
- 保存されたビュー機能を有効にした場合、変更を保持するためにビューを保存する必要があります。

ダッシュボードからのフルページエクスペリエンスとしてキャンバスアプリを埋め込む

アプリが既存のページに関連していない場合や、財務と運用アプリ内でフルページエクスペリエンスとして表示したいだけの場合に、ダッシュボードからキャンバスアプリを埋め込むことができます。

メモ

この機能を使用可能にするには、機能管理のフルページアプリ機能を有効にする必要があります。

ダッシュボードを開きます。
ページを選択したまま (または右クリック) にしてから、個人設定を選択して、ページを追加を選択します。
ページを追加ウィンドウで Power Apps を選択します。
埋め込み型アプリを構成します。詳細については、この記事後述のキャンバスアプリを構成するを参照してください。
保存を選択して、アプリを新しいタイルとしてダッシュボードに追加します。
ダッシュボードの新しいタイルを選択し、キャンバスアプリが予定通り表示されるかを確認します。

キャンバスアプリを構成する

キャンバスアプリを埋め込む際は、次のパラメーターを設定する必要があります:

名前 – 埋め込みアプリを含めるタブまたはボタンに表示するテキストを入力します。多くの場合、このフィールドでアプリの名前を繰り返すことができます。
アプリ ID – 埋め込むキャンバスアプリのグローバル一意識別子 (GUID) を指定します。この値を取得するには、make.powerapps.com でアプリを検索し、詳細の アプリ ID フィールドを確認します。
アプリのコンテキストを入力する – 必要に応じて、アプリに入力として渡すデータが含まれているフィールドを選択することができます。財務と運用アプリから送信されたデータにアプリがアクセスする方法については、この記事の後半にある財務と運用アプリから送信されたデータを活用するアプリの構築を参照してください。

バージョン 10.0.19 では、現在の法人も cmp URL パラメーターを介してコンテキストとしてキャンバスアプリに渡されます。この動作は、ターゲットのキャンバスアプリが情報を使用するまでアプリには影響しません。
アプリケーションサイズ – 埋め込むアプリのタイプを選択します。モバイルデバイス用に作成されたアプリに対してはシンを選択し、タブレット用に作成されたアプリに対してはワイドを選択します。このパラメーターにより、埋め込みアプリに十分な容量を確保できます。
法人 – アプリを使用できる法人を選択できます。既定では、すべての法人がアプリを使用できます。このオプションは、既存のページに直接埋め込み、保存されているビュー機能が無効になっている場合にのみ使用できます。

ページにキャンバスアプリを埋め込み、正しく動作することを確認したら、システム内の他のユーザーとアプリを共有できます。埋め込みキャンバスアプリを共有するには、次の手順を実行します。

Power Apps のキャンバスアプリを適切なユーザーと共有し、Power Apps から直接アプリにアクセスできるようにします。
埋め込みアプリに関連付けられた個人用設定を、目的のユーザーと共有します。次のアプローチのいずれかを使用できます:
- ビューを公開する (推奨):保存されているビュー機能が有効な場合、推奨される方法は、埋め込みキャンバスアプリを含むビューを作成し、目的のユーザーに公開することです。このアプローチを使用すると、公開されたビューの対象となるセキュリティロールを持つすべてのユーザーがページ上でキャンバスアプリを確認できるようになります。
  
  ダッシュボードからフルページエクスペリエンスとして埋め込まれたキャンバスアプリを公開することもできます。ダッシュボードで、アプリに関連付けられているタイルを選択したまま (または右クリック) にして、個人用設定を選択してから、ページを公開するを選択します。 ビューの公開エクスペリエンスと似たエクスペリエンスが表示され、公開するセキュリティロールを選択できます。更新プログラム 10.0.21 以降で、保存されたビューに対する改善された法人サポートが有効になっている場合は、目的の法人にアプリを公開することもできます。
- 保存されているビュー機能を無効にした場合、システム管理者は、個人用設定ページでキャンバスアプリを含む個人用設定を適切な一連のユーザーに与えることができます。また、ページの個人用設定をエクスポートして、1 人または複数のユーザーに送信することもできます。これらの各ユーザーは、個人用設定をインポートできます。個人用設定のツールバーには、個人用設定をエクスポートおよびインポートするためのボタンがあります。

メモ

キャンバスアプリが外部ユーザーと共有されている場合、これらのユーザーは、財務と運用アプリ内の埋め込みアプリを使用できません。ただし、Power Apps 内でアプリに直接アクセスできます。外部ユーザーには、財務と運用アプリが配置されている Microsoft 365 Azure ディレクトリに属さないゲストおよびユーザーが含まれます。

製品での個人用設定の機能について、およびそれらの使用方法の詳細については、ユーザーエクスペリエンスのパーソナライズを参照してください。

財務と運用アプリから送信されたデータを使用するキャンバスアプリの構築

財務と運用アプリに埋め込まれるキャンバスアプリを構築する場合、プロセスの重要な部分の 1 つは、財務と運用アプリからの入力データを使用することです。 Power Apps 開発エクスペリエンスからは、財務と運用アプリから渡される入力データには、Param("EntityId") 変数を使用してアクセスすることができます。また、バージョン 10.0.19 以降、現在の法人も Param("cmp") 変数を介してコンテキストとしてキャンバスアプリに渡されます。

たとえば、アプリの OnStart 機能では、財務と運用アプリから次のような変数に入力データを設定することができます。

If(!IsBlank(Param("EntityId")), Set(FinOpsInput, Param("EntityId")), Set(FinOpsInput, ""));

If(!IsBlank(Param("cmp")), Set(FinOpsLegalEntity, Param("cmp")), Set(FinOpsLegalEntity, ""));

キャンバスアプリの表示

財務と運用アプリのページに埋め込みキャンバスアプリを表示するには、埋め込みアプリがあるページに移動するだけです。標準アクションペインの Power Apps ボタンを使用してアプリにアクセスできることに注意してください。または、新しいタブ、クイックタブ、あるいはブレードとして、またはワークスペースの新しいセクションとしてページに直接表示することもできます。ユーザーがページに最初にアプリを読み込もうとすると、サインインするように求められます。この手順により、ユーザーはアプリを使用するための適切なアクセス許可を持っていることを確認します。

埋め込まれたアプリの編集

アプリがページに埋め込まれた後、そのアプリの設定をいくつか変更する必要がある場合があります。たとえば、埋め込まれたアプリに関連付けられたラベルを変更したり、アプリの新しいバージョンが作成された場合に、アプリ ID を最新の時点のものに更新したりする必要があります。

埋め込まれたアプリのコンフィギュレーションを編集するには、次の手順に従います。

アプリの編集ウインドウに移動します。
- 埋め込みアプリが Power Apps メニューボタンによりアクセスされた場合、Power Apps メニューボタンを選択したまま (または右クリック) にし、パーソナライズを選択します。 アプリの選択ドロップダウンメニューから構成するアプリを選択します。
- 埋め込み型のアプリがページに直接表示されたら、オプションを選択し、このページのパーソナライズを選択します。選択ツールを使用し、埋め込まれたアプリをクリックします。
- 埋め込みアプリがダッシュボードから追加された場合は、ダッシュボードを開き、そのキャンバスアプリに関連付けられているタイルを選択したまま (または右クリック) にし、パーソナライズを選択して、ページの編集を選択します。
アプリコンフィギュレーションに必要な変更を行ない、保存をクリックします。

アプリの削除

アプリがページに埋め込まれた後、必要に応じて削除するにはいくつかの方法があります。

この記事の前半にある埋め込みアプリの編集セクションからの手順を使用して、アプリの編集ウィンドウに移動します。ウィンドウに、削除する埋め込み型アプリの情報が表示されていることを確認してから、削除ボタンをクリックします。
埋め込みアプリがダッシュボードから追加された場合は、ダッシュボードを開き、そのキャンバスアプリに関連付けられているタイルを選択したまま (または右クリック) にし、パーソナライズを選択して、ページの削除を選択します。
埋め込まれたアプリは、個人用設定データとして保存されるため、ページの個人用設定をクリアすると、そのページの埋め込まれたアプリも削除されます。ページの個人用設定をクリアするのは、永久的なもので元に戻すことはできないことに注意してください。ページの個人用設定を削除するには、オプションを選択してこのページのパーソナライズ、最後にクリア ボタンをクリックします。ブラウザを更新した後、このページの以前のすべての個人用設定は、削除されます。個人用設定を使用してページを最適化する方法の詳細については、ユーザーエクスペリエンスのパーソナライズを参照してください。

付録

[開発者] フォーム上のアプリをモデル化する

この記事では、個人用設定を通じてキャンバスアプリを埋め込む方法に焦点を当てていますが、開発者は Visual Studio 開発エクスペリエンスを使用して、フォームにキャンバスアプリを追加することもできます。これを行うには、PowerAppsHostControl をフォームに追加します。コントロールで使用できるメタデータプロパティは、個人用設定のエクスペリエンスと同じ機能を提供します。

[開発者] アプリの埋め込み先の指定

既定では、ユーザーは、Power Apps メニューボタンの下または、タブ、クイックタブ、ブレード、またはワークスペースの新しいセクションとして任意のページに直接をアプリを埋め込むことができます。ただし、必要に応じて開発者が次の方法を実装することで、アプリの埋め込みを特定のページのみに許可するようこの機能を構成することもできます。

isPowerAppPersonalizationEnabled ーこのメソッドが、特定のページに対して false を返す場合、Power Apps メニューボタンは表示されず、ユーザーは、タブを含むこのページのどこにもアプリを埋め込むことができません。
isPowerAppTabPersonalizationEnabled ーこのメソッドが、特定のページに対して false を返す場合、タブ、クイックタブ、またはパノラマセクションとしてページに直接アプリを埋め込むことはできません。ページで埋め込みが許可されている場合でも、ユーザーは Power Apps メニューボタンを使用してアプリを埋め込むことができます。

次の例は、アプリを埋め込むための構成をするために必要な 2 つのメソッドを持つ新しいクラスを示しています。

[ExtensionOf(classStr(FormRunConfigurationPowerAppsConfiguration))]

public final class ClassTest_Extension
{
    public static boolean isPowerAppPersonalizationEnabled(str pageName)
    {
        var result = next isPowerAppPersonalizationEnabled(pageName);
        return result;
    }
    
    public static boolean isPowerAppTabPersonalizationEnabled(str pageName)
    {
        var result = next isPowerAppTabPersonalizationEnabled(pageName);
        return result;
    }
}

Power Apps からキャンバス アプリを埋め込む

埋め込みキャンバス アプリを Power Apps からページに追加する

既存のページにキャンバス アプリを埋め込む

ダッシュボードからのフル ページ エクスペリエンスとしてキャンバス アプリを埋め込む

キャンバス アプリを構成する

埋め込まれたアプリの共有

財務と運用アプリから送信されたデータを使用するキャンバス アプリの構築

キャンバス アプリの表示