Edge Delivery Services용 Forms 제출 서비스

완벽한 대상:

• 간단한 데이터 수집 양식을 작성하는 콘텐츠 작성자
• 빠른 양식-스프레드시트 워크플로우가 필요한 중소기업
• 마케팅 팀 리드 정보 수집
• 이벤트 이끌이 등록 관리

다음 항목에 대한 대체 요소 고려:

• 사용자 지정 논리가 필요한 복잡한 워크플로
• 데이터베이스와 엔터프라이즈 통합
• 고급 유효성 검사 또는 처리가 필요한 Forms

• 백엔드 인프라가 필요 없음 - Adobe이 제출 엔드포인트를 호스팅함
• 많이 사용하는 스프레드시트 플랫폼과 직접 통합
• 양식 필드에서 스프레드시트 열로 자동 데이터 매핑

• 즉시 데이터 캡처 - 제출물이 스프레드시트에 즉시 나타납니다.
• 구조화된 저장소 - 쉽게 분석할 수 있도록 구성된 열
• 실시간 공동 작업 - 여러 팀원이 데이터에 액세스하고 데이터를 분석할 수 있습니다.

• 기존 사용 권한 활용 - 스프레드시트 플랫폼의 공유 컨트롤을 사용합니다.
• Adobe 관리 보안 - 엔터프라이즈급 보호를 사용하는 보안 제출 엔드포인트
• 데이터 소유권 - 데이터가 선택한 스프레드시트 플랫폼에 있습니다.

• 최신 적응형 Forms 블록이 설치된 Edge Delivery Services 프로젝트에 대해 GitHub 저장소 설정
• 액세스 승인 - 저장소가 허용 목록에 추가하다에 추가됨

지원되는 플랫폼 중 하나를 선택하십시오.

• Google 시트 - 시트 만들기 권한이 있는 Google 계정
• Microsoft OneDrive - Excel Online에 액세스할 수 있는 Microsoft 365 계정
• SharePoint - 목록/라이브러리 권한을 가진 SharePoint 액세스

• 대상 스프레드시트의 권한 편집
• 에 대한 액세스 권한을 부여하기 위해 ​기능 공유forms@adobe.com
• 선택한 플랫폼에 대한 링크 생성 권한

두 방법 중 하나를 구성하기 전에 AEM 프로젝트 기반이 준비되었는지 확인하십시오.

1. 최신 적응형 Forms 블록(시작 자습서)을 사용하여 AEM 프로젝트 만들기 또는 업데이트

2. 프로젝트 루트에서fstab.yaml 업데이트:

   code language-yaml
   # Replace with the path to your shared folder mountpoints: /: https://drive.google.com/drive/folders/your-shared-folder-id

3. 과(와) ​프로젝트 폴더 공유forms@adobe.com(편집 권한 필요)

Google Sheets 또는 Microsoft Excel을 사용하여 양식 구조를 만듭니다.

양식 만들기 단계:

1. 스프레드시트 플랫폼을 엽니다(Google Sheets 또는 Microsoft Excel)
2. 양식 프로젝트용 새 스프레드시트 만들기
3. 시트 이름 지정(helix-default 또는 shared-aem이어야 함)
4. 양식 만들기 가이드 ​를 사용하여 양식 구조를 정의

예: 필드 유형, 레이블 및 유효성 검사 규칙을 사용한 양식 정의

유효성 검사 체크포인트:

• 양식 구조가 모든 필수 필드로 완료되었습니다.
• 시트 이름이 올바르게 지정됨(helix-default 또는 shared-aem)
• 필드 유형 및 유효성 검사 규칙이 올바르게 구성됨

양식 제출 데이터를 받을 전용 시트를 설정합니다.

데이터 시트 설정:

1. 기존 스프레드시트에 새 시트 추가
2. 시트 이름을 정확히incoming ​로 지정합니다(대/소문자 구분).
3. 양식 필드와 일치하는 열 머리글 설정
4. 변경 내용을 유지하려면 스프레드시트를 저장 ​하세요.

예: 양식 필드와 일치하는 열 머리글이 있는 시트를 가져오는 중

유효성 검사 체크포인트:

• 스프레드시트에 incoming장이 있음
• 열 헤더가 양식 필드 이름과 일치함
• 시트가 올바르게 저장되고 액세스할 수 있음

