Informazioni di riferimento su tabella/entità di Dataverse

Usare questo riferimento per comprendere le operazioni disponibili per tabelle specifiche, le colonne predefinite di ogni tabella e le relazioni tra le tabelle. Le definizioni di tabella usano la classe EntityMetadata.

Questo riferimento include solo le tabelle in cui:

  • EntityMetadata.IsPrivate Uguale false

    Questa condizione esclude le tabelle senza casi d'uso esterni.

  • EntityMetadata.IsIntersect false uguale a o IsIntersect uguale true a e la tabella contiene più di quattro colonne.

    La maggior parte delle tabelle intersecabili contiene solo le quattro colonne necessarie per supportare la relazione molti-a-molti. Non sono utili. Intersecare le tabelle con più di quattro colonne non sono comuni e più interessanti.

Per visualizzare informazioni su tutte le tabelle nell'ambiente in uso, vedere Esplorare le definizioni delle tabelle nell'ambiente in uso.

Informazioni di riferimento sulla tabella dei prodotti Dynamics 365

I prodotti Dynamics 365 usano Dataverse. Quando si crea un ambiente per i prodotti Dynamics 365, l'ambiente ha un set comune di tabelle per tutti i prodotti Dynamics 365. Vedere le informazioni di riferimento sulla tabella/entità app abilitate Dynamics 365.

Ogni Dynamics 365 prodotto specifico può aggiungere altre tabelle. La tabella seguente illustra le informazioni di riferimento sulla tabella per prodotti Dynamics 365 specifici:

Documentazione del prodotto Tabella dei prodotti di riferimento
Vendite Riferimento alla tabella/entità Sales
Servizio sul campo Riferimento a tabelle/entità di Field Service
Servizio clienti Riferimento a tabelle/entità del servizio clienti

Proprietà

Questa sezione include le proprietà dell'entità selezionate anziché tutte le proprietà. Include solo le proprietà più utili per gli sviluppatori. È possibile modificare alcuni valori delle proprietà dell'entità.

Colonne

Le colonne sono elencate in due sezioni separate:

Sezione Description
Colonne/attributi scrivibili Colonne che è possibile impostare durante la creazione o l'aggiornamento di righe in una tabella. Queste colonne restituiscono true le AttributeMetadata.IsValidForCreate proprietà o AttributeMetadata.IsValidForUpdate , in genere entrambe. Se una delle proprietà restituisce false, questa condizione è indicata.
Colonne/attributi di sola lettura Le colonne che è possibile recuperare ma non possono essere impostate durante la creazione o l'aggiornamento di righe in una tabella. Queste colonne restituiscono false sempre per le AttributeMetadata.IsValidForCreate proprietà e AttributeMetadata.IsValidForUpdate .

Opzioni delle colonne di scelta

Le opzioni della colonna di scelta in questa documentazione di riferimento provengono da una distribuzione in cui l'inglese è la lingua di base. Alcune opzioni di scelta possono variare a seconda della lingua di base selezionata al momento della creazione dell'ambiente. Queste differenze sono più strettamente allineate alle opzioni più adatte alla lingua o alla cultura. È possibile personalizzare queste opzioni modificando le etichette o aggiungendo e rimuovendo le opzioni in base alle esigenze.

Relationships

La classe EntityMetadata include tre proprietà per rappresentare le relazioni:

Proprietà TIPO Description
OneToManyRelationships OneToManyRelationshipMetadata[] Ottiene la matrice di relazioni uno-a-molti per l'entità.
ManyToOneRelationships OneToManyRelationshipMetadata[] Ottiene la matrice di relazioni molti-a-uno per l'entità.
ManyToManyRelationships ManyToManyRelationshipMetadata[] Ottiene la matrice di relazioni molti-a-molti per l'entità.

Annotazioni

