Personnaliser les métadonnées d’entité

Noms des entités

Il existe deux types de noms, et les deux doivent avoir un préfixe de personnalisation :

• EntityMetadataLogicalName : version du nom de l’entité qui est défini en lettres minuscules.

• EntityMetadataSchemaName : nom utilisé pour créer les tables de base de données de l’entité. La casse du nom peut être mixte. La casse que vous utilisez définit le nom de l’objet généré pour effectuer une programmation avec des types forts ou lorsque vous utilisez le point de terminaison REST.

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

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.

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.

Courrier électronique

Définissez la propriété EntityMetadata.IsActivityParty pour pouvoir envoyer un courrier électronique à l’adresse de messagerie avec ce type d’enregistrement.

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

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.

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

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.

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

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

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 :

DeleteEntityRequest

Supprime une entité personnalisée.

RetrieveEntityRequest

Récupère les métadonnées pour une entité.

RetrieveMetadataChangesRequest

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.