# テンプレートとカラム：再利用可能な抽出設定

> テンプレートとは、保存済みで再利用可能な抽出カラムのリストです。このページでは、カラム名とフォーマット要件の仕組み、アカウントで保持できるテンプレート数、テンプレートが再利用される場所について説明します。

[**テンプレート**](/docs/reference/glossary#template)とは、ドキュメントから抽出したい[カラム](/docs/reference/glossary#column)の保存済みで再利用可能なリストです。一度保存すれば、以降のすべての[バッチ](/docs/reference/glossary#batch)で同じカラムを再度記述することなく再利用できます。

## テンプレートとは

テンプレートは、抽出されるカラムのリストを保持します。各カラムは、結果のテーブル内の1つのカラムになります。テンプレート自体は、そのリストを保存するためのコンテナに過ぎず、同じカラムセットを再入力することなく、バッチごとに適用できます。

テンプレートと単発実行の違いは次のとおりです：

- **保存済みテンプレート** — 名前付きで再利用可能なカラムセットです。アカウント内に保持され、任意のバッチで切り替えたり、このページの後半に記載されている他のエントリポイントから再利用したりできます。
- **単発実行** — カラムはその単一の実行のためだけに存在し、再利用のために保存されません。Webアプリでは、選択したテンプレートにカラムが定義されていない場合にこれが発生します。AIがドキュメント自体からテーブル構造を推論します。APIを通じて、テンプレートを事前に作成せずに、1リクエストのみカラムリストを渡すこともできます。

## テンプレートの作成、切り替え、編集

テンプレートはダッシュボードの**Data Columns**パネル（To Tableモード）から管理します。パネルのヘッダーには現在選択中のテンプレートと、3つのアクションが表示されます：

| アクション | 機能 |
| --- | --- |
| New | New Template ダイアログを開きます。テンプレートに名前を付け、必要に応じて既存のテンプレートを基にそのカラムをコピーできます。また、Preset Libraryを参照して既成のセットから始めることもできます。 |
| Switch | テンプレート一覧を表示する Switch Template ダイアログを開きます。各行には Select 、 Settings 、 Share 、 Delete が用意されています。 |
| Settings | 現在のテンプレートの Template Settings を開きます — 下記の テンプレート全体の設定 を参照してください。 |

カラムを追加するには、テンプレートタイトルの下のボックスに名前を入力し、**Add Column**をクリックします。まだテンプレートが選択されていない場合は、自動的に作成されます。カラムを変更するには、リスト内の編集アイコンをクリックします。削除するには、削除アイコンをクリックします。

## カラムの構成

各カラムは正確に2つの部分で構成されます：**カラム名**と、オプションで[**Format Requirement**](/docs/reference/glossary#format-requirement)です。両方はドキュメント処理時に一緒に送信されます。

| 部分 | 制御内容 |
| --- | --- |
| カラム名 | 出力カラムのラベルであり、ドキュメント内で 何を 探すかの指示です — 例： Invoice Number や Total Amount 。この名前はAIが探す対象でもあるため、取得したいデータを説明するものにしてください。 |
| Format Requirement（オプション） | そのカラムの値を どのように 返すかに関する追加指示です — 例：金額を数値に変換する、通貨記号を削除する、日付を固定形式に正規化するなど。このカラムにのみ適用されます。空のままにすると、値はドキュメントに記載されている通りに返されます。 |

カラムにFormat Requirementがある場合、リスト内の名前の横に情報アイコンが表示され、編集ダイアログを開かずに指示を確認できます。Format Requirementのないカラムは、値を直接抽出します。

[Custom Columns](/docs/concepts/custom-columns)ページでは、カラムの値が生成されるさまざまな方法（ドキュメントから直接読み取る、他の値から計算する、文脈から推論する）について説明しています。

## カラムの順序を変更する

カラムはテンプレートに表示されている順序で抽出・返却されます。その順序を変更するには、リスト内のカラムをドラッグハンドルでドラッグします。新しい順序はすぐに保存され、出力テーブルにも反映されます。これは、結果のスプレッドシートを特定のカラムで始めたい場合に便利です。

## テンプレート全体の設定

**Template Settings**ダイアログ（Data ColumnsパネルのSettingsアクション、またはSwitch Templateダイアログの各行から開きます）には、単一のカラムではなくテンプレート全体に適用される設定が含まれています：

- **Global Format Requirement** — テンプレート内のすべてのカラムに、各カラム独自のFormat Requirementに加えて適用される1つの指示です。同じ書式ルール（日付スタイルや数値形式など）が全体に適用される場合に使用します。
- **Merge Multiple Results** — 抽出された複数の行を1つに結合します。これは [Multi-Page Merge](/docs/concepts/multi-page-merge) ページで説明されている機能と同じです。

## AI-Suggested Columns

選択したテンプレートにまだカラムがなく、バッチに少なくとも2つのファイルが含まれるTo Tableバッチの処理を開始すると、Webアプリがカラムリストを提案することができます。いくつかのファイルがサンプリングされ、AIがそれらを読み取り、**AI-Suggested Columns**ダイアログが提案とともに開きます。

- 提案されたカラム名を確認し、必要に応じて編集、独自のカラムを追加、不要なカラムを削除します。
- **Apply & Process**をクリックすると、リストがテンプレートに保存され、処理が開始されます。
- 提案が失敗した場合は、**Retry**または**Define manually**を選択します。

テンプレートにすでにカラムがある場合、またはバッチにファイルが1つしかない場合は、提案はスキップされ、処理が直接開始されます。

## テンプレートの最大数

1つのアカウントには最大**30テンプレート**まで保存できます。この上限に達した後に新しいテンプレートを作成しようとすると、アプリは次のメッセージを表示し、新しいテンプレートは作成されません：

> 30テンプレートの上限に達しました。先に既存のテンプレートを削除してください。

スロットを空けるには、**テンプレート切り替え**ダイアログを開き、不要になったテンプレートを削除してください。

## テンプレートを再利用できる場所

テンプレートは1つのバッチに固定されるものではありません。保存した同じカラムセットは、次のいずれかのエントリポイントから適用できます：

- **Webアプリ** — データカラムパネルでテンプレートを選択し、任意のバッチを処理します。
- **Google Sheetsアドオン** — サイドバーは同じ保存済みテンプレートを使用するため、ウェブサイトで作成したテンプレートもここで利用できます。
- **API** — バッチを開始するときにテンプレートの識別子を渡し、リクエスト内でカラムを列挙する代わりに使用します。開発者向けの詳細は [APIテンプレート＆フィールドリファレンス](/developers/reference/templates-fields) を参照してください。

テンプレートはテキストとして共有することもできます：テンプレート切り替えダイアログの**共有**アクションは、他の人に送信できるブロックを生成し、その相手はカラム名ボックスに貼り付けて**カラム追加**をクリックすると、カラムと設定を自分のアカウントにインポートできます。

---

Source: https://imagetotable.ai/ja/docs/concepts/templates-and-columns