最適化表單提交動作 configuring-the-submit-action

套用至： ✔️最適化表單基礎元件。 ❌ 最適化表單核心元件。 Adobe建議使用核心元件將最適化Forms新增至AEM Sites頁面或建立獨立的最適化Forms。

當使用者按一下最適化表單上的​ 提交 ​按鈕時，就會觸發提交動作。 Formsas a Cloud Service提供下列立即可用的提交動作。

您也可以擴充預設提交動作以建立您自己的提交動作。

您可以在側邊欄的最適化表單容器屬性的​ 提交 ​區段中設定提交動作。

提交到 REST 端點 submit-to-rest-endpoint

使用「提交到 REST 端點」動作會將提交的資料發佈到 REST URL。該 URL 可以是內部伺服器 (呈現表單的伺服器) 或外部伺服器。

若要將資料發佈到內部伺服器，請提供資源的路徑。資料會發佈到資源的路徑。例如 /content/restEndPoint。對於此類發佈要求，會使用提交要求的驗證資訊。

若要將資料發佈到外部伺服器，請提供 URL。URL 的格式是：https://host:port/path_to_rest_end_point。請確保設定以匿名方式處理 POST 要求的路徑。

在上面的範例中，在 textbox 輸入的資訊是使用 param1 參數來擷取。使用 param1 發佈所擷取之資料的語法是：

String data=request.getParameter("param1");

同樣地，用於發佈 XML 資料和附件的參數是 dataXml 和 attachments。

例如，您會在指令碼中使用這兩個參數將資料剖析到 REST 端點。您會使用以下語法來儲存和剖析資料：

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

在這個範例中，data 會儲存 XML 資料，而 att 會儲存附件資料。

「提交到 REST 端點」提交動作會將表單中填寫的資料做為 HTTP GET 要求的一部分，提交到已設定的確認頁面。您可以新增要求的欄位名稱。要求的格式為：

{fieldName}={request parameter name}

如下圖所示，param1 和 param2 是做為參數傳遞，其值是從 textbox 和 numericbox 欄位複製做為下一個動作。

您也可以「啟用 POST 要求」並提供用於發佈要求的 URL。若要將資料提交到託管表單的 AEM 伺服器，請使用對應至 AEM 伺服器根路徑的相對路徑。例如 /content/forms/af/SampleForm.html。若要將資料提交到任何其他伺服器，請使用絕對路徑。

寄送電子郵件 send-email

您可以使用​ 傳送電子郵件 ​提交動作，在成功提交表單時傳送電子郵件給一或多個收件者。 產生的電子郵件可以包含預先定義的格式表單資料。 例如，在以下範本中，客戶名稱、送貨地址、州名稱和郵遞區號會從提交的表單資料中擷取。

```

${customer_Name} 您好：

以下設定為您的預設送貨地址：
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

謹此，
WKND

```

您也可以在電子郵件中加入附件和記錄檔案(DoR)。 若要啟用​ 附加記錄檔案 ​選項，請設定最適化表單以產生記錄檔案(DoR)。 您可以啟用從最適化表單屬性產生記錄檔案的選項。

使用表單資料模型(FDM)提交 submit-using-form-data-model

使用表單資料模型​ 提交動作的 ​提交會將表單資料模型(FDM)中指定資料模型物件的已提交最適化表單資料寫入其資料來源。 設定提交動作時，您可以選擇要將其提交資料寫回其資料來源的資料模型物件。

此外，您可以使用表單資料模型(FDM)和記錄檔案(DoR)將表單附件提交至資料來源。 如需表單資料模型(FDM)的相關資訊，請參閱AEM Forms 資料整合。

叫用 AEM 工作流程 invoke-an-aem-workflow

「叫用 AEM 工作流程」提交動作會將最適化表單與 AEM 工作流程建立關聯。提交表單後，相關聯的工作流程就會在作者執行個體上自動開始。您可以將資料檔案、附件和記錄文件儲存到工作流程的承載位置，或儲存到變數。如果工作流程標記為外部資料儲存空間，且設定為外部資料儲存空間，則只有變數選項可使用。您可以從可用於工作流程模型的變數清單中選取。如果工作流程是在後續階段標記為外部資料儲存空間，而不是在建立工作流程時標記，則請確保已經具備所需的變數設定。

提交動作會將以下內容放置於工作流程的承載位置，或放置到變數 (如果工作流程標記為外部資料儲存空間)：

使用「叫用 AEM 工作流程」提交動作為 AEM DS 設定服務 ​設定以下內容之前：

提交到 SharePoint submit-to-sharedrive

「提交到 SharePoint」提交動作會將最適化表單與 Microsoft® SharePoint 儲存空間建立連結。您可以將表單資料檔案、附件或記錄檔案提交至連線的Microsoft® Sharepoint儲存體。

