Smart School Biometric Attendance App

Attendance automation for your Smart School.
By
img

Ver. 1.0
Email: support@qdocs.in
Website: smart-school.in


We would like to thank you for purchasing Smart School Biometric Attendance App! We are very pleased you have chosen Smart School for your institution, you will not be disappointed! Before you get started, please be sure to always check out these documentation files. We outline all kinds of good information, and provide you with all the details you need to use Smart School Biometric Attendance App.

If you are unable to find your answer here in our documentation then visit our support article site smart-school.in/articles. If you are still unable to find it anywhere, then please go our Support section and open a new Support Ticket with all the details we need. Please be sure to include your site URL as well. Thank you, we hope you enjoy using Smart School Biometric Attendance App!

Help & Support

System Requirements


Smart School Biometric Attendance App will be install on a pc or computer which should be on same network where biometric attendance devices are connected through router. Using Smart School Biometric Attendance App, you must have running Smart School version 5.2.0 on your online server with domain or subdomain or ip address. Smart School Biometric Attendance App sends attendance data to your online Smart School so before using Smart School Biometric Attendance App you must configure your Smart School for the biometric devices you will use with Smart School Biometric Attendance App.

To install Smart School Biometric Attendance App, below are a list of items you should ensure your computer hardware/software should comply with -

  • Atleast Intel i3 processor or its equivalent other processor
  • Atleast 4GB of RAM
  • Atleast Microsoft Windows 7 - 64 Bit Operating System
  • Broadband Internet connectivity with minimum 1 MBPS speed

Smart School Biometric Attendance App Installation & Configuration


Smart School Biometric Attendance App can be install and configure in following 5 steps -

Step 1 - Biometric Device Configuration

Smart School Biometric Attendance App supports any biometric attendance device which supports ZKTeco Firmware with Push Data (atleast Push Service Ver. 2) feature. In this documentation we have used ZKTeco K60 model device.

In your network biometric devices and computer where you will install Smart School Biometric Attendance App should be connected with your network Router through LAN wire or Wifi. The computer where you will install Smart School Biometric Attendance App must be internet ready otherwise it will not send attendance data to your Smart School even you have hosted Smart School on your local LAN network.

img

Biometric device configuration consist basically Networking Setting and Student User records entry. Student records should be mapped with Smart School student Admission Number so Smart School Biometric Attendance App can send attendance data to Smart School and mark Present attendance for that student.

At Main Menu screen first we will go to device System Info area to check device Serial Number. This Serial Number will be required in Step 3 and 5.

img

Then go to Device Info

img

In next screen we will see various details of device. Here we will note down Serial Number of device which will be used in Step 3 and 5.

img

Now at Main Menu screen we will go for COMM. (Communication) area to set Ip Address and other networking details.

img

Then go to Ethernet

img

In next screen you will see IP Address, here edit it to set Ip Address for this device. Please note that this device ip address and the computer where you will install Smart School Biometric Attendance App must be in same network e.g if your router ip address is 192.168.1.1 then your computer ip address should be 192.168.1.2 and this device ip address should be 192.168.1.3, here all these 3 ip address are in same network.

In Subnet Mask enter 255.255.255.0

In Gateway enter 0.0.0.0

In DNS enter 0.0.0.0

In TCP Comm. Port or Port leave it to default of your device port number or if it is blank then enter 4370

Keep DHCP OFF

At this point we have completed networking setting in device.

img

Now we will add a user (student) entry and map it to Smart School student Admission Number.

At Main Menu screen go to User Mgt. (User Management) area

img

Then go to New User

img

At New User screen while you are creating new user, in User Id enter student Admission Number which should be exact same as your Smart School student Admission Number.

In rest of fields like Name enter appropriate details for the user. In same way add other student users.

img

img

Step 2 - Smart School version 5.2.0 up and running

Initially your Smart School version 5.2.0 should be up and running and must be registered with your Envato Market Purchase Code. There should be some students admitted for adding attendance. If you have yet not installed Smart School then check Smart School documentation in Smart School downloaded package. Here in this documentation we assume Smart School version 5.2.0 is installed at base_url https://demo.smart-school.in/

img

Step 3 - Smart School version 5.2.0 configuration for your biometric devices

Login to you Smart School through superadmin and go to System Settings > General Setting page. Here go to Attendance Type setting. As Smart School Biometric Attendance App currently supports only Day Wise attendance so select for Day Wise attendance then select Biometric Attendance to Enable then in Devices input box enter your biometric device Serial Number. Biometric device Serial Number can be found in your device System Info area which we have already note down in Step 1 - Biometric Device Configuration. If you are using multiple devices then enter device Serial Numbers separated by comma (,) and finally Save general setting.

img

Step 4 - Smart School Biometric Attendance App Installation

