Présentation des entités dans Microsoft Dynamics CRM 2015

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Les entités permettent de modéliser et gérer les données commerciales dans Microsoft Dynamics 365. Par exemple, les entités telles que compte, campagne et incident peuvent servir à tracer et à soutenir les activités de vente, de marketing et de service. Une entité possède un ensemble d’attributs et chaque attribut représente un élément de données d’un type particulier. Par exemple, l’entité de compte possède les attributs Name, Address et OwnerId. Conceptuellement, une entité ressemble à une table de base de données et les attributs d’entité correspondent aux colonnes de la table. La création d'un enregistrement d'entité (ou, plus simplement, un enregistrement) dans Microsoft Dynamics 365 est semblable à l'ajout d'une ligne dans une table de base de données. Les entités sont divisées en trois catégories : système, entreprise et personnalisé. En tant que développeur utilisant des données commerciales, vous allez utiliser les entités commerciales et les entités personnalisées. Les entités système sont utilisées par Microsoft Dynamics 365 pour gérer tous les processus internes, tels que les workflows et les tâches asynchrones. Vous ne pouvez pas supprimer ou personnaliser les entités système.

Les entités métier font partie de l’installation par défaut de Microsoft Dynamics 365 et apparaissent dans l’interface utilisateur de personnalisation. Un compte, un contact et une lettre sont des exemples d’entités commerciales. Après l’installation, vous pouvez ajouter des entités personnalisées à Microsoft Dynamics 365 pour répondre aux besoins professionnels spécifiques de l’organisation. Dans une solutionMicrosoft Dynamics 365, vous pouvez définir des entités commerciales et des entités personnalisées, ainsi que des attributs, comme personnalisables ou non personnalisables. Vous pouvez modifier une entité personnalisable en la renommant, en ajoutant de nouveaux attributs ou en modifiant différents paramètres, tels que la détection des doublons ou les paramètres de prise en charge de la file d’attente. Vous ne pouvez pas modifier une entité non personnalisable. Pour plus d’informations sur la personnalisation, les solutions gérées et non gérées, et les propriétés gérées, consultez Empaqueter et distribuer les extensions à l’aide des solutions.

Si vous utilisez le modèle de programmation à liaison anticipée, une entité est représentée par une classe, telle que la classe Account qui représente l’entité compte. Les attributs d’entité sont représentés par des propriétés de classe. Cette classe est générée par l’outil CrmSvcUtil. Pour plus d'informations, voir Utiliser les classes d’entité à liaison anticipée dans le code. Autre solution, vous pouvez écrire les programmes qui fonctionnent avec les données d’entité à l’aide d’une approche dynamique. Pour plus d'informations, voir Utiliser la classe d’entité à liaison tardive dans le code.

Contenu de la rubrique

Métadonnées de l’entité

Actions sur les enregistrements d’entité

Propriété de l'entité

État et statut d’enregistrement

Images d'entité

Métadonnées de l’entité

Les métadonnées d’une organisation Microsoft Dynamics 365 contiennent les définitions des entités, des attributs et des relations entre les entités. Pour plus d'informations, voir Métadonnées et modèles de données dans Microsoft Dynamics CRM 2015. En tant que développeur, il existe de nombreux cas où il est utile de pouvoir trouver toutes les métadonnées d’une organisation. Il existe un certain nombre de façons dont vous pouvez rechercher et référencer les métadonnées :

• Vous pouvez utiliser le navigateur de métadonnées d'entité pour générer les entités et leurs propriétés dans Microsoft Dynamics 365. Pour plus d’informations, consultez Parcourir les métadonnées de votre organisation.

• Le package SDK contient ces mêmes informations dans une feuille de calcul Microsoft Office Excel. Vous les trouverez dans le fichier SDK\Tools\EntityMetadata.xlsx.

• Vous pouvez générer les métadonnées de votre organisation à l’aide de ces exemples :

  • Exemple : Vider les métadonnées d’entité dans un fichier

  • Exemple : Vider les informations de privilège d’entité dans un fichier

  • Exemple : Vidage des métadonnées d’attribut dans un fichier

  • Exemple : Vidage des informations de relation d’entité dans un fichier

  • Exemple : vider les informations d’un groupe d’options général dans un fichier

