--- title: "Extractions v2 — écrans « Liste complète »" module: platform type: functional status: active updated: 2026-08-20 --- # 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 | Id | Écran | Module requis | Droit de consultation | Colonnes affichées / exportables | Onglet Partage | |----|-------|---------------|-----------------------|-----------------------------------|:--------------:| | 1000 | [Entités : Liste complète](../crm/entities-extraction.md) | — | élément 13000101 | 13 / 13 | Oui | | 1001 | [Adresses : Liste complète](../platform/address-extraction.md) | — | élément 13040101 | 28 / 28 | Oui | | 1002 | [Utilisateurs : Liste complète](../identity/users-extraction.md) | — | élément 12000101 | 31 / 31 | Oui | | 1003 | Contrats : Liste complète | — | élément 14140101 | 23 / 24 | Non | | 1004 | [IT - Configurations : Liste complète](../store/configurations-extraction.md) | Informatique | élément 80000101 | 16 / 16 | Oui | | 1005 | [IT - Applis : Liste complète](../store/apps-extraction.md) | — | élément 80520101 | 14 / 14 | Oui | | 1006 | [IT - Matériels : Liste complète](../store/hardware-extraction.md) | Informatique | élément 81000101 | 38 / 42 | Oui | | 1007 | [IT - VM : Liste complète](../store/vms-extraction.md) | Informatique | élément 81090101 | 24 / 26 | Oui | | 1008 | [IT - Liens : Liste complète](../store/links-extraction.md) | Informatique | élément 80400101 | 28 / 28 | Oui | | 1010 | [Tickets : Liste complète](../tickets/tickets-extraction.md) | Tickets | élément 13200101 | 24 / 45 | Oui | | 1011 | [Interventions : Liste complète](../gmao/interventions-extraction.md) | Informatique | élément 14150101 | 19 / 24 | Oui | | 1012 | Projets : Liste complète | Projet | élément 16000101 | 21 / 21 | Non | | 1013 | [Activités ESMS : Liste complète](../sante/health-activities-extraction.md) | Santé | élément 85110101 | 24 / 24 | Oui | | 1014 | [Activités Sanitaire : Liste complète](../sante/health-activities-extraction.md) | Santé | élément 85120101 | 20 / 20 | Oui | | 1015 | [Activités EHPAD : Liste complète](../sante/health-activities-extraction.md) | Santé | élément 85100101 | 49 / 49 | Oui | | 1016 | [Client : État des lieux (PC, VM, utilisateurs…)](../gmao/situation-report-extraction.md) | Informatique | élément 13000101 | 15 / 15 | Oui | | 1017 | [Entités : État des lieux (PC, VM, utilisateurs…)](../gmao/situation-report-extraction.md) | Informatique | élément 13000101 | 14 / 14 | Oui | | 1018 | [Adresses : État des lieux (PC, VM, utilisateurs…)](../gmao/situation-report-extraction.md) | Informatique | élément 13040101 | 15 / 16 | Oui | | 1019 | [IT - Documentation](../wiki/documentation-extraction.md) | — | élément 14170101 | 13 / 16 | Oui | | 1020 | IT - Arborescence documentation | Informatique | élément 14170101 | 4 / 9 | Non | 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 : | Id | Écran | Pourquoi pas d'onglet Partage | |----|-------|-------------------------------| | 1003 | Contrats : Liste complète | Ce sont les contrats **du prestataire lui-même** (données de son propre CRM), pas des données appartenant à ses clients : la notion de « client ayant partagé l'accès » ne s'applique pas. | | 1012 | Projets : Liste complète | Pas de brique de partage client déjà exposée sur ce référentiel au moment de ce chantier. | | 1020 | IT - Arborescence documentation | Écran arborescent (pas un tableau plat comme les autres) ; pas de brique de partage réutilisable pour cette structure. | 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 : | Niveau | Contrôle | |--------|----------| | Ouvrir l'écran | souscription au module requis (colonne du catalogue) **et** droit de consultation sur l'élément de module | | Exporter | les mêmes contrôles, **rejoués** à la génération du fichier, plus le droit d'export | 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 | Point | Ancien écran | Extraction v2 | |-------|--------------|---------------| | Périmètre des données | non filtré par les droits (le filtrage était injecté par la grille) | entité mère + droits + profil limité, systématiquement | | Lignes sans correspondance | exclues silencieusement (jointures strictes) | listées, colonnes liées vides — le volume peut donc être **supérieur** au legacy | | Valeurs multiples (profil, fonction…) | une ligne au hasard | règle explicite (profil favori, fonction principale…) | | Colonnes sensibles | exposées sans condition | conditionnées au module et au droit (ex. colonnes Santé de l'extraction Utilisateurs) | | Préférences d'affichage | non mémorisées | mémorisées par écran et par utilisateur | 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)](../identity/users-extraction.md) · [Liens (1008)](../store/links-extraction.md) · [Interventions (1011)](../gmao/interventions-extraction.md) - [Export / Import](export-import.md) — le module d'export **et de réinjection** en masse, à ne pas confondre avec les extractions (consultation + export seulement).