設定提交動作 configuring-the-submit-action

Adobe 建議使用新式且可擴充的資料擷取核心元件，用來建立新的最適化表單或將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步，可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

提交動作簡介 introduction-to-submit-actions

當使用者按一下最適化表單上的提交按鈕時，就會觸發提交動作。 您可以在最適化表單上設定提交動作。 調適型表單提供一些立即可用的提交動作。 您可以複製並擴充預設提交動作，以建立您自己的提交動作。 不過，您可以根據自己的需求，編寫並註冊自己的提交動作，以處理提交表單中的資料。 提交動作可以使用同步或非同步提交。

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

設定提交動作

最適化表單可用的預設提交動作如下：

您可以撰寫最適化表單的自訂提交動作，以符合您的使用案例。 如需詳細資訊，請參閱撰寫最適化表單的自訂提交動作。

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

提交至REST端點 ​提交選項會將表單中填入的資料傳遞至已設定的確認頁面，作為HTTPGET要求的一部分。 您可以新增要求的欄位名稱。要求的格式為：

{fieldName}={request parameter name}

如下圖所示，param1和param2會以引數形式傳遞，其值複製自下一個動作的​ 文字方塊 ​和​ 數值方塊 ​欄位。

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

設定Rest端點提交動作

Post將資料提交至資源或外部rest端點  post-submitted-data-to-a-resource-or-external-rest-end-point-nbsp

使用「提交到 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 會儲存附件資料。

寄送電子郵件 send-email

傳送電子郵件 ​提交動作會在成功提交表單時，傳送電子郵件給一或多個收件者。 產生的電子郵件可以包含預先定義的格式表單資料。

透過電子郵件傳送PDF send-pdf-via-email

透過電子郵件傳送PDF ​提交動作會在成功提交表單時，傳送內含表單資料PDF的電子郵件給一或多個收件者。

叫用Forms Workflow invoke-a-forms-workflow

提交至Forms Workflow ​提交選項會將資料xml和檔案附件（如果有的話）傳送至現有的AdobeLiveCycle或JEE程式上的AEM Forms。

如需有關如何設定提交至Forms Workflow提交動作的資訊，請參閱使用表單工作流程提交及處理您的表單資料。

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

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

此外，您可以使用表單資料模型和記錄檔案(DoR)將表單附件提交至資料來源。

如需表單資料模型的相關資訊，請參閱AEM Forms資料整合。

Forms Portal提交動作 forms-portal-submit-action

Forms入口網站提交動作 ​選項可透過AEM Forms入口網站提供表單資料。

如需Forms入口網站與提交動作的詳細資訊，請參閱草稿與提交元件。

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

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

在使用​ 叫用AEM工作流程 ​提交動作之前，設定Experience ManagerDS設定。 如需有關建立AEM工作流程的資訊，請參閱OSGi上以表單為中心的工作流程。

提交動作會將下列專案置於工作流程的裝載位置。 但請注意，如果工作流程模型標示為外部資料儲存，則只會顯示「變數」選項，而不會顯示「裝載」選項。

提交至 Power Automate microsoft-power-automate

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

最適化表單編輯器提供​ 叫用 Microsoft® Power Automate 流程 ​提交動作，將最適化表單資料、附件和記錄文件發送到 Power Automate Cloud Flow。若要使用「提交」動作將擷取的資料傳送至Microsoft® Power Automate，將您的AEM Forms執行個體連線至Microsoft® Power Automate

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

提交至Microsoft® SharePoint清單 submit-to-sharedrive

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

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

若要將最適化表單連線至Microsoft® SharePoint清單：

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

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

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

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

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

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

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

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

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

在伺服器上重新執行的所有適用性表單現成可用的欄位驗證包括：

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

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

啟用伺服器端驗證

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

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

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

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

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

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

在Experience Manager安全性和強化准則中，請設定自訂錯誤頁面，例如404.jsp和500.jsp。 提交表單時出現404或500錯誤時，會呼叫這些處理常式。 在Publish節點上觸發這些錯誤碼時，也會呼叫處理常式。

如需詳細資訊，請參閱自訂錯誤處理常式顯示的頁面。