添付ファイル一括ダウンロードプラグイン

kintone で添付ファイルを扱う際、以下のような課題に直面したことはないでしょうか。

• レコードに添付された複数のファイルを1つずつダウンロードしなければならない
• 一覧画面から複数レコードのファイルをまとめて取得する方法がない
• ファイルのダウンロードに何度もクリックが必要で、業務効率が悪い

当プラグインを使用することで、ワンクリックで複数の添付ファイルを ZIP ファイルにまとめてダウンロードできます。

一覧画面では絞り込まれた全レコードのファイルを一括ダウンロード、詳細画面では表示中のレコードのファイルをまとめてダウンロードすることが可能です。

ソースコードは全て GitHub に公開しており、無料で利用できます。

プラグインが提供する機能

ZIP ファイルによる一括ダウンロード

添付ファイルフィールドに保存されたファイルを、自動的に ZIP ファイルにまとめてダウンロードします。複数の添付ファイルフィールドを対象にできるため、1つのレコードに複数のファイルフィールドがある場合でも、まとめてダウンロードできます。

サブテーブル内のフィールドにも対応

通常の添付ファイルフィールドだけでなく、サブテーブル内に配置された添付ファイルフィールドにも対応しています。設定画面では「サブテーブル名 > フィールド名」の形式で表示されるため、直感的に選択できます。

3 箇所から選択可能なボタン配置

ダウンロードボタンは、以下の 3 つの場所に設置できます。

業務フローに合わせて、最適な場所にボタンを配置できます。また、複数の条件を設定することで、異なる場所に異なる設定のボタンを同時に配置することも可能です。

カスタマイズ可能な ZIP ファイル名

ダウンロードする ZIP ファイルの名前は、テンプレート変数を使って自由にカスタマイズできます。

例えば、{{appName}}_{{date:yyyy-MM-dd}} と設定すると、「顧客管理_2025-03-15.zip」というファイル名でダウンロードされます。日付フォーマットには date-fns の書式が利用可能で、yyyy-MM-dd HH-mm のような詳細な指定も可能です。

ファイル名の重複自動回避

同じファイル名のファイルが複数存在する場合、自動的に連番を付与して重複を回避します。

例: 報告書.pdf、報告書 (1).pdf、報告書 (2).pdf

ダウンロード中の進捗表示

一覧画面から大量のファイルをダウンロードする場合、レコードの取得状況やファイルのダウンロード進捗がオーバーレイで表示されます。処理の進行状況を確認しながら安心して待つことができます。

多言語対応

日本語、英語、スペイン語、中国語（簡体字・繁体字）、ポルトガル語（ブラジル）、タイ語の 7 言語に対応しています。kintone の言語設定に応じて、プラグインの UI が自動的に切り替わります。

プラグインが活きるシーン

請求書や契約書の一括取得

月末処理などで大量の添付ファイルをダウンロードする必要がある場合、一覧画面のフィルターと組み合わせることで、必要なファイルだけを効率的に取得できます。

プロジェクト資料の一括バックアップ

レコードに添付された設計書、議事録、仕様書などのプロジェクト関連資料を、ZIP ファイルとして一括でバックアップできます。

写真や画像の一括ダウンロード

現場写真や製品画像など、大量の画像ファイルが添付されているアプリで、必要な画像を素早くまとめてダウンロードできます。

設定手順

1. プラグインの設定画面を開く

アプリの設定 → プラグインから、「添付ファイル一括ダウンロードプラグイン」の設定画面を開きます。

2. ボタンのラベルを設定する

ダウンロードボタンに表示するテキストを入力します。未入力の場合は「一括ダウンロード」がデフォルトで表示されます。

3. 添付ファイルフィールドを選択する

ダウンロード対象となる添付ファイルフィールドを選択します。「フィールドを追加する」ボタンから複数のフィールドを追加できます。サブテーブル内のフィールドも選択可能です。

4. ボタンの設置場所を選択する

以下の 3 つから、ボタンを表示する場所を選択します。

• 一覧画面のヘッダー: 一覧画面に表示され、絞り込まれた全レコードのファイルをダウンロード
• レコード詳細画面のヘッダー: レコード詳細画面に表示され、そのレコードのファイルをダウンロード
• スペースフィールド: レコード詳細・編集画面のスペースフィールドにボタンを配置

「スペースフィールド」を選択した場合は、追加で表示されるドロップダウンからスペースフィールドの ID を選択してください。

5. ZIP ファイル名を設定する

ダウンロードする ZIP ファイルの名前を設定します。テンプレート変数を使用して、動的なファイル名を設定することもできます。.zip の拡張子は自動的に付与されます。

6. 設定を保存する

フッターの「保存」ボタンをクリックして設定を保存します。

API の使用回数について

一覧画面から一括ダウンロードを実行する場合、対象レコードの取得と添付ファイルのダウンロードで API を使用します。

• レコード取得: アプリ内のレコード数に応じて API を消費します（500 件ごとに 1 リクエスト）
• ファイルダウンロード: 添付ファイル 1 件ごとに 1 リクエスト

お問い合わせ

プラグインの不具合や、機能追加のご要望などがあれば、画面上部のナビバーからお問い合わせください。

プラグインのソースコード

本プラグインはオープンソースです。 ソースコードは GitHub で公開されており、どなたでも自由に確認できます。

詳細な実装内容や構成に興味がある方は、ページトップの「ソースコードを確認する」ボタンからリポジトリにアクセスしてください。