Vous pouvez créer les types de relations suivants entre les entités : un-à-plusieurs, plusieurs-à-un, et plusieurs-à-plusieurs. Les enregistrements pour les relations plusieurs-à-plusieurs sont stockés dans une entité d’intersection. Une fois les relations sont définies, utilisez le message AssociateRequest ou la méthode Associate pour créer un lien entre les enregistrements spécifiés et utilisez le message DisassociateRequest ou la méthode Disassociate pour supprimer un lien entre les enregistrements spécifiés.

Dans les relations un-à-plusieurs et plusieurs-à-un, certaines actions sur l’enregistrement de l’entité parente affectent les enregistrements de l’entité enfant. Les actions qui ont un comportement en cascade sont les suivantes : Attribuer, Supprimer, Fusionner, Partager, Annuler le partage et Redéfinir la parenté. Pour plus d'informations, voir Comportement des relations d’entité.

Noms utilisés dans les métadonnées de l’entité

Les entités, les attributs et les relations ont différents noms. Le tableau suivant répertorie les différents noms utilisés dans les métadonnées.

Actions sur les enregistrements d’entité

Chaque entité prend en charge plusieurs actions, par exemple créer ou supprimer un enregistrement, ou attribuer un enregistrement à un autre utilisateur ou à une autre équipe. Certaines actions ne sont pas autorisées sur tous les types d’entités ou attributs. Pour chaque attribut, les métadonnées déterminent si une action donnée est prise en charge. Par exemple, les propriétés d’un attribut, comme IsValidForCreate, IsValidForRead et IsValidForUpdate, vous indiquent si vous pouvez créer, récupérer ou mettre à jour l’attribut.Pour plus d'informations :Opérations valides sur les attributs.

Pour exécuter une action, vous pouvez appeler l’une des méthodes de IOrganizationService. Par exemple, pour créer un enregistrement dans Microsoft Dynamics 365, vous pouvez utiliser la méthode IOrganizationService.Create ou la méthode IOrganizationService.Execute avec le message CreateRequest correspondant. Vous devez disposer des privilèges et des droits d’accès nécessaires pour effectuer ces actions. Pour plus d'informations, voir Modèle de sécurité de Microsoft Dynamics CRM 2015.

Le tableau suivant répertorie les actions qui sont autorisés sur les enregistrements d’entreprise et d’entité personnalisée, ainsi que les méthodes et les messages qui vous permettent d’exécuter ces actions.

Créer

Pour effectuer cette action, l’appelant doit avoir Create message privileges. Les droits d’accès ne s’appliquent pas à une action de création, mais s’appliquent à l’enregistrement une fois créé.

Pour posséder un enregistrement ou pour récupérer l’enregistrement nouvellement créé, l’utilisateur ou l’équipe doit également disposer des privilèges de lecture et des droits d’accès sur le nouvel enregistrement. Par exemple, si vous avez les privilèges de création pour les comptes, vous pouvez créer un enregistrement de compte et l’attribuer à un autre utilisateur ou à une autre équipe. Toutefois, sauf si vous avez également le privilège de lecture pour les comptes et les droits d’accès sur le nouvel enregistrement, vous ne pouvez pas créer un compte et être le propriétaire de ce nouveau compte.

Mise à jour

Pour effectuer cette action, l’appelant doit avoir les Update message privileges et les droits d’accès sur les enregistrements d’entité mis à jour.

Lorsque vous mettez à jour un enregistrement, seuls les attributs dont vous spécifiez les données ou pour lesquels vous spécifiez la valeur null sont mises à jour. Toutes les autres valeurs restent les mêmes. En outre, si vous spécifiez des données pour les attributs non valides pour la mise à jour, elles sont ignorées.

Supprimer

Pour effectuer cette action, l’appelant doit avoir les Delete message privileges et les droits d’accès sur les enregistrements d’entité en cours de suppression.

Les règles en cascade déterminent si les enregistrements associés sont supprimés en même temps. Pour plus d'informations, voir Comportement des relations d’entité.

En règle générale, vous devez uniquement supprimer les enregistrements que vous avez entrés par erreur. Pour certains types d’enregistrements, vous pouvez, à la place, désactiver ou fermer l’enregistrement. Tous les types d'enregistrements ne peuvent pas être supprimés.

Récupérer

Pour effectuer cette action, l’appelant doit avoir les Retrieve message privileges et les droits d’accès sur les enregistrements d’entité récupérés.

Récupération multiple

Pour effectuer cette action, l’appelant doit avoir les Retrieve message privileges et les droits d’accès sur les enregistrements d’entité récupérés.

