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

調適型表單需要提交動作來處理使用者指定的資料。 提交動作會決定使用最適化表單提交之資料所執行的工作。 Adobe Experience Manager (AEM)包含 現成可用的提交動作 會示範您可使用使用者提交的資料執行的自訂工作。 例如，您可以執行工作，例如傳送電子郵件或儲存資料。

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

此流程圖會說明提交動作的工作流程，此動作會在您按一下 提交 最適化表單中的按鈕。 檔案附件元件中的檔案會上傳至伺服器，而表單資料會以上傳檔案的URL更新。 在使用者端內，資料會以JSON格式儲存。 使用者端傳送Ajax要求至內部servlet，它會處理您指定的資料並以XML格式傳回。 使用者端會使用動作欄位整理此資料。 它會透過「表單提交」動作將資料提交至最終servlet （引導提交servlet）。 然後，Servlet將控制項轉送給Submit動作。 提交動作可以將請求轉送至不同的Sling資源，或將瀏覽器重新導向至其他URL。

XML資料格式 xml-data-format

XML資料會使用傳送至servlet。 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 分別於表單轉譯時及表單提交前之欄位。 提交ActionScript post.jsp 接著，可使用請求引數存取這些欄位，並計算填寫表單所需的總時間。

檔案附件 file-attachments

提交動作也可以使用您使用「檔案附件」元件上傳的檔案附件。 提交動作指令碼可使用Sling存取這些檔案 RequestParameter API. 此 isFormField api的方法有助於識別請求引數是檔案或表單欄位。 您可以在「提交」動作中反複執行「要求」引數，以識別「檔案附件」引數。

下列範常式式碼會識別請求中的檔案附件。 接下來，它會使用 取得API. 最後，它會使用資料建立Document物件，並將其附加至清單。

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存放庫。 此外，CQ提供 郵件 可用於傳送電子郵件的API。 使用Mail API之前， 設定 經由系統主控台的Day CQ Mail服務。 您可以重複使用「儲存內容（已棄用）」動作，將資料儲存在存放庫中。 存放區內容（已棄用）動作可在CRX存放庫中的/libs/fd/af/components/guidessubmittype/store位置取得。