Gerenciamento de crachás

Na guia “Configurações de autenticação do usuário”, na seção “Cartões”, há as seguintes opções de gerenciamento de cartões de identificação:

• Ativar o registro de vários cartões — essa opção está ativada por padrão. Se desativada, quando um novo cartão for registrado, os cartões atuais serão excluídos.

• Registrar cartões como temporários — Se essa opção estiver ativada, os cartões de identificação poderão ser registrados como temporários.

  • Validade dos cartões temporários — Defina a duração da validade dos cartões temporários em horas.

• Quando um cartão de identificação desconhecido é passado — Essas opções determinam o que deve acontecer quando um cartão de identificação desconhecido é passado. As opções são:

  • Falha na autenticação.

  • Permitir que o usuário existente registre o cartão — um usuário existente pode inserir seus dados de login após passar o cartão, e o cartão é registrado para esse usuário no servidor.

  • Registrar um novo usuário — registra o cartão como um novo usuário no servidor; você pode escolher se deseja que os usuários registrados dessa forma sejam automaticamente atribuídos a um grupo de usuários específico.

• Transformação do código do cartão — essa transformação é usada por terminais embarcados (com leitores USB conectados diretamente ao dispositivo) e pelo leitor de um terminal de hardware que está conectado, geralmente, como leitor principal.

• Transformação do leitor USB — marque a caixa para aplicar a transformação aos leitores de cartão conectados a uma porta USB do PC. Esses leitores de cartão são normalmente usados para recarregar crédito ou para associar cartões a contas de usuário.

Transformação de cartões de identificação

Este tópico aborda o recurso de transformação de cartões de identificação no MyQ. A transformação pode ser necessária se o cliente precisar importar números de cartões de um banco de dados de software de terceiros e o formato dos números de cartão nesse banco de dados não corresponder ao formato lido pelo leitor de cartão do MyQ.

Os leitores de cartões de sistemas de terceiros podem gerar saídas em um formato diferente daquele dos leitores de cartões usados no MyQ. Consequentemente, os números dos cartões dos usuários importados do sistema de terceiros podem diferir dos números lidos pelos leitores de cartões do MyQ. Para unificar o formato das duas saídas, é possível definir uma sequência específica de comandos que transforma a saída dos leitores de cartões do MyQ para o formato usado no banco de
dados do sistema de terceiros.

Na maioria dos leitores de cartões MyQ, é possível usar o software de configuração do leitor para definir o formato diretamente no próprio leitor de cartão. No entanto, é mais simples e rápido definir uma ou duas transformações universais do MyQ do que alterar separadamente as configurações de cada leitor de cartão.

Como configurar a transformação de cartões:

Na guia “Configurações de autenticação do usuário”, na seção “Cartões” e em “Avançado”, é possível definir e usar uma transformação para leitores de cartão e selecionar sua aplicação em um leitor USB conectado ao PC do administrador. O leitor USB pode ser usado para recarregar cartões de crédito ou associados.

Opções disponíveis:

• Transformação de código de cartão: essa transformação é usada por terminais embarcados (com leitores USB conectados diretamente ao dispositivo) e pelo leitor de um terminal HW que é conectado, geralmente, como leitor principal.

• Transformação do leitor USB: marque a caixa para aplicar a transformação aos leitores de cartão conectados a uma porta USB do PC. Esses leitores de cartão são normalmente usados para recarregar crédito ou associar cartões a contas de usuário.

Definindo a transformação

Você pode definir a transformação adicionando comandos que podem ser encontrados na lista abaixo. Os comandos devem ser separados por um ponto-e-vírgula (;) e são lidos e executados da esquerda para a direita. Por exemplo, na transformação ComandoX;ComandoY, o Comando X é executado primeiro e o Comando Y, em segundo lugar.

Todos os comandos, exceto o comando +, são aplicados da seguinte maneira:

O primeiro comando da transformação e cada comando imediatamente após o comando + são aplicados ao número inicial do cartão. Todos os demais comandos são aplicados ao resultado de seus antecessores.

 Comandos de transformação de cartões de identificação

• ltrim(número de caracteres) – Remove os primeiros X caracteres da esquerda.
  ltrim(2): 123456 —> 3456

• rtrim(número de caracteres) – Remove os primeiros X caracteres da direita (os últimos X caracteres).
  rtrim(2): 123456 —> 1234

• prepend(sequência de caracteres) – Adiciona a sequência de caracteres à frente do número do cartão.
  prepend(AB): 123456 —> AB123456

• append(sequência de caracteres) – Adiciona a sequência de caracteres ao final do número do cartão.
  append(AB): 123456 —> 123456AB

