kintoneルックアップ参照先一括更新プラグイン

マスタ側アプリのレコードをルックアップで参照している別アプリのレコードを一括更新します。

主な機能と特徴

kintoneのルックアップフィールドは便利ですが、マスタアプリ（参照元）のデータが変更されたとき、ルックアップを設定している参照先アプリのレコードは自動では更新されません。
更新するためには、参照先アプリでルックアップを再実行する必要がありますが、レコードが大量にあると修正作業に大変な時間が必要になります。

このプラグインを使うと、マスタアプリ（参照元）のレコード詳細画面のボタン1つで、マスタアプリをルックアップで参照しているアプリ（参照先）の該当レコードを一括更新できます。

実行のデモ画面

以下の画面は、アプリストア「SFA（営業支援）パック」の「顧客管理」アプリに本プラグインを設定して、「案件管理」アプリを一括更新しているデモ画面です。

右側の案件管理アプリの「株式会社サイボウズ商事」の電話番号欄に”03-xxxx-8888”が表示されています。
顧客管理アプリ（参照元）の「株式会社サイボウズ商事」電話番号を”03-xxxx-7777”に変更します。
「株式会社サイボウズ商事」のレコード詳細画面に表示される「参照先アプリ更新」ボタンをクリックします。

処理開始前の確認ダイアログ表示と、処理件数のプログレス表示のデモ画面です

参照先の複数レコード（５件）のルックアップ参照フィールド（電話番号）の一括更新が完了します。
右側の案件管理アプリの表示を更新すると「株式会社サイボウズ商事」の電話番号が一括で更新されています。

🛠️ 設定方法

プラグインの設定は、下記設定画面の４種類の設定でで完了します。

① 参照先アプリの選択

「参照先アプリ」テキストボックスにアプリ名の一部を入力すると、選択候補がサジェスト表示されます。
　候補をクリックすると、参照先アプリのフィールド定義が自動で読み込まれます。
　もし誤って、プラグイン設定側のアプリをルックアップで参照していないアプリを選択した場合は、参照先アプリのキーフィールド選択欄の下に警告メッセージ「⚠️ 選択したアプリには、このアプリを参照するルックアップフィールドが見つかりません。」が表示されますので、参照先アプリを選択し直してください。

② このアプリのキーフィールドの選択

このアプリのフィールドから、参照先アプリのレコードを特定するためのキー値を持つフィールドを選択します。
選択できるフィールドの型は、kintone の公式仕様でルックアップ参照キーに指定できる以下の6種類から自動判定されて選択リストに絞り込み表示されます。

参考: kintone 公式ヘルプ「ルックアップを設定する」に基づく仕様です。重複禁止の設定は必須ではありませんが、API による一括更新を行うプラグインでは 値の重複がないフィールド（レコード番号・重複禁止の文字列1行や数値）をキーとして使用することを推奨します。

③ 参照先アプリのキーフィールドの選択

参照先アプリのフィールドのうち、ルックアップ属性を持つフィールドのみがリスト表示されます。このアプリのキーフィールドと対応するフィールドを選択してください。

④ フィールドマップの設定

「このアプリのフィールド（コピー元）→ 参照先ルックアップフィールド（書き込み先）」のペアを設定します。

• 左列（コピー元）: このアプリのフィールドを選択
• 右列（書き込み先）: 左列の型と一致する参照先フィールド（文字列1行を含む）が自動表示されます
• 「＋ 行を追加」ボタンで行を増やせます
• 各行の「✕」ボタンで行を削除できます

⑤ 保存・実行

「保存する」ボタンでバリデーション通過後に設定が保存されます。設定完了後は、このアプリのレコード詳細画面を開き、ヘッダーに表示される 「参照先アプリの更新」ボタン をクリックするだけで、一括更新が実行されます。

設定項目の入力チェック（バリデーション）

💻 試用版プラグインのお申込み

本プラグインの試用版（60日間）をご希望の方は、以下のフォームからお申し込みください。
お申込み者のＥメール宛に「試用版ダウンロードのご案内」をＥメールでご送付します。
★★ kintoneの「ドメイン名」は正確にご記入ください。★★

📬 お問い合わせ・料金体系

本プラグインは、下記の料金プランで販売しています。
ご購入を希望される場合は、各プランの「購入する」ボタンからお申込みください。

簡易サポート契約では、当サイトのアプリテンプレートとプラグインを合計6種類までご利用できます。
会員サポート契約では、導入支援から運用ヘルプデスク対応をフルサービスでご提供します。

リリースノート

【名称】ルックアップ参照先一括更新プラグイン

【概要】マスタ側アプリをルックアップで参照している別アプリのレコードを一括更新します。

このプラグインで利用しているOSSのライセンスはありません。

参考記事（Javascriptカスタマイズ事例）

以下の記事は、サジェスト（提案リスト）表示機能活用事例の紹介記事です。
サジェスト表示カスタマイズの活用事例を紹介していますので、ご参考にしてください。

文字列入力を補完するサジェスト（提案リスト）機能の紹介

kintoneを日常的に活用している部門のユーザーにとって「文字入力」は最もストレスの溜まる作業です。特に建築設計や工事業界では、案件名が長く、かつ似たような名称が多いため、入力ミスや手間の増大が課題となります。本記事では、そんな入力負荷を劇的に軽減する「入力を補完するサジェスト（提案リスト）表示プラグイン」の活用術をご紹介します。やりたいこと：文字列入力欄に「サジェスト機能」を持たせるkintoneの「文字列1行」フィールドは、入力の自由度が高い反面、過去に入力したデータと…

dejitora.jp

2026.03.30

#kintone #plugin #ルックアップ更新 #一括更新