グループフィールド開閉プラグイン（無料）
レコード画面のグループフィールドの開閉状態を、レコードの値の条件によって自動的に切り替えます。 ルールごとに対象グループフィールドを1つ選び、日時・ラジオボタン・ドロップダウン・ チェックボックス・プロセス管理ステータスを組み合わせた条件(AND/OR結合)、または「常に」で 開く/閉じるを設定できます。同じ対象グループフィールドに複数のルールを設定した場合は、 設定順で最初に一致したルールが優先されます。
こんな方におすすめ
- kintoneのグループフィールドを条件によって自動で開閉したい
- 普段は折りたたんでおいて必要なときだけ開きたい
- 「kintone グループフィールド 開閉」を探している
紹介動画
ユースケース
「差し戻し理由」や「詳細情報」のようなグループフィールドを、通常は折りたたんで画面をすっきり見せておき、ステータスが「差し戻し」になったときだけ自動的に開いて担当者の注意を引く、といった使い方ができます。
1つのアプリに複数のグループフィールドがある場合、それぞれ独立した条件(担当部署・案件区分など)で開閉させることができます。入力項目の多いフォームでも、今関係のある情報だけを自動的に開いた状態で見せられます。
セットアップ手順
- アプリのフォーム編集で、開閉を制御したいグループフィールドを1つ以上作成しておく。
- プラグインをアプリに追加し、設定画面を開く。
- 「+ ルールを追加」でルールを作成し、対象グループフィールド・条件モード(常に/条件を満たすとき)を選ぶ。
- 「条件を満たすとき」を選んだ場合は、条件の結合方法(AND/OR)・条件(フィールド種別・フィールド・演算子・値)を1つ以上追加する。
- 動作(開く/閉じる)を選んで保存する。
- 保存後、アプリを更新する(kintoneのアプリ設定は保存しただけでは反映されず、更新〈デプロイ〉して初めてレコード画面に反映されます)。
PC(レコード詳細・追加・編集・印刷画面)・モバイル(レコード詳細・追加・編集画面)の両方に対応しています。同じ対象グループフィールドを持つルールは設定順に評価し、最初に一致したルールの動作が適用されます。「常に」を選んだルールは条件を持たず常に一致するため、既定動作として使えます。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- グループフィールドの開閉はDOMの直接操作ではなく、kintone標準のJavaScript API(
kintone.app.record.setGroupFieldOpen()/kintone.mobile.app.record.setGroupFieldOpen())のみで行います。 - 設定画面でのみ、プロセス管理のステータス名一覧を取得するために
kintone.api()(kintone自身への呼び出し専用の内部ラッパー)経由でGET /k/v1/app/status.jsonを呼びます。外部サーバーへの通信・外部ライブラリは一切使用していません。 - 設定画面でのフィールド一覧・選択肢・エラーメッセージの描画は、すべて
textContentまたは<template>要素のcloneNodeで行っており、innerHTMLへの外部由来文字列の埋め込みはありません。 - 保存前のバリデーションで、対象グループフィールド未選択・条件モード不正・条件0件・フィールド未選択・演算子不正・値未入力・動作の指定不正などを検出して保存させません。グループフィールドが1つも無いアプリでは、その旨を表示しルール追加を無効化します。
- グループフィールドの開閉はUIレベルの表示状態の切り替えであり、折り畳んだグループ内のフィールド値自体やレコードのアクセス権には一切影響しません。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
レコード画面側はsetGroupFieldOpen()というJavaScript APIのみで完結し、REST APIは
実行しません。設定画面を開いたときのみ、プロセス管理のステータス名一覧を取得するためにREST API
(GET /k/v1/app/status.json)を1回実行しますが、これは管理者が設定画面を開いたときだけ
であり、レコードの閲覧・保存のたびに実行されるものではありません。