Timeclock Employee Id Interface

Issue/Symptom/Question

How are employee identifiers that are used for the timeclock interfaced into PENTA?

Applies To

Timeclock

Employee Timeclock Identifier

Resolution/Fix/Answer

The PENTA Interface for Timeclock Id can be used:

The new table for table driven interfaces is INTR_HR_TIMECLKID


INTR_RQST_IDRequiredNOT NULLVARCHAR2(13)
SEQ_NUMRequiredNOT NULLNUMBER(10)
EMP_ID

Required

NOT NULLNUMBER(3)
ACTIVITY_CDRequiredNOT NULLVARCHAR2(1)
TIMECLK_EMP_ID_TYPE_CDRequiredNOT NULLVARCHAR2(3)
LONG_KEYRequired - must be UniqueNOT NULLVARCHAR2(2000)
DESCR_2000Optional
VARCHAR2(2000)


The Pipe delimited flat file record looks like this:
[emp_id]|TIMECLKID|[activity_cd]|[timeclk_emp_id_type_cd]|[long_key(the ID)]|[descr_2000]|


Activity code behavior is standard for the employee interface:


  • (A)dd
  • (U)pdate, or add if record doesn't exist
  • (C)hange
  • (D)elete


The ID type must be one of the values in TIMECLK_EMP_ID_TYPE table.

TIMECLK_EMP_ID_TYPE_CD:
PIN PIN
QRC QR Code
BIO Biometric Scan

  • An employee can only have one key(ID) of each type.
  • Type/key combinations must be unique across all employees, but the same key can be used for different types.
  • Employee ID + Type is the key that is used when looking for a record to update or delete. Key and description are ignored when deleting.
  • The key is free form and required.
  • The description is free form and optional.
  • The key is not encrypted.

The resulting records after the interface completes are maintained in TIMECLK_EMP_ID

 Pipe Delimited Example for QR Code and PIN for an employee:

123|TIMECLKID|U|QRC|1234567890|QR Code for Emp 123| or if no description 123|TIMECLKID|U|QRC|1234567890||

123|TIMECLKID|U|PIN|123456|PIN Code for Emp 123|

NOTE: With the requirement that the PIN and QRC being unique, do not include the record in the file unless loading a unique code.  Including the record with a blank or null code will cause an error in the interface because blank or null is not unique.