初級者編 / ファイル出力を設定する
エクスポート
プロンプトのコツまでで、発注書を読み取るためのドキュメントタイプが完成しました。ここからは、読み取った結果をアウトプットの形で出力する設定を進めます。
業務フローの整理・設計では、2つのアウトプットをそれぞれ違う方法で出力すると決めていました。このページでは、そのうち基幹システム取込データをエクスポートで出力します。明細1行につき1行が並んだだけのシンプルな表で、レイアウトの指定もないため、テンプレートを用意せず設定だけで出力できるエクスポートが適しています。
このページで進めることlink
- 1helpエクスポートでできること、書類作成との違いを確認する
- 2compare出力したいファイルの形と、いまの解析結果を見比べる
- 3tuneファイル出力タブでエクスポートパターンを作成する
- 4download実際にエクスポートして、出力されたファイルを確認する
エクスポートとはlink
エクスポートとは、ドキュメントの解析結果をExcelまたはCSV形式の表として出力する機能です。
- 出力する解析項目・並び順・ファイル形式・ファイル名を、ドキュメントタイプごとに設定しておけます
- 設定はすべてサービス内で完結し、テンプレートファイルを用意する必要がありません
- 1度に最大300件のドキュメントをまとめて出力できます
もう1つのファイル出力である書類作成との違いは、次のとおりです。
| エクスポート | 書類作成 | |
|---|---|---|
| 出力できる形 | 解析結果が列で並んだシンプルな表 | テンプレートどおりのレイアウト |
| テンプレート | 不要(設定だけで出力できる) | 必要(Excel・Word・PowerPoint) |
| 向いている用途 | システムに取り込むデータ、一覧表 | 社内外に提出する帳票 |
| 今回の用途 | 基幹システム取込データ | 発注指示書 |
出力したいファイルを確認するlink
設定を始める前に、何を・どの順番で出力したいのかをはっきりさせておきます。
目指すのは、管理部に渡している次のファイルです。
| 列 | 内容 | どこから取るか |
|---|---|---|
| 取引先コード | T0001など | 解析項目(単項目) |
| 取引先名 | 株式会社東和サプライなど | 解析項目(単項目) |
| 商品コード | PA-0001など | 発注明細の列 |
| 品名 | A4コピー用紙(箱)など | 発注明細の列 |
| 数量 | 6など | 発注明細の列 |
| 仕入単価 | 880など | 発注明細の列 |
| 納品先 | 東京都千代田区…など | 解析項目(単項目) |
いまの解析結果は、シートモードで見ると次の状態です。必要な値はすべてそろっています。
ここで確認しておきたいポイントは2つあります。
- 1発注日と納期は、このファイルでは使いません。解析項目にはありますが、出力する項目は自由に選べます
- 2明細1行につき1行の形にする必要があります。取引先コード・取引先名・納品先は単項目(1ドキュメントに1つの値)なので、明細の行数だけ繰り返して出力する設定が必要です
Tips:単項目と表項目が混ざった表の作られ方
発注書1通の中で、取引先コードや納品先は1つの値しか持ちませんが、発注明細は複数行あります。この2つを1つの表にまとめるとき、単項目をどう扱うかで結果が変わります。
繰り返さない場合
| 取引先コード | 商品コード | 数量 |
|---|---|---|
| T0001 | PA-0001 | 6 |
| SU-0001 | 3 | |
| FU-0001 | 10 |
繰り返す場合
| 取引先コード | 商品コード | 数量 |
|---|---|---|
| T0001 | PA-0001 | 6 |
| T0001 | SU-0001 | 3 |
| T0001 | FU-0001 | 10 |
基幹システムに取り込むデータは、1行だけで意味が通じる形である必要があります。そのため、今回は繰り返す設定を使います。
エクスポートパターンを作成するlink
エクスポートの設定は、エクスポートパターンという単位で保存します。1つのドキュメントタイプに複数のパターンを登録できるため、用途ごとに出力の形を使い分けられます。
ファイル出力タブを開くlink
ドキュメントタイプ「発注書」を開き、ファイル出力タブを選択します。
エクスポート設定に、すでにdefaultというパターンが1つあります。これはドキュメントタイプを作成したときに自動で作られるもので、全解析項目をそのままExcelに出力する設定です。
今回は基幹システム取込データ専用のパターンを作るので、+新規パターンをクリックします。
Tips:defaultパターンはそのまま残しておく
defaultは、解析結果をひととおり確認したいときに便利な「全部出し」のパターンです。用途ごとに新しいパターンを追加していけば、defaultはそのまま残しておけます。
パターンは一覧の左にあるハンドルをドラッグして並び替えられるため、よく使うものを上に置いておくと選びやすくなります。
基本の設定をするlink
新規パターンの画面が開きます。左側が出力の基本設定、右側が出力する項目の設定です。
左側は次のように設定しました。
| 設定 | 選んだ値 | 理由 |
|---|---|---|
| パターン名 | 基幹システム取込データ | 出力の用途がわかる名前にする |
| ファイル形式 | Excel | 管理部がExcelで受け取るため |
| CSV展開 | 展開する | 発注明細を列ごとのセルに展開するために必要 |
| ヘッダー出力 | ヘッダーを出力する | 列名の行を付ける |
| 単項目の繰り返し出力 | 表の各行に単項目の値を繰り返して出力する | 明細1行につき1行の形にするため |
| 出力ファイル名 | {{エクスポート日時}}_{{パターン名}} | いつ出力した分かがファイル名でわかるようにする |
CSV展開を有効にしても、解析項目側の解析方針がCSVになっていないと、発注明細は列ごとに展開されません。発注明細はドキュメントタイプビルダーで表項目として作成したときに解析方針がCSVになっているので、ここではそのまま進めます。
Tips:出力ファイル名は変数で組み立てられる
出力ファイル名には、固定の文字列のほかに変数を使えます。画面下部の使用できる変数から、次の変数をコピーして貼り付けられます。
| 変数 | 出力される値の例 |
|---|---|
| {{ドキュメントタイプ名}} | 発注書 |
| {{ドキュメント名}} | 見積書_サンプル |
| {{パターン名}} | 基幹システム取込データ |
| {{エクスポート日}} | 20260314 |
| {{エクスポート日時}} | 20260314121530 |
今回の設定では、20260314121530_基幹システム取込データというファイル名で出力されます。入力欄の下に出力ファイル名イメージが表示されるので、確認しながら組み立ててください。
出力する項目を選ぶlink
右側で、出力する項目と並び順を決めます。
まず項目選択モードを手動にします。
| モード | 動作 |
|---|---|
| 全選択 | エクスポート実行時点の全解析項目が自動的に出力される。解析項目の追加・削除が自動で反映される |
| 手動 | 設定した解析項目のみ出力する。設定後に追加された項目は反映されない |
今回は出力する項目を絞り込みたいので手動を選びます。
出力フィールドには、現在の解析項目が並んでいます。ここで次の操作をおこないます。
- 使わない項目は、右端の×で削除する(今回は発注日と納期を削除)
- 左端のハンドルをドラッグして、アウトプットと同じ並び順にそろえる
最終的に、取引先コード → 取引先名 → 発注明細 → 納品先の順に並べました。
Tips:出力フィールドの並び順が、そのまま列の並びになります
エクスポートでは、出力フィールドの上から順に左の列へ出力されます。アウトプットの完成形を見ながら、同じ順番に並べ替えておくと、出力後に列を入れ替える手間がなくなります。
削除した解析項目は、あとから+解析項目を追加で戻せます。ドキュメントタイプから項目そのものが消えるわけではありません。
発注明細の列を指定するlink
発注明細は表項目のため、行をクリックすると列の一覧が開きます。ここで、どの列を出力するかを選びます。
出力方法は3つから選べます。
| モード | 出力される列 |
|---|---|
| 全列展開 | 解析結果に含まれる列をすべて出力する。解析結果によって列数が変わることがある |
| 列数固定 | 現在の設定の列数にそろえて出力する。列数は常に一定になる |
| 列指定 | チェックで選んだ列だけを出力する |
基幹システム取込データで必要なのは、6列のうち商品コード・品名・数量・仕入単価の4列です。単位と備考は発注指示書でしか使わないため、列指定を選び、必要な4列だけにチェックを入れます。
列指定は、選んだ列の位置(何列目か)を記憶します。そのため、エクスポート設定をしたあとに表項目の並び替えや列の追加・削除をおこなうと、意図した列とは違う列が出力される場合があります。表項目の構成を変更したときは、エクスポートパターンの列指定もあわせて見直してください。
詳しくは、マニュアルのエクスポート設定(出力フィールド)を確認してください。
Tips:解析項目にない値も列として追加できる
その他項目を選択では、解析項目以外の値を列として追加できます。
| 項目 | 出力される値 |
|---|---|
| 空白 | 空の列(取込側で必須の空列がある場合などに使う) |
| ドキュメント名/ファイル名 | ドキュメント名、アップロードしたファイル名 |
| ドキュメントタイプ名 | 発注書 |
| ステータス | 未対応などのステータス |
| エクスポート日時/アップロード日時 | 出力した日時、アップロードした日時 |
基幹システム側で「取込日」や「元ファイル名」の列が必要な場合は、ここで追加しておくと、出力後に手を加えずに済みます。
プレビューで確認して保存するlink
設定ができたら、保存する前にプレビューをクリックします。
プレビューは、最新1件のドキュメントの解析結果から生成されます。実際に出力されるものと同じ列構成・同じ並び順で表示されるため、ここでアウトプットの完成形と見比べてください。
- 列の並びは意図したとおりか
- 単項目(取引先コード・取引先名・納品先)が、明細の各行に繰り返し出力されているか
- 発注明細が、指定した列だけ展開されているか
問題がなければ、保存するをクリックします。エクスポート設定の一覧に、作成したパターンが追加されます。
エクスポートして結果を確認するlink
設定したパターンを使って、実際にファイルを出力します。
エクスポートは、ドキュメント検証画面(リストモード・シートモード)から実行できます。
| 対象 | 操作 |
|---|---|
| 1件だけ | ドキュメント詳細画面のエクスポートボタンをクリックする |
| 複数件 | ドキュメント一覧で対象のドキュメントを選択し、エクスポートをクリックする |
今回は1日分の受注をまとめて出力するため、3通の発注書を選択してエクスポートします。
エクスポートをクリックすると、ドキュメントタイプごとにエクスポートパターンを選ぶ画面が表示されます。ここで基幹システム取込データを選びます。
出力が完了すると、ファイルがダウンロードされます。
3通分の明細が1枚のシートにまとまり、取引先コード・取引先名・納品先が各行に繰り返し出力されています。アウトプットの完成形と同じ形になりました。
Tips:行の並び順は、ドキュメントの並び順になります
エクスポートは、ドキュメント一覧の並び順(アップロード日が新しい順など)のまま出力します。取引先コード順に並べたい場合は、出力後に表計算ソフト側で並べ替えてください。
エクスポートは、解析結果をそのまま出力する機能です。解析結果に誤りがあれば、そのまま基幹システムに取り込まれてしまいます。出力する前に解析結果を確認・修正する手順は、このあとのドキュメントを確認するで扱います。
解析項目の追加・削除など、ドキュメントタイプの構造そのものを変更した場合、変更前に解析したドキュメントと変更後のドキュメントで、同じエクスポートパターンでも出力結果が異なることがあります。解析結果は常にその解析時点の設定で保存されているためです。
構造を変更する必要がある場合は、エクスポートパターンを変更前後で分けるなどの対応を検討してください。
ここまでで準備できていることlink
- エクスポートと書類作成の違いを理解し、用途に応じて使い分けられる
- 発注書のドキュメントタイプに、基幹システム取込データ用のエクスポートパターンが登録されている
- 出力する項目・並び順・表項目の列・ファイル名を、アウトプットに合わせて設定できている
- 複数のドキュメントをまとめてエクスポートし、1日分の取込データを1ファイルで出力できる
これで、2つのアウトプットのうち、基幹システム取込データを出力できるようになりました。次のページでは、もう1つのアウトプットである発注指示書を、テンプレートを使って出力する書類作成を設定します。
