グリッドの OnSave イベント (クライアント API 参照)
OnSave
イベントは、更新された情報がサーバーにを送信される前、および次のいずれかが起こると発生します。
- レコードの選択で変更がある。
- ユーザーが編集可能なグリッドの保存ボタンを使用して、保存操作を明示的にトリガーする。
- 保留中の変更がある間に編集可能なグリッドから、ユーザーが並べ替え、フィルター、グループ化、改ページ、ナビゲーション操作を適用する。
OnSave
イベントに関して考慮する必要がある重要な点がいくつかあります。
- ユーザーが、同じレコードの複数列を順番に編集する場合は、最適なパフォーマンスとフォーム動作の互換性を保つため、
OnSave
イベントが一度だけ実行されます。 - 編集可能なグリッドと親フォームには、個別の保存ボタンがあります。 一方の保存ボタンを選択しても、もう一方の変更は保存されません。
- ナビゲーション操作がコンテキスト外で実行されている場合、編集可能なグリッドでは保留中の変更は保存されません。 コントロールに保存されていないデータがある場合、そのデータが失われる可能性があります。 そのため、イベント
OnSave
発生しない可能性があります。 たとえば、OnSave
イベントは、フォームのルックアップ列を使用して、あるいはリボンを介して別のレコードに移動するときに発生する可能性があります。 - 編集可能なグリッドで更新ボタンを選択すると、保留中の変更は破棄され、
OnSave
イベントは発生しません。 - 編集可能なグリッドのコントロールは自動保存タイマーを実装していません。 編集可能なグリッドは、重複データ検出ルールを非表示にします。
ヒント
予定、定期的な予定、またはサービス活動レコードの OnSave
イベントは、保存操作を取り消し、Create
または Update
ではなく Book
メッセージを使用して変更を永続化します。 このため、これらのテーブルの OnSave
および PostSave
イベント ハンドラーは機能しません。
関連記事
フォーム OnSave イベント
イベント (クライアント API 参照)
モデル駆動型アプリのフォームとグリッド内のイベント