Model temelli uygulamalarda sütunlar (İstemci API başvurusu)

Sütunlar model temelli uygulamalar formunda veya kılavuzlarında veri içerir. Bir sütun koleksiyonuna formContext.data.entity.attributesformContext.getAttribute erişmek için koleksiyonu veya kısayol yöntemini kullanın. Koleksiyonlar hakkında daha fazla bilgi için bkz. Koleksiyonlar (İstemci API başvurusu).

Koleksiyondaki bir sütuna erişmek için, yöntemine bağımsız değişken olarak sütunun adını (dize) veya dizin değerini (sayı) geçirin. Örneğin: formContext.getAttribute(arg). Bir bağımsız değişken belirtmezseniz, yöntemi formdaki tüm özniteliklerden oluşan bir koleksiyon döndürür.

Sütunlar türe göre kategorilere ayrılmıştır. Sütunun türünü belirlemek için getAttributeType yöntemini kullanın. Belirli sütun yöntemleri yalnızca belirli sütun türleri için kullanılabilir.

Bu makalede, her sütun türü için kullanılabilen yöntemler hakkında bilgi sağlanır.

Tüm sütun türleri

controls özelliği, sütunla ilişkilendirilmiş bir denetim koleksiyonu sağlar.

Tüm sütun türleri için aşağıdaki yöntemler kullanılabilir:

Method	Description
addOnChange	Sütunun OnChange olayı gerçekleştiğinde çalıştırılacak bir işlev ekler.
fireOnChange	Sütunun OnChange olayını tetikler.
getAttributeType	Sütunun türünü döndürür.
getFormat	Sütunun biçimini döndürür.
getIsDirty	Sütunda kaydedilmemiş değişiklikler olup olmadığını döndürür.
getName	Sütunun mantıksal adını döndürür.
getParent	Üst formContext.data.entity nesneyi döndürür.
getRequiredLevel	Sütun değerinin gerekli mi yoksa önerilen mi olduğunu döndürür.
getSubmitMode	Kaydetme sırasında sütunun verileri gönderildiğinde döndürür.
getUserPrivilege	Sütunun değerini oluşturmak, okumak veya güncelleştirmek için kullanıcının ayrıcalıklarını döndürür.
getValue	Sütunun veri değerini döndürür.
isValid	Sütunun değerinin geçerli olup olmadığını döndürür.
removeOnChange	Sütunun OnChange olay işleyicilerinden bir işlevi kaldırır.
setIsValid	Sütunun geçerliliğini ve hata iletisini ayarlar.
setRequiredLevel	Kaydetmeden önce sütun değerinin gerekli mi yoksa önerilen mi olduğunu ayarlar.
setSubmitMode	Sütunun verilerinin kaydetmede gönderilip gönderilmeymeyeceğini ayarlar.
setValue	Sütunun veri değerini ayarlar.

Boole sütun türü

Tüm sütun türleri için kullanılabilen yöntemlere ek olarak boole sütun türü aşağıdaki yöntemi sağlar:

Method	Description
getInitialValue	Form açıldığında sütunun değerini döndürür.

Arama sütunu türü

Tüm sütun türleri için kullanılabilen yöntemlere ek olarak, arama sütun türü aşağıdaki yöntemi sağlar:

Method	Description
getIsPartyList	Aramanın bir grup listesi araması olarak birden çok kayda izin verip vermeyeceğini döndürür.

Seçenekler ve seçim sütun türleri

Tüm sütun türleri için kullanılabilen yöntemlere ek olarak, seçenekler ve seçim sütun türleri aşağıdaki yöntemleri sağlar:

Method	Description
getInitialValue	Form açıldığında sütunun değerini döndürür.
getOption	Belirtilen etiket veya değerle eşleşen seçeneği döndürür.
getOptions	Sütunun geçerli seçeneklerini döndürür.
getSelectedOption	Seçili seçeneği veya seçenekleri döndürür.
getText	Seçili seçenek veya seçeneklerin metnini döndürür.

Sayı sütun türü (ondalık, çift, tamsayı, para)

Aşağıdaki yöntemler yalnızca ondalık, çift ve tamsayı sütunları için kullanılabilir:

Method	Description
getMax	Sütunun izin verilen en büyük değerini döndürür.
getMin	Sütunun izin verilen en düşük değerini döndürür.
getPrecision	Ondalık ayırıcıdan sonra izin verilen basamak sayısını döndürür.
setPrecision	Ondalık ayırıcıdan sonra izin verilen basamak sayısını ayarlar.

Dize sütun türü

Daha önce açıklandığı gibi tüm sütun türleri için kullanılabilen yöntemlere ek olarak, aşağıdaki yöntem yalnızca dize sütunu için kullanılabilir:

Method	Description
getMaxLength	Sütunun en fazla dize uzunluğunu döndürür.

İlgili makaleler

Xrm nesne modelini anlama
Denetimler (İstemci API başvurusu)