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

  • Cela exclut les tables où aucun cas d’utilisation externe n’existe. En savoir plus sur les tables privées

• 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 :

• Référence de l’action de l’API web
• Référence de la fonction de l’API web

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 :

• Utilisez le connecteur Power Automate Dataverse à l’aide du déclencheur Lorsqu’une action est exécutée.
• Enregistrez un plug-in Dataverse pour répondre à l’événement.
• Envoyer les données d’événement à Azure ou à un webhook avec l’intégration Dataverse Azure

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 :

Relations plusieurs-à-un

Inclut ces propriétés OneToManyRelationship :

Relations 1 à N (un-à-plusieurs)

Inclut ces propriétés OneToManyRelationship :

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 :

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é.