Gérer des champs personnalisésManage custom fields

Vous pouvez créer et mettre à jour un ou plusieurs champs personnalisés dans toute entité.You can create and update one or more custom fields in any entity. Lorsque vous créez un champ personnalisé, vous spécifiez un ensemble de propriétés, telles que son nom, son nom d’affichage, et le type des données qu’il doit contenir.When you create a custom field, you specify a set of properties, such as the field's name, its display name, and the type of data that it will contain. Pour plus d’informations, consultez Entity field data types (Types de données des champs d’entité) et Entity field properties (Propriétés des champs d’entité).For more information, see Enity field data types and Entity field properties.

Remarque : chaque entité comporte des champs système, par exemple des champs qui indiquent les date et heure de dernière mise à jour d’un enregistrement et l’auteur de la mise à jour.Note: Every entity has system fields, such as fields that indicate when a record was last updated, and who updated it. En outre, les entités standard contiennent des champs standard (par défaut).In addition, standard entities have standard (default) fields. Vous ne pouvez pas modifier ou supprimer des champs système ou standard.You can't modify or delete system fields or standard fields. Si vous créez un champ personnalisé, celui-ci doit fournir des fonctionnalités en plus de ces champs intégrés.If you create a custom field, it should provide functionality on top of these built-in fields.

Créer un champCreate a field

  1. Sur powerapps.com, développez la section Common Data Service, puis cliquez ou appuyez sur l’élément Entities (Entités) dans le volet de navigation gauche.On powerapps.com, expand the Common Data Service section and click or tap Entities in the left navigation pane. Une liste d’entités s’affiche.A list of entities appears. Pour afficher des entités personnalisées en haut de la liste, cliquez ou appuyez sur l’en-tête de colonne Type.To show custom entities at the top of the list, click or tap the Type column header. Vous pouvez également filtrer la liste en tapant un ou plusieurs caractères dans la barre de recherche.You can also filter the list by typing one or more characters in the search bar.
  2. Cliquez ou appuyez sur une entité, puis sur Add field près du haut de l’écran.Click or tap an entity, and then click or tap Add field near the top of the screen.
  3. Sous Display name (Nom d’affichage), spécifiez la chaîne de texte qui identifie le champ pour les utilisateurs.Under Display name, specify the string of text that will identify the field to users. Pour plus d’informations, voir Créer une application.For more information, see Create an app.
  4. Sous Name (Nom), spécifiez la chaîne de texte à utiliser pour faire référence au champ, par exemple, dans une formule lors de la génération d’une application.Under Name, specify the string of text that you will use to refer to the field in, for example, a formula when you build an app.

    Important : spécifiez un nom unique, clair et explicite, car vous ne pourrez plus le modifier après la création du champ.Important: Specify a name that's unique, clear, and meaningful, because you can't change the name after you create the field.

  5. Sous Type, spécifiez le type de données que le champ doit contenir, par exemple, Text (Texte) ou Number (Nombre).Under Type, specify the type of data that the field will contain, such as Text or Number.

    Important : spécifiez cette propriété avec précaution, car il se peut que vous ne puissiez plus la modifier lorsque le champ contiendra des données.Important: Specify this property carefully, because you might not be able to change it after the field contains data. Pour plus d’informations sur les types de données que vous pouvez spécifier, voir Comprendre les entités.For information about the types of data that you can specify, see Understand entities.

  6. Si vous y êtes invité, spécifiez des informations supplémentaires pour le type de données spécifié.If you're prompted, specify additional information for the data type that you specified.
  7. Sous Unique, activez la case à cocher si chaque enregistrement doit avoir une valeur unique dans ce champ.Under Unique, select the check box if every record must have a unique value in this field.
  8. Sous Required (Obligatoire), activez la case à cocher si chaque enregistrement doit avoir une valeur dans ce champ.Under Required, select the check box if every record must have a value in this field.

    Important : vous ne pouvez pas exiger qu’un champ personnalisé dans une entité standard contienne des données.Important: You can't require that a custom field in a standard entity contain data. Cette restriction vous empêche de nuire au fonctionnement d’applications dépendant de cette entité.This restriction prevents you from breaking any apps that rely on that entity.

  9. Cliquez ou appuyez sur Save pour envoyer vos modifications.Click or tap Save to submit your changes.

    Important : vos modifications seront perdues si vous ne les enregistrez pas avant d’ouvrir une autre page dans le navigateur ou de fermer le navigateur.Important: Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Vous êtes averti lorsque l’opération aboutit.You're notified when the operation is completed successfully. Si l’opération échoue, un message d’erreur indique les problèmes qui se sont produits et explique comment les résoudre.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Mettre à jour ou supprimer un champUpdate or delete a field

  1. Dans powerapps.com, cliquez ou appuyez sur Manage, sur Entities, puis sur une entité.On powerapps.com, click or tap Manage, click or tap Entities, and then click or tap an entity.
  2. Dans la liste des champs de l’entité que vous avez sélectionnés, cliquez ou appuyez sur un champ, puis procédez comme suit :In the list of fields for the entity that you selected, click or tap a field, and then follow one of these steps:

    • Modifiez une ou plusieurs propriétés du champ.Change one or more properties of the field. Gardez à l’esprit les meilleures pratiques et restrictions.Keep in mind the best practices and restrictions.

      Pour sélectionner la propriété suivante, appuyez sur Tab. Pour annuler toutes les modifications apportées à un champ, cliquez ou appuyez sur les points de suspension (...) en regard de celui-ci, puis sur Annuler.To select the next property, press Tab. To undo all changes to a field, click or tap the ellipsis (...) for the field, and then click or tap Undo.

    • Pour supprimer le champ, cliquez ou appuyez sur ses points de suspension (...) près du bord droit du champ, puis sur Delete (Supprimer).Delete the field by clicking or tapping the ellipsis (...) near the right edge of the field, and then clicking or tapping Delete.
  3. Cliquez ou appuyez sur Save pour envoyer vos modifications.Click or tap Save to submit your changes.

    Important : vos modifications seront perdues si vous ne les enregistrez pas avant d’ouvrir une autre page dans le navigateur ou de fermer le navigateur.Important: Your changes will be lost if you don't save them before you open another page in the browser or exit the browser.

