rex0220 項目絞り込みプラグイン

kintone の他アプリのデータにより、ドロップダウンの選択肢を絞り込むプラグインです。

- 絞り込み対象項目を１０セット、各セット１０項目まで指定可能。
- 絞り込みの結果で選択肢がひとつになった場合、自動選択。
- サブテーブルの項目に設定可能。
- 参照先アプリ一覧画面で、抽出条件を指定。
- 一覧編集時、項目絞り込み対象項目を編集不可に設定
- 項目検証プラグイン（Ver.26 以降）連携
- テーブル行複写プラグイン（Ver.3 以降）連携
- 計算式プラグイン（Ver.42 以降）連携
- PC/モバイル対応


[rex0220 stores](https://rex0220.stores.jp)で、販売中です。

Ver.19 以降での注意事項
プラグイン設定保存時に、rex0220_narrowdown_hide.css, rex0220_narrowdown_hide2.css ファイルをチェックします。
Ver.18 以前から Ver.19 以降にバージョンアップする場合は、プラグイン設定を保存後に rex0220_narrowdown_hide.css と rex0220_narrowdown_hide2.css を削除してください。

![2022-05-05_13h45_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/debf11e7-3974-705d-4760-b13ce20a0958.png)


# 直近の変更点

※ Ver.24
・プラグイン設定画面のデザイン変更対応
・プラグイン設定に、「説明」設定機能を追加


# 概要

![2017-02-25_22h28_50.png](https://qiita-image-store.s3.amazonaws.com/0/100572/f02f1502-c408-f7f5-bc3c-801f96e0a08f.png)


- 設定先項目に、ドロップダウン項目、文字項目、数字項目を指定可能。
    - ドロップダウン項目の場合、選択肢に指定される値をすべて定義しておく必要があります。
- 参照先アプリのドロップダウン、ラジオボタン、文字列、数字、計算、レコード番号、ユーザ選択、作成者、更新者を指定可能。
- 参照先データが５００件以上の場合、セッションストレージにキャッシュを作成。
- キャッシュは、１時間毎に自動更新。

# 追加・編集操作例

![2017-02-25_23h01_19.gif](https://qiita-image-store.s3.amazonaws.com/0/100572/09047d5f-57fc-c919-2519-a203e4179fd8.gif)

# サブテーブル操作例

![2017-02-27_10h25_12.gif](https://qiita-image-store.s3.amazonaws.com/0/100572/7acb9170-aaee-adda-306c-9fc2e20ffbfc.gif)


# プラグイン設定による画面表示の変化

追加編集画面で、文字項目、数字項目がドロップダウンに変化します。

![項目絞り込みプラグイン1.png](https://qiita-image-store.s3.amazonaws.com/0/100572/a86a5124-aefa-d684-e58c-6d4c0499734c.png)


# モバイル表示

PCと同様にモバイルにも対応しています。

<img width="271" alt="2020-05-11_17h25_51.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/721f7cea-5cd3-fa6e-2078-8d61cdfc97f9.png">


# プラグインの設定手順

## 参照するアプリに一覧画面を作成

絞り込みプラグインのドロップダウンに表示する表示順と抽出条件を指定して、一覧画面を作成します。

対象レコードが５００件を超えると、項目選択データ読み込みにキャシュが使われます。
キャシュは、１時間ごとに最新データを読み込みます。
キャッシュをすぐに最新データにしたい場合は、ブラウザを立ち上げなおします。
常に最新データを表示したい場合は、５００件以下になるように抽出条件を指定してください。

![2017-02-25_23h28_04.png](https://qiita-image-store.s3.amazonaws.com/0/100572/abae8517-06f1-81d2-7d26-f43ec1b2a209.png)


##　項目絞り込みプラグイン用の項目を設定

![2017-02-25_22h47_04.png](https://qiita-image-store.s3.amazonaws.com/0/100572/298c5b6b-6057-dd64-0bb1-2c0253a1ba2c.png)


## プラグインの読み込みとアプリへのプラグイン追加設定

- 「Kintoneシステム管理＞プラグイン」で、プラグインを読み込みます。
- 「アプリの設定＞プラグイン」で、プラグインを追加します。


![項目絞り込みプラグイン2.png](https://qiita-image-store.s3.amazonaws.com/0/100572/86534a4a-b210-ac3e-4696-058ee3e54bc8.png)


## 項目絞り込みプラグイン設定

- プラグイン有効：　プラグインの有効・無効を指定
- 選択肢の高さ：　ドロップダウン選択肢の高さを指定　※ 200 px 規定値
- プラグイン設定のダウンロード
- プラグイン設定のアップロード
- 絞り込み対象項目セット毎に、参照先アプリと一覧画面を指定します。
- 「編集」ボタンをクリックして、対象項目を設定します。

※一覧画面のソート・抽出条件を設定変更時は、プラグインも再設定してください。

![2021-09-16_11h12_56.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/6c4a2d42-9e74-5f3f-dcf0-dd2c85070a2d.png)


- 項目をクリックすると、指定可能な項目が一覧表示されます。
- 一覧から項目を選択します。
- 項目設定後、「保存」ボタンをクリックします。


![2017-02-25_23h50_59.png](https://qiita-image-store.s3.amazonaws.com/0/100572/14b3cc12-be9c-c0b3-50dd-8929aec9acc2.png)

- 運用環境に反映：　チェックすると、「保存」クリックで運用環境に反映します。
- 項目設定後、「保存する」ボタンをクリックします。
- 「アプリを更新」で本番環境に設定内容を反映します。


![2021-09-16_11h12_56.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/ea4b66ec-a05b-7446-4aee-42e71d226f4f.png)


# サブテーブルに設定する場合

アプリにサブテーブルがあると、テーブル選択が表示されます。
設定する項目のサブテーブルを選択します。

![2017-02-27_10h44_17.png](https://qiita-image-store.s3.amazonaws.com/0/100572/38d404a6-4f79-8e9b-f04c-15d3c37e9294.png)


項目に、サブテーブルのフィールドコードが表示されます。

![2017-02-27_10h40_49.png](https://qiita-image-store.s3.amazonaws.com/0/100572/ffb91b24-e132-7964-c323-0fa6be0cfe31.png)



# 注意事項

- 既に、JavaScript によるカスタマイズを行っているアプリの場合、処理が競合して、エラーになる場合があります。その場合は、該当するアプリでプラグインの使用を中止してください。
- アプリ設定を変更した場合は、プラグインを再設定してください。