共用方式為


setSubmitMode (用戶端 API 參考)

設定儲存記錄時是否提交欄中的資料。

支援的資料行類型

全部

語法

formContext.getAttribute(arg).setSubmitMode(mode)

參數

類型:字串。

說明:設定下列其中一個模式值:

  • always:資料一律會隨儲存一起傳送。
  • never:資料永遠不會與儲存一起傳送。 使用此值時,無法編輯此欄表單中的欄。
  • dirty:預設行為。 當資料變更時,會隨儲存一起傳送。

備註

使用此方法可控制在建立或儲存記錄時提交直欄資料的時間。 例如,表單上可能有一個資料行,只用來控制表單中的邏輯。 您對捕獲其中的數據不感興趣。 您可以將其設定為不儲存資料。 或者您可能有一個插件,該插件取決於始終包含的值。 您可能想要設定資料行,使其一律包含在內。

備註

資料行中的資料一律會在儲存作業之後重新整理,即使資料行的提交模式設為 never。 例如,如果伺服器中資料行的值為空值,且資料行的提交模式設定為 never,且使用者使用某些值修改了該資料行,則使用者儲存表單後,該資料行的值將取代為空值。

在記錄的初始儲存之後未更新的直欄 (例如 createdby) 會設定為在儲存時不會提交。 若要強制提交直欄值,無論它是否已變更,請使用此方法, mode 並將參數設為 always

getSubmitMode (用戶端 API 參考)