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

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

目次

イベントタイプ イベントが発生するタイミング
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 オブジェクト 値を変更したテーブルの行データ
caution
警告

検討中の新機能を有効にしている場合、テーブルフィールドのイベントでは次の点が変わります。

  • changesに、操作の種類を表すtypeプロパティが追加されます。
  • JavaScript APIでテーブルを書き換えたときのchanges.rowは「null」になります。

詳細は、次のページを参照してください。
JavaScript APIでのテーブルフィールドの行のIDおよび更新処理の仕様変更

イベントオブジェクトで実行できる操作

フィールドコードに指定可能なフィールド

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

  • ラジオボタン
  • ドロップダウン
  • チェックボックス
  • 複数選択
  • ユーザー選択
  • 組織選択
  • グループ選択
  • 日付
  • 時刻
  • 日時
  • 文字列1行 *1
  • 数値 *2
  • テーブル *3
  • ルックアップ *4
caution
警告

検討中の新機能を有効にしている場合、テーブルに関するイベントが発生するタイミングは次のように変わります。

  • テーブルフィールドのイベントは、JavaScript APIで行を追加、削除、または並べ替えたときにも発生します。
  • テーブル内のフィールドのイベントは、そのフィールドの値が変わったときにだけ発生します。

詳細は、次のページを参照してください。
JavaScript APIでのテーブルフィールドの行のIDおよび更新処理の仕様変更

*1

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

  • コントロールからフォーカスが外れたとき
  • ルックアップで値がコピーされたとき
  • PC版の場合は自動計算が反映されたとき
^

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

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

*4

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

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

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

^

制限事項

  • フィールドコードには、存在するフィールドコードかつフィールドコードに指定可能なフィールドを指定したときだけ、イベントハンドラーが実行されます。
    フィールドコードに指定可能なフィールド
    存在しないフィールドコードや、フィールドコードに指定できないフィールドを指定した場合は、何も発生しません。
  • 添付ファイルフィールドの情報は取得できません。

公式コミュニティ

kintone開発者同士で質問や知見を共有し、学び合うことができます。