Partager via


Référence de table/d’entité Dynamics 365 Sales

Les tables Dataverse fournissent l’ensemble commun de tables à toutes les bases de données d’environnement.

La référence d’entité/de table des applications activées Dynamics 365 contient les tables supplémentaires requises pour que vous puissiez installer des applications Dynamics 365 telles que Sales.

Les tables répertoriées ici sont ajoutées ou modifiées lorsque vous choisissez d’installer Dynamics 365 Sales pendant que vous ajoutez Dataverse à un environnement que vous créez.

Cette référence inclut uniquement ces tables où :

  • IsPrivate a la valeur false

  • IsIntersect équivaut à false ou IsIntersect équivaut à true et la table contient plus de 4 colonnes.

    • La plupart des tables d’intersection ne contiennent que les 4 colonnes nécessaires pour prendre en charge la relation plusieurs-à-plusieurs. Elles ne sont pas utiles. Les tables d’intersection avec plus de quatre colonnes sont plus intéressantes.

Messages

Les messages de cette liste s’appliquent à l’entité. Par exemple, les tables appartenant à l’utilisateur prennent en charge les messages Assign, GrantAccess, ModifyAccess et RevokeAccess, contrairement aux tables appartenant à l’organisation.

Kit de développement logiciel (SDK) pour .NET

Lors de l’utilisation du Kit de développement logiciel (SDK) pour .NET, vous pouvez généralement appeler la classe de demande correspondante qui appartient aux espaces de noms Microsoft.Crm.Sdk.Messages ou Microsoft.Xrm.Sdk.Messages. Ces classes ont des noms avec le préfixe Request ajouté au nom du message.

Certains messages sont ajoutés comme actions personnalisées pour les solutions qu’ils prennent en charge. Ces messages ne sont pas définis dans les assemblys du kit de développement logiciel, mais il existe plusieurs façons de les utiliser.

API Web

Lorsque vous utilisez l’API web, vous pouvez trouver les fonctions et actions OData Dataverse communes définies dans ces références :

Pour ces fonctions et actions, ainsi que pour toute autre fonction ajoutée, vous pouvez découvrir comment les utiliser en procédant comme suit :

  1. Examinez le document de service $metadata pour plus de détails sur les paramètres et les valeurs de retour. Voir Définitions d’action et Définitions de fonction pour en savoir plus.
  2. Invoquez les actions et les fonctions. Voir Utiliser les actions de l’API web et Utiliser les fonctions de l’API web pour en savoir plus.

Événements 

Les événements sont des messages qui existent pour que vous puissiez vous y abonner. À moins que vous n’ayez ajouté l’événement, vous ne devez pas invoquer le message, mais seulement vous y abonner. Vous pouvez vous abonner à des événements de différentes manières, par exemple :

Propriétés

Cette section contient certaines propriétés d’entité, mais pas toutes. Seules les propriétés censées être les plus utiles pour les développeurs sont incluses. Certaines valeurs des propriétés d’entité peuvent être modifiées.

Colonnes

Les colonnes sont répertoriées dans deux sections distinctes : Colonnes/Attributs accessibles en écriture et Colonnes/Attributs en lecture seule. L’objectif de cette séparation est de vous concentrer sur les colonnes qu’un développeur peut définir lorsqu’il crée ou met à jour des lignes dans une table. Connaître ces colonnes permet à un développeur de savoir ce qu’il peut faire avec la table au-delà de la simple récupération des valeurs.

Les colonnes de la section Colonnes/Attributs accessibles en écriture renvoient la valeur true pour soit les propriétés IsValidForCreate ou IsValidForUpdate, (généralement les deux). Si l’une de ces propriétés renvoient la valeur false, cela est indiqué.

Les Colonnes/Attributs en lecture seule renvoient toujours la valeur false pour les propriétés IsValidForCreate et IsValidForUpdate.

Les options de colonne de choix de cette documentation de référence proviennent d’un déploiement où l’anglais est la langue de base. Certaines options de choix peuvent varier en fonction de la langue de base sélectionnée lors de la création de l’environnement. Ces différences s’alignent davantage sur les options qui conviennent le mieux à la langue ou à la culture. Vous êtes libre de personnaliser ces options en modifiant les étiquettes ou en ajoutant et en supprimant des options selon vos besoins.

