Personalizzare i metadati dell'entità
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Le entità vengono definite dai metadati. Definendo o modificando i metadati dell'entità, è possibile controllare le funzionalità di un'entità. Per visualizzare i metadati dell'organizzazione, utilizzare il browser dei metadati fornito nel pacchetto SDK. Scarica il pacchetto SDK di Microsoft Dynamics CRM. Ulteriori informazioni:Visualizzazione dei metadati per l'organizzazione
Questo argomento riguarda l'utilizzo delle entità a livello di programmazione. Per informazioni sull'utilizzo delle entità nell'applicazione, vedere TechNet: Creare e modificare le entità.
In questo argomento
Opzioni disponibili quando si crea un'entità personalizzata
Abilitare le funzionalità dell'entità
Proprietà dell'entità modificabili
Messaggi dei metadati delle entità
Messaggi supportati dalle entità personalizzate
Opzioni disponibili quando si crea un'entità personalizzata
Nella tabella seguente sono elencate le opzioni disponibili quando si crea un'entità personalizzata. È possibile impostare queste proprietà solo quando si crea un'entità personalizzata.
Opzione |
Descrizione |
|---|---|
Creazione come impegno personalizzato |
È possibile creare un'entità che è un impegno impostando la proprietà EntityMetadata.IsActivity. Per ulteriori informazioni, vedere Attività personalizzate. |
Nomi delle entità. |
Esistono due tipi di nomi ed entrambi devono contenere un prefisso di personalizzazione:
Nota Se il nome logico è diverso dal nome dello schema, il nome dello schema sovrascriverà il valore impostato per il nome logico. Quando un'entità viene creata nell'applicazione nel contesto di una soluzione specifica, il prefisso di personalizzazione utilizzato corrisponde a quello impostato per il Publisher della soluzione. Quando un'entità viene creata a livello di programmazione, è possibile impostare il prefisso di personalizzazione su una stringa di lunghezza compresa tra due e otto caratteri, con tutti i caratteri alfanumerici che devono iniziare con una lettera. Non può iniziare con "mscrm". È consigliabile l'utilizzo del prefisso di personalizzazione definito dall'autore al quale la soluzione è associata, ma non è obbligatorio. Un carattere di sottolineatura deve essere incluso tra il prefisso di personalizzazione e il nome dello schema o logico. |
Proprietà |
Utilizzare la proprietà EntityMetadata.OwnershipType per impostare quando detto. Utilizzare l'enumerazione OwnershipTypes per impostare il tipo di proprietà dell'entità. Gli unici valori validi per le entità personalizzate sono OrgOwned o UserOwned. Per ulteriori informazioni, vedere 8597998f-764f-4c73-b63d-9f5e02c78061#EntityOwnership. |
Attributo primario |
Utilizzare CreateEntityRequest.PrimaryAttribute per impostare quanto detto. Ogni entità ha un attributo StringAttributeMetadata che utilizza StringFormat.Text come attributo primario. Il valore di questo attributo corrisponde a quanto visualizzato in una ricerca per tutte le entità correlate. Pertanto, il valore del campo deve rappresentare un nome per il record dell'entità. |
Abilitare le funzionalità dell'entità
Le funzionalità dell'entità sono elencate nella tabella seguente. È possibile impostare queste funzionalità durante la creazione di un'entità o abilitarle in seguito. Quando le si abilita, queste funzionalità non possono essere disabilitate.
Funzionalità |
Descrizione |
|---|---|
Processi aziendali |
Impostare EntityMetadata.IsBusinessProcessEnabled su true per abilitare l'entità per i processi aziendali. |
Note |
Utilizzare la proprietà CreateEntityRequest o UpdateEntityRequest.HasNotes per creare una relazione di entità con l'entità Annotation e abilitare l'inclusione di un'area Note del modulo dell'entità. Includendo Note, è possibile anche aggiungere allegati ai record. |
Impegni |
Utilizzare la proprietà CreateEntityRequest o UpdateEntityRequest.HasActivities per creare una relazione di entità con l'entità ActivityPointer in modo da poter associare tutte le entità di tipo impegno con questa entità. |
Connessioni |
Impostare la proprietà EntityMetadata.IsConnectionsEnabled per abilitare la creazione di record della connessione per associare questa entità con altre entità di connessione. |
Code |
Utilizzare la proprietà EntityMetadata.IsValidForQueue per aggiungere il supporto per le code. Quando viene abilitata questa opzione, è anche possibile impostare la proprietà EntityMetadata.AutoRouteToOwnerQueue per spostare automaticamente i record nella coda predefinita del proprietario quando un record di questo tipo viene creato o assegnato. |
Impostare la proprietà EntityMetadata.IsActivityParty in modo da poter inviare messaggi di posta elettronica a un indirizzo di posta elettronica in questo tipo di record. |
Proprietà dell'entità modificabili
Nella tabella seguente sono elencate le proprietà dell'entità che è possibile modificare. A meno che una proprietà gestita non consenta queste opzioni, è possibile aggiornarle in qualsiasi momento.
Per abilitare o disabilitare la capacità degli utenti di Microsoft Dynamics 365 per Outlook di visualizzare i dati per l'entità utilizzare il riquadro di lettura di Microsoft Outlook. È necessario impostare questa proprietà nell'applicazione.
Proprietà |
Descrizione |
|---|---|
Consenti creazione rapida |
Utilizzare EntityMetadata.IsQuickCreateEnabled per abilitare i moduli di creazione rapida per l'entità. Prima di poter utilizzare i moduli di creazione rapida, è necessario creare e pubblicare un modulo di creazione rapida. Nota Le entità Impegno non supportano i moduli di creazione rapida. |
Team di accesso |
Utilizzare EntityMetadata.AutoCreateAccessTeams per abilitare l'entità per i team di accesso. Per ulteriori informazioni, vedere Guida e formazione: Informazioni sui modelli di team. |
Immagine primaria |
Se un'entità presenta un attributo di immagine è possibile abilitare o disabilitare la visualizzazione dell'immagine nell'applicazione utilizzando PrimaryImageAttribute. Per ulteriori informazioni, vedere 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages. |
Modifica testo visualizzato |
La proprietà gestita EntityMetadata.IsRenameable impedisce che il nome visualizzato venga modificato nell'applicazione. È comunque possibile modificare le etichette a livello di programmazione aggiornando le proprietà EntityMetadata.DisplayName e EntityMetadata.DisplayCollectionName. |
Modificare la descrizione delle entità |
La proprietà gestita EntityMetadata.IsRenameable impedisce che la descrizione dell'entità venga modificata nell'applicazione. È comunque possibile modificare le etichette a livello di programmazione aggiornando le proprietà EntityMetadata.Description. |
Abilitare per l'utilizzo in modalità offline |
Utilizzare EntityMetadata.IsAvailableOffline per abilitare o disabilitare la capacità degli utenti di Microsoft Dynamics 365 per Microsoft Office Outlook con accesso offline di ottenere i dati per l'entità in modalità offline. |
Abilitare il riquadro di lettura di Outlook |
Nota La proprietà EntityMetadata.IsReadingPaneEnabled è Solo per uso interno. |
Abilitare stampa unione |
Utilizzare EntityMetadata.IsMailMergeEnabled per abilitare o disabilitare la possibilità di generare documenti uniti di Microsoft Office Word che utilizzano i dati dell'entità. |
Abilita rilevamento duplicati |
Utilizzare EntityMetadata.IsDuplicateDetectionEnabled per abilitare o disabilitare il rilevamento duplicati per l'entità. Per ulteriori informazioni, vedere Rilevare dati duplicati. |
Abilitare l'integrazione SharePoint |
Utilizzare EntityMetadata.IsDocumentManagementEnabled per abilitare o disabilitare l'integrazione di SharePoint Server per l'entità. Per ulteriori informazioni, vedere Abilitare la gestione dei documenti per le entità. |
Abilitare Dynamics 365 per smartphone |
Utilizzare EntityMetadata.IsVisibleInMobile per abilitare o disabilitare la capacità degli utenti di Microsoft Dynamics 365 per telefoni di visualizzare i dati per l'entità. |
Dynamics 365 per tablet |
Utilizzare EntityMetadata.IsVisibleInMobileClient per abilitare o disabilitare la capacità degli utenti di Microsoft Dynamics 365 per tablet di visualizzare i dati per l'entità. Se l'entità è disponibile per Dynamics 365 per tablet è possibile utilizzare EntityMetadata.IsReadOnlyInMobileClient per specificare che i dati del record sono in modalità di sola lettura. |
Abilita controllo |
Utilizzare EntityMetadata.IsAuditEnabled per abilitare o disabilitare il controllo per l'entità. Per ulteriori informazioni, vedere Configurare le entità e gli attributi per il controllo. |
Modifica le aree in cui viene visualizzata l'entità |
È possibile controllare dove sono visualizzate le griglie dell'entità nel riquadro di spostamento dell'applicazione. Ciò è controllato dalla mappa del sito. Per ulteriori informazioni, vedere Modificare la mappa del sito. |
Aggiungi o Rimuovi attributi |
Se la proprietà gestita EntityMetadata.CanCreateAttributes consente la creazione di attributi, è possibile utilizzare il messaggio CreateAttributeRequest per aggiungere gli attributi. Per ulteriori informazioni, vedere Personalizzare i metadati degli attributi di entità. |
Aggiungere o rimuovere visualizzazioni |
Se la proprietà gestita EntityMetadata.CanCreateViews consente di creare visualizzazioni, è possibile utilizzare l'entità SavedQuery per creare visualizzazioni per un'entità. |
Aggiungere o rimuovere grafici |
Se la proprietà gestita EntityMetadata.CanCreateCharts consente di creare grafici la proprietà dell'entità EntityMetadata.IsEnabledForCharts è true, è possibile utilizzare SavedQueryVisualization per creare grafici per un'entità. Per ulteriori informazioni, vedere Visualizzare dati con visualizzazioni (grafici). |
Aggiungere o rimuovere relazioni di entità |
Esistono varie proprietà gestite che controllano i tipi di relazioni di entità che è possibile creare per un'entità. Per ulteriori informazioni, vedere Personalizzare i metadati delle relazioni di entità. |
Modificare le icone |
È possibile modificare le icone utilizzate per le entità personalizzate. Per ulteriori informazioni, vedere Modificare le icone per un'entità. |
Utilizzare la Guida personalizzata |
EntityMetadata.EntityHelpUrlEnabled controlla se la guida personalizzata è abilitata per l'entità.Ulteriori informazioni:Aggiungere il contenuto personalizzato della guida. |
URL della Guida |
EntityMetadata.EntityHelpUrl controlla quali risorse sono visualizzate per il contenuto della guida dell'entità se la guida personalizzata è abilitata.Ulteriori informazioni:Aggiungere il contenuto personalizzato della guida. |
Puoi modificare la relazione gerarchica |
EntityMetadata.CanChangeHierarchicalRelationship controlla se lo stato gerarchico di relazioni di entità incluso nelle soluzioni gestite può essere modificato.Ulteriori informazioni: |
Messaggi dei metadati delle entità
Nella tabella seguente sono elencati i messaggi che è possibile utilizzare per creare, recuperare, aggiornare e rimuovere i metadati delle entità.
Nome messaggio |
Descrizione |
|---|---|
Creare un'entità personalizzata. |
|
Elimina un'entità personalizzata. |
|
Recupera i metadati per tutte le entità. |
|
Recupera i metadati per un'entità. |
|
Aggiorna metadati per un'entità. |
|
Utilizzato insieme agli oggetti nello spazio dei nomi Microsoft.Xrm.Sdk.Metadata.Query per creare una query per recuperare e rilevare in modo efficiente le modifiche ai metadati specifici.Ulteriori informazioni:Recuperare e rilevare le modifiche apportate ai metadati. |
Messaggi supportati dalle entità personalizzate
Le entità personalizzate supportano gli stessi messaggi di base delle entità di sistema. Il set di messaggi disponibili cambia a seconda che l'entità personalizzata sia di proprietà dell'utente o dell'organizzazione. Per ulteriori informazioni, vedere 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords.
Vedere anche
Utilizzare il servizio Organizzazione con i metadati di Dynamics 365
Introduzione alle entità in Microsoft Dynamics 365
Visualizzazione dei metadati per l'organizzazione
Personalizzare i metadati degli attributi di entità
Personalizzare i metadati delle relazioni di entità
Rilevare dati duplicati
Abilitare la gestione dei documenti per le entità
Configurare le entità e gli attributi per il controllo
Modificare la mappa del sito
Visualizzare dati con visualizzazioni (grafici)
Quali entità sono personalizzabili?
Creare un'entità personalizzata
Recuperare, aggiornare ed eliminare entità.
Creare e aggiornare un'entità che è possibile inviare per posta elettronica
Creare un'entità di tipo impegno personalizzata
Modificare le icone per un'entità
Modificare i messaggi per un'entità
Esempio: creare e aggiornare i metadati di un'entità
Esempio: creare un'entità attività personalizzata
Esempio: creare e aggiornare un'entità che supporta il servizio e-mail
Esempio: eseguire il dump dei metadati in un file
Esempio: informazioni sui privilegi di un'entità dump in un file
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright