レコード指摘改善プラグイン（無料）
申請内容のチェックや書類の校閲で、「どの項目の・何を直してほしいか」をコメント欄に書いても、 項目との対応があいまいになり、直したかどうかも追いかけにくくなりがちです。このプラグインを使うと、 レコード詳細画面でフィールドごと・テーブルの行ごとに修正指摘を下書きし、まとめて登録できます。 未解決の指摘がある箇所には赤いバツマークが付き、マウスを乗せると指摘内容が表示されます。 対応した人が解決内容を登録すると緑のチェックマークに変わります。解決も下書きにためて、 複数の解決と新しい指摘を1回の保存でまとめて登録できます(kintoneのAPI実行数は通常1回)。指摘日時・指摘者・指摘内容・ 解決状況・解決内容・対応者・解決日時はレコード内の「指摘履歴」サブテーブルに残るため、これまでのやり取りも あとから確認できます。
紹介動画
こんな方におすすめ
- 申請・届出の審査で、不備のある項目を申請者や担当者に正確に伝えたい
- コメント欄での差し戻しは、どの項目への指摘なのか分かりにくく、やり取りが往復しがち
- 気づいた不備をまとめて書き出してから、一度に差し戻したい(1件ずつ保存するのは手間)
- 明細テーブルの「何行目の何がおかしいか」まで、行単位で正確に伝えたい
- 指摘した箇所が直ったかどうかを、レコードを開いてひと目で確認したい
- 「誰が・いつ・何を指摘し、誰が・どう直したか」をレコードの記録として残したい(監査・引き継ぎ)
- 「kintone 項目ごと コメント」「kintone 差し戻し 理由 記録」を探している
ユースケース
審査担当者は指摘モードで、気づいた不備を「申請金額」「事業期間」などの項目ごとに下書きし、最後に「まとめて登録」で一度に登録します。経費明細テーブルの「3行目の単価が見積書と違う」といった行単位の指摘もできます。担当者がレコードを開くと、不備のある項目・行に赤いバツが付いているので、どこを直せばよいかがすぐに分かります。修正後に「見積書に合わせて修正しました」などの解決内容をまとめて登録すると緑のチェックに変わり、審査担当者は残りの不備だけを確認できます。
決裁前の校閲で、上長が「件名」「本文」「相手方」の各項目への修正指示を下書きし、読み終えてからまとめて登録します。起案者は編集画面の上部に表示される未解決の指摘一覧を見ながら修正でき、修正後に解決内容を登録します。指摘と対応の経緯はサブテーブルに残るため、のちの監査や担当替えのときにも、どんな修正を経て決裁されたかを確認できます。
顧客台帳や施設台帳の定期点検で、確認担当者が「住所が旧表記のまま」「電話番号が不通」などをフィールドごとに指摘します。レコード上部には「未解決の指摘 n件」が表示され、「指摘履歴」ボタンで全件(解決済み含む)を一覧表示し「未解決のみ」に絞り込むこともできます。
新人が登録した報告書や日報を先輩がレビューし、項目ごとに書き方のアドバイスを指摘として残します。新人は解決内容に直した点を書いて登録するため、どんな指摘を受けてどう直したかが本人の振り返りにもなります。
セットアップ手順
- アプリにプラグインを追加し、設定画面を開く。
- 「指摘できるフィールド」で、指摘の対象にしたいフィールドにチェックを入れる(既定はすべて)。テーブルを選ぶと、テーブル全体に加えて各行にも指摘できます。
- 「保存する」を押す。指摘を記録する「指摘履歴」サブテーブル(対象フィールドコード・対象項目・対象行ID・指摘日時・指摘者・指摘内容・解決状況・解決内容・対応者・解決日時)が自動で作成され、アプリに反映されます(手動でのフィールド作成は不要です)。
- アプリを更新する(プラグインの設定は、アプリを更新〈デプロイ〉して初めてレコード画面に反映されます)。
- レコード詳細画面の上部にある「指摘モード」をONにすると、各フィールドの右上とテーブルの各行の右側に「＋」が表示されます。指摘したい箇所の「＋」を押すと、画面右下の「指摘の下書き」に入力欄が追加されます。
- 指摘したい箇所をすべて書き終えたら、「まとめて登録」を押します。1回の保存で全件が登録され、指摘された箇所に赤いバツ(件数付き)が表示されます。
- 修正した人はバツを押して「解決内容を下書きに追加」を押し、下書きパネルで解決内容を書きます。複数の指摘をまとめて解決でき、新しい指摘と一緒に「まとめて登録」で1回で登録されます。解決した箇所は緑のチェックに変わります。
フィールド横のバツ・チェックの表示と、指摘の登録・解決はPCのレコード詳細画面で行います。モバイルでは、レコード詳細・編集画面の上部に未解決の指摘一覧が表示されます(閲覧のみ)。指摘履歴サブテーブルは、レコードの追加・編集画面では直接編集できないようにしています。
v1をお使いの場合: プラグインを更新したあと、設定画面を開いて一度「保存する」を押してください。既存の指摘履歴テーブルに「対象行ID」列だけが追加され(これまでの指摘はそのまま残ります)、テーブルの行単位の指摘が使えるようになります。
動作イメージ
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- 書きかけの指摘・解決(下書き)は画面内のメモリにだけ保持し、ブラウザに保存しません。まとめて登録は1回の更新で全件を反映するため、途中まで登録される中途半端な状態になりません。
- 指摘内容・解決内容・ユーザー名などはすべて
textContentで描画し、innerHTMLを一切使用していません(XSS対策)。 - 登録時は必ずリビジョン番号を指定して更新します。画面を開いたあとに他の人がレコードを更新していた場合はkintoneが更新を拒否するため上書きは起きず、そのときだけ最新の内容を取り直して登録し直します。
- 更新するのは指摘履歴テーブルのみで、変更しない行はIDだけを送るため、他の指摘の内容を古い値で上書きしたり消したりしません。
- REST APIは、kintone自身への
kintone.api()のみを使用し、外部サーバーへの通信や外部ライブラリは一切ありません。 - フィールド要素の内部構造は変更せず、バツ・チェックは画面上に重ねて表示しています(kintoneのバージョンアップで壊れにくい構成)。テーブルの行の位置も読み取るだけで、行数が合わないときは行のバッジを出さずテーブル全体に表示します。
- 指摘履歴テーブルの編集禁止は画面上の制約です。改ざんを確実に防ぎたい場合は、フィールドのアクセス権もあわせて設定してください。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
レコード詳細画面を表示するだけではREST APIを使用しません(フィールド情報はJavaScript APIで取得します)。 指摘・解決の「まとめて登録」は、件数にかかわらず通常1回のAPI実行で済みます (画面を開いたときのレコード内容とリビジョン番号でそのまま更新するため、事前の取得を省いています)。 画面を開いたあとに他の人が同じレコードを更新していた場合のみ、最新の内容を取り直すため3回になります。 設定画面での保存時は、指摘履歴テーブルを新規作成する場合(またはv1のテーブルに列を追加する場合)のみ、フィールド追加・アプリ反映・反映状況の確認でAPIを実行します。