Power Automate を使用した SharePoint リストからの PDF 生成: Handlebars テンプレートと HTML から PDF への請求書ワークフロー

PDF4me ドキュメント生成 シングル これは、Handlebars HTMLテンプレートとJSONペイロードをレンダリングして完成したHTMLドキュメントを作成するPower Automateアクションです。このドキュメントは、ペアになっている「HTMLをPDFに変換」アクションによってA4サイズにページ分割されます。SharePointリストに新しい行が追加されるとフローが開始され、ComposeがJSONを組み立て、Dropboxが請求書番号にちなんだ名前の請求書PDFを保存します。プレミアムコネクタもコードも不要です。

どの財務チームもPower Automateで同じ壁にぶつかる。 ファイル変換 このアクションにはプレミアムライセンスが必要で、HTMLテンプレートには手を加えません。Adobe PDF Servicesには費用がかかります。Encodianにも費用がかかります。matthewdevaneyの人気の回避策はHTMLを完全にスキップし、Power Appsにロックします。以下のパターンは、SERPの上位10位の誰もエンドツーエンドで表示していないものです。SharePointリストの列セットがJSONペイロードになり、実際の ハンドルバーテンプレート ファイルの場所 /Shared Documents/また、無料プランのコネクタ料金では、2つのPDF4meアクションがレンダリングとページネーションを実行します。

Handlebarsテンプレートのレンダリング：PDF4meと代替サービスの比較​

Power Automateのアーキテクトが請求書PDF用のコネクタを選ぶ前に必ず行う比較：

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

得られるもの​

入力： SharePoint リスト Invoices （列：タイトル、請求書日付、支払期日、顧客名、顧客住所、顧客メールアドレス、通貨、小計、税率、税額、合計金額、メモ）と、単一のHandlebarsテンプレートが /Shared Documents/invoice_template.html。 出力： Dropbox に A4 PDF を 1 行ずつ保存し、名前を {Title}.pdf （INV-1005はINV-1005.pdfになります。）

必要なもの​

フローの概要​

1. アイテムが作成されると (SharePoint トリガー) Invoices リスト）。
2. 作曲する ネストされたJSONペイロード（請求書／顧客／アイテム／合計／メモ）。
3. パスを使用してファイルコンテンツを取得します のために /Shared Documents/invoice_template.html。
4. PDF - ドキュメント生成（単一） テンプレート本文とJSON、出力タイプはHTML。
5. HTMLをPDFに変換する A4縦向き、縮尺0.8、余白40px、背景印刷あり。
6. ファイルを作成する Dropbox内 /、 ファイル名 {Title}.pdf。

フローの概要全体​

エンドツーエンドの実行。11秒かかるHTMLからPDFへの変換処理はページネーションによるもので、それ以外はすべて0.5秒未満です。

ステップ1：新しいSharePoint請求書でPower Automateフローをトリガーするにはどうすればよいですか？​

これまでの流れ： 流れはここから始まる。

SharePointトリガーを、請求書の行が格納されているサイトとリストに設定します。すると、各列が下流で動的なコンテンツになります。

