ファイル出力 / 書類作成

書類作成用テンプレートの作成

書類作成用テンプレートにはWord、Excel、PowerPoint、CSVといった多様なファイル形式を登録することができます。書類作成用テンプレートの登録にあたって、まずはお手持ちのパソコンで好きなテンプレートとなるファイルを用意します。

テンプレート変数link

書類作成用テンプレートには、原則として１つ以上のテンプレート変数を設置します。

使用できるテンプレート変数はドキュメントタイプごとに異なり、ドキュメントタイプ/ファイル出力から確認できます。

fact_check

解析項目のテンプレート変数

ドキュメントタイプごとに異なり、ドキュメントが取得している項目の値を出力するために使用します。

info

その他項目のテンプレート変数

ドキュメントタイプで共通で、ドキュメントが保持するメタ情報を出力するために使用します。

メタ情報とは、ドキュメントのアップロード日やファイル名といったドキュメント自体の情報です。現在、使用できるメタ情報は次の通りです。

アップロード日: ドキュメントがアップロードされた日付が出力されます。
出力日: 書類作成された日付が出力されます。
ドキュメントタイプ名: ドキュメントが属するドキュメントタイプ名が出力されます。
ドキュメント名: 登録されているドキュメント名が出力されます。
ファイル名: ドキュメントのアップロード時のファイル名が出力されます。
プロジェクト名: ドキュメントに設定されているプロジェクト名が全て出力されます。
書類作成プロジェクト名: 書類作成時に選択されたプロジェクト名が出力されます。
ステータス: ドキュメントのステータス名が出力されます。

＊テンプレート変数は「書類作成」機能を利用した場合にのみ適用されます。

テンプレート変数は次のように表記されます。

{{ドキュメントタイプ名.解析項目名（またはメタ情報名）}}

テンプレート変数を選択し、コピーアイコンcontent_copyをクリックすると、クリップボードにコピーされます。

まとめてコピーしたい場合は右上のコピーアイコンcontent_copyをクリック
解析項目ごとにコピーしたい場合は解析項目のコピーアイコンcontent_copyをクリック

コピーしたテンプレート変数をテンプレートとなるファイルの任意の箇所に設置し、ファイルを保存します。

テンプレート変数の使い方link

テンプレート変数は大きく以下の3つの使い方があります。

基本的な使い方

{{ドキュメントタイプ名.解析項目名（またはメタ情報名）}}

選択されたドキュメントに対して、設置されたテンプレート変数のドキュメントタイプと解析項目が一致した場合にドキュメントの解析項目の解析結果が置換されます。ただし、１つのテンプレート変数に対して適用できるドキュメントが複数存在する場合の挙動は、テンプレートのファイル形式によって異なります。

テンプレートのファイル形式がExcelの場合

選択されたドキュメントの順にテンプレート変数が置換され、自動的に改行処理がおこなわれます。そして、テンプレート変数への置換処理は選択されたドキュメントの数だけ試行されます。具体的には次のような出力となります。

(例)同一のドキュメントタイプに属する２つの選択されたドキュメントを１つのExcel形式のテンプレートに出力する。

書類作成用のテンプレート

出力されるファイル

名刺1.png	サンプル株式会社	田中一郎
名刺2.png	株式会社さんぷる	山田花子

テンプレートのファイル形式がExcel以外の場合

１つ目に選択されたドキュメントの値が優先的に出力されます。２つ目以降に選択されたドキュメントの項目の値は無視されます。

番号を指定する

{{ドキュメントタイプ名.解析項目名（またはメタ情報名）.選択番号}}

選択されたドキュメントに対して、設置されたテンプレート変数のドキュメントタイプと解析項目と選択番号が一致した場合にドキュメントの解析項目の解析結果が置換されます。同一のドキュメントタイプに属する複数のドキュメントを意図した箇所に出力したい場合に使用します。

＊テンプレートのファイル形式に関わらず共通の仕様です。

(例)同一のドキュメントタイプに属する２つの選択されたドキュメントを１つのテンプレートに出力する（ドキュメントが選択された順番は「名刺1」→「名刺2」）

書類作成用のテンプレート

{{名刺.ファイル名.2}}	{{名刺.会社名.2}}	{{名刺.氏名.2}}
{{名刺.ファイル名.1}}	{{名刺.会社名.1}}	{{名刺.氏名.1}}

出力されるファイル

