---
title: "Étiquettes QR imprimables"
module: platform
type: functional
status: active
updated: 2026-08-28
---

# É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`