# ResoArc: kintoneプラグイン第二波4製品 導入・移行ガイド

2026-10-19 / MIT License / ResoArc Open Technology Project

## 正式版の対象

| 製品 | 版 | 概要 |
|---|---|---|
| CSVワンクリック出力 | v0.1.5 | 現在表示中の一覧レコードをCSVに変換・保存 |
| ルックアップ候補表示 | v0.1.5 | 候補の検索と選択を補助。入力値は自動保存しない |
| 一覧合計バー | v0.1.4 | 現在表示中の一覧レコードについて数値の合計を表示 |
| 添付ファイル有無表示 | v0.1.4 | 閲覧可能な添付情報を使い、行ごとの有無/件数を表示 |

## 新規導入

1. 利用中のアプリのデータ・設定をバックアップし、検証用アプリで先に動作確認します。
2. ダウンロードした**署名付きZIPを解凍せず**、kintoneシステム管理の「プラグインを追加」で読み込みます。
3. 対象アプリの設定画面でプラグインを追加し、それぞれの「プラグインの設定」で対象フィールド等を指定します。
4. 設定を保存後、アプリの設定を更新して運用画面に反映します。
5. PCとスマートフォン用ブラウザーモードで、正常系と必要なエラー系を確認します。

## 製品ごとの確認

- **CSVワンクリック出力**：出力対象フィールドコード、ファイル名などを設定。**現在表示中の一覧ページだけ**を出力し、別ページや全件の自動取得はしません。CSVの先頭セルに数式として評価される文字列を含める際は、出力ファイル側で安全化されることを検証。CSVは機密データを含む可能性があるため送信先に注意。
- **ルックアップ候補表示**：候補を検索する対象アプリ・フィールドの参照権限を確認。候補を選ぶと未保存の入力値へ反映します。**200件で打ち切るフォールバック**があり、候補の網羅性は保証しません。
- **一覧合計バー**：数値フィールドを指定し、現在の表示ページだけを集計します。閲覧できないフィールドがあれば0件と誤表示せず集計を中止します。会計帳票など、全データに対する正式な合計に使用しないでください。
- **添付ファイル有無表示**：添付フィールドを指定。現在閲覧できる一覧データ上の添付情報を表示します。添付ファイル本体を取得・転送しません。非権限・不在の列は件数0と推定せず取得不可と表示します。

## 旧α・β版からの移行（重要）

旧版と新シリーズの**プラグイン署名IDは一致するとは限りません**。上書き更新を期待せず、旧プラグインの設定を控えた上で、旧版を無効化し、新製品ZIPを別プラグインとして登録・設定・検証してから旧版を削除してください。競合する同種プラグインを同時に有効化しないでください。

## 対応・検証と保証しない範囲

隔離した実kintone QAアプリ58でPC・ブラウザースマートフォンモードを検証済み。物理iPhone/Android固有ブラウザー、ゲストスペースのすべての動作、実アカウント別権限ロール、全件・大量件数の取得、サイボウズ公式認定は保証しません。403拒否の一部試験は模擬によるものです。各製品の入力・表示結果は利用者の権限と一覧設定に依存します。

## アンインストール

対象アプリのプラグイン設定を解除しアプリ更新後にシステム管理から不要なプラグインを削除してください。CSVのダウンロード済みファイルは別途管理してください。

## 権利表示と配布範囲

MIT LICENSEと別添NOTICEを参照してください。ResoArcはサイボウズ公式開発元ではありません。