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. Parcourez les définitions de table dans votre environnement.

Cet article explique comment utiliser des tables par programmation. Pour utiliser des tables dans Power Apps, consultez Tables dans Dataverse.

Vous pouvez créer des tables à l’aide du Kit de développement logiciel (SDK) pour .NET, du Kit de développement logiciel (SDK) Dataverse pour Python ou de l’API web. Les informations suivantes s’appliquent aux trois méthodes.

Method	Interface	En savoir plus
API Web	Type d’entité EntityMetadata	Créer et mettre à jour les définitions de table à l’aide de l’API web
SDK pour .NET	EntityMetadata, classe	Créez une table personnalisée à l’aide du code Récupérer, mettre à jour et supprimer des tables
Kit de développement logiciel (SDK) Dataverse pour Python	client.tables	Utiliser des métadonnées pour personnaliser des tables et des colonnes

Créer, récupérer, mettre à jour et supprimer des définitions de table

L’utilisation des définitions de table dépend du service que vous utilisez.

Message	API Web	Kit de développement logiciel (SDK) .NET	SDK pour Python
CreateEntity	Utilisez une POST demande d’envoi de données pour créer une table.	CreateEntityRequest, classe	Permet client.tables.create de créer une table personnalisée et éventuellement de ses colonnes.
DeleteEntity	Utilisez une DELETE demande pour supprimer une table.	DeleteEntityRequest, classe	Permet client.tables.delete de supprimer une table personnalisée.
RetrieveAllEntities	Utilisez GET la demande pour récupérer des données de table.	RetrieveAllEntitiesRequest, classe	Permet client.tables.list de répertorier les définitions de table.
RetrieveEntity	Fonction RetrieveEntity	Classe RetrieveEntityRequest	Permet client.tables.get de récupérer une définition de table.
UpdateEntity	Utilisez une demande PUT pour mettre à jour une table.	UpdateEntityRequest, classe	N’est pas pris en charge actuellement. Le Kit de développement logiciel (SDK) pour Python ne fournit pas de méthode de mise à jour de table.
RetrieveMetadataChanges Utilisé avec des objets dans l’espace de noms Metadata.Query pour créer une requête pour récupérer et détecter efficacement les modifications apportées à des définitions de table spécifiques. Plus d’informations : Définitions de schéma de requête.	RetrieveMetadataChanges, fonction	RetrieveMetadataChangesRequest, classe	N’est pas pris en charge actuellement. Le Kit de développement logiciel (SDK) pour Python ne permet pas d'appeler cette fonction.

Options disponibles lorsque vous créez une table personnalisée

La liste suivante décrit les options disponibles lorsque vous créez une table personnalisée. Vous ne pouvez définir ces propriétés que lorsque vous créez une table personnalisée.

Choix	Descriptif
Créer en tant qu’activité personnalisée	Créez une table qui est une activité en définissant la IsActivity propriété lors de l’utilisation du Kit de développement logiciel (SDK) pour .NET ou l’API web respectivement. Pour plus d’informations, consultez Activités personnalisées.
Noms de tables	Il existe deux types de noms. Les tables personnalisées doivent avoir un préfixe de personnalisation : LogicalName: Nom qui est la version du nom de table défini en 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 du schéma, le nom du schéma remplace la valeur que vous définissez pour le nom logique. Lorsque vous créez une table dans l’application dans le contexte d’une solution spécifique, le préfixe de personnalisation utilisé est celui défini pour la Publisher solution. Lorsque vous créez une table par programmation, définissez le préfixe de personnalisation sur une chaîne comprise entre deux et huit caractères de longueur, tous les caractères alphanumériques, et il doit commencer par une lettre. Il ne peut pas commencer par mscrm. La meilleure pratique consiste à utiliser le préfixe de personnalisation défini par l’éditeur auquel la solution est associée, mais cette bonne pratique n’est pas appliquée. 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 comment la propriété des enregistrements de table est définie. Utilisez l’énumération OwnershipTypes ou le type d’énumération OwnershipTypes pour définir le type de propriété de table. Les seules valeurs valides pour les tables personnalisées sont OrgOwned ou UserOwned. Pour plus d’informations, consultez Propriété de table.
Colonne principale	Avec le Kit de développement logiciel (SDK) pour .NET, utilisez la propriété CreateEntityRequest.PrimaryAttribute pour définir la colonne primaire. Avec l’API web, le json définissant la table doit inclure un type d’entité StringAttributeMetadata avec la IsPrimaryName propriété définie sur true. Dans les deux cas, la colonne de chaîne doit être mise en forme comme Text. La valeur de la colonne primaire est ce qui est affiché dans une recherche pour toutes les tables associées. Par conséquent, la valeur de la colonne doit représenter un nom de l’enregistrement.

