Présentation des métadonnées d’entité et du navigateur de métadonnées

  • Article

Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Entités et métadonnées dans Dataverse

Cette rubrique se penche sur les métadonnées et la manière dont vous les utiliser pour créer des applications Dynamics 365 Customer Engagement (on-premises) ou personnaliser une application Dynamics 365 for Customer Engagement existante.

Métadonnées utilisées avec la personnalisation

Les Métadonnées sont des « données sur les données ». Dynamics 365 Customer Engagement (on-premises) fournit une plateforme souple pour vous, car il est relativement simple de modifier les définitions des données utilisées par l’environnement. Dans Dynamics 365 Customer Engagement (on-premises), les métadonnées sont une collection d’entités. Les entités décrivent les types de données stockées dans la base de données. Chaque entité correspond à une table de base de données et chaque champ (également appelé attribut) au sein d’une entité représente une colonne dans la table. Les métadonnées de l’entité sont ce qui permet de contrôler les types d’enregistrements que vous pouvez créer et les actions que vous pouvez leur appliquer. En utilisant uniquement des métadonnées d’entité et les services Web de, un développeur peut écrire du code pour effectuer des actions au moyen de données sur votre environnement. Vous avez la possibilité de modifier ces métadonnées avec les outils de personnalisation pour créer ou modifier des entités, des champs, et des relations d’entité.

L’application Web ou d’autres clients utilisés pour interagir avec les données de votre environnement dépendent des métadonnées d’entité et s’adaptent au fil des modifications des métadonnées d’entité. Mais ces clients dépendent également d’autres données pour contrôler les éléments visuels à afficher, la logique personnalisée à appliquer et comment appliquer la sécurité. Ces données système sont également stockées au sein d’entités, mais les entités elles-mêmes ne sont pas disponibles pour la personnalisation.

Utiliser le navigateur de métadonnées

L’explorateur de solutions donne accès à toutes les entités que vous pouvez personnaliser, mais il s’agit simplement d’une fraction des entités qui définissent les métadonnées utilisées dans le système. Pour la plupart des tâches de base de personnalisation, seules les informations présentées dans l’explorateur de solutions sont nécessaires. Les développeurs ont souvent besoin de plus d’informations et d’un moyen simple d’afficher les métadonnées. Si vous devez aborder en détail le sujet des métadonnées avec des développeurs ou si vous souhaitez mieux comprendre le sujet, installez la solution Navigateur de métadonnées. Le Navigateur de métadonnées est une solution gérée contenant uniquement des ressources Web HTML, que vous pouvez installer pour afficher toutes les métadonnées et filtrer les entités et les champs pour mieux comprendre ce que les métadonnées contiennent.

Télécharger et installer le Navigateur de métadonnées

Utilisez le lien approprié ci-dessous pour télécharger la solution Navigateur de métadonnées de manière à pouvoir l’installer.

Version Téléchargement
Applications Dynamics 365 for Customer Engagement version 9.0 (v9.0) Téléchargements Microsoft : MetadataBrowser_3_0_0_5_managed.zip
Dynamics 365 (v8.2) Dynamics CRM Online 2016 Mise à jour 1 et Dynamics CRM 2016 Service Pack 1 local (v8.1) Téléchargements Microsoft : MetadataBrowser_3_0_0_4_managed.zip
Dynamics CRM Online 2016 Update et CRM 2016 (v8.0) Téléchargements Microsoft : MetadataBrowser_3_0_0_2_managed.zip

Installer la solution

Après avoir téléchargé la solution, vous devez l’installer. Pour plus d’informations sur l’installation d’une solution gérée, consultez Importer, mettre à jour et exporter des solutions.

Ouvrir en tant qu’application

La version 9.0 (v9.0) des applications Dynamics 365 for Customer Engagement est configurée en tant qu’application. Après avoir installé la solution Navigateur de métadonnées d’entité, recherchez l’application Outils de métadonnées et ouvrez la. Entités est la vue par défaut. Dans la zone de navigation Outils vous pouvez sélectionner Métadonnées d’entité pour inspecter les entités individuelles.

Ouvrir à partir de la page de configuration de solution

Pour les versions antérieures vous devez utiliser la procédure suivante, mais elle fonctionne également pour la version la plus récente.

Après avoir installé la solution Navigateur de métadonnées de l’entité, ouvrez la solution gérée en double-cliquant sur sa ligne dans la liste de solutions et affichez la page Configuration pour consulter des informations sur le navigateur de métadonnées de l’entité et sur les boutons de lancement de deux vues différentes.

  • Navigateur de métadonnées est équivalent à la vue Entités dans l’application.
  • Navigateur de métadonnées d’entité est équivalent à la vue Métadonnées d’entités dans l’application.

Vue des entités

