Personalizzare i metadati degli attributi di entità

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Utilizzare la classe AttributeMetadata per recuperare gli attributi esistenti. Questa classe viene restituita dal messaggio RetrieveAttributeRequest. La classe AttributeMetadata eredita dalla classe astratta MetadataBase.

Utilizzare la classe specifica per ogni tipo di attributo con il messaggio CreateAttributeRequest per aggiornare gli attributi o creare attributi personalizzati.

Nota

È possibile accedere agli attributi personalizzati a livello di programmazione dopo la creazione, ma è necessario aggiungerli a un modulo di entità e pubblicarli prima che gli utenti possano visualizzarli.

Tipi di attributo

Nella tabella seguente viene elencato ogni tipo di Attribute con cui si può lavorare. Ogni attributo eredita dalla classe AttributeMetadata.

Classe	Etichetta di applicazione	Descrizione
BooleanAttributeMetadata	Opzione Due	Un attributo booleano. È possibile specificare il testo per entrambe le opzioni. Quando vengono aggiunte a un modulo, le proprietà di campo controllano se l'attributo viene visualizzato come due pulsanti di opzione, una casella di controllo o un elenco.
DateTimeAttributeMetadata	Data e ora	Un attributo di data e ora. Puoi specificare il comportamento per archiviare i valori di data e ora con le informazioni sul fuso orario e il formato per definire il formato di visualizzazione dei valori. Per ulteriori informazioni, vedere Comportamento e formato dell'attributo di data e ora Nota Se utilizzi Microsoft Dynamics CRM Online e l'hai aggiornato a Aggiornamento 1 di Microsoft Dynamics CRM Online 2015, tutti gli attributi di data e ora supportano i valori fino a 1/1/1753 12:00 AM.
DecimalAttributeMetadata	Numero decimale	Un attributo decimale. È possibile specificare il livello di precisione fino a dieci posizioni decimali e i valori minimo e massimo da -100.000.000.000 a 100.000.000.000.
DoubleAttributeMetadata	Numero a virgola mobile	Un attributo doppio. È possibile specificare il livello di precisione fino a cinque posizioni decimali e i valori minimo e massimo da -100.000.000.000 a 100.000.000.000. Nota DoubleAttributeMetadata sostituisce FloatAttributeMetadata utilizzato in Microsoft Dynamics CRM 4.0.
ImageAttributeMetadata	Immagine	Un attributo di immagine. Ogni entità può avere un attributo di immagine. Alcune entità di sistema includono attributi di immagine e i nuovi attributi di immagine non possono essere aggiunti alle entità di sistema che non li hanno. È possibile aggiungere un attributo di immagine per personalizzare le entità Gli attributi di immagine hanno l'"EntityImage" SchemaName e l'"entityimage" LogicalName. Gli attributi di immagine personalizzati non utilizzeranno il prefisso di personalizzazione dell'autore della soluzione nel nome.Ulteriori informazioni:Immagini di entità.
IntegerAttributeMetadata	Numero intero	Un attributo con valore intero. È possibile specificare i valori minimo e massimo da -2.147.483.648 a 2.147.483.647. L'attributo può essere formattato per creare i seguenti tipi di campi utilizzando l'enumerazione IntegerFormat: Durata: visualizza un elenco a discesa che contiene gli intervalli di tempo. Un utente può selezionare un valore nell'elenco oppure digitare un valore Integer che indica il numero di minuti. Fuso orario: visualizza un elenco a discesa che contiene un elenco di fusi orari. Lingua: visualizza un elenco a discesa che contiene un elenco delle lingue che sono state abilitate per l'organizzazione. Se nessun altra lingua è abilitata, la lingua di base sarà l'unica opzione. Il valore salvato è il valore LCID per la lingua.
LookupAttributeMetadata	Ricerca	Un attributo creato quando una relazione di entità viene creata utilizzando il messaggio CreateOneToManyRequest.
MemoAttributeMetadata	Più righe di testo	Un attributo di nota. Viene visualizzato come un campo di casella di testo in un modulo. La lunghezza massima è 1048576 caratteri.
MoneyAttributeMetadata	Valuta	Un attributo di tipo money. È possibile specificare i valori minimo e massimo tra -922.337.203.685.477 e 922.337.203.685.477. Il livello di precisione può essere impostato utilizzando la proprietà PrecisionSource: Quando la precisione è impostata su zero (0), il valore MoneyAttributeMetadata.Precision viene utilizzato. Quando la precisione è impostata su uno (1), il valore Organization.PricingDecimalPrecision. viene utilizzato. Quando la precisione è impostata su due (2), il valore TransactionCurrency.CurrencyPrecision viene utilizzato.
PicklistAttributeMetadata	Set di opzioni	Un picklistattribute. Questo attributo contiene un set di opzioni disponibili in un elenco a discesa. È possibile creare l'attributo di elenco a discesa in modo da poter contenere le proprie opzioni o utilizzare un set di opzioni globale.
StateAttributeMetadata	Stato	L'attributo stato viene creato automaticamente quando l'entità viene creata. Nota Le opzioni disponibili per l'attributo sono di sola lettura.
StatusAttributeMetadata	Motivo stato	L'attributo stato viene creato automaticamente quando l'entità viene creata. Tutte le opzioni devono essere associate all'attributo StateAttributeMetadata per l'entità. Utilizzare il messaggio InsertStatusValueRequest per aggiornare le opzioni disponibili per l'attributo. Nota Ogni StatusOption deve fare riferimento a un valore di stato specifico perché i valori di stato dipendono da un valore di stato specifico.
StringAttributeMetadata	Una riga di testo	Vedere Formati di StringAttributeMetadata.