1. 追加 SharePoint > アイテムが作成されると 引き金として。
2. 設定する:
   • サイトアドレス: SharePoint サイトを選択します (サンプルでは: PDF4me Sharepoints - https://ynoox1.sharepoint.com/sites/PDF4meSharepoints)
   • リスト名: Invoices。
3. 保存して、トリガーにリストスキーマを検出させます。下のスクリーンショットの行（INV-1002、INV-1003、INV-1005）は、Handlebarsテンプレートが使用する正確な12列を示しています。

請求書一覧​

SharePointリストが信頼できる情報源です。ここにある各列は、Handlebarsペイロードの1つのフィールドに対応しています。

トリガー設定​

トリガーとなるのはたった2つのフィールドだけです。それ以外の要素はすべて行から取得されます。

ステップ2：SharePointの行からHandlebarsのJSONペイロードを構築するにはどうすればよいですか？​

これまでの流れ： SharePointトリガー。

Compose は 12 個のフラットな SharePoint 列を、Handlebars テンプレートが反復処理するネストされた JSON に整形します。テンプレートは、 invoice、 customer、 items 配列、 totals、そして notes 弦。

1. 追加 作曲する。
2. で 入力以下の JSON を貼り付け、対応する SharePoint の動的コンテンツ ピルを各値の引用符の間にドロップして、数値と日付が文字列として表示されるようにします。

{
  "invoice": {
    "number": "Title",
    "date":   "InvoiceDate",
    "dueDate": "DueDate"
  },
  "customer": {
    "name":    "CustomerName",
    "address": "CustomerAddress",
    "email":   "CustomerEmail"
  },
  "items": [
    { "description": "Item1Description", "quantity": "Item1Qty", "unitPrice": "Item1UnitPrice", "lineTotal": "Item1Amount", "currency": "Currency" },
    { "description": "Item2Description", "quantity": "Item2Qty", "unitPrice": "Item2UnitPrice", "lineTotal": "Item2Amount", "currency": "Currency" },
    { "description": "Item3Description", "quantity": "Item3Qty", "unitPrice": "Item3UnitPrice", "lineTotal": "Item3Amount", "currency": "Currency" },
    { "description": "Item4Description", "quantity": "Item4Qty", "unitPrice": "Item4UnitPrice", "lineTotal": "Item4Amount", "currency": "Currency" },
    { "description": "Item5Description", "quantity": "Item5Qty", "unitPrice": "Item5UnitPrice", "lineTotal": "Item5Amount", "currency": "Currency" }
  ],
  "totals": {
    "currency":   "Currency",
    "subTotal":   "Subtotal",
    "taxRate":    "TaxRate",
    "taxAmount":  "TaxAmount",
    "grandTotal": "GrandTotal"
  },
  "notes": "Notes"
}

構成設定​

コードビューで作成します。各JSON値は2つの引用符で囲まれたSharePointのピルなので、数値と日付はHandlebarsテンプレートでレンダリングできる文字列として渡されます。

参考資料：SharePoint列からHandlebarsへのパス​

SharePointの列と、それがテンプレート内のどこに配置されるかの正確なマッピングを示します。スキーマを拡張する際は、この表をブックマークしておいてください。

ステップ3：SharePointからHandlebarsテンプレートファイルを読み込むにはどうすればよいですか？​

これまでの流れ： SharePointトリガーとComposeの組み合わせ。

テンプレートをプレーンテキストとして保存します .html サイトのドキュメントライブラリにあるファイル。パスを使用してファイルコンテンツを取得するアクションは、その生のバイト列を読み取るため、ドキュメント生成（単一）アクションはそれをテンプレート本文として使用できます。

テンプレート自体​

テンプレートは通常のHTMLにインラインCSSを加えたもので、データが格納される場所にHandlebars式が記述されています。実際の処理は2つの構成要素によって行われます。 {{#each items}} 行項目ごとに表の行が繰り返され、 {{#if description}} 内部のガードは、使用されていないItem4列とItem5列によって残された空白をスキップします。

<tbody>
  {{#each items}}
  {{#if description}}
  <tr>
    <td>{{description}}</td>
    <td class="num">{{quantity}}</td>
    <td class="num">{{currency}}{{unitPrice}}</td>
    <td class="num">{{currency}}{{lineTotal}}</td>
  </tr>
  {{/if}}
  {{/each}}
</tbody>

それ以外のものはすべて直接的な代替品です。 {{invoice.number}} ヘッダーでは、 {{customer.*}} 請求先ブロック、 {{totals.*}} 合計表では、 {{notes}} フッターに。

1. 追加 SharePoint > パスを使用してファイルコンテンツを取得します。
2. 設定する:
   • サイトアドレス: トリガーと同じサイト。
   • ファイルパス: /Shared Documents/invoice_template.html。
   • コンテンツタイプを推測する: Yes （デフォルト設定のままにしてください。）

パスを使用してファイルコンテンツを取得します​

テンプレートは /Shared Documents/ 絶対パスで取得されます。SharePointファイルなので、バージョン履歴は自動的に取得されます。

ステップ4：PDF - ドキュメント生成（単一）は、Handlebarsテンプレートにどのように入力されますか？​

これまでの流れ： SharePointトリガー、Compose、およびパスを使用したファイルコンテンツの取得機能。

ドキュメント生成（シングル）はテンプレートエンジンです。Handlebars ソースを読み込みます（{{invoice.number}}、 {{#each items}}...{{/each}}JSONペイロードから値を代入し、レンダリングされたHTMLを返します。ページネーションは行いません。それは次のステップの役割です。

1. 追加 PDF4me PDF > PDF - ドキュメント生成（単一）。
2. 設定する:
   • テンプレートファイルの種類: Html (Handlebars Syntax)。
   • テンプレートファイル名: invoice_template.html。
   • テンプレートファイルデータ: 動的なコンテンツ、 Body SharePointの「ファイルコンテンツの取得」ステップから。
   • 文書データタイプ: Json。
   • 文書データテキスト: 動的なコンテンツ、 Body 構成ステップから。
   • 出力タイプ: Html。
   • PDFテンプレートを編集可能にする: No。

ドキュメント生成（単一）設定​

出力タイプは Html、 ない Pdf. ドキュメント生成 (単一) は、レンダリングされた HTML を次のステップに渡すため、ページネーションは独立したテスト可能な問題として残ります。

ステップ5：レンダリングされたHTMLをA4サイズのPDFにページ分割するにはどうすればよいですか？​

これまでの流れ： SharePointトリガー、Compose、パスを使用したファイルコンテンツの取得、PDF - ドキュメントの生成（単一）。

HTMLをPDFに変換する機能は、ページネーションエンジンです。Generate Document (Single)によって生成されたHTMLを読み込み、ページサイズと余白を適用して、PDFバイトを返します。

1. 追加 PDF4me PDF > HTMLをPDFに変換する。
2. 設定する:
   • ファイルの内容: 動的なコンテンツ、 Body 「ドキュメント生成（単一）」ステップから。
   • HTMLファイル名: invoice.html。
   • ページレイアウト: Portrait。
   • ページサイズ: A4。
   • 規模: 0.8 （5項目の請求書が1ページに収まります。）
   • 上/下/左/右の余白: 40px それぞれ。
   • プリント背景: Yes （合計ブロックの背景色を表示します。）

HTMLをPDFに変換する設定​

スケール0.8では、5行の請求書がA4用紙1枚に収まります。項目数が少なく、フォントサイズを大きくしたい場合は、0.9または1.0に上げてください。

ステップ6：請求書のPDFファイルを、分かりやすい名前でDropboxに保存するにはどうすればよいですか？​

これまでの流れ： SharePoint トリガー、作成、パスを使用したファイルコンテンツの取得、PDF - ドキュメントの生成 (単一)、HTML から PDF への変換。

最終ステップでは、PDFファイルを請求書番号に関連付けられた名前のDropboxフォルダに保存します。

1. 追加 Dropbox > ファイルを作成する。
2. 設定する:
   • フォルダパス: / （または次のようなサブフォルダ） /invoices/)
   • ファイル名: 動的なコンテンツ、 Title SharePointトリガーから、リテラル文字列が続きます .pdf. INV-1005 は INV-1005.pdf。
   • ファイルの内容: 動的なコンテンツ、 Body 「HTMLをPDFに変換する」ステップから。

ファイル構成を作成する​

請求書番号をファイル名に付けることで、Dropboxフォルダは自動的に検索可能で重複のない請求書アーカイブになります。

フローを実行して検証する​

1. 保存 右上の流れ。
2. 新しい行を追加する Invoices SharePoint リスト。タイトルを認識できるものに設定します (INV-1005）すべての列にデータを入力して、テンプレートに実際のデータが含まれるようにします。
3. 流れを開く 実行履歴 そして、最新の実行結果を選択してください。フローの概要画面のスクリーンショットと同様に、すべてのカードが緑色になっているはずです。「HTMLをPDFに変換」カードが最も遅い（約11秒）のは、そこでページネーションが行われるためです。
4. Dropboxを開いて確認してください INV-1005.pdf （またはタイトル）はルートディレクトリにあります。ダウンロードして開き、サンプルと比較してください。

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

よくある質問​

Power Automateを使用してSharePointリストアイテムからPDFを作成する方法は？​

SharePoint を使用する When an item is created トリガーとして、 Compose 行のフラットな列をネストされた JSON ペイロードに整形するアクション、 Get file content using path HTMLテンプレートを読み込むためのアクション /Shared Documents/PDF4me Generate Document (Single) JSONをテンプレートにマージし、PDF4me Convert HTML to PDF 結果をページ分割します。出力は任意のファイルコネクタ（Dropbox、OneDrive、SharePoint）に保存します。この一連のアクションはすべて標準コネクタティアで実行されるため、Power Automate Premium ライセンスは不要です。

Power AutomateでPDFを生成できますか？​

はい。ネイティブの Power Automate は HTML テンプレートから PDF を単独でレンダリングすることはできませんが、 PDF4me コネクタは、それを可能にする2つのアクションを追加します。 Generate Document (Single) テンプレートのレンダリングと Convert HTML to PDF ページネーション機能を提供します。どちらも標準プランで、無料でインストールできます。これらを組み合わせることで、SharePoint、Dataverse、Excelの任意の行を、データと同じ場所に保存されている編集可能なHTMLテンプレートを使用して、ブランド化されたPDFに変換できます。

Power AutomateでHTMLからPDFを作成する方法は？​

追加する PDF4me HTMLをPDFに変換する フローのスコープ内に HTML がある場所ならどこでもアクションを実行します (Compose 出力、Get file content Body、Compose 式、webhook ペイロード)。ページ サイズを設定します (A4)、レイアウト (Portrait) 余白 (40px)、そして設定する Print Background: Yes そのため、CSS の背景は保持されます。アクションの Body 出力とは、ストレージアクションに渡すPDFバイナリのことです。これは、上記のステップ5で使用したアクションと同じです。

Power Automateはプレミアム版なしでHTMLをPDFに変換できますか？​

はい。PDF4meコネクタの「HTMLをPDFに変換」アクションは標準コネクタティアに属しているため、ネイティブのプレミアムライセンスアップグレードなしで、どのPower Automateプランにもインストールして使用できます。 Convert File Adobe PDF Servicesコネクタには、PDF4me APIキーが必要です（無料プランあり）。このキーは、アクションを初めて追加する際に貼り付けます。

Power AutomateでテンプレートからPDFを生成する方法は？​

使用 PDF4me ドキュメント生成（単一） と Template File Type: Html (Handlebars Syntax) (HTMLテンプレートの場合)または Word （のために .docx テンプレート）。テンプレートバイトを Template File Data そしてJSONペイロードを Document Data Text。 セット Output Type: Html 後でページネーションする必要がある場合（このブログのように）、または Pdf PDF を 1 ステップで取得します。このアクションは、以下の完全な Handlebars 構文をサポートしています。 {{#each}} そして {{#if}} 明細項目と条件付きブロックの場合。

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

次のステップ​

同じ6つのステップ（行、テンプレート、レンダリング、ページネーション、名前、ストア）のパターンで、HTMLで記述できる行ごとのブランド付きPDFを処理できます。