バッジリーダークライアントを使用したバッジリーダーデバイスの定義および登録

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • バッジリーダークライアントを使用して、システムに登録するバッジリーダーデバイスを作成します。バッジリーダーを登録すると、ウォークアップエクスペリエンス オンサイトキューで運用することができます。

    始める前に

    必要なロール:sn_badge.badge_admin

    このタスクについて

    バッジリーダーデバイスを登録するには、次の 2 つの方法があります。
    • バッジリーダークライアントを使用する、支援付き方法バッジリーダーと統合するには、独自のカスタムバッジリーダークライアントソフトウェアを作成する必要があります。
    • Now Platform® を介した、手動の方法。この手順の詳細については、「バッジリーダーデバイスの手動での定義および登録」を参照してください。

    バッジリーダーのクライアント支援による登録方法では、初期バッジリーダーレコードが作成されます。バッジリーダークライアントを使用してバッジをスキャンすると、この方法では、レコードの [デバイス識別子 ] フィールドにバッジリーダーデバイスのシリアル番号が自動的に入力されます。

    [デバイス識別子] フィールドの自動設定を使用すると、バッジリーダーレコードに追加するバッジリーダデバイスのシリアル番号を検索する時間を節約できます。

    バッジリーダークライアントの支援によってバッジリーダーデバイスを登録するには、まずシステムプロパティを構成して、バッジスキャンの登録を有効にし、バッジアクセストークンを無効にする必要があります。次のシステムプロパティを構成する必要があります。
    • sn_badge enable_scan_registration:デフォルトでは無効になっています。このプロパティを [True] に設定すると、badge.badge_admins が有効になり、バッジをスキャンしてバッジリーダーデバイスをすばやく登録することができます。
    • sn_badge disable_access_token:デフォルトで有効になっています。このプロパティは、Badge Reader Integration API のアクセストークン要件を無効にします。

    手順

    1. 次のように移動する。 All (すべて) > システムプロパティ > すべてのプロパティ.
    2. sn_badge と入力して、プロパティの名前で検索します。
    3. sn_badge.enable_scan_registration をクリックして、システムプロパティレコードを開きます。
      デフォルトでは、このプロパティは [False] に設定されています。
    4. プロパティの [] フィールドを [True] に変更し、[更新] をクリックします。
    5. sn_badge.disable_access_token をクリックして、システムプロパティレコードを開きます。
      デフォルトでは、このプロパティは [False] に設定されています。
    6. プロパティの [] フィールドを [True] に変更し、[更新] をクリックします。
    7. 独自のバッジリーダークライアントを作成して実行します。
    8. バッジリーダーでバッジアドミンのバッジをスワイプして登録します。
    9. バッジリーダークライアントは、デバイス識別子とカードデータを使用して、api/sn_badge/v1/reader/scan に対して REST API 呼び出しを実行します。
    10. 次のように移動する。 バッジリーダーの統合 > バッジリーダー をクリックして、新しく作成されたレコードを表示します。
    11. [名前] フィールドにバッジリーダーの名前を入力します。
      たとえば、Building B Tech Lounge Badge Reader などです。
      注:
      [ステータス] フィールドは読み取り専用で、新しいバッジリーダーを構成したときは [新規] になっています。このフィールドは、バッジリーダーがアクティベーション用に承認されたときに [アクティブ化済み] になります。バッジリーダーが非アクティブになっている場合、フィールドは [非アクティブ化済み] です。
    12. 検索リスト 検索リストアイコン アイコンを使用して、バッジイベントハンドラーを指定します。
      注:
      バッジイベントハンドラーを選択できない場合は、新しいバッジイベントハンドラーレコードを作成します。このプロセスの詳細については、「Badge Reader Integration イベントハンドラーの作成と変更」を参照してください。
    13. [デバイス識別子] および [秘密キー] フィールドが入力されていることを確認します。
      デバイス識別子は、バッジリーダーハードウェアを一意に識別します。クライアントはデフォルトでバッジリーダーデバイスのシリアル番号を使用します。入力した値は、クライアントソフトウェアアプリケーションから受信したデバイスのシリアル番号と一致する必要があります。
    14. 必要に応じて、[簡単な説明] および [場所] の必須ではないフォームフィールドに入力します。
    15. [送信] を選択して、バッジリーダーを登録します。