Personnaliser les métadonnées d’entité
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Les entités sont définies par les métadonnées. En définissant ou en modifiant les métadonnées d’entité, vous pouvez contrôler les fonctionnalités d’une entité. Pour afficher les métadonnées de votre organisation, utilisez le navigateur de métadonnées fourni dans le package du kit de développement logiciel. Téléchargez le package Kit de développement logiciel (SDK) de Microsoft Dynamics CRM. Pour plus d'informations :Parcourir les métadonnées de votre organisation
Cette rubrique traite du mode d’utilisation des entités par programme. Voir TechNet : créer et modifier des entités pour plus d’informations sur l’utilisation des entités dans l’application.
Contenu de la rubrique
Options disponibles lorsque vous créez une entité personnalisée
Activer les fonctionnalités d’entité
Propriétés d’entité modifiables
Messages de métadonnées de l’entité
Messages pris en charge par des entités personnalisées
Options disponibles lorsque vous créez une entité personnalisée
Le tableau suivant répertorie les options qui sont disponibles lorsque vous créez une entité personnalisée. Vous pouvez uniquement définir les propriétés lorsque vous créez une entité personnalisée.
Option |
Description |
|---|---|
Créer en tant qu’activité personnalisée |
Vous pouvez créer une entité qui est une activité en définissant la propriété EntityMetadata.IsActivity. Pour plus d'informations, voir Activités personnalisées. |
Noms des entités |
Il existe deux types de noms, et les deux doivent avoir un préfixe de personnalisation :
Notes Si le nom logique diffère du nom de schéma, le nom de schéma remplacera la valeur que vous définissez pour le nom logique. Lorsqu’une entité est créée dans l’application dans le contexte d’une solution spécifique, le préfixe de personnalisation utilisé est un ensemble pour l’Publisher de la solution. Lorsqu’une entité est créée par programme, vous pouvez définir le préfixe de personnalisation en chaîne contenant entre deux et huit caractères, tous les caractères alphanumériques, et devant commencer par une lettre. Elle ne peut pas commencer par « mscrm ». La meilleure méthode consiste à utiliser le préfixe de personnalisation défini par l’éditeur auquel la solution est associée, mais ce n’est pas une obligation. Un caractère de soulignement doit être compris entre le préfixe de personnalisation et le nom logique ou de schéma. |
Propriété |
Utilisez la propriété EntityMetadata.OwnershipType pour définir ce paramètre Utilisez l’énumération OwnershipTypes pour définir le type de propriété d’entité. Les seules valeurs possibles pour les entités personnalisées sont OrgOwned ou UserOwned. Pour plus d'informations, voir 8597998f-764f-4c73-b63d-9f5e02c78061#EntityOwnership. |
Attribut principal |
Utilisez CreateEntityRequest.PrimaryAttribute pour définir ce paramètre. Chaque entité comporte un attribut StringAttributeMetadata qui utilise StringFormat.Text comme attribut principal. La valeur de cet attribut est celle qui est contenue dans une recherche de toutes les entités associées. Par conséquent, la valeur du champ doit représenter le nom de l’enregistrement d’entité. |
Activer les fonctionnalités d’entité
Le tableau suivant répertorie les fonctionnalités d’entité. Vous pouvez définir ces fonctionnalités lorsque vous créez une entité ou vous pouvez les activer ultérieurement. Une fois activées, elles ne peuvent pas être désactivées.
Fonctionnalité |
Description |
|---|---|
Flux des processus d'entreprise |
Définissez EntityMetadata.IsBusinessProcessEnabled sur true pour activer l’entité pour les flux de processus d’entreprise. |
Notes |
Utilisez la propriété CreateEntityRequest ou UpdateEntityRequest.HasNotes pour créer une relation d’entités avec l’entité Annotation et pour activer l’inclusion d’une zone Notes dans le formulaire d’entité. En ajoutant Notes, vous pouvez également ajouter des pièces jointes aux enregistrements. |
Activités |
Utilisez la propriété CreateEntityRequest ou UpdateEntityRequest.HasActivities pour créer une relation d’entités avec l’entité ActivityPointer afin que toutes les entités de type d’activité puissent être associées à cette entité. |
Connexions |
Définissez la propriété EntityMetadata.IsConnectionsEnabled pour créer des enregistrements de connexion et associer cette entité à d’autres entités de connexion. |
Files d'attente |
Utilisez la propriété EntityMetadata.IsValidForQueue pour ajouter la prise en charge des files d’attente. Lorsque vous activez cette option, vous pouvez définir la propriété EntityMetadata.AutoRouteToOwnerQueue pour déplacer des enregistrements automatiquement vers la file d’attente par défaut du propriétaire lorsqu’un enregistrement de ce type est créé ou attribué. |
Courrier électronique |
Définissez la propriété EntityMetadata.IsActivityParty pour pouvoir envoyer un courrier électronique à l’adresse de messagerie avec ce type d’enregistrement. |
Propriétés d’entité modifiables
Le tableau suivant répertorie les propriétés d’entité que vous pouvez modifier. À moins qu’une propriété gérée désactive ces options, vous pouvez les mettre à jour à tout moment.
Propriété |
Description |
|---|---|
Autoriser la création rapide |
Utilisez EntityMetadata.IsQuickCreateEnabled pour activer les formulaires de création rapide pour l’entité. Avant de pouvoir utiliser les formulaires de création rapide, vous devez au préalable créer et publier un formulaire de création rapide. Notes Les entités d'activité ne sont pas compatibles avec les formulaires de création rapide. |
Équipes d'accès |
Utilisez EntityMetadata.AutoCreateAccessTeams pour activer l’entité pour les équipes d’accès. Voir Aides et formation : à propos des modèles d’équipepour plus d’informations. |
Image principale |
Si une entité possède un attribut d’image, vous pouvez activer ou désactiver l’affichage de cette image dans l’application avec PrimaryImageAttribute. Pour plus d'informations, voir 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages. |
Modifier le texte d’affichage |
La propriété gérée EntityMetadata.IsRenameable empêche la modification du nom complet dans l’application. Vous pouvez toutefois modifier par programme les étiquettes en mettant à jour les propriétés EntityMetadata.DisplayName et EntityMetadata.DisplayCollectionName. |
Modifier la description des entités |
La propriété gérée EntityMetadata.IsRenameable empêche la modification de la description de l’entité dans l’application. Vous pouvez toutefois modifier par programme les étiquettes en mettant à jour la propriété EntityMetadata.Description. |
Activer pour l’utilisation en mode hors connexion |
Utilisez EntityMetadata.IsAvailableOffline pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion d’exploiter les données de cette entité hors connexion. |
Activer le volet de lecture Outlook |
Notes La propriété EntityMetadata.IsReadingPaneEnabled est Utilisation interne uniquement. Pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Microsoft Dynamics 365 pour Outlook de consulter les données de cette entité, utilisez le volet de lecture Microsoft Outlook. Vous devez définir cette propriété dans l’application. |
Activer (la fusion et) le publipostage |
Utilisez EntityMetadata.IsMailMergeEnabled pour activer ou désactiver la fonctionnalité permettant de générer des documents fusionnés Microsoft Office Word qui utilisent les données de cette entité. |
Activer la détection des doublons |
Utilisez EntityMetadata.IsDuplicateDetectionEnabled pour activer ou désactiver la détection des doublons pour l’entité. Pour plus d'informations, voir Détecter les données dupliquées. |
Activer l’intégration SharePoint |
Utilisez EntityMetadata.IsDocumentManagementEnabled pour activer ou désactiver l’intégration SharePoint Server pour l’entité. Pour plus d'informations, voir Activer la gestion des documents pour les entités. |
Activer Dynamics 365 pour téléphones |
Utilisez EntityMetadata.IsVisibleInMobile pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Microsoft Dynamics 365 pour téléphones de consulter les données de cette entité. |
Dynamics 365 pour tablettes |
Utilisez EntityMetadata.IsVisibleInMobileClient pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Microsoft Dynamics 365 pour tablettes de consulter les données de cette entité. Si l’entité est disponible pour Dynamics 365 pour tablettes, vous pourrez utiliser EntityMetadata.IsReadOnlyInMobileClient pour spécifier que les données de l’enregistrement sont en lecture seule. |
Activer l’audit |
Utilisez EntityMetadata.IsAuditEnabled pour activer ou désactiver l’audit pour l’entité. Pour plus d'informations, voir Configurer les entités et les attributs pour l’audit. |
Modifier les zones affichant l’entité |
Vous pouvez contrôler la position des grilles d’entités dans le volet de navigation de l’application. Ceci est contrôlé par Plan de site. Pour plus d'informations, voir Modifier le plan du site. |
Ajouter ou supprimer des attributs |
Tant que la propriété gérée EntityMetadata.CanCreateAttributes permet de créer des attributs, vous pouvez utiliser le message CreateAttributeRequest pour ajouter des attributs. Pour plus d'informations, voir Personnaliser les métadonnées d’attribut d’entité. |
Ajouter ou supprimer des vues |
Tant que la propriété gérée EntityMetadata.CanCreateViews permet de créer des vues, vous pouvez utiliser l’entité SavedQuery pour créer les vues d’une entité. |
Ajouter ou supprimer des graphiques |
Tant que la propriété gérée EntityMetadata.CanCreateCharts permet de créer des graphiques et que la propriété d’entité EntityMetadata.IsEnabledForCharts a la valeur true, vous pouvez utiliser SavedQueryVisualization pour créer les graphiques de cette entité. Pour plus d'informations, voir Afficher des données avec les visualisations (graphiques). |
Ajouter ou supprimer des relations d’entités |
Il existe plusieurs propriétés gérées qui contrôlent les types de relations d’entité que vous pouvez créer pour une entité. Pour plus d'informations, voir Personnaliser des métadonnées de relation d’entité. |
Modifier les icônes |
Vous pouvez modifier les icônes utilisées pour les entités personnalisées. Pour plus d'informations, voir Modifier les icônes d’une entité. |
Utilisation de l'aide personnalisée |
EntityMetadata.EntityHelpUrlEnabled contrôle si l'aide personnalisée est activée pour l'entité.Pour plus d'informations :Ajouter un contenu d'aide personnalisé. |
URL de l'Aide |
EntityMetadata.EntityHelpUrl contrôle quelle ressource est affichée pour le contenu de l'aide relatif à l'entité si l'aide personnalisée est activée.Pour plus d'informations :Ajouter un contenu d'aide personnalisé. |
Peut changer la relation hiérarchique |
EntityMetadata.CanChangeHierarchicalRelationship contrôle si l'état hiérarchique des entités-relations inclus dans vos solutions gérées peut être modifié.Pour plus d'informations : |
Messages de métadonnées de l’entité
Le tableau suivant répertorie les messages que vous pouvez utiliser pour créer, extraire, mettre à jour et supprimer les métadonnées de l’entité.
Nom du message |
Description |
|---|---|
Crée une entité personnalisée. |
|
Supprime une entité personnalisée. |
|
Récupère les métadonnées pour toutes les entités. |
|
Récupère les métadonnées pour une entité. |
|
Met à jour les métadonnées d’une entité. |
|
Utilisé avec les objets de l'espace de noms Microsoft.Xrm.Sdk.Metadata.Query pour créer une requête visant à récupérer et détecter de manière efficace les modifications apportées à des métadonnées spécifiques.Pour plus d'informations :Récupérer et détecter les modifications apportées aux métadonnées. |
Messages pris en charge par des entités personnalisées
Les entités personnalisées prennent en charge les mêmes messages de base que les entités système. L’ensemble des messages disponibles dépend de si l’entité personnalisée appartient à l’utilisateur ou à l’organisation. Pour plus d'informations, voir 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords.
Voir aussi
Utiliser le service d'organisation avec des métadonnées Dynamics 365
Présentation des entités dans Microsoft Dynamics 365
Parcourir les métadonnées de votre organisation
Personnaliser les métadonnées d’attribut d’entité
Personnaliser des métadonnées de relation d’entité
Détecter les données dupliquées
Activer la gestion des documents pour les entités
Configurer les entités et les attributs pour l’audit
Modifier le plan du site
Afficher des données avec les visualisations (graphiques)
Quelles sont les entités personnalisables ?
Créer une entité personnalisée
Récupérer, mettre à jour et supprimer les entités
Exemple : créer et mettre à jour une entité pouvant être envoyée par courrier
Créer une entité d’activité personnalisée
Modifier les icônes d’une entité
Modifier les messages pour une entité
Exemple : Créer et mettre à jour des métadonnées d’entité
Exemple : Créer une entité d’activité personnalisée
Exemple : créer et mettre à jour une entité pouvant recevoir du courrier
Exemple : Vider les métadonnées d’entité dans un fichier
Exemple : Vider les informations de privilège d’entité dans un fichier
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright