Récupérer l’UID d’une carte sans contact
Ce guide explique comment lire l’UID d’une carte sans contact (le numéro unique renvoyé par la puce) dans eMedia Cards, l’enregistrer dans un champ de base de données et/ou un objet de la carte, et l’imprimer sur la face de la carte — ou l’enregistrer sans l’imprimer. Les mêmes étapes s’appliquent sous Windows et sur Mac, sauf indication contraire dans ce guide.
La récupération de l’UID sans contact est une fonction de la Professional Edition.
Des captures d’écran seront ajoutées plus tard, à partir d’une démonstration réelle de l’interface en FHD 1920x1080. Sur ces images, le nom du serveur, le nom d’utilisateur, le mot de passe et les chemins locaux seront masqués.
Avant de commencer
Il vous faut :
-
eMedia Cards Professional Edition (Windows ou Mac). Si votre licence n’inclut pas cette fonction, le message de mise à niveau ci-dessous apparaît lorsque vous activez Contactless ou lorsque vous imprimez.
-
Un lecteur sans contact, ou une imprimante de cartes dotée d’une antenne sans contact (par exemple une Evolis Primacy 2). Les lecteurs de bureau utilisent l’interface standard PC/SC.
-
Un modèle de carte, en mode Design, avec un emplacement où enregistrer l’UID : un champ de base de données, un objet de la carte (texte, code-barres ou code QR), ou les deux.
-
Cette fonction n’est pas disponible pour les modèles Apple Wallet.
Les modèles qui enregistrent déjà le numéro de série de la carte sans contact s’ouvrent et s’enregistrent comme avant. Cette fonction lit uniquement l’UID ; elle n’écrit aucune donnée sur la puce.
Étape 1 - Ouvrir le volet Contactless
Travaillez en mode Design. Le volet est masqué en Operating mode.
-
Cliquez sur Contactless dans la barre d’outils d’insertion (à côté de Magnetic), ou choisissez Insert > Contactless Smart Card...
-
Le volet Contactless — UID s’ouvre au-dessus de la carte, au même endroit que le volet d’encodage magnétique.
Le bouton de la barre d’outils s’intitule Contactless. Son info-bulle est Create or edit the contents of the Contactless Smart Card.
Si la licence n’inclut pas la fonction, une boîte de dialogue intitulée eMedia Cards apparaît :
Available with Professional Edition.
Contact your reseller for a license upgrade if required.
Cliquez sur OK. Le volet ne s’ouvre pas.
Capture d’écran (à réaliser plus tard en FHD 1920x1080 ; masquer le serveur, le nom d’utilisateur, le mot de passe et les chemins locaux) : mode Design, avec le bouton Contactless de la barre d’outils d’insertion sélectionné et le volet Contactless — UID ouvert au-dessus de la carte.
Étape 2 - Choisir un lecteur
-
Dans Reader:, laissez Automatic (first reader with a card) ou choisissez un lecteur dans la liste.
-
Pour actualiser la liste, cliquez sur le bouton à droite de Reader: (info-bulle : Refresh the reader list).
Avec Automatic (first reader with a card), eMedia Cards privilégie un lecteur sans contact : un lecteur dont le nom contient CL, Contactless, PICC ou NFC, ou un lecteur qui présente une carte sans contact. Un lecteur listé mais non branché apparaît sous la forme [name] (not connected).
Si aucun lecteur n’est disponible, un avertissement s’affiche : No contactless reader found. Connect a PC/SC reader, then click Refresh.
Étape 3 - Choisir où enregistrer l’UID
Vous pouvez enregistrer l’UID dans un champ de base de données, dans un objet de la carte, ou dans les deux.
-
Store in database field: choisissez le champ, ou * None * pour ne pas l’utiliser.
-
Store in card object: choisissez un objet texte, code-barres ou code QR, ou * None pour ne pas l’utiliser. Les objets sont listés avec la face sur laquelle ils se trouvent (Front ou Back*).
Les deux listes s’actualisent à leur ouverture : les champs et objets ajoutés récemment apparaissent sans fermer le volet.
Si aucune cible n’est définie, l’en-tête du volet affiche Not stored. Byte order: et Base: restent désactivés tant que vous n’avez pas choisi au moins une cible.
Pour le champ de base de données, préférez un champ texte. Un champ numérique ne peut contenir qu’un UID de 4 octets au plus. Si l’UID est plus long, le message est : The UID is [length] bytes long. Database field "[name]" is numeric and holds UIDs of 4 bytes or less. Use a text field.
Étape 4 - Régler l’ordre des octets et la base
Byte order: et Base: partagent une même ligne.
-
Byte order: choisissez Big endian (par défaut) ou Little endian. Il s’agit de l’ordre des octets de l’UID.
-
Base: choisissez Hexadecimal (par défaut) ou Decimal. Il s’agit de la façon dont l’UID est écrit dans le champ ou l’objet.
Replié, l’en-tête du volet résume le lecteur, la cible d’enregistrement, l’ordre des octets et la base.
Étape 5 - Régler le délai de détection de la carte
-
Dans Card detection timeout:, indiquez combien de secondes eMedia Cards attend une carte sur le lecteur ou sous l’antenne. L’unité affichée dans le volet est s.
-
Vous pouvez choisir de 1 à 300. La valeur par défaut est 10.
Ce même délai d’attente s’applique dans tous les cas : Test read, un lecteur de bureau USB, le SDK Evolis sous Windows et sur Mac, une séquence Printers.ini sous Windows et la file d’impression Mac. Pendant l’attente, le texte affiche un compte à rebours en direct Place a card on the reader… [SECONDS] s, par exemple Place a card on the reader… 8 s.
Card detection timeout: n’est pas le réglage Contactless insertion: du profil d’imprimante. Contactless insertion: n’est qu’un délai supplémentaire avant la lecture, utilisé lorsqu’une imprimante Windows déplace la carte avec la séquence de son profil (sans le SDK). Ce n’est pas le temps accordé pour détecter la carte.
Capture d’écran (à réaliser plus tard en FHD 1920x1080 ; masquer le serveur, le nom d’utilisateur, le mot de passe et les chemins locaux) : le volet avec un lecteur sélectionné, un champ de base de données et un objet de la carte, Byte order: et Base: sur une même ligne, Card detection timeout: avec l’unité s, et Test read.
Étape 6 - Tester la lecture
Test read vérifie que le lecteur renvoie un UID. La valeur n’est écrite ni dans le champ de base de données ni dans l’objet de la carte.
-
Cliquez sur Test read.
-
La ligne d’état affiche d’abord Place a card on the reader…, puis le compte à rebours en direct Place a card on the reader… [SECONDS] s, par exemple Place a card on the reader… 8 s. Le bouton devient Cancel. Vous pouvez cliquer sur Cancel pour arrêter l’attente ; le bouton redevient Test read et aucune erreur ne s’affiche. Si aucune carte n’est présentée, l’attente prend fin après le délai défini dans Card detection timeout:.
-
En cas de réussite, l’UID apparaît dans la zone à côté du bouton, et la ligne d’état affiche UID [UID] ([LENGTH] bytes) on [READER].
-
Si le délai expire, l’état affiche No contactless card was detected on [READER] within [SECONDS] seconds. Check that the card has a contactless chip and is placed under the antenna. ([READER] est le nom du lecteur, et [SECONDS] la durée d’attente.)
Si la puce renvoie un UID différent à chaque lecture, un avertissement apparaît : This card returns a random UID at each read. It cannot be used as a card number.
Autres messages possibles :
| Message | Signification |
|---|---|
| No contactless card was detected on [reader] within [n] seconds. Check that the card has a contactless chip and is placed under the antenna. | Avec Test read, c’est l’état affiché dans le volet à l’expiration du délai. Cliquez de nouveau sur Test read après avoir placé la carte. Cancel pendant Test read n’affiche pas ce message. Pendant l’impression, le même texte apparaît dans la boîte de dialogue No contactless card detected, avec Retry, Next card lorsque l’imprimante peut déplacer la carte, et Cancel. |
| The reader is busy. Close the other program using it, then try again. | Une autre application a ouvert le lecteur. |
| The card was removed before the UID could be read. | Laissez la carte sur le lecteur jusqu’à ce que l’UID apparaisse. |
| The reader did not return the card UID | Le lecteur n’a pas pu terminer la lecture. Essayez un autre lecteur, ou cliquez sur le bouton d’actualisation et refaites le test. |
Étape 7 - Fermer le volet
Cliquez sur le bouton bleu OK dans l’en-tête du volet. Le volet se replie sur sa barre de titre ; Contactless reste activé pour ce modèle. Vous pouvez aussi utiliser le chevron à droite de l’en-tête (Collapse contactless encoding / Expand contactless encoding).
Le volet d’encodage magnétique possède le même bouton bleu OK (Collapse magnetic encoding).
Cliquez de nouveau sur Contactless dans la barre d’outils, ou de nouveau sur Insert > Contactless Smart Card..., pour désactiver la fonction pour ce modèle.
Enregistrez le modèle pour conserver les réglages. Les réglages du volet sont enregistrés avec le modèle. Les modèles enregistrés avec une version antérieure sont réparés à leur ouverture.
Étape 8 - Imprimer une carte avec l’UID sur la face
Passez en Operating mode (l’icône de lecture dans la barre d’outils de gauche). Ouvrez ou sélectionnez l’enregistrement à imprimer, puis choisissez File > Print > All..., Front side only..., Back side only... ou Card only...
Sous Windows, la boîte de dialogue d’impression habituelle s’ouvre. Sur Mac, ces mêmes commandes ouvrent le tableau de bord Print (voir Le tableau de bord Print (Mac)).
Pour chaque carte, eMedia Cards :
-
Lit l’UID.
-
Remplit le champ de base de données et/ou l’objet de la carte que vous avez choisis.
-
Recalcule les formules qui dépendent de cette valeur.
-
Imprime la face de la carte.
L’UID peut être lu par un lecteur USB (PC/SC) ou par l’antenne sans contact de l’imprimante :
-
Si Use SDK printing est activé (dans Tools > Options..., sur la page d’impression) et qu’une imprimante Evolis est sélectionnée, eMedia Cards utilise le SDK Evolis pour amener la carte jusqu’à l’antenne, puis lit l’UID. Sur Mac, choisissez Direct to printer (SDK) comme Print path dans le tableau de bord Print.
-
Si le SDK n’est pas utilisé, eMedia Cards utilise les commandes sans contact du profil d’imprimante pour amener la carte jusqu’à l’antenne, puis attend le lecteur. La ligne d’état peut afficher Moving the card to the contactless antenna… Vous pouvez annuler l’attente. Sur une Evolis Primacy 2 sans le SDK, ce sont les mêmes commandes de déplacement de carte que pour la Primacy 1 qui sont utilisées. L’attente de la carte utilise le Card detection timeout: du volet. Contactless insertion: dans le profil d’imprimante n’est qu’un délai supplémentaire avant cette lecture, pas un délai de détection.
Si Contactless n’est pas activé pour le modèle, l’impression affiche : Turn on Contactless for this template before printing.
Pendant qu’eMedia Cards attend la carte, le texte de progression est le compte à rebours en direct Place a card on the reader… [SECONDS] s, par exemple Place a card on the reader… 8 s. Retry et Next card relancent ce compte à rebours depuis la durée d’attente complète.
Si aucune carte sans contact n’est détectée à temps, une boîte de dialogue intitulée No contactless card detected affiche No contactless card was detected on [READER] within [SECONDS] seconds. Check that the card has a contactless chip and is placed under the antenna. Les boutons sont Retry, Next card et Cancel (identiques sous Windows et sur Mac). Retry est le bouton par défaut. Next card n’apparaît que si ce mode d’impression peut déplacer une carte : le SDK Evolis sous Windows et sur Mac, et une séquence Printers.ini sous Windows. Il est masqué avec un lecteur de bureau USB et avec la file d’impression Mac (macOS print queue).
-
Retry relance une attente complète sur le même lecteur, avec la même carte. Vous pouvez réessayer autant de fois que vous le souhaitez. Sur une imprimante, la carte reste devant l’antenne ; eMedia Cards ne l’éjecte pas et n’introduit pas de nouvelle carte.
-
Next card rejette la carte en cours, amène la carte suivante du chargeur jusqu’à l’antenne et relit le même enregistrement. L’enregistrement n’est pas sauté, et le compte à rebours redémarre sur ce même enregistrement. Après trois appuis consécutifs sur Next card pour cet enregistrement, eMedia Cards demande Three cards in a row were rejected for this record. Reject another card and feed the next one? La boîte de dialogue est intitulée Next card, avec Yes et No, afin qu’une pile de cartes défectueuses ne vide pas le chargeur.
-
Cancel rejette la carte une fois (avec une imprimante). Dans un lot, la question Do you want to continue printing? vous est ensuite posée, avec Yes et No, dans une boîte de dialogue qui garde le titre No contactless card detected.
Si l’UID ne peut pas être lu pour une autre raison, une boîte de dialogue intitulée Contactless — UID affiche Smart card encoder error: suivi de la raison. Lorsque vous pouvez continuer sans l’UID, cette boîte de dialogue demande aussi Do you want to continue printing? avec Yes et No. Sinon, elle comporte OK.
Card rejected: the contactless UID could not be read. apparaît lorsque l’objet de carte choisi est introuvable, ou lorsque la lecture échoue pour une autre raison que celles indiquées ci-dessus.
Étape 9 - Enregistrer l’UID sans imprimer la face
File > Print > Contactless Smart Card only... (en Operating mode) n’imprime pas la face de la carte. Cette commande lit bien l’UID et l’enregistre dans le champ de base de données choisi (lorsqu’un champ est défini).
Sous Windows, la boîte de dialogue d’impression habituelle s’ouvre. Sur Mac, la commande ouvre le même tableau de bord Print qu’une impression normale (voir Le tableau de bord Print (Mac)). Après un clic sur Print, le travail enregistre uniquement l’UID.
La commande lit l’UID et écrit la valeur formatée dans :
-
l’objet cible du modèle ouvert (vous pouvez annuler cette action, et le document est marqué comme modifié), et
-
le champ de base de données, lorsqu’il est défini. Le champ est enregistré dans la base de données, comme avec OK sur l’enregistrement, et l’enregistrement revient en consultation avec l’UID affiché. Si la sauvegarde ne peut pas aboutir, l’enregistrement reste en modification avec l’UID renseigné. Une lecture échouée ou annulée n’ouvre pas l’enregistrement en modification.
La même vérification de la Professional Edition s’applique. Si la licence n’inclut pas la fonction, la boîte de dialogue de mise à niveau de l’étape 1 apparaît et rien n’est enregistré.
Le tableau de bord Print (Mac)
Sur Mac, File > Print > All..., Front side only..., Back side only..., Card only... et Contactless Smart Card only... ouvrent tous le tableau de bord Print.
La fenêtre s’intitule Print. Elle comporte trois zones :
-
Printer. Choisissez l’imprimante. Une ligne sous la liste peut indiquer Printer of this template, Your default printer ou macOS default printer. Le texte indicatif de la liste des imprimantes est Select a printer... Si aucune imprimante n’est installée, le message est No printers are installed on this system. Si vous cliquez sur Print sans avoir sélectionné d’imprimante, l’invite est Please select a printer. Pendant la vérification de l’imprimante, l’état peut afficher Checking printer..., puis un état de file d’attente comme Ready, Paused, Offline, Error, Out of cards or feed problem, Printing, Cover open ou Status unknown. Avec le mode Direct to printer (SDK), le ruban peut afficher ~[LEFT] of [TOTAL] prints left ou Ribbon: [PERCENT]% left.
-
Print path. Choisissez Direct to printer (SDK) ou macOS print queue. Avec macOS print queue, la mention Bitmap only apparaît sous le mode d’impression.
-
Job. Réglez Resolution (par exemple Auto ([DPI] dpi) ou [DPI] dpi), Copies et, si besoin, Rotate 180°. Records affiche 1 (current record) pour l’enregistrement en cours, ou [COUNT] records pour un lot. Pour une carte recto verso, Sides propose Front, Back et Front + back.
Les boutons sont Print et Cancel. Si une vérification apparaît avant le travail, la barre s’intitule Before printing [COUNT] card(s), le pied de page indique You can still print: press Print anyway. et le bouton devient Print anyway.
Pour Contactless Smart Card only..., le tableau de bord est identique. Après un clic sur Print, eMedia Cards enregistre l’UID dans le champ de base de données (s’il est défini) et n’imprime pas la face de la carte.
Consulter les lectures d’UID dans le journal d’activité
Chaque lecture d’UID terminée ajoute une ligne au journal d’activité d’impression, sous Windows et sur Mac. Cela comprend Test read et chaque lecture pendant l’impression. Retry et Next card n’ajoutent pas de ligne : ils sont comptés sur la même ligne.
Les lignes ne sont écrites que si Record print activity est activé. Les rapports d’activité d’impression nécessitent une licence d’édition Standard ou supérieure.
-
Choisissez Tools > Options...
-
Ouvrez la catégorie Reports.
-
Vérifiez que Record print activity est activé.
-
Lisez les lignes sous Last 50 events.
-
Pour n’afficher que les lectures qui n’ont pas abouti, sous Show, choisissez Failed and aborted only.
Une ligne sans contact affiche les valeurs suivantes :
| Colonne | Valeur |
|---|---|
| Kind | Contactless |
| Outcome | Success, No card, Read error ou Cancelled |
| Record | L’enregistrement de base de données en cours, s’il y en a un d’ouvert, puis l’UID, la source et les compteurs, séparés par ·. Exemple : UID 04A1B2C3D4E5F6 · Evolis SDK · Retry 1. |
Record affiche UID [UID] uniquement en cas de réussite. Retry [COUNT] et Next card [COUNT] n’apparaissent que lorsque le compteur est supérieur à 0.
| Résultat | Signification |
|---|---|
| Success | L’UID a été lu. |
| No card | Aucune carte n’a été détectée dans le délai Card detection timeout:. |
| Cancelled | Cancel a été cliqué. |
| Read error | La lecture a échoué pour une autre raison, par exemple un lecteur occupé, une carte retirée ou un UID aléatoire. |
| Source | Lu par |
|---|---|
| USB reader | Un lecteur de bureau PC/SC, y compris pour Test read. |
| Evolis SDK | Une imprimante Evolis avec Use SDK printing (Windows). |
| Printers.ini | Les commandes sans contact du profil d’imprimante (Windows). |
| Mac Evolis SDK | Une imprimante Evolis sur Mac. |
Une ligne sans contact a Copies à 0. Elle ne s’ajoute pas aux totaux de copies.
L’UID n’est enregistré qu’en cas de réussite. Les clés de carte, les clés SAM et les octets bruts de l’UID ne sont jamais enregistrés.
Export CSV
L’export CSV ajoute six colonnes après ExtensionId. Les noms de colonnes sont toujours en anglais.
| Colonne | Valeur |
|---|---|
| ContactlessSource | UsbReader, EvolisSdk, PrintersIni ou MacEvolisSdk |
| ContactlessUid | L’UID, selon les réglages Byte order: et Base: du volet. Vide si la lecture n’a pas réussi. |
| RetryCount | Nombre de clics sur Retry |
| NextCardCount | Nombre de passages à la carte suivante avec Next card |
| ContactlessDetail | success, no_card, read_error ou cancelled |
| ContactlessMessage | Une courte raison en anglais lorsque la lecture n’a pas réussi, par exemple No contactless card was detected. |
Sur une ligne sans contact, JobKind vaut Contactless, Outcome vaut Success, Failed ou Aborted, et PrinterName contient le nom du lecteur ou de l’imprimante. ErrorCode donne le code d’échec, par exemple NO_CARD ou READER_BUSY.
Dépannage
| Problème | Que faire |
|---|---|
| Boîte de dialogue Available with Professional Edition. | La récupération de l’UID sans contact nécessite la Professional Edition. Cliquez sur OK, puis mettez la licence à niveau, ou utilisez une copie Professional. |
| Le bouton Contactless ne fait rien sur un modèle Apple Wallet | Contactless n’est pas disponible pour Apple Wallet. Utilisez un modèle de carte plastique. |
| No contactless reader found. Connect a PC/SC reader, then click Refresh. | Branchez le lecteur, installez son pilote si nécessaire, puis cliquez sur le bouton d’actualisation à côté de Reader:. |
| Le lecteur attendu est absent, ou affiche (not connected) | Cliquez sur le bouton d’actualisation. S’il affiche toujours (not connected), reconnectez l’appareil. Ou choisissez Automatic (first reader with a card). |
| The reader is busy. Close the other program using it, then try again. | Fermez l’autre application qui a ouvert le lecteur, puis relancez Test read ou l’impression. |
| Boîte de dialogue No contactless card detected avec Retry, Next card et Cancel | Placez une carte sans contact sur le lecteur ou sous l’antenne de l’imprimante, puis cliquez sur Retry pour attendre de nouveau sur le même lecteur, avec la même carte. Sur une imprimante, la carte reste devant l’antenne. Next card, lorsque ce bouton est affiché, rejette cette carte et amène la suivante pour le même enregistrement. Après trois appuis consécutifs sur Next card, eMedia Cards demande confirmation avant d’en rejeter une autre. Cliquez sur Cancel pour rejeter la carte une fois ; dans un lot, la question Do you want to continue printing? vous est ensuite posée. Test read n’affiche pas cette boîte de dialogue : l’expiration du délai n’apparaît que dans la ligne d’état du volet, et Cancel pendant Test read n’affiche aucune erreur. |
| This card returns a random UID at each read. It cannot be used as a card number. | Cette puce ne fournit pas d’UID stable. Utilisez une autre carte, ou enregistrez un autre identifiant. |
| The UID is … bytes long. Database field "…" is numeric and holds UIDs of 4 bytes or less. Use a text field. | Choisissez un champ texte dans Store in database field:, ou utilisez un UID plus court avec un champ numérique de 4 octets au plus. |
| The serial number on the card can't be stored in the "…" field of the database as its type is not supported. | Choisissez un champ texte (ou un champ numérique, pour un UID de 4 octets au plus). |
| Turn on Contactless for this template before printing. | En mode Design, activez Contactless et choisissez une cible d’enregistrement, puis enregistrez et imprimez depuis l’Operating mode. |
| La face imprimée n’affiche pas l’UID | Vérifiez que Store in card object: pointe vers l’objet attendu, et que les formules qui doivent utiliser l’UID font référence à ce champ ou à cet objet. Lancez d’abord Test read pour vérifier le lecteur. |
| Une imprimante avec antenne ne présente jamais la carte au lecteur | Si vous utilisez une imprimante Evolis avec le SDK, vérifiez Use SDK printing dans Tools > Options.... Si vous n’utilisez pas le SDK, eMedia Cards déplace quand même la carte avec les commandes sans contact du profil d’imprimante (sur une Primacy 2, les mêmes commandes que pour la Primacy 1), puis attend le lecteur pendant le délai défini dans Card detection timeout:. Contactless insertion: dans le profil d’imprimante n’est qu’un délai supplémentaire avant cette lecture. Vérifiez le câble, l’imprimante et, sous Windows, le journal Contactless encoding. |
Journal de diagnostic (Windows)
Pour enregistrer une trace de lecture d’UID sans contact à l’intention du support :
-
Choisissez Tools > Options...
-
Ouvrez la catégorie Logs.
-
Dans le groupe Print, activez Contactless encoding.
La description de cette option est : UID read, reader choice, and Printers.ini contactless sequences (contactlessencoding.log). Card keys are never written.
Le fichier s’appelle contactlessencoding.log ; il se trouve dans le dossier des journaux, que vous pouvez ouvrir avec Open logs folder sur la même page. Le journal peut contenir l’UID. Il ne contient jamais de clés de carte ni de clés SAM.
Lorsqu’une attente d’impression expire, chaque Retry ajoute une ligne du type Timeout retry reader=... attempt=N (le nom du lecteur et le numéro de la tentative). Chaque Next card ajoute Timeout next card reader=... attempt=N. Cancel ajoute la ligne Timeout cancelled.
Sur Mac, eMedia Cards n’écrit pas ces fichiers journaux.