Aller au contenu

Modules personnalisés

Pourquoi c'est important

Les modules personnalisés sont des modules que votre cabinet crée pour des besoins que les modules de base ne couvrent pas. Exemples typiques :

  • Catalogue d'écoles pour un cabinet qui gère beaucoup de dossiers d'étudiants.
  • Liste d'employeurs approuvés pour les dossiers EIMT.
  • Événements passés pour la consignation de séminaires et promotions.
  • Polices si votre cabinet offre aussi de l'assurance santé pour nouveaux arrivants.

ImmCase est piloté par métadonnées : pas besoin d'écrire du code pour ajouter un module. Vous le configurez depuis l'interface administrative et il apparaît comme tout autre module natif, avec ses permissions, ses vues, ses champs, ses modèles.

Créer un module personnalisé

  1. Barre latérale → Paramètres → Modules → Créer.
  2. Remplissez les bases :
  3. Nom (singulier et pluriel).
  4. Clé technique — minuscules, pas d'espaces, pas de caractères spéciaux (par exemple, schools ou policies).
  5. Type : Personnalisé.
  6. Groupe de menu — où il apparaît dans la barre latérale.
  7. Table — le nom de la table en base de données (auto-générée à partir de la clé).
  8. Enregistrer.

ImmCase : - Crée la table en base de données automatiquement. - Ajoute le module à la barre latérale. - Crée les permissions de base (view, create, edit, delete). - Établit la structure de base (champs id, created_at, updated_at, deleted_at, etc.).

Ajouter des champs

Tout de suite après la création du module, configurez ses champs :

  1. Ouvrez le module → onglet Champs.
  2. Ajouter un champ → remplissez nom, type (texte, nombre, date, liste, relation), validation.
  3. Enregistrer.

Chaque champ ajouté devient une colonne dans la table du module en base de données. Plus dans Champs.

Configurer les relations

Si votre module se connecte à d'autres (par exemple, écoles liées à des dossiers) :

  1. Onglet Relations.
  2. Ajouter une relation → type (belongsTo, hasMany, etc.) → module cible.
  3. Enregistrer.

Plus dans Relations entre modules.

Configurer les visibilités

Par défaut, les champs du nouveau module apparaissent partout (liste, détail, formulaire, etc.). Pour restreindre :

  • Onglet Visibilités → cochez où chaque champ apparaît.

Plus dans Visibilités de champs.

Permissions du module

Les permissions de base sont créées automatiquement à la création du module. Attribuez-les aux rôles et profils :

  • Ouvrez le rôle ou le profil → Permissions → cherchez le nouveau module → attribuez.

Tant que vous n'avez pas attribué de permissions, seul Super Admin peut accéder au nouveau module.

Dossiers automatiques et modèles

Si votre module personnalisé aura besoin de :

  • Dossiers automatiques (chaque fiche a son dossier pour les fichiers) : configurez dans la Structure de dossiers du module.
  • Modèles PDF spécifiques : créez-les dans Modèles PDF et liez-les au module.
  • Flux de travail pour automatiser : dans Flux de travail, choisissez ce module comme déclencheur.

À surveiller

  • Ne créez pas de modules qui en dupliquent d'autres. Si vous avez besoin de « Étudiants » et que vous avez déjà « Demandeurs » avec un champ type=étudiant, ne créez pas de nouveau module. Utilisez des filtres. Créer un module parallèle fragmente les données.
  • Réfléchissez bien à la clé technique. Elle ne peut pas être changée. En cas de doute, choisissez des noms génériques et durables.
  • Testez avec un utilisateur avant de l'activer pour tous. Créez le module, attribuez-le seulement à votre profil d'admin, testez, ajustez, et alors seulement étendez les permissions à l'équipe.
  • Ne surutilisez pas. Si votre cabinet se retrouve avec 50 modules personnalisés, la barre latérale devient ingérable. Révisez périodiquement et supprimez ceux qui ne servent plus.

Pour la suite