Attendance Scanning Troubleshooting for Middle and High Schools

Below you will find tips regarding basic trouble steps for troubleshooting attendance scanning devices found in CCS Middle and High Schools. Each set up consists of a Surface GO 3 running Windows 10 and a mobile receipt printer (Custom MP Ranger).

Known Issues:

 

  • User cannot log in

    • These devices are set up to be mobile and rely on CCS Wifi for their internet connection. Most often when a user cannot log in, they have not selected an SSID. This happens because sometimes the SSID will show that there is “No Internet” and the user does not select the SSID believing they will not be able to connect to the internet.

  • Users are logged in but cannot connect to the internet. The Chrome browser (with link to Infinite Campus) is launched automatically but displays a 404-error due to the lack of Internet connection.

    • The user has not selected an SSID or the user has selected an SSID that indicates that there is “No internet” connection. By right-clicking on the SSID in the selection menu you can choose “Forget”. This releases that SSID from the menu. The SSID will refresh and if there are no other contributing factors, should no longer show the “No Internet” warning.

  • User navigates to the “Check In/Check Out Kiosk” in IC but receives an error stating that the “Requested Resource was not Found”.

    • This is typically caused by the user not selecting the current year and their current school calendar in Infinite Campus. If a user has defaulted to or selected a year or calendar which has not been configured for attendance scanning, they will receive this result. To resolve this, simply select the current school year and the calendar for the school they are working in.

      image-20240830-110527.png

       

  • Students can “Check In” or Check Out” but the device will not print the student pass.

    • This is typically caused by a disruption to communication between the Surface device and the printer. There could be many reasons for this disruption, and we will go over those and troubleshooting below.

      • There are errors in the print queue. If there has been an error previously and the device has failed to print, this will create an error in the print queue. Any attempts to print after that will result in additional queued jobs. The print queue must be cleared to resume printing. Due to current CCS policy, users are only able to clear print queues for jobs that have been submitted by the user account. This can cause issues when another user has signed into the device and experienced an error and did not clear the queue prior to logging out. Technicians can clear the print queue of all jobs but may need to do so using the trouble shooting tool and providing their credentials.

      • Bluetooth is turned off. On occurrence it has been observed the Bluetooth has been turned off on the device. Enable Bluetooth and clear any error in the print queue and test for functionality.

      • The printer is no longer connected to Bluetooth. If the printer has been disconnected from Bluetooth, navigate to the Bluetooth menu within settings and click add new device. Power off the printer by holding the power button down for 5 seconds. Click the power button again to power up the device. The first led will flash white while in pairing mode. The device should up as “MP Ranger” followed by an identifying string. Click the printer to add. Clear any errors in the print queue and test for functionality.

      • QZTray is not running. QZTray is the application that allows for the printer to speak to the web browser directly bypassing the print dialogue menu. All devices have had QZTray installed and should be set up to run automatically upon startup. If QZtray is not running simply search for QZtray in the windows search tool and run. When running you should see either a white or green icon in the lower right corner of the Windows Taskbar. If QZTray is not installed, it may be installed using the following executable: .

        Please note, this version of QZTray is the only version supported by Infinite Campus to work with their attendance scanning product.

      • If the combination of the above steps does not resolve the error, it may be best to perform a clean install. In this case first remove the printer from both Bluetooth and Printer Management in Windows. Reboot the device and verify that the device is no longer appearing in either menu.

        • First, add the Printer to Bluetooth following the above instructions.

          • Once attached to Bluetooth click on the “More Options” link and click on the “Comm Ports” tab. Observe the “Outgoing” port. This should be either 3 or 4.

        • Second, install QZTray using the above executable.

        • Install and run the MP Ranger driver package:

          • When installing the drivers select Bluetooth Connection and then the Comm Port that matches with the outgoing port in your Blue Connection.

        • Once installation is complete you must rename the Printer to “icReceiptPrinter” for QZTray to recognize the printer as its output destination.

 

Additional Documentation:

 

Department of Accountability & Other Support Services
Division of Information Management