AEM Forms에 대한 제출 액션 구성

Forms 제출 서비스는 간단한 데이터 캡처 시나리오에 이상적인 Adobe에서 호스팅하는 엔드포인트입니다.

지원되는 대상

• 스프레드시트: Google Sheets, Microsoft Excel (OneDrive/SharePoint)
• 이메일: 양식 데이터를 지정된 이메일 주소로 보냅니다.

구성 단계

1. 대상 액세스 설정

   • 스프레드시트의 경우: 대상 스프레드시트에서 forms@adobe.com에 편집 권한을 부여합니다.
   • 이메일의 경우: 수신자 이메일 주소에 액세스할 수 있는지 확인합니다.

2. 양식 제출 구성

   • 저작 환경에서 양식을 엽니다.
   • 제출 작업을 “Forms 제출 서비스”로 설정합니다.
   • 대상 스프레드시트 URL 또는 이메일 주소를 지정합니다.
   • 양식을 저장하고 게시합니다.

3. 테스트 제출

   • 양식을 통해 테스트 데이터를 제출합니다.
   • 타기팅된 대상에 데이터가 표시되는지 확인합니다.
   • 제출이 실패하면 오류 로그를 확인합니다.

중요 참고 사항

• 서비스 계정 forms@adobe.com에는 대상 스프레드시트에 대한 편집 액세스 권한이 필요합니다.
• 양식 제출 시 이메일 알림이 즉시 전송됩니다.
• 데이터 유효성 검사는 서비스 수준에서 발생합니다.

복잡한 처리를 위해 양식 데이터를 AEM as a Cloud Service 게시 인스턴스에 직접 제출합니다.

AEM 게시 사용 시기

• 제출 후 사용자 정의 AEM 워크플로가 필요한 경우
• 데이터베이스와 양식 데이터 모델(FDM) 통합
• 서드파티 서비스 통합 (Marketo, Power Automate, Workfront Fusion)
• Azure Blob Storage 또는 SharePoint 문서 라이브러리
• 복잡한 서버측 유효성 검사 또는 처리 논리

사용 가능한 제출 작업

• REST 엔드포인트에 제출
• AEM 메일 서비스를 통해 이메일 보내기
• 양식 데이터 모델을 사용하여 제출
• AEM 워크플로 호출
• SharePoint에 제출
• OneDrive에 제출
• Azure Blob Storage에 제출
• Microsoft Power Automate에 제출
• Adobe Workfront Fusion에 제출
• Adobe Marketo Engage에 제출

구성 요구 사항

​1. Edge Delivery에서 AEM 인스턴스 URL 업데이트

constant.js 아래 form 블록의 submitBaseUrl 파일에서 AEM Cloud Service 인스턴스 URL을 업데이트합니다. 사용자 환경에 따라 URL을 구성할 수 있습니다.

Cloud Service 인스턴스용

export const submitBaseUrl = '<aem-publish-instance-URL>';

로컬 개발용

export const submitBaseUrl = 'http://localhost:<port-number>';

​2. OSGi 레퍼러 필터

특정 Edge Delivery 사이트 도메인을 허용하도록 레퍼러 필터를 구성합니다.

1. OSGi 구성 파일 org.apache.sling.security.impl.ReferrerFilter.cfg.json을(를) 만들거나 업데이트합니다.

2. 특정 사이트 도메인에 다음 구성을 추가합니다.

   code language-json
   { "allow.empty": false, "allow.hosts": [ "main--abc--adobe.aem.live", "main--abc1--adobe.aem.live" ], "allow.hosts.regexp": [ "https://.*\\.aem\\.live:443", "https://.*\\.aem\\.page:443", "https://.*\\.hlx\\.page:443", "https://.*\\.hlx\\.live:443" ], "filter.methods": [ "POST", "PUT", "DELETE", "COPY", "MOVE" ], "exclude.agents.regexp": [ "" ] }

3. Cloud Manager을 통해 구성 배포

자세한 OSGi 레퍼러 필터 구성은 레퍼러 필터 안내서를 참조하십시오.

​3. CORS(원본 간 리소스 공유) 문제

특정 Edge Delivery 사이트 도메인의 요청을 허용하도록 AEM에서 CORS 설정을 구성합니다.

개발자 Localhost

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(http://localhost(:\d+)?$)#" CORSTrusted=true

Edge Delivery 사이트 - 각 사이트 도메인을 개별적으로 추가

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc--adobe\.aem\.live$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc1--adobe\.aem\.live$)#" CORSTrusted=true

레거시 Franklin 도메인(사용 중인 경우)

SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.page$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.live$)#" CORSTrusted=true

자세한 CORS 구성은 CORS 구성 안내서를 참조하십시오.

로컬 개발 환경에 CORS를 사용하려면 CORS(원본 간 리소스 공유) 이해 문서를 참조하십시오.

​4. 양식 구성

1. 범용 편집기에서 양식을 생성합니다.
2. 제출 작업을 AEM Forms 작업을 타기팅하도록 구성합니다.
3. 제출 엔드포인트 경로를 지정합니다.
4. 양식을 Edge Delivery 사이트에 게시합니다.

1. Google Docs/Sheets에서 양식 구조를 생성합니다.
2. Forms 제출 서비스 엔드포인트를 구성합니다.
3. 대상 스프레드시트에 forms@adobe.com 편집 액세스 권한을 부여합니다.
4. 문서를 Edge Delivery 사이트에 게시합니다.
5. 양식 제출 및 데이터 플로우를 테스트합니다.

1. 범용 편집기에서 양식을 작성합니다.
2. “AEM 워크플로 호출”에 대한 제출 작업을 구성합니다.
3. AEM 게시에서 Dispatcher 및 레퍼러 필터를 설정합니다.
4. CDN 라우팅 규칙을 구성합니다.
5. 양식을 게시하고 워크플로 실행을 테스트합니다.