表單容器元件

利用核心元件表單容器元件，可建立簡單的提交表單。

使用狀況

表單容器元件可支援簡單的WCM表單，並使用巢狀結構來允許其他表單元件，讓您建立簡單的資訊提交表單和功能。

藉由使用 設定對話方塊 內容編輯者可以定義由表單提交所觸發的動作、應處理提交的URl，以及是否應觸發工作流程。 範本作者可以使用 設計對話方塊 定義允許的元件及其對映，類似於 範本編輯器中的標準版面容器.

注意

核心元件表單容器元件僅支援使用核心元件表單元件（按鈕、文字、隱藏等）。 使用 基礎元件 不支援核心元件表單容器中的表單元件（反之亦然）。

版本和相容性

表單容器元件的目前版本是v2，此版本隨2018年1月的核心元件2.0.0版的發佈引入，具體說明見本文。

下表詳細說明元件的所有支援版本、與元件版本相容的AEM版本，以及舊版檔案的連結。

元件版本 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v2 相容於
版本2.17.4 和先前的		 相容 相容
v1 相容 相容 相容

如需核心元件版本和發行版本的詳細資訊，請參閱檔案 核心元件版本.

範例元件輸出

若要體驗表單容器元件並檢視其設定選項範例以及HTML和JSON輸出，請造訪 元件資料庫.

技術細節

有關表單容器元件的最新技術檔案 可在GitHub上找到.

有關開發核心元件的進一步詳細資訊，請參閱 核心元件開發人員檔案.

設定對話方塊

設定對話方塊可讓內容作者定義在提交元件時所採取的動作。

根據選取的專案 動作型別，容器內的可用選項將會變更。 可用的動作型別為：

無論型別為何，都有 一般設定 適用於每個動作。

張貼表單資料

提交表單時，發佈表單資料動作型別會將提交的資料以JSON的格式傳遞給第三方以進行處理。

表單容器元件的「編輯」對話方塊中的「發佈表單資料」選項

  • 端點 — 將處理資料的完整HTTPS服務
  • 錯誤訊息 — 提交失敗時顯示的訊息
秘訣

系統管理員可以調整其他逾時選項，以處理轉送的表單資料。 如需詳細資訊，請參閱GitHub上的技術檔案。

郵件

提交表單時，郵件動作型別會傳送電子郵件給指定的收件者。

表單容器元件的「編輯」對話方塊中的郵件選項

  • 主旨 — 在提交表單時將傳送的電子郵件主題
  • 從 — 表單提交時將傳送之電子郵件的寄件者電子郵件地址
  • 至 — 在提交表單時將收到電子郵件的收件者地址
    • 點選或按一下 新增 按鈕以新增其他地址
    • 點選或按一下 刪除 按鈕以移除電子郵件地址
  • CC — 將接收在提交表單時傳送之電子郵件副本的收件者地址
    • 點選或按一下 新增 按鈕以新增其他地址
    • 點選或按一下 刪除 按鈕以移除電子郵件地址

存放區內容

提交表單時，表單內容會儲存在指定的存放庫位置。

在表單容器的編輯對話方塊中儲存內容選項

  • 內容路徑 — 儲存所提交內容的內容存放庫路徑
  • 檢視資料 — 點選或按一下以檢視以JSON格式儲存的提交資料
  • 開始工作流程 — 設定為在提交表單時啟動工作流程，並將儲存的內容作為裝載
注意

為了更輕鬆管理使用者資料並強制進行關注點分離，通常不建議將使用者產生的內容儲存在存放庫中。

請改用 張貼表單資料 將使用者內容傳遞至專用服務提供者的動作型別。

一般設定

無論選取的動作型別為何，您一律可以定義感謝頁面。

表單容器元件的「編輯」對話方塊中的一般選項

  • 感謝頁面 — 完成表單提交後，會將使用者重新導向至指定的頁面。
    • 使用「選取」對話方塊來選取AEM中的資源。
    • 如果感謝頁面不在AEM中，請指定絕對URL。 非絕對URL將會解釋為相對於AEM。
    • 留空可在提交後重新顯示表單。
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.
    • 如果保留為空白，系統會自動為您產生唯一ID，並可透過檢查結果頁面找到該ID。
    • 若指定ID，作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。

設計對話方塊

「設計」對話方塊可讓範本作者為容器定義允許的元件及其對應，類似於「設計」對話方塊的 範本編輯器中的標準版面容器.

樣式索引標籤

表單容器元件支援AEM 樣式系統.

本頁內容