用友U8+HR考勤管理考勤机客户化开发手册

用友U8HR考勤治理_考勤机数据采集API使用手册U8+HR_考勤机数据采集API使用手册用友软件股份第1页/共16页用友U8HR考勤治理_考勤机数据采集API使用手册\l“_TOC_250023“简述 3\l“_TOC_250022“二 API主要功能 4\l“_TOC_250021“1 功能： 4\l“_TOC_250020“支持版本： 4\l“_TOC_250019“公开方法 4\l“_TOC_250018“Init方法 4\l“_TOC_250017“ExecCardImport方法 5\l“_TOC_250016“三 API演示包使用说明：如以以下图 5\l“_TOC_250015“四例如程序界面 6\l“_TOC_250014“VB独立运行EXE程序界6\l“_TOC_250013“U8集成门户VB程序界面 7\l“_TOC_250012“U8集成门户NET程序界面 8\l“_TOC_250011“演示步骤： 9\l“_TOC_250010“五例如代码使用说明 9\l“_TOC_250009“假设直接使用U8门户登录，可跳过ADO数据源设置； 10\l“_TOC_250008“ADO数据源设置方法： 10\l“_TOC_250007“数据来源的设置 12\l“_TOC_250006“考勤物理表： 12\l“_TOC_250005“调用存储过程： 12\l“_TOC_250004“使用DOM对象： 12\l“_TOC_250003“初始化API 13\l“_TOC_250002“加载刷卡数14\l“_TOC_250001“导入刷卡数15\l“_TOC_250000“六附录 16第2页/共16页用友U8HR考勤治理_考勤机数据采集API使用手册简述人员考勤数据作为考勤治理系统中最为核心、最为根底的数据来源；考勤数据采集是支撑考勤系统正常运行的重要环节。我们结合大量用户的成功应用案例，针对目前市面常用的机型，通过与考勤机厂商业务接洽与合作以及客开伙伴的沟通与反响，推出根底API接口方式的考勤数据集成处理模式，具有格外好的开放性，采集设备的低偶合〔不依靠硬件设备〕，供给VB/DotNet例如程序与实例，可实现U8接下来，通过框图来让大家了解一下如何将考勤机与U8系统集成：指纹考勤机1指纹考勤机2ID考勤机1

ID考勤机2

U8应用效劳器

U8数据库效劳器考勤机治理员客户化开发流程：

U8客户端 U8WEB效劳器考勤机与U8系统集成框图考勤机考勤机API客开流程阶段备设勤考开头包，可与硬件厂商联系或从厂商官网下载发包1、设备连接与识别方法2、获得机内数据的方法3、删除机内数据的方法数据数据库直连考勤机相关参数获得数据组织直连数据库序程独单程序DEMO成集统系配置Machine.xml直连考勤机例如TMZKFNew.vbpDEMO8UAAPI初始化API考勤数据导入完毕第3页/共16页API类图：

