PolyDoc(독립 Publisher)(미리 보기)
HTML 또는 URL을 픽셀에 완벽한 PDF 및 스크린샷으로 변환하고 EU 규격 하이브리드 e-청구서(ZUGFeRD/Factur-X)를 생성합니다. PolyDoc는 실제 브라우저 엔진을 사용하여 렌더링되므로 페이지에 표시되는 내용은 문서에서 얻을 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | Class | 지역 |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 표준 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | PolyDoc |
| URL | https://polydoc.tech |
| 전자 메일 | hello@polydoc.tech |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | blue-d3v |
| 웹 사이트 | https://polydoc.tech |
| 개인 정보 보호 정책 | https://polydoc.tech/legal/privacy-policy/ |
| 카테고리 | 콘텐츠 및 파일 |
PolyDoc
PolyDoc 는 HTML 또는 URL을 픽셀에 완벽한 PDF 및 스크린샷으로 전환하고 EU 규격 하이브리드 e-청구서(ZUGFeRD/Factur-X)를 생성합니다. 변환은 실제 브라우저 엔진에서 렌더링되므로 페이지에 표시되는 내용이 문서에서 얻을 수 있습니다.
게시자
PolyDoc
사전 요구 사항
PolyDoc 계정 및 API 키가 필요합니다. 무료 계층은 커넥터를 평가하기에 충분합니다. 사용자 지정 커넥터는 프리미엄 Power Automate 기능이므로 이 커넥터를 사용하는 흐름에는 기본 제공 HTTP 작업과 동일한 Power Automate Premium 플랜(사용자별 또는 흐름당)이 필요합니다.
자격 증명 가져오기
- dashboard.polydoc.tech 로그인합니다.
- API 키를 열고 키를 만듭니다.
- 연결을 만들 때 PolyDoc API 키에 키를 붙여넣습니다. 키만 붙여넣습니다. 커넥터가 접두사를
Bearer추가합니다.
지원되는 작업
| 수술 | 용도 |
|---|---|
| PDF로 변환 | HTML, URL 또는 저장된 템플릿을 PDF로 렌더링합니다. 페이지 형식, 여백, 크기 조정, 머리글/바닥글, 책갈피, 액세스 가능(태그가 지정된) PDF, 메타데이터, 암호화, 워터마크 및 PDF/A에 대한 컨트롤입니다. |
| 캡처 스크린샷 | HTML, URL 또는 템플릿의 PNG, JPEG 또는 WebP를 캡처합니다. 뷰포트 및 디바이스 픽셀 비율 컨트롤을 사용하여 전체 페이지 또는 잘렸습니다. |
전자 송장은PDF로 변환을 사용하여 생성됩니다. E-청구서 필드(표준, 프로필 및 구조적 invoice 개체)를 입력하고 PolyDoc는 반환된 PDF에 ZUGFeRD/Factur-X 청구서를 포함합니다.
example-flows/ 즉시 사용할 수 있는 본문은 커넥터 리포지토리의 폴더를 참조하세요.
Source
모든 작업은 다음 중 하나인 단일 원본 을 취합니다.
- URL(예:
- 인라인 HTML 문자열
- 저장된 템플릿 참조(
[template:TEMPLATE_ID]필요에 따라 Liquid 렌더러에 대한 템플릿 데이터 사용)
배달
기본적으로 파일은 파일 만들기(OneDrive, SharePoint, Blob) 또는 전자 메일 첨부 파일에 드롭할 준비가 된 이진 콘텐츠로 반환됩니다. 두 가지 대체 배달 모드는 고급 옵션에서 사용할 수 있습니다.
- 클라우드 스토리지: 미리 서명된 PUT URL을 제공합니다. PolyDoc는 파일을 업로드하고 작업은 저장된 URL을 포함하는 JSON을 반환합니다.
- 웹후크: PolyDoc는 파일을 웹후크에 전달하고 작업은 JSON 승인(비동기인 경우 HTTP 202)을 반환합니다.
배달 모드 중 하나를 사용하는 경우 응답은 이진 파일이 아닌 JSON입니다.
샌드박스 모드
각 작업에는 고급 샌드박스 모드 입력이 있습니다. 흐름을 빌드하고 테스트하는 동안 유용한 낮은 속도 제한을 사용하여 별도의 할당량에서 워터마크 출력을 생성하도록 true 설정합니다.
false 프로덕션 문서에 그대로 둡니다.
알려진 문제 및 제한 사항
- 각 작업의 응답은 이진 파일로 선언됩니다. 클라우드 스토리지 또는 웹후크 배달이 구성되면 작업은 파일 대신 JSON을 반환합니다.
- 외부 CDN에서 JavaScript를 로드하는 페이지는 변환기를 크게 느리게 할 수 있습니다. 인라인 HTML의 경우 자체 포함 태그(인라인 CSS, 데이터 URI 이미지)를 선호합니다.
- 전자 송장은 EN 16931을 따릅니다. 최소한 기한 또는 지불 조건(규칙 BR-CO-25), 줄에서 VAT 범주
S를 사용하는 경우 판매자 세금 ID 및 일관된 합계(순 + 세금 = 총액)를 제공합니다. Verify를 사용하도록 설정하면 유효성 검사에 실패한 청구서가 오류를 반환합니다.
배포 지침
이 커넥터는 표준 Power Platform 사용자 지정 커넥터(apiDefinition.swagger.json + + apiProperties.jsonicon.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>
Power Automate Maker 포털에서 직접 가져올 apiDefinition.swagger.json 수도 있습니다(데이터 > 사용자 지정 커넥터 새 > 사용자 지정 커넥터 > OpenAPI 파일 가져오기).
연결을 만드는 중
커넥터는 다음과 같은 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유 불가 |
기본값
적용 가능 지역: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유할 수 없는 연결입니다. Power App이 다른 사용자와 공유되는 경우, 다른 사용자에게는 명시적으로 새로운 연결을 생성하라는 메시지가 표시됩니다.
| 이름 | 유형 | 묘사 | 필수 |
|---|---|---|---|
| PolyDoc API 키 | 시큐어스트링 (보안 문자열) | PolyDoc API 키입니다. API 키 아래에 dashboard.polydoc.tech 하나를 만듭니다. 키만 붙여넣습니다. 커넥터는 'Bearer' 접두사를 추가합니다. | True |
actions
| PDF로 변환 |
HTML, URL 또는 저장된 템플릿을 PDF로 렌더링합니다. 일반 PDF 대신 ZUGFeRD/Factur-X 하이브리드 송장을 포함하도록 E-청구서 필드를 채웁다. 파일을 이진 콘텐츠로 반환합니다. |
| 캡처 스크린샷 |
HTML, URL 또는 저장된 템플릿을 렌더링하고 PNG, JPEG 또는 WebP 스크린샷을 캡처합니다. 이미지를 이진 콘텐츠로 반환합니다. |
PDF로 변환
HTML, URL 또는 저장된 템플릿을 PDF로 렌더링합니다. 일반 PDF 대신 ZUGFeRD/Factur-X 하이브리드 송장을 포함하도록 E-청구서 필드를 채웁다. 파일을 이진 콘텐츠로 반환합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
샌드박스 모드
|
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 | string | ||
|
하단
|
bottom | string | ||
|
왼쪽
|
left | string | ||
|
Title
|
title | string | ||
|
작성자
|
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 | 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를 사용하는 경우 판매자에게 필요합니다. |
|
|
전자 메일
|
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(0), E(제외). |
|
|
범주 코드
|
categoryCode | True | string | |
|
Rate (%)
|
rate | True | number | |
|
과세 금액
|
taxableAmount | True | number | |
|
세액
|
taxAmount | True | number | |
|
지불 조건
|
paymentTerms | string |
무료 텍스트 결제 조건입니다. 이 날짜 또는 기한을 입력합니다. |
|
|
형식 코드
|
typeCode | True | string |
UN/ECE 4461 결제는 코드(예: 30(신용 이체)를 의미합니다. |
|
이반
|
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 | ||
|
만료(epoch)
|
expires | number | ||
|
HTTP만
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
동일사이트
|
sameSite | string | ||
|
유형
|
type | string | ||
|
사용자 이름
|
username | True | string | |
|
암호
|
password | True | string | |
|
웹후크 URL
|
url | True | string | |
|
비동기
|
async | boolean |
백그라운드에서 배달하고 즉시 202를 반환합니다. |
|
|
메서드
|
method | string | ||
|
Headers
|
headers | object |
웹후크 요청에 대한 추가 헤더입니다. |
|
|
시간 제한(ms)
|
timeout | number | ||
|
재시도
|
retries | integer | ||
|
재시도 지연(ms)
|
retryDelay | number | ||
|
미리 서명된 URL
|
presignedUrl | True | string |
스토리지 공급자의 HTTP PUT 미리 서명된 URL입니다. |
반품
- response
- binary
캡처 스크린샷
HTML, URL 또는 저장된 템플릿을 렌더링하고 PNG, JPEG 또는 WebP 스크린샷을 캡처합니다. 이미지를 이진 콘텐츠로 반환합니다.
매개 변수
| 속성 | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
샌드박스 모드
|
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 | ||
|
만료(epoch)
|
expires | number | ||
|
HTTP만
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
동일사이트
|
sameSite | string | ||
|
유형
|
type | string | ||
|
사용자 이름
|
username | True | string | |
|
암호
|
password | True | string | |
|
웹후크 URL
|
url | True | string | |
|
비동기
|
async | boolean |
백그라운드에서 배달하고 즉시 202를 반환합니다. |
|
|
메서드
|
method | string | ||
|
Headers
|
headers | object |
웹후크 요청에 대한 추가 헤더입니다. |
|
|
시간 제한(ms)
|
timeout | number | ||
|
재시도
|
retries | integer | ||
|
재시도 지연(ms)
|
retryDelay | number | ||
|
미리 서명된 URL
|
presignedUrl | True | string |
스토리지 공급자의 HTTP PUT 미리 서명된 URL입니다. |
반품
- response
- binary
정의
binary
기본 데이터 형식 'binary'입니다.