Personnaliser les définitions de table
En définissant ou en modifiant les définitions de table, vous pouvez contrôler les fonctionnalités d’une table. Pour afficher les définitions de table de votre environnement, utilisez le navigateur de métadonnées. Parcourir les définitions de table dans votre environnement.
Pour plus d’informations : Parcourir les définitions de table de votre environnement
Cet article traite du mode d’utilisation des tables par programme. Pour travailler avec des tables dans Power Apps Voir Tables dans Dataverse.
Les tables peuvent être créées à partir du SDK pour .NET ou de l’API web. Les informations suivantes peuvent être appliquées aux deux.
- Avec le kit de développement logiciel pour .NET, utilisez la classe EntityMetadata. Pour plus d’informations, voir Créer une table personnalisée avec du code et Récupérer, mettre à jour et supprimer les tables
- Avec l’API web, vous utilisez le type d’entité EntityMetadata. Apprendre à créer et mettre à jour les définitions de table à l’aide de l’API web
Opérations sur les définitions de table
L’utilisation des définitions de table dépend du service que vous utilisez.
Comme l’API web est un point de terminaison RESTful, elle utilise une méthode différente pour créer, récupérer, mettre à jour et supprimer les définitions de table. Utilisez les verbes HTTP POST, GET, PUT et DELETE avec les types d’entités de définitions de table. Apprendre à créer et mettre à jour les définitions de table à l’aide de l’API web
Une exception à cette règle est que la RetrieveMetadataChanges Function permet de composer une requête de définitions de table et d’assurer le suivi des modifications dans le temps.
Avec le SDK pour .NET, utilisez la classe RetrieveMetadataChangesRequest. Cette classe contient les données nécessaires pour récupérer une collection d’enregistrements de définitions de table répondant aux critères définis. La classe RetrieveMetadataChangesResponse renvoie une valeur d’horodatage qui peut être utilisée ultérieurement avec cette demande pour renvoyer des informations sur les modifications des définitions de table depuis la dernière demande.
| Message | API Web | Assembly du Kit de développement logiciel (SDK) |
|---|---|---|
CreateEntity |
Utilisez une demande POST pour envoyer des données pour créer une table. | CreateEntityRequest |
DeleteEntity |
Utilisez une demande DELETE pour supprimer une table. | DeleteEntityRequest |
RetrieveAllEntities |
Utilisez une demande GET pour récupérer des données de table. | RetrieveAllEntitiesRequest |
RetrieveEntity |
RetrieveEntity Function | RetrieveEntityRequest |
UpdateEntity |
Utilisez une demande PUT pour mettre à jour une table. | UpdateEntityRequest |
RetrieveMetadataChangesUtilisé 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 définitions de table. Pour plus d’informations : Récupérer et détecter les modifications apportées aux définitions de table. |
RetrieveMetadataChanges Function | RetrieveMetadataChangesRequest |
Options disponibles lorsque vous créez une table personnalisée
Le tableau suivant répertorie les options qui sont disponibles lorsque vous créez une table personnalisée. Vous pouvez uniquement définir les propriétés lorsque vous créez une table personnalisée.
| Option | Description |
|---|---|
| Créer en tant qu’activité personnalisée | Vous pouvez créer une table qui est une activité en définissant la propriété IsActivity lorsque vous utilisez le SDK pour .NET ou l’API web, respectivement. Pour plus d’informations, voir Activités personnalisées dans Dynamics 365. |
| Noms de table | Il existe deux types de noms, et les deux doivent avoir un préfixe de personnalisation :LogicalName : Version du nom de la table qui est défini en lettres minuscules.SchemaName: Nom utilisé pour créer les tables de base de données. 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.Remarque : si le nom logique diffère du nom de schéma, le nom de schéma remplace la valeur que vous définissez pour le nom logique. Lorsqu’une table est créée dans l’application dans le contexte d’une solution spécifique, le préfixe de personnalisation utilisé est un ensemble pour le Publisher de la solution. Lorsqu’une table 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. Il 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é OwnershipType pour définir la manière dont les enregistrements de table sont détenus. Utilisez l’énumération OwnershipTypes ou OwnershipTypes EnumType pour définir le type de propriété de table. Les seules valeurs possibles pour les tables personnalisées sont OrgOwned ou UserOwned. Pour plus d’informations, voir Propriété de la table. |
| Colonne primaire | Avec le SDK pour .NET, utilisez CreateEntityRequest.PrimaryAttribute propriété pour définir la colonne principale. Avec l’API web, le JSON définissant la table doit inclure un StringAttributeMetadata avec la propriété IsPrimaryName définie sur true.Dans les deux cas, la colonne de chaîne doit être mise en forme en tant que Text. La valeur de la colonne principale est celle qui est contenue dans une recherche de toutes les tables associées. Par conséquent, la valeur de la colonne doit représenter le nom de l’enregistrement. |
Activer les fonctionnalités de table
Le tableau suivant répertorie les fonctionnalités de table. Vous pouvez définir ces fonctionnalités lorsque vous créez une table ou vous pouvez les activer ultérieurement. Une fois activées, elles ne peuvent pas être désactivées.
| Capacité | Description |
|---|---|
| Flux des processus d’entreprise | Définissez IsBusinessProcessEnabled sur true pour activer la table pour les flux de processus d’entreprise. |
| Notes | Pour créer une relation d’entités avec la table Annotation et pour activer l’inclusion d’une zone Notes dans le formulaire. En ajoutant Notes, vous pouvez également ajouter des pièces jointes aux enregistrements. Avec le SDK pour .NET, utilisez la propriété CreateEntityRequest ou UpdateEntityRequest HasNotes Avec l’API web, définissez la propriété EntityMetadata. HasNotes propriété. |
| Activités | Pour créer une relation d’entités avec la table ActivityPointer afin que toutes les tables de type d’activité puissent être associées à cette table.Avec le SDK pour .NET, utilisez la propriété CreateEntityRequest ou UpdateEntityRequest HasActivities. Avec l’API web, définissez la propriété EntityMetadata. HasActivities propriété. |
| Connexions | Pour créer des enregistrements de connexion pour associer cette table à d’autres tables de connexion, définissez la valeur de la propriété IsConnectionsEnabled.Value sur true. |
| Files d’attente | Utilisez la propriété IsValidForQueue pour ajouter la prise en charge des files d’attente. Lorsque vous activez cette option, vous pouvez définir la propriété 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é IsActivityParty. pour pouvoir envoyer un courrier électronique à l’adresse de messagerie avec ce type d’enregistrement. |
Propriétés de table modifiables
Le tableau suivant répertorie les propriétés de table 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 IsQuickCreateEnabled pour activer les formulaires de création rapide pour la table. 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.Remarque : Les tables d’activité ne sont pas compatibles avec les formulaires de création rapide. |
| Équipes d’accès | Utilisez AutoCreateAccessTeams pour activer la table pour les équipes d’accès. Voir À propos de la collaboration avec les modèles d’équipe pour en savoir plus. |
| Image principale | Si une table possède une colonne d’image, vous pouvez activer ou désactiver l’affichage de cette image dans l’application avec PrimaryImageAttribute. Apprendre à utliser les définitions de colonne d’image avec du code |
| Modifier le texte d’affichage | La propriété gérée 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 DisplayName et DisplayCollectionName. |
| Modifier la description des tables | La propriété gérée IsRenameable empêche la modification de la description de la table dans l’application. Vous pouvez toutefois modifier par programme les Étiquettes en mettant à jour la propriété Description. |
| Activer pour l’utilisation en mode hors connexion | Utilisez IsAvailableOffline pour activer ou désactiver la possibilité pour les utilisateurs de Dynamics 365 for Microsoft Office Outlook avec accès hors ligne de récupérer des données pour cette table hors ligne. |
| Activer le volet de lecture Outlook | Remarque : La propriété IsReadingPaneEnabled est à usage interne uniquement.Pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Office Outlook de consulter les données de cette table, utilisez le volet de lecture Outlook. Vous devez définir cette propriété dans l’application. |
| Activer (la fusion et) le publipostage | Utilisez IsMailMergeEnabled pour activer ou désactiver la fonctionnalité permettant de générer des documents fusionnés Office Word qui utilisent les données de cette table. |
| Activer la détection des doublons | Utilisez IsDuplicateDetectionEnabled pour activer ou désactiver la détection des doublons pour la table. Pour plus d’informations, voir Détecter les données dupliquées avec le code |
| Activer l’intégration de SharePoint | Utilisez IsDocumentManagementEnabled pour activer ou désactiver l’intégration de serveur SharePoint pour la table. Pour plus d’informations : Activer la gestion des documents SharePoint pour des entités spécifiques. |
| Activer Dynamics 365 for phones | Utilisez IsVisibleInMobile pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Dynamics 365 pour téléphones de consulter les données de cette table. |
| Dynamics 365 pour tablettes | Utilisez IsVisibleInMobileClient pour activer ou désactiver la fonctionnalité permettant aux utilisateurs Dynamics 365 pour tablettes de consulter les données de cette table.Si la table est disponible pour Dynamics 365 pour tablettes vous pouvez utiliser IsReadOnlyInMobileClient pour spécifier que les données de l’enregistrement sont en lecture seule. |
| Activer l’audit | Utilisez IsAuditEnabled pour activer ou désactiver l’audit pour la table. Pour plus d’informations, voir Configurer la table et les colonnes pour l’audit. |
| Modifier les zones affichant la table | Vous pouvez contrôler la position des grilles de tables dans le volet de navigation de l’application. Ceci est contrôlé par Plan de site. |
| Ajouter ou supprimer des colonnes | Tant que la propriété gérée CanCreateAttributes.Value permet de créer des colonnes, vous pouvez ajouter des colonnes à la table. Pour plus d’informations, consultez la section Définitions de colonnes. |
| Ajouter ou supprimer des vues | Tant que la propriété gérée CanCreateViews.Value permet de créer des vues, vous pouvez utiliser la table SavedQuery pour créer les vues d’une table. |
| Ajouter ou supprimer des graphiques | Tant que la propriété gérée CanCreateCharts.Value permet de créer des graphiques et que la propriété de table IsEnabledForCharts a la valeur true, vous pouvez utiliser l’Table SavedQueryVisualization pour créer les graphiques d’une table. Pour plus d’informations, voir Afficher des données avec les visualisations (graphiques). |
| Ajouter ou supprimer des relations de tables | 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 table. Reportez-vous à Définitions des relations de table pour plus d’informations. |
| Modifier les icônes | Vous pouvez modifier les icônes utilisées pour les tables personnalisées. Pour plus d’informations, consultez Modifier les icônes de table personnalisées de l’application pilotée par modèle |
| Peut changer la relation hiérarchique | CanChangeHierarchicalRelationship.Value contrôle si l’état hiérarchique des relations inclus dans vos solutions gérées peut être modifié. |
| Nom du jeu d’entités | EntitySetName spécifie le nom utilisé pour identifier de manière unique la table à l’aide de l’API web Dataverse. C’est généralement le même que le LogicalCollectionName, mais vous ne pouvez pas modifier le LogicalCollectionName. Vous devez uniquement modifier EntitySetName avant d’écrire du code en utilisant le nom de l’ensemble d’entités par défaut. En savoir plus sur les noms de l’ensemble d’entités |
Messages pris en charge par des tables personnalisées
Les tables personnalisées prennent en charge les mêmes messages de base que les tables système. L’ensemble des messages disponibles dépend de si la table personnalisée appartient à l’utilisateur ou à l’organisation. Les tables appartenant à l’utilisateur prennent en charge le partage, de sorte que des messages tels que GrantAccess, ModifyAccess et RevokeAccess sont disponibles.
Voir aussi
Utiliser l’API web avec les définitions de table
Utiliser les définitions de table à l’aide du SDK pour .NET
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).