使用提交至SharePoint，您可以：

將最適化表單連線至SharePoint檔案庫 connect-af-sharepoint-doc-library

若要以最適化表單使用​ 提交至SharePoint檔案庫 ​提交動作：

建立SharePoint檔案庫組態 create-sharepoint-configuration

若要將AEM Forms連線至您的Microsoft® Sharepoint檔案庫儲存空間：

現在，您可以使用此SharePoint Sites設定，在最適化表單中執行提交動作。

在最適化表單中使用SharePoint檔案庫設定 use-sharepoint-configuartion-in-af

您可以使用在最適化表單中建立的SharePoint檔案庫組態，將資料或產生的記錄檔案儲存在SharePoint資料夾中。 執行以下步驟，在最適化表單中使用SharePoint檔案庫儲存設定，如下所示：

當您提交表單時，資料會儲存在指定的Microsoft® Sharepoint檔案庫儲存空間中。
儲存資料的資料夾結構是 /folder_name/form_name/year/month/date/submission_id/data。

將最適化表單連線至Microsoft® SharePoint清單 connect-af-sharepoint-list

若要在最適化表單中使用提交至SharePoint清單提交動作：

建立SharePoint清單設定 create-sharepoint-list-configuration

若要將AEM Forms連線至您的Microsoft®Sharepoint清單：

在最適化表單中使用表單資料模型提交(FDM) use-submit-using-fdm

您可以在調適型表單中使用已建立的SharePoint清單設定，以在SharePoint清單中儲存資料或產生的記錄檔案。 執行以下步驟，在最適化表單中使用SharePoint清單儲存體設定：

提交表單時，資料會儲存在指定的Microsoft® Sharepoint清單儲存空間中。

提交到 OneDrive submit-to-onedrive

「提交到 OneDrive」提交動作會將最適化表單連結到 Microsoft® OneDrive。您可以將表單資料、檔案、附件或記錄文件提交到連結的 Microsoft® OneDrive 儲存空間。若要在最適化表單中使用「提交到 OneDrive」提交動作：

建立 OneDrive 設定 create-onedrice-configuration

若要將 AEM Forms 連結到您的 Microsoft® OneDrive 儲存空間：

現在，您可以使用此 OneDrive 儲存空間設定，在最適化表單中使用該提交動作。

在最適化表單中使用 OneDrive 設定 use-onedrive-configuartion-in-af

您可以在最適化表單中使用建立的 OneDrive 儲存空間設定，將資料或產生的記錄文件儲存在 OneDrive 資料夾中。執行以下步驟，即可在最適化表單中使用 OneDrive 儲存空間設定：

您提交表單時，資料將儲存在指定的 Microsoft® OneDrive 儲存空間。
儲存資料的資料夾結構是 /folder_name/form_name/year/month/date/submission_id/data。

提交到 Azure Blob 儲存體 submit-to-azure-blob-storage

「提交到 Azure Blob 儲存體」提交動作會將最適化表單連結到 Microsoft® Azure 入口網站。您可以將表單資料、檔案、附件或記錄文件提交到連結的 Azure 儲存體容器。若要使用對 Azure Blob 儲存體的提交動作：

建立 Azure Blob 儲存體容器 create-azure-configuration

若要將 AEM Forms 連結到 Azure 儲存體容器：

現在，您可以使用此 Azure 儲存體容器設定，在最適化表單中使用該提交動作。

在最適化表單中使用 Azure 儲存體設定 use-azure-storage-configuartion-in-af

您可以在最適化表單中使用建立的 Azure 儲存體器設定，將資料或產生的記錄文件儲存在 Azure 儲存體容器中。執行以下步驟，即可在最適化表單中使用 Azure 儲存體容器設定：

提交表單時，資料會儲存在指定的 Azure 儲存體容器設定中。
儲存資料的資料夾結構是 /configuration_container/form_name/year/month/date/submission_id/data。

若要設定值，請使用 AEM SDK 產生 OSGi 設定，並將設定部署至您的 Cloud Service 執行個體。

提交至 Power Automate microsoft-power-automate

您可以設定最適化表單，在提交時執行 Microsoft® Power Automate Cloud Flow。設定的最適化表單會將擷取的資料、附件和記錄文件傳送到 Power Automate Cloud Flow 進行處理。那有助於建置自訂資料擷取體驗，同時利用 Microsoft® Power Automate 的強大功能，根據擷取的資料建置商業邏輯，並將客戶工作流程自動化。以下是整合最適化表單與 Microsoft® Power Automate 後，可以執行的部分操作範例：

