PolyDoc (независимый Publisher) (предварительная версия)
Преобразуйте HTML или URL-адрес в пиксель идеальные PDF-файлы и снимки экрана, а также создайте гибридные электронные счета, совместимые с ЕС (ZUGFeRD/ Factur-X). PolyDoc отрисовывается с помощью реального обработчика браузера, поэтому то, что вы видите на странице, это то, что вы получаете в документе.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандартный | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | PolyDoc |
| URL | https://polydoc.tech |
| Эл. почта | hello@polydoc.tech |
| Метаданные соединителя | |
|---|---|
| Publisher | blue-d3v |
| Веб-сайт | https://polydoc.tech |
| Политика конфиденциальности | https://polydoc.tech/legal/privacy-policy/ |
| Categories | Содержимое и файлы |
PolyDoc
PolyDoc преобразует HTML или URL-адрес в пиксель идеальные PDF-файлы и снимки экрана, а также создает гибридные электронные счета, совместимые с ЕС (ZUGFeRD / Factur-X). Преобразования отображаются в реальном обработчике браузера, поэтому то, что вы видите на странице, это то, что вы получаете в документе.
Publisher
PolyDoc
Необходимые условия
Вам нужна учетная запись PolyDoc и ключ API. Уровень "Бесплатный" достаточно, чтобы оценить соединитель. Пользовательские соединители — это функция Power Automate уровня "Премиум", поэтому потоки, использующие этот соединитель, нуждаются в плане Power Automate Premium (на пользователя или на поток), так же, как и встроенное действие HTTP.
Получение учетных данных
- Войдите в dashboard.polydoc.tech.
- Откройте ключи API и создайте ключ.
- При создании подключения вставьте ключ в ключ API PolyDoc. Вставьте только ключ; Соединитель добавляет
Bearerпрефикс для вас.
Поддерживаемые операции
| Operation | Что делает |
|---|---|
| Преобразование в PDF | Отрисовка HTML, URL-адреса или сохраненного шаблона в ФОРМАТЕ PDF. Элементы управления для формата страницы, полей, масштабирования, верхних и нижних колонтитулов, закладок, доступных (помеченных) PDF-файлов, метаданных, шифрования, подложки и PDF/A. |
| Снимок экрана | Запись PNG, JPEG или WebP HTML, URL-адреса или шаблона. Полностраничные или обрезанные с помощью окна просмотра и управления соотношением пикселей устройства. |
Электронные счета создаются с помощью преобразования в PDF: заполните поля E-счет (стандартный, профиль и структурированный invoice объект) и PolyDoc внедряет счет ZUGFeRD /Factur-X в возвращенный PDF-файл. См. example-flows/ папку в репозитории соединителя для готового текста.
Source
Каждая операция принимает один источник , который является одним из следующих:
- URL-адрес, например.
https://example.com - встроенная строка HTML
- сохраненная ссылка на шаблон ,
[template:TEMPLATE_ID]при необходимости с данными шаблона для отрисовщика Liquid
Доставка
По умолчанию файл возвращается в виде двоичного содержимого, готового к переходу в файл создания (OneDrive, SharePoint, BLOB-объектов) или вложения электронной почты. Два альтернативных режима доставки доступны в расширенных вариантах:
- Облачное хранилище: предписанный URL-адрес PUT; PolyDoc отправляет файл, а действие возвращает JSON, содержащий сохраненный URL-адрес.
- Веб-перехватчик: PolyDoc передает файл в веб-перехватчик, а действие возвращает подтверждение JSON (HTTP 202 при асинхронном использовании).
Если используется любой режим доставки, ответ — JSON, а не двоичный файл.
Режим песочницы
Каждая операция имеет расширенные входные данные в режиме песочницы . Присвойте ему true значение для создания подложки из отдельной квоты с более низким ограничением скорости, которое полезно при создании и тестировании потока. Оставьте его false для рабочих документов.
Известные проблемы и ограничения
- Ответ каждого действия объявляется двоичным файлом. Если настроена доставка облачного хранилища или веб-перехватчика , действие возвращает JSON вместо файла.
- Страницы, загружающие JavaScript из внешнего CDN, могут значительно замедлить преобразователь. Для встроенного HTML предпочтительна автономная разметка (встроенные CSS, образы URI данных).
- Электронные счета соответствуют EN 16931. По крайней мере укажите дату выполнения или условия оплаты (правило BR-CO-25), идентификатор налога продавца, когда строка использует категорию
SНДС и согласованные итоги (чистый + налог = валовый). При включенной проверке счета, завершившемся сбоем проверки, возвращается ошибка.
Инструкции по развертыванию
Этот соединитель определяется как стандартный настраиваемый соединитель Power Platform (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Разверните его с помощью интерфейса командной строки соединителей Power Platform:
# 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 (пользовательские соединители data > custom connectors > New custom connector > Import an OpenAPI file).
Создание подключения
Коннектор поддерживает следующие типы аутентификации:
| По умолчанию | Параметры для создания подключения. | Все регионы | Не подлежит распространению |
По умолчанию
Применимо: Все регионы
Параметры для создания подключения.
Это не общее соединение. Если приложение Power используется совместно с другим пользователем, ему будет предложено явно создать новое подключение.
| Имя | Тип | Описание | Обязательный |
|---|---|---|---|
| Ключ API PolyDoc | securestring | Ключ API PolyDoc. Создайте его в dashboard.polydoc.tech в разделе "Ключи API". Вставьте только ключ; соединитель добавляет префикс носителя для вас. | True |
Действия
| Преобразование в формат PDF |
Отрисовка HTML, URL-адреса или сохраненного шаблона в ФОРМАТЕ PDF. Заполните поля E-invoice для внедрения ZUGFeRD / Factur-X гибридного счета вместо обычного PDF-файла. Возвращает файл в виде двоичного содержимого. |
| Снимок экрана |
Отрисовка HTML, URL-адреса или сохраненного шаблона и запись снимка экрана PNG, JPEG или WebP. Возвращает изображение в виде двоичного содержимого. |
Преобразование в формат PDF
Отрисовка 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 |
Данные ключа и значения, передаваемые в средство отрисовки шаблона Liquid, когда источник является ссылкой [template:ID]. |
|
|
Тег
|
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 |
Создайте закладки PDF из заголовков HTML. |
|
|
Тегированные (доступные)
|
tagged | boolean |
Создание PDF-файла с тегами (доступно). |
|
|
Предпочитать размер страницы CSS
|
preferCSSPageSize | boolean |
Учитывая размер, объявленный @page в CSS в формате бумаги. |
|
|
Опущен фон
|
omitBackground | boolean |
Отрисовка с прозрачным фоном. |
|
|
Отображение верхнего и нижнего колонтитула
|
displayHeaderFooter | boolean |
Отрисовка шаблонов верхних и нижних колонтитулов. |
|
|
Шаблон заголовка
|
headerTemplate | string |
HTML-код заголовка страницы. Требуется колонтитул отображения. |
|
|
Шаблон нижнего колонтитула
|
footerTemplate | string |
HTML для нижнего колонтитула страницы. Требуется колонтитул отображения. |
|
|
Верх
|
top | string | ||
|
Правильно
|
right | string | ||
|
Низ
|
bottom | string | ||
|
Лево
|
left | string | ||
|
Заголовок
|
title | string | ||
|
Author
|
author | string | ||
|
Тема
|
subject | string | ||
|
Ключевые слова
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Создатель
|
creator | string | ||
|
Пароль пользователя
|
userPassword | string | ||
|
Пароль владельца
|
ownerPassword | string | ||
|
Source
|
source | True | string |
Текст водяного знака или URL-адрес изображения или URI данных. |
|
Тип
|
type | True | string | |
|
Options
|
options | object |
Параметры шрифта, непрозрачности, поворота, масштабирования, повтора и смещения. |
|
|
Level
|
level | True | string | |
|
Проверка соответствия требованиям
|
verify | boolean | ||
|
Проверка соответствия требованиям
|
verify | boolean |
Проверка на соответствие veraPDF PDF/UA-1; возвращает ошибку, если проверка завершается ошибкой. |
|
|
Стандартный
|
standard | True | string |
Стандартный гибридный счет. |
|
Profile
|
profile | True | string |
Профиль детализации данных для проверки на соответствие. |
|
Проверка соответствия требованиям
|
verify | boolean |
Проверка соответствия PDF/A и соответствия электронным счетам; возвращает ошибку, если проверка завершается ошибкой. |
|
|
Номер накладной
|
number | True | string | |
|
Дата выпуска
|
issueDate | True | string |
Дата выпуска, ГГГГ-ММ-ДД. |
|
Срок
|
dueDate | string |
Дата выполнения, ГГГГ-ММ-ДД. Укажите эти или условия оплаты (правило 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 |
Идентификатор НДС. Требуется для продавца, когда строка использует категорию НДС S. |
|
|
Эл. почта
|
string | |||
|
Телефон
|
phone | string | ||
|
Описание
|
description | True | string | |
|
Количество
|
quantity | True | number | |
|
Код единицы
|
unitCode | string |
Код единицы UN/ECE, например C62 (кусок). |
|
|
Цена единицы
|
unitPrice | True | number | |
|
Итог строки
|
lineTotal | True | number | |
|
Ставка НДС (%)
|
vatRate | number | ||
|
Категория НДС
|
vatCategoryCode | string |
Код категории НДС, например 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
|
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 | string | ||
|
Срок действия (эпоха)
|
expires | number | ||
|
Только HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Сайт SameSite
|
sameSite | string | ||
|
Тип
|
type | string | ||
|
Имя пользователя
|
username | True | string | |
|
Password
|
password | True | string | |
|
URL-адрес вебхука
|
url | True | string | |
|
Асинхронный режим
|
async | boolean |
Доставить в фоновом режиме и вернуть 202 немедленно. |
|
|
Метод
|
method | string | ||
|
Headers
|
headers | object |
Дополнительные заголовки для запроса веб-перехватчика. |
|
|
Время ожидания (мс)
|
timeout | number | ||
|
Повторные попытки
|
retries | integer | ||
|
Задержка повтора (мс)
|
retryDelay | number | ||
|
URL-адрес предназначаемого url-адреса
|
presignedUrl | True | string |
URL-адрес http PUT с предварительно заданным URL-адресом от поставщика хранилища. |
Возвращаемое значение
- response
- binary
Снимок экрана
Отрисовка 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 |
Данные ключа и значения, передаваемые в средство отрисовки шаблона Liquid, когда источник является ссылкой [template:ID]. |
|
|
Тип изображения
|
type | string |
Формат изображения. По умолчанию используется png. |
|
|
Полная страница
|
fullPage | boolean |
Захватить всю прокручиваемую страницу. |
|
|
Quality
|
quality | integer |
Качество сжатия 0-100 для JPEG/WebP. |
|
|
Опущен фон
|
omitBackground | boolean |
Захват с прозрачным фоном (PNG/WebP). |
|
|
Ширина (px)
|
width | integer | ||
|
Высота (px)
|
height | integer | ||
|
Соотношение пикселей устройства
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
У
|
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 | string | ||
|
Срок действия (эпоха)
|
expires | number | ||
|
Только HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Сайт SameSite
|
sameSite | string | ||
|
Тип
|
type | string | ||
|
Имя пользователя
|
username | True | string | |
|
Password
|
password | True | string | |
|
URL-адрес вебхука
|
url | True | string | |
|
Асинхронный режим
|
async | boolean |
Доставить в фоновом режиме и вернуть 202 немедленно. |
|
|
Метод
|
method | string | ||
|
Headers
|
headers | object |
Дополнительные заголовки для запроса веб-перехватчика. |
|
|
Время ожидания (мс)
|
timeout | number | ||
|
Повторные попытки
|
retries | integer | ||
|
Задержка повтора (мс)
|
retryDelay | number | ||
|
URL-адрес предназначаемого url-адреса
|
presignedUrl | True | string |
URL-адрес http PUT с предварительно заданным URL-адресом от поставщика хранилища. |
Возвращаемое значение
- response
- binary
Определения
binary
Это базовый тип данных binary.