Pour récupérer une collection d’enregistrements basée sur les paramètres de la requête, vous pouvez utiliser une expression de requête ou le langage de requête FetchXML. Les expressions de requête vous permettent de créer une arborescence de requête en utilisant une hiérarchie de classe. Les méthodes qui utilisent une expression de requête retournent une collection d’enregistrements fortement typés. FetchXML vous permet de créer une requête à l’aide du langage XML. FetchXML renvoie une chaîne XML. Par conséquent, une manipulation supplémentaire des données est nécessaire pour utiliser les résultats de la requête. Pour plus d'informations, voir Récupérer les données avec des requêtes.

Attribuer

Pour les entités appartenant à l’utilisateur ou à l’équipe, vous attribuez un enregistrement à un nouveau propriétaire. Pour plus d'informations, voir Propriété de l'entité. Pour effectuer cette action, l’appelant doit avoir les Assign message privileges et les droits d’accès sur les enregistrements d’entité.

Les règles en cascade déterminent si les enregistrements associés sont attribués en même temps à un autre utilisateur. Pour plus d'informations, voir Comportement des relations d’entité.

Lorsqu’un enregistrement est attribué à un utilisateur ou à une autre équipe, le propriétaire précédent a toujours accès à cet enregistrement si l’attribut ShareToPreviousOwnerOnAssign est défini sur true. Toutefois, le propriétaire précédent n’aura plus la propriété de l’enregistrement.

Partager

Pour les entités appartenant à l’utilisateur ou à l’équipe, vous pouvez partager un enregistrement avec d’autres utilisateurs ou équipes. Pour effectuer cette action, l’appelant doit avoir les GrantAccess message privileges, les ModifyAccess message privileges et les RevokeAccess message privileges, ainsi que les droits d’accès sur les enregistrements d’entité.

Les règles en cascade déterminent si les enregistrements associés sont partagés en même temps. Pour plus d'informations, consultez la rubrique Comportement des relations d’entité.

Le partage est la façon dont les utilisateurs Microsoft Dynamics 365 peuvent fournir à d’autres utilisateurs un accès aux informations concernant les clients si nécessaire. Par exemple, un commercial peut décider de partager une opportunité avec un autre commercial pour pouvoir suivre l’avancement d’une vente importante.

Utilisez le message GrantAccessRequest pour partager un enregistrement. Utilisez le message ModifyAccessRequest pour modifier la façon dont un enregistrement est partagé. Utilisez le message RevokeAccessRequest pour supprimer tout partage de l’enregistrement.

Un utilisateur doit disposer de droits de partage pour partager les enregistrements liés au client, tels que les contacts, comptes, opportunités, incidents et commandes, avec n’importe quel autre utilisateur de Microsoft Dynamics 365. Lorsqu’un enregistrement est partagé, vous pouvez spécifier les droits à accorder pour l’enregistrement partagé.

La liste suivante décrit les règles de partage des enregistrements :

• Toute personne titulaire des privilèges de partage sur un enregistrement peut le partager avec d’autres utilisateurs ou équipes.

• Toute personne titulaire des privilèges de partage sur un enregistrement peut définir des droits d’accès pour cet enregistrement. Ces droits d’accès déterminent la façon dont une personne qui partage un enregistrement peut accéder à cet enregistrement.

• L’accès sur un enregistrement partagé peut être défini sur n’importe quel droit d’accès, par exemple, en lecture ou écriture.

• Les droits d’accès sur un enregistrement partagé peuvent être différents pour chaque utilisateur avec lequel l’enregistrement est partagé.

• Un enregistrement ne peut être partagé par le même principal de sécurité qu’une seule fois. Un utilisateur peut partager un enregistrement s’il a des privilèges de partage sur cet enregistrement.

• Toute personne titulaire des privilèges de partage sur un enregistrement commercial peut modifier les droits d’accès pour les utilisateurs qui partagent l’enregistrement.

• Toute personne titulaire des privilèges de partage sur un enregistrement commercial peut supprimer le partage d’un utilisateur spécifié qui partage l’enregistrement.

• Toute personne titulaire des privilèges de partage sur un enregistrement commercial peut supprimer tous les utilisateurs qui partageaient préalablement l’enregistrement.

Associer

Pour effectuer cette action, l’appelant doit avoir les Associate message privileges et les droits d’accès sur les enregistrements mis à jour.

La méthode Associate crée plusieurs associations dans une transaction entre l’enregistrement spécifié et chaque enregistrement de la collection spécifiée pour la relation spécifiée.

Pour un relation de type un-à-plusieurs, cette méthode définit ReferencingAttribute dans l’enregistrement associé à l’ID d’enregistrement spécifié.

