適用於Edge Delivery Services的Forms提交服務

最適合：

• 內容建立者 ​正在建置簡單的資料收集表單
• 小型企業 ​需要快速的表單至試算表工作流程
• 行銷團隊 ​正在收集潛在客戶資訊
• 活動召集人 ​管理註冊

考慮下列專案的替代方案：

• 需要自訂邏輯的複雜工作流程
• 企業與資料庫的整合
• 需要進階驗證或處理的Forms

• 不需要後端基礎結構 - Adobe代管提交端點
• 直接整合 ​與熱門試算表平台
• 自動將表單欄位中的資料對應 ​至試算表欄

• 即時資料擷取 — 提交內容會立即顯示在您的試算表中
• 結構化儲存空間 — 方便分析的結構化資料行
• 即時共同作業 — 多個團隊成員可以存取和分析資料

• 利用現有許可權 — 使用試算表平台的共用控制項
• Adobe代管安全性 — 具有企業級保護的安全提交端點
• 資料擁有權 — 您的資料會保留在您選擇的試算表平台上

• 為您的Edge Delivery Services專案設定的​ GitHub存放庫 ​已安裝最新的Adaptive Forms Block
• 存取核准 — 已新增至允許清單的存放庫

選擇其中一個支援的平台：

• Google工作表 — 具有工作表建立許可權的Google帳戶
• Microsoft OneDrive — 具有Excel Online存取權的Microsoft 365帳戶
• SharePoint — 使用清單/程式庫許可權存取SharePoint

• 編輯目標試算表的許可權
• 共用功能 ​以授與forms@adobe.com的存取權
• 針對您選擇的平台產生​ 連結 ​許可權

在設定任一方法之前，請確定您的AEM專案基礎已準備就緒：

1. 使用最新的Adaptive 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工作表或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
• 表單識別碼 （來自您發佈的表單）
• 存放庫資訊 （組織和網站名稱）

基底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}→您的實際表單識別碼
   • [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}→您的實際表單識別碼
• [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系統