[AEM Forms]{class="badge positive" title="AEM Forms에 적용됩니다)."}

동일한 적응형 양식에 대한 환경별 REST 끝점 구성

적응형 양식을 개발에서 스테이징으로 승격할 때 양식은 일반적으로 각 환경의 다른 REST 끝점에 제출해야 하지만 양식 자체는 동일합니다. 양식의 제출 작업에서 끝점 URL을 하드코딩하면 동일한 URL이 양식과 함께 모든 환경으로 이동하므로 이것이 중단됩니다.

이 문서에서는 하나의 휴대용 적응형 양식을 유지하고 해당 REST 끝점에 제출 작업이 각 환경에서 올바른 끝점으로 확인되도록 하는 방법에 대해 설명합니다. 양식이 URL이 아닌 이름​을(를) 사용하여 REST 구성을 참조하며, 각 환경은 해당 구성에 대해 고유한 값을 제공합니다.

사전 요구 사항 prerequisites

스테이징에서 RESTful 서비스 구성 만들기 create-rest-configuration

스테이징 작성자 인스턴스에서 폼이 참조하는 명명된 구성을 만듭니다. 서비스 끝점 URL​을(를) 스테이징용 REST 또는 웹후크 끝점으로 설정합니다.

구성 컨테이너에서 적응형 양식 지정 set-configuration-container

스테이징에서 양식을 REST 구성을 포함하는 구성 컨테이너와 연결합니다.

REST에 제출 엔드포인트 작업 구성 configure-submit-action

스테이징에서 하드 코딩된 URL 대신 명명된 REST 구성을 통해 제출하도록 양식을 구성합니다. 전체 제출 동작 참조에 대해서는 REST 끝점에 대한 적응형 양식 제출 동작 구성을 참조하십시오.

이제 양식은 고정 URL이 아닌 명명된 구성을 통해 제출 끝점을 확인합니다.

스테이징에서 프로덕션으로 양식 승격 promote-across-environments

스테이징에서 구성 및 테스트한 후 동일한 양식 및 구성 컨테이너를 프로덕션으로 이동합니다. 다음 접근 방식 중 하나를 사용할 수 있습니다.

옵션 1: 작성자 및 패키지 접근 방식 option-package

작성자가 각 환경에서 직접 양식 및 구성을 유지 관리할 때 사용합니다.

옵션 2: 컨텍스트 인식 재정의 접근 방식(자동화에 권장) option-context-aware

배포 후 수동으로 편집하지 않고 엔드포인트, 사용자 이름 및 암호를 환경별로 자동으로 해결하는 패키지화된 구성을 한 개 원할 때 사용합니다. 이 접근 방식은 Cloud Manager 환경 변수를 사용하여 구성 속성을 재정의합니다.

REST 구성의 경우 일반적으로 serviceEndPoint, userName 및 password 속성에 대한 환경 변수를 만든 다음 프로젝트의 OsgiConfigurationOverrideProvider 구성 파일에서 이를 참조합니다.

전체 절차는 컨텍스트 인식 클라우드 구성을 참조하십시오.

프로덕션에서 엔드포인트 URL 업데이트 configure-endpoint-on-production

프로덕션에 패키지를 설치한 후 적응형 양식과 REST 구성 name(예: restTest)이(가) 스테이징과 일치합니다. 해당 구성의 서비스 끝점 URL​은(는) 여전히 패키지의 스테이징 끝점을 가리킵니다. 프로덕션에서 구성을 열고 프로덕션 끝점 URL로 대체합니다.

테스트 중에 Webhook 캡처 서비스와 같은 요청 검사기는 각 제출을 받는 끝점을 확인할 수 있도록 환경당 고유한 URL을 제공합니다.

라우팅 확인 verify

스테이징 및 프로덕션에서 동일한 양식을 제출하고 각 환경이 다른 환경의 URL이 아닌 자체 끝점에 게시되는지 확인하십시오.

모범 사례 best-practices

관련 문서 related-articles