ファイル・添付 ・ 導入ガイド
添付ファイル表示プラグイン
Attachment Viewer
現場のこんな時に添付ファイル欄がアプリ内に散らばっていて、写真や見積書を毎回スクロールして探すのが手間な時。
あちこちに散らばった添付ファイルを、詳細画面の上部に1つのギャラリーにまとめて表示します。
社内稟議・上長への共有には、製品概要(PDF・1枚/印刷対応)をご利用ください。
kintone 標準の添付欄と何が違う?
kintone 標準でも画像サムネイルやダウンロードは出ます。違いは「散らばった複数の添付欄を1か所にまとめて見せる」ことと、PDF をその場でプレビューできること。添付欄が多いアプリほど効きます。
- 添付欄ごとにフォーム上の別々の位置に並ぶので、複数あると毎回スクロールして探す
- PDF は一度ダウンロードして開かないと中身を確認できない
- スマートフォンでも添付欄がフォーム上に散らばり、写真をまとめて確認しづらい
- どの欄に何が入っているかを一覧で見比べる導線がない
- 指定した複数の添付欄を横断し、詳細画面の上部に1つのギャラリーとして集約
- PDF はその場でプレビュー、画像はサムネイルをクリックで拡大表示
- 設定でモバイル表示用スペースを指定すれば、スマートフォンでも同じギャラリーをまとめて表示できる
- 非画像は名前と種別で整理。ダウンロードもパネル内から行えます
同じ目的の製品を探す方へ:一覧・ビュー拡張のkintoneプラグイン比較(価格・無料枠・試用を公式情報で確認)
概要
添付ファイル表示プラグインは、添付ファイルフィールドの中身を詳細画面でまとまりよく表示するためのプラグインです。標準の添付欄だけだと見分けにくいファイルを、画像サムネイルとファイル名リンクで整理して確認しやすくします。
写真、見積書、申込書のように、まず見て判別したい添付が多いアプリで、ファイルを一個ずつ開かなくても詳細画面の中で素早く中身を確認できるようにするのが狙いです。
できること
指定した添付ファイルフィールドを集めて、詳細画面の上部に専用ビューアーパネルとして表示します。
画像は小さなサムネイルで中身を判別しやすくし、どの添付欄に何が入っているかをひと目で把握できます。
PDF は「プレビュー」ボタンから詳細画面内で開けます。ダウンロードせずに中身を確認でき、画像サムネイルもクリックで拡大表示します。
その他の非画像ファイルはファイル名と種別を並べて表示し、そのまま kintone 標準のダウンロードへつなぎます。
実際の画面でできることを確認
向いている場面
- 写真、見積書、申込書など添付の確認を詳細画面内で早く済ませる
- 現場写真や契約関連、申請時の証跡ファイルをまず見て判別する
- どの添付欄に何が入っているかを一覧的に把握する
- Excel・Word など Office ファイルを画面内で閲覧したい
- アップロードや削除までこのプラグインで行いたい
- PDF に注釈を書き込む・編集まで行いたい
導入手順
はじめてでも迷わないよう、ダウンロードから動作確認までを順に説明します(所要 初期設定 4分前後)。
- 署名付き ZIP をダウンロード:上の「ダウンロード」から署名付き ZIP を保存します。
- kintone にプラグインを読み込む:kintone 画面右上の歯車から「kintone システム管理」→「プラグイン」を開き、「読み込む」で保存した ZIP をアップロードします。これでドメインにプラグインが登録されます。

kintone システム管理:プラグインの読み込み画面 画像を原寸で開く - 使いたいアプリに追加する:対象アプリを開き、「アプリの設定」→「プラグイン」→「プラグインを追加」で「添付ファイル表示プラグイン」を選びます。

