レコード編集画面でフィールドの値を変更したときのイベント
固定リンクがコピーされました
レコード編集画面で、フィールドの値を変更したときに発生するイベントです。
| イベントタイプ | イベントが発生するタイミング | |
|---|---|---|
| PC | app.record.edit.change.フィールドコード
|
|
| モバイル | mobile.app.record.edit.change.フィールドコード
|
|
イベントオブジェクトのプロパティ
固定リンクがコピーされました
| プロパティ名 | 型 | 説明 |
|---|---|---|
| type | 文字列 | イベントタイプ 次の値が返ります。
|
| appId | 数値 | アプリID |
| record | オブジェクト | フィールドの値を変更した後のレコードのデータ 詳細は次のページを参照してください。 フィールド形式 |
| recordId | 数値 | レコードID |
| changes | オブジェクト | 変更したフィールドとサブテーブルの行データ |
| changes.field | オブジェクト | 値を変更したフィールドのデータ |
| changes.row | オブジェクト | 値を変更したテーブルの行データ
|
イベントオブジェクトで実行できる操作
固定リンクがコピーされました
- フィールドの値を書き換える
- フィールドの編集可／不可を設定する
- フィールドにエラーを表示する
- 画面上部にエラーを表示する
- ルックアップを自動取得する
- ルックアップのコピー先のフィールドの値を自動でクリアする
- 値を変更したフィールドやテーブル行のフィールドデータを取得する
フィールドコードに指定可能なフィールド
固定リンクがコピーされました
フィールドコードに指定できるフィールドは次のとおりです。
警告
ルックアップフィールドへの対応は、開発を検討中の機能です。
利用するには、アップデートオプションの「検討中の新機能」から、「ルックアップフィールドで『フィールドの値を変更したときのイベント』が発生する機能」を有効にしてください。
設定方法は、kintoneヘルプの
新機能の有効／無効の切り替え手順
を参照してください。
*1
次のいずれかのタイミングで、イベントが発生します。
- コントロールからフォーカスが外れたとき
- ルックアップで値がコピーされたとき
- PC版の場合は自動計算が反映されたとき
*2 コントロールからフォーカスが外れた、またはルックアップで値がコピーされたときに、イベントが発生します。 ^
*3 テーブルの行を追加するボタンや削除するボタンをクリックしたときに、イベントが発生します。 ^
*4
次のいずれかのタイミングで、イベントが発生します。ただし、ルックアップフィールドに入力している検索用のキーワードを変更した場合か、ルックアップで選択した参照先のレコードが変更されている場合だけ発生します。
- ルックアップフィールドで【取得】をクリックして参照するレコードを確定したとき（一致するレコードが1つで自動取得された場合と、複数の候補からダイアログで選択した場合の両方を含みます）
- ルックアップフィールドをクリアしたとき
- ルックアップフィールドからフォーカスが外れたとき
ルックアップフィールドの値を変更したときのイベントは、コピー先フィールドの値を変更したときのイベントより先に発生します。
^制限事項
固定リンクがコピーされました
- フィールドコードには、存在するフィールドコード、かつフィールドコードに指定可能なフィールドを指定したときだけ、イベントハンドラーが実行されます。
フィールドコードに指定可能なフィールド
存在しないフィールドコードや、フィールドコードに指定できないフィールドを指定した場合は、何も発生しません。 - 「検討中の新機能」を有効にしていない場合、ルックアップフィールドのフィールドコードをイベント名に指定しても、イベントは発生しません。
この場合に、ルックアップによる値の変更を使ってイベントハンドラーを実行したいときは、ルックアップで値をコピーするフィールドコードをイベント名に指定してください。 - 添付ファイルフィールドの情報は取得できません。
