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

개요

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

URL 기반 호출

사용자 지정 포털에서 서신 만들기 애플리케이션을 호출하는 한 가지 방법은 다음 요청 매개 변수로 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].

노트

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

노트

서신 만들기 애플리케이션을 호출하기 전에 데이터를 저장하고 업로드하여 지정된 dataURL에서 서신 만들기 UI를 호출합니다. 이 작업은 사용자 지정 포털 자체 또는 다른 백엔드 프로세스를 통해 수행할 수 있습니다.

인라인 데이터 기반 호출

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

문자 지정에 대한 매개 변수

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

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

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

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

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

XML 데이터 소스 지정에 대한 매개 변수

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

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

기타 매개 변수

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

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

이 페이지에서는