Gestión de tarjetas de identidad

En la pestaña de configuración de Autenticación de usuario, en la sección Tarjetas, se encuentran las siguientes opciones de gestión de tarjetas de identificación:

• Habilitar el registro de varias tarjetas: esta opción está habilitada de forma predeterminada. Si se deshabilita, cuando se registra una nueva tarjeta, se eliminan las tarjetas actuales.

• Registrar tarjetas como temporales: si se habilita, las tarjetas de identificación se pueden registrar como temporales.

  • Validez de las tarjetas temporales: establezca la duración de la validez de las tarjetas temporales en horas.

• Transformación del código de la tarjeta: esta transformación la utilizan los Embedded Terminals (con lectores USB conectados directamente al dispositivo) y el lector de un terminal HW que suele conectarse como lector principal.

• Transformación del lector USB: marque la casilla para aplicar la transformación a los lectores de tarjetas conectados a un puerto USB del PC. Estos lectores de tarjetas se utilizan normalmente para recargar saldo o para asociar tarjetas a cuentas de usuario.

No es posible añadir tarjetas manualmente cuando las tarjetas se sincronizan desde una fuente LDAP. Las tarjetas añadidas manualmente se eliminarán durante la siguiente sincronización LDAP y serán sobrescritas por las tarjetas de la fuente LDAP.

Setting up an LDAP synchronizationSe admite la adición de varias tarjetas a través de la sincronización LDAP.

Transformación de tarjetas de identificación

En este tema se describe la función de transformación de tarjetas de identificación en MyQ. La transformación puede ser necesaria si el cliente necesita importar números de tarjeta desde una base de datos de software de terceros y el formato de los números de tarjeta de dicha base de datos no coincide con el formato leído por el lector de tarjetas de MyQ.

Los lectores de tarjetas de sistemas de terceros pueden generar una salida en un formato diferente al de los lectores de tarjetas utilizados en MyQ. En consecuencia, los números de tarjeta de los usuarios importados desde el sistema de terceros pueden diferir de los números de tarjeta leídos por los lectores de tarjetas MyQ. Para unificar el formato de ambas salidas, puede definir una secuencia específica de comandos que transforme la salida de los lectores de tarjetas MyQ al formato utilizado en la base de
datos del sistema de terceros.

Con la mayoría de los lectores de tarjetas MyQ, puede utilizar el software de configuración del lector de tarjetas para establecer el formato directamente en el lector. Sin embargo, es más sencillo y rápido configurar una o dos transformaciones universales de MyQ que cambiar por separado los ajustes de cada lector de tarjetas.

Cómo configurar la transformación de tarjetas:

En la pestaña Ajustes de autenticación de usuario, en la sección Tarjetas y en Avanzado, puede definir y utilizar una transformación para lectores de tarjetas y seleccionar su uso en un lector USB conectado al PC del administrador. El lector USB se puede utilizar para recargar tarjetas de crédito o tarjetas asociadas.

Opciones disponibles:

• Transformación del código de la tarjeta: Esta transformación es utilizada por los Embedded Terminals (con lectores USB conectados directamente al dispositivo) y por el lector de un terminal HW que suele estar conectado como lector principal.

• Transformación del lector USB: marque la casilla para aplicar la transformación a los lectores de tarjetas conectados a un puerto USB del PC. Estos lectores de tarjetas se utilizan normalmente para recargar crédito o para asociar tarjetas a cuentas de usuario.

Definición de la transformación

Puede definir la transformación añadiendo comandos que se encuentran en esta lista. Los comandos deben estar separados por un punto y coma (;) y se leen y ejecutan de izquierda a derecha. Por ejemplo, en la transformación CommandX;CommandY, el comando X se ejecuta primero y el comando Y, en segundo lugar.

Todos los comandos, excepto el comando +, se aplican de la siguiente manera:

El primer comando de la transformación y cada comando inmediatamente posterior al comando + se aplican al número de tarjeta inicial. Todos los demás comandos se aplican al resultado de sus predecesores.

Comandos de transformación de tarjetas de identificación

• ltrim(número de caracteres) – Elimina los primeros X caracteres de la izquierda.
  ltrim(2): 123456 —> 3456

• rtrim(número de caracteres): elimina los primeros X caracteres de la derecha (los últimos X caracteres).
  rtrim(2): 123456 —> 1234

