台帳屋kintone管理者向けプラグイン 30日間無料で試す

kintoneでフィールドを削除・変更する前に、使われている場所を調べる方法

2026年11月5日

使っていないように見えるフィールドを消したい。フィールドコードを分かりやすく直したい。
そのとき気になるのが、「このフィールドは、どこで使われているのか」です。

このページでは、フィールドが使われうる場所と、調べ方をまとめます。

フィールドを削除できないとき

kintoneでは、次の設定で使われているフィールドは、削除しようとするとエラーになります。

  • ほかのアプリのルックアップから参照されている
  • ほかのアプリの関連レコード一覧から参照されている
  • プロセス管理の作業者の指定に使われている

エラーの画面には、どのアプリのどのフィールドが参照しているかまでは出ません。
参照しているアプリは、アプリの設定の「設定」タブ →「運用管理」→「このアプリを参照しているアプリ」で分かります(2026年4月から)。そのあと、相手のアプリのフォームを開いて、ルックアップや関連レコード一覧の設定を1つずつ確かめます。

フィールドが使われうる場所

場所確かめる画面
計算式フォーム:計算フィールドと、自動計算を使う文字列(1行)フィールド
ルックアップ・関連レコード一覧フォーム:このアプリと、ほかのアプリの両方(キー、コピーするフィールド、絞り込みや並び順)
一覧・グラフ一覧の表示項目・絞り込み・並び順、グラフの分類・集計・絞り込み
アクセス権レコードのアクセス権の条件、フィールドのアクセス権、ユーザー選択などのフィールドで指定した人
プロセス管理ステータスの作業者、アクションの条件
通知レコードの条件通知・リマインダーの条件通知の条件と日時、フィールドで指定した通知先
アプリアクションこのアプリから、またはほかのアプリから、値をコピーするフィールド
そのほかレコードのタイトル、JavaScriptのカスタマイズ、プラグインの設定

フィールドコードを変えるときの注意

フィールドコードを変えると、計算式の中のフィールドコードは自動で変わります(計算式が正しくない場合を除く)。
一方で、JavaScriptのカスタマイズやプラグインの設定の中に書かれたフィールドコードは変わりません。そのままだと、カスタマイズが動かなくなることがあります。

REST APIや外部のサービスとつないでいる場合も、フィールドコードを使っていることが多いので、あわせて確かめてください。

REST APIで調べる

上の設定は、kintoneのREST APIで取得できます(そのアプリの管理権限が必要です)。

  • フォーム:/k/v1/app/form/fields.json(計算式、ルックアップ、関連レコード一覧)
  • 一覧・グラフ:/k/v1/app/views.json・/k/v1/app/reports.json
  • アクセス権・プロセス管理・通知:/k/v1/record/acl.json・/k/v1/field/acl.json・/k/v1/app/status.json・/k/v1/app/notifications/perRecord.json・reminder.json
  • アクション・タイトル:/k/v1/app/actions.json・/k/v1/app/settings.json

条件の文字列(例:金額 >= 1000000)の中では、フィールドコードが名前のまま出てきます。似た名前のフィールド(「金額」と「金額税込」など)を取り違えないように気をつけてください。
ほかのアプリからの参照は、すべてのアプリのフォームとアクションを取得して、参照先がこのアプリになっているものを探します。

プラグインで調べる

台帳屋のフィールド影響チェッカー(無料)は、上のAPIを使って、選んだフィールドが使われている場所を一覧にするプラグインです。
ほかのアプリのルックアップ・関連レコード一覧・アクションも調べ、使われている間は削除できない設定に★を付けます。JavaScriptのカスタマイズの中も探せます。

フィールド影響チェッカーの画面。レコード番号が使われている場所が一覧になり、ほかのアプリのルックアップのキーに★が付いている
見本のアプリで調べた例

すべてのアプリのフィールドをまとめて調べるなら、有料版の棚卸し・変更監視パックの「フィールドの使われ方」のシートが使えます。ほかのアプリから使われているフィールドと、設定のどこにも出てこないフィールドが、1つのExcelにまとまります(30日間の無料試用があります)。

参考