Gestione delle carte d’identità

Nella scheda delle impostazioni di Autenticazione utente, nella sezione Schede, sono disponibili le seguenti opzioni di gestione delle schede di identificazione:

Abilita registrazione di più carte - Questa opzione è abilitata per impostazione predefinita. Se disabilitata, quando viene registrata una nuova carta, le carte attuali vengono eliminate.
Registra le tessere come temporanee - Se questa opzione è abilitata, le tessere identificative possono essere registrate come temporanee.
- Validità delle tessere temporanee - Imposta la durata della validità delle tessere temporanee in ore.
Trasformazione del codice della carta - Questa trasformazione viene utilizzata dagli Embedded Terminal (con lettori USB collegati direttamente al dispositivo) e dal lettore di un terminale HW che è collegato, solitamente, come lettore primario.
Trasformazione del lettore USB - Selezionare la casella per applicare la trasformazione ai lettori di carte collegati a una porta USB del PC. Questi lettori di carte sono solitamente utilizzati per ricaricare il credito o per associare le carte agli account utente.

User Authentication settings tab - Cards

L'aggiunta manuale delle carte non è possibile quando le carte vengono sincronizzate da una fonte LDAP. Le carte aggiunte manualmente verranno eliminate durante la successiva sincronizzazione LDAP e sovrascritte dalle carte provenienti dalla fonte LDAP.

Setting up an LDAP synchronizationÈ supportata l'aggiunta di più tessere tramite la sincronizzazione LDAP.

Trasformazione della tessera identificativa

Questo argomento tratta la funzione di trasformazione delle tessere identificative in MyQ. La trasformazione potrebbe essere necessaria se il cliente deve importare i numeri delle tessere da un database di un software di terze parti e il formato dei numeri delle tessere in questo database non corrisponde al formato letto dal lettore di tessere MyQ.

I lettori di carte di sistemi di terze parti possono fornire un output in un formato diverso rispetto ai lettori di carte utilizzati in MyQ. Di conseguenza, i numeri delle carte degli utenti importati dal sistema di terze parti possono differire dai numeri delle carte letti dai lettori di carte MyQ. Per unificare il formato dei due output, è possibile definire una sequenza specifica di comandi che trasformi l'output dei lettori di carte MyQ nel formato utilizzato nel database del
sistema di terze parti.

Con la maggior parte dei lettori di tessere MyQ, è possibile utilizzare il software di configurazione del lettore per impostare il formato direttamente sul lettore. Tuttavia, è più semplice e veloce impostare una o due trasformazioni MyQ universali piuttosto che modificare separatamente le impostazioni di ciascun lettore di tessere.

Come configurare la trasformazione delle tessere:

Nella scheda Impostazioni di autenticazione utente, nella sezione Carte e sotto Avanzate, è possibile definire e utilizzare una trasformazione per i lettori di carte e selezionare di utilizzarla su un lettore USB collegato al PC dell'amministratore. Il lettore USB può essere utilizzato per ricaricare carte di credito o associate.

Opzioni disponibili:

Trasformazione codice carta: questa trasformazione viene utilizzata dagli Embedded Terminal (con lettori USB collegati direttamente al dispositivo) e dal lettore di un terminale HW che è collegato, solitamente, come lettore principale.
Trasformazione del lettore USB: selezionare la casella per applicare la trasformazione ai lettori di carte collegati a una porta USB del PC. Questi lettori di carte vengono solitamente utilizzati per ricaricare il credito o per associare le carte agli account utente.

Definizione della trasformazione

È possibile definire la trasformazione aggiungendo i comandi presenti in questo elenco. I comandi devono essere separati da un punto e virgola (;) e vengono letti ed eseguiti da sinistra a destra. Ad esempio, nella trasformazione CommandX;CommandY, il comando X viene eseguito per primo e il comando Y per secondo.

Tutti i comandi, ad eccezione del comando +, vengono applicati nel modo seguente:

Il primo comando della trasformazione e ogni comando immediatamente successivo al comando + vengono applicati al numero della carta iniziale. Tutti gli altri comandi vengono applicati al risultato dei comandi precedenti.

Comandi di trasformazione della carta d'identità

