Gérer les champs et les onglets d'une entité
Ajouter un champ, le rendre obligatoire, le déplacer dans un onglet, changer son type, éditer une liste de valeurs ou le supprimer
À quoi ça sert
Les champs sont les informations que porte une fiche : un nom, une date, un montant, un lien vers une autre fiche. Vous les créez, vous choisissez leur type, vous décidez lesquels sont obligatoires, et vous les répartissez dans des onglets pour que le formulaire reste lisible.
Tout se passe dans « CRM », « Administration », « Gérer mes entités », puis l'entité voulue, onglet « Propriétés ». Cet écran est réservé aux administrateurs du module CRM.
Le catalogue des types disponibles et leurs options sont décrits dans Les types de champs disponibles.
Concepts clés
- Champ — une information de la fiche. Il porte un label, un type et un nom technique.
- Nom technique — l'identifiant interne du champ, proposé automatiquement à partir du label. Il est définitif une fois le champ créé.
- Onglet — un regroupement de champs dans le formulaire et sur la fiche. Chaque champ appartient à un onglet et un seul.
- Champ système — un champ fourni avec l'application. Il ne peut être ni supprimé, ni déplacé par glisser-déposer.
- Requis / Unique / Recherchable / Visible / Lecture seule — les cinq comportements d'un champ, réglés dans l'onglet « Comportement » de son formulaire.
- Onglet général — l'onglet par défaut de toute entité. Il ne peut pas être supprimé.
Comment faire
Ajouter un champ
- Ouvrez l'entité, puis l'onglet « Propriétés ».
- Cliquez sur « Ajouter un champ ». Un volet s'ouvre sur la droite.
- Onglet « Détails » : saisissez le « Label d'affichage ». Le « Nom technique » est proposé automatiquement ; vous pouvez le corriger tant que le champ n'est pas créé.
- Choisissez l'« Onglet » dans lequel le champ doit apparaître.
- Choisissez le « Type de champ ». La liste est classée par catégorie et chaque type est décrit d'une phrase.
- Complétez la « Description » et le « Texte d'aide » si nécessaire, puis choisissez une « Icône ».
- Onglet « Configuration » : réglez les options propres au type choisi.
- Onglet « Comportement » : réglez « Obligatoire », « Unique », « Recherchable », « Visible », « Lecture seule » et, si besoin, « Visible uniquement par l'auteur ».
- Cliquez sur « Créer ».
Le message « Champ "{label}" créé avec succès » s'affiche et le champ apparaît dans le tableau de son onglet.
Modifier un champ
- Ouvrez l'entité, onglet « Propriétés », puis l'onglet qui contient le champ.
- Cliquez sur « Modifier » sur la ligne du champ.
- Modifiez les valeurs voulues, puis cliquez sur « Enregistrer ».
Le message « Champ "{label}" mis à jour avec succès » s'affiche. Le type et le nom technique ne sont plus modifiables : « Le type ne peut pas être modifié après création. »
Changer le type d'un champ
- Ouvrez le champ en modification.
- Cliquez sur « Changer le type ».
- Dans « Nouveau type », choisissez la cible parmi les types compatibles.
- Lisez les avertissements, puis cliquez sur « Migrer le type ».
Le message « Champ "{label}" migré vers {type} » s'affiche. Seules trois migrations sont proposées : « Texte » vers « Texte long », « Texte » vers « Texte enrichi », et « Texte long » vers « Texte enrichi ». Pour tout autre champ, le bouton n'apparaît pas. Le dialogue prévient que « Cette opération est irréversible. Le type d'un champ ne pourra pas être restauré. » et liste les paramètres qui seront réinitialisés.
Réordonner les champs d'un onglet
- Ouvrez l'entité, onglet « Propriétés », puis l'onglet voulu.
- Faites glisser une ligne par sa poignée jusqu'à sa nouvelle position.
Le message « L'ordre d'affichage des champs a été modifié. » s'affiche. L'ordre est enregistré immédiatement. Les champs système ne se déplacent pas : leur poignée est inactive.
Créer un onglet
- Ouvrez l'entité, onglet « Propriétés ».
- Cliquez sur l'icône « Gérer les onglets », à droite de la barre d'onglets.
- Cliquez sur « Ajouter un onglet ».
- Choisissez une icône et saisissez le nom de l'onglet.
- Validez.
Le message « L'onglet a été créé. » s'affiche.
Renommer, réordonner ou supprimer un onglet
- Ouvrez « Gérer les onglets ».
- Pour renommer : cliquez sur « Modifier l'onglet », changez le nom ou l'icône, puis « Enregistrer ». Message : « L'onglet a été renommé. »
- Pour réordonner : faites glisser l'onglet par sa poignée. Message : « L'ordre des onglets a été modifié. »
- Pour supprimer : cliquez sur « Supprimer l'onglet », puis confirmez par « Supprimer ». Message : « L'onglet a été supprimé. »
Un onglet ne peut pas être supprimé dans trois cas, indiqués par une infobulle : « L'onglet général ne peut pas être supprimé », « L'onglet système ne peut pas être supprimé », « Impossible de supprimer : l'onglet contient des champs ». Videz l'onglet de ses champs avant de le supprimer.
Éditer les valeurs d'une liste déroulante
- Ouvrez le champ en modification, onglet « Configuration ».
- Sous « Ajouter une nouvelle valeur », saisissez le « Libellé », choisissez la couleur, indiquez si la valeur est « Par défaut » et si elle est « Actif », puis cliquez sur « Ajouter ».
- Sous « Valeurs configurées », réordonnez les valeurs par glisser-déposer, modifiez un libellé ou une couleur, désactivez une valeur devenue obsolète.
- Cliquez sur « Enregistrer ».
Une valeur en doublon est refusée : « Cette valeur existe déjà ». Deux options gouvernent le comportement de la liste : « Ordre alphabétique » trie les valeurs à l'affichage, « Option d'édition » ajoute un bouton d'édition à côté du champ sur la fiche pour que les utilisateurs puissent eux-mêmes compléter la liste.
Supprimer un champ
- Ouvrez l'entité, onglet « Propriétés », puis l'onglet du champ.
- Cliquez sur « Supprimer » sur la ligne du champ.
- Confirmez par « Supprimer ».
Le message « Champ "{label}" supprimé avec succès » s'affiche. Le dialogue prévient : « Cette action est irréversible et supprimera définitivement ce champ ainsi que toutes ses données associées. » Un champ système ne peut pas être supprimé : « Les champs système ne peuvent pas être supprimés ».
Si le champ est utilisé ailleurs (voir « Champ utilisé ailleurs » ci-dessous), le dialogue de suppression le rappelle avant de confirmer ; ce n'est qu'informatif, la suppression reste possible.
Référence
Le formulaire d'un champ
| Onglet | Contenu |
|---|---|
| Détails | Label d'affichage, nom technique, onglet, type, description, texte d'aide, icône |
| Configuration | Les options propres au type choisi (voir Les types de champs disponibles) |
| Comportement | Obligatoire, unique, recherchable, visible, lecture seule, visible uniquement par l'auteur, groupes autorisés, limitation d'accès |
Comportements d'un champ
| Réglage | Effet |
|---|---|
| Obligatoire | Le champ doit être rempli pour enregistrer la fiche |
| Unique | Deux fiches ne peuvent pas porter la même valeur |
| Recherchable | Le champ est inclus dans la recherche globale |
| Visible | Le champ est affiché dans les formulaires |
| Lecture seule | Le champ n'est pas modifiable par les utilisateurs |
| Visible uniquement par l'auteur | Seule la personne ayant renseigné la valeur la voit, dans la liste, sur la fiche et dans l'historique |
Quatre types de champs ne peuvent pas être rendus obligatoires, l'option étant alors désactivée : « One-to-Many », « Propriété liée », « Web Service » et « Source Web Service ». Un champ fichier configuré avec une gestion d'expiration non plus : « Non applicable a un champ fichier avec gestion d'expiration ».
Trois types sont toujours en lecture seule et l'indiquent : « Les champs somme sont toujours en lecture seule », « Les champs formule sont toujours en lecture seule », « Toujours activé pour les champs One-to-Many ».
Les réglages « Groupes autorisés » et « Limitation d'accès » sont décrits dans Visibilité et permissions par groupe.
Contraintes sur le nom technique
| Message | Situation |
|---|---|
| « Nom du champ est requis » | Nom technique vide |
| « Le nom technique ne peut contenir que des lettres non accentuées, des chiffres et des underscores, et doit commencer par une lettre ou un underscore » | Caractère interdit |
| « Le nom technique ne peut pas dépasser 50 caractères » | Nom trop long |
| « Ce nom technique est un mot réservé, veuillez en choisir un autre » | Nom réservé par l'application |
| « Un champ utilise déjà ce nom technique dans cette entité » | Nom déjà pris sur l'entité |
Le formulaire rappelle la règle sous le champ : « Lettres non accentuées, chiffres et underscores uniquement. Définitif une fois le champ créé. »
Le tableau des champs
Colonnes : « Ordre », « Nom », « Type », « Propriétés », « Description », « Actions ». La colonne « Propriétés » porte les badges « Requis », « Unique », « Recherchable », « Masqué », « Lecture seule » et « Système ».
Quatre compteurs figurent en haut de l'onglet « Propriétés » : « Total champs », « Obligatoires », « Système », « Visibles ». Chaque onglet de la barre affiche le nombre de champs qu'il contient.
Migrations de type autorisées
| Type d'origine | Types cibles proposés |
|---|---|
| Texte | Texte long, Texte enrichi |
| Texte long | Texte enrichi |
| Tous les autres types | Aucune — « Aucune migration de type n'est disponible pour ce champ. » |
Un champ système n'est jamais migrable.
Champ utilisé ailleurs
Quand un champ est référencé par une règle d'automatisation ou lu par un widget KPI, une carte « Utilisé ailleurs » s'affiche dans le formulaire du champ, quel que soit l'onglet ouvert, et dans le dialogue de suppression. Elle liste les règles d'automatisation concernées (les modifier ou renommer le champ peut affecter leur fonctionnement) et les widgets KPI qui le lisent, avec leur propriétaire quand ce n'est pas vous (le renommer, changer son type ou le supprimer peut vider ces widgets). Elle est informative : elle n'empêche ni l'enregistrement, ni la suppression du champ.
Questions fréquentes
Puis-je changer le type d'un champ après coup ? Seulement entre types de texte : « Texte » vers « Texte long » ou « Texte enrichi », et « Texte long » vers « Texte enrichi ». Pour tout autre changement, créez un nouveau champ.
Puis-je déplacer un champ d'un onglet à un autre ? Oui : ouvrez le champ en modification et changez la valeur du champ « Onglet ». Le glisser-déposer, lui, ne réordonne les champs qu'à l'intérieur d'un même onglet.
Pourquoi ne puis-je pas supprimer cet onglet ? Trois raisons possibles, indiquées par l'infobulle du bouton : c'est l'onglet général, c'est un onglet système, ou l'onglet contient encore des champs.
Un champ masqué est-il supprimé ? Non. Décocher « Visible » retire le champ des formulaires mais conserve les valeurs déjà saisies ; il reste marqué « Masqué » dans le tableau des champs.
Raccourcis de navigation et blocs d'accueil
Ordonner les entités dans les raccourcis, configurer le bloc de recherche de la page d'accueil et les créations récentes
Configurer une connexion Web Service
Déclarer une API externe, choisir son authentification, la tester et comprendre ce que sa suppression casse