埋め込みキャンバス アプリに現在のレコードをデータ コンテキストとして渡す

重要

モデル駆動型フォームに埋め込まれたキャンバス アプリケーションがプレビューから外され、一般的に、使用可能です。 以下に示す手順は古すぎて、モデル駆動型フォームに埋め込まれたキャンバス アプリケーションの共有プレビューリリースに対してのみ適用可能です。 最新リリースの手順の更新された一覧については、 駆動型モデルのキャンバス アプリケーションの埋め込みフォームの追加 を参照してください。

このトピックでは、埋め込みキャンバス アプリを追加して、現在の (メイン フォーム) レコードをデータ コンテキストとして埋め込みキャンバス アプリに渡す方法を説明します。

埋め込みキャンバス アプリを取引先企業のメイン フォーム上に追加して、現在の取引先企業レコードを埋め込みキャンバス アプリに渡すことを想定します。 これを行うには、次の手順を実行します。

1. Power Apps にサインインして、取引先企業テーブルなどのテーブルのメイン フォームのためにフォーム エディターを開きます。
2. 埋め込みキャンバス アプリを表示するフォーム上のセクションを選択します。
3. 列エクスプローラー ペインを使用して、アカウント名 などの必須列を追加します。

   重要

   必ず値を持つ必須列を常に使用します。 列に値がない場合、埋め込みキャンバス アプリはホストのモデル駆動型フォーム上のデータが変更されるときに最新の情報に更新されません。

4. 選択した列で、ホーム タブの 編集 グループで、プロパティの変更 を選択します。
5. 列のプロパティ ダイアログ ボックスで、コントロール タブを選択します。
6. コントロール タブで、コントロールの追加... を選択します。
7. コントロールの追加 ダイアログ ボックスの、使用可能なコントロールの一覧で、キャンバス アプリ を選択してから 追加 を選択します。
8. 列プロパティ ダイアログ ボックスで、コントロールの一覧から キャンバス アプリ を選択し、Web オプションを選択します。
9. コントロール リストの下部のセクションに、キャンバス アプリ コントロールで使用可能なプロパティのリストが表示されます。
   • テーブル名 プロパティは、埋め込みキャンバス アプリにデータを提供するテーブルを指定します。 これは、以前のステップで追加した列を含むテーブルにセットされます。
     • このプロパティが変更可能として表示される場合であっても、それに対する変更が埋め込みキャンバス アプリ上に影響を与えないことに注意してください。 それは参照することのみを目的としています。
   • アプリ ID プロパティは埋め込みキャンバス アプリの ID を指定します。 これはキャンバス アプリが作成されるときに自動的に生成および入力されます。
     • アプリ ID の値を変更すると、モデル駆動型フォームから埋め込みキャンバス アプリへのリンクが切断されることに注意してください。
10. キャンバス アプリを作成または編集するには カスタマイズ を選択します。 これは新規タブの、 Power Apps Studio で開きます。

    注意

    • カスタマイズ オプションは現在、従来のフォーム デザイナーを使用した場合にのみ使用できます。
    • Power Apps Studio を開くことが Web ブラウザーのポップアップ ブロッカーによりブロックされた場合は、make.powerapps.com サイトを有効にするか、一時的にポップアップ ブロッカーを無効にしてから、再び カスタマイズ を選択する必要があります。
11. Power Apps Studio の通知には、 ウィンドウの左側に特別な ModelDrivenFormIntegration コントロールが表示されます。 このコントロールは、ホストのモデル駆動型フォームから埋め込みキャンバス アプリにコンテキスト データを取り込みます。
12. Gallery1 コントロールを選択して、アイテム プロパティに ModelDrivenFormIntegration.Data がセットされていることを確認します。

    注意

    ModelDrivenFormIntegration.Data はレコードのリストです。 この例ではレコードは 1 つのみです。 直接レコードを参照するには、First 関数を使用することができます。 たとえば、First(ModelDrivenFormIntegration.Data).Name です。

