설명서AEM 6.5사용 안내서

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 사용자
  • 개발자

개요 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

응답 만들기 응용 프로그램을 호출하는 다른(및 보다 안전한) 방법은 매개 변수와 데이터를 전송하여 응답 만들기 응용 프로그램을 POST 요청으로(최종 사용자에게 숨기기) 호출하는 동안 https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html에서 URL을 히트하는 것입니다. 즉, 이전 접근 방법에서는 불가능하거나 이상적이지 않았던 서신 작성 애플리케이션 인라인(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