為REST端點提交動作設定最適化表單

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

建立對象：

使用者
開發人員

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

AEM as a Cloud Service提供多種立即可用的提交動作，用於處理表單提交。您可以在最適化表單提交動作文章中進一步瞭解這些選項。

優點

為Adaptive Forms設定 提交至REST端點 提交動作的部分優點包括：

透過RESTful API，可緊密整合表單資料與外部系統和服務。
它提供處理最適化Forms資料提交作業的彈性，支援動態和複雜的資料結構。
它支援將表單欄位動態對應到REST端點URL中的引數，允許適應性和可自訂的資料提交。

設定提交至REST端點提交動作 steps-to-configure-submit-to-restendpoint-submit-action

若要設定提交動作：

開啟內容瀏覽器，然後選取最適化表單的「指引容器」元件。
按一下「指引容器」屬性圖示。此時會開啟「最適化表單容器」對話框。
按一下「提交」標籤。
從 提交動作 下拉式清單中，選取 提交至Rest端點。
提交至Rest端點的

若要將資料發佈到內部伺服器，請提供資源的路徑。資料會發佈到資源的路徑。例如 /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。若要將資料提交到任何其他伺服器，請使用絕對路徑。
按一下 「完成」。