アプリ間突合プラグイン（無料）
「基準アプリ」に登録されている人が、別の「対象アプリ」にも提出しているかどうかを突き合わせ、 提出済/未提出の一覧を作成するプラグインです。たとえば「妊娠届は出ているが、 妊娠時面談予約が出ていない人」を1クリックで洗い出せます。結果は集計アプリのレコードに JSONファイルとして履歴で残り、過去の実行結果と切り替えて見比べられます。
アプリと絞り込み条件の指定は、kintoneのレコード一覧のURLをコピーして貼り付けるだけ。 一覧画面で絞り込んでからURLをコピーすれば、その条件がそのまま突合の対象範囲になります。 クエリ記法を覚える必要はありません。
こんな方におすすめ
- kintoneで「Aアプリには出ているがBアプリには出ていない人」を一覧にしたい
- 未提出者・未受診者・未回答者の洗い出しを毎月CSV+ExcelのVLOOKUPでやっている
- 「kintone アプリ間 突合」「kintone 未提出 抽出」を探している
- 関連レコード一覧では1件ずつしか見られず、一覧化・件数集計ができなくて困っている
- いつ時点でどれだけ未提出だったか、推移を記録として残したい
kintone標準ではなぜできないのか
kintoneの関連レコード一覧フィールドは、レコード詳細画面で「この人の面談予約」を 1件ずつ見ることはできますが、一覧画面に並べたり、「予約が0件の人だけ」を絞り込んだりはできません。 グラフ・クロス集計も1つのアプリの中でしか集計できないため、アプリをまたいだ 「片方にしかない」の抽出はできません。結果として、両方のアプリからCSVを書き出して ExcelのVLOOKUPで突き合わせる、という手作業が残りがちです。
このプラグインは、その突き合わせをkintoneの中で完結させ、結果を記録として残すためのものです。
ユースケース
「妊娠届」アプリを基準アプリ、「妊娠時面談予約」アプリを対象アプリに設定し、宛名番号などの共通コードで突き合わせます。妊娠届を出しているのに面談予約のレコードがない人が「未提出」として一覧に並ぶので、そのまま連絡対象のリストとして使えます。「未提出のみ表示」に切り替えてCSVでダウンロードすれば、通知の宛先リストがそのまま作れます。
対象アプリは複数登録できます。「職員名簿」を基準アプリにして、「研修受講記録」「健診受診記録」「ストレスチェック回答」をそれぞれ対象アプリに設定すると、1つの表に「誰が・何を・出しているか」が横並びで表示されます。対象アプリごとに絞り込み条件(クエリ)を設定できるので、「今年度分だけ」といった条件も指定できます。
突合結果は上書きされず、実行するたびに「突合履歴」テーブルへ1行ずつ追記されます。過去の実行結果はドロップダウンで切り替えて表示できるため、「先月時点では何人が未提出だったか」をあとから確認できます。督促の効果測定や、監査時の記録としても使えます。
対象アプリに同じキーのレコードが複数ある場合、「提出済(2件)」のように件数付きで表示され、最終提出日もあわせて表示されます。重複登録や再申請の確認に使えます。
セットアップ手順
- 突合結果を保存するための「集計アプリ」を新しく1つ作る(フィールドは空のままで構いません)。
- 集計アプリにプラグインを追加し、設定画面で「集計用フィールドを作成」ボタンを押す。突合設定・「突合履歴」テーブル(添付ファイル付き)・結果表示用のスペースが自動で作成されます。この操作はアプリの設定を運用環境へ反映(デプロイ)しますので、動作テスト環境に未反映の変更がないことを確認してから実行してください。
- アプリを更新(デプロイ)する。
- 集計アプリでレコードを1件作成して開く。レコード画面に「突合設定」が表示されます。
- 「基準アプリ」に、対象者の母集団となるアプリのレコード一覧のURLを貼り付けて「このURLから読み込む」を押し、突合キー(宛名番号・個人番号など)と表示名(氏名など)のフィールドを選ぶ。一覧画面で絞り込んでからURLをコピーすれば、その絞り込み条件がそのまま使われます。
- 「対象アプリ」に、提出状況を調べるアプリを同様に設定する。「+ 対象アプリを追加」で複数登録できる。
- 「設定を保存」を押し、画面上部の「突合を実行」ボタンを押す。
突合の設定はレコードごとに持ちます。そのため、同じ集計アプリの中に「妊娠届×面談予約」「職員名簿×研修受講記録」といった別々の突合を、別レコードとして並べて管理できます。突合キーは「完全一致」で突き合わせます。数値フィールド同士であれば「1」と「01」は同じものとして扱いますが、文字列フィールドの場合は先頭のゼロも含めて一致する必要があります(宛名番号のように先頭ゼロに意味があるコードを壊さないための仕様です)。
実行結果イメージ
「未提出のみ表示」のチェック、対象アプリでの絞り込み、突合キー・氏名でのキーワード検索ができます。表示中の内容はCSVでダウンロードできます。突合キーと状況のセルからは、元のアプリのレコードへ直接リンクします。
突合設定イメージ(レコード画面の中)
一覧のURLを貼って「このURLから読み込む」を押すと、アプリ名と絞り込み条件が読み取られて表示され、そのアプリのフィールドが選択肢に並びます。設定・実行・結果確認がレコード画面の中で完結します。
プラグイン設定画面イメージ
プラグイン設定画面で行うのは、集計用フィールドの作成と、アプリ全体で共通の表記・上限の設定だけです。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- 突合結果は添付ファイル(JSON)として保存されますが、添付ファイルはレコードを編集できる人が差し替えられる「信用できない入力」として扱っています。画面に表示する前に必ず形式と型を検証し、レコードIDとアプリIDは「数字のみ」しか通しません(リンクの組み立てに使うため、
javascript:のような値が混入する経路を塞いでいます)。 - 結果一覧の描画は
innerHTMLを一切使わず、createElementとtextContentのみで組み立てています。氏名や突合キーにHTML特殊文字が含まれていても、文字列として表示されます。 - CSV出力では、
=や+で始まる値の先頭にシングルクォートを付けて無害化しています(Excelで開いたときに数式として実行されるCSVインジェクションの対策)。 - 集計用フィールドの自動作成は、設定画面で管理者がボタンを押したときだけ実行され、確認ダイアログで「運用環境へ反映される」ことを明示します。追加するのは不足しているフィールドだけで、既存フィールドの設定は変更も削除もしません。書き換え対象はプラグインが動作しているアプリ自身のみで、基準アプリ・対象アプリには読み取りしか行いません。
- 突合設定はレコードに保存されるため、そのレコードを編集できる人が設定を書き換えられます。ただし読み書きできる範囲はその利用者自身の権限の範囲を超えません(閲覧権限のないアプリを指定してもAPIがエラーを返すだけです)。逆に、閲覧権限を持つアプリであれば突合対象にできるため、集計アプリの編集権限は担当者だけに絞ってください。
- 貼り付けられた一覧URLから取り出すアプリID・一覧IDは数字のみを通し、URL文字列自体をリンクやDOM構造に使うことはありません。取り出した絞り込み条件はkintone側でクエリとして構文検証されます。
- kintone以外のサーバーへの通信は一切行わず、外部ライブラリも使用していません。ファイルの読み書きだけはkintone公式が
kintone.api()非対応と明記しているため同一オリジンへのfetchを使いますが、URLはkintone.api.url()で組み立て、POSTにはCSRFトークンを付与しています。 - レコードの取得は逐次実行で、1アプリあたりの読み込み件数に上限(既定5000件)を設けています。突合履歴の行数にも上限(既定20件)を設け、kintone公式の「1つのテーブルに大量の行を追加しない」という注意事項に対応しています。
- 運用上の注意: 突合結果のJSONには対象者の突合キーと氏名が含まれます。集計アプリのアクセス権は、閲覧してよい担当者だけに絞ってください。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
API実行数について
「突合を実行」ボタンを押すたびに、基準アプリと各対象アプリからレコードを取得します。 レコード取得は1回のAPIで最大500件のため、API実行数はおおよそ (基準アプリの件数 ÷ 500) + Σ(対象アプリの件数 ÷ 500) + 3 回です (末尾の3回は、結果JSONのアップロード・集計アプリのレコード取得・レコード更新)。 たとえば基準アプリ1,200件・対象アプリ2つが各800件の場合、1回の実行で約10回のAPIを消費します。 自動実行は行わないため、ボタンを押さない限りAPIは消費しません。
制限事項
- 突合キーは1つのフィールドの完全一致のみです。「氏名＋生年月日」のような複合キーや、表記ゆれ(全角/半角、旧字体)の吸収はしていません。共通のID項目を持たない運用ではご利用いただけません。
- 対象者の母集団は基準アプリです。対象アプリにしか存在しない人は一覧に表示されません。
- 実行は手動のボタン操作のみです(kintoneプラグインから定期自動実行はできません)。
- 突合設定は「突合設定(自動生成・編集不要)」フィールドにJSONで保存されます。この欄を手で書き換えると設定が壊れる可能性があるため、フォームから隠すか閲覧のみにしておくことをおすすめします。
- 実行直後、結果一覧はすぐ更新されますが、レコード上の「突合履歴」テーブルの表示は画面を再読み込みするまで更新されません(その旨を画面に表示します)。
- 画面に一度に表示するのは500行までです。それを超える場合はCSVでダウンロードしてください。
- モバイル表示には対応していません。