setSubmitMode (rujukan API Klien)

Mengesetkan sama ada data daripada lajur akan diserahkan apabila rekod disimpan.

Jenis lajur disokong

Semua

Sintaks

formContext.getAttribute(arg).setSubmitMode(mode)

Parameter

Jenis: Rentetan.

Penerangan: Tetapkan salah satu daripada nilai mod berikut:

• always: Data sentiasa dihantar dengan simpanan.
• never: Data tidak pernah dihantar dengan simpanan. Apabila nilai ini digunakan, lajur dalam borang untuk lajur ini tidak boleh diedit.
• dirty: Tingkah laku lalai. Data dihantar dengan simpan apabila ia telah berubah.

Ucapan

Gunakan kaedah ini untuk mengawal apabila data bagi lajur diserahkan apabila rekod dicipta atau disimpan. Sebagai contoh, anda mungkin mempunyai lajur pada borang yang hanya bertujuan untuk mengawal logik dalam borang. Anda tidak berminat untuk menangkap data di dalamnya. Anda boleh menetapkannya supaya data tidak disimpan. Atau anda mungkin mempunyai Plugin yang bergantung pada nilai yang sentiasa disertakan. Anda mungkin mahu menetapkan lajur supaya ia akan sentiasa disertakan.

Nota

Data dalam lajur akan sentiasa dimuat semula selepas operasi simpan, walaupun mod penyerahan lajur ditetapkan kepada never. Contohnya, jika nilai lajur dalam pelayan adalah null dan mod penyerahan lajur ditetapkan kepada never, dan lajur diubah suai dengan beberapa nilai oleh pengguna, selepas pengguna menyimpan borang nilai lajur akan digantikan dengan null.

Lajur yang tidak dikemas kini selepas simpanan awal rekod, seperti createdby, ditetapkan supaya ia tidak akan diserahkan semasa menyimpan. Untuk memaksa nilai lajur diserahkan sama ada ia telah berubah atau tidak, gunakan kaedah ini dengan mode parameter ditetapkan kepada always.

Artikel berkaitan

getSubmitMode (Rujukan API Klien)