レコード追加画面でフィールドの値を変更したときのイベント
レコード追加画面でフィールドの値を変更したときのイベント
レコード追加画面または再利用画面で、フィールドの値を変更したときに発生するイベントです。
- トリガーとなった値の変更はキャンセルされません。
| イベントタイプ | イベントが発生するタイミング | |
|---|---|---|
| PC | app.record.create.change.フィールドコード |
|
| モバイル | mobile.app.record.create.change.フィールドコード |
|
イベントオブジェクトのプロパティ
| プロパティ名 | 型 | 説明 |
|---|---|---|
| type | 文字列 | イベントタイプ 次の値が返ります。
|
| appId | 数値 | アプリ ID |
| record | オブジェクト | 値を変更した後のレコードのデータ 詳細は フィールド形式 を参照してください。 |
| changes | オブジェクト | 変更したフィールドとサブテーブルの行データ |
| changes.field | オブジェクト | 値を変更したフィールドのデータ |
| changes.row | オブジェクト | 値を変更したテーブルの行データ |
イベントオブジェクトで実行できる操作
- フィールドの値を書き換える
- フィールドの編集可／不可を設定する
- フィールドにエラーを表示する
- 画面上部にエラーを表示する
- ルックアップを自動取得する
- ルックアップのコピー先のフィールドの値を自動でクリアする
- 値を変更したフィールドやテーブル行のフィールドデータを取得する
フィールドコードに指定可能なフィールド
フィールドコードに指定できるフィールドは次のとおりです。
*1
次のいずれかのタイミングで、イベントが発生します。
- コントロールからフォーカスが外れたとき
- ルックアップで値がコピーされたとき
- PC 版の場合は自動計算が反映されたとき
*2 コントロールからフォーカスが外れた、またはルックアップで値がコピーされたときに、イベントが発生します。 ^
*3 テーブルの行を追加するボタンや削除するボタンをクリックしたときに、イベントが発生します。 ^
制限事項
- フィールドコードには、存在するフィールドコードかつ
フィールドコードに指定可能なフィールド を指定したときだけ、イベントハンドラーが実行されます。
存在しないフィールドコードや、フィールドコードに指定できないフィールドを指定した場合は、何も発生しません。 - 添付ファイルフィールドの情報は取得できません。