Coloane în aplicațiile bazate pe modele (referință API client)

Coloanele conțin date în formularul sau grilele aplicațiilor bazate pe modele. Utilizați colecția formContext.data.entity.attributesformContext.getAttribute sau metoda de comandă rapidă pentru a accesa o colecție de coloane. Pentru mai multe informații despre colecții, consultați Colecții (Referință API client).

Pentru a accesa o coloană din colecție, transmiteți numele (șirul) sau valoarea indexului (numărul) coloanei ca argument al metodei. De exemplu: formContext.getAttribute(arg). Dacă nu specificați un argument, metoda returnează o colecție de toate atributele formularului.

Coloanele sunt clasificate după tip. Utilizați metoda getAttributeType pentru a determina tipul coloanei. Anumite metode de coloană sunt disponibile doar pentru anumite tipuri de coloane.

Acest articol oferă informații despre metodele disponibile pentru fiecare tip de coloană.

Toate tipurile de coloane

Proprietatea controale oferă o colecție de controale asociate coloanei.

Următoarele metode sunt disponibile pentru toate tipurile de coloane:

Metodă Descriere
addOnChange Adaugă o funcție de rulat atunci când are loc evenimentul coloanei OnChange .
fireOnChange Declanșează evenimentul coloanei OnChange .
getAttributeType Returnează tipul coloanei.
getFormat Returnează formatul coloanei.
getIsDirty Returnează dacă coloana are modificări nesalvate.
getName Returnează numele logic al coloanei.
getParent Returnează obiectul părinte formContext.data.entity .
getRequiredLevel Returnează dacă este necesară sau recomandată o valoare de coloană.
getSubmitMode Returnează când datele coloanei sunt remise la salvare.
getUserPrivilege Returnează privilegiile utilizatorului pentru a crea, a citi sau a actualiza valoarea coloanei.
getValue Returnează valoarea de date a coloanei.
isValid Returnează dacă valoarea coloanei este validă.
removeOnChange Elimină o funcție din rutinele de tratare a evenimentelor din OnChange coloană.
setIsValid Setează validitatea coloanei și un mesaj de eroare.
setRequiredLevel Setează dacă este necesară sau recomandată o valoare de coloană înainte de salvare.
setSubmitMode Setează dacă datele coloanei sunt remise la salvare.
setValue Setează valoarea de date a coloanei.

Tip de coloană booleană

În plus față de metodele disponibile pentru toate tipurile de coloane, tipul de coloană boolean furnizează următoarea metodă:

Metodă Descriere
getInitialValue Returnează valoarea coloanei atunci când formularul se deschide.

Tip de coloană de căutare

În plus față de metodele disponibile pentru toate tipurile de coloane, tipul de coloană de căutare furnizează următoarea metodă:

Metodă Descriere
getIsPartyList Returnează dacă căutarea permite mai multe înregistrări ca căutare listă de părți.

Tipuri de coloane Opțiuni și alegere

În plus față de metodele disponibile pentru toate tipurile de coloane, tipurile de coloaneopțiuni și alegere furnizează următoarele metode:

Metodă Descriere
getInitialValue Returnează valoarea coloanei atunci când formularul se deschide.
getOption Returnează opțiunea care se potrivește cu o etichetă sau o valoare specificată.
getOptions Returnează opțiunile valide ale coloanei.
getSelectedOption Returnează opțiunea sau opțiunile selectate.
getText Returnează textul opțiunii sau opțiunilor selectate.

Tip de coloană număr (zecimal, dublu, întreg, bani)

Următoarele metode sunt disponibile doar pentru coloanele zecimale, duble și întregi :

Metodă Descriere
getMax Returnează valoarea maximă permisă a coloanei.
getMin Returnează valoarea minimă permisă a coloanei.
getPrecision Returnează numărul de cifre permise după virgula zecimală.
setPrecision Setează numărul de cifre permise după virgula zecimală.

Tip coloană șir

În plus față de metodele disponibile pentru toate tipurile de coloane așa cum este explicat anterior, următoarea metodă este disponibilă doar pentru coloana șir :

Metodă Descriere
getMaxLength Returnează lungimea maximă a șirului coloanei.

Înțelegerea modelului de obiect Xrm
Controale (Referință API client)