PolyDoc (独立したPublisher) (プレビュー)

HTML または URL をピクセルに完全な PDF とスクリーンショットに変換し、EU 準拠のハイブリッド電子請求書 (ZUGFeRD/Factur-X) を生成します。 PolyDoc は実際のブラウザー エンジンでレンダリングされるため、ページに表示される内容はドキュメントに表示されます。

このコネクタは、次の製品とリージョンで使用できます。

Service クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate（パワーオートメート） Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
連絡先
名前 PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
コネクタ メタデータ
Publisher blue-d3v
Website https://polydoc.tech
プライバシー ポリシー https://polydoc.tech/legal/privacy-policy/
カテゴリ コンテンツとファイル

PolyDoc

PolyDoc は、HTML または URL をピクセル完璧な PDF とスクリーンショットに変換し、EU 準拠のハイブリッド電子請求書 (ZUGFeRD/Factur-X) を生成します。 変換は実際のブラウザー エンジンでレンダリングされるため、ページに表示される内容はドキュメントに表示されます。

Publisher

PolyDoc

前提条件

PolyDoc アカウントと API キーが必要です。 Free レベルでは、コネクタを評価するのに十分です。 カスタム コネクタは Premium Power Automate機能であるため、このコネクタを使用するフローには、組み込みの HTTP アクションと同じPower Automate Premium プラン (ユーザーごとまたはフローごと) が必要です。

資格情報の取得

  1. dashboard.polydoc.tech でサインインします。
  2. API キーを開き、キーを作成します。
  3. 接続を作成するときに、 PolyDoc API キーにキーを貼り付けます。 キーのみを貼り付けます。コネクタによって、 Bearer プレフィックスが自動的に追加されます。

サポートされている操作

Operation それが何をするか
PDF に変換 HTML、URL、または保存されたテンプレートを PDF にレンダリングします。 ページ形式、余白、スケール、ヘッダー/フッター、ブックマーク、アクセシビリティ対応 (タグ付き) PDF、メタデータ、暗号化、透かし、PDF/A のコントロール。
キャプチャのスクリーンショット HTML、URL、またはテンプレートの PNG、JPEG、または WebP をキャプチャします。 ビューポートとデバイスのピクセル比コントロールを使用して、ページ全体またはクリップします。

電子請求書 は、 PDF への変換を使用して生成されます。 E-invoice フィールド (標準、プロファイル、構造化 invoice オブジェクト) に入力し、PolyDoc は返された PDF に ZUGFeRD/Factur-X 請求書を埋め込みます。 すぐに使用できる本文については、コネクタ リポジトリの example-flows/ フォルダーを参照してください。

Source

