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