Aller au contenu

Champs

Pourquoi c'est important

Les champs sont les « colonnes » d'un module : nom, courriel, date de naissance, numéro de passeport. En tant qu'administrateur, vous pouvez ajouter, modifier, masquer et configurer les champs sur tout module personnalisé, et modifier la configuration (étiquette, validation, visibilité) des champs des modules de base.

Types de champs

  • Texte court — une ligne (nom, NEQ).
  • Texte long — plusieurs paragraphes (notes, adresse).
  • Nombre — entier ou décimal.
  • Devise — nombre avec formatage de devise.
  • Booléen — oui/non, vrai/faux.
  • Date et Date et heure.
  • Liste déroulante — sélection dans une liste prédéfinie.
  • Liste multiple — plusieurs sélections.
  • Relation — pointe vers une fiche d'un autre module (belongsTo).
  • Fichier — téléversement direct.
  • Calculé — valeur calculée à partir d'autres champs.

Ajouter un champ

  1. Ouvrez le module → onglet Champs → Ajouter un champ.
  2. Remplissez :
  3. Nom technique — utilisé en BD et URL (first_name, passport_number). Ne se changera pas après.
  4. Étiquette — ce que voit l'utilisateur (peut différer selon la langue).
  5. Type — dans la liste ci-dessus.
  6. Obligatoire — si coché, la fiche ne peut être enregistrée sans lui.
  7. Défaut — valeur initiale (facultatif).
  8. Validation — format attendu (courriel, téléphone, regex).
  9. Cherchable — inclus dans la recherche globale.
  10. Enregistrer.

ImmCase ajoute la colonne correspondante à la table du module en base de données.

Capture d'écran : éditeur de champ avec type de champ et options

Champs calculés

Un champ calculé ne se remplit pas — il est calculé automatiquement à partir d'autres champs.

Exemple : champ nom_complet calculé comme CONCAT(first_name, ' ', last_name).

  1. Type : Calculé.
  2. Expression — formule SQL ou de modèle.
  3. Déclencheur — quand recalculer : à la création, à la modification, toujours.

Utile pour les noms complets, totaux, âges calculés depuis la date de naissance, etc.

Nom à afficher (display_name)

Chaque module a un champ spécial display_name qui définit comment la fiche s'affiche dans les listes et références. Par exemple, un demandeur peut s'afficher comme <folio> - <nom complet>.

Configurez-le dans Champs → champ display_name → expression.

Pour recalculer toutes les fiches existantes après l'avoir changé, utilisez la commande admin modules:finalize-records (ou demandez à votre administrateur technique).

Listes déroulantes liées

Un champ Liste déroulante ne stocke pas le texte de la valeur — il stocke l'ID de l'option. Les options se gèrent dans Listes déroulantes.

À la création d'un champ Liste déroulante, vous choisissez quel groupe d'options il utilise.

Validation

Chaque champ peut avoir des règles :

  • Format — courriel, téléphone, NEQ.
  • Longueur — minimum, maximum.
  • Plage — pour nombres ou dates.
  • Unique — pas deux fiches avec la même valeur.

Les validations s'appliquent au formulaire et à l'API. Si une valeur invalide vient d'une autre source (importation), ImmCase la rejette.

À surveiller

  • Ne changez pas le type d'un champ ayant des données. Si un champ Texte contient 10 000 fiches et que vous le passez à Nombre, les données peuvent se corrompre. Si vous devez changer de type, créez un nouveau champ et migrez les données.
  • Ne supprimez pas un champ sans vérifier les dépendances. D'autres champs calculés, modèles, flux de travail ou rapports peuvent le référencer. Vous casserez tout si vous supprimez sans vérifier.
  • Renommer le nom technique — impossible. Si vous avez mal saisi, créez-en un nouveau et supprimez l'ancien, ou vivez avec le nom étrange.

Pour la suite