ltrim(numero di caratteri) – Rimuove i primi X caratteri da sinistra.
ltrim(2): 123456 —> 3456
rtrim(numero di caratteri) – Rimuove i primi X caratteri da destra (gli ultimi X caratteri).
rtrim(2): 123456 —> 1234
prepend(stringa di caratteri) – Aggiunge la stringa all'inizio del numero della carta.
prepend(AB): 123456 —> AB123456
append(stringa di caratteri) – Aggiunge la stringa dopo il numero della carta.
append(AB): 123456 —> 123456AB
left(numero di caratteri) – Seleziona i primi X caratteri da sinistra (e rimuove il resto).
left(2): 123456 —>12
right(numero di caratteri) – Seleziona i primi X caratteri da destra.
right(2):123456 —> 56
mid(numero di caratteri, numero di caratteri) – Rimuove X caratteri da sinistra, rimuove Y caratteri da destra e lascia i caratteri al centro.
mid(2,2): 123456 —> 34
lpad(numero di posizioni, simbolo) – Completa la stringa fino alla lunghezza specificata dal parametro numero di posizioni aggiungendo il valore del parametro simbolo a sinistra (prima del numero della carta).
lpad(12,0): 123456 —> 000000123456
hex2dec() – Trasforma il numero della carta dalla modalità esadecimale a quella decimale.
hex2dec(): 1000AB —> 1048747
dec2hex() – Trasforma il numero della carta dalla modalità decimale a quella esadecimale.
dec2hex(): 1048747 —>1000AB
hex2bin – Trasforma il numero della carta dalla modalità esadecimale alla modalità binaria.
hex2bin(): 1000AB —> 100000000000010101011
bin2hex – Trasforma il numero della carta dalla modalità binaria a quella esadecimale.
bin2hex(): 100000000000010101011 —> 1000AB
dec2bin – Trasforma il numero della carta dalla modalità decimale alla modalità binaria.
dec2bin(): 100023 —> 11000011010110111
bin2dec – Trasforma il numero della carta dalla modalità binaria a quella decimale.
bin2dec(): 11000011010110111 —> 100023
reverse() – Inverte la sequenza di byte, ovvero prende tutti i caratteri a coppie e inverte l'ordine delle coppie. (L'ultima coppia va per prima, la penultima va seconda, ecc.)
reverse(): 1234AB —> AB3412
reverseString() – Inverte la sequenza di caratteri. (L'ultimo carattere va per primo, il penultimo va secondo, ecc.)
reverseString(): 1234AB —> BA4321
reverseNibbleBits() – Converte ogni carattere dalla modalità esadecimale a quella binaria, inverte la sequenza di caratteri di ogni quartina e riconverte il risultato in modalità esadecimale.
reverseNibbleBits(): 10AB —> 0001 0000 1010 1011 —> 1000 0000 0101 1101 —> 805D
upper() – Converte la stringa in maiuscolo.
upper(): Abcd —> ABCD
plugin(reference) – Chiama un plugin di trasformazione delle schede con il riferimento specificato. Questa opzione consente di utilizzare script PHP personalizzati per la trasformazione. Per ulteriori informazioni su questa opzione, contattare l'assistenza MyQ.
asciiCode2ascii – Converte i caratteri ASCII codificati come cifre esadecimali in caratteri ASCII.
asciiCode2ascii(): 414F —> AO
"stringa 1" + "stringa 2" – Unisce le stringhe che precedono e seguono il comando +.
"stringa 1":
- O il numero della scheda iniziale (se non ci sono comandi che precedono il simbolo +),
- oppure il risultato dell'ultimo comando prima del simbolo + (se non ci sono comandi + che precedono il simbolo +),
- oppure il risultato del comando + precedente.
  "string 2":
- O il numero della carta iniziale (se non ci sono comandi dopo il simbolo + o se il comando successivo è un altro comando +),
- oppure il risultato dell'ultimo comando della trasformazione (se non ci sono comandi + dopo il simbolo +),
- oppure il risultato dell'ultimo comando prima di un altro comando +.

Esempio di trasformazione della carta ID:

Numero della carta: 10AB

Trasformazione del codice della carta: hex2bin();lpad(16,0);reverseString();ltrim(8);reverseString();bin2hex() + ltrim(4);lpad(4,10AB)

Risultato: 1010AB

Processo di trasformazione:
("10AB" —> "1 0000 1010 1011" —> "0001 0000 1010 1011" —> "1101 0101 0000 1000" —> "0000 1000" —> "0001 0000" —> "10") + ("10AB"" —> "" —> "10AB") ==> "1010AB"