Colonne nelle app basate su modello (Informazioni di riferimento sulle API client)

Le colonne contengono dati nella maschera o nelle griglie delle app basate su modello. Utilizzare la formContext.data.entity.attributes raccolta o il formContext.getAttribute metodo di scelta rapida per accedere a una raccolta di colonne. Per altre informazioni sulle raccolte, vedere Raccolte (informazioni di riferimento sulle API client).

Per accedere a una colonna all'interno della raccolta, passare il nome (stringa) o il valore di indice (numero) della colonna come argomento al metodo . Ad esempio: formContext.getAttribute(arg). Se non si specifica un argomento, il metodo restituisce una raccolta di tutti gli attributi nel form.

Le colonne sono categorizzate per tipo. Usare il metodo getAttributeType per determinare il tipo della colonna. Alcuni metodi di colonna sono disponibili solo per tipi specifici di colonne.

Questo articolo fornisce informazioni sui metodi disponibili per ogni tipo di colonna.

Tutti i tipi di colonna

La proprietà controls fornisce una raccolta di controlli associati alla colonna.

Per tutti i tipi di colonna sono disponibili i metodi seguenti:

Method Description
addOnChange Aggiunge una funzione da eseguire quando si verifica l'evento della OnChange colonna.
fireOnChange Attiva l'evento della OnChange colonna.
getAttributeType Restituisce il tipo della colonna.
getFormat Restituisce il formato della colonna.
getIsDirty Restituisce un valore che indica se la colonna ha modifiche non salvate.
getName Restituisce il nome logico della colonna.
getParent Restituisce l'oggetto genitore formContext.data.entity .
getRequiredLevel Restituisce un valore di colonna obbligatorio o consigliato.
getSubmitMode Restituisce quando i dati della colonna vengono inviati al salvataggio.
getUserPrivilege Restituisce i privilegi dell'utente per creare, leggere o aggiornare il valore della colonna.
getValue Restituisce il valore dei dati della colonna.
isValid Restituisce un valore che indica se il valore della colonna è valido.
removeOnChange Rimuove una funzione dai gestori eventi della OnChange colonna.
setIsValid Imposta la validità della colonna e un messaggio di errore.
setRequiredLevel Imposta un valore di colonna obbligatorio o consigliato prima del salvataggio.
setSubmitMode Imposta un valore che indica se i dati della colonna vengono inviati al salvataggio.
setValue Imposta il valore dei dati della colonna.

Tipo di colonna booleana

Oltre ai metodi disponibili per tutti i tipi di colonna, il tipo di colonna booleano fornisce il metodo seguente:

Method Description
getInitialValue Restituisce il valore della colonna all'apertura della maschera.

Tipo di colonna di ricerca

Oltre ai metodi disponibili per tutti i tipi di colonna, il tipo di colonna di ricerca fornisce il metodo seguente:

Method Description
getIsPartyList Restituisce un valore che indica se la ricerca consente più record come ricerca elenco di entità.

Scelte e tipi di colonna di scelta

Oltre ai metodi disponibili per tutti i tipi di colonna, le scelte e i tipi di colonna choice forniscono i metodi seguenti:

Method Description
getInitialValue Restituisce il valore della colonna all'apertura della maschera.
getOption Restituisce l'opzione corrispondente a un'etichetta o a un valore specificato.
getOptions Restituisce le opzioni valide della colonna.
getSelectedOption Restituisce l'opzione o le opzioni selezionate.
getText Restituisce il testo dell'opzione o delle opzioni selezionate.

Tipo di colonna numerica (decimal, double, integer, money)

I metodi seguenti sono disponibili solo per le colonne decimali, double e integer :

Method Description
getMax Restituisce il valore massimo consentito della colonna.
getMin Restituisce il valore minimo consentito della colonna.
getPrecision Restituisce il numero di cifre consentite dopo il separatore decimale.
setPrecision Imposta il numero di cifre consentite dopo il separatore decimale.

Tipo di colonna stringa

Oltre ai metodi disponibili per tutti i tipi di colonna come illustrato in precedenza, il metodo seguente è disponibile solo per la colonna stringa :

Method Description
getMaxLength Restituisce la lunghezza massima della stringa della colonna.

Informazioni sul modello a oggetti Xrm
Controlli (informazioni di riferimento sulle API client)