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

使用​ 提交至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

若要設定提交動作:

  1. 開啟內容瀏覽器,然後選取最適化表單的「指引容器」元件。

  2. 按一下「指引容器」屬性 指引屬性 圖示。此時會開啟「最適化表單容器」對話框。

  3. 按一下「提交」標籤。

  4. 從​ 提交動作 ​下拉式清單中,選取​ 提交至Rest端點
    提交至Rest端點的 動作設定

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

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

    做為「感謝頁面」參數傳遞之欄位值的對應

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

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

    同樣地,用於發佈 XML 資料和附件的參數是 dataXmlattachments

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

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

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

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

    {fieldName}={request parameter name}

    如下圖所示,param1param2 是做為參數傳遞,其值是從 textboxnumericbox 欄位複製做為下一個動作。

    設定 REST 端點提交動作

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

  5. 按一下​ 「完成」

最佳做法

  • 將資料張貼至外部伺服器時,請確定URL是安全的,並設定以匿名方式處理POST請求的路徑,以保護敏感資訊。
  • 若要將欄位做為 REST URL 的參數傳遞,所有欄位都必須具有不同的元素名稱,即使這些欄位位於不同面板上也是如此。

相關文章

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab