Obtener el UID de una tarjeta sin contacto
Esta guía explica cómo leer el UID de una tarjeta sin contacto (el número único que devuelve el chip) en eMedia Cards, guardarlo en un campo de base de datos y/o en un objeto de la tarjeta, e imprimirlo en la cara de la tarjeta, o guardarlo sin imprimirlo. Los mismos pasos sirven en Windows y en Mac, salvo donde esta guía indique lo contrario.
La obtención del UID sin contacto es una función de Professional Edition.
Las capturas de pantalla se añadirán más adelante, a partir de un recorrido real por la interfaz en FHD 1920x1080. En esas imágenes se ocultarán el nombre del servidor, el nombre de usuario, la contraseña y las rutas locales.
Antes de empezar
Necesitas:
-
eMedia Cards Professional Edition (Windows o Mac). Si tu licencia no incluye esta función, aparece el mensaje de actualización que se indica más abajo al activar Contactless o al imprimir.
-
Un lector sin contacto, o una impresora de tarjetas con antena sin contacto (por ejemplo, una Evolis Primacy 2). Los lectores de escritorio usan la interfaz estándar PC/SC.
-
Una plantilla de tarjeta, en modo Design, con un lugar donde guardar el UID: un campo de base de datos, un objeto de la tarjeta (texto, código de barras o código QR), o ambos.
-
Esta función no está disponible en las plantillas de Apple Wallet.
Las plantillas que ya guardan el número de serie de la tarjeta sin contacto se siguen abriendo y guardando como antes. Esta función solo lee el UID; no escribe datos en el chip.
Paso 1 - Abrir el panel Contactless
Trabaja en modo Design. El panel está oculto en Operating mode.
-
Haz clic en Contactless en la barra de herramientas de inserción (junto a Magnetic), o elige Insert > Contactless Smart Card...
-
El panel Contactless — UID se abre encima de la tarjeta, en el mismo lugar que el panel de codificación magnética.
El botón de la barra de herramientas se llama Contactless. Su información emergente es Create or edit the contents of the Contactless Smart Card.
Si la licencia no incluye la función, aparece un cuadro de diálogo titulado eMedia Cards:
Available with Professional Edition.
Contact your reseller for a license upgrade if required.
Haz clic en OK. El panel no se abre.
Captura de pantalla (se tomará más adelante en FHD 1920x1080; ocultar el servidor, el nombre de usuario, la contraseña y las rutas locales): modo Design con el botón Contactless de la barra de herramientas de inserción seleccionado y el panel Contactless — UID abierto encima de la tarjeta.
Paso 2 - Elegir un lector
-
En Reader:, deja Automatic (first reader with a card) o elige un lector de la lista.
-
Para actualizar la lista, haz clic en el botón situado a la derecha de Reader: (información emergente: Refresh the reader list).
Con Automatic (first reader with a card), eMedia Cards da preferencia a un lector sin contacto: uno cuyo nombre contenga CL, Contactless, PICC o NFC, o un lector que esté presentando una tarjeta sin contacto. Un lector que aparece en la lista pero no está enchufado se muestra como [name] (not connected).
Si no hay ningún lector disponible, aparece una advertencia: No contactless reader found. Connect a PC/SC reader, then click Refresh.
Paso 3 - Elegir dónde guardar el UID
Puedes guardar el UID en un campo de base de datos, en un objeto de la tarjeta o en ambos.
-
Store in database field: elige el campo, o * None * para no usarlo.
-
Store in card object: elige un objeto de texto, código de barras o código QR, o * None para no usarlo. Los objetos aparecen con la cara en la que están (Front o Back*).
Las dos listas se actualizan al abrirlas, así que los campos y objetos recién añadidos aparecen sin cerrar el panel.
Si no hay ningún destino definido, el encabezado del panel muestra Not stored. Byte order: y Base: permanecen desactivados hasta que elijas al menos un destino.
Para el campo de base de datos, es preferible un campo de texto. Un campo numérico solo puede contener un UID de 4 bytes o menos. Si el UID es más largo, el mensaje es: The UID is [length] bytes long. Database field "[name]" is numeric and holds UIDs of 4 bytes or less. Use a text field.
Paso 4 - Configurar el orden de bytes y la base
Byte order: y Base: comparten una misma fila.
-
Byte order: elige Big endian (predeterminado) o Little endian. Es el orden de los bytes del UID.
-
Base: elige Hexadecimal (predeterminado) o Decimal. Es la forma en que se escribe el UID en el campo o en el objeto.
Cuando el panel está contraído, su encabezado resume el lector, el destino de guardado, el orden de bytes y la base.
Paso 5 - Configurar el tiempo de espera de detección de la tarjeta
-
En Card detection timeout:, indica cuántos segundos espera eMedia Cards una tarjeta en el lector o bajo la antena. La unidad que se muestra en el panel es s.
-
Puedes indicar de 1 a 300. El valor predeterminado es 10.
Este mismo tiempo de espera se usa en todos los casos: Test read, un lector de escritorio USB, el SDK de Evolis en Windows y en Mac, una secuencia de Printers.ini en Windows y la cola de impresión de Mac. Mientras la aplicación espera, el texto muestra una cuenta atrás en directo Place a card on the reader… [SECONDS] s, por ejemplo Place a card on the reader… 8 s.
Card detection timeout: no es el ajuste Contactless insertion: del perfil de la impresora. Contactless insertion: es solo un retardo adicional antes de la lectura, que se usa cuando una impresora de Windows mueve la tarjeta con la secuencia de su perfil (sin el SDK). No es el tiempo disponible para detectar la tarjeta.
Captura de pantalla (se tomará más adelante en FHD 1920x1080; ocultar el servidor, el nombre de usuario, la contraseña y las rutas locales): el panel con un lector seleccionado, un campo de base de datos y un objeto de la tarjeta, Byte order: y Base: en una misma fila, Card detection timeout: con la unidad s, y Test read.
Paso 6 - Probar la lectura
Test read comprueba que el lector devuelve un UID. No escribe el valor en el campo de base de datos ni en el objeto de la tarjeta.
-
Haz clic en Test read.
-
La línea de estado muestra primero Place a card on the reader… y luego la cuenta atrás en directo Place a card on the reader… [SECONDS] s, por ejemplo Place a card on the reader… 8 s. El botón cambia a Cancel. Puedes hacer clic en Cancel para dejar de esperar; el botón vuelve a Test read y no se muestra ningún error. Si no se presenta ninguna tarjeta, la espera termina tras el tiempo configurado en Card detection timeout:.
-
Si la lectura se realiza correctamente, el UID aparece en el cuadro junto al botón y la línea de estado muestra UID [UID] ([LENGTH] bytes) on [READER].
-
Si se agota el tiempo de espera, el estado muestra 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] es el nombre del lector y [SECONDS] el tiempo que esperó la aplicación).
Si el chip devuelve un UID distinto en cada lectura, aparece una advertencia: This card returns a random UID at each read. It cannot be used as a card number.
Otros mensajes que puedes ver:
| Mensaje | Qué significa |
|---|---|
| No contactless card was detected on [reader] within [n] seconds. Check that the card has a contactless chip and is placed under the antenna. | Con Test read, es el estado que muestra el panel cuando se agota el tiempo de espera. Vuelve a hacer clic en Test read después de colocar la tarjeta. Cancel durante Test read no muestra este mensaje. Durante la impresión, el mismo texto aparece en el cuadro de diálogo No contactless card detected con Retry, Next card cuando la impresora puede mover la tarjeta, y Cancel. |
| The reader is busy. Close the other program using it, then try again. | Otra aplicación tiene abierto el lector. |
| The card was removed before the UID could be read. | Mantén la tarjeta en el lector hasta que aparezca el UID. |
| The reader did not return the card UID | El lector no pudo completar la lectura. Prueba con otro lector, o haz clic en el botón de actualizar y vuelve a probar. |
Paso 7 - Cerrar el panel
Haz clic en el botón azul OK del encabezado del panel. El panel se contrae hasta su barra de título; Contactless sigue activado para esta plantilla. También puedes usar el botón de flecha situado a la derecha del encabezado (Collapse contactless encoding / Expand contactless encoding).
El panel de codificación magnética tiene el mismo botón azul OK (Collapse magnetic encoding).
Vuelve a hacer clic en Contactless en la barra de herramientas, o de nuevo en Insert > Contactless Smart Card..., para desactivar la función en esta plantilla.
Guarda la plantilla para conservar la configuración. La configuración del panel se guarda con la plantilla. Las plantillas guardadas con una versión anterior se reparan al abrirlas.
Paso 8 - Imprimir una tarjeta con el UID en la cara
Cambia a Operating mode (el icono de reproducción de la barra de herramientas de la izquierda). Abre o selecciona el registro que quieres imprimir y luego elige File > Print > All..., Front side only..., Back side only... o Card only...
En Windows, se usa el cuadro de diálogo de impresión habitual. En Mac, esos mismos comandos abren el panel de control Print (consulta El panel de control Print (Mac)).
Para cada tarjeta, eMedia Cards:
-
Lee el UID.
-
Rellena el campo de base de datos y/o el objeto de la tarjeta que elegiste.
-
Vuelve a calcular las fórmulas que dependen de ese valor.
-
Imprime la cara de la tarjeta.
El UID se puede leer con un lector USB (PC/SC) o con la antena sin contacto de la impresora:
-
Si Use SDK printing está activado (en Tools > Options..., en la página de impresión) y hay una impresora Evolis seleccionada, eMedia Cards usa el SDK de Evolis para llevar la tarjeta hasta la antena y luego lee el UID. En Mac, elige Direct to printer (SDK) como Print path en el panel de control Print.
-
Si no se usa el SDK, eMedia Cards usa los comandos sin contacto del perfil de la impresora para llevar la tarjeta hasta la antena y luego espera al lector. La línea de estado puede mostrar Moving the card to the contactless antenna… Puedes cancelar la espera. En una Evolis Primacy 2 sin el SDK, se usan los mismos comandos de movimiento de tarjeta que en la Primacy 1. La espera de la tarjeta usa el Card detection timeout: del panel. Contactless insertion: en el perfil de la impresora es solo un retardo adicional antes de esa lectura, no un tiempo de espera de detección.
Si Contactless no está activado para la plantilla, al imprimir aparece: Turn on Contactless for this template before printing.
Mientras eMedia Cards espera la tarjeta, el texto de progreso es la cuenta atrás en directo Place a card on the reader… [SECONDS] s, por ejemplo Place a card on the reader… 8 s. Retry y Next card reinician esa cuenta atrás con el tiempo de espera completo.
Si no se detecta ninguna tarjeta sin contacto a tiempo, un cuadro de diálogo titulado No contactless card detected muestra No contactless card was detected on [READER] within [SECONDS] seconds. Check that the card has a contactless chip and is placed under the antenna. Los botones son Retry, Next card y Cancel (iguales en Windows y en Mac). Retry es el botón predeterminado. Next card solo aparece cuando esta vía de impresión puede mover una tarjeta: el SDK de Evolis en Windows y en Mac, y una secuencia de Printers.ini en Windows. Está oculto con un lector de escritorio USB y con la cola de impresión de Mac (macOS print queue).
-
Retry inicia otra espera completa en el mismo lector, con la misma tarjeta. Puedes reintentar tantas veces como quieras. En una impresora, la tarjeta permanece en la antena; eMedia Cards no la expulsa ni introduce una tarjeta nueva.
-
Next card rechaza la tarjeta actual, lleva la siguiente tarjeta del alimentador a la antena y vuelve a leer el mismo registro. El registro no se omite, y la cuenta atrás se reinicia en ese mismo registro. Tras pulsar Next card tres veces seguidas para ese registro, eMedia Cards pregunta Three cards in a row were rejected for this record. Reject another card and feed the next one? El cuadro de diálogo se titula Next card, con Yes y No, para que una pila de tarjetas defectuosas no vacíe el alimentador.
-
Cancel rechaza la tarjeta una vez (en una vía de impresora). En un lote, a continuación se te pregunta Do you want to continue printing? con Yes y No, en un cuadro de diálogo que mantiene el título No contactless card detected.
Si el UID no se puede leer por otro motivo, un cuadro de diálogo titulado Contactless — UID muestra Smart card encoder error: y el motivo. Cuando puedes continuar sin el UID, ese cuadro de diálogo también pregunta Do you want to continue printing? con Yes y No. Si no, solo tiene OK.
Card rejected: the contactless UID could not be read. aparece cuando falta el objeto de la tarjeta elegido, o cuando la lectura falla por otro motivo no indicado arriba.
Paso 9 - Guardar el UID sin imprimir la cara
File > Print > Contactless Smart Card only... (en Operating mode) no imprime la cara de la tarjeta. Sí lee el UID y lo guarda en el campo de base de datos que elegiste (cuando hay un campo definido).
En Windows, se usa el cuadro de diálogo de impresión habitual. En Mac, se abre el mismo panel de control Print que en una impresión normal (consulta El panel de control Print (Mac)). Después de hacer clic en Print, el trabajo solo guarda el UID.
Lee el UID y escribe el valor con formato en:
-
el objeto de destino de la plantilla abierta (puedes deshacerlo, y el documento se marca como modificado), y
-
el campo de base de datos, cuando hay uno definido. El campo se guarda en la base de datos, igual que con OK en el registro, y el registro vuelve al modo de consulta mostrando el UID. Si no se puede completar el guardado, el registro permanece en edición con el UID rellenado. Una lectura fallida o cancelada no abre el registro para editarlo.
Se aplica la misma comprobación de Professional Edition. Si la licencia no incluye la función, aparece el cuadro de diálogo de actualización del paso 1 y no se guarda nada.
El panel de control Print (Mac)
En Mac, File > Print > All..., Front side only..., Back side only..., Card only... y Contactless Smart Card only... abren todos el panel de control Print.
La ventana se titula Print. Tiene tres zonas:
-
Printer. Elige la impresora. Una línea bajo la lista puede indicar Printer of this template, Your default printer o macOS default printer. El texto indicativo de la lista de impresoras es Select a printer... Si no hay ninguna instalada, el mensaje es No printers are installed on this system. Si haces clic en Print sin seleccionar ninguna impresora, el aviso es Please select a printer. Mientras se comprueba la impresora, el estado puede mostrar Checking printer... y después un estado de la cola, como Ready, Paused, Offline, Error, Out of cards or feed problem, Printing, Cover open o Status unknown. En la vía Direct to printer (SDK), la cinta puede mostrar ~[LEFT] of [TOTAL] prints left o Ribbon: [PERCENT]% left.
-
Print path. Elige Direct to printer (SDK) o macOS print queue. Con macOS print queue, aparece la leyenda Bitmap only debajo de la vía.
-
Job. Configura Resolution (por ejemplo, Auto ([DPI] dpi) o [DPI] dpi), Copies y, si quieres, Rotate 180°. Records muestra 1 (current record) para el registro actual, o [COUNT] records para un lote. En una tarjeta de doble cara, Sides ofrece Front, Back y Front + back.
Los botones son Print y Cancel. Si aparece una comprobación antes del trabajo, la barra se titula Before printing [COUNT] card(s), el pie dice You can still print: press Print anyway. y el botón cambia a Print anyway.
Para Contactless Smart Card only..., el panel de control es igual. Después de hacer clic en Print, eMedia Cards guarda el UID en el campo de base de datos (cuando hay uno definido) y no imprime la cara de la tarjeta.
Revisar las lecturas de UID en el historial de actividad
Cada lectura de UID terminada añade una fila al historial de actividad de impresión, en Windows y en Mac. Esto incluye Test read y cada lectura durante la impresión. Retry y Next card no añaden filas: se cuentan en la misma fila.
Las filas solo se escriben cuando Record print activity está activado. Los informes de actividad de impresión requieren una licencia de edición Standard o superior.
-
Elige Tools > Options...
-
Abre la categoría Reports.
-
Comprueba que Record print activity está activado.
-
Lee las filas de Last 50 events.
-
Para mostrar solo las lecturas que no se completaron correctamente, en Show, elige Failed and aborted only.
Una fila sin contacto muestra estos valores:
| Columna | Valor |
|---|---|
| Kind | Contactless |
| Outcome | Success, No card, Read error o Cancelled |
| Record | El registro actual de la base de datos, si hay uno abierto, y luego el UID, el origen y los contadores, separados por ·. Ejemplo: UID 04A1B2C3D4E5F6 · Evolis SDK · Retry 1. |
Record muestra UID [UID] solo si la lectura es correcta. Retry [COUNT] y Next card [COUNT] solo aparecen cuando el contador es mayor que 0.
| Resultado | Significado |
|---|---|
| Success | Se leyó el UID. |
| No card | No se detectó ninguna tarjeta dentro del Card detection timeout:. |
| Cancelled | Se hizo clic en Cancel. |
| Read error | La lectura falló por otro motivo, por ejemplo un lector ocupado, una tarjeta retirada o un UID aleatorio. |
| Origen | Leído por |
|---|---|
| USB reader | Un lector de escritorio PC/SC, incluido Test read. |
| Evolis SDK | Una impresora Evolis con Use SDK printing (Windows). |
| Printers.ini | Los comandos sin contacto del perfil de la impresora (Windows). |
| Mac Evolis SDK | Una impresora Evolis en Mac. |
Una fila sin contacto tiene Copies en 0. No se suma a los totales de copias.
El UID solo se guarda si la lectura es correcta. Las claves de la tarjeta, las claves SAM y los bytes sin procesar del UID nunca se guardan.
Exportación CSV
La exportación CSV añade seis columnas después de ExtensionId. Los nombres de las columnas siempre están en inglés.
| Columna | Valor |
|---|---|
| ContactlessSource | UsbReader, EvolisSdk, PrintersIni o MacEvolisSdk |
| ContactlessUid | El UID, con el Byte order: y la Base: configurados en el panel. Vacío si la lectura no fue correcta. |
| RetryCount | Número de clics en Retry |
| NextCardCount | Número de pasos a la tarjeta siguiente con Next card |
| ContactlessDetail | success, no_card, read_error o cancelled |
| ContactlessMessage | Un motivo breve en inglés cuando la lectura no fue correcta, por ejemplo No contactless card was detected. |
En una fila sin contacto, JobKind es Contactless, Outcome es Success, Failed o Aborted, y PrinterName contiene el nombre del lector o de la impresora. ErrorCode indica el código del error, por ejemplo NO_CARD o READER_BUSY.
Solución de problemas
| Problema | Qué hacer |
|---|---|
| Cuadro de diálogo Available with Professional Edition. | La obtención del UID sin contacto requiere Professional Edition. Haz clic en OK y luego actualiza la licencia, o usa una copia Professional. |
| El botón Contactless no hace nada en una plantilla de Apple Wallet | Contactless no está disponible para Apple Wallet. Usa una plantilla de tarjeta de plástico. |
| No contactless reader found. Connect a PC/SC reader, then click Refresh. | Conecta el lector, instala su controlador si hace falta y luego haz clic en el botón de actualizar junto a Reader:. |
| Falta el lector esperado, o aparece como (not connected) | Haz clic en el botón de actualizar. Si sigue apareciendo (not connected), vuelve a conectar el dispositivo. O elige Automatic (first reader with a card). |
| The reader is busy. Close the other program using it, then try again. | Cierra la otra aplicación que tiene abierto el lector y vuelve a probar Test read o la impresión. |
| Cuadro de diálogo No contactless card detected con Retry, Next card y Cancel | Coloca una tarjeta sin contacto en el lector o bajo la antena de la impresora y luego haz clic en Retry para volver a esperar en el mismo lector, con la misma tarjeta. En una impresora, la tarjeta permanece en la antena. Next card, cuando se muestra ese botón, rechaza esta tarjeta y lleva la siguiente para el mismo registro. Tras pulsar Next card tres veces seguidas, eMedia Cards pregunta antes de rechazar otra. Haz clic en Cancel para rechazar la tarjeta una vez; en un lote, a continuación se te pregunta Do you want to continue printing? Test read no muestra este cuadro de diálogo: el tiempo de espera agotado solo aparece en la línea de estado del panel, y Cancel en Test read no muestra ningún error. |
| This card returns a random UID at each read. It cannot be used as a card number. | Ese chip no ofrece un UID estable. Usa otra tarjeta o guarda otro identificador. |
| The UID is … bytes long. Database field "…" is numeric and holds UIDs of 4 bytes or less. Use a text field. | Elige un campo de texto en Store in database field:, o usa un UID más corto con un campo numérico de 4 bytes o menos. |
| The serial number on the card can't be stored in the "…" field of the database as its type is not supported. | Elige un campo de texto (o un campo numérico, para un UID de 4 bytes o menos). |
| Turn on Contactless for this template before printing. | En modo Design, activa Contactless y elige un destino de guardado; luego guarda e imprime desde Operating mode. |
| La cara impresa no muestra el UID | Comprueba que Store in card object: apunta al objeto que esperas y que las fórmulas que deben usar el UID hacen referencia a ese campo u objeto. Ejecuta primero Test read para confirmar el lector. |
| Una impresora con antena nunca presenta la tarjeta al lector | Si usas una impresora Evolis con el SDK, comprueba Use SDK printing en Tools > Options.... Si no usas el SDK, eMedia Cards sigue moviendo la tarjeta con los comandos sin contacto del perfil de la impresora (en una Primacy 2, los mismos comandos que en la Primacy 1) y luego espera al lector durante el tiempo configurado en Card detection timeout:. Contactless insertion: en el perfil de la impresora es solo un retardo adicional antes de esa lectura. Comprueba el cable, la impresora y, en Windows, el registro Contactless encoding. |
Registro de diagnóstico (Windows)
Para capturar un seguimiento de la lectura del UID sin contacto para el soporte:
-
Elige Tools > Options...
-
Abre la categoría Logs.
-
En el grupo Print, activa Contactless encoding.
La descripción de esa opción es: UID read, reader choice, and Printers.ini contactless sequences (contactlessencoding.log). Card keys are never written.
El archivo es contactlessencoding.log y está en la carpeta de registros, que puedes abrir con Open logs folder en la misma página. El registro puede incluir el UID. Nunca incluye claves de la tarjeta ni claves SAM.
Cuando se agota una espera de impresión, cada Retry añade una línea como Timeout retry reader=... attempt=N (el nombre del lector y el número de intento). Cada Next card añade Timeout next card reader=... attempt=N. Cancel añade la línea Timeout cancelled.
En Mac, eMedia Cards no escribe estos archivos de registro.