一覧出力プラグイン

こんな困りごとに

• 一覧をCSVで書き出した後、毎回Excelの罫線や見出しを整えている。
• 現在の一覧条件に合う案件や売上を、決まった様式で提出したい。
• 全件と表示中のページを使い分け、ExcelとPDFの両方で共有したい。

標準のCSV書き出しに対し、本プラグインはExcelテンプレートへ値を差し込む用途です。利用者が閲覧できるレコード・フィールドの範囲で動作します。

本プラグインの特長

利用画面：一覧から出力

保存した設定はアプリを更新すると反映されます。一覧画面で絞り込み・並び順を確認し、「一覧を出力」を押してください。形式選択の設定ならExcel／PDFを選びます。対象が0件の場合は空のダミー行を作らず、出力を中止します。

設定画面・基本的な使い方

1. アプリへ追加する

   無料ZIPをkintoneのプラグイン管理から読み込み、出力したいアプリへ追加します。

2. テンプレートを登録する

   通常の.xlsxに差し込み記号を記入し、帳票名とテンプレートを設定します。用途ごとに帳票を追加・複製できます。

出力対象と形式を選ぶ

• 一覧の条件に一致する全レコード：表示ページをまたいで取得します。上限は10,000件です。
• 表示中のページのみ：一覧表示時に取得した、そのページのレコードを使います。カスタマイズ一覧ではこの方式に対応しないため、全レコードを選択してください。
• 出力形式：Excel（.xlsx）／PDF（.pdf）／出力時にExcel／PDFを選択の3種類です。
• PDF対象シート：空欄で先頭、シート名で指定シート、*で全シートを対象にします。

ボタン名・ファイル名・複数値の区切り・モバイルでのボタン表示も帳票ごとに設定します。ファイル名には一覧情報の専用記号を使用し、拡張子.xlsx／.pdfは自動で付きます。

必要に応じて追加条件を設定する

「出力レコードの追加条件」は、取得した一覧レコードから出力対象をさらに絞る設定です。まず、テーブル外の項目で条件を作り、AND／ORで結合してください。

条件未設定なら、一覧の出力対象をすべて出力します。ただし、ボタン自体の表示やアクセス権を変更する設定ではありません。

設定を保存し、アプリを更新します。まず少数のレコードで、出力対象・順序・金額・改ページを確認してから運用してください。

差し込み記号の書き方

以下は記法の例です。宛名や合計金額などは、実際のアプリのフィールドコードへ置き換えてください。通常のレコードの記号は同じExcel行へ並べます。

