中控考勤机接口文档.docx

一．接口说明：
本接口用于将中控考勤机的打卡数据定时上传至金蝶K3的原始打卡数据表（HR_ATS_OriginalityCard）中，避免人工导入的动作。

二．接口条件：
1.服务器要装office access 2010版本以上;
2.要安装中控的“考勤管理系统”（如图），且该客户端要支持“定时下载记录”
3.要有SQL server;

三．接口原理：
1.中控客户端定时下载记录到att2000.mdb；
2.我们在SQL数据库中创建一个视图A来实时抓取att2000.mdb中表CHECKINOUT的卡号和打卡时间；
3.然后再创建一个视图B获取视图A中最近一个月的数据；
4.最后再创建一个SQL执行计划，将视图B中的数据插入到K3的表HR_ATS_OriginalityCard中

四．注意事项：
1.本接口要注意中控客户端的定时下载时间和SQL执行计划的时间这两个时间的先后顺序，SQL代理作业的执行时间要在中控客户端下载记录时间之后几分钟；
2.一般来讲，如果att2000文件中有打卡记录，则金蝶K3的HR_ATS_OriginalityCard表中一定可以取到打卡记录，如果K3中没有打卡记录，请先检查att2000.mdb数据库中的CHECKINOUT表中有没有相应记录。
3.下述具体步骤是制作该接口的过程，如非更换服务器或其他损坏等原因，则下面几步无需再做，仅供了解原理。

五．具体步骤：
1. 在中控客户端里可以查看它的数据文件位置（如图att2000.mdb），记下此文件路径，att2000.mdb中有一个表“CHECKINOUT”存放着打卡数据

表checkinout

2. 中控客户端设置定时下载，打开中控客户端，在上方工具栏“维护/设置”——“系统设置”，打开后进入“监控设置”，设置指定时间段连接设备，设置“定时下载记录时间”

3. 进入SQL，选择K3HR帐套的数据库（在帐套管理可知道数据库名称），新建查询，然后执行语句，开启SQL的辅助功能
EXEC sp_configure 'show advanced options', 1
GO
-- To update the currently configured value for advanced options.
RECONFIGURE
GO
-- To enable the feature.
EXEC sp_configure 'xp_cmdshell', 1
GO
-- To update the currently configured value for this feature.
RECONFIGURE
GO

EXEC sp_configure 'Ad Hoc Distributed Queries' ,1
RECONFIGURE
GO

4. sql代码读取ACCESEE，创建视图hr_ats_CardData

CREATE view [dbo].[hr_ats_CardData] as
SELECT * FROM OpenRowSet('Microsoft.ACE.OLEDB.12.0',';database=D:\data\2000.mdb','select badgenumber as 卡号 ,checktime as 打卡时间 from checkinout a inner join userinfo b on a.userid=b.userid ')

GO

5. 如果需要过滤时间范围,创建新的视图(这里取最近30天的记录)
CREATE view [dbo].[hr_ats_CardData1] as
SELECT * FROM hr_ats_CardData
where 打卡时间>DATEADD(day,-30,getdate())

6. 创建数据库作业，在作业步骤中代码如下
insert into HR_ATS_OriginalityCard (FCardID,FCardDateTime,FEmpID)
select a.*,b.EM_ID from dbo.hr_ats_CardData1 a
inner join v_HR_ATS_Employee b on a.卡号=b.FCardID
where not exists
(select * from HR_ATS_OriginalityCard where FCardID=a.卡号 and FCardDateTime=a.打卡时间)

在计划中则定义执行频率等计划