PolyDoc （独立Publisher） （预览版）

将 HTML 或 URL 转换为像素完美的 PDF 和屏幕截图，并生成符合欧盟标准的混合电子发票（ZUGFeRD/Factur-X）。 PolyDoc 使用真实的浏览器引擎呈现，因此你在页面中看到的内容就是你在文档中得到的内容。

此连接器在以下产品和区域中可用：

Service Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人
名字 PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
连接器元数据
发布者 blue-d3v
Website https://polydoc.tech
隐私策略 https://polydoc.tech/legal/privacy-policy/
类别 内容和文件

PolyDoc

PolyDoc 将 HTML 或 URL 转换为像素完美的 PDF 和屏幕截图，并生成符合欧盟标准的混合电子发票（ZUGFeRD/Factur-X）。 转换在真实的浏览器引擎中呈现，因此你在页面中看到的就是你在文档中得到的内容。

发布者

PolyDoc

先决条件

需要 PolyDoc 帐户和 API 密钥。 免费层足以评估连接器。 自定义连接器是一项高级Power Automate功能，因此使用此连接器的流需要Power Automate高级计划（每用户或每流），这与内置的 HTTP 操作相同。

获取凭据

  1. 登录 dashboard.polydoc.tech。
  2. 打开 API 密钥 并创建密钥。
  3. 创建连接时，请将密钥粘贴到 PolyDoc API 密钥中。 仅粘贴密钥;连接器会为你添加 Bearer 前缀。

支持的操作

运算 它的作用是什么
转换为 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）或电子邮件附件。 高级选项下提供了两种备用交付模式：

  • 云存储：提供预先签名的 PUT URL;PolyDoc 上传文件，操作返回包含存储 URL 的 JSON。
  • Webhook：PolyDoc 将文件传递到 Webhook，操作返回 JSON 确认（异步时 HTTP 202）。

使用任一传递模式时，响应为 JSON 而不是二进制文件。

沙盒模式

每个操作都有一个高级 沙盒模式 输入。 将其设置为 true 从具有较低速率限制的单独配额生成水印输出，这在生成和测试流时很有用。 将其 false 保留为生产文档。

已知问题和限制

  • 每个操作的响应声明为二进制文件。 配置 云存储 或 Webhook 传递时，该操作将返回 JSON 而不是文件。
  • 从外部 CDN 加载 JavaScript 的页面可能会显著降低转换器的速度。 对于内联 HTML，首选自包含标记（内联 CSS、数据 URI 图像）。
  • E-invoices 遵循 EN 16931。 至少提供截止日期或付款条款（规则 BR-CO-25），当行使用增值税类别 S时，卖方税务 ID，以及一致的总计（净 + 税 = 毛额）。 启用 验证 后，验证失败的发票将返回错误。

部署说明

此连接器定义为标准 Power Platform 自定义连接器（apiDefinition.swagger.jsonicon.png + apiProperties.json + ）。 使用 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>

还可以直接从Power Automate创建者门户导入apiDefinition.swagger.json（数据>自定义连接器新自定义连接器>>导入 OpenAPI 文件）。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

默认值

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

名字 类型 描述 Required
PolyDoc API 密钥 安全字符串 PolyDoc API 密钥。 在 API 密钥下 dashboard.polydoc.tech 创建一个。 仅粘贴密钥;连接器会为你添加“Bearer”前缀。 是

操作

捕获屏幕截图

呈现 HTML、URL 或保存的模板，并捕获 PNG、JPEG 或 WebP 屏幕截图。 将图像作为二进制内容返回。
转换为 PDF

将 HTML、URL 或已保存的模板呈现到 PDF 中。 填充 E-invoice 字段以嵌入 ZUGFeRD/Factur-X 混合发票，而不是纯 PDF。 将文件作为二进制内容返回。

捕获屏幕截图

操作 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
高度 （px）
 height integer
设备像素比率
 devicePixelRatio number
X
 x number
Y
 y number
宽度
 width number
高度
 height number
Scale
 scale number
标记
 tag string

用于日志记录和分析的标签（最多 30 个字符）。
超时 （ms）
 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 True string
Webhook 链接地址
 url True string
异步
 async boolean

在后台传递并立即返回 202。
方法
 method string
Headers
 headers object

Webhook 请求的额外标头。
超时 （ms）
 timeout number
重试
 retries integer
重试延迟 （ms）
 retryDelay number
预签名 URL
 presignedUrl True string

存储提供程序中的 HTTP PUT 预签名 URL。

返回

响应
binary

转换为 PDF

操作 ID:
ConvertToPdf

将 HTML、URL 或已保存的模板呈现到 PDF 中。 填充 E-invoice 字段以嵌入 ZUGFeRD/Factur-X 混合发票，而不是纯 PDF。 将文件作为二进制内容返回。

参数

名称 密钥 必需 类型 说明
沙盒模式
 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 个字符）。
超时 （ms）
 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

@page遵循在纸张格式上以 CSS 声明的大小。
省略背景
 omitBackground boolean

使用透明背景呈现。
显示页眉/页脚
 displayHeaderFooter boolean

呈现页眉和页脚模板。
标头模板
 headerTemplate string

页眉的 HTML。 需要显示页眉/页脚。
页脚模板
 footerTemplate string

页脚的 HTML。 需要显示页眉/页脚。
Top
 top string
Right
 right string
底部
 bottom string
Left
 left string
Title
 title string
作者
 author string
Subject
 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 True string
验证符合性
 verify boolean
验证符合性
 verify boolean

针对 veraPDF PDF/UA-1 进行验证;如果验证失败，则返回错误。
标准
 standard True string

混合发票标准。
个人资料
 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。
税号
 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
增值税税率（%）
 vatRate number
VAT 类别
 vatCategoryCode string

VAT 类别代码，例如 S（标准）、Z（零）、E（豁免）。
类别代码
 categoryCode True string
费率（%）
 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
总毛
 totalGrossAmount True number

必须等于净 + 税。
注释
 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 True string
Webhook 链接地址
 url True string
异步
 async boolean

在后台传递并立即返回 202。
方法
 method string
Headers
 headers object

Webhook 请求的额外标头。
超时 （ms）
 timeout number
重试
 retries integer
重试延迟 （ms）
 retryDelay number
预签名 URL
 presignedUrl True string

存储提供程序中的 HTTP PUT 预签名 URL。

返回

响应
binary

定义

二进制

这是基本数据类型“binary”。