A2：$(#)
B2：$(宛名)
C2：$(合計金額)

この行をレコード数分繰り返します。$(#)は1から始まる出力行番号です。通常のレコードの記号を見出し・集計欄へ置くと、その行も繰り返し対象になります。複数行を1レコードのブロックとして繰り返す記法はありません。

テーブルと一覧情報の記号

• $(見積明細.商品名)：各レコードのテーブル列の値を改行して1セルにまとめます。テーブル明細を行ごとに展開する用途ではありません。
• $(見積明細)：テーブルの各行を文字列にまとめます。
• $(#件数)：追加条件適用後の出力件数。
• $(#一覧名)／$(#アプリID)／$(#出力日)：一覧名・アプリID・日本時間の出力日。

一覧情報の専用記号は見出し・集計欄・ファイル名にも使えます。ファイル名の例は$(#一覧名)_$(#出力日)です。個々のレコードのフィールドコードはファイル名に使用できません。

帳票出力プラグインとの使い分け

一覧の複数レコードを、1つの一覧表へまとめたい場合は「一覧出力プラグイン」を使用します。一覧の条件に一致する全レコード、または表示中のページを、Excelテンプレートの行へ繰り返し出力します。

1レコードから見積書・請求書などを作り、その中の明細テーブルを行展開したい場合は「帳票出力プラグイン」が適しています。どちらもExcel／PDF出力に対応しますが、出力単位とテーブルの扱いが異なります。

一覧出力では、各レコードのテーブル内の値は改行して1セルへまとめます。複数レコードそれぞれの見積書を一括で個別発行する機能ではありません。

仕様・利用前に確認すること

• バージョン：1.0.1／ListExport。無料で利用できます。
• 件数：一覧条件に一致する全レコードの取得は10,000件まで。上限判定は追加条件での絞り込みより前に行うため、多い場合は一覧側の条件を絞ってください。0件は出力しません。
• 容量：テンプレートは通常の.xlsx、1ファイル180KBまで。全帳票のテンプレート・設定合計は256KBまでです。同じテンプレートの複製は共通保存します。.xls／.xlsm・暗号化などは非対応です。
• 値の扱い：ユーザー・組織・グループは名称（なければコード）、添付ファイルはファイル名のみ。単独の数値・日付・日時の記号はExcelの型付きセルになります。日時は日本時間、テーブル内の値は文字列です。
• 権限：レコード・フィールドの閲覧権限を尊重します。差し込み項目が取得できない場合は出力を中止します。関連レコード一覧・グループ自体・添付ファイル実体の差し込みはありません。
• テンプレート：繰り返し行にまたがる縦結合、複数行を1レコードとして繰り返す設定は非対応。Excelテーブル・条件付き書式・入力規則・複数セルの共有／配列数式などにも制約があります。

数式の再計算

• 数式：Excel出力はExcelで開いたときに再計算します。PDFは基本演算・セル／シート参照とIF・IFS・SUM・SUMIF・ROUND・ROUNDUP・ROUNDDOWN・MIN・MAX・COUNT・COUNTA・ABS・AND・OR・NOTに対応。未対応の関数・構文や計算エラー、循環参照は出力を中止します。

PDFの形式・対応範囲

• PDFの形式：ブラウザー内で生成する画像ベースのPDFです。そのため、文字検索・コピーはできません。
• PDFの用紙・上限：A4／A3／A5／Letterに対応。最大50ページ・30,000セルまでです。
• PDFの再現範囲：印刷範囲・基本書式・内部PNG／JPEG画像に対応します。ただし、グラフ・図形・回転文字などは非対応です。印刷タイトル・Excelのヘッダー／フッターも反映しません。
• PDFの確認：フォントは利用端末に依存します。そのため、Excelの印刷結果と完全には一致しません。配布前に文字の見切れと改ページを確認してください。
• データ：レコードの追加・変更・削除は行いません。外部PDF変換サービスへレコードデータを送信しません。案内バナーの契約判定ではドメイン名とプラグイン名を送信します。

よくある質問

標準のCSV書き出しとは何が違いますか？

決まったExcelテンプレートの見出し・列幅・罫線などを使い、レコードを一覧表へ差し込むためのプラグインです。Excel／PDFで共有する書式を整えたいときに使います。

一覧の次のページにあるレコードも出力できますか？

「一覧の条件に一致する全レコード」を選ぶとページをまたいで取得します。上限10,000件以内に一覧条件を絞ってください。「表示中のページのみ」は、そのページに限定します。

1レコードにつき1枚の見積書を一括発行できますか？

本プラグインは複数レコードを1つの一覧表へ並べる用途です。個別帳票の一括発行機能はありません。1レコードの見積書や明細行を作る場合は帳票出力プラグインをご確認ください。

モバイルでも使えますか？

モバイルの一覧画面にも対応し、帳票ごとに出力ボタンの表示を設定できます。出力ファイルを開くアプリと、PDFのフォント・改ページを利用する端末で確認してください。

リリース・アップデート情報

【新着プラグイン】「一覧出力プラグイン」をリリースしました！

2026.10.142026.10.15

リリース・更新履歴一覧を見る

一覧出力の設定・運用を相談する

自社の集計・提出用の書式に合わせたテンプレートや、一覧条件・追加条件の設計をご相談いただけます。継続的な伴走支援は有償サポートプランをご確認ください。