This page (revision-22) was last changed on 26-Nov-2021 10:22 by lurtan

This page was created on 26-Nov-2021 10:22 by jmyers

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
22 26-Nov-2021 10:22 14 KB lurtan to previous
21 26-Nov-2021 10:22 14 KB rforbes to previous | to last

Page References

Incoming links Outgoing links

Version management

Difference between version and

At line 36 changed one line
*There are 4 main pieces of software that are required to be loaded and maintained on the clocks.
*There are four main pieces of software that are required to be loaded and maintained on the clocks.
At line 40 changed one line
**High Line Provided
**System Provided
At line 44 changed 2 lines
*The Load all four pieces of software is preformed via TFTP communication.
TFTP [-i] host [GET | PUT] source [destination]
*Loading all four pieces of software is preformed via TFTP communication.:\\{{tftp -i <ipaddress> PUT App.jar \flashdisk\App.jar}}
At line 62 changed 3 lines
%%information These setting are adjusting features of the bio and Mifare readers which are NOT provided by High Line. These are features of the hardware and when changing these values to something different than provided in the config file CMI support should be consulted.%%
*Delay times for displaying messages(MSG_TIME), clock idle time (time when no key strokes have been recorded)(IDLE_TIMEOUT) and function completion time before returning to the idle screen (DELAY_TIME) may be set in milliseconds to ensure users have time to read the information on the clock screens.
*Data server communication does have an attribute however ONLY HTTP request types are currently supported. (DATA_SERVER_TYPE)
%%information These setting are adjusting features of the bio and Mifare readers which are NOT provided. These are features of the hardware and when changing these values to something different than provided in the config file, CMI support should be consulted.%%
*Delay times for displaying messages(MSG_TIME), clock idle time (time when no key strokes have been recorded)(IDLE_TIMEOUT) and function completion time before returning to the idle screen (DELAY_TIME) may be set in milliseconds to ensure users have time to read the information on the clock screens.
*Data server communication does have an attribute however only HTTP request types are currently supported. (DATA_SERVER_TYPE)
At line 67 changed one line
*For clock functionality please refer to the provided xls story boards giving screen illustrations and available keys. The functionality described below is as it pertains to the G2 application and is common to the G1. Functionality not available in the G1 will be identified.
*The functionality described below is as it pertains to the G2 application and is common to the G1. Functionality not available in the G1 will be identified.
At line 71 changed 4 lines
*The idle screen is the screen which all clocks revert back to when waiting for a user to punch. This screen may include such information as a main title(TITLE), welcome message (WELCOME_MESSAGE), punch IN and OUT(*) prompts(*), verification prompt(*), Software Version(G2 only), time stamp including date and time.
(*) - Located on function buttons only on the G1: F1-Punch IN, F2-Punch OUT F3-verify, F4-Enroll(**), F5-remove print(if applicable to clock reader) (**), F6-Edit punch(**), F11 - Turn Debug on and off, F12-Memory Capacity Test /Current queue size.
*The G2 provides access to the administrators screen and functions using the F1 key(**).
(**) -These functions are restricted and requires an administrator to enter the admin pass code defined in the configuration file (PASSCODE) before access is granted.
*The idle screen is the screen which all clocks revert back to when waiting for a user to punch. This screen may include such information as a main title(TITLE), welcome message (WELCOME_MESSAGE), punch IN and OUT(*) prompts(*), verification prompt(*), software version(G2 only), time stamp including date and time.\\(*) - Located on function buttons only on the G1: F1-Punch IN, F2-Punch OUT F3-verify, F4-Enroll(**), F5-remove print(if applicable to clock reader) (**), F6-Edit punch(**), F11 - Turn Debug on and off, F12-Memory Capacity Test /Current queue size.
*The G2 provides access to the administrator's screen and functions using the F1 key(**).\\(**) -These functions are restricted and requires an administrator to enter the admin pass code defined in the configuration file (PASSCODE) before access is granted.
At line 78 changed 5 lines
*A user may then be requested to enter a valid cost center code if defined in the configuration file (ENTER_COST_CENTER). The entered code is validated against a list provided in the configuration file (VALID_COST_CENTERS). An error sound and light will tell the user of an invalid entry and the punch attempt is stopped. If a valid cost center code is entered the user will then be allowed to continue the punch.
*The user will be asked to identify themselves using the reader built into the clock being used. If permitted (ALLOW_KEYING ) a prompt stating a badge code may be entered manually to identify the employee will be displayed. If this is set to false. All keying for all employees will be removed. If using a biometric reader some employees may be unable to record a bio template successfully; If that is the case the administrator may define specific employees who are allowed to key their badge. ( VALID_KEYED_VALUES a comma separated list of badge numbers). All Badge values will be validated for minimum and maximum length. ( MIN_BADGE_LEN, MAX_BADGE_LEN)
*When an employee badge is keyed or if badge validation is required ( VALIDATE_PUNCHES ) the entered badge will be sent immediately to the server. An active employment will be searched for using either the person code or the clock card code as defined by (USE_BADGE) .
*Employees may be requested to punch into a specific job. (ENTER_JOB) When this is true the information collected identifying the employee is sent immediately to the server for validation and a list of jobs the employee may clock into is returned to the clock. If the employee has only one assignment the punch will be recorded and the clock will declare a successful punch recorded.
*If validation is not required the punch details will be stored into clock memory (the queue) for speed to allow the next user to punch. All details collected within the defined (QUEUE_SLEEP_TIME) are sent to the server. Once the details are stored in the queue a successful completion message is given and the clock is reset back to the welcome screen for the next user.
*A user may then be requested to enter a valid cost center code if defined in the configuration file (ENTER_COST_CENTER). The entered code is validated against a list provided in the configuration file (VALID_COST_CENTERS). An error sound and light will tell the user of an invalid entry and the punch attempt is stopped. If a valid cost center code is entered, the user will then be allowed to continue the punch.
*The user will be asked to identify themselves using the reader built into the clock being used. If permitted (ALLOW_KEYING), a prompt will be displayed, stating a badge code may be entered manually to identify the employee. If this is set to 'False', all keying for all employees will be removed. If using a biometric reader, some employees may be unable to record a bio template successfully. If that is the case, the administrator may define specific employees who are allowed to key their badge. (VALID_KEYED_VALUES a comma separated list of badge numbers). All badge values will be validated for minimum and maximum length. (MIN_BADGE_LEN, MAX_BADGE_LEN)
*When an employee badge is keyed or if badge validation is required (VALIDATE_PUNCHES), the entered badge will be sent immediately to the server. An active employment will be searched for using either the person code or the clock card code as defined by (USE_BADGE) .
*Employees may be requested to punch into a specific job (ENTER_JOB). When this is true, the information collected identifying the employee is sent immediately to the server for validation and a list of jobs the employee may clock into is returned to the clock. If the employee has only one assignment, the punch will be recorded and the clock will declare a successful punch recorded. The number of jobs an employee can punch into the G2 clock is limited to 8 (as there are 8 selection buttons).
*If validation is not required, the punch details will be stored into clock memory (the queue) for speed to allow the next user to punch. All details collected within the defined (QUEUE_SLEEP_TIME) are sent to the server. Once the details are stored in the queue a successful completion message is given and the clock is reset back to the welcome screen for the next user.
At line 85 changed 3 lines
*The Idle screen has a function button dedicated to initiate the employee verification. When pressed the user is given two choices. One to verify using the reader or to enter the employee number.
%%information: The employee number will be either the eP "Person code" (defined in IEID) or the employees defined "clock card code" (defined in ITCC). This is important to know depending on the reader type being used. The clock card code may only be a numeric value since both clocks (G1 and G2) only support numeric keying. The USE_BADGE in the configuration file defines this; A true value will validate against the HR IEID record. A false value will validate against the ITCC record.%%
*Validation using the reader will verify the badge number ( Please refer to USE_BADGE attribute. ) on the server. Biometric readers will verify that biometric templates exist in the clock memory first then check the server for validation.
*The Idle screen has a function button dedicated to initiate the employee verification. When pressed, the user is given two choices. One to verify using the reader and the other to enter the employee number.
%%information The employee number will be either the "Person code" (defined in [IEID]) or the employees defined "clock card code" (defined in [ITCC]). This is important to know depending on the reader type being used. The clock card code may only be a numeric value since both clocks (G1 and G2) only support numeric keying. The USE_BADGE in the configuration file defines this, a true value will validate against the HR IEID record. A false value will validate against the ITCC record.%%
*Validation using the reader will verify the badge number (Please refer to USE_BADGE attribute.) on the server. Biometric readers will verify that biometric templates exist in the clock memory first then check the server for validation.
At line 97 changed 2 lines
*The enroll key is used to capture two finger print bio scans referred to as templates and record them into the clock memory. An option to store the print templates on the server is provided in the configuration file (STORE_BIO). If this attribute is false two templates will be stored on the clock only; If true two templates will be stored on both the clock being used and in the database which the web server points to.
*The template may be verified it was stored correctly by viewing the ITCC effective record for the badge the templates were enrolled with.
*The enroll key is used to capture two finger print bio scans referred to as templates and record them into the clock memory. An option to store the print templates on the server is provided in the configuration file (STORE_BIO). If this attribute is false, two templates will be stored on the clock only. The true two templates will be stored on both the clock being used and in the database which the web server points to.
*The template may be verified that it was stored correctly by viewing the ITCC effective record for the badge the templates were enrolled with.
At line 101 changed one line
%%information:If the config file is defined to use badge "true" the ITCC clock card code must match the person code and the administrator must use the person code as the badge number when enrolling the employee at the clock. The reason for this is that validation will be looking to the HR identity record using the entered badge and looking for a person code. Since the templates are stored in ITCC the clock card code must match in order to store the templates.%%
%%information If the config file is defined to use the "True" badge, the ITCC clock card code must match the person code and the administrator must use the person code as the badge number when enrolling the employee at the clock. The reason for this is that validation will be looking to the HR identity record using the entered badge and looking for a person code. Since the templates are stored in ITCC, the clock card code must match in order to store the templates.%%
At line 104 changed 2 lines
*When remove is selected the administrator will be provided with two options. The first is to remove a single employee and prompted for a badge number ( Reminder: This may be either a clock card code or person code depending what was used to enroll the employee and what the config file has defined with USE_BADGE. ) . The templates associated to that badge number will be removed from memory on that clock only. If prints were stored on the server they will remain.
*The second option is to remove ALL templates stored on that clock only. This feature is provided for testing purposes and not recommended for a live clock. The admin will be prompted to enter 10 "9"'s in a row for confirmation before this is executed.
*When 'Remove' is selected, the administrator will be provided with two options. The first is to remove a single employee and prompted for a badge number (Reminder: This may be either a clock card code or person code depending what was used to enroll the employee and what the config file has defined with USE_BADGE.). The templates associated to that badge number will be removed from memory on that clock only. If prints were stored on the server they will remain.
*The second option is to remove ALL templates stored on that clock only. This feature is provided for testing purposes and not recommended for a live clock. The admin will be prompted to enter ten "9's" in a row for confirmation before this is executed.
At line 111 changed 4 lines
*This feature is useful in tuning the clock depending on the use.
Example: If the clock generally has 50 > employees punching IN/OUT at a time the clock may encounter a high volume of stored punches. In the field, memory could potentially be filled up if a network or database was not available.
This test will identify to the admin the maximum number of punches before it must shut down and wait for communication to upload. A sample punch will be requested in order to use the correct amount of memory for each punch. The clock will then queue as many punches the clock will successfully record. That number will be made available to the administrator.
*This feature is useful in tuning the clock depending on the use.\\ \\Example: If the clock generally has more than 50 employees punching IN/OUT at a time the clock may encounter a high volume of stored punches. In the field, memory could potentially be filled up if a network or database was not available.\\ \\This test will identify to the administrator the maximum number of punches before it must shut down and wait for communication to upload. A sample punch will be requested in order to use the correct amount of memory for each punch. The clock will then queue as many punches the clock will successfully record. That number will be made available to the administrator.
At line 116 changed 2 lines
*Once the maximum is found each company may decide the maximum memory capacity is not a business practice they would like to allow each clock to hold in cases of emergency. There are two configuration file attributes available to set a ceiling for stored punches where the clock will stop allowing punches and provide a configurable message to the users that a manager must be notified the clock is full. The second is used once communication comes back on line the clock will begin again down loading queued punches. When the queue size reaches the thaw limit the clock will then become operational and accept punches.
Both attributes are located in the configuration file as QUEUE_LIMIT and THAW_LIMIT. The queue full message is configurable and also in the configuration file as QUEUE_FULL and for the G2 only a second line is provided as QUEUE_FULL2.
*Once the maximum is found each company may decide the maximum memory capacity is not a business practice they would like to allow each clock to hold in cases of emergency. There are two configuration file attributes available to set a ceiling for stored punches where the clock will stop allowing punches and provide a configurable message to the users that a manager must be notified the clock is full. The second is used once communication comes back on line the clock will begin again down loading queued punches. When the queue size reaches the thaw limit, the clock will then become operational and accept punches.\\ \\Both attributes are located in the configuration file as QUEUE_LIMIT and THAW_LIMIT. The queue full message is configurable and in the configuration file as QUEUE_FULL, in addition, for the G2 only, a second line is provided as QUEUE_FULL2.
At line 120 changed one line
*The Administrator is given the ability to clear all punches in the queue. This is generally used for testing purposes. Upon selection the user will be prompted to enter 10 number 9's to confirm the removal of all queued punches.
*The Administrator is given the ability to clear all punches in the queue. This is generally used for testing purposes. Upon selection the user will be prompted to enter ten number 9's to confirm the removal of all queued punches.
At line 123 changed 5 lines
*This is a feature which runs transparent to users. Administrators may define a time in milliseconds which the clock will ping the server. (PING_SLEEP_TIME)
*Each ping includes the machine name, time, the HL clock software version.
*The ping information is stored in the device information field of ITCD - Define clock devices.
*If the clock device record was made with data in the device information field previous to the initial ping, that data will be appended to at the end. All xml data received will always be the last appended.
%%information: If text is added after the xml it will be lost after the next ping.%%
*This is a feature which runs transparent to users. Administrators may define a time in milliseconds which the clock will ping the server (PING_SLEEP_TIME).
*Each ping includes the machine name, time, the clock software version.
*The ping information is stored in the device information field of Define Clock Devices [ITCD] screen.
*If the clock device record was made with data in the device information field previous to the initial ping, that data will be appended to at the end. All xml data received will always be the last appended.
%%information If text is added after the xml it will be lost after the next ping.%%