用友U8HR考勤治理_考勤机数据采集API使用手册TMMachineimportAPI::clsImportAPI+Init(inoLogin:Object,inDBConnStr:string)+ExecCardImport(inCardData:object,inoutErrStr:String,inoutbsuc:Boolean,inoutiErrCount:Long,inImportDataTime:String,in二API功能：通过API接口实现直接考勤机或其它第三方考勤机的考勤数据导入U8考勤，可支持多〔记录到指定名目下了解导入状况后后续处理。支持版本：集成至U8V11.1，U8V10.1以及U8V11.0需更考勤最补丁公开方法Init方法功能描述：完成API接口的初始化参数说明：参数名称类型入/出/返说明oLoginU8Login.clsLogin入默认，U8登录对象DBConnStrString入可选，数据库连接串[Return]Boolean返返回True成功,False失败调用说明：传入oLogin对象或DBConnStroLogin对象用于实现U8可实现在U8系统增加相关的导入程序界面〔如导入向导DBConnStr用于外挂程序实现导入数据。第4页/共16页ExecCardImport方法

用友U8HR考勤治理_考勤机数据采集API使用手册功能描述：完成通过API导入外部考勤机数据，处理导入出错日志，返回出错记录条数参数说明：参数名称类型入/出/返说明CardDataObject(Recordset/DataSet入RecordSet(可以前级将DataSet或DataTable)ErrStrString入/出出错信息bSucBoolean入/出成功标志True成功，False失败iErrCountLong入/出ImportDataTimeString入错日志文件名拼装sMachineNOString入1三API演示包使用说明：如以以下图先将此包解压至U8安装名目下TM名目下，具体名目说明：Data\odom.xml演示数据DOM，可修改内容DemoCodeTM_importAPI_DEMO_NETUFIDA.U8.HR.TM.importAPI.DEMO.slnC#例如TM_importAPI_DEMO_VBTM_ImportAPI_DEMO_EXE.vbpVB独立EXE例如TM_importAPI_DEMO_VBTM_ImportAPI_DEMO.vbpVBU8门户集成例如Help为考勤机实施与客开手册ScriptTM_APIDEMO_Menu_Auth_IDT_8111.sql请在UFSYSTEMU8门户集成第5页/共16页例如，如独立EXE方式不需运行脚本

用友U8HR考勤治理_考勤机数据采集API使用手册TM_ImportAPI_DEMO.dllU8门户集成例如主程序，请使用Regsvr32.exe注册TM_ImportAPI_Demo_EXE.exeVB独立EXE例如程序，不需Regsvr32.exe注册UFIDA.U8.HR.TM.importAPI.DEMO.dllC#DotNet主程序，不需注册UFIDA.U8.HR.TM.importAPIProxy.dllC#DotNet代理效劳主程序，不需注册演示说明.txt请先阅读此文件四例如程序界面VBEXE程序界面运行TM名目下TM_ImportAPI_Demo_EXE.exVB正常使用，本例默认的账套是U8V11.0演示账套第6页/共16页U8HR考勤治理_考勤机数据采集API使用手册U8VB程序界面首先登录U8，在菜单[人力资源][考勤治理][刷卡数据][考勤数据导入API演示]下，点击[考勤数据导入API演示VB]，如以以下图运行后界面：第7页/共16页用友U8HR考勤治理_考勤机数据采集API使用手册初始化API参数，可通过U8门户登录对象也可通过ADO数据源〔需先设置好相关参数3方考勤机治理程序的物理表DOM对象取得U8NET程序界面首先登录U8，在菜单[人力资源][考勤治理][刷卡数据][API演示]下，点击[考勤数据导入API演示.NET]，运行后如下界面第8页/共16页用友U8HR考勤治理_考勤机数据采集API使用手册数据加载类型可支持DataTable或Recordset两种演示步骤：首先点击[初始化]按钮，初始化成功后，再点击[加载数据]按钮，加载成功后，再点击[导入刷卡数据]进展模拟数据的导入。说明：请先预备好对应的数据。五例如代码使用说明例如代码我们用VB门户集成版为例给大家作个讲解：首先，使用VB翻开U8安装名目U8SoftTMTM_importAPI_DEMO_VBTM_ImportAPI_DEMO.vbp如以以下图：第9页/共16页用友U8HR考勤治理_考勤机数据采集API使用手册U8ADO数据源设置；ADO数据源设置方法：先在窗体视图选择Adodc_CommConnectionStringConnectionString；生成连接字符串，选择数据连接类型，设置数据库效劳器，设置登录账套模式，选择对应的U8账套库，最终测试连接。如以以下图：第10页/16页用友U8HR考勤治理_考勤机数据采集API使用手册第11页/16页用友U8HR考勤治理_考勤机数据采集API使用手册数据来源的设置本例如中，支持以下数据来源：考勤物理表：适用于已通过考勤机治理程序猎取数据的状况；这里直接修改相关的表名与字段名为所需支持的考勤机治理程序的对应考勤记录表与字段就可以了。假设存在跨库取数可将修改表前缀。可参见以以下图修改代码：搜寻“1”调用存储过程：也适用于已通过考勤机治理程序猎取数据的状况；这里请自行设计相关的取数规律，修改对应存储过程名以及参数；可参见以以下图修改代码：搜寻“2”DOM对象：DOMData\odom.xml中提取数据导入，一般不会使用，仅供参考。这里请修改oDom.xml中的相关数据，如以以下图第12页/16页用友U8HR