Formati di StringAttributeMetadata

Gli attributi stringa possono essere formattati per consentire ai collegamenti di iniziare telefonate utilizzando Lync o Skype. Questa modifica richiede che una nuova proprietà FormatName venga aggiunta alla classe StringAttributeMetadata e alla deprecazione della proprietà Format.

Nota

Lync è stato rinominato in Skype for Business. Al momento, potrai ancora vedere riferimenti a "Lync" in Microsoft Dynamics CRM, ma CRM utilizzerà Skype for Business.

L'utilizzo dell'enumerazione StringFormat per definire il formato per StringAttributeMetadata.Format è deprecato. In alternativa, utilizzare la classe StringFormatName per impostare il valore di StringAttributeMetadata.FormatName.

Questo consente di impostare il valore di formato di PhoneNumber, che non esiste nell'enumerazione StringFormat.

Per la compatibilità con le versioni precedenti, è possibile impostare un valore per controllare il formato dell'attributo utilizzando la proprietà Format o FormatName. Il codice esistente continuerà a funzionare se si utilizza solo Format, ma non sarà possibile formattare un attributo come numero di telefono senza utilizzare FormatName. Se entrambe le proprietà sono impostate, il set di valori che utilizza FormatName è l'unico che verrà applicato.

La classe StringFormatName contiene i seguenti membri; ogni membro restituisce una stringa con lo stesso valore del nome membro:

Nome membro e valore	Descrizione
Email	Il campo del modulo convaliderà il valore testuale come indirizzo di posta elettronica e creerà un collegamento mailto nel campo.
PhoneNumber	Il campo del modulo conterrà un collegamento per iniziare una telefonata utilizzando Lync o Skype.
PhoneticGuide	Solo per uso interno.
Text	Il modulo visualizzerà una casella di testo.
TextArea	Il modulo visualizzerà un campo di area di testo.
TickerSymbol	Il modulo visualizzerà un collegamento che verrà aperto per visualizzare un'offerta per il simbolo del titolo.
URL	Il modulo visualizzerà un collegamento per aprire l'URL.
VersionNumber	Solo per uso interno.

Vedere anche

Estendere il modello dei metadati
Utilizzare i metadati degli attributi
Comportamento e formato dell'attributo di data e ora
Messaggi dei metadati degli attributi di entità
Esempio: Utilizzare i metadati degli attributi
Articolo tecnico: Utilizzo delle opzioni Set di opzioni con l'endpoint REST - JScript
Esempio: eseguire il dump dei metadati di attributo in un file
Esempio: eseguire il dump dell'elenco a discesa attributi dei metadati in un file
Esempio: Convertire il comportamento di data e ora

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright