广州同鑫HR考勤系统二次开发注意记录

1、2010.11.041. C#.net 和 VB.net 的采集数据请使用BatchReadRecordEx 2010.11.161. 修正了读名单函数ReadDeviceListCard 返回false的bug.2. 增加了读名单的例子。2010.11.171. 有关主动上传的说明主动上传的流程如下：1.1首先使用接口软件设置考勤机远程IP，启动主动上传。如下图:强调，考勤机的网关必须要设置正确。1.2开发的程序如下：定义三个回调函数1.2.1 首先弓 I用 Eastriver.pas/ 主动上传，设备登录的回调函数procedureOnDeviceLogin(Dev_id:integer;

2、Serial:TSerialType;ip:PChar;port:integer;var Heartbeat/nteger);/Dev_id:机号/Serial:序列号/ip:考勤机私网或公网IP/po rt:考勤机私网或公网端口/ var Heartbeat:心跳时间间隔。(单位秒)/主动上传，状态更新procedure On RefreshDeviceStateBySerial(Dev_id: i nteger;Serial:TSerialType; State: i nteger; RecordCou nt:in teger);/Dev_id:机号/Serial:序列号/State:状态

3、值。0 ,脱机，1,联机/RecordCount: 总共的记录数/ 主动上传，有记录的回调procedure OnRecieveBatchRecordBySerial（Dev_id: integer;Serial:TSerialType;index:integer;RecordCount:integer;Records: DeviceDataArray;var bReturnOK:boolean）;/Dev_id: 机号/Serial: 序列号/ index: 记录序号/RecordCount: 本次上次的记录数/Records ： 记录数组， 最大 16 条记录。真实数量由 RecordCo

4、unt 确定。 /bReturnOK 是否确认该批记录， 确认就删除，否则，设置在 2-3 秒后重传。1.2.2 流程首先 ，调用 eastriver.StartUpLoad （远程端口） 监听某个端口 调用 eastriver.SetUpLoadProc（OnDeviceLogin,OnRefreshDeviceStateBySerial,OnRecieveBatchRecordBySerial）; 设 置回调函数。然后，考勤机启动后，会主动向 远程端口发送数据。首先 触发 OnDeviceLogin ，登录 然后，按回调的心跳时间， 发送心跳。 （心跳时间一般推荐，局域网10秒以上，广域网

5、 30 秒以上 ）采集线程，每两秒，返回每个考勤机的状态回调 OnRefreshDeviceStateBySerial 。通知，考勤机的状态处于脱机还 是联机。如果有数据，考勤机将以每 3 秒的频率 调用 OnRecieveBatchRecordBySerial 上传数据。其中， index: 记录序号 和 Serial: 序列号 是记录的主要标识， index 从 0-255 循环。 同一时间内， 收 到重复的 index 和 Serial ，说明该记录是重发的。最后，调用 eastriver.StopUpLoad; 停止主动上传的监听。2010.11.241. 新增 3 个用于字符串输出的

6、采集函数。/采集函数以文本形式输出（每次最多取16条记录，缓冲区建议2048 ）仅为VB , C#兼容BatchReadRecordAsString ，/顺序采集数据，不删除方式，以文本形式输出（每次最多取16条记录，缓冲区建议 2048 ）仅为VB ， C#兼容BatchReadRecordNotDelAsString ，/读已删除记录（4G），以文本形式输出（每次最多取16条记录，缓冲区建议 2048 ）仅为VB ， C#兼容BatchReadDelRecordAsString ，2. 新增函数按编号读取记录/不删除采集记录 （4G）BatchReadRecordNotDel2010.12

7、.141. 新增函数 QuickOldCallClock 和 QuickCallClock, 用于替换 981, 880.890 的 CallCall 经测试 ，981 调用 QuickCallClock 联机 只需 0.031 秒 . 使用该函数需注意，在 QuickCallClock 返回 False 的时候，请调用 UnCallClock 再 QuickCallClock 。其中 UnCallClock 耗时 1 秒。注意。2010.12.151. 修正长时间调用 ReadLastCard 会提示内存出错的 Bug.2010.12.29 1.01.410.131修正在转换器中485通讯不正常的情况。经测试支持的转换器有PCI转COM , USB转COM , TCP转COM.2011.01.111.01.410.141 .原采集函数中，工号返回值长度为 16。现改为实际长度(下名单时的长度) 。2. 修正了消费机机号为 10时，不能联机的问题。2011.01.111.01.410.151. 用户 不需要 调用 SetCmdVerty(true). 调用 GetClockModel 后， 动 态库会 根据设 备类 型， 而 自动调 用 SetCmdVerty(false).2011.01.18 1.01.410.161.