すべての操作は、次のいずれかである単一の ソース を受け取ります。

  • URL (例: https://example.com
  • インライン HTML 文字列
  • 保存されたテンプレート参照 ([template:TEMPLATE_ID])、必要に応じて Liquid レンダラーのテンプレート データ

配送

既定では、ファイルはバイナリ コンテンツとして返され、ファイルの作成 (OneDrive、SharePoint、BLOB) または電子メールの添付ファイルにドロップできます。 高度なオプションでは、次の 2 つの代替配信モードを使用できます。

  • クラウド ストレージ: 署名済みの PUT URL を指定します。PolyDoc はファイルをアップロードし、アクションは格納されている URL を含む JSON を返します。
  • Webhook: PolyDoc は Webhook にファイルを配信し、アクションは JSON 受信確認 (非同期の場合は HTTP 202) を返します。

いずれかの配信モードを使用すると、応答はバイナリ ファイルではなく JSON になります。

サンドボックス モード

各操作には、高度な サンドボックス モード の入力があります。 trueに設定すると、レート制限が低い別のクォータから透かし付き出力が生成されます。これは、フローの構築とテスト中に役立ちます。 運用ドキュメントの場合は false のままにします。

既知の問題と制限事項

  • 各アクションの応答はバイナリ ファイルとして宣言されます。 クラウド ストレージまたは Webhook 配信が構成されている場合、アクションはファイルではなく JSON を返します。
  • 外部 CDN から JavaScript を読み込むページでは、コンバーターの速度が大幅に低下する可能性があります。 インライン HTML の場合は、自己完結型マークアップ (インライン CSS、データ URI イメージ) を使用します。
  • 電子請求書は EN 16931 に従います。 少なくとも、期限または支払条件 (ルール BR-CO-25)、明細行で VAT カテゴリ Sを使用する場合の販売者税 ID、および一貫した合計 (net + tax = gross) を指定します。 検証が有効になっている場合、検証に失敗した請求書はエラーを返します。

デプロイ手順

このコネクタは、標準の Power Platform カスタム コネクタ (apiDefinition.swagger.json + apiProperties.json + icon.png) として定義されています。 Power Platform Connectors CLI を使用してデプロイします。

# one-time login
paconn login

# validate the definition
paconn validate --api-def apiDefinition.swagger.json

# create the connector in the selected environment
paconn create --api-def apiDefinition.swagger.json \
  --api-prop apiProperties.json --icon icon.png --secret <none>

apiDefinition.swagger.jsonは、Power Automate Maker ポータルから直接インポートすることもできます (Data > Custom connectors > New custom connector > OpenAPI ファイルのインポート)。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有できません

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ 形容 必須
PolyDoc API キー securestring PolyDoc API キー。 API キーの下 dashboard.polydoc.tech に作成します。 キーのみを貼り付けます。コネクタによって 'Bearer' プレフィックスが追加されます。 True

アクション

PDF に変換する

HTML、URL、または保存されたテンプレートを PDF にレンダリングします。 プレーン PDF ではなく、ZUGFeRD/Factur-X ハイブリッド請求書を埋め込むための電子請求書フィールドを設定します。 ファイルをバイナリ コンテンツとして返します。
キャプチャのスクリーンショット

HTML、URL、または保存されたテンプレートをレンダリングし、PNG、JPEG、または WebP のスクリーンショットをキャプチャします。 画像をバイナリ コンテンツとして返します。

PDF に変換する

操作 ID:
ConvertToPdf

HTML、URL、または保存されたテンプレートを PDF にレンダリングします。 プレーン PDF ではなく、ZUGFeRD/Factur-X ハイブリッド請求書を埋め込むための電子請求書フィールドを設定します。 ファイルをバイナリ コンテンツとして返します。

パラメーター

名前 キー 必須 型 説明
サンドボックス モード
 X-Sandbox string

サンドボックス モードで変換を実行します。 サンドボックスの出力には透かしが付き、レート制限が低い別のクォータから引き出されます。 実稼働ドキュメントには false を使用します。
Source
 source True string

URL (https://...)、インライン HTML 文字列、または [template:TEMPLATE_ID] 形式の保存されたテンプレート参照。
Filename
 filename string

出力ファイル名 (例: invoice.pdf.
テンプレート データ
 templateData object

ソースが [template:ID] 参照である場合に Liquid テンプレート レンダラーに渡されるキー/値データ。
タグ
 tag string

ログ記録と分析用のラベル (最大 30 文字)。
タイムアウト (ミリ秒)
 timeout integer

ミリ秒単位の変換タイムアウト (最大 600000)。
用紙形式
 format string

用紙形式。 既定値は A4 です。
風景
 landscape boolean

横向きを使用します。
背景を印刷する
 printBackground boolean

背景のグラフィックスと色を印刷します。
Scale
 scale number

0.1 から 2 の間のレンダリング スケール。
ページ範囲
 pageRanges string

含めるページ(例: "1-5,8")。 空は、すべてのページを意味します。
アウトライン (ブックマーク)
 outline boolean

HTML 見出しから PDF ブックマークを生成します。
タグ付け (アクセス可能)
 tagged boolean

タグ付けされた (アクセス可能な) PDF を生成します。
CSS ページ サイズを優先する
 preferCSSPageSize boolean

CSS で宣言された @page サイズを Paper 形式で優先します。
背景を省略する
 omitBackground boolean

透明な背景でレンダリングします。
ヘッダー/フッターを表示する
 displayHeaderFooter boolean

ヘッダーテンプレートとフッターテンプレートをレンダリングします。
ヘッダー テンプレート
 headerTemplate string

ページ ヘッダーの HTML。 ヘッダー/フッターを表示する必要があります。
フッター テンプレート
 footerTemplate string

ページ フッターの HTML。 ヘッダー/フッターを表示する必要があります。
トップ
 top string
はい
 right string
最小値
 bottom string
左
 left string
Title
 title string
Author
 author string
サブジェクト
 subject string
キーワード
 keywords array of string
Producer
 producer string
Creator
 creator string
ユーザー パスワード
 userPassword string
所有者パスワード
 ownerPassword string
Source
 source True string

透かしテキスト、または画像の URL/データ URI。
タイプ
 type True string
オプション
 options object

フォント、不透明度、回転、スケール、繰り返し、オフセットの各オプション。
Level
 level True string
コンプライアンスを確認する
 verify boolean
コンプライアンスを確認する
 verify boolean

veraPDF PDF/UA-1 に対して検証します。は、検証が失敗した場合にエラーを返します。
Standard
 standard True string

ハイブリッド請求書標準。
Profile
 profile True string

検証対象のデータ粒度プロファイル。
コンプライアンスを確認する
 verify boolean

PDF/A と電子請求書のコンプライアンスを確認する。は、検証が失敗した場合にエラーを返します。
請求書番号
 number True string
発行日
 issueDate True string

発行日、YYYY-MM-DD。
期限
 dueDate string

期限、YYYY-MM-DD。 この条項または支払条件を指定します (EN 16931 ルール BR-CO-25)。
通貨
 currencyCode True string

ISO 4217 通貨コード (例: EUR)。
名前
 name True string
住所欄1
 line1 True string
住所行 2
 line2 string
市町村
 city True string
郵便番号
 postalCode True string
国コード
 countryCode True string

ISO 3166-1 alpha-2 国コード (例: DE)。
税 ID
 taxId string

VAT 識別子。 品目が VAT カテゴリ S を使用する場合、販売者に必要です。
Email
 email string
電話
 phone string
形容
 description True string
数量
 quantity True number
ユニット コード
 unitCode string

UN/ECE 単位コード (例: C62 (部分)。
単価
 unitPrice True number
行合計
 lineTotal True number
VAT レート (%)
 vatRate number
VAT カテゴリ
 vatCategoryCode string

VAT カテゴリ コード (例: S (標準)、Z (ゼロ)、E (除外)。
カテゴリ コード
 categoryCode True string
Rate (%)
 rate True number
課税対象額
 taxableAmount True number
課税額
 taxAmount True number
支払条件
 paymentTerms string

フリーテキストの支払い条件。 この日付または期限を指定します。
コードを入力する
 typeCode True string

UN/ECE 4461 支払いとは、30 (クレジット転送) などのコードを意味します。
IBAN
 iban string
BIC
 bic string
アカウント名
 accountName string
支払の参照
 paymentReference string
合計純額
 totalNetAmount True number
合計税額
 totalTaxAmount True number
Total gross
 totalGrossAmount True number

net + tax と等しい必要があります。
Note
 note string
購入者のリファレンス
 buyerReference string

公的機関の請求書の購入者参照/Leitweg-ID。
JavaScript を無効にする
 disableJavascript boolean
CSS を挿入する
 css string

ページに挿入された追加の CSS。
JavaScript を挿入する
 javascript string

キャプチャ前にページで実行された JavaScript。
セレクターを待つ
 waitForSelector string

この CSS セレクターが表示されるまで待ちます。
関数を待機する
 waitForFunction string

この JS 式が true を返すまで待ちます。
メディアの種類
 mediaType string
広告をブロックする
 blockAds boolean
ユーザーエージェント
 userAgent string
HTTP ヘッダー
 httpHeaders object

キーと値のペアとしての追加の HTTP ヘッダー。
名前
 name True string
価値
 value True string
URL
 url string
[ドメイン]
 domain string
Path
 path string
有効期限 (エポック)
 expires number
HTTP のみ
 httpOnly boolean
Secure
 secure boolean
同じサイト
 sameSite string
タイプ
 type string
ユーザー名
 username True string
Password
 password True string
ウェブフックURL
 url True string
非同期
 async boolean

バックグラウンドで配信し、すぐに 202 を返します。
Method
 method string
ヘッダー
 headers object

webhook 要求の追加ヘッダー。
タイムアウト (ミリ秒)
 timeout number
再試行
 retries integer
再試行の遅延 (ミリ秒)
 retryDelay number
署名済み URL
 presignedUrl True string

ストレージ プロバイダーからの HTTP PUT の署名付き URL。

返品

response
binary

キャプチャのスクリーンショット

操作 ID:
CaptureScreenshot

HTML、URL、または保存されたテンプレートをレンダリングし、PNG、JPEG、または WebP のスクリーンショットをキャプチャします。 画像をバイナリ コンテンツとして返します。

パラメーター

名前 キー 必須 型 説明
サンドボックス モード
 X-Sandbox string

サンドボックス モードで変換を実行します。 サンドボックスの出力には透かしが付き、レート制限が低い別のクォータから引き出されます。 実稼働ドキュメントには false を使用します。
Source
 source True string

URL (https://...)、インライン HTML 文字列、または [template:TEMPLATE_ID] 形式の保存されたテンプレート参照。
Filename
 filename string

出力ファイル名 (例: screenshot.png.
テンプレート データ
 templateData object

ソースが [template:ID] 参照である場合に Liquid テンプレート レンダラーに渡されるキー/値データ。
画像の種類
 type string

イメージ形式。 既定値は png です。
ページ全体
 fullPage boolean

スクロール可能なページ全体をキャプチャします。
Quality
 quality integer

JPEG/WebP の圧縮品質 0 から 100。
背景を省略する
 omitBackground boolean

透明な背景 (PNG/WebP) でキャプチャします。
幅 (px)
 width integer
Height (px)
 height integer
デバイスのピクセル比
 devicePixelRatio number
X
 x number
Y
 y number
幅
 width number
高さ
 height number
Scale
 scale number
タグ
 tag string

ログ記録と分析用のラベル (最大 30 文字)。
タイムアウト (ミリ秒)
 timeout integer

ミリ秒単位の変換タイムアウト (最大 600000)。
JavaScript を無効にする
 disableJavascript boolean
CSS を挿入する
 css string

ページに挿入された追加の CSS。
JavaScript を挿入する
 javascript string

キャプチャ前にページで実行された JavaScript。
セレクターを待つ
 waitForSelector string

この CSS セレクターが表示されるまで待ちます。
関数を待機する
 waitForFunction string

この JS 式が true を返すまで待ちます。
メディアの種類
 mediaType string
広告をブロックする
 blockAds boolean
ユーザーエージェント
 userAgent string
HTTP ヘッダー
 httpHeaders object

キーと値のペアとしての追加の HTTP ヘッダー。
名前
 name True string
価値
 value True string
URL
 url string
[ドメイン]
 domain string
Path
 path string
有効期限 (エポック)
 expires number
HTTP のみ
 httpOnly boolean
Secure
 secure boolean
同じサイト
 sameSite string
タイプ
 type string
ユーザー名
 username True string
Password
 password True string
ウェブフックURL
 url True string
非同期
 async boolean

バックグラウンドで配信し、すぐに 202 を返します。
Method
 method string
ヘッダー
 headers object

webhook 要求の追加ヘッダー。
タイムアウト (ミリ秒)
 timeout number
再試行
 retries integer
再試行の遅延 (ミリ秒)
 retryDelay number
署名済み URL
 presignedUrl True string

ストレージ プロバイダーからの HTTP PUT の署名付き URL。

返品

response
binary

定義

binary

これは基本的なデータ型 'binary' です。