Adobe Forms 제출 서비스에 스프레드시트에 대한 액세스 권한을 부여합니다.

공유 프로세스:

1. 스프레드시트의 오른쪽 상단에 있는 공유 단추를 클릭합니다

2. Adobe 서비스 계정 추가:

   • 전자 메일: forms@adobe.com
   • 권한 수준: 편집기(데이터 쓰기에 필요)

3. 공유 초대 보내기

4. 다음 단계를 위해 스프레드시트 링크 복사

   
   Adobe 서비스 액세스 권한을 부여하기 위한 단계별 공유 프로세스

플랫폼별 지침:

Google 시트:

• forms@adobe.com을(를) 편집기로 추가
• "링크가 있는 모든 사용자가 볼 수 있음"이 활성화되었는지 확인합니다.
• 공유 가능한 링크 복사

Microsoft Excel(OneDrive/SharePoint):

• 편집 권한이 있는 forms@adobe.com 추가

• 링크 공유를 "링크가 있는 모든 사용자가 편집할 수 있음"으로 설정

• 공유 URL 복사

  
  예: 양식 구성에 대한 공유 가능한 링크 복사

유효성 검사 체크포인트:

• forms@adobe.com이(가) 스프레드시트에 대한 편집기 액세스 권한이 있습니다.
• 스프레드시트 링크가 복사되어 사용할 수 있습니다.
• 권한을 공유하면 외부 액세스가 허용됨

양식 정의를 제출 스프레드시트에 연결합니다.

양식 스프레드시트 연결:

1. 양식 정의 스프레드시트 열기(helix-default 또는 shared-aem시트가 있는 스프레드시트)

2. 양식 정의에서 제출 필드 행 찾기

3. 복사한 스프레드시트 링크 ​를 제출 필드의 Action 열에 붙여 넣습니다.

4. 양식 정의에 변경 내용을 저장

   

예: 데이터 수집 스프레드시트에 제출 동작 연결

양식 게시:

1. 브라우저에서 AEM Sidekick 열기
2. 구성을 테스트하려면 양식 미리 보기
3. 라이브로 만들려면 양식을 게시

최종 유효성 검사:

• 스프레드시트 링크가 제출 필드 작업에 올바르게 추가됩니다.
• 양식 정의가 저장되고 게시됨
• 양식 미리 보기에 모든 필드가 올바르게 표시됨
• 제출 버튼이 올바르게 구성됨

참조 자료:

• 적절한 구성이 있는 예제 스프레드시트 작성
• 게시 지침에 대한 AEM Sidekick 설명서

완벽한 대상:

• 자동화된 데이터 수집 시스템
• 사용자 정의 양식 구현
• 기존 애플리케이션과 통합
• 대량 데이터 제출 워크플로우

API를 사용하기 전에 다음을 확인하십시오.

• 스프레드시트 설정 완료(incoming장 포함)
• 에게 Adobe 서비스 액세스forms@adobe.com 부여
• 게시된 양식의 양식 ID
• 저장소 정보(조직 및 사이트 이름)

기본 URL: https://forms.adobe.com/adobe/forms/af/submit/{id}

필수 헤더:

• Content-Type: application/json
• x-adobe-routing: tier=live,bucket=main--[repository]--[organization]

API 설명서: 전체 API 참조

Postman은 API 제출을 테스트할 수 있는 사용자 친화적인 인터페이스를 제공합니다.

설치 지침:

1. Postman에서 새 POST 요청 만들기

2. 끝점 구성: https://forms.adobe.com/adobe/forms/af/submit/{id}

3. 자리 표시자 바꾸기:

   • 실제 양식 ID→ {id}
   • GitHub 저장소 이름→ [repository]
   • GitHub 조직/사용자 이름→ [organization]

요청 구성:

POST https://forms.adobe.com/adobe/forms/af/submit/your-form-id

Headers:
Content-Type: application/json
x-adobe-routing: tier=live,bucket=main--your-repo--your-org

Body (JSON):
{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Mary",
            "age": "35",
            "subscribe": null,
            "email": "mary@gmail.com"
                }
}

예상 응답:

• 상태 코드: 201 Created
• 스프레드시트 시트에 ​데이터가 즉시 표시됨incoming

