Add a barcode scanner

Overview

This article guides you through the process of installing the software required by Clubware to detect and communicate with a barcode scanner.
The article is divided into the following eight topics:

Prerequisites
   Role
   Rules
Use case
Navigation
   Adding an access card number
Install node software
Install barcode scanner software

 

Prerequisites

Barcode scanners can only be connected to Clubware via a computer running Windows OS.

The barcode scanner software must be installed onto the Windows machine that has the scanner plugged into it.

Numeric and Alpha-numeric barcodes (up to 200 characters long) are supported by Clubware.

 

Role

All Roles permit Staff members to connect a scanner to Clubware.

 

Rules

Only supported scanners can be used with Clubware. There are two we recommend (see below).

Your barcode scanner must be configured to be used with Clubware. This is done by scanning specific manufacturer barcodes provided with your scanner. These settings vary from device to device.

To configure your barcode scanner, identify the model via the sticker at the bottom of your device, then select the supported scanner from the list below and follow the configuration instructions:

Motorola DS9208 Configuration

Motorola LS2208 Configuration

 

Use case

Connecting a barcode scanner enables you quickly log member arrivals using membership cards with a barcode printed on them.

The barcode scanner software constantly listens to your barcode reader, sending any scanned barcodes to Clubware.

 

Navigation

Once installed, the barcode scanner software will interact with Clubware in the following way:

 

Adding an access card number

To add an access card number to a member:
Navigate to a member's overview page.
Within the access card panel, click add:

 

If the barcode scanner software is installed, a barcode icon will be displayed on the right-hand side of the access card number field. Click the barcode icon to enter a card number via your scanner:

Note: If there is an issue with the barcode scanner, its connectivity or the barcode scanner software is not installed, a warning is displayed:

 

Install node software

Node.js version 16.6.2 must be installed to enable your barcode scanner to interact with Clubware:

		Ensure your barcode scanner is not plugged into your machine
		Download Node version 16.6.2 https://nodejs.org/dist/v16.6.2/node-v16.6.2-x64.msi
		Double click on node-v16.6.2-x64.msi
		Click Run and use the default installation options
		Click Next
		Accept the License Agreement terms
		Click Next
		Click Next
		Click Next
		Click Next
		Click Install
		Node.js will be installed onto your machine
		Click Finish

 

Install barcode scanner software

The Clubware Barcode Scanner software must be installed to enable your barcode scanner to interact with Clubware:

		Download Barcode installer.zip Barcode installer.zip can be downloaded via the link at the bottom of this article:
		Unzip Barcode installer.zip
		Move the unzipped Barcode installer folder to C:\Program Files (x86)\Clubware\ Tip: If the Clubware folder does not exist in C:\Program Files (x86), you will need to create it.
		Double click on barcode-service-signed.exe
		Click Run
		The program will install the necessary files:
		Double click on index.html
		A browser window will open displaying the scanner configuration page: Tip: The URL for this page will be http://localhost:8410 Note: If the screen is greyed out with a spinning loading symbol, it is likely the services were not successfully installed. To resolve this, open the Command Prompt window (CMD) on your computer. Type the following 4 lines (hit enter after each line): > npm -g install yarn > yarn > node installConfig.min.js > node installService.min.js If you need to uninstall before attempting to re-install again, type the following 2 lines (hit enter after each line): > node uninstallService.min.js > node uninstallConfig.min.js Delete all files in the C:\Program Files (x86)\Clubware\ folder except for the *.json files.
		Click Install Tip: The Service Status will change from NOT_INSTALLED to RUNNING.
		Plug your barcode scanner into your machine and refresh the browser page Note: Only one barcode scanner can be plugged into each machine.
		Select the barcode scanner from the Device settings dropdown box Note: If you do not see your scanner in the dropdown box, it is likely you have not yet installed the device drivers for your scanner.
		Enter your Branch name Note: This must be the exact spelling and capitalisation as it appears in Clubware.
		Enter the Application ID Note: To obtain your Application ID, in Clubware, hit the F12 key on your keyboard to present the browser Console: Ensure Console is selected: Expand getInitialisationData: Expand RESULTS: Expand data: The Application ID is displayed here:
		Enter the Branch ID Note: To obtain your Branch ID, in Clubware, navigate to any member of the branch. The Branch ID is located immediately after the characters /branch/ within the page's URL. e.g. https://fitfarm.staff.clubware.global/branch/98b2ab7e-bf1a-4103-a22e-3e46049957bf/members/0da699b8-f11d-4d88-bb63-49c5f13b5a94/overview
		Enter the API Username and Password Note: The API Username and Password is supplied to you on request. Please contact Clubware support if you have not been advised what the API Username and Password is.
		Enter the Auth URL Note: The Auth URL is https://prod.auth.clubware.global/oauth2/token
		Enter the API URL Note: The API URL is https://prod.api.clubware.global/access-control
		Click Update to save your settings
		Click Start to turn on the service