2026年12月13日 kintone API アップデート情報
2026年12月13日に実施するメンテナンスにおける、kintone APIのアップデート内容は次のとおりです。
kintone JavaScript API
APIラボで公開していたテーブルフィールドのAPIを、「リリース予定の新機能の先行利用」で提供します
以前APIラボで公開した次のアップデートの機能が、アップデートオプションの「リリース予定の新機能の先行利用」を通じた提供に変更されます。
また、これらの変更は今後、次のスケジュールでのリリースを予定しています。
- 2026年12月13日:「リリース予定の新機能の先行利用」を通じて提供します。
- 2027年2月の定期アップデート:正式リリースします。「新機能の無効化」による無効化が可能です。
2027年2月の正式リリース後は、アップデートオプションでAPIの利用設定を有効にしなくても、テーブルフィールドのAPIの変更が適用されます。
先行利用の期間に、テーブルフィールドを扱うカスタマイズの動作確認や改修ができます。
対象となる変更内容
テーブルフィールドのすべての行にIDが付与され、行のIDをもとに行の追加/更新/削除/並べ替えが判定されます
レコード追加画面とレコード編集画面で取得するレコードのデータのうち、テーブルフィールドに新しく追加された行のidとして一時的な値(仮ID)が返るように変わります。
従来は「null」が返っていました。
また、idが行の位置ではなく行のデータに結び付き、行を並べ替えても同じ行をidで指し示せます。
PC版とモバイル版の、レコード追加画面とレコード編集画面の次のAPIが対象です。
- イベントオブジェクトの
recordプロパティ-
レコード追加画面を表示したときのイベント
-
app.record.create.show、mobile.app.record.create.show -
レコード編集画面を表示したときのイベント
-
app.record.edit.show、mobile.app.record.edit.show -
レコード追加画面でフィールドの値を変更したときのイベント
-
app.record.create.change.フィールドコード、mobile.app.record.create.change.フィールドコード -
レコード編集画面でフィールドの値を変更したときのイベント
-
app.record.edit.change.フィールドコード、mobile.app.record.edit.change.フィールドコード -
レコード追加画面で保存するときのイベント
-
app.record.create.submit、mobile.app.record.create.submit -
レコード編集画面で保存するときのイベント
-
app.record.edit.submit、mobile.app.record.edit.submit
-
レコード追加画面を表示したときのイベント
-
- JavaScript API
-
レコードの値を取得する
-
kintone.app.record.get()、kintone.mobile.app.record.get() -
レコードに値をセットする
-
kintone.app.record.set()、kintone.mobile.app.record.set()
-
レコードの値を取得する
-
JavaScript APIによる行の操作で「フィールドの値を変更したときのイベント」が発生します
テーブルフィールドのフィールドコードを指定した「フィールドの値を変更したときのイベント」が、JavaScript APIで行を追加、削除、または並べ替えたときにも発生します。
合わせて、イベントオブジェクトのchangesプロパティに、操作の種類を表すtypeが追加されます。
テーブル内のフィールドのイベントは、行を並べ替えただけでは発生せず、値が変わったときにだけ発生します。
PC版とモバイル版の、レコード追加画面とレコード編集画面の次のイベントが対象です。
-
PC版
-
レコード追加画面でフィールドの値を変更したときのイベント
-
app.record.create.change.フィールドコード -
レコード編集画面でフィールドの値を変更したときのイベント
-
app.record.edit.change.フィールドコード
-
レコード追加画面でフィールドの値を変更したときのイベント
-
-
モバイル版
-
レコード追加画面でフィールドの値を変更したときのイベント
-
mobile.app.record.create.change.フィールドコード -
レコード編集画面でフィールドの値を変更したときのイベント
-
mobile.app.record.edit.change.フィールドコード
-
レコード追加画面でフィールドの値を変更したときのイベント
-
追加されるプロパティは次のとおりです。
| プロパティ | 型 | 説明 |
|---|---|---|
| changes.type | 文字列 | 操作の種類 次のいずれかの値が返ります。
|
テーブルフィールドにカスタマイズ列を作成するJavaScript APIが追加されます
指定したテーブルフィールドに、ボタンを表示するカスタマイズ列を作成できます。
作成したカスタマイズ列は、行の追加、削除、並べ替えに追従します。
次のAPIが対象です。
-
PC版
-
テーブルフィールドにカスタマイズ列を作成する
-
kintone.app.record.createCustomTableColumn()
-
テーブルフィールドにカスタマイズ列を作成する
-
-
モバイル版
-
テーブルフィールドにカスタマイズ列を作成する
-
kintone.mobile.app.record.createCustomTableColumn()
-
テーブルフィールドにカスタマイズ列を作成する
-
テーブルフィールドのスタイルを設定/取得するJavaScript APIが追加されます
テーブルフィールドのヘッダーと各行のセルにスタイルを設定できます。
設定したスタイルは、取得用のAPIで確認できます。
次のAPIが対象です。
-
PC版
-
テーブルフィールドにスタイルを設定する
-
kintone.app.record.setTableFieldStyle() -
テーブルフィールドに設定されているスタイルを取得する
-
kintone.app.record.getTableFieldStyle()
-
テーブルフィールドにスタイルを設定する
-
-
モバイル版
-
テーブルフィールドにスタイルを設定する
-
kintone.mobile.app.record.setTableFieldStyle() -
テーブルフィールドに設定されているスタイルを取得する
-
kintone.mobile.app.record.getTableFieldStyle()
-
テーブルフィールドにスタイルを設定する
-
先行利用する場合に必要な設定
kintoneシステム管理のアップデートオプション画面で、「リリース予定の新機能の先行利用」の次のオプションを選択します。
- 「JavaScript API:テーブルの行へのID付与、テーブル操作時のイベント発生、およびテーブル操作用APIを追加する機能」を有効にする
設定方法は、
新機能の有効/無効の切り替え手順
を参照してください。
関連ページ
より詳細な情報は、次のページを参照してください。
- JavaScript APIでのテーブルフィールドの行のIDおよび更新処理の仕様変更
- テーブルフィールドにカスタマイズ列を作成する
- テーブルフィールドにスタイルを設定する
- テーブルフィールドに設定されているスタイルを取得する
製品のアップデート情報
API以外のkintoneのアップデートに関する情報は、kintoneアップデート情報サイトを参照してください。
kintone アップデート情報
12月定期メンテナンス分は後日公開されます。
補足
kintone APIの更新情報は、Xでお知らせしています。
@kintonedevjp
をフォローし、最新情報をチェックしましょう。