Pour un relation de type plusieurs-à-plusieurs, cette méthode crée un enregistrement dans la table d’intersection de la relation, contenant l’ID de l’enregistrement référencé et les enregistrements de référencement. Le nom de la table d’intersection est défini dans la propriété IntersectEntityName de la relation.

Dissocier

Pour effectuer cette action, l’appelant doit avoir les Disassociate message privileges et les droits d’accès sur les enregistrements mis à jour.

La méthode Disassociate inverse l’opération Associate, en mettant à jour les enregistrements référencés et les enregistrements de référencement, et en supprimant l’enregistrement d’intersection le cas échéant. Pour plus d'informations, voir Associer.

Définir l’état

Pour effectuer cette action, l’appelant doit avoir les SetState message privileges et les droits d’accès sur les enregistrements mis à jour. Le message SetStateRequest met à jour les attributs StateCode et StatusCode de l’enregistrement d’entité.

Propriété de l'entité

Il existe plusieurs types de propriété d’entité. La plupart des entités, notamment les entités personnalisées, appartiennent à l’organisation, à un utilisateur ou à une équipe. Certaines entités métier n’ont pas de propriétaire, comme le type de remise (liste de remises), où la propriété est définie par la remise de son entité parente. Le type de propriété définit certaines opérations qui peuvent être effectuées sur un enregistrement. La propriété d’une entité est définie dans la propriété OwnershipType des métadonnées. Le tableau suivant répertorie les propriétés de propriété.

Informations supplémentaires sur la propriété d’un utilisateur ou d’une équipe

Vous pouvez utiliser le message AssignRequest pour modifier la propriété d’un enregistrement. Pour plus d'informations, voir Attribuer. Vous pouvez utiliser le message ReassignObjectsOwnerRequest ou le message ReassignObjectsSystemUserRequest pour exécuter la réaffectation de tous les enregistrements d’un propriétaire.

État et statut d’enregistrement

La plupart des entités commerciales ont deux propriétés pour suivre l’état d’un enregistrement. Ce sont StateCode, appelée Statut dans l’application Web, et StatusCode, appelée Raison du statut dans l’application Web. Les valeurs des attributs StateCode et StatusCode sont liées. L’attribut StateCode est utilisé en interne pour représenter le statut de l’entité. L’attribut StatusCode est utilisé pour afficher cette valeur à l’utilisateur final. L’ensemble des codes d’état valides pour une entité n’est pas personnalisable, mais les codes de statut le sont. Pour l'entité incident et les entités personnalisées, vous pouvez définir des critères supplémentaires pour les transitions valides entre les statuts. Pour plus d'informations, consultez les rubriques Personnaliser les métadonnées d’attribut d’entité et Définir les transitions de modèles d’état personnalisés.

Images d'entité

Certaines entités système possèdent des attributs d’image. Vous pouvez ajouter des attributs d’image à des entités personnalisées. Lorsqu’une entité a un attribut d’image, vous pouvez définir la propriété d’PrimaryImageAttribute pour contrôler si l’image apparaît dans l’application. Lorsque l’image apparaît dans l’application, les utilisateurs de l’application Web peuvent télécharger des images pour l’enregistrement d’entité. Les entités système suivantes ont des attributs d’image. Celles signalées par un astérisque sont activées par défaut pour s’afficher dans l’application.

Pour plus d'informations :Attributs des données d'image.

Voir aussi

Entités d’administration et de sécurité
Utiliser les métadonnées pour générer des diagrammes d’entités
Définir les transitions de modèles d’état personnalisés
Clé des diagrammes d’entité
Modeler vos données d'entreprise
Personnaliser des métadonnées de relation d’entité
Comportement des relations d’entité
Métadonnées et modèles de données dans Microsoft Dynamics CRM 2015
Étendre le modèle de métadonnées
Empaqueter et distribuer les extensions à l’aide des solutions
Entités IOrganizationService
Modèle de sécurité de Microsoft Dynamics CRM 2015
Exemple : Définir et récupérer des images d’entité
Exemple : Attribuer un enregistrement à une équipe
Exemple : partager des enregistrements à l’aide des messages GrantAccess, ModifyAccess et RevokeAccess
Exemple : Fusionner deux enregistrements
Exemple : valider l’état d’enregistrement et définir l’état de l’enregistrement
Exemple : Regrouper les enregistrements relatifs à un enregistrement spécifique

© 2017 Microsoft. Tous droits réservés. Copyright