文件AEM as a Cloud Service使用手冊

設定您的 Google 表單或 Microsoft Excel 檔案以開始接受資料

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 開發人員

建立並預覽表單後，就可以啟用對應的試算表以開始接收資料。您可以手動啟用試算表以接受資料，或使用管理 API 啟用試算表以接受資料。

文件型製作生態系統

手動啟用試算表以接受資料

若要啟用試算表以接受資料

  1. 開啟包含您表單的試算表並附加一個新工作表，將其重新命名為 incoming。

    note warning
    WARNING
    如果 incoming 工作表不存在，AEM 不會向試算表傳送任何資料。

  2. 在此工作表中，插入一個名為 "intake_form" 的表。選取與表單欄位名稱相符所需的欄數。然後，在工具列中前往「插入 > 表格」，並按一下「確定」。

  3. 將表格的名稱更改為 “intake_form”。在 Microsoft Excel 中，若要變更表格的名稱，請選取該表格並按一下「表格設計」。

  4. 接下來，新增表單欄位名稱作為表格標題。為了確保這些欄位完全相同，您可以從「共用預設」工作表中複製並貼上名稱。在「共用預設」工作表中，選取並複製「名稱」欄下所列的表單 ID (提交欄位除外)。

  5. 在「傳入」工作表中，選取「選擇性貼上 > 將列調換為欄」，以便將欄位 ID 複製為該新工作表中的欄標題。只保留需要擷取資料的欄位，其他可以忽略。

    shared-default 工作表 Name 欄的每個值 (不包含提交按鈕) 可以成為 incoming 工作表的標題。例如，請參考下方說明「聯絡我們」表單標題的圖片：

    聯絡我們表單的欄位

  6. 使用 AEM Sidekick 擴充功能預覽表單更新。您的工作表已準備好接受傳入的表單提交。

    note note
    NOTE
    即使以前已預覽過該工作表，在第一次建立 incoming 工作表後也必須再次預覽。

將欄位名稱新增至 incoming 工作表後，您的表單就可以接受提交了。您可以預覽表單並使用它向工作表提交資料。

只要工作表已設定可接受資料，您可以使用最適化表單區塊預覽表單或使用 POST 請求開始將資料傳送到工作表。

WARNING
「共用預設」工作表絕不會包含您不願意開放存取的任何個人識別資料或敏感資料。

使用 Admin API 讓試算表接受資料

您也可以向表單傳送 POST 請求，使其能夠接受資料並設定 incoming 工作表的標題。收到 POST 請求後，服務會分析請求內文並自動產生資料擷取所需的基本標題和工作表。

若要使用 Admin API 讓試算表接受資料：

  1. 開啟您建立的活頁簿並將預設工作表的名稱變更為 incoming。

    note warning
    WARNING
    如果 incoming 工作表不存在，AEM 不會向此活頁簿傳送任何資料。

  2. 在 Sidekick 中預覽工作表。

    note note
    NOTE
    即使以前已預覽過該工作表，在第一次建立 incoming 工作表後也必須再次預覽。

  3. 傳送 POST 請求以在 incoming 工作表中產生適當的標題，並將 shared-default 工作表新增至試算表 (如果尚未存在)。

    若要了解如何制訂用來設定工作表的 POST 請求格式，請參閱「Admin API 文件」。您可以查看下方提供的範例：

    請求

    code language-json 
    POST 'https://admin.hlx.page/form/{owner}/{repo}/{branch}/contact-us.json' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "Email": "john@wknd.com",
        "Name": "John",
        "Subject": "Regarding Product Inquiry",
        "Message": "I have some questions about your products.",
        "Phone": "123-456-7890",
        "Company": "Adobe Inc.",
        "Country": "United States",
        "PreferredContactMethod": "Email",
        "SubscribeToNewsletter": true
    }
}'

    回應

    code language-json 
    HTTP/2 200
content-type: application/json
x-invocation-id: 1b3bd30a-8cfb-4f85-a662-4b1f7cf367c5
cache-control: no-store, private, must-revalidate
accept-ranges: bytes
date: Sat, 10 Feb 2024 09:26:48 GMT
via: 1.1 varnish
x-served-by: cache-del21736-DEL
x-cache: MISS
x-cache-hits: 0
x-timer: S1707557205.094883,VS0,VE3799
strict-transport-security: max-age=31557600
content-length: 138

{"rowCount":2,"columns":["Email","Name","Subject","Message","Phone","Company","Country",      "PreferredContactMethod","SubscribeToNewsletter"]}%

    您可以使用 curl 或 Postman 等工具來執行此 POST 請求，如下所示：

    code language-json 
    curl -s -i -X POST 'https://admin.hlx.page/form/wkndforms/portal/main/contact-us.json' \
    --header 'Content-Type: application/json' \
    --data '{
        "data": {
            "Email": "john@wknd.com",
            "Name": "John",
            "Subject": "Regarding Product Inquiry",
            "Message": "I have some questions about your products.",
            "Phone": "123-456-7890",
            "Company": "Wknd Inc.",
            "Country": "United States",
            "PreferredContactMethod": "Email",
            "SubscribeToNewsletter": true
    }
}'

    上面提及的 POST 請求提供了範例資料，包括表單欄位及其個別的範例值。Admin 服務會使用此資料來設定表單。

    您的表單現在可以接受資料了。您也可以觀察到試算表有以下變化：

