メインコンテンツまでスキップ

Zapierの「ドキュメント生成」アクション:PDF4meを使用してWordテンプレートをメールマージして完成したPDFを作成する

18分読み取り
PDF4me Team

ドキュメントを生成する PDF4meは、Zapier用のアクションで、メールマージを実行します。Word、HTML、またはPDFテンプレートとJSONまたはXMLデータファイルを受け取り、入力済みのドキュメントを返します。Zapはフォルダを監視し、各レコードをマージして、Wordを開くことなくすべての結果を保存できます。

世の中にあるメールマージのチュートリアルはどれも、Wordでウィザードを使ってクリック操作を行うことを前提としています。確かに一度はそれでうまくいきますが、定期的に何百枚もの請求書を作成する必要がある場合や、データが個人のデスクトップにあるスプレッドシートではなくシステムから送られてくる場合には通用しません。この記事では、テンプレートの構文と、自動でマージを実行するZapについて解説します。

流れの概要
1. New File in Folder
Dropbox trigger watching the folder your data lands in.
2. Find File
Dropbox fetches the Word template from its own folder.
3. Generate Document
PDF4me merges the data into the template.
4. Create Loop From Line Items
Only needed when the merge returns many documents.
5. Upload File
Dropbox saves each finished document.
短縮版

二重山括弧構文を使用して、Word 文書に差し込みフィールドを書き込みます。そのテンプレートを 1 つの Dropbox フォルダに保存し、データを別のフォルダに保存します。Zap がデータを取得し、両方のファイルを PDF4me の「文書生成」アクションに渡して、結合された結果を保存します。1 回の実行で 1 つの文書を生成する場合は「単一」アクションを、1 つのデータ配列から複数の文書を生成する場合は「複数」アクションを選択してください。

なぜ?という問いに対する質疑応答​

コードで文書を作成するのではなく、Wordテンプレートを使用する理由は何ですか? なぜなら、文言の所有者とコードの所有者はめったに一致しないからです。Wordテンプレートは請求書の原稿を作成する人が誰でも編集でき、次の実行時には展開や開発者の関与なしにその変更が反映されます。

スプレッドシートではなく、JSONやXMLを使う理由とは? これらはシステムが出力するデータ形式です。Wordの差し込み印刷機能は、人間がエクスポートしたシートを読み込みます。注文やフォーム送信がトリガーとなる場合、データは既に構造化されているため、差し込み印刷機能はその形式でデータを受け入れる必要があります。

なぜ「ドキュメント生成」アクションが2つあるのですか? 「Generate Document Single」は1つのレコードをマージして1つのファイルを返します。「Generate Documents Multiple」は配列を受け取り、要素ごとに1つのファイルを返します。バッチ処理を期待していたのにZapが単一のドキュメントしか生成しないのは、通常、誤った選択が原因です。

テンプレートを専用フォルダに保存しておく理由は何ですか? トリガーはデータフォルダを監視します。テンプレートがデータと同じ場所に存在する場合、改訂されたテンプレートをアップロードするとZapが起動し、テンプレートをレコードであるかのようにマージしようとします。


得られるもの​

入力: 差し込み印刷フィールドを含むWordテンプレートと、JSONまたはXMLレコード。 出力: 結合された文書はクラウドストレージに保存され、送信またはアーカイブする準備が整います。


必要なもの​

  • ザピアー。 PDF4me Zapierアプリを開く複数のステップからなるZapを実行するには、Zapierの有料プランが必要です。
  • PDF4me APIキー。 APIキーを取得してくださいPDF4meアクションを初めて追加する際に接続してください。
  • クラウドストレージ テンプレート用のフォルダと、受信データ用のフォルダを別々に用意する。
  • Wordテンプレート 下記のPDF4me構文で記述された差し込みフィールドを使用します。

メールマージとは何か、一言で説明してください。​

差し込み印刷では、データソースから値を読み込み、それぞれの値をテンプレート内の対応するプレースホルダーに挿入します。必要なのは、差し込みフィールドを格納するテンプレートと、値を提供するデータソースの2つです。差し込み印刷エンジンはこれらを結合し、レコードごとに完成した文書を1つ返します。

