TemplioniX(미리 보기)
TemplioniX는 재사용 가능한 Word 템플릿에서 DOCX 및 PDF 파일을 만들기 위한 문서 생성 API입니다. 이 커넥터를 사용하여 템플릿 메타데이터를 추출하고, 단일 문서를 생성하고, 대량 문서 생성을 실행하고, 대량 작업 상태를 확인하고, 생성된 결과를 다운로드하고, 구독 또는 사용 정보를 볼 수 있습니다.
인증은 전달된 API 키를 사용하여 수행됩니다.
생성된 대량 ZIP 다운로드 링크는 24시간 동안 유효합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | Standard | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Contact | |
|---|---|
| 이름 | TemplioniX 지원 |
| URL | https://templionix.com |
| 전자 메일 | support@templionix.com |
| 커넥터 메타데이터 | |
|---|---|
| Publisher | TemplioniX |
| 웹 사이트 | https://templionix.com |
| 개인 정보 보호 정책 | https://templionix.com/privacy-policy |
| 사용 약관 | https://templionix.com/terms-of-use |
| 카테고리 | 생산력; 콘텐츠 및 파일 |
| IconBrandColor | #333A41 |
TemplioniX 커넥터
Overview
TemplioniX는 재사용 가능한 Microsoft Word 템플릿 및 구조화된 JSON 데이터에서 DOCX 및 PDF 파일을 만드는 데 도움이 되는 문서 생성 서비스입니다.
이 커넥터를 사용하면 사용자가 Microsoft Power Automate, Power Apps, Azure Logic Apps 및 Copilot Studio 워크플로를 TemplioniX API에 연결할 수 있습니다. 사용자는 템플릿 메타데이터를 추출하고, 시작 JSON 페이로드를 생성하고, 문서를 생성하고, 대량 문서 생성 작업을 실행하고, 작업 상태를 확인하고, 생성된 결과를 다운로드하고, 사용 가능한 템플릿을 검색할 수 있습니다.
Publisher
TemplioniX
의도한 Microsoft 제품
- Microsoft Power Automate (자동화 소프트웨어)
커넥터는 Microsoft Power Platform 사용자 지정 커넥터로 구현되며 인증된 커넥터가 지원되는 다른 Microsoft 커넥터 환경에서 사용할 수 있습니다.
Authentication
커넥터는 API 키 인증을 사용합니다. API 키는 요청 헤더에 x-functions-key 전달됩니다.
이 커넥터를 사용하려면 활성 TemplioniX 계정과 유효한 API 키가 있어야 합니다.
주요 기능
템플릿 가져오기
TemplioniX에서 페이지를 매긴 사용 가능한 문서 서식 파일 목록을 검색합니다. 이 작업을 사용하여 메타데이터, 시작 모델, 단일 문서 또는 대량 문서 생성 작업을 생성하기 전에 템플릿을 선택할 수 있습니다.
템플릿 필드 및 자리 표시자 추출
템플릿 필드 및 자리 표시자를 포함하여 선택한 템플릿에서 메타데이터를 추출합니다. 이렇게 하면 사용자가 템플릿에 필요한 데이터를 이해할 수 있습니다.
템플릿에 대한 시작 JSON 페이로드 생성
선택한 템플릿을 기반으로 예제 JSON 페이로드를 생성합니다. 사용자는 이 페이로드를 다른 시스템의 데이터를 문서 생성 요청으로 매핑하기 위한 시작점으로 사용할 수 있습니다.
문서 생성
선택한 템플릿에서 DOCX 또는 PDF 문서를 생성하고 JSON 데이터를 입력합니다.
대량으로 문서 생성
선택한 템플릿 및 여러 입력 레코드를 사용하여 대량 문서 생성 작업을 시작합니다. 생성된 대량 ZIP 다운로드 링크는 24시간 동안 유효합니다.
대량 생성 작업 상태 가져오기
특정 대량 문서 생성 작업에 대한 상태 및 결과 정보를 검색합니다.
템플릿으로 대량 생성 작업 가져오기
선택한 템플릿과 연결된 대량 생성 작업을 검색합니다.
일반적인 사용 시나리오
- 구조화된 데이터에서 계약, 청구서, 제안, 보고서, 편지 및 기타 비즈니스 문서를 생성합니다.
- CRM, ERP, 양식, Excel, SharePoint, Dataverse, SQL 또는 API 기반 시스템에서 문서 만들기를 자동화합니다.
- 워크플로에서 요청 시 단일 문서를 만듭니다.
- 여러 문서를 대량으로 생성하고 생성된 ZIP 결과를 검색합니다.
- 추출된 템플릿 메타데이터를 사용하여 문서 생성에 필요한 필드를 파악합니다.
예시 워크플로
- 수동으로 또는 비즈니스 이벤트에서 흐름을 트리거합니다.
- 템플릿 가져오기 작업을 사용하여 템플릿을 선택합니다.
- 시작 JSON 페이로드 생성 작업을 사용하여 예상 데이터 구조를 이해합니다.
- 원본 시스템 데이터를 생성된 JSON 구조에 매핑합니다.
- 문서 생성 작업을 사용하여 DOCX 또는 PDF 파일을 만듭니다.
- 생성된 파일을 OneDrive, SharePoint, Dataverse, 전자 메일 또는 다른 대상에 저장합니다.
Support
제품 정보, 설명서 및 지원을 보려면 다음을 방문하세요.
- 웹 사이트: https://templionix.com
- 문서: https://docs.templionix.com
- 고객 지원: https://templionix.com/contact
- 개인 정보 취급 방침: https://templionix.com/privacy-policy
- 사용 약관: https://templionix.com/terms-of-use
인증 검토를 위한 참고 사항
이 패키지에는 TemplioniX 커넥터 솔루션 및 커넥터 작업을 보여 주는 샘플 흐름 솔루션이 포함되어 있습니다. 커넥터는 프로덕션 TemplioniX API와 통신하고 헤더를 통해 API 키 인증을 x-functions-key 사용합니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | Type | Description | 필수 |
|---|---|---|---|
| TemplioniX API 키 | 시큐어스트링 (보안 문자열) | 이 API의 TemplioniX API 키 | True |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
actions
| 대량 문서 생성 시작 |
대량 작업을 시작하여 공유 템플릿에서 문서를 생성하고, 읽기 SAS URL로 ZIP을 빌드하고, 진행률을 추적합니다. 작업 ID를 즉시 반환합니다. 반환된 ZIP 다운로드 URL은 작업이 완료된 후 사용할 수 있으며 생성 시간으로부터 24시간 동안 유효합니다. |
| 대량 생성 작업 상태 가져오기 |
상태, 시작/종료 시간, 완료 시 ZIP SAS URL, 실패한 오케스트레이션 오류 및 항목별 생성 실패 구문 분석과 같은 ID별로 작업의 상태를 로드합니다. |
| 사용 가능한 템플릿 나열 |
메타데이터 추출, 모델 생성 및 문서 생성 엔드포인트와 함께 사용할 수 있는 페이지를 매긴 템플릿 목록을 반환합니다. |
| 템플릿 데이터에서 문서 생성 |
제공된 JSON 페이로드를 선택한 템플릿과 병합하고 생성된 문서를 반환합니다. Word 출력 또는 |
| 템플릿 필드 및 자리 표시자 추출 |
선택한 서식 파일을 읽고 사용 가능한 경우 제목, 태그, 형식 및 미리 정의된 값을 포함하여 문서에서 검색된 콘텐츠 컨트롤을 반환합니다. |
| 템플릿에 대한 시작 JSON 페이로드 생성 |
문서 생성을 위한 입력으로 다시 사용할 수 있도록 선택한 템플릿에서 검색된 자리 표시자와 일치하는 샘플 JSON 구조를 빌드합니다. |
| 템플릿의 대량 생성 작업 나열 |
TemplateId가 일치하는 대량 생성 파티션에 대한 모든 작업을 반환합니다. 단일 작업 상태와 동일한 페이로드 셰이프, 시작 시간 내림차순으로 정렬 |
대량 문서 생성 시작
대량 작업을 시작하여 공유 템플릿에서 문서를 생성하고, 읽기 SAS URL로 ZIP을 빌드하고, 진행률을 추적합니다. 작업 ID를 즉시 반환합니다. 반환된 ZIP 다운로드 URL은 작업이 완료된 후 사용할 수 있으며 생성 시간으로부터 24시간 동안 유효합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
고유 템플릿 식별자 |
|
|
Format
|
format | string |
출력 형식 Word 문서에 .docx 사용하거나 PDF 문서의 경우 .pdf 사용합니다. |
|
|
파일 이름
|
fileName | string |
생성되거나 요청된 파일 이름 |
|
|
items
|
items | object |
반품
대량 문서 생성 작업이 처리에 허용되면 응답이 반환됩니다.
대량 생성 작업 상태 가져오기
상태, 시작/종료 시간, 완료 시 ZIP SAS URL, 실패한 오케스트레이션 오류 및 항목별 생성 실패 구문 분석과 같은 ID별로 작업의 상태를 로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
대량 작업 식별자
|
jobId | True | string |
generateDocumentsBulk 202 응답에서 반환된 작업 ID( |
반품
대량 문서 생성 작업에 대한 상태 및 결과 세부 정보입니다.
사용 가능한 템플릿 나열
메타데이터 추출, 모델 생성 및 문서 생성 엔드포인트와 함께 사용할 수 있는 페이지를 매긴 템플릿 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
페이지 번호
|
pageNumber | True | integer |
반환할 1부터 시작하는 페이지 인덱스 |
|
페이지 크기
|
pageSize | True | integer |
단일 응답에서 반환할 최대 템플릿 수 |
반품
템플릿 레코드를 포함하는 오프셋 기반 페이징 응답입니다.
템플릿 데이터에서 문서 생성
제공된 JSON 페이로드를 선택한 템플릿과 병합하고 생성된 문서를 반환합니다. Word 출력 또는 .pdf PDF 출력에 사용 .docx
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
고유 템플릿 식별자 |
|
|
데이터
|
data | object |
템플릿 자리 표시자에 대한 값을 포함하는 JSON 개체입니다. |
|
|
문서 이름
|
documentName | string |
API에서 확장을 허용하지 않는 한 확장명 없이 생성된 문서의 이름 |
|
|
Format
|
format | string |
출력 형식 Word 문서에 .docx 사용하거나 PDF 문서의 경우 .pdf 사용합니다. |
반품
- response
- file
템플릿 필드 및 자리 표시자 추출
선택한 서식 파일을 읽고 사용 가능한 경우 제목, 태그, 형식 및 미리 정의된 값을 포함하여 문서에서 검색된 콘텐츠 컨트롤을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
템플릿 식별자
|
templateId | True | uuid |
템플릿 카탈로그에서 반환된 고유 템플릿 식별자 |
반품
- response
- array of contentControlInfoDto
템플릿에 대한 시작 JSON 페이로드 생성
문서 생성을 위한 입력으로 다시 사용할 수 있도록 선택한 템플릿에서 검색된 자리 표시자와 일치하는 샘플 JSON 구조를 빌드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
템플릿 식별자
|
templateId | True | uuid |
템플릿 카탈로그에서 반환된 고유 템플릿 식별자 |
반품
- response
- object
템플릿의 대량 생성 작업 나열
TemplateId가 일치하는 대량 생성 파티션에 대한 모든 작업을 반환합니다. 단일 작업 상태와 동일한 페이로드 셰이프, 시작 시간 내림차순으로 정렬
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
템플릿 식별자
|
templateId | True | uuid |
이 템플릿 ID로 시작된 작업만 반환됩니다. |
반품
- response
- array of bulkGenerationJobStatusDto
정의
bulkGenerationAcceptedDto
대량 문서 생성 작업이 처리에 허용되면 응답이 반환됩니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
직무 ID
|
jobId | string |
고유한 대량 생성 작업 식별자입니다. |
|
시작 날짜
|
startedAt | date-time |
작업이 시작된 UTC 날짜 및 시간입니다. |
bulkGenerationFailureItemDto
대량 생성 작업에서 실패한 문서 항목 하나에 대한 정보입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
전역 인덱스
|
globalIndex | string |
실패한 생성된 항목의 인덱스 또는 내부 식별자입니다. |
|
파일 이름
|
fileName | string |
생성되거나 요청된 파일 이름입니다. |
|
오류
|
error | string |
실패한 항목에 대한 오류 메시지입니다. |
bulkGenerationJobStatusDto
대량 문서 생성 작업에 대한 상태 및 결과 세부 정보입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
직무 ID
|
jobId | string |
고유한 대량 생성 작업 식별자입니다. |
|
템플릿 아이디
|
templateId | uuid |
고유 템플릿 식별자입니다. |
|
Status
|
status | string |
현재 작업 상태(예: 보류 중, 실행 중, 완료됨, 실패 또는 부분 완성됨)입니다. |
|
시작 날짜
|
startedAt | date-time |
작업이 시작된 UTC 날짜 및 시간입니다. |
|
종료 시간
|
endTime | date-time |
작업이 완료된 UTC 날짜 및 시간입니다. |
|
Zip Url
|
zipUrl | string |
생성된 ZIP 파일에 대한 임시 다운로드 URL입니다. 대량 생성의 경우 이 링크는 생성 시간으로부터 24시간 동안 유효합니다. |
|
오류 메시지
|
errorMessage | string |
오케스트레이션에 실패한 경우 작업 수준 오류 메시지입니다. |
|
failedGenerations
|
failedGenerations | array of bulkGenerationFailureItemDto |
대량 생성 작업 내에서 실패한 항목의 컬렉션입니다. |
|
실패한 생성 수
|
failedGenerationCount | integer |
대량 생성 작업 내에서 실패한 항목 수입니다. |
categoryDto
템플릿 범주 정보입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | uuid |
고유 식별자. |
|
name
|
name | string |
표시 이름: |
contentControlInfoDto
템플릿에서 검색된 Word 콘텐츠 컨트롤 또는 자리 표시자에 대한 메타데이터입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
title
|
title | string |
콘텐츠 컨트롤 제목입니다. |
|
tag
|
tag | string |
JSON 필드 키로 사용되는 콘텐츠 컨트롤 태그입니다. |
|
type
|
type | string |
콘텐츠 컨트롤 형식입니다. |
pagedResponseOffsetDto_templateInfoDto
템플릿 레코드를 포함하는 오프셋 기반 페이징 응답입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of templateInfoDto |
템플릿 자리 표시자에 대한 값을 포함하는 JSON 개체입니다. |
|
페이지 번호
|
pageNumber | integer |
현재 페이지 번호입니다. |
|
페이지 크기
|
pageSize | integer |
페이지당 레코드 수입니다. |
|
총 레코드
|
totalRecords | integer |
사용 가능한 총 레코드 수입니다. |
|
총 페이지 수
|
totalPages | integer |
총 페이지 수입니다. |
templateInfoDto
템플릿 목록 엔드포인트에서 반환된 템플릿 카탈로그 항목입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | uuid |
고유 식별자. |
|
이름
|
name | string |
표시 이름: |
|
Description
|
description | string |
사람이 읽을 수 있는 설명입니다. |
|
생성 일자
|
createdOn | date-time |
템플릿을 만든 UTC 날짜 및 시간입니다. |
|
마지막으로 수정한 날짜
|
lastModified | date-time |
템플릿이 마지막으로 수정된 UTC 날짜 및 시간입니다. |
|
categories
|
categories | array of categoryDto |
템플릿 범주입니다. |
파일
기본 데이터 형식 'file'입니다.
object
'object' 형식입니다.