【TECH COLUMN】D3Workerのサービス「ワーク実行 - PDF結合」の利用例(Salesforce) – OPSS - 株式会社オプロ

本記事では、D3Workerのサービス「ワーク実行 - PDF結合」を用いて、既存のPDFとOPROARTSで生成したPDFを結合し、結合したPDFをWeb配信する方法についてご紹介します。

本記事では例として注文書(既存PDF)と請求書(生成するPDF)の結合を取り上げ、説明します。

事前準備

D3Workerの設定をする前に、以下の2点を準備します。

OPROARTSで請求書のPDFを生成するために、請求書の帳票テンプレートを用意します。
今回は、OPROARTS Designerの「新規作成」で選べるこちらのサンプルを使用します。

本記事では例として以下の注文書を使用します。

本記事でご紹介する処理を実行するには、2つのワークを作成する必要があります。

以下、それぞれのワークについて設定方法を説明していきます。

使用するサービスは以下の2つです。

各サービスの設定方法については以下の記事をご覧ください。
・OPROARTS 設定方法(Salesforce)
・ワーク実行 - PDF結合設定方法(Salesforce)

「ワーク実行 - PDF結合」サービスの設定において、以下の点に留意してください。

「PDFの結合方法」で既存PDF(注文書)と生成する文書(請求書)をどの順番で結合するか指定する(本記事では請求書の後に注文書を結合すべく「文書の後にアップロードされたファイルを結合する」を選択しています)
ワーク②では渡されたCSVデータのフィールド値を使用しないが、実行するワークのデータCSVでは形式的に最低1つのフィールドを用意して値を設定する(これを指定しないとワーク②が動きません)

文書化サービスに「OPROARTS」を基に作成したサービスを、配送サービスに「ワーク実行 - PDF結合」を基に作成したサービスを指定します。

文書化サービス

配送サービス

基本設定で名称とメモを入力したら、「データソース」「エンベロープ」「文書とデータのマッピング」の設定をします。

データソース

ここではワーク①が受け取るCSVデータを、フィールドの順番通りに定義します。
受け取ったCSVデータは、「文書とデータのマッピング」で指定する帳票テンプレートにCSVデータとして渡します。

今回はSalesforceやkintoneと連携せずに直接D3WorkerにCSVデータを渡します。
使用するCSVデータに合わせて文字コードを指定し、先頭行が項目名である場合(実際に使用する値でない場合)は先頭行の「データとして使用しない」にチェックを入れます。

エンベロープ

同じ請求番号を含むCSVデータの行を1つのエンベロープ単位に含めるため、エンベロープフィールドには請求番号フィールドを指定します。

作成したエンベロープを選択したら、アクティブ化するフィールドに「エンベロープフィールド」を指定し、「ELSEとして使用する」にチェックを入れます。

文書とデータのマッピング

上から、文書名に任意の名前を、テンプレート名に使用する帳票テンプレートの名前を入力します。
※テンプレート名には"live_"を先頭につけて「live_{作成したテンプレート名}」と入れてください。

今回使用する帳票テンプレートは明細行とそれ以外の項目を含むヘッダー明細型ですので、データセットを2つ用意します。

それぞれのデータセットについて、「単一行のCSV」(非明細部分)「複数行のCSV」(明細部分)と設定し、データソースのフィールドを帳票テンプレートのCSVフィールドの順番通りになるように並べます。