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