初級者編 / ファイル出力を設定する
書類作成
エクスポートで、1つめのアウトプットである基幹システム取込データを出力できるようになりました。
残るアウトプットは、商品管理部に渡す発注指示書です。こちらは社内帳票としてレイアウトが決まっているため、業務フローの整理・設計では書類作成で出力すると決めていました。
このページでは、手元のExcelを書類作成用テンプレートに作り替えるところから、実際に出力して結果を整えるところまでを進めます。
このページで進めることlink
- 1help書類作成の流れと、テンプレート変数の仕組みを確認する
- 2edit_document発注指示書のExcelを、書類作成用テンプレートに作り替える
- 3upload_fileテンプレートを登録し、出力ファイル名と出力方法を設定する
- 4fact_check書類作成を実行し、出力結果を確認して整える
書類作成とはlink
書類作成とは、あらかじめ用意したテンプレートに解析結果を流し込んでファイルを出力する機能です。
テンプレートには、Excel・Word・PowerPoint・CSVなどが使えます。テンプレートの中にテンプレート変数という目印を置いておくと、書類作成を実行したときに、その場所へ解析結果が差し込まれます。
テンプレートを作る
出力したい書類にテンプレート変数を埋め込む
登録する
ワークスペースにアップロードし、出力の設定をする
書類作成を実行する
ドキュメントを選んでファイルを出力する
| 内容 | |
|---|---|
| 準備するもの | 出力したい書類のテンプレートファイル(今回はExcel) |
| テンプレートに置くもの | テンプレート変数({{ドキュメントタイプ名.解析項目名}}) |
| 出力できる形 | テンプレートのレイアウトをそのまま保った書類 |
| 1度に出力できる件数 | 最大100件 |
前のページで扱ったエクスポートとの違いは、レイアウトを自分で決められるかどうかです。列が並んだだけの表でよければエクスポート、罫線や見出し、注意書きまで含めた決まった体裁で出したい場合は書類作成を使います。考え方は、マニュアルのファイル出力の方法と書類作成とはでも解説しています。
出力したい書類を確認するlink
まず、完成形の発注指示書を確認します。1枚目に宛先と受注の概要、2枚目に明細という2シート構成です。
このファイルの中身を、3つに分けて考えます。
| 分類 | 該当する箇所 | テンプレートでの扱い |
|---|---|---|
| 毎回変わらない文言 | タイトル、宛先(商品管理部)、出荷前の確認事項・注意事項 | そのまま残す |
| 人が手で記入する欄 | 指示日、指示者(黄色のセル) | 空欄のまま残す |
| 解析結果を差し込む値 | 取引先コード・取引先名・発注日・納期・納品先、明細の各行 | テンプレート変数に置き換える |
Tips:テンプレートは「完成形のファイル」から作るのが近道です
テンプレートをゼロから作る必要はありません。すでに運用している書類があるなら、そのファイルをコピーして、値が入っているセルだけをテンプレート変数に置き換えるのがもっとも簡単で確実です。
罫線・セルの書式・列幅・数式などはそのまま残るため、見た目を作り直す手間がかかりません。
テンプレートを作るlink
値を消して、変数を置く場所を空けるlink
完成形のファイルをコピーし、解析結果を差し込むセルの値を削除します。
指示日・指示者は商品管理部に渡したあとに手で記入する欄なので、空欄のまま残します。確認事項・注意事項のような固定の文言も、そのままにしておきます。
使えるテンプレート変数を確認するlink
テンプレート変数は、ドキュメントタイプごとに決まっています。ドキュメントタイプ「発注書」を開き、ファイル出力タブのテンプレート変数をクリックします。
解析項目ごとのテンプレート変数が一覧で表示されます。右側のコピーアイコンをクリックすると、その変数がクリップボードにコピーされます。
変数には2種類あります。
| 種類 | 書き方 | 出力される内容 |
|---|---|---|
| 解析項目の変数 | {{発注書.取引先名}} | その解析項目の解析結果 |
| 表項目の変数 | {{発注書.発注明細.品名}} | 表項目のうち、指定した1列だけの解析結果 |
その他項目タブには、解析項目以外のメタ情報の変数(アップロード日・出力日・ドキュメント名・ファイル名・ステータスなど)があります。
1枚目に変数を貼り付けるlink
コピーした変数を、対応するセルに貼り付けていきます。
見た目が変数の文字列に変わるだけで、セルの書式や罫線はそのままです。
2枚目に明細の変数を置くlink
明細シートでは、表項目の変数を1つだけ置きます。
ヘッダー行のすぐ下(A2セル)に{{発注書.発注明細}}と入力しました。これだけで、CSV展開によって明細の全行・全列が右方向と下方向に自動で展開されます。
CSV展開は、変数を置いたセルから隣接する行・列へ自動的に展開されます。展開される範囲にあらかじめ値や数式が入っていると、強制的に上書きされて消えてしまいます。また、セル結合は無視されます。
明細が何行になるかを見込んで、変数の下には十分な空白行を用意しておいてください。詳しくは、マニュアルの書類作成用テンプレートの注意点を確認してください。
Tips:CSV展開を使うには3つの条件がそろう必要があります
- テンプレートのファイル形式がExcelであること
- 解析項目の解析方針がCSVであること
- テンプレート側のCSV展開がONになっていること
発注明細はドキュメントタイプビルダーで表項目として作成したときに解析方針がCSVになっているため、残るはテンプレート登録時の設定だけです。
テンプレートを登録するlink
作成したファイルを、ワークスペースに登録します。画面上部の書類テンプレから書類作成用テンプレートを開き、テンプレート登録をクリックしてファイルをアップロードします。
アップロード前の確認画面で、2つの設定をおこないます。
| 設定 | 選んだ値 | 理由 |
|---|---|---|
| CSV展開 | ON | 明細をセルごとに展開するため |
| 出力方法 | 別々に出力 | 発注指示書は取引先ごとに分けて商品管理部へ渡すため |
アップロードすると、一覧にテンプレートが追加されます。
関連ドキュメントタイプに「発注書」と表示されました。これは、テンプレート内のテンプレート変数から自動的に紐づけられたものです。
テンプレートの設定を整えるlink
テンプレート名をクリックすると、詳細な設定を変更できます。
ここでは、出力ファイル名を次のように設定しました。
【{{発注書.取引先名}}】{{発注書.出力日.YYYYMMDD}}_発注指示書出力ファイル名にもテンプレート変数が使えるため、取引先名と出力日がファイル名に入るようになります。取引先ごとに分けて出力する今回の運用では、ファイル名を見ただけでどの取引先の分かがわかります。
| 設定 | 内容 |
|---|---|
| テンプレート名 | サービス内で検索・管理するための名前 |
| 出力ファイル名 | 書類作成時に出力されるファイルの名前。テンプレート変数が使える |
| 関連ドキュメントタイプ | テンプレート変数から自動で紐づくドキュメントタイプ |
| CSV展開 | 書類作成時のCSV展開の初期設定 |
| テンプレート変数を表示 | 変数に対応する解析結果が見つからない場合に、変数をそのまま出力するか(ON)、空欄にするか(OFF) |
| 出力方法 | まとめて出力(1ファイル)か、別々に出力(ドキュメントごと)か |
Tips:テンプレートには3つの「名前」があります
| 名前 | 変更 | 役割 |
|---|---|---|
| テンプレート名 | できる | サービス内での管理・検索に使う名前 |
| 出力ファイル名 | できる | 書類作成で出力されるファイルの名前 |
| アップロードされたファイル名 | できない | アップロードしたファイルそのものの名前 |
登録した直後は3つとも同じ名前になっています。運用が増えてくると探しにくくなるため、テンプレート名は社内で通じる名前に、出力ファイル名は渡す相手にわかる名前に、それぞれ整えておくのがおすすめです。
一覧やファイル更新などの操作は、マニュアルの書類作成用テンプレートの登録と編集で解説しています。
書類作成を実行するlink
登録したテンプレートを使って、実際に書類を作成します。
書類作成は、ドキュメント一覧で対象のドキュメントを選択して実行するほか、ドキュメント詳細画面の個別ファイル出力からも実行できます。ここでは、発注書①の詳細画面から書類作成を選びました。
書類作成用テンプレート選択の画面で、使用するテンプレートを1つ選びます。
テンプレート名の右には、実際に出力されるファイル名(【株式会社架空商事】20261030_発注指示書)が表示されます。画面下の出力オプションでは、次の3つを切り替えられます。
| オプション | 内容 |
|---|---|
| PDF出力 | Excelではなく、PDF形式で出力する |
| CSV展開 | CSV形式の解析結果をセルごとに展開する(テンプレートの設定が初期値) |
| テンプレート変数を表示 | 対応する解析結果が見つからない変数を、そのまま出力する |
プレビューをクリックすると、変数が実際の解析結果に置き換わった結果を確認できます。
適用前にテンプレート変数、適用後に差し込まれる値が並びます。ここで意図した解析項目が使われているかを確認してから、書類作成をクリックすると、ファイルがダウンロードされます。
出力結果を確認して整えるlink
出力されたファイルを開いて確認します。1枚目は、取引先コード・取引先名・発注日・納期・納品先がすべて正しく差し込まれました。
ところが、2枚目の明細を見ると、列がずれています。
「単位」の列に仕入単価の数字が入り、「商品管理部への指示・注意」の列に単位が入ってしまっています。
原因は、{{発注書.発注明細}}という解析項目の変数を使ったことです。この変数は、表項目の全列を左から順にそのまま展開します。
| 列の並び | |
|---|---|
| 発注明細(解析項目) | 商品コード/品名/数量/仕入単価/単位/備考 |
| テンプレート(明細シート) | 商品コード/品名/数量/単位/商品管理部への指示・注意 |
発注明細には仕入単価がありますが、発注指示書では使いません。この1列分だけ、4列目以降がずれてしまったというわけです。
表項目のテンプレート変数で列を指定するlink
必要な列だけを、置きたい場所に出力したい場合は、表項目のテンプレート変数を使います。テンプレート変数の一覧で発注明細を展開すると、列ごとの変数が確認できます。
テンプレートの明細シートを開き、{{発注書.発注明細}}を削除して、各列に対応する変数を1つずつ配置し直します。
仕入単価の変数は置かないため、テンプレートの列構成どおりに出力されるようになります。
Tips:2つの変数の使い分け
| 使う変数 | 向いているケース |
|---|---|
| {{発注書.発注明細}}(解析項目の変数) | 表項目の全列をそのままの順番で出したい |
| {{発注書.発注明細.品名}}(表項目の変数) | 一部の列だけ出したい、順番を入れ替えたい、離れた列に出したい |
テンプレートの列構成と解析項目の列構成が完全に一致していない場合は、表項目の変数を使うほうが確実です。
テンプレートを更新して出力し直すlink
修正したファイルを、同じテンプレートに上書きします。テンプレートの操作メニューからファイル更新を選び、修正したファイルを選択します。
新しくテンプレートを登録し直す必要はありません。ファイル更新を使えば、テンプレート名・出力ファイル名・関連ドキュメントタイプなどの設定を保ったまま、中身のファイルだけを差し替えられます。
もう一度書類作成を実行すると、明細が正しい列に出力されました。
テンプレートは、一度で完璧に作れることのほうが少ないと考えてください。今回のように、実際に出力してみて初めて気づくずれもあります。
本運用を始める前に、様式の異なる書類で1通ずつ出力して確認するところまでをセットにしてください。
テンプレート変数は、ドキュメントタイプ名と解析項目名の組み合わせで解析結果を探します。そのため、ドキュメントタイプ名や解析項目名を変更すると、テンプレート側の変数と一致しなくなり、解析結果が出力されなくなります。名前を変更した場合は、テンプレートの変数もあわせて修正してください。
ここまでで準備できていることlink
- 書類作成の流れ(テンプレートを作る → 登録する → 実行する)を理解できている
- 発注指示書のExcelが、テンプレート変数を埋め込んだ書類作成用テンプレートになっている
- テンプレートが登録され、取引先名と出力日を含むファイル名で、取引先ごとに別々に出力される設定になっている
- 書類作成を実行し、出力結果を確認して、ずれていた明細をテンプレートの修正で直せている
これで、2つのアウトプット(基幹システム取込データ・発注指示書)が、どちらもドキュメントフォースから出力できるようになりました。次のページドキュメントを確認するでは、出力する前に解析結果を確認・修正する手順に進みます。