PDF4meは受け入れます Word、HTML、PDF テンプレート。Wordは3つの中で最も機能が豊富です。構文が単純な検索と置換だけでなく、条件、表、繰り返しセクション、画像、インラインHTMLをサポートしているからです。

Wordテンプレートはどのようにデザインするのですか?​

マージフィールドでは、フィールド名を二重山括弧で囲みます。

<<[FieldName]>>

値を適切な場所にWord文書に挿入してください。角括弧内の名前は、JSONまたはXMLレコード内のキーに対応します。

Wordテンプレート構文リファレンス​

あなたは欲しい文書
構文全体(最初から最後まで)概要
条件文テキストコントロール
データ量に応じて拡張するテーブル表
段落やセクションを繰り返す段落を繰り返す
画像の挿入画像を挿入
生のHTMLを挿入するHTMLを挿入
数値と日付の書式設定書式設定
変数とリスト変数
PDF請求書用のWord差し込み印刷テンプレートのサンプル。条件付き行を含む表の中に、二重山括弧で囲まれた差し込みフィールドが表示されています。

表と条件を使用した請求書テンプレートのサンプルです。表の行は、データ内の各明細項目ごとに1回繰り返されます。


ドキュメント生成Zapはどのように構築するのですか?​

Zapには4つの構成要素があります。開始するためのもの、テンプレート、マージ、そして結果を格納する場所です。

  1. トリガー。 データが到着する場所に合わせてトリガーを選択します。Dropbox の場合、 フォルダ内の新しいファイル あなたのデータフォルダを指し示してください。
  2. テンプレートを取得します。 トリガーは到着したばかりのファイルのみを運ぶので、テンプレートは別々に読み取ってください。Dropbox の場合、 ファイルの検索テンプレートのファイル名と全く同じ名前のテンプレートフォルダを指定しました。
  3. マージ。 PDF4meを追加する ドキュメントを生成する アクションを実行し、両方のファイルをそのアクションにマッピングします。
  4. 保存。 追加 ファイルのアップロード 結果を書き戻す。マージによって複数のドキュメントが返された場合は、これを 明細項目からループを作成する ステップから Zapierによるループ機能 つまり、ドキュメントごとに一度実行されるということです。

ドキュメントパラメータを生成する​

パラメータ必須その機能
テンプレートファイル必須テンプレート自体は、それを取得したステップからマッピングされます。
テンプレートファイルの種類必須提供されたテンプレートの種類は、Word、HTML、それともPDFですか?
入力データ形式タイプ必須データがテキスト形式で届くか、ファイル形式で届くかに関わらず。
データテキストまたはデータファイル必須記録。どの欄に記入するかは、上の行の内容によります。
入力データタイプ必須データの形式:JSONまたはXML。
テンプレートファイル名オプションアクションのテンプレート名を指定します(拡張子を含む)。
出力ドキュメントタイプオプション生成されるドキュメントのフォーマット。
PDFを編集可能な状態に保つオプション出力時に編集可能なフォームフィールドを残します。
メタデータオプションマージ処理に渡される追加値。

ヒント。 テンプレートファイルの種類と入力データの種類は、最もよく不一致になる組み合わせです。出力結果にプレースホルダーが表示されたままになっている場合は、まずこの2つを確認してください。マージ処理自体は実行されていますが、マージ対象として認識できるデータがなかっただけです。

シングルループとマルチループの違い、そしてループが必要な場合​

シングル対マルチドキュメントを生成 シングル複数のドキュメントを生成する
データ形状1枚のレコード配列、ドキュメントごとに1つのオブジェクト
返品1つの文書配列要素ごとに1つのドキュメント
その後にループが必要ですいいえはい、各結果を保存します
典型的な使用例1つの注文につき1枚の請求書1つのエクスポートからのステートメントのバッチ
PDF4meのメールマージ機能で生成されたPDF請求書。テンプレートのマージフィールドは実際の値に置き換えられています。

統合された出力結果です。テンプレート内のすべてのプレースホルダーが置き換えられ、テーブルは各行項目につき1行に拡張されています。