• left(número de caracteres) – Seleciona os primeiros X caracteres da esquerda (e remove o restante).
  left(2): 123456 —> 12

• right(número de caracteres) – Seleciona os primeiros X caracteres da direita.
  right(2):123456 —> 56

• mid(número de caracteres, número de caracteres) – Conta X caracteres a partir da esquerda e, em seguida, remove Y caracteres.
  mid(2,2): 123456 —> 1256

• lpad(número de posições, símbolo) – Completa a string até o comprimento especificado pelo parâmetro “número de posições”, adicionando o valor do parâmetro “símbolo” à esquerda (antes do número do cartão).
  lpad(12,0): 123456 —> 000000123456

• hex2dec() – Converte o número do cartão do formato hexadecimal para o decimal.
  hex2dec(): 1000AB —> 1048747

• dec2hex() – Converte o número do cartão do formato decimal para o formato hexadecimal.
  dec2hex(): 1048747 —> 1000AB

• hex2bin – Converte o número do cartão do formato hexadecimal para o binário.
  hex2bin(): 1000AB —> 100000000000010101011

• bin2hex – Converte o número do cartão do formato binário para o formato hexadecimal.
  bin2hex(): 100000000000010101011 —> 1000AB

• dec2bin – Converte o número do cartão do modo decimal para o modo binário.
  dec2bin(): 100023 —> 11000011010110111

• bin2dec – Converte o número do cartão do modo binário para o modo decimal.
  bin2dec(): 11000011010110111 —> 100023

• reverse() – Inverte a sequência de bytes, ou seja, agrupa todos os caracteres em pares de dois e inverte a ordem desses pares. (O último par fica em primeiro lugar, o penúltimo em segundo, etc.)
  reverse(): 1234AB —> AB3412

• reverseString() – Inverte a sequência de caracteres. (O último caractere vai primeiro, o penúltimo vai em segundo, etc.)
  reverseString(): 1234AB —> BA4321

• reverseNibbleBits() – Converte cada caractere do modo hexadecimal para o modo binário, inverte a sequência de caracteres de cada quarteto e converte o resultado de volta para o modo hexadecimal.
  reverseNibbleBits(): 10AB —> 0001 0000 1010 1011 —> 1000 0000 0101 1101 —> 805D

• upper() – Converte a string para maiúsculas.
  upper(): Abcd —> ABCD

• plugin(referência) – Chama um plugin de transformação de cartão com a referência fornecida. Essa opção permite o uso de scripts PHP personalizados para a transformação. Para obter mais informações sobre essa opção, entre em contato com o suporte do MyQ.

• asciiCode2ascii – Converte caracteres ASCII codificados como dígitos hexadecimais em caracteres ASCII.
  asciiCode2ascii(): 414F —> AO

• "string 1" + "string 2" – Une as strings à frente e atrás do comando +.
  "string 1":

  • O número inicial do cartão (se não houver comandos antes do símbolo +),

  • ou o resultado do último comando antes do símbolo + (se não houver comandos + antes do símbolo +),

  • ou o resultado do comando + anterior.
    “string 2”:

  • O número inicial do cartão (se não houver comandos após o símbolo + ou se o próximo comando for outro comando +),

  • ou o resultado do último comando da transformação (se não houver comandos + após o símbolo +),

  • ou o resultado do último comando antes de outro comando +.

Exemplo de transformação de cartão de identificação:

Número do cartão: 10AB

Transformação do código do cartão: hex2bin();lpad(16,0);reverseString();ltrim(8);reverseString();bin2hex() + ltrim(4);lpad(4,10AB)

Resultado: 1010AB

Processo de transformação:
("10AB" —> "1 0000 1010 1011" —> "0001 0000 1010 1011" —> "1101 0101 0000 1000" —> "0000 1000" —> "0001 0000" —> "10") + ("10AB" —> "" —> "10AB") ==> "1010AB"

Excluir cartões

Se você tiver a permissão “Excluir cartões” atribuída a você, poderá excluir os cartões de outros usuários. Isso se destina, por exemplo, a situações em que uma organização possui um balcão de atendimento onde você devolve seu cartão e ele deve ser removido do sistema.

Para fazer isso:

• Faça login e abra o Painel do MyQ.

• Clique na opção “Excluir cartões…”.

• Insira o número do cartão de identificação (manualmente ou passando o cartão em um leitor de cartão conectado ao seu computador):

• Clique em “Enter” para pesquisar o cartão.

• Quando o usuário for encontrado, clique em X para excluir o cartão e, em seguida, salve as alterações.