中控奥康考勤机接口使用说明书

中控考勤机接口使用说明书指纹考勤机掌握效劳程序使用说明此接口效劳程序适用于中控iClock系列指纹考勤机，指纹算法版本为V10.0适用。如：IClock360，IClock660等。陈本栋2013/12/10112013-12-10中控考勤机接口使用说明书一、 程序文件本接口程序包含三个局部内容，分别是：1SQL脚本文件，“支持脚本”名目下两个文件接口调用验证改到函数里.sql支撑表脚本.sql2、MAS接口文件，“App_Data\Interface\zk.fp”名目下，包含：empCheckFinger.sql 收接到考勤记录后执行的刷卡记录处理脚本getEmpList.sql “数据库到设备操作”界面人员列表查询关联脚本getEmpTmps.sql “数据库到设备操作”界面同步人员查询关联脚本getMacList.sql “设备登记”界面设备列表查询脚本getMacType.sql “设备登记”界面设备类型选项脚本setEmpFinger.sql 从设备传回指纹数据到数据库的处理脚本setMachine.sql “设备登记”界面中保存设备信息的处理脚本svrCmdQueue.sql “掌握效劳”查询操作指令的查询脚本svrCmdResult.sql “掌握效劳”指令执行结果反响脚本svrGetQueue.sql “考勤记录接收效劳”轮询设备信息准时间脚本svrSubsequent.sql “考勤记录接收效劳”考勤记录接收后执行脚本3SDK版本，masZkFpSvc名目：SdksdkAPI文件commpro.dllcomms.dllplce.dllrscagent.dllrscomm.dlltcpcomm.dllusbcomm.dllzkemkeeper.dllzkemsdk.dllregZkemkeeper.bat sdk注册文件absLib.dll 程序库文件employee.sql SQL暂存文件Interop.zkemkeeper.dll sdk引用文件mas86.dll 程序库文件masZkFpSvc.exe 主程序文件〔掌握效劳及接收效劳〕masZkFpSvc.exe.config 主程序配置文件srvInstall.bat NT效劳命令文件srvUnInstall.bat NT注册命令文件二、 安装说明