Zapを実行して検証する​

  1. 公開 ザップ。
  2. サンプルレコードをデータフォルダにドロップし、トリガーがポーリングするまで待ちます。
  3. 開ける ザップランズ そして、「ドキュメント生成」ステップでエラーではなくファイルが返されたことを確認します。
  4. 出力結果を開き、次の2点を確認してください。プレースホルダーが表示されていないこと、そして繰り返し表の行数が正しいこと。

実際に何を作ったのですか? テンプレートの文言は、Zap の管理者ではなく、テンプレートを編集したユーザーが所有するドキュメント ファクトリーです。テンプレートを変更すると、次回の実行時にその変更が適用されます。同じパターンは、Make、n8n、Power Automate で同じアクションを使用して実行されます。


再構築せずに追加できる一般的なバリエーション​

文書をメールで送信する
GmailまたはOutlookの手順を追加して結合ファイルを添付すれば、受信者はストレージを開かなくてもファイルを受け取ることができます。
送信前に署名してください
PDF4meの署名アクションを結合後に挿入することで、文書が既に署名済みの状態で出力されるようになります。
フォームから始める
DropboxトリガーをフォームまたはWebhookトリガーに置き換え、入力データ形式タイプをテキストに設定し、ペイロードをそのまま貼り付けます。
結果を変換する
テンプレートの種類と出力形式が異なる場合は、結合処理の後にHTMLをPDFに変換するか、フォーマット変換を実行してください。

よくある質問​

メールマージとは何ですか?​

データソースから値を読み込み、それぞれの値をテンプレート内の対応するプレースホルダーに挿入することで、レコードごとに完成したドキュメントを1つ生成します。Wordのウィザード機能によってこの用語が普及しましたが、操作自体はWordとは何の関係もありません。テンプレートとデータ形式を理解できるエンジンであればどれでも実行でき、それが「ドキュメントの生成」アクションです。

Wordで差し込み印刷を行うにはどうすればよいですか?​

もしあなたが意味するなら デスクトップウィザードスプレッドシートをWordに指定し、ダイアログの手順に従って操作します。ウィザードを使わずにWordテンプレートをマージする場合は、上記の二重山括弧構文を使用してフィールドを記述し、テンプレートとJSONまたはXMLレコードをGenerate Documentに渡します。テンプレートは依然としてWordファイルであり、出力のためにWordが開かれることはありません。

Wordを使わずに差し込み印刷はできますか?​

はい。マージ処理はPDF4me APIを介して行われるため、Wordは一切使用されません。Word、または.docxファイルを作成できるエディタが必要なのは、テンプレートを作成する時だけです。Wordを使いたくない場合は、PDF4meはHTMLやPDFテンプレートにも対応しています。

1つのテンプレートから複数のドキュメントを生成するにはどうすればよいですか?​

使用 複数のドキュメントを生成する そして、ドキュメントごとにオブジェクトが1つずつ配列に渡します。要素ごとにドキュメントが返されます。次に、アップロード手順を 明細項目からループを作成する 各結果が最初の結果だけでなく個別に保存されるようにするアクション。


トラブルシューティング​

出力には依然としてマージフィールドが表示されます

データがテンプレートと一致しませんでした。入力データタイプがレコードの実際の形式と一致していること、レコードが有効であること、キー名が山括弧内の内容(大文字・小文字を含む)と一致していることを確認してください。

バッチからは1つのドキュメントのみが出力されます

複数処理が必要な場面で単一処理が使用されたか、アップロード手順がループの外に配置されているかのどちらかです。どちらの場合も、入力されたレコード数に関わらず、保存されるファイルは正確に1つになります。

繰り返しテーブルには1行あります

テンプレート内で繰り返し領域がマークアップされていませんでした。拡張可能なテーブルでは、行の周囲に繰り返し構文が必要であり、行内のマージフィールドだけでは不十分です。繰り返し段落に関するドキュメントを参照してください。

テンプレートを編集すると、Zapが起動します。

テンプレートは監視対象フォルダ内にあります。それを専用フォルダに移動し、フェッチ手順でそのフォルダを指定してください。


次のステップ​

同じ4つのステップ(監視、テンプレートの取得、マージ、保存)のパターンで、「データ入力、ブランド化されたドキュメント出力」の自動化をすべて処理できます。