Lecteurs de cartes

Guide des horloges

Version
R2024.2.0
Lecteurs de cartes

La section <cardreaders> contrôle le fonctionnement des lecteurs d’insigne internes et externes avec l’horloge Dayforce Touch. Vous pouvez définir des entrées pour les types de lecteurs suivants :

  • Code à barres interne
  • Magnétique interne
  • Proximité interne
  • Lecteur externe générique connecté par USB

Les entrées précisées dans le fichier config.custom.xml de l’horloge déterminent les classes de programme requises pour lire les cartes. Pour chaque entrée, vous pouvez également préciser quels caractères d’insigne le lecteur numérisera. Cela permet au lecteur de sauter des caractères avant de lire la chaîne requise.

Le fichier de configuration de l’horloge vous permet de définir le type d’appareil de votre lecteur d’insigne (par exemple, type="O"). Les caractères suivants représentent chaque type d’appareil valide :

  • « O » pour un lecteur de code à barres interne
  • « M » pour un lecteur magnétique interne
  • « X » pour un lecteur de proximité interne (RFID).
  • « XE » pour un lecteur externe, qui peut être un lecteur de code à barres, magnétique ou de proximité.

Pour les types d’appareils « O », « M » et « XE », les lecteurs reçoivent les caractères comme s’ils avaient été entrés à partir d’un clavier. Pour les types d’appareils « X », les lecteurs reçoivent les données au format binaire brut et le programme de l’horloge convertit les données en caractères.

N. B. : Vous définissez la longueur de l’insigne dans la section <system> du fichier de configuration. Si le lecteur détecte une insigne comportant moins de caractères que la longueur d’insigne définie, il ajoute des zéros à gauche du numéro d’insigne. Si le lecteur détecte une insigne comportant un nombre de caractères supérieur à la longueur définie, il supprime des caractères de la dernière partie du numéro d’insigne.

La section <cardreaders> contient les balises décrites ci-dessous :

<numkeypad>

Active le clavier numérique de l’horloge et règle les modes superviseur et transfert.

Par exemple :

<numkeypad enabled="yes" supervisor_mode="yes" transfer_mode="yes" />

<cardreader>

Active ou désactive le lecteur de carte à l’aide de l’attribut enabled.

Par exemple :

<cardreader enabled="yes"/>

<badgecoder>

N. B. : Le lecteur de carte et l’identification biométrique s’excluent mutuellement lors du fonctionnement en mode sans orientation. Si l’identification biométrique et le mode sans orientation sont activés, le lecteur de carte est automatiquement désactivé.

Les entrées de codage d’insigne sont requises pour chaque type de lecteur de carte utilisé dans l’horloge. Si l’horloge a plus d’un lecteur, vous devez insérer des entrées dans le fichier config.custom.xml pour chaque type de lecteur.

La balise <badgecoder> comporte les attributs suivants : 

  • type : définit le type de lecteur. Les options suivantes sont disponibles, comme décrit ci-dessus :
    • « O »
    • « M »
    • « X »
    • « XE »
  • totalLength : cet attribut n’est disponible que pour les lecteurs type="X", et doit toujours être défini à 32.
  • offset : réglez ceci au nombre de chiffres (ou de bits pour les lecteurs « X ») depuis le début des données qui doivent être ignorées avant d’accepter le nombre de chiffres (ou de bits) précisé dans la section length.
  • length : réglez ceci sur le nombre de chiffres (ou de bits) du numéro d’insigne de l’employé.

Exemples d’entrées de codage d’insigne

Cette section contient un exemple de chaque entrée de codage d’insigne valide, ainsi qu’une description de chaque configuration.

Exemple 1 – Saisissez « O »

Cette entrée correspond à un lecteur de code à barres qui lit 6 caractères sans décalage. Si la longueur de l’insigne définie ici est plus courte que la longueur définie dans la section <system>, des zéros non significatifs sont insérés :

<badgedecoder type="O" class="com.dayforce.devices.cardreader.GenericDecoder" offset="0" length="6"/>

Exemple 2 – Saisissez « M »

Cette entrée reflète un lecteur de carte magnétique qui lit 5 chiffres après avoir sauté les 9 premiers :

<badgedecoder type="M" class="com.dayforce.devices.cardreader.GenericDecoder" offset="9" length="5"/>

Exemple 3 – Saisissez « X »

Cette entrée reflète l’insigne de proximité HID 26 bits standard, dans lequel le numéro d’insigne est une valeur convertie à partir de 16 bits :

<badgedecoder type="X" class="com.dayforce.devices.cardreader.GenericHIDDecoder" totalLength="32" offset="15" length="16"/>

Exemple 4 – Saisissez « XE »

Cette entrée tient compte d’un lecteur externe connecté par un port USB qui peut être un code à barres, un lecteur de proximité ou un lecteur magnétique :

<badgecoder type="XE" class="com.dayforce.devices.cardreader.GenericDecoder" offset="0" length="6"/>

Remarques supplémentaires sur les lecteurs de proximité interne

Les lecteurs de proximité interne (RFID, version 3) prennent en charge les insignes 125 kHz et 13,5 MHz suivantes :

  • HID Proxpoint™
  • iClass™
  • Mifare™
  • NFC

N. B. : Des insignes à 13,5 MHz sont nécessaires pour utiliser la fonction d’enregistrement d’insignes, qui n’est actuellement prise en charge qu’en mode autonome et qui permet la lecture de CSN uniquement.

Les lecteurs de proximité internes déterminent les numéros d’insigne par le nombre total de bits qu’ils lisent. Par exemple, les lecteurs de proximité interne reçoivent un total de 32 bits d’une insigne 125 kHz. Si l’insigne comporte moins de bits, les bits de début sont insérés; si l’insigne a plus de bits, les 32 bits les moins significatifs (c’est-à-dire les derniers bits) sont reçus. Pour l’insigne standard à 26 bits, les 15 premiers bits sont ignorés pendant que les 16 bits suivants sont lus, lesquels sont ensuite convertis en un nombre à 5 chiffres. Pour les insignes à 34 bits ou à 35 bits, les 7 premiers bits sont ignorés pendant que les 24 bits suivants sont lus, lesquels sont ensuite convertis en un nombre à 8 chiffres.