ルックアッププラグイン

使い方

kintone標準のルックアップには、使っていて困るところが2つあります。1つは、コピーされた値を編集できないこと。住所や担当者を「このレコードだけ少し直したい」ができません。もう1つは、探せるのが「コピー元のフィールド」だけなこと。そこがレコード番号や「値の重複を禁止する」コードになっていると、会社名やフリガナ、電話番号では探せません。 このプラグインは、別のアプリを検索して、その値をふつうのフィールドにコピーします。ふつうのフィールドなので、コピーしたあとで自由に直せます。検索するフィールドも何個でも選べるので、コードでも名前でもフリガナでも電話番号でも探せます。 キーの欄に入力すると自動で探し、1件だけならそのままコピー、複数あれば候補の一覧から選べます。スマホでも同じように使えます。

1. 参照先のアプリと、キーを入れるフィールドを決める

   プラグインの設定画面で「＋ ルックアップを追加」を押し、次を決めます。

   「参照先のアプリID」には、値を持ってくるアプリ（取引先マスタ、商品マスタなど）のアプリIDを入れて、「フィールドを読み込む」を押します。アプリIDは、そのアプリを開いたときのURL「.../k/42/」の数字です。参照先を見る権限がない人は検索できません。

   「キーを入れるフィールド」は、このアプリで探す文字を入力する欄です。文字列（1行）・数値・リンク・ドロップダウン・ラジオボタン・日付から選べます。ここに入力すると、参照先の検索が始まります。

   「このルックアップの名前」は、画面のお知らせや候補の画面の見出しに出ます。空にすると、キーの欄の名前をそのまま使います。

2. 検索するフィールドと、コピーする項目を決める

   「参照先で検索するフィールド」に、探すときに見るフィールドを選びます（5つまで）。ここが標準のルックアップとの一番の違いで、コピー元でないフィールド（会社名・フリガナ・電話番号など）も選べます。入力した文字は、選んだフィールドのどれかに合えば候補になります。

   「一致のしかた」は、部分一致（含む）・前方一致（で始まる）・完全一致（ぴったり同じ）から選べます。ドロップダウン・ラジオボタン・チェックボックス・複数選択・数値・日付・レコード番号は、種類の決まりで「ぴったり同じ」でしか探せません。文字列（複数行）・リッチエディター・添付ファイルは、kintoneが検索できないので選べません。

   「コピーする項目」で、「参照先のフィールド」→「このアプリのフィールド」の組を並べます（20組まで）。ここに入れた値は、あとから手で直せます。計算・自動計算の文字列・ルックアップのコピー先・レコード番号などは、値を入れられないので選択肢に出ません。

   「候補一覧に出す列」は、候補が複数あるときに出す一覧の列です（4つまで）。選ばなければ「検索するフィールド」をそのまま出します。

   「参照先の絞り込み（任意）」に条件を書くと、その条件に合うレコードだけを候補にします（例：状態 in ("有効")）。

3. 追加・編集画面で使う

   レコードの追加・編集画面でキーの欄に入力すると、参照先を検索します。

   ・候補が1件だけのとき：そのままコピーします。

   ・候補が複数あるとき：候補の一覧が開くので、「これにする」を押して選びます。

   ・見つからなかったとき：画面の上に「見つかりませんでした」と出ます。

   「参照先から選ぶ」ボタンを使うと、キーの欄を使わずに、探す文字を入れて候補から選べます。ボタンを出すには、アプリのフォーム設定で「スペース」を置き、その要素IDを設定画面に入れてください（キーの欄の近くに置くと使いやすくなります）。スマホは要素IDを決めていなくても、レコードタイトルの下にボタンが出ます。

   「動き」では次を選べます。

   ・候補が1件だけなら、自動でコピーする：外すと、1件でも候補の画面を出して確かめてから入れます。

   ・キーの欄を空にしたら、コピー先も空にする：前のレコードの値が残るのを防ぎます。

   ・見つからなかったときも、コピー先を空にする。

   ・見つからないときなどのお知らせを画面に出す。

   ・参照先にないキーのままでは保存できないようにする：標準のルックアップと同じように、でたらめなコードのまま保存するのを防ぎます。

   設定を保存したら「アプリを更新」を押してください。