Sélection en masse des matériels

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

À quoi ça sert

Les actions en masse du parc matériel (changement de statut, transfert, groupes, archivage) existaient déjà, mais il fallait cocher les matériels un par un, et la sélection était perdue à chaque changement de page. Passer 200 machines en « mise au rebut » demandait donc de les retrouver une par une : plusieurs heures de travail pour une action qui, elle, prend dix secondes.

Cette feature permet de constituer la sélection d'un coup, soit en collant une liste d'identifiants (typiquement une colonne d'un fichier Excel fourni par le client), soit en prenant tous les matériels correspondant aux filtres affichés.

Comment ça marche (côté utilisateur)

Sur n'importe quel onglet du parc matériel (Postes, Serveurs, Imprimantes, Réseau, Téléphones, Tablettes, Autres, ainsi que le parc d'une entité ou d'un utilisateur), le menu « Actions en masse » propose deux nouvelles entrées, avant les actions de modification :

Sélectionner depuis une liste

1. Choisir le champ de correspondance : libellé du matériel, tag / n° d'inventaire, n° de série, référence immo / compta, ou identifiant interne.
2. Coller les valeurs dans la zone de saisie. Un copier-coller de colonne Excel fonctionne tel quel : les séparateurs acceptés sont le retour à la ligne, la tabulation, le point-virgule et la virgule. La casse, les espaces superflus et les doublons sont ignorés.
3. « Ajouter à la sélection » : les matériels reconnus sont cochés, et un compte rendu s'affiche :
   • le nombre de matériels reconnus sur le nombre de valeurs fournies ;
   • la liste des valeurs introuvables (faute de frappe, matériel archivé, matériel d'un autre client…), pour corriger et relancer ;
   • un avertissement si une valeur correspond à plusieurs matériels — ils sont alors tous sélectionnés (deux postes peuvent porter le même libellé).

La sélection s'ajoute à ce qui était déjà coché : plusieurs collages successifs se cumulent.

Sélectionner tous les résultats filtrés

Ajoute en une fois tous les matériels correspondant aux filtres et à la recherche en cours (et pas seulement ceux de la page affichée). Utile quand le critère est déjà exprimable par un filtre (« tous les postes de l'entité X en maintenance »).

Comme le collage, cette action s'ajoute à la sélection en cours, elle ne la remplace pas. Si les filtres ramènent plus de matériels que le plafond (500), l'action est refusée en annonçant le nombre réel — la sélection déjà constituée est conservée. Sur un parc de plusieurs milliers de matériels, posez donc d'abord un filtre (entité, statut, type) : sans filtre, tout le parc est concerné et l'action ne peut pas aboutir.

Bandeau de sélection

Dès qu'au moins un matériel est sélectionné, un bandeau affiche le nombre de lignes retenues, dont combien sont hors de la page affichée, et propose de vider la sélection. La sélection survit au changement de page et au changement de tri : les cases restent cochées quand on revient sur une page.

Enchaîner ensuite normalement sur l'action voulue du menu « Actions en masse » (par exemple Modifier les statuts → « Mise au rebut » + date).

Règles d'accès

• Module informatique et droits du module Matériels (81000101) comme pour le reste de l'écran.
• Seuls les matériels visibles par l'utilisateur peuvent être sélectionnés : un identifiant appartenant à un autre client, ou un matériel archivé, est signalé comme introuvable — jamais sélectionné silencieusement.
• Les contrôles propres à chaque action en masse restent inchangés : droit U/D matériel par matériel, refus d'une sélection portant sur plusieurs clients.

Points d'attention

• Plafond de 500 matériels par sélection (paramétrable, config/hardware.php). Au-delà, la sélection est refusée (« Plus de 500 lignes correspondent aux filtres ») : affiner les filtres ou traiter en deux fois. L'ancienne limite était de 50, ce qui bloquait les demandes de type « 200 machines à mettre au rebut ».
• Chaque action en masse enregistre les matériels un par un (validation métier + historique) : sur plusieurs centaines de lignes, compter quelques secondes de traitement.
• Un matériel dont une donnée existante est incomplète est écarté, pas bloquant : l'action contrôle la fiche entière, pas seulement le champ modifié. Les matériels concernés (par exemple sans fabricant renseigné) sont listés nommément à la fin du traitement, et tous les autres sont bien mis à jour — un message annonce « N mis à jour, M écarté(s) ». La fenêtre reste ouverte sur les seuls matériels écartés : après avoir corrigé leur fiche, relancer l'action ne retouche pas ceux déjà traités.
• Une erreur technique sur un matériel est signalée par son libellé et un motif générique (l'incident est enregistré côté support) : rien du détail interne n'est affiché à l'écran.
• Changer un filtre vide la sélection (le périmètre affiché n'est plus le même). Constituer la sélection en dernier, juste avant l'action.
• Les valeurs collées sont comparées à l'identique (aux espaces et à la casse près) : il n'y a pas de recherche partielle. Un libellé tronqué dans l'Excel du client ne sera pas reconnu.

Voir aussi

• Doc technique : ../../.claude/technical-docs/store/hardware-bulk-selection.md
• Module Matériels : hardware.md