Extractions v2 — écrans « Liste complète »

Doc fonctionnelle : décrit le quoi et le pourquoi (point de vue utilisateur / chef de projet).

À quoi ça sert

Les extractions sont les écrans « Liste complète » de la page Données : sortir la totalité d'un référentiel (entités, adresses, utilisateurs, contrats, parc informatique, tickets, projets, activités santé, états des lieux) sous forme de tableau exhaustif, le filtrer, choisir ses colonnes, puis l'exporter en Excel ou PDF.

Historiquement ces 20 écrans étaient des grilles jQuery (Core_Grid / DataTables) pilotées par du SQL stocké en base, sans filtrage par entité ni par droits. Ils sont désormais servis par des tableaux TableWire sous la famille d'URL /extractions/{id} : mêmes colonnes, même vocation, mais le périmètre des données est borné à l'entité mère et aux droits de l'utilisateur, et les préférences d'affichage sont mémorisées.

Les 20 extractions du catalogue sont migrées. Les anciens écrans (/exp/basic/{id}, /extraction/{id}) n'ont pas été coupés : ils restent atteignables par URL directe.

Comment y accéder

• Page Données (/datas/home) : chaque carte « Export — … » liste ses extractions ; le bouton ouvre /extractions/{id}.
• Une extraction n'apparaît pas si l'entité n'a pas souscrit au module requis. Si aucune extraction d'une carte n'est accessible, la carte entière disparaît (plutôt qu'un 403 après clic).
• Depuis l'annuaire clients (/datas/customers, contexte prestataire), les boutons pointent encore vers l'export legacy /exp/presta/{id} : ce périmètre-là n'est pas migré.

Le catalogue

Une colonne peut être exportable sans être affichée par défaut : l'extraction Tickets, par exemple, affiche 24 colonnes à l'écran mais en propose 45 à l'export. Chaque écran a désormais sa propre doc dédiée (fonc + technique) ; ceux déjà documentés sont liés dans le tableau, les autres suivent au fil du chantier. La colonne Onglet Partage est décrite juste en dessous.

Le droit indiqué est celui réellement consulté. Il ne correspond pas toujours à celui déclaré par l'ancienne configuration : l'arborescence documentation (1020) s'appuie sur le droit de la documentation, et les états des lieux sur celui des entités (1016, 1017) ou des adresses (1018), les valeurs legacy pointant sur des éléments morts ou sur un autre module.

Second onglet « Données Clients / Partage » (prestataire premium)

17 des 20 extractions exposent un second onglet, visible uniquement pour un compte prestataire premium (offre Prestamium) : 1000, 1001, 1002, 1004, 1005, 1006, 1007, 1008, 1010, 1011, 1013, 1014, 1015, 1016, 1017, 1018, 1019.

• L'onglet « Données internes » (par défaut) reste inchangé : périmètre de la seule entité mère du prestataire, comme avant.
• L'onglet « Données Clients / Partage » restitue le même référentiel mais élargi aux clients qui ont explicitement partagé leur accès avec ce prestataire — jamais l'ensemble du portefeuille, seulement les clients ayant accordé le partage. Une colonne d'identification du client (ou une ligne par client, selon l'écran) permet de distinguer la provenance de chaque ligne.
• L'onglet n'apparaît pas du tout (ni le bouton, ni la route) pour un compte qui n'est pas prestataire premium : ce n'est pas un onglet visible-mais-vide.
• Filtres, colonnes visibles et tri de cet onglet sont mémorisés séparément de l'onglet « Données internes » : personnaliser l'affichage de l'un ne modifie pas l'autre.
• L'export (Excel / PDF) de l'onglet Partage applique exactement les mêmes règles de périmètre que l'écran : impossible d'obtenir plus de données en forgeant l'URL d'export.
• Basculer d'un onglet à l'autre est instantané (pas de rechargement de page) : le second onglet reste chargé en arrière-plan dès l'ouverture de l'écran, prêt à s'afficher. Un rafraîchissement de la page (F5) rouvre le bon onglet, celui sur lequel on se trouvait.

Restent sans cet onglet, faute de périmètre de partage pertinent ou de brique technique réutilisable :

Les extractions dotées d'une doc dédiée détaillent le fonctionnement précis de leur onglet Partage dans leur propre page ; cette section commune et la doc technique restent la référence transverse pour tous les écrans.

Ce que tous les écrans partagent

• Tableau uniquement : pas de vue cartes ni Kanban ; 25 lignes par page.
• Colonnes configurables : afficher / masquer, réordonner. Les colonnes non affichées restent disponibles à l'export.
• Filtres : ceux de l'écran métier d'origine (recherche, entités, adresses, statuts, années…).
• Préférences mémorisées par écran et par utilisateur : régler les colonnes ou les filtres d'une extraction ne touche pas l'écran métier correspondant (l'extraction Utilisateurs et l'écran Personnes ont des réglages indépendants), et inversement.
• Export Excel et PDF avec choix des colonnes et de la plage de lignes. L'export rejoue exactement le périmètre affiché : filtres appliqués, mêmes droits, même tri.
• Lecture seule : aucune action de masse (modification, transfert, archivage, envoi de codes…) n'est proposée. Ces actions restent sur les écrans métier.

Règles d'accès

Deux niveaux, contrôlés côté serveur :

Le droit d'export n'est donc pas seulement un bouton masqué : forger l'URL d'export d'une extraction à laquelle on n'a pas droit renvoie un refus d'accès.

Le périmètre des lignes est en plus borné à l'entité mère, aux droits du profil et, pour les profils limités à certaines entités, à ces seules entités.

Ce qui change par rapport aux anciens écrans

Les écarts assumés écran par écran (volumes, règles de choix, colonnes non résolues) sont recensés dans la doc technique et dans les docs dédiées.

Depuis le pilotage IT

Les tuiles « Voir la liste » du pilotage IT ouvrent directement l'extraction concernée, déjà filtrée (ex. serveurs en production, liens à revoir). Les anciens liens /exp/… (favoris) redirigent vers l'extraction, sans filtre.

Points d'attention

• États des lieux (1016 à 1018) : ce sont des écrans d'agrégat (comptages de PC, serveurs, VM, utilisateurs…), pas des listes de fiches. L'export est plafonné à 50 000 lignes.
• Activités santé (1013 à 1015) : 0 ligne est le résultat normal pour une entité qui n'est pas un établissement de santé.
• Extraction Tickets, colonne « Système » : reste vide si le sujet du ticket n'a aucun niveau de système configuré — c'est une configuration incomplète du sujet, pas une perte de donnée.
• Arborescence documentation (1020) : l'export (Excel comme PDF) est un tableau plat, y compris depuis la vue arborescente.
• Un même référentiel peut avoir plusieurs portes d'entrée (extraction, écran métier, export du module Import/Export) ; l'extraction est celle qui vise l'exhaustivité en une passe.

Voir aussi

• Doc technique : .claude/technical-docs/platform/extractions-v2.md
• Docs dédiées : Utilisateurs (1002) · Liens (1008) · Interventions (1011)
• Export / Import — le module d'export et de réinjection en masse, à ne pas confondre avec les extractions (consultation + export seulement).