埋め込みキャンバス アプリ内からホスト モデル駆動型フォームに対して定義済みのアクションを実行する

埋め込みキャンバス アプリは、ホスト モデル駆動型フォームで定義済みのアクションを実行する機能を提供します。 これらのアクションにより、作成者はホスト モデル駆動型フォームを移動、更新、保存できます。 埋め込まれたキャンバス アプリは、これらのアクションを使用して、モデル駆動型フォームとモデル駆動型アプリのより不可欠な部分として機能できます。

ModelDrivenFormIntegration オブジェクトには、作成者がホスト モデル駆動型フォームでアクションを実行できるようにするための次の新しいメソッドが含まれています。

Important

ModelDrivenFormIntegration コントロールと対話できるようにするには、クラシック フォーム デザイナーを使用して、モデル駆動型フォームのキャンバス アプリ コントロール プロパティで [カスタマイズ] を選択してキャンバス アプリを作成する必要があります。 詳細情報: クラシック エクスペリエンスを使用してキャンバス アプリを埋め込む

ホストモデル駆動型フォームからメインフォームに移動し、指定した行を表示します。

  • entityName - メイン フォームの親テーブルを指定する必須の文字列パラメーター。
  • formName - 移動するメイン フォームの名前を指定する必須の文字列パラメーター。
  • recordId - メイン フォームに表示する行の ID を指定する必須の文字列パラメーター。

NavigateToMainForm メソッドを呼び出すと、次のエラー メッセージが返されることがあります。

エラーメッセージ トラブルシューティング ガイダンス
テーブルが見つかりません: [EntityName] entityName パラメーターの値を確認し、それが有効なテーブル名であり、ユーザーがアクセスできることを確認してください。
フォームが見つかりません: [FormName] mainFormName パラメーターの値を確認し、それが有効なメイン フォーム名であり、ユーザーがアクセスできることを確認してください。
行の読み込みに問題が発生しました。 recordId パラメーターの値を確認し、それが有効な行 ID であり、ユーザーがアクセスできることを確認してください。

ホストモデル駆動型フォームをビューに移動します。

  • entityName - ビューの親テーブルを指定する必須の文字列パラメーター。
  • viewName - 移動するメイン フォームの名前を指定する必須の文字列パラメーター。

NavigateToView メソッドを呼び出すと、次のエラー メッセージが返されることがあります。

エラーメッセージ トラブルシューティング ガイダンス
テーブルが見つかりません: [EntityName] entityName パラメーターの値を確認し、それが有効なテーブル名であり、ユーザーがアクセスできることを確認してください。
ビューが見つかりません: [ViewName] viewName パラメーターの値を確認し、それが有効なビュー名であり、ユーザーがアクセスできることを確認してください。

OpenQuickCreateForm(entityName)

テーブルの既定の簡易作成フォームを開きます。

  • entityName - 簡易作成フォームの親テーブルを指定する必須の文字列パラメーター。

OpenQuickCreateForm メソッドを呼び出すと、次のエラー メッセージが返されることがあります。

エラーメッセージ トラブルシューティング ガイダンス
テーブルが見つかりません: [EntityName] entityName パラメーターの値を確認し、それが有効なテーブル名であり、ユーザーがアクセスできることを確認してください。

RefreshForm(showPrompt)

ホストのモデル駆動型フォームのデータを更新します。

  • showPrompt - ホスト モデル駆動型フォームに保存されていないデータを保存する前に、確認プロンプトをユーザーに表示するかどうかを示す必須のブール値パラメーター。 値は "true" または "false" にする必要があります。

RefreshForm メソッドを呼び出すと、次のエラー メッセージが返されることがあります。

エラーメッセージ トラブルシューティング ガイダンス
パラメーター値として "true" または "false" を使用してください。 showPrompt パラメーターの値を確認し、"true" または "false" であることを確認してください。

SaveForm()

ホストモデル駆動型フォームにデータを保存します。

注

機能が使用可能になる前に作成された埋め込みキャンバス アプリで定義済みのアクションを実行するメソッドの IntelliSense が観察されない場合。アプリを保存、閉じて、再度開きます。

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