最適化表單提交動作
套用至： ✔️最適化表單基礎元件。 ❌ 最適化表單核心元件。 Adobe建議使用核心元件來將最適化Forms新增至AEM Sites頁面或建立獨立的最適化Forms。
當使用者按一下最適化表單上的 提交 按鈕時，就會觸發提交動作。 Forms as a Cloud Service提供下列立即可用的提交動作。
您也可以擴充預設提交動作以建立您自己的提交動作。
您可以在側邊欄的最適化表單容器屬性的 提交 區段中設定提交動作。
提交到 REST 端點
使用「提交到 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。若要將資料提交到任何其他伺服器，請使用絕對路徑。
注意寄送電子郵件
您可以使用 傳送電子郵件 提交動作，在成功提交表單時傳送電子郵件給一或多個收件者。 產生的電子郵件可以包含預先定義的格式表單資料。 例如，在以下範本中，客戶名稱、送貨地址、州名稱和郵遞區號會從提交的表單資料中擷取。
```
${customer_Name} 您好：
以下設定為您的預設送貨地址：
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}
謹此，
WKND
```
- 所有表單欄位都必須有不同的元素名稱，即使這些欄位位於調適型表單的不同面板上亦然。
- AEM as a Cloud Service需要加密傳出郵件。 依預設，會停用傳出電子郵件。 若要啟用它，請將支援票證提交給要求存取權。
您也可以在電子郵件中加入附件和記錄檔案(DoR)。 若要啟用 附加記錄檔案 選項，請設定最適化表單以產生記錄檔案(DoR)。 您可以啟用從最適化表單屬性產生記錄檔案的選項。
使用表單資料模型(FDM)提交
使用表單資料模型 提交動作的 提交會將表單資料模型(FDM)中指定資料模型物件的已提交最適化表單資料寫入其資料來源。 設定提交動作時，您可以選擇要將其提交資料寫回其資料來源的資料模型物件。
此外，您可以使用表單資料模型(FDM)和記錄檔案(DoR)將表單附件提交至資料來源。 如需表單資料模型(FDM)的相關資訊，請參閱AEM Forms 資料整合。
叫用 AEM 工作流程
「叫用 AEM 工作流程」提交動作會將最適化表單與 AEM 工作流程建立關聯。提交表單後，相關聯的工作流程就會在作者執行個體上自動開始。您可以將資料檔案、附件和記錄文件儲存到工作流程的承載位置，或儲存到變數。如果工作流程標記為外部資料儲存空間，且設定為外部資料儲存空間，則只有變數選項可使用。您可以從可用於工作流程模型的變數清單中選取。如果工作流程是在後續階段標記為外部資料儲存空間，而不是在建立工作流程時標記，則請確保已經具備所需的變數設定。
提交動作會將以下內容放置於工作流程的承載位置，或放置到變數 (如果工作流程標記為外部資料儲存空間)：
-
資料檔案：包含提交給最適化表單的資料。您可以使用「資料檔案路徑」選項來指定相對於承載的檔案名稱和檔案路徑。例如，
/addresschange/data.xml路徑會建立一個名為addresschange的資料夾，並將其置於相對於承載的位置。您也可以僅指定data.xml，僅發送提交的資料而不建立資料夾階層。如果工作流程標記為外部資料儲存空間，請使用變數選項並從工作流程模型可用的變數清單中選取變數。 -
附件：您可以使用「附件路徑」選項，指定用來儲存上傳到最適化表單之附件的資料夾名稱。該資料夾會建立在相對於承載的位置。如果工作流程標記為外部資料儲存空間，請使用變數選項，並從工作流程模型可用的變數清單中選取變數。
-
記錄文件：包含為最適化表單產生的記錄文件。您可以使用「記錄文件路徑」選項指定記錄文件檔案的名稱，以及相對於承載的檔案路徑。例如，
/addresschange/DoR.pdf路徑會在相對於承載的位置建立一個名為addresschange的資料夾，並將DoR.pdf放置在相對於承載的位置。您也可以指定DoR.pdf僅儲存記錄文件而不建立資料夾階層。如果工作流程標記為外部資料儲存空間，請使用變數選項，並從工作流程模型可用的變數清單中選取變數。
使用「叫用 AEM 工作流程」提交動作為 AEM DS 設定服務 設定以下內容之前：
-
處理伺服器 URL：處理伺服器是觸發表單或 AEM 工作流程所在的伺服器。這可以與 AEM 作者執行個體或另一個伺服器的 URL 相同。
-
處理伺服器使用者名稱：工作流程使用者的使用者名稱
-
處理伺服器密碼：工作流程使用者的密碼
提交到 SharePoint
「提交到 SharePoint」提交動作會將最適化表單與 Microsoft® SharePoint 儲存空間建立連結。您可以將表單資料檔案、附件或記錄檔案提交至連線的Microsoft® Sharepoint儲存體。
使用提交至SharePoint，您可以：
將最適化表單連線至SharePoint檔案庫
若要以最適化表單使用 提交至SharePoint檔案庫 提交動作：
- 建立SharePoint檔案庫組態：它會將AEM Forms連線至您的Microsoft® Sharepoint儲存體。
- 使用最適化表單中的「提交到 SharePoint」提交動作：會將您的最適化表單連結到已設定的 Microsoft® SharePoint。
建立SharePoint檔案庫組態
若要將AEM Forms連線至您的Microsoft® Sharepoint檔案庫儲存空間：
-
前往您的 AEM Forms作者 執行個體> 工具 > 雲端服務 > Microsoft® SharePoint。
-
選取 Microsoft® SharePoint 後，系統會將您重新導向至 SharePoint瀏覽器。
-
選取一個 設定容器。設定會儲存在選取的設定容器中。
-
從下拉式清單中按一下 建立 > SharePoint檔案庫。 此時會顯示 SharePoint 設定精靈。
-
指定「標題」、「用戶端 ID」、「用戶端密碼」和「OAuth URL」。如需有關如何擷取 OAuth URL 之用戶端 ID、用戶端密碼、租用戶 ID 的資訊，請參閱 Microsoft® 文件。
- 您可以從 Microsoft® Azure 入口網站擷取應用程式的
Client ID和Client Secret。 - 在 Microsoft® Azure 入口網站中，將重新導向 URI 新增為
https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html。以作者執行個體的 URL 取代[author-instance]。 - 新增 API 權限
offline_access和Sites.Manage.All以提供讀取/寫入權限。 - 使用 OAuth URL：
https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize。從 Microsoft® Azure 入口網站，以應用程式的tenant-id取代<tenant-id>。
注意用戶端密碼 欄位為必填或選用，取決於您的 Azure Active Directory 應用程式設定。如果您的應用程式設定為使用用戶端密碼，就必須提供用戶端密碼。 - 您可以從 Microsoft® Azure 入口網站擷取應用程式的
-
按一下「連結」。連結成功後，就會顯示
Connection Successful訊息。 -
現在選取 SharePoint網站 > 檔案庫 > SharePoint資料夾，以儲存資料。
注意- 依預設，
forms-ootb-storage-adaptive-forms-submission存在於選取的SharePoint網站。 - 按一下 建立資料夾，將資料夾建立為
forms-ootb-storage-adaptive-forms-submission(如果尚未存在於所選SharePoint網站的Documents資料庫中)。
- 依預設，
現在，您可以使用此SharePoint Sites設定，在最適化表單中執行提交動作。
