ID-Karten-Management

Auf der Registerkarte „Benutzerauthentifizierung“ im Abschnitt „Karten“ stehen folgende Optionen zur Verwaltung von ID-Karten zur Verfügung:

• Registrierung mehrerer Karten aktivieren – Diese Option ist standardmäßig aktiviert. Wenn sie deaktiviert ist, werden bei der Registrierung einer neuen Karte die aktuellen Karten gelöscht.

• Karten als temporär registrieren – Wenn diese Option aktiviert ist, können ID-Karten als temporär registriert werden.

  • Gültigkeitsdauer temporärer Karten – Legen Sie die Gültigkeitsdauer der temporären Karten in Stunden fest.

• Kartencode-Transformation – Diese Transformation wird von Embedded Terminals (mit direkt an das Gerät angeschlossenen USB-Lesegeräten) und vom Lesegerät eines HW-Terminals verwendet, das in der Regel als primäres Lesegerät angeschlossen ist.

• USB-Lesegerät-Transformation – Aktivieren Sie das Kontrollkästchen, um die Transformation auf Kartenlesegeräte anzuwenden, die an einen USB-Anschluss des PCs angeschlossen sind. Diese Kartenlesegeräte werden in der Regel zum Aufladen von Guthaben oder zum Verknüpfen von Karten mit Benutzerkonten verwendet.

Das manuelle Hinzufügen von Karten ist nicht möglich, wenn Karten aus einer LDAP-Quelle synchronisiert werden. Die manuell hinzugefügten Karten werden bei der nächsten LDAP-Synchronisierung gelöscht und durch die Karten aus der LDAP-Quelle überschrieben.

Das Hinzufügen mehrerer Karten über die LDAP-Synchronisierung wird unterstützt.

ID-Karten-Transformation

In diesem Abschnitt wird die Funktion zur ID-Karten-Transformation in MyQ behandelt. Die Transformation kann erforderlich sein, wenn der Kunde Kartennummern aus einer Datenbank einer Drittanbieter-Software importieren muss und das Format der Kartennummern in dieser Datenbank nicht mit dem vom MyQ-Kartenleser gelesenen Format übereinstimmt.

Kartenleser von Drittanbietersystemen können die Ausgabe in einem anderen Format liefern als die in MyQ verwendeten Kartenleser. Infolgedessen können sich die aus dem Drittanbietersystem importierten Kartennummern der Benutzer von den Kartennummern unterscheiden, die von den MyQ-Kartenlesern gelesen werden. Um das Format der beiden Ausgaben zu vereinheitlichen, können Sie eine bestimmte Befehlsfolge definieren, die die Ausgabe der MyQ-Kartenleser in das in der Datenbank des
Drittanbietersystems verwendete Format umwandelt.

Bei den meisten MyQ-Kartenlesern können Sie das Format mithilfe der Konfigurationssoftware direkt am Lesegerät einstellen. Es ist jedoch einfacher und schneller, ein oder zwei universelle MyQ-Konvertierungen festzulegen, als die Einstellungen jedes einzelnen Kartenlesers separat zu ändern.

So richten Sie die Kartenumwandlung ein:

Auf der Registerkarte „Benutzerauthentifizierung“ im Abschnitt „Karten“ und unter „Erweitert“ können Sie eine Transformation für Kartenleser definieren und verwenden sowie festlegen, dass diese auf einem an den Administrator-PC angeschlossenen USB-Lesegerät verwendet wird. Das USB-Lesegerät kann zum Aufladen von Guthaben- oder Partnerkarten verwendet werden.

Verfügbare Optionen:

• Kartencode-Transformation: Diese Transformation wird von Embedded Terminals (mit direkt am Gerät angeschlossenen USB-Lesegeräten) und vom Lesegerät eines HW-Terminals verwendet, das in der Regel als primäres Lesegerät angeschlossen ist.

• USB-Lesegerät-Transformation: Aktivieren Sie das Kontrollkästchen, um die Transformation auf Kartenlesegeräte anzuwenden, die an einen USB-Anschluss des PCs angeschlossen sind. Diese Kartenlesegeräte werden in der Regel zum Aufladen von Guthaben oder zum Verknüpfen von Karten mit Benutzerkonten verwendet.

Definieren der Transformation

Sie können die Transformation definieren, indem Sie Befehle hinzufügen, die in dieser Liste aufgeführt sind. Die Befehle müssen durch ein Semikolon (;) getrennt werden und werden von links nach rechts gelesen und ausgeführt. Beispielsweise wird bei der Transformation „BefehlX;BefehlY“ zuerst Befehl X und dann Befehl Y ausgeführt.

Alle Befehle, mit Ausnahme des Befehls +, werden wie folgt angewendet:

Der erste Befehl der Transformation und jeder Befehl unmittelbar hinter dem Befehl + werden auf die ursprüngliche Kartennummer angewendet. Alle anderen Befehle werden auf das Ergebnis ihrer Vorgänger angewendet.

Befehle zur ID-Karten-Transformation

• ltrim(Anzahl der Zeichen) – Entfernt die ersten X Zeichen von links.
  ltrim(2): 123456 —> 3456

