← ブログ一覧へ

添付・プレビュー

kintoneの添付ファイル・画像を詳細画面で見やすく表示する方法

現場の写真、見積書、申込書など、kintone のレコードに添付ファイルを溜めていくと「ファイル名だけ並んでいて中身が分かりにくい」「画像なのにサムネイルが出ないので1件ずつ開くしかない」という不満が出てきます。この記事では、標準の添付フィールドでできることの限界と、添付ファイルや画像を詳細画面で見やすく一覧表示する方法を整理します。

標準の添付フィールドの限界

kintone の添付ファイルフィールドは、アップロードしたファイルをファイル名のリンクとして縦に並べる表示です。シンプルで分かりやすい反面、いくつか確認作業がもたつく場面があります。

• サムネイルが出ない: 画像を添付してもファイル名のテキストだけが並び、どの写真かは開くまで分かりません。
• 一覧で中身が見えない: レコード一覧では「添付あり」が分かる程度で、何枚あるか・どんな画像かまでは把握しづらいです。
• 複数フィールドが散らばる: 「現場写真」「見積PDF」のように添付フィールドを分けると、確認のたびに離れた場所を見比べることになります。

写真を多用する工事・点検・小売や、書類を添える申請・契約の業務では、この「1件ずつ開く」「あちこち見る」の積み重ねが地味な負担になります。

添付を詳細画面のパネルに一覧表示する

解決策はシンプルで、詳細画面に「添付をまとめて見やすく並べるパネル」を追加することです。添付ファイル表示プラグイン（Attachment Viewer）は、指定した添付フィールドのファイルを集めて、詳細画面の専用パネルにグリッドで表示します。

• 画像はサムネイル: 画像ファイルはサムネイル付きのカードで並ぶので、写真の中身を開かずに見渡せます。
• 画像以外もファイル名で一覧: PDF や Excel などはファイル名のリンクとして表示され、項目名・種類・サイズもあわせて確認できます。
• 複数フィールドを1か所に: 「現場写真」「見積PDF」など複数の添付フィールドを指定すれば、ひとつのパネルにまとめて並べられます。
• 添付がないときの表示も指定: 添付ゼロのときに出すメッセージを設定でき、空のレコードでも見え方が安定します。

動くのは詳細画面（レコード表示時）です。設定は、見せたい添付フィールドのフィールドコードをカンマ区切りで指定し、サムネイルの大きさ（例: md）と、添付が無いときのメッセージを決めるだけ。初期設定はおおむね4分前後で、難しいコードは書きません。

このプラグインが向かないケース（正直なところ）

万能ではありません。次のような用途には向かないので、期待値を合わせておくのが大事です。

• PDFの埋め込みプレビュー: PDF の中身を画面内に展開して読む機能はありません。ファイル名のリンクから開く形です。
• Officeファイルの画面内閲覧: Excel や Word をその場で表示する機能はありません。
• アップロード／削除の代替: 添付の追加・削除は標準のフィールドで行います。本プラグインは「見やすく表示する」ことに特化しています。

あくまで「詳細画面で添付を素早く確認する」のが得意分野です。PDFを読み込んで注釈を付けたい、ファイル管理そのものを置き換えたい、という要件には別の手段を検討してください。

あわせて読みたい

レコードに紐づく情報の見せ方を整えるなら、関連レコードの一覧表示もよく合わせて使われます。一覧画面そのものの操作性を上げたいときは、一覧でのインライン編集の記事も参考になります。表示まわりを少しずつ整えるだけで、日々の確認作業はかなり軽くなります。