関連付けられたレコードのリストをデータコンテキストとして埋め込みキャンバスアプリと共に渡す - Power Apps

[アーティクル]
03/09/2022

重要

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

概要

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

処置

埋め込みキャンバスアプリを取引先企業のメインフォーム上に追加して、現在の取引先企業レコードに関連付けられた取引先担当者のリストを埋め込みキャンバスアプリに渡すとしましょう。これを行うには、次の手順を実行します。

Power Apps にサインインして、取引先企業テーブルなどのテーブルのメインフォームのためにフォームエディターを開きます。
埋め込みキャンバスアプリを表示するフォーム上のセクションを選択します。
選択したセクションの、挿入タブの、コントロール グループで、サブグリッド を選択します。
プロパティの設定 ダイアログボックスで、表示タブを選択してから、名前ボックスにグリッドコントロールの名前を入力します。
データソース セクションで、データコンテキストとして埋め込みキャンバスアプリに渡すレコードのリストに対応する テーブル および 既定のビュー を選択します。
コントロール タブを選択してから、コントロールの追加... を選択します
コントロールの追加 ダイアログボックスの、使用可能なコントロールの一覧で、キャンバスアプリ を選択してから追加を選択します。
プロパティの設定 ダイアログボックスの、コントロールのリストで キャンバスアプリ を選択してから Web オプションを選択します。
コントロールリストの下部のセクションに、キャンバスアプリコントロールに対応するプロパティのリストを確認して、以下の内容に注意します。
- テーブル名 プロパティは、埋め込みキャンバスアプリにデータを提供するテーブルを指定します。これは以前選択したテーブルに設定されます。
  - このプロパティが変更可能として表示される場合であっても、それに対する変更は埋め込みキャンバスアプリ上に影響を与えません。それは参照することのみを目的としています。
- ビュー名 プロパティは、埋め込みキャンバスアプリに提供されるデータのフィルター処理に使用されるテーブルのビューを指定します。これは以前選択した 既定のビュー に設定されます。
  - 実行時に埋め込みキャンバスアプリに送信されるデータ (フィールドおよび値) はこのビューにより決定されます。ビューに含まれる、または必要に応じてビューに追加されるキャンバスアプリ内の列のみを使用します。ビューに含まれていない列すべてには、実行時に空の値として表示されます。
  - ビューのフィルター条件は、作成時には使用されません。そのため、埋め込みキャンバスアプリを作成するときに表示されるデータはフィルター処理されず、単にアクセス対象の上部にある少数のレコードのリストとなります。実行時、ビューのフィルター条件は想定どおりに適用され、ユーザーに対して関連データのみが表示されます。
- アプリ ID プロパティは埋め込みキャンバスアプリの ID を指定します。これはキャンバスアプリが作成されるときに自動的に生成および入力されます。
  - アプリ ID の値を変更すると、モデル駆動型フォームから埋め込みキャンバスアプリへのリンクが切断されることに注意してください。
キャンバスアプリを作成または編集するには カスタマイズ ボタンを選択します。これにより新規ブラウザタブに Power Apps Studio が開きます。
重要
- カスタマイズ オプションは現在、従来のフォームデザイナーを使用した場合にのみ使用できます。
- Power Apps Studio が Web ブラウザーのポップアップブロッカーにより開くことがブロックされた場合は、make.powerapps.com サイトを有効にするか、一時的にポップアップブロッカーを無効にしてから、再び カスタマイズ を選択する必要があります。
Power Apps Studio で、左のウィンドウに配置された ModelDrivenFormIntegration コントロールがあることに注意してください。このコントロールは、ホストのモデル駆動型フォームから埋め込みキャンバスアプリにコンテキストデータを取り込みます。
Gallery1 コントロールを選択して、アイテム プロパティに ModelDrivenFormIntegration.Data がセットされていることを確認します。
右側のプロパティペインで、列の隣にある編集を選択します。
データウィンドウで、Title1 コントロールにマッピングされた列を氏名に変更、またはデータを持つ他の列に変更します。
ギャラリーに、ホストのモデル駆動型フォームから ModelDrivenFormIntegration コントロールを介して渡されるデータが表示されることを確認します。データウィンドウを閉じます。
ファイル タブ、設定の順に選択します。
試験的な機能 セクションの 近日公開の機能 タブで、埋め込みの外観の最適化 をオンに設定します。
全般タブを選択します。アプリに一意の名前を指定し、保存を選択します。以下に注意します。
- アプリを初めて保存するときは、アプリが自動的に公開されます。
- それ以降の保存時には、公開を選択してから このバージョンを公開 を選択し、変更を有効にします。
設定ダイアログを閉じます。
戻るを選択してから、フォームエディターを開いたブラウザータブを選択します。
キャンバスアプリ コントロールの アプリ ID プロパティに値が自動的に入力されたことを確認します。以下に注意します。
- フォームエディターには前のステップで他のブラウザータブで開いた Power Apps Studio とのダイレクトリンクがあります。
- フォームエディターは送信されるアプリ ID をリスニングしていました。
- アプリが保存されたときにアプリ ID が送信されました。
プロパティの設定 ダイアログボックスで、表示タブを選択して、フォームでラベルを表示する をクリアしてから、OK を選択します。
- このフォームに埋め込まれたキャンバスアプリが既にある場合は、"1 つのフォームで 1 つのキャンバスアプリのみを有効にすることができます。" というメッセージが表示されます。" 新しいキャンバスアプリを追加するには、まず現在の埋め込みキャンバスアプリを無効化する必要があります。次に、新しい埋め込みキャンバスアプリを有効化します。
ホーム タブで、保存を選択してから、公開を選択します。

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

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

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

概要

処置

関連項目

フィードバック

関連付けられたレコードのリストをデータ コンテキストとして埋め込みキャンバス アプリに渡す

概要

処置

関連項目

フィードバック

関連付けられたレコードのリストをデータコンテキストとして埋め込みキャンバスアプリに渡す