Isi-APP Docs fonctionnelles
Toutes les docs
Markdown brut
Étiquettes QR imprimables
Actif platform functional Revu le 2026-08-28 platform/qr-labels.md

Étiquettes QR imprimables

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

À quoi ça sert

Coller sur un objet physique une étiquette qui, scannée avec un téléphone, ouvre directement sa fiche dans l'application. Le besoin vient du terrain GMAO — un technicien devant un compresseur veut sa fiche en une seconde, pas une recherche par nom dans une liste de plusieurs centaines d'équipements — mais rien dans le mécanisme n'est propre aux équipements : il fonctionne sur n'importe quel tableau de l'application.

Comment ça marche (côté utilisateur)

Depuis n'importe quel tableau :

Ce que je veux Où je clique Ce qui se passe
Voir / scanner le code d'une ligne Menu ⋮ de la ligne → Étiquette QR Une fenêtre affiche le code en grand, avec le libellé et la référence, et un bouton Télécharger.
Étiqueter plusieurs lignes Je coche les lignes, puis Actions en masse → Imprimer les QR codes Une fenêtre montre l'aperçu de la planche et le nombre de pages A4, avec un bouton Télécharger.

La fenêtre du menu de ligne sert au geste courant : montrer le code pour le scanner tout de suite depuis l'écran (avec un téléphone tenu devant le poste), ou vérifier qu'il pointe au bon endroit — sans lancer une impression.

L'action en masse est disponible sur tous les tableaux éligibles. L'action de ligne, elle, dépend de l'écran : elle est présente sur les équipements GMAO, le parc matériel et les écrans qui utilisent le menu de ligne partagé ; ailleurs, elle s'ajoute à la demande (voir la doc technique).

La sortie est un PDF, téléchargé sans quitter le tableau : vous l'imprimez depuis votre visionneuse, avec vos propres réglages papier (imprimante, recto-verso, échelle). Il s'archive et s'envoie par mail aussi bien qu'il s'imprime.

Un seul format de planche : 6 étiquettes par page A4, avec un QR de 48 mm. Les formats plus compacts ont été retirés — un code trop petit ne se scanne pas de façon fiable sur un équipement en place, et c'est précisément l'usage visé.

L'aperçu affiche les 12 premières étiquettes (« et N autres… » en dessous) : de quoi vérifier qu'on a sélectionné les bonnes lignes, sans faire attendre l'ouverture de la fenêtre. La planche imprimée, elle, les contient toutes.

Chaque étiquette porte le QR code, le nom de l'objet et, quand elle existe, une référence métier :

Objet Ce qui est imprimé
Équipement GMAO Nom · type et localisation · numéro de série
Matériel informatique Nom · tag d'inventaire (ou numéro de série à défaut)

Une étiquette ne porte jamais le nom de la personne à qui l'objet est affecté, ni un identifiant interne : elle est collée sur du matériel, visible de tous, et un poste change de main sans que l'étiquette suive.

Un pointillé délimite chaque étiquette pour faciliter la découpe.

Combien d'étiquettes d'un coup ? Jusqu'à 200 par planche. Au-delà, un message invite à réduire la sélection : une planche plus grande met plusieurs secondes à se composer.

Où mène le QR ? Vers la fiche de l'objet dans l'application. Le scan demande donc d'être connecté : un agent non authentifié passe d'abord par l'écran de connexion, puis arrive sur la fiche.

Règles d'accès

  • L'action n'apparaît que si l'objet listé possède une fiche dans l'application. Un tableau dont les lignes n'ont pas de fiche ne la propose jamais.
  • Avoir une fiche ne suffit pas à rendre l'étiquette pertinente : beaucoup d'écrans en listent (paramétrage, journaux, écrans de synchronisation) sans qu'il y ait quoi que ce soit à étiqueter, et l'action y apparaît quand même aujourd'hui. C'est une limitation connue : l'action est actuellement proposée par défaut et retirée écran par écran. L'inversion de ce défaut est identifiée ; d'ici là, croiser l'action sur un écran où elle n'a pas de sens est sans conséquence — elle imprime une étiquette qui ne mène qu'à la fiche de la ligne.
  • Elle n'apparaît que pour les utilisateurs ayant le droit de lecture sur cette fiche. Le droit contrôlé est celui de la page que le QR ouvrira, pas celui de l'écran de liste.
  • Une planche ne contient jamais que des lignes de votre propre entité : un identifiant hors périmètre est écarté silencieusement.

Points d'attention

  • Les QR générés en développement pointent vers localhost et ne sont donc pas scannables depuis un téléphone. Toute recette terrain se fait sur un environnement déployé.
  • Une planche expire au bout de 30 minutes. L'onglet rouvert le lendemain affiche « sélection expirée » : il suffit de relancer l'impression depuis le tableau. Même chose après un changement d'entité courante — les étiquettes de l'entité précédente ne ressortent pas.
  • La planche reflète l'état au moment de l'impression, pas celui du clic : une ligne archivée entre-temps disparaît de la planche.
  • L'ordre des étiquettes est celui de votre sélection, ce qui permet de les imprimer dans l'ordre d'une tournée.

Voir aussi

  • Doc technique : ../../.claude/technical-docs/platform/qr-labels.md