다음을 통해 공유

Adobe Experience Manager(미리 보기)

Adobe Experience Manager 통합을 사용하면 Adobe Experience Manager Forms 관련 서비스(예: 통신 등)에 액세스할 수 있습니다. 또한 이 통합을 통해 Adobe Experience Manager Forms를 통해 양식을 제출할 때 흐름을 트리거할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
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)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Adobe Experience Manager Forms
URL https://www.adobe.com/go/adobe-experience-manager-forms-community
전자 메일 aem-pa@adobe.com
커넥터 메타데이터
게시자 Adobe
웹 사이트 https://business.adobe.com/products/experience-manager/forms/aem-forms.html
개인 정보 보호 정책 https://www.adobe.com/in/privacy/policy.html
카테고리 생산력; 비즈니스 관리

Adobe Experience Manager 커넥터를 사용하여 Adobe Experience Manager Forms - 통신 기능에 액세스하여 양식 디자인 및 XML 양식 데이터를 기반으로 하는 PDF 문서를 만들거나 PS(PostScript), PCL(프린터 명령 언어), ZPL(Zebra Printing Language) 및 기타 프린터 정의 언어 문서를 만들 수 있습니다.

필수 조건

커넥터를 사용하려면 라이선스와 Adobe Experience Manager Forms as a Cloud Service - Communication API 에 대한 액세스 권한이 필요합니다.

자격 증명을 가져오는 방법

다음과 같은 몇 가지 단계를 통해 Adobe Experience Manager를 쉽게 시작할 수 있습니다.

서비스 자격 증명 생성

Adobe Experience Manager 개발자 콘솔을 사용하여 서비스 자격 증명을 생성 합니다.

연결 설정

Adobe Experience Manager 커넥터에 서비스 자격 증명을 추가합니다. 서비스 자격 증명 JSON에서 자격 증명을 가져와서 이러한 자격 증명 세부 정보를 일회성 연결 설정에 복사할 수 있습니다.

  • 조직 ID
  • 클라이언트 ID
  • 클라이언트 암호
  • 기술 계정 ID
  • 메타 범위
  • 프라이빗 키
  • Adobe IMS 호스트 URL

AEM 서버의 경우 Adobe Experience Manager 클라우드 서비스 작성자 또는 게시 인스턴스의 URL을 지정합니다. 예를 들어 https://publish-pXXXX-eXXXXX.adobeaemcloud.com

커넥터 시작

커넥터는 다음 작업을 지원합니다.

템플릿에서 PDF 문서 생성 및 데이터 병합

양식 디자인 및 XML 양식 데이터를 기반으로 하는 PDF 문서를 만들 수 있습니다. 이를 통해 비즈니스 서신, 명세서, 청구 처리 편지, 혜택 통지, 월별 청구서 또는 환영 키트와 같은 브랜드 승인, 개인 설정 및 표준화된 문서를 만들 수 있습니다.

기본 워크플로는 XML 양식 데이터를 양식 디자인과 병합하여 PDF 문서를 만드는 것입니다. Adobe Experience Manager Forms 디자이너에서 템플릿을 만들 수 있습니다.

작업의 출력은 비대화형 PDF 문서입니다. 즉, 사용자가 양식 데이터를 입력하거나 수정할 수 없습니다. 다음 매개 변수를 지정하여 작업에 대한 다양한 옵션을 구성할 수 있습니다.