Vous êtes averti lorsque l’opération aboutit.You're notified when the operation is completed successfully. Si l’opération échoue, un message d’erreur indique les problèmes qui se sont produits et explique comment les résoudre.If the operation is unsuccessful, an error message indicates the issues that occurred and how you can fix them.

Meilleures pratiques et restrictionsBest practices and restrictions

Lorsque vous créez et modifiez des champs, ayez à l’esprit les points suivants :As you create and modify fields, keep these points in mind:

  • Vous ne pouvez pas modifier ou supprimer des champs système ou les valeurs de ceux-ci.You can't modify or delete system fields or their values.
  • Dans une entité standard, vous ne pouvez pas modifier ou supprimer un champ standard (par défaut), ajouter un champ nécessitant des données, ou apporter toute autre modification susceptible de nuire au fonctionnement d’une application dépendant de cette entité.In a standard entity, you can't modify or delete a standard (default) field, add a field that requires data, or make any other change that might break an app that relies on that entity.
  • Dans une entité personnalisée, vous devez vous assurer que les modifications que vous apportez ne nuisent pas au fonctionnement des applications qui en dépendent.In a custom entity, you should make sure that the changes that you make won't break any app that relies on that entity.
  • Vous devez attribuer à chaque champ personnalisé un nom unique au sein de l’entité, et ne pouvez pas renommer un champ après l’avoir créé.You must give each custom field a name that's unique within the entity, and you can't rename a field after you create it.
  • Vous pouvez modifier le type de données de n’importe quel champ, pour autant que le champ ne contienne pas encore de données.You can change the data type of any field, provided that the field doesn't yet contain data. Si le champ contient déjà des données, vous pouvez modifier le type de données, à condition que toutes les données existantes remplissent les conditions du nouveau type de données.If the field already contains data, you can change the data type, provided that all the existing data meets the requirements of the new data type. Par exemple, vous pouvez modifier le type de données d’un champ de Number en String, mais vous ne pouvez pas passer de String à Number si le champ contient des données non numériques.For example, you can change the data type of a field from Number to String, but you can't change the data type from String to Number if the field contains non-numerical data.
  • Vous risquez de nuire au fonctionnement d’une application utilisant une entité si vous modifiez un champ de celle-ci d’une ou plusieurs des manières suivantes :You might break an app that uses an entity if you modify a field in that entity in one or more of these ways:
    • Vous modifiez le type de données du champ.You change the field's data type.
    • Vous exigez des valeurs, mais un ou plusieurs enregistrements ne contiennent pas de valeur dans ce champ.You require values, but one or more records don't contain a value in that field.
    • Vous exigez des valeurs uniques, mais plusieurs enregistrements contiennent la même valeur dans ce champ.You require unique values, but two or more records contain the same value in that field.

Étapes suivantesNext steps

Avis de confidentialitéPrivacy notice

Avec le modèle de données commun Microsoft PowerApps, nous collectons et stockons les noms d’entités et de champs personnalisés dans nos systèmes de diagnostic.With the Microsoft PowerApps common data model we collect and store custom entity and field names in our diagnostic systems. Ces informations nous servent à améliorer le modèle de données commun pour nos clients.We use this knowledge to improve the common data model for our customers. Les noms d’entités et de champs créés par les créateurs nous aident à comprendre les scénarios courants dans la communauté Microsoft PowerApps et à identifier les lacunes dans la couverture d’entités standard du service, telles que les schémas liés aux organisations.The entity and field names that Creators create help us understand scenarios that are common across the Microsoft PowerApps community and ascertain gaps in the service’s standard entity coverage, such as schemas related to organizations. Les données contenues dans les tables de base de données associées à ces entités ne font l’objet d’aucun accès ou d’aucune utilisation de la part de Microsoft et ne sont pas répliquées en dehors de la région d’approvisionnement de la base de données.The data in the database tables associated with these entities is not accessed or used by Microsoft or replicated outside of the region in which the database is provisioned. Notez toutefois que les noms d’entités et de champs personnalisés peuvent être répliqués dans différentes régions et sont supprimés conformément à nos politiques de rétention des données.Note, however, the custom entity and field names may be replicated across regions and are deleted in accordance with our data retention policies. Microsoft s’engage à respecter votre confidentialité, comme décrit plus en détail dans notre Centre de confidentialité.Microsoft is committed to your privacy as described further in our Trust Center.