Smart Hospital Biometric Attendance App

Attendance automation for your Smart Hospital.
By
img

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


We would like to thank you for purchasing Smart Hospital Biometric Attendance App! We are very pleased you have chosen Smart Hospital 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 Hospital Biometric Attendance App.

If you are unable to find your answer here in our documentation then visit our support article site smart-hospital.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 Hospital Biometric Attendance App!

Help & Support

System Requirements


Smart Hospital 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 Hospital Biometric Attendance App, you must have running latest Smart Hospital (version 5.0 or higher) on your online server with domain or subdomain or ip address. Smart Hospital Biometric Attendance App sends attendance data to your online Smart Hospital so before using Smart Hospital Biometric Attendance App you must configure your Smart Hospital for the biometric devices you will use with Smart Hospital Biometric Attendance App.

To install Smart Hospital Biometric Attendance App, below are the 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 Hospital Biometric Attendance App Installation & Configuration


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

Step 1 - Biometric Device Configuration

Smart Hospital 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 Hospital Biometric Attendance App should be connected with your network Router through LAN wire or Wifi. The computer where you will install Smart Hospital Biometric Attendance App must be internet ready otherwise it will not send attendance data to your Smart Hospital even you have hosted Smart Hospital on your local LAN network.

img

Biometric device configuration consist basically Networking Setting and Staff User records entry. Staff records should be mapped with Smart Hospital staff ID so Smart Hospital Biometric Attendance App can send attendance data to Smart Hospital and mark Present attendance for that staff.

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 Hospital 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 (staff) entry and map it to Smart Hospital staff ID.

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 staff ID which should be exact same as your Smart Hospital staff Id.

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

img

img

Step 2 - Latest Smart Hospital (version 5.0 or higher) up and running

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

img

Step 3 - Smart Hospital configuration for your biometric devices

Login to you Smart Hospital through superadmin and go to Setup > Settings > Attendance Setting page. Here go to Biometric Attendance setting. Now Enable Biometric Attendance 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 Hospital Biometric Attendance App Installation

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

img

In Smart Hospital Biometric Attendance App downloaded package go to Python folder and double click on python-3.11.0-amd64.exe file to start Python installation.

img

Install Python with following options -

  1. Install for all users
  2. Install Python at default location
  3. Add python.exe to Path
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 at Windows Command Prompt type pip install setuptools and hit enter.

img

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

After successful installation there will be some new folders created under Smart Hospital Biometric Attendance App folder.

Step 5 - Smart Hospital Biometric Attendance App Configuration and Running App

Smart Hospital Biometric Attendance App configuration is pretty simple, just we have to enter details in settings.py file.

img

Open settings.py file in any editor and remove following text and enter details related to your Biometric Device and Smart Hospital -

  1. enter your device ip
  2. enter your device port
  3. enter your device serial number
  4. enter your Smart Hospital URL

img

For use single device use above code block

img

For use multiple device use above code block

img

After adding details in settings.py file double click on file run.bat to start Smart Hospital Biometric Attendance App. If everything is correct then Smart Hospital Biometric Attendance App will start listening for biometric attendance. At this point our all setup, configuration is completed and our device has been started to take staff attendance. Just add any registered staff fingerprint to test and send attendance data. When Smart Hospital Biometric Attendance App captures and send attendance data a confirmation popup window will flash. If staff has punched their finger attendance multiple time frequently or in a days but still Smart Hospital Biometric Attendance App will send only first time captured attendance data then further repeated attempts will be ignored. After taking attendance you should close Smart Hospital Biometric Attendance App.

img

Further everyday when you want start taking biometric attendance you should double click on run.bat to start Smart Hospital Biometric Attendance App. To avoid every time going to Smart Hospital Biometric Attendance App folder just create a shortcut of run.bat and send it to desktop. So next time you can start Smart Hospital Biometric Attendance App directly from desktop shortcut.

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

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

Smart Hospital Biometric Attendance App Changelog for version 1.0


Version 1.0

Released Date: 1 September, 2024

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 Hospital Biometric Attendance App. We will be glad to help you if you have any questions relating to this application.

QDOCS Team