Vous pouvez effectuer les actions suivantes :

  • Afficher les détails de l’entité : Sélectionnez une entité à afficher à l’aide de la vue Métadonnées d’entité.
  • Modifier l’entité : Ouvrir le formulaire d’entité sélectionné dans l’organisation par défaut, si l’entité prend en charge cette action.
  • Recherche de texte : Effectuer une recherche de texte pour filtrer les entités affichées à l’aide des propriétés d’entité suivantes : SchemaName, LogicalName, DisplayName, ObjectTypeCode, et MetadataId.
  • Filtrer les entités : Critères simples définis pour afficher un sous-ensemble d’entités. Tous les critères sont évalués à l’aide de la logique AND.
  • Filtrer les propriétés : Filtrer les propriétés affichées pour une entité sélectionnée. Il existe environ 100 propriétés dans la liste. Utilisez cela pour sélectionner uniquement celles qui vous intéressent.

Vue Métadonnées d’entité

Vous pouvez exécuter les actions suivantes pour une entité unique :

  • Entité : Changer l’entité à afficher.

  • Propriétés : Afficher toutes les propriétés de l’entité et filtrer les propriétés affichées.

    • Modifier l’entité : Ouvrir le formulaire de modification de l’entité sélectionné dans l’organisation par défaut, si l’entité prend en charge cette action.
    • Filtrer les propriétés : Filtrer les propriétés affichées pour une entité sélectionnée. Il existe environ 100 propriétés dans la liste. Utilisez cette option pour sélectionner uniquement celles qui vous intéressent.

  • Attributs : Afficher les attributs d’entité en mode d’affichage principal/détaillé. Cette vue vous permet d’effectuer les actions suivantes :

    • Modifier l’attribut : Ouvrir le formulaire d’attribut sélectionné dans l’organisation par défaut si l’attribut prend en charge cette action.
    • Recherche de texte : Effectuer une recherche de texte pour filtrer les attributs affichés à l’aide des propriétés d’attribut suivantes : SchemaName, LogicalName, DisplayName, et MetadataId.
    • Filtrer les attributs : Filtrer les attributs par toute valeur de propriété d’attribut.
    • Filtrer les propriétés : Filtrer toutes les propriétés affichées pour l’attribut sélectionné.

  • Clés: Si des clés secondaires sont activées pour une entité vous pouvez vérifier leur configuration. Informations complémentaires : Définir les clés secondaires

  • Relations: Affichez les trois types de relations d’entités : Un-à-plusieurs, plusieurs-à-un et plusieurs-à-plusieurs. Ces vues vous permettent d’effectuer les actions suivantes :

    • Modifier la relation : Ouvrir le formulaire de relation sélectionné dans l’organisation par défaut si la relation prend en charge cette action.
    • Recherche de texte : Effectuer une recherche de texte pour filtrer les relations affichées à l’aide des valeurs relatives au type de relation.
    • Filtrer les propriétés : Filtrer les relations par toute valeur de propriété de relation.

  • Privilèges : Afficher les privilèges d’entité. Avec cette vue vous pouvez :

    • Filtrer le privilège affiché avec la propriété PrivilegeId.

Note

En affichant les propriétés des détails d’entité, vous verrez que de nombreuses propriétés complexes sont expansibles. La valeur la plus utile s’affiche avec un lien qui permet de basculer vers une vue plus détaillée. La vue détaillée reflète la structure des données pour vous permettre de les récupérer par programme. La vue détaillée montre également d’autres données appropriées qui peuvent être récupérées dans la même zone, par exemple, si des étiquettes localisées sont présentes pour les propriétés Nom complet.

Astuce

Pour copier du texte depuis la page, il suffit de sélectionner le texte et d’utiliser le raccourci clavier Ctrl+C ou la commande Copier du menu contextuel.

Créer de nouvelles métadonnées ou utiliser des métadonnées existantes

Dynamics 365 Customer Engagement (on-premises) comprend un certain nombre d’entités système qui prennent en charge les fonctionnalités d’application métier de base. Par exemple, les données sur vos clients ou les clients potentiels sont destinées à être enregistrées à l’aide des entités Compte ou Contact. L’entité Prospect est l’endroit où les informations sur les prospects ou les opportunités de ventes potentielles doivent être conservées. L’entité Opportunité est destinée à être utilisée pour suivre les événements potentiellement générateurs de revenus.

Chaque entité comporte également un certain nombre de champs qui représentent des données courantes dont le système peut avoir besoin pour stocker l’entité respective.

La plupart des organisations ont tout avantage à utiliser les entités et attributs système dans le cadre pour lequel ils ont été fournis. Même si vous pouvez créer des entités personnalisées, les entités système peuvent avoir des fonctionnalités spéciales que vous ne pourrez pas répliquer facilement sans écrire de code.

