コンセプト

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

テンプレートとは

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

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

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

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

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

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

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

カラムの構成

各カラムは正確に2つの部分で構成されます：カラム名と、オプションでFormat Requirementです。両方はドキュメント処理時に一緒に送信されます。

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

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

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

カラムの順序を変更する

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

テンプレート全体の設定

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

  • Global Format Requirement — テンプレート内のすべてのカラムに、各カラム独自のFormat Requirementに加えて適用される1つの指示です。同じ書式ルール（日付スタイルや数値形式など）が全体に適用される場合に使用します。
  • Merge Multiple Results — 抽出された複数の行を1つに結合します。これは 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テンプレート＆フィールドリファレンス を参照してください。

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

📮 contact email: [email protected]