レコード追加画面でフィールドの値を変更したときのイベント

固定リンクがコピーされました

レコード追加画面または再利用画面で、フィールドの値を変更したときに発生するイベントです。

	イベントタイプ	イベントが発生するタイミング
PC	app.record.create.change.`フィールドコード`	レコード追加画面または再利用画面で、`フィールドコード`に指定したフィールドの値を変更したときアプリアクションを実行し、コピー先のアプリのレコード追加画面で、`フィールドコード`に指定したフィールドの値を変更したとき次のAPI使って、`フィールドコード`に指定したフィールドの値を書き換えたときレコードに値をセットするイベントオブジェクトで実行できる操作
モバイル	mobile.app.record.create.change.`フィールドコード`	レコード追加画面または再利用画面で、`フィールドコード`に指定したフィールドの値を変更したときアプリアクションを実行し、コピー先のアプリのレコード追加画面で、`フィールドコード`に指定したフィールドの値を変更したとき次のAPI使って、`フィールドコード`に指定したフィールドの値を書き換えたときレコードに値をセットするイベントオブジェクトで実行できる操作

固定リンクがコピーされました

プロパティ名	型	説明
type	文字列	イベントタイプ次の値が返ります。 PC：`app.record.create.change.フィールドコード` モバイル：`mobile.app.record.create.change.フィールドコード`
appId	数値	アプリID
record	オブジェクト	値を変更した後のレコードのデータ詳細は次のページを参照してください。フィールド形式
changes	オブジェクト	変更したフィールドとサブテーブルの行データ
changes.field	オブジェクト	値を変更したフィールドのデータ
changes.row	オブジェクト	値を変更したテーブルの行データ

固定リンクがコピーされました

固定リンクがコピーされました

フィールドコードに指定できるフィールドは次のとおりです。

ルックアップフィールドへの対応は、開発を検討中の機能です。

利用するには、アップデートオプションの「検討中の新機能」から、「ルックアップフィールドで『フィールドの値を変更したときのイベント』が発生する機能」を有効にしてください。
設定方法は、kintoneヘルプの新機能の有効／無効の切り替え手順を参照してください。

^*1

次のいずれかのタイミングで、イベントが発生します。

^*2 コントロールからフォーカスが外れた、またはルックアップで値がコピーされたときに、イベントが発生します。 ^

^*3 テーブルの行を追加するボタンや削除するボタンをクリックしたときに、イベントが発生します。 ^

^*4

次のいずれかのタイミングで、イベントが発生します。ただし、ルックアップフィールドに入力している検索用のキーワードを変更した場合か、ルックアップで選択した参照先のレコードが変更されている場合だけ発生します。

ルックアップフィールドで【取得】ボタンをクリックして参照するレコードを確定したとき（一致するレコードが1つで自動取得された場合と、複数の候補からダイアログで選択した場合の両方を含みます）
ルックアップフィールドをクリアしたとき
ルックアップフィールドからフォーカスが外れたとき

ルックアップフィールドの値を変更したときのイベントは、コピー先フィールドの値を変更したときのイベントより先に発生します。

固定リンクがコピーされました

フィールドコードには、存在するフィールドコードかつフィールドコードに指定可能なフィールドを指定したときだけ、イベントハンドラーが実行されます。
フィールドコードに指定可能なフィールド
存在しないフィールドコードや、フィールドコードに指定できないフィールドを指定した場合は、何も発生しません。
「検討中の新機能」を有効にしていない場合、ルックアップフィールドのフィールドコードをイベント名に指定しても、イベントは発生しません。
この場合に、ルックアップによる値の変更を使ってイベントハンドラーを実行したいときは、ルックアップで値をコピーするフィールドコードをイベント名に指定してください。
添付ファイルフィールドの情報は取得できません。

kintone API