Mentre ogni tabella elenca le relazioni applicabili, ogni relazione viene condivisa da entrambe le tabelle. Esistono relazioni tra le tabelle. Sebbene esistano relazioni uno-a-molti, le relazioni molti-a-uno sono semplicemente una visualizzazione di una relazione uno-a-molti dalla tabella di riferimento.

Relazioni molti-a-uno

Include queste OneToManyRelationshipMetadata proprietà della classe :

Proprietà Description
ReferencedEntity Nome logico della relativa tabella.
ReferencedAttribute Nome logico della chiave primaria della relativa tabella.
ReferencingEntity Nome logico della relativa tabella che contiene la colonna di ricerca.
ReferencingAttribute Nome logico della colonna di ricerca nella tabella correlata che contiene un riferimento alla chiave primaria della tabella primaria.
IsHierarchical Se la relazione rappresenta una relazione gerarchica autoreferenziale
CascadeConfiguration Dati che descrivono le operazioni eseguite sulla propagazione dell'entità padre verso il basso alle entità correlate.
Per altre informazioni, vedere Configurazione a catena.

Relazioni uno-a-molti

Include queste OneToManyRelationshipMetadata proprietà della classe :

Proprietà Description
ReferencingEntity Nome logico della relativa tabella.
ReferencingAttribute Nome logico della colonna nella tabella correlata che contiene un riferimento alla chiave primaria della tabella primaria.
IsCustomizable Indica se è possibile modificare le proprietà della relazione.
ReferencedEntityNavigationPropertyName Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione.
Per altre informazioni, vedere Proprietà di navigazione dell'API Web.
AssociatedMenuConfiguration Dati usati dalle app basate su modello per controllare se e come è possibile accedere ai dati dell'entità correlata nell'interfaccia utente dall'entità primaria.

Relazioni molti-a-molti

Ogni relazione molti-a-molti include Entity1LogicalName e Entity2LogicalName. Per questa documentazione, i dettagli delle relazioni vengono forniti nel contesto della tabella corrente. Che sia Entity1 o Entity2 non è importante.

Per ogni relazione molti-a-molti, sono incluse le proprietà della classe seguentiManyToManyRelationshipMetadata:

Proprietà Description
IntersectEntityName Nome logico della tabella di intersezione che supporta questa relazione molti-a-molti.
IsCustomizable Indica se è possibile modificare le proprietà della relazione.
SchemaName Nome dello schema della relazione.
IntersectAttribute (Entity1IntersectAttribute o Entity2IntersectAttribute) Nome della colonna nella tabella di intersezione che rappresenta la chiave primaria per i record di questo tipo.
NavigationPropertyName (Entity1NavigationPropertyName o Entity2NavigationPropertyName) Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione.
Ulteriori informazioni: Proprietà di navigazione dell'API Web
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration o Entity2AssociatedMenuConfiguration) Dati usati dalle app basate su modello per controllare se e come è possibile accedere ai dati della seconda tabella nell'interfaccia utente da questa tabella.

Nel raro caso in cui una relazione molti-a-molti è autoreferenziale, ad esempio per Ruolo di connessione (ConnectionRole) connectionroleassociation_association, Entity1 o Entity2 è anteposta alla proprietà.

Proprietà Value
Entity1IntersectAttribute Nome della colonna nella tabella di intersezione che rappresenta la chiave primaria per i record di questo tipo come prima tabella.
Entity2IntersectAttribute Nome della colonna nella tabella di intersezione che rappresenta la chiave primaria per i record di questo tipo come seconda tabella.
Entity1NavigationPropertyName Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione come prima tabella.
Entity2NavigationPropertyName Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione come seconda tabella.
Entity1AssociatedMenuConfiguration Dati usati dalle app basate su modello per controllare se e come è possibile accedere ai dati della seconda tabella nell'interfaccia utente da questa tabella come prima tabella.
Entity2AssociatedMenuConfiguration Dati usati dalle app basate su modello per controllare se e come è possibile accedere ai dati della seconda tabella nell'interfaccia utente di questa tabella come seconda tabella.