매개 변수 필수(필수) Description
Template Yes 템플릿은 PDF 문서의 모양과 동작을 정의합니다. API는 XDP 및 PDF 문서 형식의 템플릿을 지원합니다. 정규화된 경로, Adobe Experience Manager 리포지토리의 참조 경로 또는 이진 파일을 지정할 수 있습니다.
데이터 Yes 템플릿과 병합할 데이터가 포함된 XML 파일입니다. 정규화된 HTTP 위치 또는 이진 파일을 지정할 수 있습니다.
XCI 구성 아니오 서비스는 XCI 구성 파일을 사용하여 PDF 문서의 다양한 속성을 구성합니다. XCI 매개 변수는 템플릿이 XDP 또는 XDP 기반 PDF 문서 형식인 경우에만 적용됩니다. 정규화된 경로, Adobe Experience Manager 리포지토리의 참조 경로 또는 이진 파일을 지정할 수 있습니다.
로케일 아니오 pdf를 렌더링해야 하는 로캘입니다.
콘텐츠 루트 아니오 템플릿 리소스의 위치(이미지, 조각 등). 이 경로는 템플릿 위치를 기준으로 합니다.
PDF에 태그 추가 아니오 태그가 있는 PDF를 만들어 화면 읽기 프로그램 및 기타 보조 기술에 사용하도록 최적화하도록 지정합니다.
PDF에 글꼴 포함 아니오 글꼴을 포함하면 포함된 글꼴도 모든 장치에서 동일하게 보이지만 더 큰 출력 파일이 생성됩니다.
PDF 선형화(빠른 웹 보기) 아니오 빠른 웹 보기에 대해 PDF를 최적화하도록 선택
상태 유지 아니오 대화형 PDF 문서에는 양식을 구성하는 다양한 요소가 포함되어 있습니다. 이러한 요소에는 필드(데이터 허용 또는 표시), 단추(이벤트 트리거) 및 스크립트(특정 작업을 수행하는 명령)가 포함될 수 있습니다. 단추를 클릭하면 필드의 상태를 변경하는 이벤트가 트리거할 수 있습니다. 예를 들어 성별 옵션을 선택하면 필드 색이나 폼의 모양이 변경됩니다. 양식 상태가 변경되는 수동 이벤트의 예입니다. Adobe Experience Manager Forms Communication 기능을 사용하여 이러한 대화형 PDF 문서를 평면화하면 양식의 상태가 유지되지 않습니다. 양식이 평면화된 후에도 폼의 상태가 유지되도록 하려면 부울 값 보존 상태를 True로 설정하여 양식의 상태를 저장하고 유지합니다.
서명되지 않은 서명 필드 유지 아니오 PDF 파일이 평면화될 때 서명된 서명 필드와 서명되지 않은 서명 필드를 유지할지 여부를 지정합니다.
Adobe Acrobat Reader 버전 아니오 PDF 문서를 여는 데 필요한 Acrobat Reader의 최소 버전을 지정합니다. 기본 버전은 Adobe Acrobat 11입니다.

템플릿 및 데이터에서 PS(PostScript), PCL(프린터 명령 언어), ZPL(Zebra Printing Language), DPL(Datamax 프로그래밍 언어), IPL(Intermec Printer Language), TPCL(TEC Printer Command Language) 파일 생성

문서 생성 API를 사용하여 XDP 양식 디자인 또는 PDF 문서를 기반으로 하는 PostScript(PS), 프린터 명령 언어(PCL), ZPL(Zebra Printing Language), DPL(Datamax Programming Language), IPL(Intermec Printer Language), TPCL(TEC Printer Command Language) 문서를 만들 수 있습니다. 이러한 API를 사용하면 양식 디자인을 양식 데이터와 병합하여 문서를 생성할 수 있습니다. 문서에 문서를 저장하고 Power Automate를 사용하여 프린터로 보낼 수 있습니다. 다음 매개 변수를 지정하여 작업에 대한 다양한 옵션을 구성할 수 있습니다.

