Tables de base

De wiki-iren
Révision datée du 13 avril 2026 à 10:05 par ELiA (discussion | contributions) (Documentation fonctionnelle mise a jour depuis les brouillons locaux)
Aller à la navigation Aller à la recherche

La page des tables de base regroupe les paramétrages transverses d'iREN. Elle alimente les formulaires, les listes de choix, certains écrans de gestion avancée et plusieurs comportements métier visibles dans le dossier, l'agenda, les factures, les devis, les commandes, la Médiathèque ou les Échanges internes.

Cette page a été revue sur l'environnement de recette en version 1.14.0.305 le 13/04/2026. Les captures sont historisées par date et par version afin de conserver la lecture des évolutions de l'outil.

Version 1.14.0.305 du 13/04/2026 - vue générale des tables de base
Version 1.14.0.305 du 13/04/2026 - vue générale des tables de base

Rôle des tables de base

Les tables de base servent de référentiel commun à iREN. Elles permettent de centraliser dans une même page :

  • les listes de valeurs utilisées dans les écrans métier
  • les libellés et codifications affichés aux utilisateurs
  • certains paramétrages de pilotage plus avancés, comme les modèles, les statuts alternatifs, les bordereaux de prix ou des règles de comptabilité
  • des paramétrages qui ne sont pas visibles partout, mais qui influencent ensuite le comportement d'autres modules

Fonctionnellement, la page n'est donc pas un simple annuaire de codes. C'est un point d'administration transverse.

Une modification réalisée ici peut avoir un effet direct sur :

Repère technique : le référentiel actif est chargé depuis TablesDeBase.xml. Au 13/04/2026, il contient 14 catégories, 28 sous-catégories et 54 tables effectivement déclarées.

Comprendre l'écran

L'écran est organisé en quatre zones complémentaires.

1. L'arborescence de navigation

La colonne de gauche présente l'arborescence des catégories, sous-catégories et tables.

Elle permet de :

  • parcourir les familles de paramétrage
  • retrouver rapidement une table grâce à la zone de recherche
  • ouvrir directement une table sans passer par plusieurs écrans intermédiaires

La recherche agit sur les libellés visibles. Elle est pensée pour la consultation quotidienne :

  • elle ignore les différences d'accents
  • elle ouvre automatiquement les niveaux parents utiles
  • elle affiche un message Aucun résultat si aucune correspondance n'est trouvée

Certaines catégories ne sont pas toujours affichées :

  • Plateforme n'apparaît que sur un site géré en contexte plateforme
  • Sous-Traitance n'apparaît que sur un site géré en contexte sous-traitance

Un bloc Cache API peut aussi apparaître sous l'arborescence. Sur l'environnement observé, il n'est visible que pour le compte EURO.

2. La liste centrale

La zone centrale affiche les lignes de la table sélectionnée.

Elle sert à :

  • lire rapidement le contenu du référentiel
  • ajouter une nouvelle ligne lorsque la table l'autorise
  • trier la liste
  • ouvrir une ligne existante pour la consulter ou la modifier

Selon la table choisie, cette zone peut également afficher :

  • un filtre par cabinet
  • un filtre par famille
  • un filtre texte par nom
  • un bloc Import / Export

3. Le panneau de détail

La zone de droite affiche le détail d'une ligne sélectionnée pour les tables gérées par le moteur standard.

Ce panneau est utile lorsque la table suit une logique simple :

  • iREN charge la ligne
  • iREN affiche les champs configurés pour cette table
  • l'utilisateur peut ensuite enregistrer sa modification sans quitter l'écran

4. La zone complexe

Certaines tables ne se limitent pas à une liste et à quelques champs. Dans ce cas, iREN charge un composant dédié dans la zone basse ou redirige vers un écran spécialisé.

Ce fonctionnement concerne par exemple :

Comment iREN organise les paramétrages

La page des tables de base regroupe en réalité plusieurs façons de paramétrer un référentiel. C'est ce point qui explique pourquoi toutes les tables ne réagissent pas de la même manière.

Table simple

Une table simple suit la logique la plus lisible :

  • une ligne dans la grille
  • un détail à droite
  • un bouton Ajouter
  • une sauvegarde directe depuis l'écran

