Files
upstream-twenty/packages/twenty-docs/l/fr/user-guide/data-model/capabilities/fields.mdx
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

123 lines
7.7 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Champs
description: Comprendre le rôle des champs et comment les gérer.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## À propos des Champs
Les champs sont comme les colonnes d'une feuille de calcul. Ils stockent différents types de données comme du texte, des chiffres ou des dates. Les champs peuvent être standard (intégrés) ou personnalisés (ceux que vous créez).
### Champs Standards
Les champs standard sont intégrés à Twenty pour répondre aux besoins professionnels courants.
Par exemple, `Prénom` et `Nom de famille` sont des champs standards dans l'objet `Personnes`. Ils stockent des données textuelles pour les noms individuels.
Vous ne pouvez pas supprimer les champs standard, mais vous pouvez les désactiver si vous n'en avez pas besoin.
Vous pouvez également personnaliser les options des champs standard de type `SELECT`, par exemple les options pour l’`Étape` des Opportunités.
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### Champs Personnalisés
Les champs personnalisés peuvent être ajoutés à n'importe quel objet. Vous pouvez stocker du texte, des chiffres, des dates, des sélections déroulantes, et plus encore. Utilisez les champs personnalisés pour suivre des informations spécifiques à votre entreprise.
Par exemple, un champ personnalisé pour SpaceX pourrait être `Statut Actif de la Fusée`, indiquant si une fusée est opérationnelle.
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## Types de champs
Twenty prend en charge divers types de champs :
| Type | Description | Exemple |
| ------------------ | ----------------------------------------------------------- | -------------------------- |
| Adresse | Adresse structurée avec rue, ville, état, pays, code postal | Adresse du bureau |
| Tableau | Liste de valeurs textuelles | Étiquettes |
| Booléen | Case à cocher vrai/faux | Actif |
| Devise | Valeur monétaire avec code de devise | Montant de l’affaire (USD) |
| Date | Valeurs de date | Date de clôture |
| Date et heure | Date avec heure | Heure de réunion |
| Domaine | Domaine de site web (utilisé pour les Entreprises) | acme.com |
| E-mail | Adresses e-mail (principale + supplémentaires) | Adresse e-mail du contact |
| JSON | Données JSON structurées | Métadonnées personnalisées |
| Liens | URL avec libellés (primaire + secondaire) | Site web, LinkedIn |
| Texte long | Texte sur plusieurs lignes | Description, Notes |
| Sélection multiple | Choix multiples à partir d’une liste prédéfinie | Étiquettes, Catégories |
| Nombre | Valeurs numériques (entières ou décimales) | Quantité, Score |
| Téléphone | Numéros de téléphone avec indicatif du pays | Téléphone professionnel |
| Note | Notation par étoiles (1-5) | Priorité, Score |
| Relation | Liens vers des enregistrements dans d’autres objets | Entreprise → Personnes |
| Sélection | Choix unique à partir d’une liste prédéfinie | Étape, Statut |
| Texte | Texte sur une seule ligne | Nom, Titre |
## Créer un Champ Personnalisé
Pour ajouter un champ personnalisé à n'importe quel objet, suivez ces étapes:
1. Allez dans les `Paramètres` dans la barre latérale gauche.
2. Allez dans le `Modèle de Données`, puis sélectionnez l'objet que vous souhaitez personnaliser.
3. Continuez en cliquant sur `+ Nouveau champ`.
4. Choisissez un nom de champ et un type qui répondent à vos exigences. Envisagez d'ajouter une description du champ pour une meilleure compréhension.
Votre nouveau champ est maintenant disponible dans les champs de l'application. Pour l'afficher sur une vue spécifique, cliquez sur le menu des options, puis sélectionnez `Champs`.
<VimeoEmbed videoId="927628219" title="Démonstration vidéo" />
**Méthode rapide:** Cliquez sur le bouton **+** en haut à droite de tout tableau d'objet, puis sélectionnez `Personnaliser les champs`. Cela vous amène directement aux paramètres du Modèle de Données.
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## Désactiver un champ
Vous pouvez désactiver un champ pour le masquer dans l'application sans perdre vos données. Considérez cela comme masquer le champ plutôt que de le supprimer.
Voici comment vous pouvez le faire:
1. Trouvez le champ que vous voulez désactiver dans vos paramètres d'objet.
2. Cliquez sur les trois points `⋮` à côté du champ pour ouvrir le menu.
3. Sélectionnez `Désactiver` dans le menu déroulant.
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
Que se passe-t-il lorsque vous désactivez un champ?
1. **Dans l'application :** Le champ disparaît et vous ne pouvez plus ajouter de nouvelles valeurs.
2. **Relations existantes :** S'il s'agit d'un champ de relation, les connexions existantes restent, mais vous ne pouvez pas en créer de nouvelles.
3. **Accès API :** Vous pouvez toujours accéder au champ et à ses données par l'API.
Vous pouvez réactiver les champs standards et personnalisés ou avoir l'option de les supprimer définitivement.
## Rendre les Champs Uniques
Rendez un champ unique pour garantir que des enregistrements distincts ne peuvent pas avoir la même valeur. Par exemple, les adresses e-mail sont uniques pour chaque personne.
Si vous obtenez une erreur lors de la définition de l'unicité, vérifiez les valeurs en double dans vos données (y compris les enregistrements supprimés).
## Index (avancé)
Les index de base de données sont gérés automatiquement — ajouter les vôtres est rarement nécessaire et il est facile de se tromper. Lorsque le mode avancé est activé, chaque objet possède une section **Index** sous `Paramètres → Modèle de données → <object>` pour les cas où vous savez que vous en avez besoin.
## Bonnes pratiques de configuration des champs
### Conventions de nommage et limitations
* **Les noms au singulier et au pluriel doivent être distincts** : Notre API GraphQL nécessite des noms distincts pour les mutations
* **Noms de champs protégés** : certains noms sont réservés à l’usage du système (par exemple, `Type`, `Application`)
### Champs de devise et de téléphone
* **Devise par défaut** : peut être configurée via le modèle de données
* **Codes de pays par défaut** : peuvent être configurés pour les champs téléphoniques via le modèle de données
### Champs de sélection
* **Une option par défaut peut être sélectionnée** pour chaque champ de sélection
### Champs de texte d'enregistrement
* **Chaque objet a un champ d'affichage principal**: Ce champ apparaît dans la colonne la plus à gauche et représente l'enregistrement lorsqu'il est lié à d'autres objets. Il doit s'agir d'un champ de texte. Par exemple, le champ `Nom` est utilisé pour les Personnes comme champ principal, donc lorsque vous liez une personne à une entreprise, vous verrez son nom dans la vue de l'entreprise.