2013-12-101SQL查询分析器中执行两个需要升级以及支持系统运行的SQL脚本文件。2、将“MASMASApp_Data名目下掩盖，以便在这个名目里添加接口文件。3、将“掌握效劳程序文件”名目复制到效劳器的“C:\ProgramFiles”名目下建一个“peopleone.cn”子名目，完成后名目全称如下：C:\ProgramFiles\peopleone.cn\masZkFpSvc464位系统则在：5、C:\ProgramFiles(x86)\peopleone.cn\masZkFpSvc名目下。6masZkFpSvc名目下，以治理员身份运行其中的：SDKAPI。7masZkFpSvc名目，以治理员身份运行其中的：srvInstall.bat文件，NT效劳。三、 设置说明1、中控考勤机接口程序有两种工作模式，一是界面模式，二是效劳模式。界面模式主要针对治理员使用，用于登记考勤机，对考勤机各项操作进展调试，以及对大批量的考勤机进展初始化操作等。2、进入masZkFpSvc 名目，双击运行masZkFpSvc.exe程序文件，如以下图：2013-12-103、先转到“设置”页MAS效劳地址等设置，如以下图：MASMAS系统的地址，地址后面的文件指向局部是一样的〔“/common/DataProvider.asmx”〕，不用改，前面的地址依据实际安装IE中必需能访问，访问画面如下：改好后点保存，并关闭程序，重翻开后，可以点“测试连接”按钮进展测试，假设返回版本信息，恭喜了，说明设置成功了。4、回到第一个画面“设备登录&初始化”页面。该界面主要是进展考勤机的登记测试和初始化工作。比方对考勤机进展联机测试，数据初始化等的处理。2013-12-10连接好考勤机后就可以进展联机测试了，选择左边的考勤机列表，可以点住鼠标拖拉多项选择，也可以按住[Ctrl]或[Shift]后点鼠标多项选择，然后点联机测试如以下图：本页面只是登记考勤机以及对考勤机进展批量初始化操作所用。本页面的全部功能都在按钮上写着了。5、转到设备到数据库操作页面——该页面有“读取刷卡记录”和“读取指纹记录”两功能，这个功能都是从左边选定的考勤机中直接读取数据。2013-12-102013-12-101010读到数据后可以执行，“保存数据到效劳器”操作，该操作中刷卡记录的保存，MAS接口中的“empCheckFinger.sql”这个脚本进展处理，且当一台考勤机记录处理完毕后将调用“svrSubsequent.sql”脚本进展后续处理；而保存指纹记录时则调用了“setEmpFinger.sql”脚原来处理。〔注：上述，以及后面文档中所说到的接口脚本，均指本文档第一局部“程序文件”的第2条“ MAS接口文件”中所提到的，存在于ＭＡＳ系统的“App_Data\Interface\zk.fp”名目下接口脚本文件。〕其中，A01Fpt表时，不需要做任何调整。而对于刷卡记录的处理，基于各个公司对业务的需求不同可以进展更改。----员工号，刷卡时间，刷卡地点〔IP〕declare@A0188intset@A0188=-1select@A0188=A0188fromA01whereA0190=””{0}””if(@A0188>-1)begininsertintoK07(A0188,K0700,K0701,K0702)select@A0188,convert(varchar(20),cast(””{1}””asdatetime),102),convert(varchar(20),cast(””{1}””asdatetime),8),right(””{2}””,6)比方，标准接口中的脚本内容如下：3个参数——1、员工号考勤机上看到的员工号2120，即：2013-12-1213:573IP地址〔K07K0702字段的宽度〕接收到刷卡记录后直接插入到考勤刷卡记录表〔K07〕中去的。这样做有两个缺点，一是假设考勤记录中的，假设我们需要员工号不存在于系统的A01表中，则该刷卡记录就行丧失；二是每笔记录都去执行员工号与A0188的转换处理以及日期时间的转换处理，将会降底执行效率。所以，实际使用中，我们可以建立一张刷卡记录临时表进展过渡处理和原始记录保存操作，这个可以这样做——创立格式一样的两张表，一张为原始刷卡记录表，另一张为刷卡记录处理临时表，在收到刷卡数据时，只往刷卡记录处理临时表只写，这样收多少写多少，不做多余处理，速度会有很大提升。当收完一个考勤机后，系统用调用svrSubsequent.sql脚本，而在这个脚本中，我们再对接收到的记录进展批处理，第一步，原记录倒入到原始刷卡记录A01K07表插入数据，第三步，删除临时表中的数据记录。SQL中处理，提高效率。以下是这样的解决方案——----建立原始记录保存表Createtablepo_kcard_org(recDatedatetimenotnulldefault(getdate),empCodevarchar(40)notnull,logTimedatetimenotnull,macAddrvarchar(15))--建立记录处理临时表Createtablepo_kcard_tmp(recDatedatetimenotnulldefault(getdate),empCodevarchar(40)notnull,logTimedatetimenotnull,macAddrvarchar(15))第一步，建表——其次步，改刷卡记录接收接口脚本empCheckFinger.sqlsvrSubsequent.sql6、转到数据库到设备操作页面——MAS系统中的人员名单，人员指纹下发到各个考输入参数：考勤机IP记录数declare@MacIPvarchar(15)set@MacIP””{0}””--1、备份原始记录insertintopo_kcard_orgselect*frompo_kcard_tmpwheremacAddr=@MacIP--2、插入到考勤刷卡记录表insertintoK07(A0188,K0700,K0701,K0702)t卡时间，刷卡地点〔P〕es””macAddr””frompo_kcard_tmp,A01whereempCode=A0190andmacAddr=@MacIP--3、删除临时记录deletepo_kcard_tmpwheremacAddr=@MacIP勤机上，也可以处理从各个考勤机中删除指定人员名单的操作。这里是治理员工具，所以对人员名单的查询过滤直接设计为直接写SQL语句的方案，以便支持更加敏捷。如以下图所示——查询语句必需有的字段以字段名称是：empCode,empNmae,empProfile，即员工号〔即下面表格中的“识别名”〕，员工姓名，和员工简介这三个字段。SQL的条件范围可以任凭写。比方上面中的语句是查到全部部门编号在1002下的全部人员，假设我们只要查有指纹记录的人员名单可以在后面加一andandA0188in(selectA0188fromA01Fpt)行条件——变成——从“指纹个数”栏可以看出这个员工在数据库中登记了多枚指纹，假设为0即selectselectA0190empCode,A0101empName,CONTENTempProfilefromA01,DEPTCODEwhereA01.Dept_id=DEPTCODE.Dept_idanddept_codelike”1002%”andA0188in(selectA0188fromA01Fpt)没有登记过指纹。在表格中选择人员列表进展指纹的上传或删除操作，可以用户鼠标点住拖拉方式多项选择，也可以使用按住[Ctrl]点鼠标方式选择，或是按住[Shift]点鼠标方式连续多项选择，或组合使用，还可以按键盘[Ctrl]+[A]全选。按执行上传指纹操作时，假设所选人员的“指纹个数”栏为0，则将只在考勤0则会把全部指纹上传到考勤机上。当员工在分部入职，需要收集其指纹时，可以先下发名单到考勤机上，然后等5点的操作，把指纹收到在数据库中，以便于再下发到其他考勤机上。四、 与MAS无缝接口说明二是效劳模式。现在就来说说其次种效劳模式。1、无缝接口之数据接收支持数据效劳模式接收的接口脚本有三个：svrGetQueue.sql和empCheckFinger.sqlsvrSubsequent.sql。empCheckFinger.sqlsvrSubsequent.sql5点svrGetQueue.sql接口：svrGetQueue.sql接口是效劳对考勤机接收范围的定义，包括要对接收哪几台考勤机进展接收，在什么时间段进展轮询等。下面的脚本文件中的语句说明对selectMacNumber,selectMacNumber,MacIp,MacPort,””00:01””start_time,””23:59””stop_timefrom[RollMachine]024点，即一成天。但这样的设置可能不能在实际工作中使用，由于对考勤机进展数据接收时，考勤时机临时停顿对指纹打卡的响应，这样假设接收操作开头时刚好有人要打卡，则就打不进来了。所以，对考勤记录接收一般安排在没有人操作考勤机时进展，8点半上班，17点半下班，要在早上上班时间后一小时和晚上下班时间后一小时进展两次接收数据，则可以改这个SQL为如下语句——同理，你可以从处延长出其他的分时段方案。selectMacNumber,selectMacNumber,MacIp,MacPort,””09:30””start_time,””10:30””stop_timefrom[RollMachine]unionallselectMacNumber,MacIp,MacPort,””18:30””start_time,””19:30””stop_timefrom[RollMachine]2、无缝接口之考勤机操作对考勤机命令操作支持上节界面中几乎全部功能。该功能通过操作命令队列表〔po_ftOperate〕中的记录，进展对考勤机进展指纹下发，上传，用户登记，删除，设备数据去除等操作。svrCmdQueue.sqlsvrCmdResult.sql。svrCmdQueue是查询队列表中需要处理而还没有处理的命令，其中actdateselectselect*frompo_ftOperatewhereactdateisnull为空则为还没有处理过的记录，所以脚本内容一般如下：svrCmdResult则是处理完每一个命令后，对处理结果进展反响的数据操作：上面的语句说明处理完一个命令后，将这笔记录标志为已处理。这样，这张表,记录号updatepo_ftOperatesetactdate=getdate,actResult=””{0}””whereridin({1})deletepo_ftOperatedeletepo_ftOperatewhereridin({1})将会越来越大，所以在这里我们也可以在处理完的命令后直接删除它：这个功能支撑的表是：po_ftOperate表，该表字段说明如下：[rid]IDENTITY(1,1)命令行号命令作动名称，取值——1、reg登记2、rem移除[action][varchar]3、empty清空4、haul回传单人5、haulall回传整机6、batreg[macid][int]设备编号[macip][int]IP[macport][varchar]通讯端口号[cardno][varchar]员工编号[fingerindex] [int]

指纹序号〔0~9〕1012[empname] [varchar] 员工姓名[template] [text] 文本格式的指纹数据[password][varchar]默认为空[isenable][varchar]默认为：true[actdate][datetime]命令执行时间〔命令反响时回写〕[actResult][varchar]命令执行结果〔命令反响时回写〕简洁的说，就是我们要在考勤机上做什么操作，就向这个表里插一条操作命令。以下是各命令说明例子：命令 用途 SQL例句reg 向考勤机登记单个人 insertintopo_ftOperate([action],macid,macip,macport,cardno,fingerindex,empname,template,的名单或指纹

isenable)select”reg”,1,”18”,”4370”,A0190,fingerindex,A0101,tmpData,”true”fromA01,A01FptwhereA01.A0188=A01Fpt.A0188andA0190=”8888”batreg 向考勤机登记一批人 insertintopo_ftOperate([action],macid,macip,macport,cardno,fingerindex,empname,template,和名单或指纹

isenable)select”batreg”,1,”18”,”4370”,A0190,fingerindex,A0101,tmpData,”true”fromA01,A01Fpt,deptcodewhereA01.A0188=A01Fpt.A01