傳統上,網路表單的設定是同步提交。 在同步提交中,當使用者提交表單時,系統會將他們重新導向至確認頁面、感謝頁面,或在提交失敗時,重新導向至錯誤頁面。 不過,單頁應用程式等現代化網頁體驗正日益普及,當用戶端與伺服器互動於背景時,網頁會維持靜態。 您可以設定非同步提交,以透過適用性Forms提供此體驗。
在非同步提交中,當使用者提交表單時,表單開發人員會插入不同的體驗,例如重新導向至網站的其他表單或個別區段。 作者也可以外掛個別服務,例如傳送資料至不同的資料存放區,或新增自訂分析引擎。 非同步提交時,適用性表單的行為類似於單頁應用程式,因為表單不會重新載入,或提交的表單資料在伺服器上通過驗證時,其URL不會變更。
如需Adaptive Forms中非同步提交的詳細資訊,請參閱。
若要設定適用性表單的非同步提交:
在適用性表單製作模式中,選取「表單容器」物件並點選 來開啟其屬性。
在 提交 屬性部分,啟用 使用非同步提交.
在 提交時 部分,選擇以下選項之一,以在成功提交表單時執行。
點選 以儲存屬性。
Experience Manager Forms 為表單提交提供現成可用的成功和錯誤處理常式。 處理常式是根據伺服器回應執行的用戶端函式。 提交表單時,將資料發送到伺服器進行驗證,伺服器會向客戶端返回一個響應,其中包含有關提交成功或錯誤事件的資訊。 資訊會以參數形式傳遞至相關處理常式,以執行函式。
此外,表單作者和開發人員可以在表單層級撰寫規則,以覆寫預設處理常式。 如需詳細資訊,請參閱 使用規則覆蓋預設處理程式.
讓我們先檢閱伺服器對成功和錯誤事件的回應。
提交成功事件的伺服器回應結構如下:
{oneOf: [
{ properties : {
contentType : {"type" : "string", "enum" : ["xmlschema", "jsonschema"]},
data : {type : "string", description : "Form data in XML or JSON format"},
thankYouOption : {type : "string"}
}},
properties : {
contentType : {"type" : "string", "enum" : ["xmlschema", "jsonschema"]},
data : {type : "string", description : "Form data in XML or JSON format"},
thankYouContent: {type: "string"}
}
]
}
成功提交表單時的伺服器回應包括:
成功處理常式會讀取伺服器回應,並因此重新導向至設定的頁面URL或顯示訊息。
提交錯誤事件的伺服器回應結構如下:
{
errorCausedBy : "<CAPTCHA_VALIDATION or SERVER_SIDE_VALIDATION>",
errors : [
{ "somExpression" : "<SOM Expression>",
"errorMessage" : "<Error Message>"
},
...
]
}
提交表單時發生錯誤時的伺服器回應包括:
錯誤處理程式讀取伺服器回應,並因此在表單上顯示錯誤訊息。
表單開發人員和作者可以在表單層級撰寫規則,以覆寫預設處理常式。 成功和錯誤事件的伺服器回應會在表單層級公開,開發人員可使用 $event.data
在規則中。
執行下列步驟來編寫規則以處理成功和錯誤事件。
在製作模式中開啟「最適化表單」,選取任何表單物件,然後點選 來開啟規則編輯器。
選擇 表單 在「表單對象」樹中,並點選 建立.
選擇 已成功提交 或 提交失敗 從 選擇狀態 下拉式清單。
定義 然後 動作。 例如,選取 導覽至 然後輸入或貼上URL。 您也可以使用 函式 標籤。
點選 完成 來儲存規則。