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

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Correspondence Management

개요 overview

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

URL 기반 호출 url-based-invocation

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

문자 템플릿의 식별자(cmLetterId 매개 변수 사용).
원하는 데이터 소스에서 가져온 XML 데이터의 URL(cmDataUrl 매개 변수 사용).

예를 들어 사용자 정의 포털은 다음과 같이 URL을 준비합니다.
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]: 포털에 있는 링크의 href일 수 있습니다.

NOTE

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

NOTE

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

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

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

편지 지정을 위한 매개변수 parameters-for-specifying-letter

이름

유형

설명

cmLetterInstanceId

문자열

편지 인스턴스에 대한 식별자.

cmLetterId

문자열

Letter 템플릿의 이름입니다.

표의 매개 변수 순서는 문자 로드에 사용되는 매개 변수의 기본 설정을 지정합니다.

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

이름

유형

설명

cmDataUrl

URL

cq, ftp, http 또는 file과 같은 기본 프로토콜을 사용하는 소스 파일의 XML 데이터입니다.

cmLetterInstanceId

문자열

편지 인스턴스에서 사용할 수 있는 xml 데이터를 사용합니다.

cmUseTestData

부울

데이터 사전에 첨부된 테스트 데이터를 재사용합니다.

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

기타 매개 변수 other-parameters

이름

유형

설명

cmPreview

부울

True로 설정하면 편지가 미리 보기 모드로 열립니다

임의

타임스탬프

브라우저 캐싱 문제를 해결하려면.

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2