사용자 지정 포털과 서신 만들기 UI 통합 integrating-create-correspondence-ui-with-your-custom-portal

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

개요 overview

이 문서에서는 사용자 환경과 서신 솔루션 만들기 를 통합하는 방법을 자세히 설명합니다.

URL 기반 호출 url-based-invocation

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

  • 편지 템플릿의 식별자(cmLetterId 매개 변수 사용) 또는 Letter 템플릿의 이름(cmLetterName 매개 변수 사용)입니다.

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

예를 들어 사용자 지정 포털은 다음과 같이 URL을 준비합니다
https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]: 포털에서 링크의 href일 수 있습니다.
포털에 편지 템플릿 이름이 있는 경우 URL은
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL].

NOTE
필요한 매개 변수가 URL에 동일하게(명확하게 표시)를 노출하여 GET 요청으로 전달되므로 이러한 방식으로 를 호출하는 것은 안전하지 않습니다.
NOTE
서신 만들기 애플리케이션을 호출하기 전에 데이터를 저장하고 업로드하여 지정된 dataURL에서 서신 만들기 UI를 호출합니다. 이 작업은 사용자 지정 포털 자체 또는 다른 백엔드 프로세스를 통해 수행할 수 있습니다.

인라인 데이터 기반 호출 inline-data-based-invocation

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

문자 지정에 대한 매개 변수 parameters-for-specifying-letter

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

편지 템플릿의 식별자입니다.

서버에 동일한 이름의 CM 문자가 여러 개 있는 경우 URL에서 cmLetterName 매개 변수를 사용하면 "Multiple letters exist with name" 오류가 발생합니다. 이러한 경우 cmLetterName 대신 URL에서 cmLetterId 매개 변수를 사용합니다.

cmLetterId
문자열
편지 템플릿의 이름입니다.

테이블의 매개변수 순서는 편지 로딩에 사용되는 매개변수의 기본 설정을 지정합니다.

XML 데이터 소스를 지정하기 위한 매개 변수 parameters-for-specifying-the-xml-data-source

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

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

기타 매개 변수 other-parameters

이름
유형
설명
cmPreview
부울
미리 보기 모드에서 문자를 열려면 True입니다
임의
Timestamp
브라우저 캐싱 문제를 해결하려면

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da