Show Menu
화제×

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

개요

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

URL 기반 호출

사용자 지정 포털에서 통신 만들기 애플리케이션을 호출하는 한 가지 방법은 다음 요청 매개 변수를 사용하여 URL을 준비하는 것입니다.
  • 편지 템플릿의 식별자(cmLetterId 매개 변수 사용) 또는 편지 템플릿의 이름(cmLetterName 매개 변수 사용)
  • cmDataUrl 매개 변수를 사용하여 원하는 데이터 소스에서 가져온 XML 데이터의 URL입니다.
예를 들어 사용자 지정 포털에서 URL을 https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL] 를 참조하십시오. 포털에 Letter 템플릿 이름이 있으면 URL이 https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL] .
필요한 매개 변수가 GET 요청으로 전달되면 URL에 동일한(선명하게 표시됨)을 노출하여 이러한 방식으로 호출하는 것은 안전하지 않습니다.
통신 만들기 응용 프로그램을 호출하기 전에 데이터를 저장하고 업로드하여 지정된 dataURL에서 통신 UI를 호출합니다. 이 작업은 사용자 지정 포털 자체 또는 다른 백엔드 프로세스를 통해 수행할 수 있습니다.

인라인 데이터 기반 호출

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

문자 지정을 위한 매개 변수

이름 유형 설명
cmLetterInstanceId 문자열 문자 인스턴스의 식별자입니다.
cmLetterName 문자열
문자 템플릿의 식별자입니다.
서버에 동일한 이름의 여러 CM 문자가 있는 경우 URL의 cmLetterName 매개 변수를 사용하면 "이름이 있는 여러 문자가 있습니다"라는 오류가 발생합니다. 이러한 경우 URL에 cmLetterName 대신 cmLetterId 매개 변수를 사용하십시오.
cmLetterId 문자열 편지 템플릿의 이름입니다.
표의 매개 변수 순서는 문자를 로드하는 데 사용되는 매개 변수의 환경 설정을 지정합니다.

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

이름 유형 설명
cmDataUrl URL cq, ftp, http 또는 file과 같은 기본 프로토콜을 사용하여 소스 파일의 XML 데이터
cmLetterInstanceId 문자열 Letter 인스턴스에서 사용할 수 있는 xml 데이터 사용.
cmUseTestData 부울 데이터 사전에 첨부된 테스트 데이터를 재사용합니다.
표의 매개 변수 순서는 XML 데이터를 로드하는 데 사용되는 매개 변수의 환경 설정을 지정합니다.

기타 매개 변수

이름 유형 설명
cmPreview 부울 True로 설정하면 미리 보기 모드에서 문자를 열 수 있습니다.
임의 타임스탬프 브라우저 캐싱 문제를 해결하려면
cmDataURL에 http 또는 cq 프로토콜을 사용하는 경우 http/cq의 URL에 익명으로 액세스할 수 있어야 합니다.