Modellalapú alkalmazások oszlopai (ügyfél API-referencia)

Az oszlopok a modellalapú alkalmazások űrlapjában vagy rácsaiban tartalmaznak adatokat. formContext.data.entity.attributes A gyűjtemény vagy a formContext.getAttribute parancsikon metódus használatával érheti el az oszlopok gyűjteményét. A gyűjteményekről további információt a Gyűjtemények (Ügyfél API-referencia) című témakörben talál.

Ha egy oszlopot szeretne elérni a gyűjteményben, adja át argumentumként az oszlop nevét (sztringje) vagy indexértékét (számát) a metódusnak. Például: formContext.getAttribute(arg). Ha nem ad meg argumentumot, a metódus az űrlap összes attribútumának gyűjteményét adja vissza.

Az oszlopok típus szerint vannak kategorizálva. Az oszlop típusának meghatározásához használja a getAttributeType metódust . Bizonyos oszlopmetszetek csak bizonyos típusú oszlopokhoz érhetők el.

Ez a cikk az egyes oszloptípusokhoz elérhető metódusokról nyújt tájékoztatást.

Minden oszloptípus

A vezérlőtulajdonság az oszlophoz társított vezérlők gyűjteményét biztosítja.

Az alábbi módszerek minden oszloptípushoz elérhetők:

Method Description
addOnChange Hozzáad egy függvényt, amely az oszlop eseményének OnChange bekövetkezésekor fut.
fireOnChange Aktiválja az oszlop eseményét OnChange .
getAttributeType Az oszlop típusát adja vissza.
getFormat Az oszlop formátumát adja vissza.
getIsDirty Azt adja vissza, hogy az oszlopban vannak-e nem mentett módosítások.
getName Az oszlop logikai nevét adja vissza.
getParent A szülőobjektumot formContext.data.entity adja vissza.
getRequiredLevel Azt adja vissza, hogy szükség van-e oszlopértékre vagy ajánlott-e.
getSubmitMode Azt adja vissza, hogy az oszlop adatai mentéskor lesznek elküldve.
getUserPrivilege Visszaadja a felhasználó jogosultságait az oszlop értékének létrehozásához, olvasásához vagy frissítéséhez.
getValue Az oszlop adatértékét adja vissza.
isValid Azt adja vissza, hogy az oszlop értéke érvényes-e.
removeOnChange Eltávolít egy függvényt az oszlop eseménykezelőiből OnChange .
setIsValid Beállítja az oszlop érvényességét és egy hibaüzenetet.
setRequiredLevel Beállítja, hogy szükség van-e oszlopértékre vagy javasolt-e a mentés előtt.
setSubmitMode Beállítja, hogy az oszlop adatai mentésre legyenek-e elküldve.
setValue Beállítja az oszlop adatértékét.

Logikai oszlop típusa

Az összes oszloptípushoz elérhető metódusok mellett a logikai oszloptípus a következő metódust biztosítja:

Method Description
getInitialValue Az űrlap megnyitásakor az oszlop értékét adja vissza.

Keresési oszlop típusa

A keresési oszloptípus az összes oszloptípushoz elérhető metódusok mellett a következő metódust is biztosítja:

Method Description
getIsPartyList Azt adja vissza, hogy a keresés lehetővé teszi-e több rekord féllista-keresésként való keresését.

Választási lehetőségek és választási lehetőségek oszloptípusai

Az összes oszloptípushoz elérhető metódusok mellett a választási lehetőségek és a választási lehetőségek oszloptípusai a következő módszereket biztosítják:

Method Description
getInitialValue Az űrlap megnyitásakor az oszlop értékét adja vissza.
getOption A megadott címkének vagy értéknek megfelelő beállítást adja vissza.
getOptions Az oszlop érvényes beállításait adja vissza.
getSelectedOption A kiválasztott beállítást vagy beállításokat adja vissza.
szöveg beolvasása A kijelölt beállítás vagy beállítások szövegét adja vissza.

Számoszlop típusa (decimális, dupla, egész szám, pénz)

A következő módszerek csak a tizedes,a dupla és az egész szám oszlophoz érhetők el:

Method Description
getMax Az oszlop megengedett maximális értékét adja vissza.
getMin Az oszlop megengedett minimális értékét adja vissza.
getPrecision A tizedesvessző után engedélyezett számjegyek számát adja vissza.
setPrecision A tizedesvessző után engedélyezett számjegyek számát állítja be.

Sztringoszlop típusa

A korábban ismertetett összes oszloptípushoz elérhető metódusok mellett a következő metódus csak a sztringoszlophoz érhető el:

Method Description
getMaxLength Az oszlop maximális sztringhosszát adja vissza.

Az Xrm objektummodell ismertetése
Vezérlők (ügyfél API-referencia)