特定フィールド一括更新プラグイン（無料）

一覧画面で条件を絞り込んだ状態でボタンを押すと、その絞り込み条件に一致するレコードだけが更新対象になります。確認ダイアログには絞り込み条件と対象件数が表示されるため、意図した範囲であることを確認してから実行できます。ステータスの一括変更、キャンペーン対象レコードへのフラグ一括付与など、条件に応じた一括編集作業に使えます。

設定画面で実行可能グループを指定すると、一覧画面のボタン自体を特定グループのメンバーにだけ表示できます(ただし表示・非表示の切り替えに過ぎず、実際の書き込み可否はアプリ・フィールドのアクセス権設定に依存します)。また、対象フィールドがフォームで必須に設定されている場合、確認ダイアログでの入力も必須になるため、必須項目を空欄のまま一括更新してしまうミスを防げます。

対象フィールドにルックアップフィールドを指定すると、確認ダイアログには値の入力欄が出ず、「現在の値のまま更新します」という注記だけが表示されます。実行すると、対象レコードのルックアップフィールドがそのままの値で書き戻され、kintone側の自動転記が再実行されて、コピー先フィールドが参照先アプリの最新の値へ一括で更新されます。参照先アプリのデータを更新したあと、こちら側のコピー先フィールドが古いままになっているレコードをまとめて最新化したい場合に使えます。

kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。

• 対象レコードの列挙にはレコードカーソルAPI(POST/GET /k/v1/records/cursor.json)を使い、書き戻しはPUT /k/v1/records.jsonを100件ずつのバッチで送信します。バッチ全体が失敗した場合のみ1件ずつの個別送信にフォールバックし、リビジョン競合(他ユーザーによる同時編集)が起きたレコードだけをスキップして他のレコードの処理は継続します。REST API呼び出しはすべてkintone.api()(kintone自身への呼び出し専用の内部ラッパー)経由で、外部サーバーへの通信は一切行いません。
• 対象フィールドの一覧取得・絞り込み条件の取得は、いずれもREST APIではなくkintone.app.getFormFields()/kintone.app.getQueryCondition()のJavaScript APIを使用しています。
• 書き込む値は設定画面には一切保存されません。実行のたびに確認ダイアログへ入力し、その場でPUT APIへ渡すだけで完結します。
• 選択肢系フィールド(ラジオボタン・ドロップダウン)はkintoneのREST API仕様上、空文字列を指定しても明示的に空にはできない(初期値が設定されてしまう)ため、常に選択肢の中から値を選ばせる仕様にしています。対象フィールドがフォームで必須の場合は、確認ダイアログでの入力も必須にし、空欄のまま実行しようとするとダイアログを閉じさせずエラー表示します。
• 確認ダイアログで「更新する」チェックを外したフィールドはPUT APIのリクエストに含めず、既存の値をそのまま残します(書き込み対象から完全に除外するだけで、値を明示的に上書きするような処理は行いません)。また、実際の書き戻しの前に確定した値を見直せる最終確認ダイアログをもう1段階挟んでいます。
• 実行可能グループによる一覧画面ボタンの表示制御(kintone.user.getGroups())は、あくまでUI上の表示・非表示を切り替える機能であり、真の権限境界ではありません。実際に書き込みできるかどうかは、対象アプリ・対象フィールド自体のkintone標準のアクセス権設定に委ねられます(設定画面にも明記しています)。
• 確認ダイアログの本文・入力欄はすべてtextContent/createElementのみで組み立てており、ユーザー入力(絞り込み条件・書き込む値)をHTML要素として出力することはありません。
• ルックアップの「ほかのフィールドのコピー」設定でコピー先に指定されているフィールド(通常のフィールドと同じ型で表示されるため見分けにくいですが、ルックアップ実行時に自動上書きされるフィールドです)は一括更新の対象から除外しています。ルックアップフィールド自体は対象にできますが、確認ダイアログには値の入力欄を出さず、レコードごとに自分自身の現在値をそのまま書き戻すことでコピー先フィールドの自動転記だけを再実行させる仕様にしており、任意の値を書き込めるわけではありません。

詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。

→ security-checklist.md をGitHubで見る