フォーム OnLoad イベント
このイベントは、フォームが読み込まれるたびに発生します。具体的には、次のとおりです。
- 最初のページ読み込み時
- 新しいレコードの初回保存 (作成) 後
このイベントのイベント ハンドラーを管理するには、formContext.ui.addOnLoad メソッドとformContext.ui.removeOnLoad メソッドを使用します。
注意
フォームの OnLoad イベントが発生したときに、フォーム内のコントロールが準備ができていない可能性があります。 コントロールの OnLoad イベントを使用して、準備ができるまで待機します。 詳細情報: UIを使用してイベントにイベント ハンドラー関数を追加または削除する
非同期 OnLoad イベント ハンドラーのサポート
イベント ハンドラーには、イベントを非同期 ("async") にできるフォームをロードする前に、イベント ハンドラーによって返されたプロミスが確定するのを待機する機能があります。 OnLoad OnLoad イベント ハンドラーがpromiseを返すと、 OnLoad イベントは非同期になります。
イベント ハンドラーから返された各プロミスが解決されると、フォームが読み込まれます。 返されたプロミスについては、それぞれ 10 秒の制限があります。 その後、プラットフォームは、プロミスがタイムアウトしたとみなします。このタイムアウトはプロミスごとに適用されます。 たとえば、5 つのプロミスが返された場合、合計待機時間は 50 秒です。 たとえばプロミスが拒否されたり、タイムアウトした場合、フォームの読み込み操作は、現在のスクリプトのエラーと同様の動作をします。
OnLoad イベントは、ハンドラーごとに返される1つのプロミスを待機します。 複数のPromiseが必要な場合は、 Promise.all() メソッド内のすべてのPromiseを ラップ し、結果として得られる単一のPromiseを返すことをお勧めします。 プロミスを返す複数のハンドラーについては、すべてのイベントを呼び出し、必要なすべてのプロミスをラップした単一のプロミスを返す 1 つのハンドラを作成することをお勧めします。 これは、タイムアウトによる待機時間を最小限に抑えるためです。
アプリの設定で非同期 OnLoad を有効にする
非同期 onLoad ハンドラーを使用するには、アプリの設定で有効にする必要があります。 アプリ設定とは、プラットフォームのコンポーネントで、アプリでサポートされている機能をオン/オフにすることができます。 特定のアプリのために非同期 Onload イベント ハンドラーを有効にする方法:
https://make.powerapps.com に移動します。
それが正しい環境を選択していることを確認します。
左側のナビゲーション ウィンドウから、アプリを選択します。
アプリを 選択 し、次に 選択 ... (省略記号) を実行します。 編集 を選択します。
選択 設定 をコマンド バーで選択します。
ダイアログが開いたら、選択 機能 を選択します。
非同期オンロード ハンドラーをオンにします。
保存 を選びます。
非同期 OnLoad タイムアウト
非同期ハンドラーを使用した場合、フォームのロードは、プロミスの履行を待機しますが、最大で 10 秒までです。 この制限により、フォームが適切な時間内に読み込まれることが保証されます。