名刺2.png	株式会社さんぷる	山田花子
名刺1.png	サンプル株式会社	田中一郎

CSV形式の値をセルを展開して出力する

（出力するファイルがExcel形式の時のみ）

{{ドキュメントタイプ名.解析項目名}}

選択されたドキュメントに対して、設置されたテンプレート変数のドキュメントタイプと解析項目が一致した場合にドキュメントの解析項目の解析結果が置換されます（1.基本的な使い方と同じ）。ただし、以下のすべての要件を満たした場合に限り、異なる挙動となります。

指定した解析項目の解析結果がCSV形式で取得されている
書類作成用テンプレートのCSV展開がONになっている
出力するファイル形式がExcel形式である

上記の条件を満たした場合に限り、CSV形式で取得された解析結果が自動的にCSV展開されます。詳しくは後述のテンプレート変数のCSV展開で解説します。

テンプレート変数のCSV展開link

CSV展開とは、書類作成時にCSV形式の値をExcel形式のファイルに出力する際に自動的にインポートさせる機能です。表形式のデータをまとめて出力したい場合に使用します。

表形式のデータを取り扱う場合はCSV形式のデータとして管理する必要がありますが、取得したCSV形式のデータ（解析結果）を特にExcel形式のフォーマットに出力した場合、そのままの形では非常に扱いにくい形になる場合があります。

例１：CSV展開しない場合のサンプルデータ

2025年1月1日,¥100,3,¥300 2026年1月1日,¥200,3,¥600

例２：CSV展開する場合のサンプルデータ

2025年1月1日	¥100	3	¥300
2026年1月1日	¥200	3	¥600

例１のCSV展開をしない場合は、1つのセルに全ての値が挿入されてしまっているのに対して、例２のCSV展開をする場合は、適切にCSV形式の値がインポートされ、より活用しやすい形に出力されているのがわかります。

CSV展開用テンプレートの作成

CSV展開される解析項目のテンプレート変数は、CSV展開されることを想定してExcelファイル内に配置する必要があります。展開される行数分の領域を事前に空けて配置してください。

例えば、先述の例を用いて下記のようなデータを作成したいと考えます。

請求日	単価	数量	合計金額
2025年1月1日	¥100	3	¥300
2026年1月1日	¥200	3	¥600

この2025年1月1日から始まるデータが実際に出力したいデータになりますが、上記の要件を満たすためには次のようにテンプレート変数を配置します。

請求日	単価	数量	合計金額
{{請求書.請求明細}}

ポイントは、CSV展開される列と行を事前に想定しておくことです。今回はテンプレート変数以降の空白セルに値が入りますので、その箇所をあらかじめ空けておく必要があります。

なお、上記の想定を無視して、CSV展開予定のセルにあらかじめ異なる値が入力されていた場合、その値が上書きされ消えてしまう場合があるため注意してください。

lightbulb

Tips：ダブルコーテーションでの値取得

CSV展開では、解析結果に含まれるカンマと改行に従ってデータを出力しますが、解析結果の値にコンマ（,）を含む文字列（例：¥1,530）が含まれる場合、CSV展開時に１行あたりの値の数がずれてしまい、意図しない結果になることがあります。

想定しない結果

請求日	単価	数量	合計金額
2025年1月1日	¥100	30	¥3	000
2026年1月1日	¥200	30	¥6	000

期待する結果

請求日	単価	数量	合計金額
2025年1月1日	¥100	30	¥3,000
2026年1月1日	¥200	30	¥6,000

想定しない結果のケースでは、合計金額に含まれるコンマがCSV展開で用いるカンマと混在してしまっていることによって、意図しない挙動となってしまいました。CSV展開では、カンマと改行の扱いに気をつける必要があります。

カルクペーパーでは、上記の想定しない結果を回避するために、CSV形式での解析結果の取得では全ての値をダブルコーテーションで囲うようにあらかじめ指示をしています。

ダブルコーテーションで囲わない場合

2025年1月1日,¥100,30,¥3,000
2026年1月1日,¥200,30,¥6,000

ダブルコーテーションで囲った場合

"2025年1月1日","¥100","30","¥3,000"
"2026年1月1日","¥200","30","¥6,000"

後者のようにダブルコーテーションで値を囲うことで、ダブルコーテーション内のコンマと改行がCSV展開時には無視されるようになるため、適切なデータ出力が可能になります。