モデル駆動型フォームに埋め込まれたキャンバス アプリケーションには、 ModelDrivenFormIntegration という名前の特別なコントロールが含まれています。 このコントロールは、ホストのモデル駆動型フォームから埋め込みキャンバス アプリにコンテキスト データを取り込みます。
Important
ModelDrivenFormIntegration コントロールと対話できるようにするには、クラシック フォーム デザイナーを使用して、モデル駆動型フォームのキャンバス アプリ コントロール プロパティで [カスタマイズ] を選択してキャンバス アプリを作成する必要があります。 詳細情報: クラシック エクスペリエンスを使用してキャンバス アプリを埋め込む
この記事では、 ModelDrivenFormIntegration コントロールで使用できるプロパティとアクションについて説明します。 このコントロールは、クラシック フォーム デザイナーの Canvas アプリ コントロール プロパティ UI を使用してキャンバス アプリを作成するときに、Power Apps Studio でカスタマイズできます。
mod
| プロパティまたは操作 | Description |
|---|---|
| DataSource | ホスト モデル駆動型フォームの親テーブルに接続されたデータ ソースに設定する必要があります。 新しいのキャンバス アプリを埋め込む ときに自動的に設定されます 。 既存のキャンバス アプリを埋め込む場合、ModelDrivenFormIntegration データ ソースをキャンバス アプリのツリー ビューから構成できます。 DataSource の値は、常にアプリが埋め込まれているテーブルを参照する必要があります。 値はいかなる方法でも、フィルター処理したり変更したりしないでください。 |
| アイテム | 埋め込みキャンバス アプリがホスト モデル駆動型フォームから行にアクセスできるようにする読み取り専用プロパティ。 たとえば、accountnumber という名称と アカウント番号 という表示名称を持つ列の値を取得するには、ModelDrivenFormIntegration.Item.accountnumber または ModelDrivenFormIntegration.Item.'Account Number' を使用することができます。 |
| OnDataRefresh | このプロパティの計算式は、ホスト モデル駆動型フォームがデータを保存する際に評価されます。 これを使用して、ホストのモデル駆動型フォームの親テーブルに接続されているデータ ソースを更新したり、変数の設定や更新などのほかの操作を実行します。 たとえば、これを以下の計算式に設定すると、アカウントのデータ ソースが更新され、CurrentAccountNumber という変数に現在の行の取引先企業番号列の値が設定されます。 更新 (アカウント); 設定 (CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number') OnDataRefresh アクションは、埋め込みキャンバス アプリ内のデータを更新するためにのみ使用する必要があります。 OnDataRefresh アクションを使用して、埋め込みキャンバス アプリ内で変更を保存することはお勧めしません。 詳細: 埋め込みキャンバス アプリでデータを保存する |
| RefreshForm | ホストのモデル駆動型フォームのデータを更新します。 詳細については ホスト フォームでの定義済みのアクションの実行 を参照してください。 |
| SaveForm | ホストモデル駆動型フォームにデータを保存します。 詳細については ホスト フォームでの定義済みのアクションの実行 を参照してください。 |
| NavigateToMainForm | ホストモデル駆動型フォームからメインフォームに移動し、指定した行を表示します。 詳細については ホスト フォームでの定義済みのアクションの実行 を参照してください。 |
| NavigateToView | ホストモデル駆動型フォームをビューに移動します。 詳細については ホスト フォームでの定義済みのアクションの実行 を参照してください。 |
| OpenQuickCreateForm | テーブルの既定のクイック作成フォームを開きます。 詳細については ホスト フォームでの定義済みのアクションの実行 を参照してください。 |
| データ | ホスト のモデル駆動型フォームから埋め込みキャンバス アプリに重要なデータを送信するためにフレームワークによって使用される読み取り専用使用するプロパティ。 このプロパティは使用しないでください。 ホストのモデル駆動型フォームから行にアクセスできるアイテムを使用します。 |
ModelDrivenFormIntegration コントロール データは、アプリの起動時に使用できません
ModelDrivenFormIntegration.Item プロパティは、アプリの起動時にデータが設定されるとは限りません。 アプリは、 !IsBlank(ModelDrivenFormIntegration.Item)などの式を使用してこのデータを待機するように設計する必要があります。または、アプリは、 LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId))などの式を使用してレコードを明示的に取得する必要があります。
関連項目
モデル駆動型フォームにキャンバス アプリを埋め込む
埋め込み型キャンバス アプリケーションをモデル駆動フォームに追加する
組み込みキャンバス アプリ内からホスト フォームで事前定義済みの操作を実行する
埋め込みキャンバス アプリの共有
埋め込みキャンバス アプリの作業のガイドライン