Par exemple,

  • Les enregistrements d’entité prospect peuvent être inclus. Cette action d’inclusion désactive le prospect et crée une nouvelle opportunité et un nouvel enregistrement de compte ou de contact pour permettre d’avancer dans votre processus d’entreprise.

  • Les enregistrements d’entité d’incident possèdent une connexion spéciale avec les entités de contrat qui permet de définir des droits pour les services clientèle.

    Si vous souhaitez installer une solution, vous pouvez compter sur le fait que le développeur de la solution a tiré parti des entités et attributs système. La création d’une nouvelle entité personnalisée qui remplace une entité ou un attribut système signifie que les solutions disponibles ne fonctionneront pas forcément dans votre organisation.

    Pour cette raison, nous vous recommandons d’utiliser les entités et les champs système disponibles lorsque cela est approprié pour votre organisation. Si ce n’est pas le cas et qu’ils ne peuvent pas être modifiés pour répondre à vos besoins, vous devez déterminer si la création d’une entité est obligatoire. N’oubliez pas que vous pouvez modifier le nom complet d’une entité afin qu’il corresponde à la nomenclature utilisée dans votre organisation. Par exemple, il est fréquent de changer le nom complet de l’entité Compte en « Société » ou de l’entité Contact en « Individu ». Cela peut être appliqué aux entités ou aux attributs sans modifier le comportement de l’entité. Pour plus d’informations sur le changement de nom des entités, voir Modifier le nom d’une entité.

    Vous ne pouvez pas supprimer les entités ni les champs système. Ils sont considérés comme faisant partie de la solution système et chaque organisation est supposée en posséder. Si vous souhaitez masquer une entité système, modifiez les privilèges des rôles de sécurité de votre organisation pour supprimer le privilège de lecture pour cette entité. Cela supprimera l’entité de la majeure partie de l’application. Si un champ système est inutile, supprimez-le du formulaire et des vues qui l’utilisent. Modifiez la valeur Possibilité de recherche dans la définition du champ afin qu’elle n’apparaisse plus dans la recherche avancée. Informations complémentaires : Création et modification de champs

Limitations sur la création des articles de métadonnées

Il existe une limite au nombre d’entités que vous pouvez créer. Vous pouvez rechercher des informations concernant le nombre maximal dans la page Ressources en cours d’utilisation. Si vous avez besoin de plus d’entités personnalisées, contactez le support technique Dynamics 365 Customer Engagement (on-premises). Cette limite supérieure peut être ajustée.

Dans chaque entité, il existe une limite supérieure du nombre de champs que vous pouvez créer. Cette limite est basée sur les limitations techniques concernant la quantité de données qui peuvent être stockées dans une ligne d’une table de base de données. Il est difficile de fournir un nombre spécifique, car chaque type de champ peut utiliser un volume d’espace différent. La limite supérieure dépend de l’espace total utilisé par tous les champs de l’entité.

La plupart des utilisateurs ne créent pas suffisamment de champs personnalisés pour atteindre la limite, mais si vous planifiez d’ajouter des centaines de champs personnalisés à une entité, vous devez déterminer s’il s’agit de la meilleure option de création. Tous les champs que vous souhaitez ajouter décrivent-ils des propriétés d’un enregistrement de cette entité ? Estimez-vous que les utilisateurs de votre organisation pourront réellement gérer un formulaire contenant un si grand nombre de champs ? Le nombre de champs que vous ajoutez à un formulaire augmente la quantité de données devant être transférées à chaque fois qu’un enregistrement est modifié et affecte les performances du système. Tenez compte de ces facteurs lorsque vous ajoutez des champs personnalisés à une entité.

Les champs de groupes d’options fournissent un ensemble d’options qui apparaîtront dans un contrôle de liste déroulante dans un formulaire ou dans un contrôle de liste déroulante lors de l’utilisation de la recherche avancée. Votre environnement peut prendre en charge des milliers d’options dans un groupe d’options, mais vous ne devez pas considérer cela comme la limite supérieure. Des études de convivialité ont démontré que les utilisateurs ont du mal à utiliser un système dans lequel un contrôle de liste déroulante propose un grand nombre d’options. Utilisez le champ de groupe d’options pour définir des catégories pour les données. N’utilisez pas les champs de groupes d’options pour sélectionner des catégories qui représentent réellement des éléments de données distincts. Par exemple, au lieu de conserver un champ de groupe d’options qui stocke chaque fabricant parmi une centaine possibles d’un type d’équipement, envisagez de créer une entité qui stocke les références à chaque fabricant et utilisez un champ plutôt qu’un groupe d’options.

Les vues sont limitées à 1 000 attributs par vue. Si une vue est créée sur une entité qui dépasse cette limite, un sous-ensemble d’attributs disponibles doit être utilisé dans la vue. L’ajout d’un attribut à la limite de 1 000 attributs entraînera un message d’erreur indiquant que le nombre maximal d’attributs a été dépassé.

Voir aussi

Créer et modifier des entités
Création et modification de relations d’entité
Créer et modifier des champs

Créer et concevoir des formulaires