最適化Forms編輯器提供​ 叫用Microsoft®Power Automate流程 ​提交動作，以將最適化表單資料、附件和記錄檔案傳送至Power Automate雲端流程。 若要使用提交動作將擷取的資料傳送到 Microsoft® Power Automate，請使用 Microsoft® Power Automate 連線您的 Forms as a Cloud Service 執行個體

在設定成功之後，使用叫用 Microsoft® Power Automate 流程提交動作，將資料傳送到 Power Automate Flow。

提交至 Workfront Fusion workfront-fusion

您可以設定最適化表單，在提交時提交資料給Workfront Fusion。 Workfront Fusion允許流程自動化，以便使用者可以專注於新任務，而不是一遍又一遍地重複相同的任務。 它可自動化簡單和複雜的工作，節省時間並確保一致的流程執行。

最適化Forms編輯器提供​ 叫用Workfront Fusion案例 ​提交動作，以將最適化Forms資料或附件傳送至Workfront Fusion案例。 若要使用提交動作將擷取的資料傳送至Workfront Fusion案例，請參閱將最適化表單提交至Adobe Workfront Fusion。

使用同步或異步提交 use-synchronous-or-asynchronous-submission

提交動作可以使用同步或異步提交。

同步提交：傳統上，Web 表單設定為同步提交。在同步提交中，使用者提交表單時，系統會將其被重新導向至確認頁面、感謝頁面；如果提交失敗，則會重新導向至錯誤頁面。您可以選擇「使用異步提交」選項，將使用者重新導向至網頁，或在提交時顯示訊息。

異步提交：單一頁面應用程式等現代 Web 體驗越來越受歡迎，其中網頁會保持靜態，而用戶端-伺服器的互動則是在背景中執行。透過設定異步提交，您現在就可以對最適化表單提供此體驗了。

最適化表單中的伺服器端重新驗證 server-side-revalidation-in-adaptive-form

一般而言，在任何線上資料擷取系統中，開發人員都會在用戶端放置一些 JavaScript 驗證，以強制執行一些業務規則。但在現代的瀏覽器中，一般使用者可以略過那些驗證，並使用各種技巧 (例如 Web Browser DevTools Console) 手動進行提交。此類技術對於最適化表單也有效。表單開發人員可以建立各種驗證邏輯，但技術上而言，一般使用者可以略過那些驗證邏輯並提交無效的資料給伺服器。無效的資料會破壞表單作者強制執行的業務規則。

伺服器端重新驗證功能也能夠執行最適化表單作者在伺服器上設計最適化表單時提供的驗證能力。這樣可以避免對提交的資料造成任何可能的危害，以及在表單驗證方面違反業務規則。

伺服器上會進行哪些驗證？ what-to-validate-on-server-br

會在伺服器上對最適化表單重新執行的所有立即可用 (OOTB) 欄位驗證包括：

啟用伺服器端驗證 enabling-server-side-validation-br

使用在側邊欄「最適化表單容器」下方的「在伺服器上重新驗證」，即可對目前表單啟用或停用伺服器端驗證。

啟用伺服器端驗證

如果一般使用者略過那些驗證並提交表單，伺服器將再次執行驗證。如果伺服器端驗證失敗，就會停止提交交易。使用者會再次看到原始表單。 擷取的資料和提交的資料會做為錯誤呈現給使用者。

支援驗證運算式中的自訂函數 supporting-custom-functions-in-validation-expressions-br

有時候，如果有​ 複雜的驗證規則，則確切的驗證指令碼會駐留在自訂函數中，且作者會從欄位驗證運算式中呼叫這些自訂函數。若要在執行伺服器端驗證時公開和提供此自訂函數程式庫，表單作者可以在「最適化表單容器」屬性的「基礎」標籤下方，設定 AEM 用戶端程式庫的名稱，如以下所示。

支援驗證運算式中的自訂函數

作者可以根據最適化表單來設定自訂 JavaScript 程式庫。程式庫中只會保留可重複使用的函數，這些函數與 jquery 和 underscore.js 第三方程式庫有相依性。

提交動作的錯誤處理 error-handling-on-submit-action

為了 AEM 安全性和強化準則，請設定自訂錯誤頁面，例如 400.jsp、404.jsp 和 500.jsp。提交表單時，如果出現 400、404 或 500 錯誤，就會呼叫這些處理常式。在發佈節點上觸發這些錯誤代碼時，也會呼叫處理常式。您也可以為其他 HTTP 錯誤代碼建立 JSP 頁面。

當您將包含XML或JSON資料投訴的表單資料模型(FDM)或結構描述型調適型表單預填至資料不包含<afData>、<afBoundData>和</afUnboundData>標籤的結構描述時，調適型表單未限制欄位的資料會遺失。 結構描述可以是XML結構描述、JSON結構描述或表單資料模型(FDM)。 未繫結欄位是最適化表單欄位，但沒有 bindref 屬性。