# バッチ: グループ化、命名、ステータスのライフサイクル

> バッチとは、1回のアップロードで作成されたファイルのグループであり、処理・レビュー・エクスポートの単位です。このページでは、バッチ名の生成方法、各プランでバッチに保持できるファイル数、各ファイルステータスの意味、再処理・追加・削除の動作について説明します。

[**バッチ**](/docs/reference/glossary#batch)とは、1回のアップロードで作成されたファイルのグループであり、処理・レビュー・エクスポートの単位です。ダッシュボードからのアップロードはすべて独自の名前を持つバッチを開始し、その中のファイルはまとめて処理されます。

## バッチの対象となるもの

ダッシュボードでファイルを追加すると、それらは1つのバッチにまとめられ、**ファイル**の下に1つの折りたたみ可能なグループとして表示され、グループヘッダーにバッチ名が表示されます。そのヘッダーからバッチの処理、エクスポート、削除を行います。

- **1回のアップロードで1つのバッチが作成されます。**一緒に送信したファイルは同じバッチに入り、複数のPDFを一度に追加した場合、各PDFから選択したページはすべてその1つのバッチに含まれます。唯一の例外は、PDFを他のファイルと一緒に追加する場合です。PDFはページを選択するまで待機するため、そのページは独自のバッチを形成し、他のファイルは別のバッチを形成します（[ドキュメントのアップロード](/docs/guides/uploading-documents)を参照）。
- **各PDFページは独自のファイルです。**PDFはアップロード前にページに分割され、Word文書またはテキストファイルはページに変換されます。結果の各ページはバッチ内の1ファイルとしてカウントされ、個別に処理されます。そのファイルが生成する結果の行数は内容によって異なります（単一の値を含むページは1行、複数の項目をリストするページは項目ごとに1行を生成します）。
- **ファイルは正確に1つのバッチに属します。**ファイルは後でバッチ間で移動されず、後からバッチに追加することもできません（[バッチへのファイル追加](#adding-files)を参照）。
- **バッチは作成したアカウントに属します。**ファイルリストには、お客様のアカウントでアップロードまたは受信したバッチが表示されます。

## バッチ名の由来

バッチ名は自動的に生成されます。バッチ名を入力するフィールドや名前を変更する操作はありません。すべてのバッチは、アップロードが開始された時点で名前が付けられます。

バッチ名は `YYMMDD-XXXX` の形式です。

- `YYMMDD` — アップロードが開始された西暦の下2桁の年、月、日を表し、バッチの日付が一目でわかります。
- `XXXX` — 時刻から生成される4文字のコードで、数字と大文字を使用します。同じ日に異なる時間に開始された2つのバッチには、異なる名前が付けられます。

日付が名前に含まれているため、エクスポートダイアログでは今日のバッチに**今日**ラベルが表示され、ワンクリックでそれらのみを選択できます。同じ命名形式は、コレクションリンクまたはメール受信トレイから届いたバッチにも使用されます。

## 1つのバッチに含めることができるファイル数

各バッチには最大ファイル数があり、その上限はアカウントのプランによって異なります。チームメンバーは、個人のプランではなく、チーム所有者のプランによって制限されます。

| プラン | バッチあたりの最大ファイル数 |
| --- | --- |
| 無料（有料プランなし） | 利用可能な クレジット に基づく：クレジットが20以下の場合は20ファイル、その後はクレジット1につき1ファイルで最大100ファイルまで。クレジットが101〜400の場合は100ファイル、400を超える場合は200ファイル。 |
| ベーシックプラン | 100ファイル |
| プロプラン | 200ファイル |
| マックスプラン | 300ファイル |
| グロースチーム | 200ファイル |
| スケールチーム | 300ファイル |
| エンタープライズチーム | 500ファイル |

上限はアップロード数ではなくファイル数でカウントされます。また、1回のアップロードは1つのバッチのままです。40ページのPDFは40個の個別ファイルになりますが、すべて同じバッチに属するため、その1つのPDFは40個のバッチになるのではなく、そのバッチのファイル枠を40個消費します。（Word文書やテキストファイルも同様にカウントされます。変換後の各ページが1ファイルになります。）上限を超えるページ数を選択した場合、アプリは超過分のページが無視されることを警告します。バッチが上限を超える場合、アプリはアップロードを拒否し、バッチ上限を超えたことを報告して、プランのアップグレードを提案します。

これはバッチごとの上限のみです。アプリはまた、アカウントがすべてのバッチにわたって同時に保持できる未処理ファイルの総数にも上限を設けています。完全な表は[制限と仕様](/docs/reference/limits-and-specs)を、各プランの内容は[プランとクレジット](/docs/guides/plans-and-points)をご覧ください。

## バッチステータス一覧

バッチには単一のステータスはありません。各ファイルはファイルリスト内で独自のステータスタグを持ち、バッチヘッダーは該当する各状態の数 — **完了**、**レビュー済み**、**処理中**、**エラー**、**準備完了** — を合計ファイル数と進捗バーとともにまとめて表示します。

| 表示されるステータス | 意味 |
| --- | --- |
| アップロード中 | ファイルがまだサーバーに送信中です。Wordおよびテキストファイルの場合は、アップロードの一部としてサーバーが処理可能なページに変換するため、代わりに 変換中 が表示されます。 |
| アップロード済み | ファイルはサーバー上にあり、待機中です。まだ何も処理されていません。 |
| 待機中 | バッチの処理が開始され、ファイルがキューで待機中です。 |
| 処理中 | ファイルが現在処理されています。 |
| 完了 | 処理が終了し、結果を表示またはエクスポートできる状態です。 |
| レビュー済み | 結果が完成し、レビュー済みとしてマークされています。（レビュー後に値を編集すると、ファイルは 完了 に戻ります。） |
| エラー | このファイルの処理が失敗しました。バッチを再度処理して再試行できます。 |
| 受信中 | メール受信トレイまたはコレクションリンクから届いたファイルで、通常のキューに加わる前に準備が行われている状態です。 |

ファイルパネルの**ステータス**フィルターは、4つの主要な状態 — **アップロード済み**、**処理中**、**完了**、**エラー** — を使用してリストを絞り込みます。ファイルに独立した*キャンセル済み*ステータスはありません。バッチを削除すると、ファイルはキャンセル済みとしてマークされるのではなく削除されます（[バッチの削除](#deleting-a-batch)を参照）。

## バッチとテンプレート

バッチはファイルのアップロード時にテンプレートに紐付けられません。テンプレートは処理を開始するときに選択されます。バッチは**データ列**パネルで現在選択されているテンプレートを使用し、そのテンプレートは処理したファイルとともに記録されます。

- **同じバッチを別のテンプレートで再処理できます。**別のテンプレートを選択してバッチを再度実行すると、新しい実行では新しいテンプレートが列に使用されます。テンプレートとその列の仕組みについては、[テンプレートと列](/docs/concepts/templates-and-columns)を参照してください。
- **1回の処理実行では1つのテンプレートを使用します。**一緒に送信されたすべてのファイルは同じ列で処理され、各ファイルの結果は処理に使用されたテンプレートに属します。
- **Wordに変換モードのバッチはテンプレートを使用しません。**このモードでは、列を抽出する代わりにページ全体をWord文書として返します。
- **マルチページ結合は単一のバッチ内で機能します。**テンプレートで結合が有効になっている場合、そのバッチ内のファイルの行が結合されます。行が2つのバッチにまたがって結合されることはありません。[マルチページ結合](/docs/concepts/multi-page-merge)を参照してください。

## バッチへのファイルの追加

ダッシュボードでは、各アップロードが新しいバッチを開始します。既存のバッチにファイルを追加する操作はありません。後でファイルをアップロードすると、以前のバッチが作成直後であろうと処理・エクスポート済みであろうと、新しい名前の新しいバッチが作成されます。すでにエクスポートしたファイルは元のバッチに残ります。

ファイルを自動的に収集するバッチは動作が少し異なります。コレクションリンクまたはメール受信トレイから到着したファイルは、同じソースの最新バッチが未処理で空きがある場合、そのバッチに追加できます。そのバッチ内のいずれかのファイルで処理が開始された後、またはバッチがいっぱいになった後は、次の到着で新しいバッチが開始されます。

## バッチの削除

バッチヘッダーのゴミ箱アイコンをクリックすると、バッチ全体が削除されます。ファイルとその結果がアカウントから削除され、元に戻せない操作のため、アプリは先に確認を求めます。

クレジットは各ファイルの進行状況に応じて処理されます：

- **キューで待機中のファイルは返金されます。**確認ダイアログには、返金される待機中ファイルの数が表示されます。例：*「待機中のファイル3件が返金されます。このバッチを削除しますか？」*
- **処理中のファイルは返金されません。**いずれかのファイルが処理を開始した場合、確認ダイアログは、すでに請求されたクレジットが返金されないことを警告します。バッチを削除してもその処理は停止せず、結果は破棄されます。

プロフィールの**履歴を削除**からすべてを一度に削除することもできます。同じルールが適用されます。キュー内のファイルは返金され、処理中のファイルは返金されません。

## バッチのエクスポート

バッチヘッダーのダウンロードアイコンでそのバッチをエクスポートでき、複数バッチのエクスポートダイアログでは複数のバッチにチェックを入れてまとめてエクスポートできます。エクスポートでは、各バッチのファイルと、それらのファイルが処理されたテンプレート（マルチページ結合の設定を含む）が使用されます。処理は再実行されません。エクスポート前に、アプリはバッチ内のすべてのファイルが完了しているかを確認し、まだ待機中、失敗、または結果がないファイルがある場合は警告します。詳細な手順は[エクスポート](/docs/guides/export)ページをご覧ください。

## よくある質問

### バッチの名前を変更できますか？

いいえ。バッチ名はアップロードの日時から自動的に生成され、名前を変更する操作はありません。

### すでにエクスポートしたバッチにファイルを追加できますか？

いいえ。再度アップロードすると、以前のバッチを続けるつもりでも新しいバッチが開始されます。エクスポート済みのバッチには、すでにあったファイルのみが保持されます。

### 処理中にバッチを削除するとどうなりますか？

バッチのファイルはすぐに削除されます。開始していなかったファイルは返金され、すでに処理中のファイルは返金されず、バックグラウンドで処理が完了するまで放置され、結果は破棄されます。

### チームメンバーはバッチを共有しますか？

いいえ。バッチは作成したアカウントに属します。チームはプランとクレジットを共有しますが、各メンバーのバッチは各自のファイルリストに残ります。

---

Source: https://imagetotable.ai/ja/docs/concepts/batches