傳統上,網路表單會設定為同步提交。 在同步提交中,當使用者提交表單時,系統會將他們重新導向至確認頁面、感謝頁面,或在提交失敗的情況下重新導向至錯誤頁面。 不過,單頁應用程式等現代網頁體驗越來越熱門,這是因為網頁在背景執行使用者端與伺服器互動時,網頁會維持靜態。 您現在可以透過設定非同步提交,以最適化表單提供此體驗。
在非同步提交中,當使用者提交表單時,表單開發人員會插入個別體驗,例如重新導向到其他表單或網站的個別區段。 作者也可以外掛程式來個別服務,例如傳送資料至不同的資料存放區,或新增自訂分析引擎。在非同步提交的情況下,最適化表單的行為就像單頁應用程式,因為提交表單的資料在伺服器上驗證時,表單不會重新載入或其URL不會變更。
請閱讀下文,瞭解最適化表單中非同步提交的詳細資訊。
若要設定最適化表單的非同步提交:
在調適型表單製作模式中,選取「表單容器」物件並點選 以開啟其屬性。
在 提交 屬性區段,啟用 使用非同步提交.
在 提交時 區段,選取下列其中一個選項以在成功提交表單時執行。
點選 以儲存屬性。
AEM Forms為表單提交提供現成可用的成功和錯誤處理常式。 處理常式是根據伺服器回應執行的使用者端功能。 提交表單時,資料會傳輸到伺服器進行驗證,伺服器會傳回回應給使用者端,其中包含提交成功或錯誤事件的相關資訊。 此資訊會以引數形式傳遞至相關處理常式,以執行函式。
此外,表單作者和開發人員可以在表單層級撰寫規則來覆寫預設處理常式。 如需詳細資訊,請參閱 使用規則覆寫預設處理常式.
讓我們先檢閱伺服器回應,以瞭解成功和錯誤事件。
提交成功事件的伺服器回應結構如下:
{
contentType : "<xmlschema or jsonschema>",
data : "<dataXML or dataJson>" ,
thankYouOption : <page/message>,
thankYouContent : "<thank you page url/thank you message>"
}
成功提交表單時的伺服器回應包括:
成功處理常式會讀取伺服器回應,並據以重新導向至設定的頁面URL或顯示訊息。
提交錯誤事件的伺服器回應結構如下:
{
errorCausedBy : "<CAPTCHA_VALIDATION or SERVER_SIDE_VALIDATION>",
errors : [
{ "somExpression" : "<SOM Expression>",
"errorMessage" : "<Error Message>"
},
...
]
}
表單提交中發生錯誤時的伺服器回應包括:
錯誤處理常式會讀取伺服器回應,並在表單上顯示錯誤訊息。
表單開發人員和作者可以在表單層級在程式碼編輯器中編寫規則來覆寫預設處理常式。 成功和錯誤事件的伺服器回應會公開於表單層級,開發人員可透過此層級存取: $event.data
在規則中。
執行以下步驟,在程式碼編輯器中撰寫規則以處理成功和錯誤事件。