kintoneのルックアップ機能は非常に便利ですが、標準機能では「取得」ボタンを手動でクリックしなければデータが反映されません。
このひと手間が、大量のレコードを扱う現場では大きな入力工数となり、押し忘れによるデータの不整合を引き起こす原因となっています。
kintone開発の専門家であるAIzen株式会社の視点から断言すると、 ルックアップの自動取得は、現場の運用レベルや予算に合わせた最適な拡張ツールを選ぶことで、確実に解決可能な課題です。
本記事では、ルックアップが自動取得できない理由を仕組みから解説した上で、プラグイン・JavaScriptカスタマイズ・連携ツールの3つの手法を比較し、導入時の注意点まで網羅的にお伝えします。
kintoneのルックアップが自動取得できない理由とは
kintoneを導入して間もない現場のマネージャーから最も多く寄せられる不満の一つが、「なぜルックアップは毎回ボタンを押さなければならないのか」という点です。
この疑問を解消するために、まずは標準機能の仕様と、現場で実際に起きている問題の本質を整理します。
標準機能では「取得」ボタンの手動クリックが必須
kintoneのルックアップは、参照元のアプリからデータを「引っ張ってくる」プル型の動作を基本設計としています。
コピー元のフィールドとコピー先のフィールドを紐付けるだけでは不十分で、ユーザーが必ず「取得」ボタンをクリックするという操作をトリガーとして初めてデータが反映されます。
これは、意図しないデータの書き換えを防ぐためのkintoneの安全策としての仕様です。しかし、数百件・数千件の案件データを日常的に入力する現場においては、この1クリックの積み重ねが膨大なタイムロスを生み、入力担当者のストレスの原因になっています。
「取得の手間」と「マスタ更新の追従」は別の課題
kintoneのルックアップに関する悩みは、大きく2つのフェーズに分けて考える必要があります。
一つ目は、新規レコード作成時にルックアップの「取得」ボタンを毎回押さなければならないという「入力の手間」の問題です。
そしてもう一つが、参照元のマスタアプリの情報（例：顧客の社名や住所）が変更された際に、すでに作成済みのレコードに反映されたルックアップ値が古いまま残り続けてしまう「更新の追従」問題です。
多くのユーザーがこの2つを「ルックアップの自動取得」とひとまとめに語りがちですが、解決するためのアプローチは全く異なります。
前者は入力時のアクションを自動化する仕組み、後者はアプリ間のデータを同期させる仕組みが必要です。
ここからは、この2つの課題を明確に切り分けて、それぞれの解決策を解説していきます。
kintoneのルックアップを自動取得する3つの方法【比較表あり】
kintoneのルックアップ自動取得を実現するには、主に「プラグイン」「JavaScriptカスタマイズ」「ノーコード連携ツール」の3つの選択肢があります。それぞれにメリット・デメリットがあるため、自社の体制やスキルレベルに合った手法を選ぶことが重要です。以下の比較表で、各手法の特徴を整理しました。
| 手法 | 難易度 | コスト | 自由度 | おすすめの層 |
| プラグイン | 低（設定のみ） | 低〜中 | 中 | 手軽に早く導入したい現場 |
| JSカスタマイズ | 高（要開発） | 低（内製なら） | 高 | 独自の複雑な挙動が必要な場合 |
| 連携ツール | 中（設定学習） | 中〜高 | 高 | 他の自動化も併せて行いたい場合 |
プラグインで自動取得する（ノーコードで導入可能）
最も一般的かつ推奨されるのがプラグインの活用です。kintoneの管理画面からプラグインをインストールし、自動取得を適用したいルックアップフィールドを選択して設定するだけで導入が完了します。
プログラミングの知識が一切不要なため、現場マネージャーやkintone管理者が自ら設定・調整を行えるのが最大のメリットです。導入のハードルが低いにもかかわらず、レコードの新規追加・アクション機能によるコピー・レコード再利用時など、幅広い場面でルックアップの自動取得を実現できます。
JavaScriptカスタマイズで自動取得する（自由度が高い）
自社内にJavaScriptの知識を持つエンジニアがいる場合、または非常に特殊な条件（例：特定のプロセス管理のステータスに遷移したときだけ自動取得を発動させる等）を組み込みたい場合は、JavaScriptカスタマイズが有効です。
kintone JavaScript APIを利用してバックグラウンドでルックアップ取得処理を実行させるため、ユーザーのUI操作を妨げることなく、シームレスな操作感を実現できます。
ただし、コードの記述やテスト、保守が必要となるため、エンジニアリソースが確保できる組織向けの手法です。
ノーコード連携ツールで自動取得する（gusuku Customine等）
アールスリーインスティテュートが提供する「gusuku Customine（グスク カスタマイン）」などのノーコードカスタマイズツールを利用する方法です。プラグインよりも設定の自由度が高く、かつJavaScriptのコードを一切書かずに複雑なロジックを組むことができます。
ルックアップの自動取得にとどまらず、フィールドの表示制御やアプリ間のデータ更新など、他の自動化処理も一つのプラットフォーム上で一括管理したい場合に特に適しています。
ルックアップ自動取得におすすめのプラグインと選び方
ルックアップ自動取得プラグインは多くのベンダーから提供されていますが、導入実績と動作の安定性を考慮すると、選ぶべき候補は限られます。ここでは、無料・有料それぞれの代表的なプラグインと、選定時に見落としがちなチェックポイントを解説します。
TiS「条件分岐処理プラグイン」の自動ルックアップ機能（無料）
TiSが提供する「条件分岐処理プラグイン」は、kintone無料プラグインの中でも特に汎用性が高く、条件に応じたフィールドの自動入力やエラーチェックなど、17種類以上の処理を設定できる多機能プラグインです。その付随機能の一つとして、ルックアップの自動取得にも対応しています。
コストをかけずに導入できるため、まず試してみる第一選択肢として有力です。ただし、多機能ゆえに設定画面がやや専門的で、自動ルックアップ機能にたどり着くまでの設定ステップが多い点は考慮が必要です。kintoneの設定にある程度慣れた方であれば問題なく運用できるでしょう。
rex0220「ルックアップ自動取得プラグイン」（有料・買い切り）
kintoneカスタマイズ界で多数のプラグインを提供していることで知られるrex0220氏による専用プラグインです。「コピー元フィールドに値が入ったら即座にルックアップ取得を実行する」という単機能に特化しており、動作が軽量で安定しています。
価格は11,000円（税込）/ kintone 1サイトの買い切り型で、アプリ数は無制限で利用可能です。ランニングコストが発生しないため、長期的に見てコストパフォーマンスに優れています。アクション機能からのルックアップ自動取得やレコード複写時の自動取得にも対応しており、PC・スマートフォンの両方で動作する点も魅力です。
Smart at「ルックアップ自動取得プラグイン」（有料・年額）
M-SOLUTIONS株式会社が提供する「Smart at」シリーズのルックアップ自動取得プラグインです。設定画面のUIが非常に直感的で、自動取得を適用したいルックアップフィールド名を選択するだけで設定が完了します。
価格は年額50,000円（税抜）/ 1ドメインで、同一ドメイン内のアプリ数は無制限です。サポート体制が充実しており、15日間の無料トライアルも用意されているため、エンタープライズ企業や、初めてプラグインを導入する組織でも安心して利用を開始できます。テーブル内のルックアップやアクションボタンとの併用にも対応しています。
プラグイン選定で見落としがちな3つのチェックポイント
プラグインを選ぶ際には、機能面だけでなく以下の3点を必ず確認してください。
モバイル対応：
スマートフォンアプリ版のkintoneでも自動取得が動作するかどうか。現場でモバイル端末からデータ入力を行うケースがある場合、ここを見落とすと導入後に「外出先では手動に戻る」という事態になります。
一括更新対応：
CSVファイルの読み込みによるレコードの一括更新時にもルックアップの自動取得が走るかどうか。多くのプラグインはレコード編集画面でのみ動作するため、一括更新には別途対応が必要です。
既存カスタマイズとの競合：
すでにアプリに適用している他のプラグインやJavaScriptカスタマイズ（特にフィールドの入力制御系）と処理が干渉しないかどうか。同じフィールドをトリガーとする処理が重なると、意図しないエラーが発生する場合があります。
JavaScriptカスタマイズでルックアップを自動取得する手順
プラグインでは対応しきれない複雑な要件がある場合や、社内にJavaScriptの知識を持つエンジニアがいる場合は、カスタマイズによる実装が選択肢に入ります。ここでは、エンジニア向け、あるいはJSカスタマイズの内製化を検討しているチーム向けに、実装の流れと注意点を解説します。
jsEdit for kintoneを使った実装の流れ
kintone上でブラウザから直接JavaScriptコードを編集・即時反映できる無料プラグイン「jsEdit for kintone」を利用するのが効率的です。cybozu developer networkからダウンロードし、アプリに追加するだけで開発環境が整います。
実装の基本的な考え方としては、app.record.create.change.フィールドコード や app.record.edit.change.フィールドコード のイベントハンドラ内で、ルックアップフィールドの値が入力された（＝changeイベントが発火した）タイミングを捕捉し、record['ルックアップフィールド']['lookup'] = true; というプロパティをセットした上で kintone.app.record.set(record); を実行するという流れになります。これにより、ユーザーが「取得」ボタンを押さなくても、バックグラウンドでルックアップの取得処理が自動実行されます。
既存プラグインやJSカスタマイズとの競合を防ぐ方法
一つのアプリに複数のカスタマイズが適用されている環境では、処理の実行順序によって予期しないエラーが発生することがあります。特に注意が必要なのは、同じフィールドのchangeイベントをトリガーにする処理が複数存在するケースです。
競合を防ぐためには、イベントハンドラ内での条件分岐を厳密に行い、処理が重複して走らないようガードロジックを組む必要があります。また、プラグインとJSカスタマイズを併用する場合は、読み込み順序（kintoneの「JavaScript / CSSでカスタマイズ」設定画面での並び順）も動作に影響するため、テスト環境で十分に検証してから本番適用することを強く推奨します。
マスタを更新したらルックアップ先も自動で反映させる方法
ここまで解説してきた「入力時の自動取得」とは別に、もう一つの大きな課題が「マスタ更新の追従」です。例えば、顧客マスタアプリで社名が変更された場合に、過去に作成した案件管理アプリの社名フィールドも自動で最新の情報に更新したい、というニーズへの対応を解説します。
アプリ間レコード更新プラグインで自動反映する
TiSが無料で提供する「アプリ間レコード更新プラグイン」を使う方法が、最もシンプルな解決策です。マスタアプリ側でレコードを「保存」したタイミングで、ルックアップのキー（顧客IDやレコード番号など）をもとに紐付いている別アプリのレコードを自動的に書き換える仕組みを構築できます。
このプラグインを適用することで、情報の「一貫性」が常にアプリ間で保たれ、「案件アプリに表示されている顧客情報が古い」という問題を根本から解消できます。
CSV一括更新で手動対応する場合の手順と注意点
プラグインを利用しない場合は、kintoneの標準機能である「ファイルからの一括更新」を使った手動対応も可能です。手順は以下のとおりです。
まず、案件管理アプリなどのルックアップ先アプリから、レコードのキー項目（レコード番号やルックアップキーとなるフィールド）を含むCSVをエクスポートします。次に、そのCSVを加工せずにそのまま同じアプリに読み込み直します。この際、インポート画面で「一括更新」にチェックを入れ、更新キーを指定してください。
この操作を行うことで、kintoneが各レコードについてルックアップの再取得を試行し、参照元マスタの最新情報がルックアップ先に反映されます。
自動更新で上書きしてはいけないデータの扱い方
マスタ更新の自動反映を設計する際に、最も注意が必要なのが「過去時点のデータを保持しなければならないケース」です。
典型的な例が、商品マスタの「価格」フィールドです。商品マスタで価格改定が行われた場合、自動反映の設定が全フィールドに適用されていると、過去の売上レコードや見積レコードに記録された「受注時点の価格」まで最新価格に上書きされてしまいます。これは決算データの不整合を招く重大な問題です。
そのため、自動反映を適用するフィールド（社名、住所、担当者名など「常に最新であるべき情報」）と、あえて自動反映の対象外とするフィールド（価格、契約条件など「その時点の情報を保持すべきデータ」）を、設計段階で明確に分けておく必要があります。
弊社エンジニアからのコメント：
ルックアップの自動反映は便利な反面、『何でもかんでも自動で上書きする』設計にしてしまうと、取り返しのつかない事故につながります。
実際にあった事例として、商品マスタの価格を改定した瞬間に、過去半年分の売上レコードの単価がすべて最新価格に書き換わってしまい、月次の売上集計が合わなくなったというケースがあります。原因は、自動反映の対象フィールドを精査せずに『全コピー項目を反映対象』にしてしまっていたことでした。
私たちが設計する際は、まずフィールドを『常に最新であるべき情報（社名・住所・担当者名など）』と『その時点の値を保持すべき情報（単価・契約条件・ステータスなど）』に分類するところから始めます。この分類さえ最初にやっておけば、後から『やっぱりこのフィールドも反映したい』となっても安全に拡張できます。
自動化の設計で一番大事なのは、『何を自動にするか』よりも『何を自動にしないか』を決めることです。
導入前に知っておきたい注意点とよくある失敗
ルックアップ自動取得の仕組みを導入する際に、設定方法だけを理解していてもスムーズにいかないケースがあります。ここでは、実際の現場で頻出するトラブルとその回避策を紹介します。
アプリ間のアクセス権設定
「プラグインを設定したのにルックアップの自動取得が動かない」というトラブルの原因として、最も多いのがアクセス権の問題です。
ルックアップの自動取得は、内部的にはユーザーの権限でkintone APIを実行し、参照元アプリのレコードを取得しています。そのため、操作しているユーザーが「参照元アプリ」のレコード閲覧権限を持っていない場合、プラグインやJavaScriptが裏側で取得処理を実行しようとしても、kintone側でアクセスがブロックされます。
特に、組織やグループ単位でアクセス権を細かく制御している環境では見落としやすいポイントです。自動取得がうまく動作しない場合は、まず対象ユーザーのアクセス権限を確認してください。
フィールドコード変更後のプラグイン再設定忘れ
運用途中でkintoneアプリのフィールドコードを変更すると、プラグインの設定が実質的に無効化されてしまいます。
これは、kintoneのプラグインやJavaScriptカスタマイズがフィールドの識別に「フィールド名」ではなく「フィールドコード」を使用しているためです。フィールドコードを変更した場合、プラグインが参照している旧フィールドコードとの対応が途切れ、自動取得が停止します。
フィールドコードの変更を行った際は、必ずプラグインの設定画面を開き直して再保存するというルーチンを運用フローに組み込んでください。
自社に合った方法はどれ？体制・スキル別の選び方
ルックアップ自動取得の実現手段を把握したところで、最後に「自社の状況に合った方法はどれか」を判断するための指針を整理します。
社内にエンジニアがいない場合のおすすめルート
プログラミングの知識がない現場でも、段階的に導入を進めることが可能です。
まずは無料で利用できるTiS製の「条件分岐処理プラグイン」の自動ルックアップ機能で検証を行い、設定の難易度が高いと感じたり、より専用の機能が必要と判断した場合は、rex0220の「ルックアップ自動取得プラグイン」（11,000円・買い切り）やSmart atの「ルックアップ自動取得プラグイン」（年額50,000円）の導入を検討するのが最も効率的なルートです。
外部開発に外注費用を支払うよりも、数万円のプラグイン代で課題を解決するほうが、導入後のメンテナンスコストも含めてトータルコストを大幅に抑えられます。
自社対応が難しいと感じたときの相談先
「自社に最適な構成がわからない」「複数のアプリが複雑に絡み合っていて、どこから手をつけるべきか判断できない」という場合は、kintone認定パートナーへの相談を推奨します。
私たちAIzen株式会社は、単なるプラグインの導入支援にとどまらず、現場の業務フローそのものを分析・最適化した上で、最も費用対効果の高い実装手法を提案する内製化支援を行っています。
まとめ
kintoneのルックアップ自動取得は、現場のストレスを軽減し、データの精度を高めるために不可欠なカスタマイズです。本記事で解説したポイントを改めて整理します。
入力工数の削減：
プラグイン等を活用してルックアップの「取得」ボタンの手動クリックを自動化し、現場の入力負荷を軽減する。
データの鮮度維持：
マスタアプリの更新が既存レコードに自動反映される仕組み（追従）まで考慮して設計することで、アプリ間の情報の一貫性を保つ。
適切な手段の選択：
自社のスキルや予算、メンテナンス体制に応じて、プラグイン・JavaScriptカスタマイズ・連携ツールの中から最適な手法を冷静に判断する。
「取得」ボタンを押すだけの単純作業から現場を解放し、よりクリエイティブな業務に集中できる環境を構築しましょう。
コメント