Relations

La classe EntityMetadata compte trois propriétés pour représenter les relations :

Propriété Type Description
OneToManyRelationships OneToManyRelationshipMetadata[] Obtient le tableau des relations un-à-plusieurs pour l’entité.
ManyToOneRelationships OneToManyRelationshipMetadata[] Obtient le tableau des relations plusieurs-à-un pour l’entité.
ManyToManyRelationships ManyToManyRelationshipMetadata[] Obtient le tableau des relations plusieurs-à-plusieurs pour l’entité.

Note

Il est important de garder à l’esprit que chaque table répertorie les relations qui lui sont appliquées, mais chaque relation est partagée par les deux tables associées. Les relations existent entre les tables. Les relations un-à-plusieurs existent, mais les relations plusieurs-à-un sont une simple vue des relations un-à-plusieurs à partir de la table de référencement.

Relations plusieurs-à-un

Inclut ces propriétés OneToManyRelationship :

Propriété Description
ReferencedEntity Le nom logique de la table associée.
ReferencedAttribute Nom logique de clé principale de la table associée.
ReferencingEntity Nom de la logique de la table associée à qui appartient la colonne de recherche.
ReferencingAttribute Le nom logique de la colonne de recherche dans la table associée qui contient une référence à la clé primaire de la table primaire.
IsHierarchical Indique si les relations représentent une relation hiérarchique auto-référentielle
CascadeConfiguration Les données qui décrivent les opérations effectuées sur l’entité parente sont mises en cascade vers les entités associées.
Pour plus d’informations : Configuration en cascade

Relations 1 à N (un-à-plusieurs)

Inclut ces propriétés OneToManyRelationship :

Propriété Description
ReferencingEntity Le nom logique de la table associée.
ReferencingAttribute Le nom logique de la colonne dans la table associée qui contient une référence à la clé primaire de la table primaire.
IsCustomizable Indique si les propriétés de la relation peuvent être modifiées.
ReferencedEntityNavigationPropertyName Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation.
Informations complémentaires : Propriétés de navigation de l’API web
AssociatedMenuConfiguration Données utilisées par les applications basées sur un modèle pour contrôler si et comment les données de l’entité associée sont accessibles dans l’interface utilisateur depuis l’entité principale.

Relations plusieurs-à-plusieurs

Chaque relation plusieurs-à-plusieurs inclut Entity1LogicalName et Entity2LogicalName. Pour cette documentation, les détails de la relation sont fournis dans le contexte de la table actuelle. Que ce soit Entity1 ou Entity2 n’est pas vraiment important.

Pour chaque relation plusieurs-à-plusieurs, les propriétés suivantes sont incluses :

Propriété Description
IntersectEntityName Le nom logique de la table d’intersection qui prend en charge cette relation plusieurs-à-plusieurs.
Vous pouvez utiliser cette valeur lorsque vous joignez des colonnes de table à l’aide de FetchXml
IsCustomizable Indique si les propriétés de la relation peuvent être modifiées.
SchemaName Le nom du schéma de la relation.
IntersectAttribute Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type.
NavigationPropertyName Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation.
Informations complémentaires : Propriétés de navigation de l’API web
AssociatedMenuConfiguration Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la deuxième table sont accessibles dans l’interface utilisateur à partir de cette table.

Dans les rares cas où une relation plusieurs-à-plusieurs est auto-référencée, comme pour le rôle de connexion (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 est préfixée à la propriété.

Propriété Valeur
Entity1IntersectAttribute Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type en tant que première table.
Entity2IntersectAttribute Le nom de la colonne dans la table d’intersection qui est la clé primaire pour les enregistrements de ce type en tant que deuxième table.
Entity1NavigationPropertyName Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation en tant que première table.
Entity2NavigationPropertyName Nom de la propriété de navigation avec une valeur de collection prise en charge par l’API web pour cette relation en tant que seconde table.
Entity1AssociatedMenuConfiguration Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la seconde table sont accessibles dans l’interface utilisateur à partir de cette table en tant que première table.
Entity2AssociatedMenuConfiguration Données utilisées par les applications pilotées par modèle pour contrôler si et comment les données de la seconde table sont accessibles dans l’interface utilisateur à partir de cette table en tant que deuxième table