매개 변수 필수(필수) Description
Template Yes 템플릿은 PDF 문서의 모양과 동작을 정의합니다. API는 XDP 및 PDF 문서 형식의 템플릿을 지원합니다. 정규화된 경로, Adobe Experience Manager 리포지토리의 참조 경로 또는 이진 파일을 지정할 수 있습니다.
데이터 Yes 템플릿과 병합할 데이터가 포함된 XML 파일입니다. 정규화된 HTTP 위치 또는 이진 파일을 지정할 수 있습니다.
프린터 프로필 Yes 사용할 XDC 파일을 지정합니다. XDC 파일은 XML 형식의 프린터 설명 파일입니다. Adobe Experience Manager Forms Communications 기능은 XDC 파일을 사용하여 PostScript, PCL, DPL, TPCL 및 ZPL과 같은 형식으로 문서를 출력합니다. XDC 파일은 복사본 수, 이중 프린터 사용 여부 또는 스테이플러 옵션과 같은 인쇄 옵션을 지정하는 데도 사용됩니다.
출력 형식 Yes 작업에 대한 출력 파일 형식을 지정합니다. 지원되는 옵션은 PostScript(PS), PCL(Printer Command Language), ZPL(Zebra Printing Language), DPL(Datamax 프로그래밍 언어), IPL(Intermec Printer Language), TPCL(TEC Printer Command Language)입니다.
XCI 구성 아니오 사용할 XCI 파일을 지정합니다. XCI 파일은 양식 디자인 요소에 사용되는 글꼴을 설명하는 데 사용됩니다. 정규화된 경로, Adobe Experience Manager 리포지토리의 참조 경로 또는 이진 파일을 지정할 수 있습니다.
로케일 아니오 출력을 렌더링해야 하는 로캘입니다.
콘텐츠 루트 아니오 템플릿 리소스의 위치(이미지, 조각 등). 이 경로는 템플릿 위치를 기준으로 합니다.
복사본 수 아니오 생성할 출력 파일의 복사본 수를 지정합니다.
Pagination 아니오 양면 인쇄 또는 단면 인쇄를 사용할지 여부를 지정합니다. PostScript 및 PCL을 지원하는 프린터는 이 값을 사용합니다.

일반적인 오류 및 해결

오류 코드 Description 해결 방법
403 금지된. API 사용을 수행하려면 양식 사용자 그룹의 구성원이어야 합니다. 양식-사용자 그룹의 기술 계정 구성원으로 만들고 사용자(기술 계정)와 그룹(양식-사용자)을 모두 게시합니다.
400 지정한 템플릿이 잘못되었습니다. 유효한 템플릿을 지정하고 다시 시도합니다. 매개 변수 값 template 이 URL이 아닌 일반 텍스트인 경우 데이터 xml 문자열을 이진으로 변환합니다. Microsoft Power Automate의 binary() 식을 사용하여 변환할 수 있습니다. JCR 경로를 사용하는 경우 경로에 crx:// 접두사를 추가합니다.
400 지정한 데이터가 잘못되었습니다. 유효한 데이터 파일을 사용하여 다시 시도합니다. 매개 변수 값 data 이 URL이 아닌 일반 텍스트인 경우 데이터 xml 문자열을 이진으로 변환합니다. Microsoft Power Automate의 binary() 식을 사용하여 변환할 수 있습니다.
400 지정된 XCI 구성에 잘못된 값이 포함되어 있습니다. 구성 파일을 수정하고 다시 시도합니다. 매개 변수 값 XCI configuration 이 URL이 아닌 일반 텍스트인 경우 데이터 xml 문자열을 이진으로 변환합니다. Microsoft Power Automate의 binary() 식을 사용하여 변환할 수 있습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
AEM 서버 문자열 AEM 작성자 또는 게시 인스턴스의 URL을 지정합니다. 진실
조직 ID(조직) 문자열 조직 ID를 지정합니다. 진실
클라이언트 ID(clientId) 문자열 서비스 자격 증명에서 클라이언트 ID를 지정합니다. 진실
Client Secret(clientSecret) 시큐어스트링 (보안 문자열) 서비스 자격 증명에서 클라이언트 암호를 지정합니다. 진실
기술 계정 ID(ID) 문자열 AEM 기술 계정의 ID를 지정합니다. 진실
메타 범위(전이) 문자열 서비스 자격 증명에서 메타 범위를 지정합니다. 진실
프라이빗 키(privateKey) 시큐어스트링 (보안 문자열) 프라이빗 키를 제공합니다. 서비스 자격 증명에 포함됩니다. 진실
Adobe IMS 호스트 URL(imsEndpoint) 문자열 Adobe Identity Management 서비스의 호스트 URL을 제공합니다. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

템플릿 및 데이터에서 PDF 생성(미리 보기)

