Lajur dalam aplikasi berasaskan model (Rujukan API Klien)

Lajur mengandungi data dalam borang aplikasi dipacu model atau grid. Gunakan formContext.data.entity.attributes koleksi atau formContext.getAttribute kaedah pintasan untuk mengakses koleksi lajur. Untuk maklumat lanjut tentang koleksi, lihat Koleksi (rujukan API Klien).

Untuk mengakses lajur dalam koleksi, masukkan sama ada nama (rentetan) atau nilai indeks (nombor) lajur sebagai argumen kepada kaedah. Sebagai contoh: formContext.getAttribute(arg). Jika anda tidak menentukan argumen, kaedah akan mengembalikan koleksi semua atribut pada borang.

Lajur dikategorikan mengikut jenis. Gunakan kaedah getAttributeType untuk menentukan jenis lajur. Kaedah lajur tertentu hanya tersedia untuk jenis lajur tertentu.

Artikel ini menyediakan maklumat tentang kaedah yang tersedia untuk setiap jenis lajur.

Semua jenis lajur

Sifat kawalan menyediakan koleksi kawalan yang berkaitan dengan lajur.

Kaedah berikut tersedia untuk semua jenis lajur:

Kaedah	Perihalan
addOnChange	Menambah fungsi untuk dijalankan apabila peristiwa lajur OnChange berlaku.
fireOnChange	Mencetuskan OnChange acara lajur.
getAttributeType	Mengembalikan jenis lajur.
getFormat	Mengembalikan format lajur.
dapatIsKotor	Mengembalikan sama ada lajur mempunyai perubahan yang belum disimpan.
dapatNama	Mengembalikan nama logik lajur.
dapatIbu Bapa	Mengembalikan objek induk formContext.data.entity .
dapatTahap Diperlukan	Mengembalikan sama ada nilai lajur diperlukan atau disyorkan.
getSubmitMode	Kembali apabila data lajur dihantar semasa menyimpan.
getUserPrivilege	Mengembalikan keistimewaan pengguna untuk mencipta, membaca, atau mengemas kini nilai lajur.
dapatNilai	Mengembalikan nilai data lajur.
isSah	Mengembalikan sama ada nilai lajur adalah sah.
removeOnChange	Mengeluarkan fungsi daripada pengendali acara lajur OnChange .
setIsValid	Menetapkan kesahihan lajur dan mesej ralat.
setTahap yang diperlukan	Menetapkan sama ada nilai lajur diperlukan atau disyorkan sebelum disimpan.
setSubmitMode	Menetapkan sama ada data lajur dihantar semasa simpanan.
setNilai	Menetapkan nilai data lajur.

Jenis lajur Boolean

Selain kaedah yang tersedia untuk semua jenis lajur, jenis lajur boolean menyediakan kaedah berikut:

Kaedah	Perihalan
getInitialValue	Mengembalikan nilai lajur apabila borang dibuka.

Jenis lajur carian

Selain kaedah yang tersedia untuk semua jenis lajur, jenis lajur carian menyediakan kaedah berikut:

Kaedah	Perihalan
getIsPartyList	Mengembalikan sama ada carian membenarkan beberapa rekod sebagai carian senarai parti.

Pilihan dan jenis lajur pilihan

Selain kaedah yang tersedia untuk semua jenis lajur, pilihan dan jenis lajur pilihan menyediakan kaedah berikut:

Kaedah	Perihalan
getInitialValue	Mengembalikan nilai lajur apabila borang dibuka.
dapatPilihan	Mengembalikan pilihan yang sepadan dengan label atau nilai yang ditentukan.
dapatPilihan	Mengembalikan pilihan sah lajur.
getSelectedOption	Mengembalikan pilihan yang dipilih.
dapatkanTeks	Mengembalikan teks pilihan yang dipilih.

Jenis lajur nombor (perpuluhan, berganda, integer, wang)

Kaedah berikut hanya tersedia untuk lajur perpuluhan, berganda dan integer :

Kaedah	Perihalan
dapatkanMaks	Mengembalikan nilai maksimum yang dibenarkan pada lajur.
getMin	Mengembalikan nilai minimum yang dibenarkan pada lajur.
mendapatkanKetepatan	Mengembalikan bilangan digit yang dibenarkan selepas titik perpuluhan.
setKetepatan	Menetapkan bilangan digit yang dibenarkan selepas titik perpuluhan.

Jenis lajur rentetan

Sebagai tambahan kepada kaedah yang tersedia untuk semua jenis lajur seperti yang dijelaskan sebelum ini, kaedah berikut hanya tersedia untuk lajur rentetan :

Kaedah	Perihalan
mendapatkanMaxPanjang	Mengembalikan panjang rentetan maksimum lajur.

Artikel berkaitan

Fahami model objek Xrm
Kawalan (Rujukan API Klien)