适用于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. 使用最新的自适应AEM块创建或更新您的Forms项目 （入门教程）

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. 将复制的电子表格链接 ​粘贴到“提交”字段的​ 操作 ​列

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
   • [repository]→您的GitHub存储库名称
   • [organization]→您的GitHub组织/用户名

请求配置：

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
• [repository]→您的GitHub存储库名称
• [organization]→您的GitHub组织/用户名

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 Not Found错误

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系统