사용자 지정 포털과 통신 UI 만들기 통합

개요

이 문서에서는 Create Correspondence Solution을 환경과 통합하는 방법을 자세히 설명합니다.

URL 기반 호출

사용자 지정 포털에서 통신 만들기 애플리케이션을 호출하는 한 가지 방법은 다음 요청 매개 변수를 사용하여 URL을 준비하는 것입니다.

  • 문자 템플릿의 식별자입니다(cmLetterId 매개 변수 사용).

  • 원하는 데이터 소스에서 가져온 XML 데이터의 URL(cmDataUrl 매개 변수 사용).

예를 들어 사용자 지정 포털은
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL], 포털의 링크의 href일 수 있습니다.

노트

필요한 매개 변수가 URL에 동일하게(선명하게 표시됨)을 노출하여 GET 요청으로 전달되므로 이러한 방식으로 호출하는 것은 안전하지 않습니다.

노트

통신 만들기 응용 프로그램을 호출하기 전에 데이터를 저장하고 업로드하여 지정된 dataURL에서 통신 만들기 UI를 호출합니다. 사용자 지정 포털 자체나 다른 백엔드 프로세스를 통해 수행할 수 있습니다.

인라인 데이터 기반 호출

통신 만들기 응용 프로그램을 호출하는 또 다른 (그리고 더 안전한) 방법은 https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html의 URL을 단순히 히트하고, 매개 변수와 데이터를 전송하여 POST 요청으로 통신 만들기 응용 프로그램을 호출할 수 있습니다(최종 사용자로부터 숨기기). 또한 이제 이전 접근 방식에서는 불가능하거나 적합하지 않은 cmData 매개 변수를 사용하여, 동일한 요청의 일부로 통신 응용 프로그램 인라인에 대한 XML 데이터를 전달할 수 있습니다.

문자 지정을 위한 매개 변수

이름 유형 설명
cmLetterInstanceId 문자열 문자 인스턴스의 식별자입니다.
cmLetterId 문자열 편지 템플릿의 이름입니다.

표의 매개 변수 순서는 문자를 로드하는 데 사용되는 매개 변수의 환경 설정을 지정합니다.

XML 데이터 소스 지정을 위한 매개 변수

이름 유형 설명
cmDataUrl
URL cq, ftp, http 또는 file과 같은 기본 프로토콜을 사용하는 소스 파일의 XML 데이터입니다.
cmLetterInstanceId 문자열 문자 인스턴스에서 사용할 수 있는 xml 데이터 사용.
cmUseTestData 부울 데이터 사전에 첨부된 테스트 데이터를 다시 사용하려면

테이블의 매개 변수 순서는 XML 데이터를 로드하는 데 사용되는 매개 변수의 환경 설정을 지정합니다.

기타 매개 변수

이름 유형 설명
cmPreview
부울 미리 보기 모드에서 문자를 열려면 True입니다.
임의 타임스탬프 브라우저 캐싱 문제를 해결하려면 다음을 수행하십시오.

cmDataURL에 http 또는 cq 프로토콜을 사용하는 경우 http/cq의 URL에 익명으로 액세스할 수 있어야 합니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now