Le moteur décide ensuite comment présenter chaque champ :

  • champ texte libre
  • liste déroulante lorsqu'il existe un jeu de valeurs possibles
  • champ protégé en lecture seule lorsque le paramétrage le prévoit
  • champ masqué en mode mot de passe pour certains cas particuliers

L'exemple le plus parlant sur la recette observée est Familles/Fonction, qui montre bien la logique grille + détail.

Table simplex

Une table simplex ajoute un niveau de contexte avant d'afficher les lignes.

Fonctionnellement, cela signifie que l'utilisateur doit d'abord choisir une valeur de pilotage, puis seulement ensuite consulter ou modifier les lignes associées.

Sur le référentiel actuel, cette logique est utilisée pour :

  • Liaison source Mandant

Cette variante est utile lorsque le même paramétrage doit être consulté à travers une famille, une source ou un regroupement préalable.

Table complexe

Une table complexe correspond à un paramétrage dont la logique métier dépasse la simple édition d'une ligne.

Dans ces cas, iREN peut :

  • afficher une liste pilotée par des filtres complémentaires
  • ouvrir un composant dédié dans la partie basse de la page
  • rediriger vers un écran spécialisé d'ajout ou de modification

Cette logique est utilisée pour des paramétrages plus structurants, comme :

Repères techniques : le moteur distingue les modes Table, TableSimplex et TableComplexe. La structure, les champs, les listes de valeurs, les filtres et les méthodes de chargement sont décrits dans TablesDeBase.xml, puis interprétés par GestionTables.vb et Tables.aspx.vb.

Règles communes de gestion

Même si toutes les tables n'ont pas la même profondeur métier, plusieurs règles sont communes à l'ensemble de la page.

Recherche et accès direct

La page peut être ouverte de façon transverse depuis d'autres modules. En pratique, certains écrans ouvrent directement l'onglet ou la table utile pour éviter une recherche manuelle.

Ce principe est utilisé notamment pour atteindre plus vite :

  • des modèles SMS
  • des modèles de mail
  • des actions
  • certains types de rendez-vous
  • des paramétrages comptables
  • les statuts alternatifs

La page joue donc un rôle de carrefour. Elle ne sert pas seulement à "ranger" des listes, elle sert aussi de point d'entrée vers des réglages ciblés.

Lecture et tri des listes

Lorsqu'une table est sélectionnée :

  • iREN recharge la grille associée
  • le titre central se met à jour avec le nom de la table
  • le tri est réinitialisé
  • la première logique de tri repart en ordre décroissant, puis alterne selon les clics utilisateur

Si la table demande un contexte particulier, iREN affiche en plus le filtre adapté.

Ajout et modification

Le bouton Ajouter n'a pas toujours la même portée fonctionnelle :

  • pour une table simple, il ouvre directement le formulaire de saisie
  • pour une table complexe, il peut ouvrir un écran dédié
  • pour certains cas protégés, il peut être masqué

Au moment de la saisie, le moteur applique plusieurs règles communes :

  • les champs numériques attendent une vraie valeur numérique
  • les listes de valeurs sont proposées en liste déroulante lorsqu'elles existent
  • les champs marqués en lecture seule restent non modifiables
  • la taille maximale d'un champ texte est ajustée à la structure réelle de la base

Une règle métier explicite a été conservée sur Familles/Fonction :

  • les familles CI et GE doivent toujours rester visibles
  • si l'on essaie de les masquer, iREN refuse l'enregistrement

Cette règle est importante car ces familles structurent ensuite plusieurs usages métier autour des mandants et de la lecture du dossier.

Suppression

La suppression d'une ligne demande toujours une confirmation.

Selon la table, deux comportements sont possibles :

  • la suppression est acceptée et la liste est rechargée
  • la suppression est refusée car la donnée est protégée, encore utilisée ou gérée par une logique spécifique

Lorsque la suppression n'est pas possible, iREN affiche un message dédié au lieu de faire disparaître la ligne de manière silencieuse.

Paramétrages pilotés par cabinet

Toutes les tables ne sont pas globales.

Certaines sont pilotées par cabinet ou par site, ce qui explique l'apparition d'une liste de sélection comme sur Dossier comptable, Aiguillage des sources, Banques, Modèles de mail ou Modèles SMS automatique.

