Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
12
Help us understand the problem. What is going on with this article?
@rex0220

kintone ルックアップ先更新プラグイン

kintone 標準機能では、ルックアップ項目の値を変更した場合、ルックアップ参照しているアプリのレコードは、更新されません。
RDB データベースで、テーブル結合した場合と異なり、ルックアップ機能は値のコピー機能です。
しかし、データベースとして使用する場合は、マスターの最新データを反映したい要望が多いです。

このプラグインは、ルックアップ先更新処理を簡単に設定して、更新できます。
複数アプリがルックアップ対象でも、対象アプリを順次更新します。

  • 更新条件指定機能
  • 一覧画面で、一括ルックアップ先更新機能(PCのみ)
  • PC・スマホ対応

stores で、販売中です。

※Ver.6 の変更点
・更新条件の計算式に、MATCH, ARRAY_DEL, ARRAY_SORT, INTERSECT 関数追加
・ステータス変更時、編集権限が無い場合エラーになる対策
・プラグイン設定においてアプリ数が 4以下の場合、エラーになる対策
・編集画面の更新エラー時に、対象アプリをスキップして他アプリの更新処理を続行

ルックアップ先更新プラグイン

編集画面で「保存」後に、ルックアップ先更新処理が実行されます。
また、詳細画面でプロセス管理のステータスを変更時に、ルックアップ先更新処理が実行されます。
更新処理中、処理件数が表示されます。

プログレスバーとアプリ別件数表示されます。

更新処理中に、画面を閉じたり、別ページに移動すると更新処理が中止されます。

lookup01.png

スマホ対応

スマホでレコード変更を行った場合も、ルックアップ先更新処理が実行されます。

2018-04-04_13h57_09.png

1万件のレコード更新可能

対象件数が1万件でも、更新可能です。
lookup02b.png

対象アプリ10本でも更新可能

プラグイン設定画面
2020-04-05_23h18_21.png

更新ダイアログ表示
lookup02d.png

アプリ内の複数ルックアップ設定に対応

ルックアップ設定例

lookup02e.png

ルックアップの項目値変更に対応

ルックアップのキー項目変更にも対応しています。

lookup02a.png

ルックアップデータ削除のエラー

ルックアップ先アプリのレコード状況により、更新エラーが発生する場合があります。
ルックアップのデータ削除した場合、該当レコードのエラーを訂正してください。

lookup04a.png

ルックアップ設定変更によるエラー

ルックアップ先アプリの画面設定変更により、更新エラーが発生する場合があります。
ルックアップ設定を変更した場合、プラグイン設定画面で再設定してください。

lookup04b.png

一覧画面での編集機能

2017-05-08_09h56_07.png

一覧画面での「ルックアップ先更新」機能

プラグイン設定により、一覧画面に「ルックアップ先更新」ボタンを表示できます。
一覧画面で表示対象のレコードについて、まとめてルックアップ先更新を実行できます。
※対象レコードは、最大 2,000件です。2,000件以上の場合は、対象レコードを絞ってください。
REST API の1日当たりの回数制限(1万件/日)を超えないように調整してください。

2020-04-05_23h55_40.png

プラグインの追加

lookup05.png

設定画面

設定画面を開くと全アプリを検索し、ルックアップ参照しているアプリを取得します。
更新対象とするアプリを選択して、「保存する」をクリックします。

2020-04-05_23h21_19.png

ルックアップ設定チェック

項目設定内容により、API更新可能かチェックします。
2020-04-05_23h30_14.png

「値の重複を禁止」の設定

ルックアップ先更新を行うには、ルックアップのマスター側の項目の値がユニークキーとなっている必要があります。

例えば、担当者名に同じ名前のデータが複数登録されているとルックアップされた値がどちらのレコードか判断できません。
※ルックアップ選択時は、マニュアルでどちらかのレコードを選択していますが、レコード登録後はどちらのレコードかわからなくなります。

対応としては、下記のように担当者名の「値の重複を禁止する」を設定します。
なお既存レコードに値の重複がある場合は、あらかじめ重複を解消してください。
また、「値の重複を禁止する」を設定できないようなケースでは、ルックアップ項目を変更する必要があります。

2020-06-19_08h59_36.png

更新条件

更新対象レコードの条件を指定します。
「編集」ボタンをクリックすると、更新条件のダイアログが表示されます。
更新先アプリの項目と条件を指定します。条件値には、計算式が指定できます。
※計算式には、計算式プラグインの計算式が使用できます。

2020-04-05_23h35_23.png

ボタン別設定

一覧画面で「ルックアップ先更新」ボタンを表示する場合に、チェックします。
ボタン名を変更する場合は、名称を変更します。

2020-04-05_23h47_10.png

一覧別設定

「ルックアップ先更新」ボタンを表示する一覧を指定します。

2020-04-05_23h44_55.png

権限設定

「ルックアップ先更新」ボタンを表示するユーザー・組織・グループ(ロール)を指定します。

2020-04-05_23h46_03.png

注意事項

  • 更新処理中に、画面を閉じたり、別ページに移動すると更新処理が中止されます。
  • レコードを削除された場合、本プラグインではエラーになりません。
  • 既に、JavaScript によるカスタマイズを行っているアプリの場合、処理が競合して、エラーになる場合があります。その場合は、該当するアプリでプラグインの使用を中止してください。
12
Help us understand the problem. What is going on with this article?
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
rex0220

Comments

No comments
Sign up for free and join this conversation.
Sign Up
If you already have a Qiita account Login
12
Help us understand the problem. What is going on with this article?