Kolumny w aplikacjach opartych na modelu (dokumentacja interfejsu API klienta)

Kolumny zawierają dane w formularzu lub siatce aplikacji opartych na modelu. Użyj kolekcji formContext.data.entity.attributes lub metody skrótu formContext.getAttribute , aby uzyskać dostęp do kolekcji kolumn. Aby uzyskać więcej informacji na temat kolekcji, zobacz Kolekcje (dokumentacja interfejsu API klienta).

Aby uzyskać dostęp do kolumny w kolekcji, przekaż nazwę (ciąg) lub wartość indeksu (liczbę) kolumny jako argument do metody . Na przykład: formContext.getAttribute(arg). Jeśli nie określisz argumentu, metoda zwraca kolekcję wszystkich atrybutów w formularzu.

Kolumny są podzielone na kategorie według typu. Użyj metody getAttributeType , aby określić typ kolumny. Niektóre metody kolumn są dostępne tylko dla określonych typów kolumn.

Ten artykuł zawiera informacje o metodach dostępnych dla każdego typu kolumny.

Wszystkie typy kolumn

Właściwość controls udostępnia kolekcję kontrolek skojarzonych z kolumną.

Dla wszystkich typów kolumn są dostępne następujące metody:

Method	Description
addOnChange	Dodaje funkcję do uruchamiania po wystąpieniu zdarzenia kolumny OnChange .
fireOnChange	Wyzwala zdarzenie kolumny OnChange .
getAttributeType	Zwraca typ kolumny.
getFormat	Zwraca format kolumny.
getIsDirty	Zwraca, czy kolumna ma niezapisane zmiany.
getName	Zwraca nazwę logiczną kolumny.
getParent	Zwraca obiekt nadrzędny formContext.data.entity .
getRequiredLevel	Zwraca, czy wartość kolumny jest wymagana, czy zalecana.
getSubmitMode	Zwraca informacje o przesłaniu danych kolumny podczas zapisywania.
getUserPrivilege	Zwraca uprawnienia użytkownika do tworzenia, odczytywania lub aktualizowania wartości kolumny.
getValue	Zwraca wartość danych kolumny.
isValid	Zwraca, czy wartość kolumny jest prawidłowa.
removeOnChange	Usuwa funkcję z procedur obsługi zdarzeń w kolumnie OnChange .
setIsValid	Ustawia ważność kolumny i komunikat o błędzie.
setRequiredLevel	Określa, czy wartość kolumny jest wymagana, czy zalecana przed zapisaniem.
setSubmitMode	Określa, czy dane kolumny są przesyłane podczas zapisywania.
setValue	Ustawia wartość danych kolumny.

Typ kolumny logicznej

Oprócz metod dostępnych dla wszystkich typów kolumn typ kolumny logicznej udostępnia następującą metodę:

Method	Description
getInitialValue	Zwraca wartość kolumny po otwarciu formularza.

Typ kolumny odnośnika

Oprócz metod dostępnych dla wszystkich typów kolumn typ kolumny odnośnika zapewnia następującą metodę:

Method	Description
getIsPartyList	Zwraca, czy wyszukiwanie umożliwia wyszukiwanie wielu rekordów jako odnośnik listy testowej.

Wybór i wybór typów kolumn

Oprócz metod dostępnych dla wszystkich typów kolumn opcje i typy kolumn wyboru zapewniają następujące metody:

Method	Description
getInitialValue	Zwraca wartość kolumny po otwarciu formularza.
getOption	Zwraca opcję zgodną z określoną etykietą lub wartością.
getOptions	Zwraca prawidłowe opcje kolumny.
getSelectedOption	Zwraca wybraną opcję lub opcje.
getText	Zwraca tekst wybranej opcji lub opcji.

Typ kolumny liczbowej (liczba dziesiętna, podwójna, liczba całkowita, pieniądze)

Następujące metody są dostępne tylko dla kolumn dziesiętnych, podwójnych i całkowitych :

Method	Description
getMax	Zwraca maksymalną dozwoloną wartość kolumny.
getMin	Zwraca minimalną dozwoloną wartość kolumny.
getPrecision	Zwraca liczbę cyfr dozwolonych po przecinku dziesiętny.
setPrecision	Ustawia liczbę cyfr dozwolonych po przecinku dziesiętny.

Typ kolumny ciągu

Oprócz metod dostępnych dla wszystkich typów kolumn, jak wyjaśniono wcześniej, następująca metoda jest dostępna tylko dla kolumny ciągu :

Method	Description
getMaxLength	Zwraca maksymalną długość ciągu kolumny.

Powiązane artykuły

Omówienie modelu obiektów Xrm
Kontrolki (dokumentacja interfejsu API klienta)