예: Postman 인터페이스를 사용하여 API를 제출했습니다

터미널/명령 프롬프트를 선호하는 개발자의 경우 curl을 사용하여 데이터를 프로그래밍 방식으로 제출하십시오.

명령줄 설정:

아래 명령에서 다음 자리 표시자를 바꿉니다.

• 실제 양식 ID→ {id}
• GitHub 저장소 이름→ [repository]
• GitHub 조직/사용자 이름→ [organization]

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" \
    --header "Content-Type: application/json" \
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" \
    --data '{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Joe",
            "age": "35",
            "subscribe": null,
      "email": "joe@example.com"
                }
            }'

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" ^
    --header "Content-Type: application/json" ^
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" ^
  --data "{\"data\": {\"startDate\": \"2025-01-10\", \"endDate\": \"2025-01-25\", \"destination\": \"Australia\", \"class\": \"First Class\", \"budget\": \"2000\", \"amount\": \"1000000\", \"name\": \"Joe\", \"age\": \"35\", \"subscribe\": null, \"email\": \"joe@example.com\"}}"

$body = @{
  data = @{
    startDate = "2025-01-10"
    endDate = "2025-01-25"
    destination = "Australia"
    class = "First Class"
    budget = "2000"
    amount = "1000000"
    name = "Joe"
    age = "35"
    subscribe = $null
    email = "joe@example.com"
  }
} | ConvertTo-Json -Depth 3

Invoke-RestMethod -Uri "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" `
  -Method POST `
  -Headers @{"Content-Type"="application/json"; "x-adobe-routing"="tier=live,bucket=main--your-repo--your-org"} `
  -Body $body

성공한 응답:

HTTP/1.1 201 Created
Connection: keep-alive
Content-Length: 0
X-Request-Id: 02a53839-2340-56a5-b238-67c23ec28f9f
X-Message-Id: 42ecb4dd-b63a-4674-8f1a-05a4a5b0372c
Date: Fri, 10 Jan 2025 13:06:10 GMT
Access-Control-Allow-Origin: *

데이터 확인:

제출 후 스프레드시트에 데이터가 표시되는지 확인합니다.

예: API를 통해 들어오는 시트에 데이터를 썼습니다

응답 유효성 검사:

• HTTP 상태: 201 Created은(는) 성공적으로 제출했음을 나타냅니다.
• X-Request-Id: 제출 추적을 위한 고유 식별자
• 데이터가 시트에 incoming초 이내에 표시됨
• 모든 양식 필드 ​이(가) 스프레드시트 열에 올바르게 매핑되었습니다.

문제: 403 사용할 수 없는 오류

Causes: Missing or incorrect access permissions
Solutions:
- Verify forms@adobe.com has Editor access to your spreadsheet
- Check that your repository is added to the allowlist
- Confirm the x-adobe-routing header format

문제: 404 찾을 수 없음 오류

Causes: Incorrect Form ID or endpoint URL
Solutions:
- Verify your Form ID is correct
- Check the API endpoint URL format
- Ensure your form is published and live

문제: 스프레드시트에 데이터가 표시되지 않음

Causes: Missing 'incoming' sheet or permission issues
Solutions:
- Confirm 'incoming' sheet exists (case-sensitive)
- Verify column headers match form field names exactly
- Check forms@adobe.com has edit permissions
- Ensure spreadsheet is shared properly

문제: 잘못된 JSON 형식 오류

Causes: Malformed request body
Solutions:
- Validate JSON syntax using online JSON validators
- Ensure proper escaping of special characters
- Check quote marks and brackets are balanced

지원 채널:

• 조기 액세스 문제: 전자 메일 aem-forms-ea@adobe.com
• API 설명서: 개발자 참조
• 커뮤니티 지원: Adobe Experience League 커뮤니티

• 고급 Forms 만들기 - 유효성 검사, 조건부 논리 및 사용자 지정 스타일 추가
• 양식 구성 요소 안내서 - 사용 가능한 양식 필드 형식 살펴보기

• AEM 게시 제출 - 복잡한 워크플로 및 엔터프라이즈 통합용
• 사용자 지정 제출 액션 - 고급 제출 처리

• 양식 분석 - 양식 성능 및 사용 추적
• 데이터 통합 - 양식을 데이터베이스 및 CRM 시스템에 연결