Smart School Biometric Attendance App is majorly built on Python language so to use Smart School Biometric Attendance App you first install Python.

img

In Smart School Biometric Attendance App downloaded package go to Python folder and double click on python-2.7.16.amd64.msi file to start Python installation.

img

Select Install for all users and click on Next button.

img

Let the installer to install Python in default location and click on Next button.

img

At this window scroll down to see last option Add python.exe to Path.

img

Click on Add python.exe to Path option to select Entire feature will be installed on local hard drive.

img

Now click on Next button to start installation process.

img

After successful installation you will see Finish button. Now click on Finish button to exit Installer.

Note: it is strongly recommended to restart your computer after clicking Finish button, perhaps after clicking Finish button Python installer will automatically ask for restarting your computer but if it will not ask then must restart your computer yourself.

img

After restarting your computer first we will check for Python has been installed and configured properly. For this open Run window by using keyboard short cut Winkey + r . At Run window enter cmd then click OK button to open Windows Command Prompt.

img

Now at Windows Command Prompt type python and hit enter, now if you can see Python current version message as mentioned in above picture that means Python has been installed and configured properly. Now type exit() and hit enter to exit Python and return back to Windows Command Prompt.

img

Now copy Smart School Biometric Attendance App folder from your downloaded package in your computer c drive and open this Smart School Biometric Attendance App folder here you will see setup.py file. We have to execute this setup.py file to install Smart School Biometric Attendance App dependency in computer. For this in Windows Command Prompt type cd c:\Smart School Biometric Attendance App then hit enter and then type python setup.py install and hit enter. After this Python will download Smart School Biometric Attendance App dependency and install Smart School Biometric Attendance App in your computer.

img

After successful installation you will see message something like above picture.

img

Now we will double click on SS Biometric Attendance App.exe file to open Smart School Biometric Attendance App.

img

After few seconds of loading you will see Smart School Biometric Attendance App has been started.

Step 5 - Smart School Biometric Attendance App Configuration

Smart School Biometric Attendance App configuration is pretty simple. First we will register our Smart School base_url, then we will add our biometric device, then start device, then further will start taking attendance through device.

img

Click on Register Site button to enter your Smart School base_url where you want to send captured attendance data. Here in our case it is https://demo.smart-school.in/ (please don't forget to add trailing / in base_url otherwise you will face issues).

img

Click on Submit button to register your Smart School base_url.

img

Now enter your biometric device Ip Address, Port Number and Serial Number configured in Step - 1, then click on Add Device button.

img

Device has been added now.

img

Click on added device to select device.

img

Then click on Start Device button to start device for sending data. At this point our all setup, configuration is completed and our device has been started to take student attendance. Just add any registered student fingerprint to test and send attendance data. When Smart School Biometric Attendance App captures and send attendance data a confirmation popup window will flash. If student has punched their finger attendance multiple time frequently or in a days but still Smart School Biometric Attendance App will send only first time captured attendance data then further repeated attempts will be ignored.

img

Repeat same procedure to add and start more biometric devices if you have.

img

To stop device click on device to select device then click on Stop Server button. To remove a device just click on device to select device then click on Remove Device button. To remove device, device should be stopped.

img

After taking attendance you should stop device and close Smart School Biometric Attendance App.

img

Further everyday when you want start taking biometric attendance you should double click on SS Biometric Attendance App.exe to start Smart School Biometric Attendance App and start your already added device. To avoid every time going to Smart School Biometric Attendance App folder just create a shortcut of SS Biometric Attendance App.exe and send it to desktop. So next time you can start Smart School Biometric Attendance App directly from desktop shortcut.

Every student whose attendance has been submitted through Smart School Biometric Attendance App will be directly marked as Present in Smart School so there is no need to do anything for their attendance. But after finishing attendance submission time you should go to your Smart School Admin Panel > Attendance > Student Attendance > Select Class - Section - Attendance Date then click on Search button to see Present and Absent student of that day. Here you will see those students have submitted their attendance though Smart School Biometric Attendance App was marked as Present with their punching time. Now click on Save button to submit Absent students attendance and send Absent notification.

If you need help for installation and configuration, do not hesitate to open Support Ticket

Smart School Biometric Attendance App Changelog for version 1.0


Version 1.0

Released Date: 21 April, 2020

We are happy to announce the first version release.

Free Help & Support


All of our items come with free support, and we have a Dedicated Support Ticket System to handle your requests. Support is limited to questions regarding the code features, bugs or problems with the application. We are not able to provide support for code customizations or third-party plugins. If you need help with anything other than minor customizations of your code then you should enlist the help of a developer or our customization service.

Go to Support Portal

Thank you once again for the purchase!


Once again, thank you to trust on Smart School Biometric Attendance App. We will be glad to help you if you have any questions relating to this application.

QDOCS Team