導入ガイド

添付ファイル表示プラグイン

Attachment Viewer

添付ファイルを詳細画面の専用パネルで見やすく表示するオリジナル実装。

向いているケース 写真、見積書、申込書など、添付ファイルの確認を詳細画面内で早くしたい時。
向いている画面 詳細画面
動くタイミング 詳細表示時
導入目安 初期設定 4分前後

概要

Attachment Viewer は、添付ファイルフィールドの中身を詳細画面でまとまりよく表示するためのプラグインです。標準の添付欄だけだと見分けにくいファイルを、画像サムネイルとファイル名リンクで整理して確認しやすくします。

できること

指定した添付ファイルフィールドを集めて、詳細画面の上部に専用ビューアーパネルとして表示します。

画像は小さなサムネイルで中身を判別しやすくし、非画像はファイル名と種別を並べて標準ダウンロードへつなぎます。

向いている場面

現場写真、契約関連の添付、申請時の証跡ファイルみたいに、まず見て判別したい添付が多いアプリで使いやすいです。

ファイルを一個ずつ開いて確認するのがだるい運用や、どの添付欄に何が入っているかをすぐ把握したい詳細画面に向いています。

設定項目

attachmentFieldCodes: 表示対象の添付ファイルフィールドコード

thumbnailSize: サムネイルサイズ。sm md lg から選びます。

emptyMessage: ファイル未登録時の案内文

おすすめ設定例

attachmentFieldCodessite_photos,estimate_pdf,completion_files を入れておくと、写真と帳票をひとつの確認導線にまとめられます。

thumbnailSize は、スマホ確認も多いなら smmd、写真判別を優先するなら lg が使いやすいです。

仕様メモ

詳細画面でだけ動作し、指定フィールドに入っているファイル情報を読み出して表示します。ダウンロード自体は kintone 標準の URL を使います。

制限

PDF や Office ファイルを画面内に埋め込むところまではまだやりません。非画像は名前と種別で扱います。

アップロードや削除機能も持たせていないので、役割はあくまで「見やすくするビューアー」に限定しています。

導入手順

1. ZIPをダウンロード

2. kintone のプラグイン管理で読み込み

3. 対象アプリへ追加

4. 表示対象の添付ファイルフィールドを設定

5. 詳細画面でサムネイルとリンク表示を確認

ダウンロード

固定バージョンとエイリアスを分けて公開しています。通常導入は Stable、先行確認は Latest を使います。

固定URL: 固定URLを開く

変更履歴

v1.0.0 2026-05-21
  • Plumeru 版の初回公開
  • 添付ファイル専用ビューアーを詳細画面へ追加
  • 署名付き ZIP 配布と解説ページを整備