Définir et enregistrer un lecteur de badge à l'aide du client Lecture de badge

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Utilisez le client lecteur de badge pour créer un appareil de lecture de badge pour l'enregistrement dans votre système. L'enregistrement de votre lecteur de badge vous permet de le rendre opérationnel dans votre file d'attente sur site Expérience de visite.

    Avant de commencer

    Rôle requis : sn_badge.badge_admin

    Pourquoi et quand exécuter cette tâche

    Il existe deux façons d'enregistrer un appareil de lecture de badge :
    • Méthode assistée, par l'intermédiaire du client lecteur de badge. Vous devez créer votre propre logiciel client de lecteur de badge personnalisé pour l'intégrer au lecteur de badge.
    • Manuellement, via la ServiceNow AI Platform®. Reportez-vous à la section Définir et enregistrer manuellement un lecteur de badge pour plus de détails sur cette procédure.

    La méthode assistée d'enregistrement du client lecteur de badge crée un enregistrement initial du lecteur de badge. Lorsqu’un badge est analysé à l’aide du client du lecteur de badge, cette méthode remplit automatiquement le champ Identificateur de l’appareil de l’enregistrement avec le numéro de série de l’appareil de lecture de badge.

    Le remplissage automatique du champ Identificateur d'appareil vous permet de gagner du temps dans la recherche du numéro de série de l'appareil de lecture de badge à ajouter à son enregistrement.

    Pour enregistrer votre appareil de lecture de badge avec l'assistance du client lecteur de badge, vous devez d'abord configurer les propriétés système pour activer l'enregistrement de l'analyse de badge et désactiver le jeton d'accès au badge. Les propriétés système suivantes doivent être configurées :
    • sn_badge.enable_scan_registration : désactivée par défaut. Lorsqu'elle est définie sur vrai, cette propriété permet à n_badge.badge_admins d'enregistrer rapidement les appareils de lecture de badge en analysant un badge.
    • sn_badge.disable_access_token : activée par défaut. Cette propriété désactive la demande de jeton d'accès pour l'API Badge Reader Integration.

    Procédure

    1. Accédez à la Tous > Propriétés système > Toutes les propriétés.
    2. Recherchez les propriétés par Nom en tapant sn_badge.
    3. Cliquez sur sn_badge.enable_scan_registration pour ouvrir l'enregistrement de propriété système.
      La propriété est définie sur False par défaut.
    4. Modifiez le champ Valeur de la propriété sur Vrai et cliquez sur Mettre à jour.
    5. Cliquez sur sn_badge.disable_access_token pour ouvrir l'enregistrement de propriété système.
      La propriété est définie sur False par défaut.
    6. Modifiez le champ Valeur de la propriété sur Vrai et cliquez sur Mettre à jour.
    7. Créez puis exécutez votre propre client de lecture de badge.
    8. Faites glisser le badge de l’administrateur du badge sur le lecteur de badge pour vous inscrire.
    9. Le client lecteur de badge effectue un appel d’API REST à api/sn_badge/v1/reader/scan avec l’identificateur de l’appareil et les données de la carte.
    10. Accédez à la Intégration de lecteur de badge > Lecteurs de badge pour afficher l’enregistrement nouvellement créé.
    11. Fournissez un nom pour le lecteur de badge dans le champ Nom.
      Par exemple, Lecteur de badge Salon technologique Bâtiment B.
      Remarque :
      Le champ Statut est en lecture seule et indique Nouveau lors de la configuration d'un nouveau lecteur de badge. Le champ indique Activé lorsqu'un lecteur de badge est approuvé pour l'activation. Si un lecteur de badge est désactivé, le champ indique Désactivé.
    12. Spécifiez un gestionnaire d'événements de badge à l'aide de l'icône de liste de recherche icône de liste de recherche.
      Remarque :
      si aucun gestionnaire d'événements de badge n'est disponible à la sélection, créez un nouvel enregistrement de gestionnaire d'événements de badge. Pour plus de détails sur ce processus, reportez-vous à la section Créer ou modifier des gestionnaires d'événements pour Badge Reader Integration.
    13. Vérifiez que les champs Identificateur d'appareil et Clé secrète sont remplis.
      L'identificateur d'appareil identifie uniquement le matériel de lecture de badge. Le client utilise par défaut le numéro de série de l'appareil de lecture de badge. La valeur saisie doit correspondre au numéro de série de l'appareil reçu depuis l'application du logiciel client.
    14. Remplissez les champs de formulaire facultatifs Brève description et Emplacement si vous le souhaitez.
    15. Sélectionnez Soumettre pour enregistrer le lecteur de badge.