• prepend(cadena de caracteres): añade la cadena delante del número de tarjeta.
  prepend(AB): 123456 —> AB123456

• append(cadena de caracteres): añade la cadena al final del número de tarjeta.
  append(AB): 123456 —> 123456AB

• left(número de caracteres): selecciona los primeros X caracteres desde la izquierda (y elimina el resto).
  left(2): 123456 —>12

• right(número de caracteres): selecciona los primeros X caracteres de la derecha.
  right(2):123456 —> 56

• mid(número de caracteres, número de caracteres) – Elimina X caracteres de la izquierda, elimina Y caracteres de la derecha y deja los caracteres del medio.
  mid(2,2): 123456 —> 34

• lpad(número de posiciones, símbolo) – Completa la cadena hasta la longitud especificada por el parámetro número de posiciones añadiendo el valor del parámetro símbolo a la izquierda (delante del número de tarjeta).
  lpad(12,0): 123456 —> 000000123456

• hex2dec() – Transforma el número de tarjeta del modo hexadecimal al modo decimal.
  hex2dec(): 1000AB —> 1048747

• dec2hex() – Transforma el número de tarjeta del modo decimal al modo hexadecimal.
  dec2hex(): 1048747 —>1000AB

• hex2bin – Convierte el número de la tarjeta del formato hexadecimal al binario.
  hex2bin(): 1000AB —> 100000000000010101011

• bin2hex – Convierte el número de la tarjeta de binario a hexadecimal.
  bin2hex(): 100000000000010101011 —> 1000AB

• dec2bin – Convierte el número de la tarjeta del modo decimal al modo binario.
  dec2bin(): 100023 —> 11000011010110111

• bin2dec – Convierte el número de la tarjeta de binario a decimal.
  bin2dec(): 11000011010110111 —> 100023

• reverse() – Invierte la secuencia de bytes, es decir, toma todos los caracteres de dos en dos e invierte el orden de los pares. (El último par va primero, el penúltimo va segundo, etc.)
  reverse(): 1234AB —> AB3412

• reverseString() – Invierte la secuencia de caracteres. (El último carácter va primero, el penúltimo va segundo, etc.)
  reverseString(): 1234AB —> BA4321

• reverseNibbleBits() – Convierte cada carácter del modo hexadecimal al modo binario, invierte la secuencia de caracteres de cada cuádruple y vuelve a convertir el resultado al modo hexadecimal.
  reverseNibbleBits(): 10AB —> 0001 0000 1010 1011 —> 1000 0000 0101 1101 —> 805D

• upper() – Convierte la cadena a mayúsculas.
  upper(): Abcd —> ABCD

• plugin(reference) – Llama a un complemento de transformación de tarjetas con la referencia dada. Esta opción permite utilizar scripts PHP personalizados para la transformación. Para obtener más información sobre esta opción, póngase en contacto con el servicio de asistencia de MyQ.

• asciiCode2ascii – Convierte los caracteres ASCII codificados como dígitos hexadecimales a caracteres ASCII.
  asciiCode2ascii(): 414F —> AO

• "cadena 1" + "cadena 2" – Une las cadenas situadas delante y detrás del comando +.
  "cadena 1":

  • O bien el número de tarjeta inicial (si no hay comandos que precedan al símbolo +),

  • o el resultado del último comando antes del símbolo + (si no hay comandos + precediendo al símbolo +),

  • o el resultado del comando + anterior.
    «cadena 2»:

  • O bien el número de tarjeta inicial (si no hay comandos detrás del símbolo + o si el siguiente comando es otro comando +),

  • o el resultado del último comando de la transformación (si no hay comandos + detrás del símbolo +),

  • o el resultado del último comando antes de otro comando +.

Ejemplo de transformación de tarjeta de identificación:

Número de tarjeta: 10AB

Transformación del código de la tarjeta: hex2bin();lpad(16,0);reverseString();ltrim(8);reverseString();bin2hex() + ltrim(4);lpad(4,10AB)

Resultado: 1010AB

Proceso de transformación:
(«10AB» —> «1 0000 1010 1011» —> «0001 0000 1010 1011» —> «1101 0101 0000 1000» —> «0000 1000» —> «0001 0000» —> «10») + («10AB» —> «» —> «10AB») ==> «1010AB»