Activer les fonctionnalités de table

La liste suivante décrit les fonctionnalités de tableau. Vous pouvez définir ces fonctionnalités lorsque vous créez une table ou que vous les activez ultérieurement.

Note

Vous ne pouvez pas désactiver ces fonctionnalités une fois que vous les avez activés.

Capacité	Descriptif
Flux de processus d’entreprise	Définissez IsBusinessProcessEnabled la valeur true pour activer la table pour les flux de processus métier.
Remarques	Créez une relation avec la Annotation table et activez l’inclusion d’une zone Notes dans le formulaire. En ajoutant Notes, vous pouvez également ajouter des pièces jointes aux enregistrements. À l’aide du Kit de développement logiciel (SDK) pour .NET, utilisez la propriété CreateEntityRequest ou UpdateEntityRequestHasNotes À l’aide de l’API web, définissez la propriété EntityMetadata.HasNotes
Activités	Créez une relation avec la ActivityPointer table afin que toutes les tables de type d’activité puissent être associées à cette table. À l’aide du Kit de développement logiciel (SDK) pour .NET, utilisez la propriété CreateEntityRequest ou UpdateEntityRequestHasActivities. À l’aide de l’API web, définissez la propriété EntityMetadata.HasActivities
Connexions	Définissez la IsConnectionsEnabled.Value propriété sur true pour permettre la création d’enregistrements de connexion pour associer cette table à d’autres tables de connexion. Pour en savoir plus sur les connexions, consultez Configurer des rôles de connexion et utiliser des connexions pour lier des enregistrements entre eux.
Queues	Utilisez la propriété IsValidForQueue pour ajouter la prise en charge des files d’attente. Lorsque vous activez cette option, vous pouvez également définir la AutoRouteToOwnerQueue propriété pour déplacer automatiquement les enregistrements vers la file d’attente par défaut du propriétaire lorsqu’un enregistrement de ce type est créé ou affecté. Pour en savoir plus, consultez En savoir plus sur les files d’attente et les tables de file d’attente.
Courriel	Définissez la propriété IsActivityParty. pour pouvoir envoyer un courrier électronique à l’adresse de messagerie avec ce type d’enregistrement. En savoir plus sur les parties d’activité.

Propriétés de table modifiables

La liste suivante montre les propriétés de tableau que vous pouvez modifier. Sauf si une propriété gérée interdit ces options, vous pouvez les mettre à jour à tout moment. En savoir plus sur les propriétés gérées