PDF 또는 XDP 템플릿에서 PDF 문서를 생성하고 XML 데이터를 병합합니다.
템플릿 및 데이터에서 PS, PCL, ZPL, DPL, IPL 또는 TPCL 파일 생성(미리 보기)

XDP 파일 또는 PDF 문서에서 PS(PostScript), PCL(Printer Command Language), ZPL(Zebra Printing Language), DPL(Datamax Programming Language), IPL(Intermec Printer Language) 또는 TPCL(TEC Printer Command Language) 문서를 XDP 파일 또는 PDF 문서에서 생성하고 XML 데이터를 병합합니다.

템플릿 및 데이터에서 PDF 생성(미리 보기)

작업 ID:
GeneratePDFOutput

PDF 또는 XDP 템플릿에서 PDF 문서를 생성하고 XML 데이터를 병합합니다.

매개 변수

Name 키 필수 형식 Description
Template
 template True binary

XDP 또는 PDF 템플릿의 이진 파일 또는 위치를 제공합니다.
데이터
 data True binary

템플릿과 병합할 XML 데이터의 이진 파일 또는 위치를 제공합니다.
XCI 구성
 xci binary

XCI 구성 파일의 이진 파일 또는 위치를 제공합니다.
로케일
 locale string

PDF 문서의 로캘을 선택합니다.
콘텐츠 루트
 contentRoot string

템플릿에서 사용되는 자산을 검색할 URI, 절대 참조 또는 위치를 지정합니다.
PDF에 태그 추가
 isTagged boolean

태그가 있는 PDF를 만들어 화면 읽기 프로그램 및 기타 보조 기술을 사용하는 사용자를 위해 PDF를 최적화합니다.
PDF에 글꼴 포함
 embedFonts boolean

장치 및 화면에서 일관된 모양을 위해 PDF에 글꼴 포함
PDF 선형화(빠른 웹 보기)
 linearizedPDF boolean

빠른 웹 보기에 대해 PDF를 최적화하도록 선택
상태 유지
 retainFormState boolean

문서가 평면화된 후 상태를 유지하도록 선택합니다.
서명되지 않은 서명 필드 유지
 retainUnsignedSignatureFields boolean

서명되지 않은 서명 필드를 유지하거나 제거하려면 선택합니다.
Adobe Acrobat Reader 버전
 acrobatVersion string

PDF 문서를 여는 데 필요한 최소 버전의 Acrobat Reader를 선택합니다.

반환

response
PDFResult

템플릿 및 데이터에서 PS, PCL, ZPL, DPL, IPL 또는 TPCL 파일 생성(미리 보기)

작업 ID:
GeneratePrintedOutput

XDP 파일 또는 PDF 문서에서 PS(PostScript), PCL(Printer Command Language), ZPL(Zebra Printing Language), DPL(Datamax Programming Language), IPL(Intermec Printer Language) 또는 TPCL(TEC Printer Command Language) 문서를 XDP 파일 또는 PDF 문서에서 생성하고 XML 데이터를 병합합니다.

매개 변수

Name 키 필수 형식 Description
Template
 template True binary

XDP 또는 PDF 템플릿의 이진 파일 또는 위치를 제공합니다.
데이터
 data True binary

템플릿과 병합할 XML 데이터의 이진 파일 또는 위치를 제공합니다.
XCI 구성
 xci binary

XCI 구성 파일의 이진 파일 또는 위치를 제공합니다.
로케일
 locale string

출력 파일의 로캘을 선택합니다.
콘텐츠 루트
 contentRoot string

템플릿에서 사용되는 자산을 검색할 URI, 절대 참조 또는 위치를 지정합니다.
복사본 수
 copies integer

생성할 복사본 수를 지정합니다.
Pagination
 paginationOverride string

페이지의 한쪽 또는 양쪽에 인쇄하는 옵션을 설정합니다.
프린터 프로필
 xdcUri True string

프린터 기능 및 용지 종류와 같은 프린터 기능을 설명하는 XDC 파일을 선택합니다.
출력 형식
 renderType True string

사용 가능한 출력 형식 중에서 선택합니다.

반환

response
PrintedResult

정의

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary