Kolom dalam aplikasi berbasis model (referensi API Klien)

Kolom berisi data dalam formulir atau kisi aplikasi berbasis model. formContext.data.entity.attributes Gunakan koleksi atau formContext.getAttribute metode pintasan untuk mengakses kumpulan kolom. Untuk informasi selengkapnya tentang koleksi, lihat Koleksi (Referensi API Klien).

Untuk mengakses kolom dalam koleksi, teruskan nama (string) atau nilai indeks (angka) kolom sebagai argumen ke metode . Misalnya: formContext.getAttribute(arg). Jika Anda tidak menentukan argumen, metode mengembalikan kumpulan semua atribut pada formulir.

Kolom dikategorikan menurut jenis. Gunakan metode getAttributeType untuk menentukan jenis kolom. Metode kolom tertentu hanya tersedia untuk jenis kolom tertentu.

Artikel ini menyediakan informasi tentang metode yang tersedia untuk setiap jenis kolom.

Semua jenis kolom

Properti kontrol menyediakan kumpulan kontrol yang terkait dengan kolom .

Metode berikut tersedia untuk semua jenis kolom:

Method	Description
addOnChange	Menambahkan fungsi untuk dijalankan saat peristiwa kolom OnChange terjadi.
fireOnChange	Memicu peristiwa kolom OnChange .
getAttributeType	Mengembalikan jenis kolom.
getFormat	Mengembalikan format kolom.
getIsDirty	Mengembalikan apakah kolom memiliki perubahan yang belum disimpan.
getName	Mengembalikan nama logika kolom.
getParent	Mengembalikan objek induk formContext.data.entity .
getRequiredLevel	Mengembalikan apakah nilai kolom diperlukan atau disarankan.
getSubmitMode	Mengembalikan saat data kolom dikirim saat disimpan.
getUserPrivilege	Mengembalikan hak istimewa pengguna untuk membuat, membaca, atau memperbarui nilai kolom.
getValue	Mengembalikan nilai data kolom.
isValid	Mengembalikan apakah nilai kolom valid.
removeOnChange	Menghapus fungsi dari penanganan aktivitas kolom OnChange .
setIsValid	Mengatur validitas kolom dan pesan kesalahan.
setRequiredLevel	Mengatur apakah nilai kolom diperlukan atau disarankan sebelum menyimpan.
setSubmitMode	Mengatur apakah data kolom dikirim saat disimpan.
setValue	Mengatur nilai data kolom.

Tipe kolom Boolean

Selain metode yang tersedia untuk semua jenis kolom, jenis kolom boolean menyediakan metode berikut:

Method	Description
getInitialValue	Mengembalikan nilai kolom saat formulir dibuka.

Jenis kolom pencarian

Selain metode yang tersedia untuk semua jenis kolom, jenis kolom pencarian menyediakan metode berikut:

Method	Description
getIsPartyList	Mengembalikan apakah pencarian memungkinkan beberapa rekaman sebagai pencarian daftar pihak.

Pilihan dan jenis kolom pilihan

Selain metode yang tersedia untuk semua jenis kolom, pilihan dan jenis kolom pilihan menyediakan metode berikut:

Method	Description
getInitialValue	Mengembalikan nilai kolom saat formulir dibuka.
getOption	Mengembalikan opsi yang cocok dengan label atau nilai tertentu.
getOptions	Mengembalikan opsi kolom yang valid.
getSelectedOption	Mengembalikan opsi atau opsi yang dipilih.
getText	Mengembalikan teks opsi atau opsi yang dipilih.

Jenis kolom angka (desimal, ganda, bilangan bulat, uang)

Metode berikut hanya tersedia untuk kolom desimal, ganda, dan bilangan bulat :

Method	Description
getMax	Mengembalikan nilai maksimum kolom yang diizinkan.
getMin	Mengembalikan nilai minimum kolom yang diizinkan.
getPrecision	Mengembalikan jumlah digit yang diizinkan setelah titik desimal.
setPrecision	Mengatur jumlah digit yang diizinkan setelah titik desimal.

Jenis kolom string

Selain metode yang tersedia untuk semua jenis kolom seperti yang dijelaskan sebelumnya, metode berikut hanya tersedia untuk kolom string :

Method	Description
getMaxLength	Mengembalikan panjang string maksimum kolom.

Artikel terkait

Memahami model objek Xrm
Kontrol (Referensi API Klien)