Propriété	Descriptif
Autoriser la création rapide	Utilisez IsQuickCreateEnabled pour activer les formulaires de création rapide pour la table. Avant de pouvoir utiliser des formulaires de création rapide, vous devez d’abord créer et publier un formulaire de création rapide. En savoir plus sur les formulaires de création rapide d’applications pilotées par modèle Remarque : Les tables d’activité ne prennent pas en charge les formulaires de création rapide.
Équipes d’accès	Utilisez AutoCreateAccessTeams pour activer la table pour les équipes d’accès. Pour plus d’informations, voir À propos de la collaboration avec des modèles d’équipe .
Image principale	Si une table a une colonne d’image, vous pouvez activer ou désactiver l’affichage de cette image dans l’application à l’aide PrimaryImageAttributede . Découvrez comment utiliser des définitions de colonnes d’image à l’aide du code
Modifier le texte d’affichage	La propriétéIsRenameable gérée 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 de la table	La propriétéIsRenameable gérée 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 le volet de lecture Outlook	Remarque :La IsReadingPaneEnabled propriété est destinée à une utilisation interne uniquement. Pour activer ou désactiver la possibilité pour les utilisateurs d’Office Outlook d’afficher les données de ce tableau, utilisez le volet de lecture Outlook. Vous devez définir cette propriété dans l’application.
Activer (la fusion et) le publipostage	Permet IsMailMergeEnabled d’activer ou de désactiver la possibilité de générer des documents fusionnés Office Word qui utilisent des données de ce tableau.
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, consultez Détecter les données dupliquées à l’aide du code
Activer l’intégration de SharePoint	Utilisez IsDocumentManagementEnabled pour activer ou désactiver l'intégration du serveur SharePoint pour la table. Pour plus d’informations : Activer la gestion des documents SharePoint pour des entités spécifiques
Activer Dynamics 365 pour téléphones	Permet IsVisibleInMobile d’activer ou de désactiver la capacité des utilisateurs de Dynamics 365 pour les téléphones à afficher les données de ce tableau.
Dynamics 365 pour tablettes	Permet IsVisibleInMobileClient d’activer ou de désactiver la possibilité pour les utilisateurs de Dynamics 365 pour tablettes d’afficher les données de ce tableau. 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, consultez Configurer la table et les colonnes pour l’audit.
Ajouter ou supprimer des colonnes	Tant que la propriétéCanCreateAttributes.Value gérée permet de créer des colonnes, vous pouvez ajouter des colonnes à la table. Pour plus d’informations, consultez définitions de colonnes.
Ajouter ou supprimer des vues	Tant que la propriétéCanCreateViews.Value gérée permet de créer des vues, vous pouvez utiliser la SavedQuery table pour créer des vues pour une table.
Ajouter ou supprimer des graphiques	Tant que la propriétéCanCreateCharts.Value gérée permet de créer des graphiques et que la IsEnabledForCharts propriété de table est vraie, vous pouvez utiliser la table SavedQueryVisualization pour créer des graphiques pour une table. Pour plus d’informations, consultez Afficher les données avec des visualisations (graphiques).
Ajouter ou supprimer des relations de table	Plusieurs propriétés gérées contrôlent les types de relations que vous pouvez créer pour une table. Pour plus d’informations, consultez définitions de relation de table.
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 basée sur des modèles
Peut changer la relation hiérarchique	CanChangeHierarchicalRelationship.Value contrôle si l’état hiérarchique des relations incluses dans vos solutions managées peut être modifié. En savoir plus : Définir et interroger des données hiérarchiquement associées et interroger des données hiérarchiques
Nom de l'ensemble d’entités	EntitySetName spécifie le nom utilisé pour identifier de manière unique la table à l’aide de l’API Web Dataverse. Ce nom est généralement le même que le LogicalCollectionName, mais vous ne pouvez pas modifier le LogicalCollectionName. Vous devez uniquement modifier EntitySetName avant l’écriture d’un code à l’aide du nom du jeu d’entités par défaut. En savoir plus sur les noms des ensembles d’entités

Messages pris en charge par les tables personnalisées

Les tables personnalisées prennent en charge les mêmes messages de base que les tables système. L’ensemble de messages que vous pouvez utiliser dépend de la propriété de l’utilisateur ou de l’organisation de la table personnalisée. Les tables appartenant à l’utilisateur prennent en charge le partage. Vous pouvez donc utiliser des messages tels que GrantAccess, ModifyAccesset RevokeAccess.

Voir aussi

Utiliser l’API Web avec les définitions de table
Utiliser des définitions de table à l’aide du Kit de développement logiciel (SDK) pour .NET