撰寫最適化表單的自訂提交動作 writing-custom-submit-action-for-adaptive-forms

適用性表單需要提交動作，才能處理使用者指定的資料。 「提交」動作會決定您使用最適化表單提交之資料所執行的任務。 Adobe Experience Manager(AEM)包含 OOTB提交操作 展示可使用使用者提交的資料執行的自訂工作。 例如，您可以執行工作，例如傳送電子郵件或儲存資料。

「提交」動作的工作流程 workflow-for-a-submit-action

流程圖描述了按一下 提交 按鈕。 檔案附件元件中的檔案會上傳到伺服器，而表單資料會以上傳檔案的URL更新。 在用戶端內，資料會以JSON格式儲存。 用戶端會傳送Ajax要求至內部servlet，以按摩您指定的資料，並以XML格式傳回。 用戶端會使用動作欄位來整理此資料。 它通過「表單提交」操作將資料提交到最終的Servlet（指南提交Servlet）。 然後，Servlet將控制項轉發到Submit操作。 Submit動作可將要求轉送至其他Sling資源，或將瀏覽器重新導向至其他URL。

XML資料格式 xml-data-format

XML資料會使用 jcr:data 要求參數。 提交動作可存取參數以處理資料。 以下代碼描述XML資料的格式。 綁定到表單模型的欄位將顯示在 afBoundData 區段。 未綁定的欄位顯示在 afUnoundData 區段。 如需 data.xml 檔案，請參閱 預先填入最適化表單欄位的簡介.

<?xml ?>
<afData>
<afUnboundData>
<data>
<field1>value</field2>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
<repeatablePanel>
    <field2>value</field2>
</repeatablePanel>
</data>
</afUnboundData>
<afBoundData>
<!-- xml corresponding to the Form Model /XML Schema -->
</afBoundData>
</afData>

動作欄位 action-fields

「提交」動作可新增隱藏的輸入欄位(使用HTML 輸入 標籤)轉換為轉譯的表單HTML。 這些隱藏欄位可包含處理表單提交時所需的值。 提交表單時，這些欄位值會以請求參數的形式發回，「提交」動作可在提交處理期間使用。 輸入欄位稱為動作欄位。

例如，如果「提交」動作也擷取填寫表單所花的時間，則可新增隱藏的輸入欄位 startTime 和 endTime.

指令碼可提供 startTime 和 endTime 表單轉譯時和表單提交前的欄位。 提交操作指令碼 post.jsp 之後，您就可以使用請求參數存取這些欄位，並計算填寫表單所需的總時間。

檔案附件 file-attachments

提交操作也可以使用使用檔案附件元件上傳的檔案附件。 提交動作指令碼可使用Sling存取這些檔案 RequestParameter API. 此 isFormField API的方法有助於識別要求參數是檔案還是表單欄位。 您可以反覆查看提交動作中的請求參數，以識別檔案附件參數。

下列范常式式碼可識別請求中的檔案附件。 接下來，會使用 取得API. 最後，它使用資料建立文檔對象並將其附加到清單中。

RequestParameterMap requestParameterMap = slingRequest.getRequestParameterMap();
for (Map.Entry<String, RequestParameter[]> param : requestParameterMap.entrySet()) {
    RequestParameter rpm = param.getValue()[0];
    if(!rpm.isFormField()) {
        fileAttachments.add(new Document(rpm.get()));
    }
}

前進路徑和重新導向URL forward-path-and-redirect-url

執行所需操作後，提交servlet將請求轉發到轉發路徑。 動作會使用setForwardPath API來設定指南提交Servlet中的前進路徑。

如果動作未提供轉送路徑，則提交servlet會使用重新導向URL來重新導向瀏覽器。 作者會使用「適用性表單編輯」對話方塊中的「感謝頁面」設定來設定重新導向URL。 您也可以透過提交動作或指南提交servlet中的setRedirectUrl API來設定重新導向URL。 您也可以使用指南提交servlet中的setRedirectParameters API來設定傳送至重新導向URL的要求參數。

提交動作 submit-action

提交動作是sling:Folder，包含下列項目：

建立自訂提交動作 creating-a-custom-submit-action

執行下列步驟以建立自訂的「提交」動作，將資料儲存在CRX存放庫，然後傳送電子郵件給您。 適用性表單包含將資料儲存在CRX存放庫的OOTB提交動作存放區內容（已淘汰）。 此外，CQ也提供 郵件 可用於傳送電子郵件的API。 使用郵件API之前， 設定透過系統主控台提供Day CQ Mail服務。 您可以重複使用「儲存內容（已廢止）」動作，將資料儲存在存放庫中。 「儲存內容（已廢止）」動作可在CRX存放庫的/libs/fd/af/components/guidesubmittype/store位置取得。