Personalizzare i metadati degli attributi di entità
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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 |
|---|---|---|
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. |
|
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 usi Aggiornamento 1 di Microsoft Dynamics CRM Online 2015 o Microsoft Dynamics 365 (locale), tutti gli attributi data e ora supportano i valori fino a 1/1/1753 12:00 AM. |
|
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. |
|
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. |
|
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à. |
|
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:
|
|
Ricerca |
Un attributo creato quando una relazione di entità viene creata utilizzando il messaggio CreateOneToManyRequest. |
|
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. |
|
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:
|
|
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. |
|
Stato |
L'attributo stato viene creato automaticamente quando l'entità viene creata. Nota Le opzioni disponibili per l'attributo sono di sola lettura. |
|
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. |
|
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 365, ma Dynamics 365 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 |
|---|---|
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
Utilizzare il servizio Organizzazione con i metadati di Dynamics 365
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
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright