Condividi tramite


Informazioni di riferimento su tabella/entità di Dataverse

Usare questo riferimento per comprendere le operazioni disponibili che possono essere eseguite per tabelle specifiche, le colonne predefinite di ogni tabella e le relazioni tra le tabelle.

Questo riferimento include solo le tabelle in cui:

  • IsPrivate è uguale a false

    • Sono escluse le tabelle in cui non esistono casi d'uso esterni.
  • IsIntersect è uguale a false o IsIntersect è uguale a true e la tabella contiene più di 4 colonne.

    • La maggior parte delle tabelle di intersezione contiene solo le 4 colonne necessarie per supportare la relazione molti-a-molti. Non si tratta di valori garantiti. Le tabelle Intersecazione con più di quattro colonne sono 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. Queste tabelle sono incluse nel riferimento alla tabella/entità app abilitate per Dynamics 365.

Ognuno dei prodotti Dynamics 365 specifici 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à. Sono incluse solo le proprietà che si prevede siano più utili per gli sviluppatori. Alcuni valori delle proprietà dell'entità possono essere modificati.

Colonne

Le colonne sono elencate in due sezioni separate: colonne/attributi scrivibili e colonne/attributi di sola lettura. Lo scopo di questa separazione è quello di concentrarsi sulle colonne che uno sviluppatore può impostare durante la creazione o l'aggiornamento delle righe in una tabella. La comprensione di queste colonne consente a uno sviluppatore di capire cosa può fare con la tabella oltre al semplice recupero dei valori.

Le colonne nella sezione Colonne/attributi scrivibili restituiscono true per le proprietà IsValidForCreate o IsValidForUpdate (in genere entrambe). Viene indicato se una di queste proprietà restituisce false.

Le colonne/gli attributi di sola lettura restituiscono sempre false per le proprietà IsValidForCreateeIsValidForUpdate .

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 si allineano più strettamente alle opzioni che meglio si adattano alla lingua o alla cultura. Sei libero di personalizzare queste opzioni modificando le etichette o aggiungendo e rimuovendo opzioni secondo necessità.

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

È importante tenere presente che, sebbene ogni tabella elenchi le relazioni che si applicano, ogni relazione è 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 proprietà OneToManyRelationship:

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 I dati che descrivono le operazioni eseguite sull'entità padre verranno propagati alle entità correlate.
Ulteriori informazioni: Configurazione a cascata

Relazioni uno-a-molti

Include queste proprietà OneToManyRelationship:

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 Se le proprietà della relazione possono essere modificate.
ReferencedEntityNavigationPropertyName Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione.
Ulteriori informazioni: 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 seguenti proprietà:

Proprietà Description
IntersectEntityName Nome logico della tabella intersect che supporta questa relazione molti-a-molti
IsCustomizable Se le proprietà della relazione possono essere modificate.
SchemaName Nome dello schema della relazione.
IntersectAttribute Nome della colonna nella tabella di intersezione che rappresenta la chiave primaria per i record di questo tipo.
NavigationPropertyName Nome della proprietà di navigazione con valori di raccolta dell'API Web per questa relazione.
Ulteriori informazioni: Proprietà di navigazione dell'API Web
AssociatedMenuConfiguration 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 da questa tabella come seconda tabella