一旦啟用接受資料，工作表就會自動變更

將工作表設定為接收資料後，您會在試算表中觀察到以下變更：

名為「Slack」的工作表會新增至您的 Excel 活頁簿或 Google Sheet 中。在此工作表中，當系統擷取新資料至試算表中時，您可以為指定的 Slack 頻道設定自動通知。目前，AEM 僅支援向 AEM Engineering Slack 組織和 Adob​​e Enterprise 支援組織發送通知。

  1. 若要設定 Slack 通知，請輸入 Slack 工作區的「teamId」和「頻道名稱」或「ID」。您也可以向 Slack 機器人 (使用 debug 指令) 要求「teamId」和「頻道 ID」。最好使用「頻道 ID」而不是「頻道名稱」，因為這樣可以在頻道重新命名後繼續存在。

    note note
    NOTE
    舊的表單沒有「teamId」欄。「teamId」會包含在頻道欄中，並且以「#」或「/」分隔。

  2. 輸入您想要的任何標題，然後在欄位下輸入您想要在 Slack 通知中看到的欄位名稱。每個標題應以逗號分隔 (例如姓名、電子郵件)。

    note warning
    WARNING
    「共用預設」工作表絕不會包含您不願意開放存取的任何個人識別資料或敏感資料。

將資料傳送到您的工作表 send-data-to-your-sheet

將工作表設定為接收資料後，您可以使用最適化表單區塊預覽表單或使用 Admin API 開始傳送資料到工作表。

使用 Admin API 將資料傳送到您的工作表

您可以使用 hlx.page、hlx.live 或您的生產網域將 POST 請求直接發送到表單來傳送資料。

POST https://branch–repo–owner.hlx.(page|live)/email-form
POST https://my-domain.com/email-form
NOTE
URL 不應有 .json 副檔案名稱。您必須發佈 POST 操作的工作表才能在 .live 或生產網域上運作。

格式化表單資料

您可使用幾種不同法來格式化 POST 內文中的表單資料。您可以使用：

  • name:value 配對組陣列：

    code language-json 
    {
  "data": [
    { "name": "name", "value": "Clark Kent" },
    { "name": "email", "value": "superman@example.com" },
    { "name": "subject", "value": "Regarding Product Inquiry" },
    { "name": "message", "value": "I have some questions about your products." },
    { "name": "phone", "value": "123-456-7890" },
    { "name": "company", "value": "Example Inc." },
    { "name": "country", "value": "United States" },
    { "name": "preferred_contact_method", "value": "Email" },
    { "name": "newsletter_subscribe", "value": true }
  ]
}

    例如

    code language-json 
    curl -s -i -X POST 'https://main--portal--wkndforms.hlx.page/contact-us' \
    --header 'Content-Type: application/json' \
    --data '{
    "data": [
        { "name": "name", "value": "Clark Kent" },
        { "name": "email", "value": "superman@example.com" },
        { "name": "subject", "value": "Regarding Product Inquiry" },
        { "name": "message", "value": "I have some questions about your        products." },
        { "name": "phone", "value": "123-456-7890" },
        { "name": "company", "value": "Example Inc." },
        { "name": "country", "value": "United States" },
        { "name": "preferred_contact_method", "value": "Email" },
        { "name": "newsletter_subscribe", "value": true }
    ]
}'

  • 具備 key:value 配對組的物件：

    code language-json 
        {
      "data": {
        "name": "Jessica Jones",
        "email": "jj@example.com",
        "subject": "Regarding Product Inquiry",
        "message": "I have some questions about your products.",
        "phone": "123-456-7890",
        "company": "Example Inc.",
        "country": "United States",
        "preferred_contact_method": "Email",
        "newsletter_subscribe": true
      }
    }

    例如，

    code language-json 
    curl -s -i -X POST 'https://admin.hlx.page/form/wkndforms/portal/main/contact-us.json' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "Email": "khushwant@wknd.com",
        "Name": "khushwant",
        "Subject": "Regarding Product Inquiry",
        "Message": "I have some questions about your products.",
        "Phone": "123-456-7890",
        "Company": "Adobe Inc.",
        "Country": "United States",
        "PreferredContactMethod": "Email",
        "SubscribeToNewsletter": true
    }
}'

  • URL 編碼 (x-www-form-urlencoded) 內文 (content-type 標題設定為 application/x-www-form-urlencoded)

    code language-shell 
    'Email=kent%40wknd.com&Name=clark&Subject=Regarding+Product+Inquiry&Message=I   +have+some+questions+about+your+products.&Phone=123-456-7890&Company=Adobe+Inc.&   Country=United+States&PreferredContactMethod=Email&SubscribeToNewsletter=true'

    例如，

    code language-shell 
    curl -s -i -X POST \
  -d 'Email=kent%40wknd.com&Name=clark&Subject=Regarding+Product+Inquiry&   Message=I+have+some+questions+about+your+products.&Phone=123-456-7890& Company=Adobe+Inc.&Country=United+States&PreferredContactMethod=Email&   SubscribeToNewsletter=true' \
  https://main--portal--wkndforms.hlx.live/contact-us

接下來，您可以自訂感謝訊息。

另請參閱

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab