MakeとPDF4meを使用して動的な請求書を生成する

By Nishanth Asokan | オートメーション

MakeとPDF4meを使用して動的な請求書を生成する

動的文書生成とは、ソースからの動的データを用いてパーソナライズされた文書のバッチを自動的に作成するプロセスです。例えば、請求書は各受取人の名前で宛名を付けるなど、パーソナライズされた形式で作成できます。動的データを用いた文書を作成するには、リスト、スプレッドシート、データベース、JSON、配列などのデータソースが必要です。差し込みフィールドは、定義済みのテンプレート内のプレースホルダーであり、上記データソース、またはその他のサポートされているデータソースからのデータを使用して後で置き換えられます。

動的なデータを含む請求書を作成するには、メールマージやマージフィールドなどのテクニックを適用する必要があります。動的なドキュメントを生成する最も一般的な方法の1つは、テンプレートの設計がはるかに容易になるマスタッシュレンダリングを使用することです。カスタム請求書は、Wordなどのマージフィールド機能を持つフォーム作成ツールを使用して作成されたドキュメントテンプレートに基づいています。ここでは、マスタッシュ構文({{プレースホルダーフィールド}})を使用して作成されたテンプレートの使用について説明します。このテンプレートは、後で動的なデータに置き換えられます。

PDF4me Make のドキュメント生成アクション を使用すると、動的なドキュメントを生成するシナリオを作成して自動化できます。テンプレートと動的なデータが準備できていれば、生成プロセスを自動化できます。テンプレートは、Word ファイル、HTML、またはその他のサポートされている形式にすることができます。データは、スプレッドシート、CSV、JSON、XML、またはデータリストにすることができます。

動的な請求書の生成

Make を使用して動的なデータを含む請求書を生成するには、テンプレートとデータをクラウドストレージプラットフォームに保存する必要があります。少なくとも、テンプレートは Dropbox のようにクラウドストレージに保存する必要がありますが、データは入力データフィールドに直接渡すことができます。

それでは、Make シナリオを使用して、以下のようなサンプル請求書を作成してみましょう。

動的請求書作成用のMustacheテンプレート

私たちのユースケースでは、以下のサンプルがDropboxの場所で利用可能であると想定されています。

ファイル監視トリガーを追加してシナリオを開始

テンプレートファイルの到着を監視するDropboxモジュールを作成します。新しいテンプレートファイルがフォルダに到着するとすぐに、シナリオがトリガーされます。

Dropboxモジュールのファイルアクションを監視

ファイルダウンロードアクション(Dropbox)を追加

ソースフォルダ内でテンプレートファイルが検出されると、ファイルダウンロードアクションを持つDropboxモジュールが、ストレージからPDF4meアクションにファイルを渡します。ファイルダウンロードアクションを2つ追加する必要があります。

テンプレートをダウンロードするためのもの。

Dropboxモジュールのファイルダウンロードアクション

JSONデータをダウンロードするための別の方法

DropboxからJSONデータをダウンロードする

ドキュメント生成アクションにPDF4meモジュールを追加

次に、ドキュメント生成アクションにPDF4meモジュールを追加する必要があります。ここでは、テンプレートタイプ、出力タイプ、および入力データを設定する必要があります。入力データは、フィールドに直接入力することも、今回のケースのようにJSONファイルからデータを取得するように設定することもできます。

PDF4me Make 用のドキュメント生成モジュール

ユースケースのテンプレートにおける入力フィールドのデータは、以下のようになります。

{
"Documents": [

{
"header": {

"docType": "Original Copy"

},

"body": {

"Column1": "Quantity",

"Column2": "Description",

"Column3": "Unit Price",

"Column4": "Total",

"Invoice": {

"number": 14957,

"date": "2022-02-25",

"instructions": "Instruction Invoice 1",

"subTotal": 200150,

"tax": "18%",

"dueDate": "2022-03-25",

"shipping": "200"

},

"Biller": {

"phone": "989797",

"fax": "998463",

"email": "doc1@email.com",

"web": "www.doc1.com",

"address": {
"company": "Organization 1",

"street": "Street 1",

"city": "City 1",

"zip": "123456"

}
},

"Recepient": {
"name": "recepeint 1",

"address": {
"street": "testveien 3 "",

"city": "City 1",

"zipcode": "0555",

"country": "Country 1"

}
},

"Product": [
{
"quantity": 1,

"description": "item 1",

"unitPrice": 45,

"totalPrice": 867

},

{
"quantity": 2,

"description": "item 2",

"unitPrice": 123,

"totalPrice": 3464
},

{
"数量": 3,

"説明": "商品番号 3",

"単価": 323,

"合計金額": 6564

}

]

},

"フッター": {
"電話番号": "phone123",

"FAX番号": "fax123",

"メールアドレス": "123@mail.com",

"ウェブサイト": "www.123.com"

}

}

]
}

複数の出力ファイルを処理するためのイテレータの追加

ご想像のとおり、PDF4me アクションはデータに基づいて複数のファイルを生成します。これを処理するには、次のアクションのために各ファイルを処理するための Make イテレータ モジュールが必要です。

出力ファイル用のフロー制御イテレータ

Dropboxアップロードモジュールを追加して出力ファイルを保存

Dropboxモジュールを作成し、「ファイルのアップロード」アクションを設定して、すべてのファイルを指定したフォルダに保存します。

Dropboxモジュールのファイルアップロードアクション

このシナリオの出力は、以下の文書と似たものになるはずです。

最終統合テンプレート

PDF4meの開発者向けサブスクリプションをご利用いただくと、Makeでシナリオを作成し、動的データを使用したドキュメントの大量生成を低コストで自動化できます。このサブスクリプションにより、API呼び出し回数の不足による自動化の停止を防ぎます。

Related Blog Posts