フォーム 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 イベント ハンドラーを有効にする方法:

1. https://make.powerapps.com に移動します。

2. それが正しい環境を選択していることを確認します。

3. 左側のナビゲーション ウィンドウから、アプリ を選択します。

4. アプリを選択し、... (省略記号) を選択します。 編集 を選択します。

5. コマンド バーで、設定 を選択します。

6. ダイアログが開いたら、機能 を選択します。

7. 非同期 onload ハンドラーを有効化します。

8. 保存 を選びます。

   

非同期 OnLoad タイムアウト

非同期ハンドラーを使用した場合、フォームのロードは、プロミスの履行を待機しますが、最大で 10 秒までです。 この制限により、フォームが適切な時間内に読み込まれることが保証されます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。