Sloupce v modelem řízených aplikacích (reference k rozhraní API klienta)

Sloupce obsahují data ve formuláři nebo mřížkách modelem řízených aplikací. formContext.data.entity.attributes Pro přístup k kolekci sloupců použijte kolekci nebo metodu formContext.getAttribute zástupce. Další informace o kolekcích najdete v tématu Kolekce (referenční informace k rozhraní API klienta).

Pokud chcete získat přístup ke sloupci v kolekci, předejte metodě název (řetězec) nebo hodnotu indexu (číslo) sloupce. Například: formContext.getAttribute(arg). Pokud nezadáte argument, vrátí metoda kolekci všech atributů ve formuláři.

Sloupce jsou kategorizovány podle typu. K určení typu sloupce použijte metodu getAttributeType . Některé metody sloupců jsou k dispozici pouze pro konkrétní typy sloupců.

Tento článek obsahuje informace o metodách dostupných pro každý typ sloupce.

Všechny typy sloupců

Vlastnost ovládacích prvků poskytuje kolekci ovládacích prvků přidružených ke sloupci.

Pro všechny typy sloupců jsou k dispozici následující metody:

Method Description
addOnChange Přidá funkci, která se má spustit, když dojde k události sloupce OnChange .
fireOnChange Aktivuje událost sloupce OnChange .
getAttributeType Vrátí typ sloupce.
getFormat Vrátí formát sloupce.
getIsDirty Vrátí, zda sloupec obsahuje neuložené změny.
getName Vrátí logický název sloupce.
getParent Vrátí nadřazený formContext.data.entity objekt.
getRequiredLevel Vrátí, zda je hodnota sloupce povinná nebo doporučená.
getSubmitMode Vrátí, když se data sloupce odesílají při uložení.
getUserPrivilege Vrátí oprávnění uživatele k vytvoření, čtení nebo aktualizaci hodnoty sloupce.
getValue Vrátí hodnotu dat sloupce.
isValid Vrátí, zda je hodnota sloupce platná.
removeOnChange Odebere funkci z obslužných rutin událostí sloupce OnChange .
setIsValid Nastaví platnost sloupce a chybovou zprávu.
setRequiredLevel Nastaví, jestli se před uložením vyžaduje nebo doporučuje hodnota sloupce.
setSubmitMode Nastaví, jestli se data sloupce odesílají při uložení.
setValue Nastaví datovou hodnotu sloupce.

Typ logického sloupce

Kromě metod dostupných pro všechny typy sloupců poskytuje logický typ sloupce následující metodu:

Method Description
getInitialValue Vrátí hodnotu sloupce při otevření formuláře.

Typ vyhledávacího sloupce

Kromě metod dostupných pro všechny typy sloupců poskytuje typ vyhledávacího sloupce následující metodu:

Method Description
getIsPartyList Vrátí, zda vyhledávání umožňuje více záznamů jako vyhledávání seznamu stran.

Volby a typy sloupců voleb

Kromě metod dostupných pro všechny typy sloupců nabízejí možnosti a typy sloupců voleb následující metody:

Method Description
getInitialValue Vrátí hodnotu sloupce při otevření formuláře.
getOption Vrátí možnost odpovídající zadanému popisku nebo hodnotě.
getOptions Vrátí platné možnosti sloupce.
getSelectedOption Vrátí vybranou možnost nebo možnosti.
getText Vrátí text vybrané možnosti nebo možností.

Typ číselného sloupce (desítkové, dvojité, celé číslo, peníze)

Následující metody jsou k dispozici pouze pro desetinné, dvojité a celočíselné sloupce:

Method Description
getMax Vrátí maximální povolenou hodnotu sloupce.
getMin Vrátí minimální povolenou hodnotu sloupce.
getPrecision Vrátí počet číslic povolených za desetinnou čárkou.
setPrecision Nastaví počet číslic povolených za desetinnou čárkou.

Typ sloupce String

Kromě metod dostupných pro všechny typy sloupců, jak je vysvětleno výše, je následující metoda k dispozici pouze pro řetězcový sloupec:

Method Description
getMaxLength Vrátí maximální délku řetězce sloupce.

Principy objektového modelu Xrm
Ovládací prvky (referenční dokumentace k rozhraní API klienta)