13. 右側のプロパティ ペインで、列 の隣にある 編集 を選択します。
14. データ ウィンドウで、Title1 コントロールにマッピングされた列を 名前 に変更、またはデータを持つ他の列に変更します。
15. ギャラリーに、ホストのモデル駆動型フォームから ModelDrivenFormIntegration コントロールを介して渡されるデータが表示されることを確認します。 データ ウィンドウを閉じます。
16. ファイル タブ、設定 の順に選択します。
17. 試験的な機能 セクションの 近日公開の機能 タブで、埋め込みの外観の最適化 を オン に設定します。
18. 全般 タブを選択します。アプリに一意の名前を指定し、保存 を選択します。 以下に注意します。
    • アプリを初めて保存するときは、アプリが自動的に公開されます。
    • それ以降の保存時には、公開 を選択してから このバージョンを公開 を選択し、変更を有効にします。
19. 設定 ダイアログを閉じます。
20. メニュー上で 戻る を選択してから、フォーム エディターを開いたブラウザー タブを選択します。 キャンバス アプリ コントロールの アプリ ID プロパティの値が自動的に入力されたことを確認します。 以下に注意します。
    • フォーム エディターには前のステップで他のブラウザー タブで開いた Power Apps Studio とのダイレクト リンクがあります。
    • フォーム エディターは送信される アプリ ID を「リスニング」します。
    • アプリ ID はアプリが保存されるときにエディターから送信されます。
21. フィールド プロパティ ダイアログ ボックスで、表示 タブを選択します。
22. フォーム上の ラベルの表示 をクリアしてから OK を選択します。
    • このフォームに埋め込まれたキャンバス アプリが既にある場合は、「1 つのフォームで 1 つのキャンバス アプリのみを有効にすることができます。」というメッセージが表示されます。 新しいキャンバス アプリを追加するには、まず現在の埋め込みキャンバス アプリを無効化する必要があります。 次に、新しい埋め込みキャンバス アプリを有効化します。
23. ホーム タブで、保存 を選択してから、公開 を選択します。

埋め込みキャンバス アプリを自分のモデル駆動型フォームに追加した後、埋め込みキャンバス アプリを他のユーザーと共有します。 詳細: 埋め込みキャンバス アプリの共有。

修正したフォームを含むモデル駆動型アプリ (統一インターフェイスのみ) を開くと、埋め込みキャンバス アプリがフォーム上に表示されます。 メイン フォームに表示される行を変更すると、フォームに渡されたデータ コンテキストが変更され、関連するデータを表示するように埋め込みアプリがリフレッシュされます。

このトピックは、モデル駆動型フォームで埋め込みキャンバス アプリを使用する方法を説明しました。 さまざまなデータ ソースに接続してデータを取り込むように、埋め込みキャンバス アプリをさらにカスタマイズすることができます。 フィルター、検索、およびルックアップ機能、およびホストのモデル駆動型フォームからフィルターから渡されたコンテキストを使用して、これらのデータ ソース内の特定のレコードをフィルター処理または検索します。 WYSIWYG キャンバス アプリ エディターを使用して、ユーザーの環境に合ったインターフェイスを簡単に設計します。

関連項目

モデル駆動型フォーム上にキャンバス アプリを埋め込む
埋め込み型キャンバス アプリケーションをモデル駆動フォームに追加する
モデル駆動型フォームの埋め込み型キャンバス アプリケーションを編集する
モデル駆動フォームに埋め込まれたキャンバス アプリケーションの画面サイズと表示方向をカスタマイズする
組み込みキャンバス アプリ内からホスト フォームで事前定義済みの操作を実行する
ModelDrivenFormIntegrationコントロールのプロパティとアクション
埋め込みキャンバス アプリの共有
埋め込みキャンバス アプリの作業のガイドライン
パブリック プレビュー リリースを使用して作成された、モデル駆動型フォームの埋込み型キャンバスアプリケーションを最新版へと移行する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。