• rtrim(Anzahl der Zeichen) – Entfernt die ersten X Zeichen von rechts (die letzten X Zeichen).
  rtrim(2): 123456 —> 1234

• prepend(Zeichenkette) – Fügt die Zeichenkette vor der Kartennummer ein.
  prepend(AB): 123456 —> AB123456

• append(Zeichenkette) – Fügt die Zeichenkette an das Ende der Kartennummer an.
  append(AB): 123456 —> 123456AB

• left(Anzahl der Zeichen) – Wählt die ersten X Zeichen von links aus (und entfernt den Rest).
  left(2): 123456 —>12

• right(Anzahl der Zeichen) – Wählt die ersten X Zeichen von rechts aus.
  right(2):123456 —> 56

• mid(Anzahl der Zeichen, Anzahl der Zeichen) – Entferne X Zeichen von links, entferne Y Zeichen von rechts und behalte die Zeichen in der Mitte.
  mid(2,2): 123456 —> 34

• lpad(Anzahl der Positionen, Symbol) – Vervollständigt die Zeichenkette auf die durch den Parameter „Anzahl der Positionen“ angegebene Länge, indem der Wert des Parameters „Symbol“ links (vor der Kartennummer) angehängt wird.
  lpad(12,0): 123456 —> 000000123456

• hex2dec() – Wandelt die Kartennummer vom Hexadezimal- in den Dezimalmodus um.
  hex2dec(): 1000AB —> 1048747

• dec2hex() – Wandelt die Kartennummer vom Dezimalsystem in das Hexadezimalsystem um.
  dec2hex(): 1048747 —>1000AB

• hex2bin – Wandelt die Kartennummer vom Hexadezimalformat in das Binärformat um.
  hex2bin(): 1000AB —> 100000000000010101011

• bin2hex – Wandelt die Kartennummer vom Binärformat in das Hexadezimalformat um.
  bin2hex(): 100000000000010101011 —> 1000AB

• dec2bin – Wandelt die Kartennummer vom Dezimalmodus in den Binärmodus um.
  dec2bin(): 100023 —> 11000011010110111

• bin2dec – Wandelt die Kartennummer vom Binärmodus in den Dezimalmodus um.
  bin2dec(): 11000011010110111 —> 100023

• reverse() – Kehrt die Byte-Reihenfolge um, d. h. nimmt alle Zeichen paarweise und kehrt die Reihenfolge der Paare um. (Das letzte Paar kommt an die erste Stelle, das vorletzte an die zweite usw.)
  reverse(): 1234AB —> AB3412

• reverseString() – Kehrt die Zeichenfolge um. (Das letzte Zeichen kommt an den Anfang, das vorletzte an die zweite Stelle usw.)
  reverseString(): 1234AB —> BA4321

• reverseNibbleBits() – Konvertiert jedes Zeichen vom Hexadezimalmodus in den Binärmodus, kehrt die Zeichenfolge jedes Viererblocks um und konvertiert das Ergebnis zurück in den Hexadezimalmodus.
  reverseNibbleBits(): 10AB —> 0001 0000 1010 1011 —> 1000 0000 0101 1101 —> 805D

• upper() – Wandelt die Zeichenfolge in Großbuchstaben um.
  upper(): Abcd —> ABCD

• plugin(reference) – Ruft ein Kartenumwandlungs-Plugin mit der angegebenen Referenz auf. Diese Option ermöglicht die Verwendung benutzerdefinierter PHP-Skripte für die Umwandlung. Weitere Informationen zu dieser Option erhalten Sie beim MyQ-Support.

• asciiCode2ascii – Konvertiert als Hexadezimalzahlen kodierte ASCII-Zeichen in ASCII-Zeichen.
  asciiCode2ascii(): 414F —> AO

• "Zeichenkette 1" + "Zeichenkette 2" – Fügt die Zeichenketten vor und hinter dem Befehl + zusammen.
  "Zeichenkette 1":

  • Entweder die ursprüngliche Kartennummer (wenn dem +-Symbol keine Befehle vorausgehen)

  • oder das Ergebnis des letzten Befehls vor dem +-Symbol (wenn dem +-Symbol keine +-Befehle vorausgehen)

  • oder das Ergebnis des vorherigen +-Befehls.
    „string 2“:

  • Entweder die ursprüngliche Kartennummer (wenn hinter dem +-Symbol keine Befehle stehen oder wenn der nächste Befehl ein weiterer +-Befehl ist),

  • oder das Ergebnis des letzten Befehls der Transformation (wenn hinter dem +-Symbol keine +-Befehle stehen),

  • oder das Ergebnis des letzten Befehls vor einem weiteren +-Befehl.

Beispiel für eine ID-Kartentransformation:

Kartennummer: 10AB

Kartencode-Transformation: hex2bin();lpad(16,0);reverseString();ltrim(8);reverseString();bin2hex() + ltrim(4);lpad(4,10AB)

Ergebnis: 1010AB

Umwandlungsprozess:
(„10AB“ —> „1 0000 1010 1011“ —> „0001 0000 1010 1011“ —> „1101 0101 0000 1000“ —> „0000 1000“ —> "0001 0000" —> "10") + ("10AB"" —> "" —> "10AB") ==> "1010AB"