アプリ設定:プラグインを追加 画像を原寸で開く - プラグインを設定する:追加した「添付ファイル表示プラグイン」の設定(歯車アイコン)を開き、項目を設定して「保存」します。
設定のポイント:表示したい添付ファイル欄(写真・見積書など)をチェックで選び、未登録時の案内文を「添付ファイルはまだありません」にする。
設定画面:表示する添付ファイルの項目をチェックで選ぶ(フィールドコード不要) 画像を原寸で開く - アプリを更新して反映する:アプリ右上の「アプリを更新」を必ずクリックします(更新しないと変更が反映されません)。
- 動作を確認する(サンプル検証):詳細画面を開くと詳細表示時にプラグインが動きます。テスト用のアプリ/レコードで「添付ファイル欄がアプリ内に散らばっていて、写真や見積書を毎回スクロールして探すのが手間な時」を実際に試し、想定どおり動くか確認しましょう。
無料プランでは各プラグインを 1アプリまでお試しいただけます(プラグインが動作する画面の上部に小さな「Plumeru 提供」クレジットが表示されます。Pro では非表示)。うまく動かない時は、対象の項目の指定と、「アプリを更新」を実行済みかをご確認ください。
うまく動かない・不具合の通報
添付ファイル表示プラグインがこのガイドの説明どおりに動かない、または不具合を見つけた場合は、こちらからお知らせください。内容を確認し、できるだけ早く修正します。
不具合を通報する仕様メモと制限
- 詳細画面を開くと、画面の上部に添付ファイルの閲覧パネルを表示します(スマートフォンでも、設定の「モバイル表示用スペースの要素ID」を指定すれば、その位置に表示できます)
- 表示するのは、設定で選んだ添付ファイルの項目だけです。設定画面には添付ファイルの項目だけが並びます
- PDFは画面内でそのままプレビュー、画像はサムネイル表示+クリックで拡大できます。設定は、表示する添付ファイルの項目・添付が無いときの案内文・(任意で)モバイル表示用スペースの要素IDです
- 通信できないときも、kintoneの動作を妨げません(機能はそのまま動作します)
- 閲覧専用です。アップロード・削除・差し替えはせず、kintone標準の添付欄で行います
- 画面内でプレビューできるのはPDFと画像だけです。Officeファイル・動画などはダウンロードリンクのみ表示します
- 詳細画面でのみ表示します。一覧・追加・編集画面には出ません
- 表(サブテーブル)の中の添付ファイル欄は対象外です
- 添付が多いレコードでは、最初の表示に少し時間がかかることがあります
変更履歴
- レコード詳細画面で、添付ファイル一覧の上下にページ背景のグレーが細い帯状に露出することがある表示上の問題を修正しました。動作は変わりません。
- 設定画面で対象項目の候補が多いとき、項目名を検索してチェックできるようにしました。
過去の変更履歴を表示(残り42件)
- トライアル残日数を確認できない画面で「残り0日」と誤表示される問題を修正しました。
- お知らせ表示と設定画面の一部の色をPlumeru共通のブランド配色に統一しました。動作は変わりません。
- ボタンなどの緑色をPlumeru共通のブランド色に統一しました。見た目のみの変更で、動作は変わりません。
- 設定画面の項目選択プルダウンの幅を、選択肢の項目名の長さに合わせて自動で広げるようにしました(これまで一律幅のため、画面に余白があっても長い項目名が「…」に省略されることがありました)。設定画面のみの変更で、通常画面の動作は変わりません。
- 設定画面の項目選択プルダウンで、長い項目名が途中で切れて読めないことがある問題を修正しました(候補一覧を項目名の長さに合わせて広げるほか、選択中の値は末尾を「…」で省略しつつマウスオーバーで全文を表示します)。設定画面のみの変更で、通常画面の動作は変わりません。
- 設定画面のプラン表示を正確にしました(Pro・トライアル契約中でも「Plumeru Free」と表示されることがあった問題の修正。トライアル中は残り日数も表示)。管理者向け表示のみで、通常画面の動作は変わりません。
- ライセンス状態の表示名を修正(無料時に「Pro」と出ていた設定画面・ヘッダーの表示を「Free」等の正しい名称へ。管理者向け表示のみで、通常画面の動作は変わりません)。
- 添付ファイルの取得を効率化しました。PDF・その他ファイルは「プレビュー/ダウンロードを押したとき」に取得するようにし、詳細画面を開くたびに全ファイルを取得しなくなりました。kintone APIリクエスト数を大幅に削減します(画像のサムネイル表示など見た目・操作は変わりません)。
- 設定画面に、新しい版が公開されているときのお知らせを表示するようにしました(管理者向け。通常画面の動作は変わりません)。
- プラグインの説明文を、機能がより伝わるように書き直しました(動作の変更はありません)。
- 設定画面で項目(プルダウン)を選ぶとき、選択肢が多い場合は名前の一部を入力して絞り込めるようにしました(部分一致の検索付き)。選択肢が少ないものは従来どおりです。
- 設定画面のデザインを共通ベースへ統一(ブランド差し色の保存ボタン・全操作要素のフォーカス表示・入力欄やメッセージの体裁を全プラグインで揃える)。
- ライセンス判定をsessionStorage短TTLキャッシュ+裏リフレッシュ化。
- 設定画面の文言を統一・是正。
- 監査対応の内部改善(設定の保存ガード・削除項目の扱い・日時/選択肢比較・アクセシビリティ・モバイルでの無料枠通知・仕様表記の整合など)。
- 無料枠の判定通信にドメイン単位の照合トークンを導入し、なりすましによる無料枠の横取りを防止しました(内部改善)。
- ライセンス通知の表示処理を安全側に見直しました(無料枠の対象アプリ名表示を含む内部改善)。
- 通知やボタン・確認ダイアログの文言で、数字と単位(日・件)の間の不要な空白を除去し表記を統一しました。
- 設定画面の下部に、機能の改善要望・不具合報告をその場から送れるリンクを追加しました。
- 画面上部のお知らせ・提供クレジットの文字色を濃くし、読みやすさを改善しました。
- 画面の端に密着していた表示を、左右に余白を取って表示するよう修正しました。
- 無料プランの上限に達したとき、いま有効になっているアプリ(app番号・リンク付き)をお知らせに表示し、仕組みを説明する詳細ページへのリンクを追加しました。
- レコードを前後に切り替えた直後に、切替前のレコードの添付ファイルが表示されたままになることがある問題を修正しました。
- プレビューを開いたままレコードを切り替えたときに、プレビューが画面に残る問題を修正しました。
- 設定画面で項目の読込完了前に保存すると設定が消えることがある問題を修正しました。
- ライセンス確認の通信が応答しない場合でも画面表示を待たせないよう、5秒で通常動作へ切り替えるようにしました(判定できない場合は従来どおり全機能が動作します)。
- 複数の Plumeru プラグインを同じアプリで使っている場合に、無料プラン上限のお知らせが表示されないことがある問題を修正し、どのプラグインのお知らせか分かるようプラグイン名を併記するようにしました。
- 想定外のエラーを匿名で通知する仕組みを追加しました(表示は妨げません)。
- kintone に表示されるプラグイン名を、サイトのカタログ表記(日本語名)に統一しました。
- 設定画面のタイトル・見出しをカタログの名称に合わせました。
- PDFプレビューでブラウザ内蔵ビューアのツールバー(印刷・注釈・Drive保存など)を非表示にし、閲覧に絞るよう変更(印刷したい場合は元ファイルをダウンロードしてください)
- サムネイルの大きさの設定を廃止し、標準の大きさ(中)に統一(表示の違いが分かりにくかったため簡素化)
- ライセンス通知(無料プランのクレジット)の文言を「Plumeru 提供」に統一し、レコード画面上部の余白を調整して表示を整えました。
- レコード画面(詳細・編集・新規)のライセンス通知(トライアル残日数・クレジット)が左端に寄っていた表示を、本文に合わせて左余白を付けて整列するよう修正
- 添付ファイルが多いレコードでファイルを一気に取得しすぎないよう、同時取得数を抑えるよう改善(kintone の同時リクエスト上限への保険)。表示や順序は変わりません。
- モバイル表示でも無料プランのアプリ数制限が正しく判定されるよう修正(ライセンス確認をモバイル画面に対応)
- プラグインの不具合を早期に検知するため、エラー発生時に診断情報(エラー種別など)を送信する仕組みを追加(kintone のレコードの中身などの業務データは送信しません)
- 設定画面の Pro 案内から固定のプラグイン数表記を撤廃し、数字に依存しない表現に変更
- スマートフォンの kintone でも添付ファイルを表示できるよう対応(設定の「モバイル表示用スペースの要素ID」に、フォームに置いたスペースの要素IDを入れると、その位置に表示します)
- ライセンス確認時に、操作した kintone ユーザーのメールアドレスをサーバーへ送信しないよう変更(不要な個人情報の送信を停止)
- 添付プレビューを表示したあとのメモリを解放し、詳細画面を開くたびにメモリ使用量が増える問題を修正
- 設定画面の Pro 案内の文言を、当時の提供範囲が伝わる表現に調整
- 設定画面の項目選択から補助のフィールドコード表示を撤去(項目名だけで選べるように)
- PDF を詳細画面内でプレビュー表示できる機能を追加(ダウンロード不要で中身を確認)
- 画像サムネイルをクリックで拡大プレビューできるように
- 添付画像のサムネイル/ダウンロードが表示されない不具合を修正(ファイル取得に必要なヘッダーを付与)
- 設定画面をフィールドコード手入力から「項目名で選ぶ」方式に刷新
- 設定画面の Pro アップグレード案内が kintone の固定ヘッダーに隠れる不具合を修正
- Pro アップグレード導線を設定画面に集約
- トライアル残日数の一覧通知を終盤のみ表示に軽量化
- 無料プランでは動作画面の上部に Plumeru クレジットを表示(Pro プランは非表示)
- Plumeru 版の初回公開
- 添付ファイル専用ビューアーを詳細画面へ追加
- 署名付き ZIP 配布と解説ページを整備