ルックアップフィールドで「フィールドの値を変更したときのイベント」が発生する

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

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

ルックアップフィールドで「フィールドの値を変更したときのイベント」が発生します。
また、kintone JavaScript APIやイベントで取得できるレコード情報のルックアップフィールドの値にルックアップの状態を表す値を追加します。

利用するには検討中の新機能の「ルックアップフィールドで『フィールドの値を変更したときのイベント』が発生する機能」を有効にしてください。

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

レコード追加／編集画面で、ルックアップフィールドの値を変更した時に次のイベントが発生します。

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

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

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

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

kintone JavaScript APIやイベントオブジェクトのプロパティで取得できるレコード情報に含まれるルックアップフィールドの値に、次の情報を追加します。

プロパティ	型	説明
confirmed	真偽値	参照先のレコードが確定しているかどうか参照先のレコードが確定しているとき、および【クリア】ボタンを押して参照するレコードをクリアしたときに`true`になります。
recordId	文字列	参照先のレコードのレコードID ルックアップフィールドに値が入力されていないとき、および入力済みでも参照先のレコードが未確定のときは「null」になります。

value、confirmed、recordIdは、その時点のルックアップフィールドの状態に応じた組み合わせになります。
組み合わせの例は次のとおりです。

ルックアップフィールドの状態	value	confirmed	recordId
「kintone」を入力し、参照先のレコードを取得済みのとき	"kintone"	true	"（レコードID）"
「kintone」を入力したが、まだ参照先のレコードを取得していないとき	"kintone"	false	null
未入力のとき（初期状態、またはクリアした後）	""	true	null

参照先のレコードを取得済みのときのオブジェクトの例は次のとおりです。

1
2
3
4
5
6


"フィールドコード": {
  "type": "SINGLE_LINE_TEXT",
  "value": "kintone",
  "confirmed": true,
  "recordId": "10"
}

kintone API