---
title: "Extraction « IT - VM : Liste complète »"
module: store
type: functional
status: active
updated: 2026-08-24
---

# Extraction « IT - VM : Liste complète »

> Doc fonctionnelle : l'extraction n° 1007, migrée de l'ancien écran d'extraction (grille
> DataTables) vers un tableau moderne filtrable, triable et exportable.

## À quoi ça sert

Restituer **toutes les machines virtuelles** (table `dsi_hwvm`) de l'entité mère, avec les 24
colonnes de l'extraction historique, dans un tableau interactif. Répond au besoin « je veux la
liste exhaustive de mon parc de VM, dans Excel, avec les colonnes que je choisis » — sans
passer par l'onglet VM de la fiche matériel, dont la vue par défaut est centrée sur une seule
entité à la fois. Voir aussi la doc du parc matériel : [`hardware.md`](hardware.md) (section
« Machines virtuelles »).

## Comment ça marche (côté utilisateur)

- **Accès** : `/extractions/1007`. L'écran nécessite la souscription au module *Informatique*
  et le droit de consultation sur l'élément de module « VM » (81090101).
- **Contenu par défaut** : les 24 colonnes de l'extraction historique sont affichées, 25 lignes
  par page. Deux colonnes de maintenance (début/fin), absentes du legacy, restent disponibles
  mais masquées par défaut.
- **Filtres disponibles** (panneau latéral) : type de VM, statut, entité, adresse, client
  (entité mère), groupes de matériel, plus la recherche libre.
- **Colonnes** : le sélecteur de colonnes permet de masquer celles dont on n'a pas besoin ;
  l'ordre et la visibilité sont mémorisés **par utilisateur**, indépendamment de l'onglet VM de
  la fiche matériel.
- **Export** : boutons Excel et PDF. On choisit les colonnes à exporter et la portée (résultats
  filtrés ou plage de lignes). L'export PDF est limité à 8 colonnes.
- **Actions par ligne** : consultation uniquement (fiche synthétique) ; aucune action de masse.

## Onglet « Données Clients / Partage »

Pour un compte **prestataire premium**, un second onglet apparaît au-dessus du tableau :
« Données internes » (par défaut) / « Données Clients / Partage » (`/extractions/1007?presta=1`).
Il liste les VM des **clients ayant explicitement partagé l'accès** au module Informatique avec
ce prestataire — même colonnes, mêmes filtres, export indépendant. Un client qui a délégué un
accès **sans cocher le module Informatique** n'y figure pas : ses VM (nom, IP, système,
mémoire, politique de sauvegarde) ne sont pas diffusées au prestataire. Les préférences (colonnes,
filtres) de cet onglet sont mémorisées séparément de l'onglet interne.

Basculer d'un onglet à l'autre est **instantané** (pas de rechargement de page). Un
rafraîchissement (F5) rouvre le bon onglet, celui sur lequel on se trouvait.

Un utilisateur qui n'est pas prestataire premium ne voit ni l'onglet, ni son contenu (le statut
est revérifié côté serveur, jamais fait confiance à l'URL).

## Règles d'accès

| Contrôle | Effet |
|---|---|
| Module *Informatique* non souscrit | Écran refusé (403), export refusé (403) |
| Pas de droit de consultation sur 81090101 | Écran refusé (403) |
| Pas de droit d'export (`E`) sur 81090101 | Boutons d'export masqués, téléchargement refusé (403) |
| Profil limité à certaines entités | Seules les VM des entités autorisées sont listées et exportées |

## Ce que l'écran ne fait pas

- **Aucune action de masse** : l'extraction est en lecture seule. Les modifications se font
  depuis l'écran Matériels (onglet VM).
- **Pas de colonnes figées ni de défilement horizontal déclaratif**, contrairement à l'ancienne
  grille.

## Différences avec l'ancienne extraction

| Point | Ancienne grille 1007 | Nouvel écran |
|---|---|---|
| VM archivées | Incluses | Exclues (soft delete `dtdel` respecté) |
| Type de VM (`tpvm`) | Code brut | Libellé résolu |
| Statut, hébergement, OS VM | Libellé résolu | Libellé résolu (identique) |
| Colonne « Date de modification » | `dtocs` (colonne disparue) | `updated_at` |

## Voir aussi

- Doc technique : [`.claude/technical-docs/store/vms-extraction.md`](../../.claude/technical-docs/store/vms-extraction.md)
- Parc matériel (dont les VM) : [`hardware.md`](hardware.md)
- [Extractions v2](../platform/extractions-v2.md) — le catalogue des écrans « Liste complète » et
  les règles communes à tous.