Fonctionnellement, cela signifie que :

  • le référentiel ne s'applique pas forcément à tous les cabinets
  • le choix du cabinet fait partie de la lecture correcte de la table
  • selon le profil, l'utilisateur ne voit pas forcément la liste complète de tous les sites

Sur la logique observée :

  • le compte EURO peut accéder à une liste plus large
  • les autres profils sont limités à leur périmètre de site sur plusieurs tables

Import et export

Le bloc Import / Export n'est pas un comportement générique affiché partout.

Sur le référentiel observé le 13/04/2026, il est activé sur :

  • Bibliotheque Divers

Le fonctionnement attendu est strict :

  • l'import attend un fichier .xlsx
  • les en-têtes Excel doivent reprendre les libellés visibles de la table, et non les noms techniques des champs
  • lorsqu'un champ utilise une liste de valeurs, iREN remappe la valeur visible vers la valeur stockée

L'export suit la logique inverse :

  • iREN repart des données stockées
  • iREN remplace les codes par les libellés visibles lorsqu'une liste de valeurs existe
  • iREN renomme les colonnes avec les libellés de la table
  • iREN produit un fichier Excel directement exploitable

Fonctionnellement, ce bloc sert donc surtout aux référentiels qui gagnent à être alimentés en masse ou relus hors écran.

Repères techniques :

  • l'affichage du bloc dépend de l'attribut afficherimportexport="1" dans TablesDeBase.xml
  • l'import passe par Import_Depuis_Tables_De_Base
  • l'export passe par Export_Depuis_Tables_De_Base

Parcourir les familles de paramétrage

Au 13/04/2026, la page est structurée autour des familles suivantes.

  • Annuaire paramètre les intitulés, les formules de politesse, les types de média, les familles / fonctions et les comptes Exchange à synchroniser.
  • Antécédents pilote la gestion des critères de rapprochement entre un nouveau dossier et un dossier déjà existant.
  • Bordereaux de prix regroupe la bibliothèque de divers, les natures de dommages, les bordereaux, leurs correspondances et les ajouts automatiques.
  • Comptabilité concentre le paramétrage logiciel, les modes de règlement, l'aiguillage des sources, les banques et les dossiers comptables.
  • Dossier gère les actions automatiques enchaînées, les familles de nature de sinistre, les natures de sinistre, les types de mission et les types d'assuré.
  • Échanges internes permet de maintenir les intitulés d'objet proposés dans les échanges internes.
  • Evénement regroupe les actions, les familles d'action, les commentaires d'événements, les événements extérieurs, les modèles SMS automatiques, les modèles de mail et les types de rendez-vous.
  • Facture expose ici le référentiel des taux de TVA.
  • Implications regroupe les rôles, qualités, qualifiants et paramètres d'assujettissement à la TVA.
  • Médiathèque pilote les catégories et sous-catégories de pièces jointes.
  • Planning gère le référentiel des types d'actions générales.
  • Plateforme ajoute des tables spécifiques aux entreprises partenaires, aux types de documents juridiques, aux contrats, aux anomalies et au statut établissement.
  • Sous-Traitance ajoute des tables spécifiques au contexte de sous-traitance, notamment les corps de métier et les types de facturation.
  • Statuts alternatifs permet de piloter des statuts complémentaires pour les Devis, les commandes et les factures.

Cette cartographie permet d'utiliser la page comme une porte d'entrée transverse. Quand on cherche un paramétrage, il est souvent plus simple de partir de sa famille métier que de partir de son nom technique.

Points d'attention

Les tables de base donnent une grande souplesse de paramétrage, mais elles demandent aussi de la prudence.

Avant de modifier une table, il faut garder en tête que :

  • certaines tables ont une portée strictement locale
  • d'autres ont une portée transverse sur plusieurs modules
  • plusieurs référentiels alimentent ensuite des exports, des documents ou des automatisations

Une bonne pratique consiste à :

  • identifier d'abord le module métier concerné
  • vérifier si une page dédiée existe déjà dans le wiki
  • tester la modification sur la recette lorsqu'elle touche un comportement transverse

Repères techniques : les comportements d'ouverture, de chargement, de filtre, de sauvegarde, de suppression, d'import et d'export sont portés principalement par Tables.aspx, Tables.aspx.vb et GestionTables.vb.