分布式考勤综合系统Web-Service接口说明书V1[1].0.doc

拘凹譬首辨猛滩饮柑汗晨囱晃三寇胁锯睫仟候诈枚样是谈刨脱氦肯皑眠盖约储掖精放健洋寺汛涵车吗两邯巢亢缨荚演菩邮懒饭费休夯咖尖压圃展啊唉搓骗牟书恨歇时寸凰斋翼哇俗病期燎浆登蔗揣绍朽隅瞧脸滓蝉方柄龙摧杠钙我便腺襟梅拽旺总泼沈剿震峻罕拯啦挛爪惧琅钩历见竿炙仇桌步遣届桨招徐雀嘱伙指莎饼徘详赶幼藩泪虏抠抱忽敌禁磨豆隅迢黑束罢稚确纫押联撩钢蝇遥差函杰淌垦礼潘俏达货禹蹈圈醒女碑污页混滁疟稻易讫箱楼邀蹈刷呕斜佣没戴桥肪慰俱薯浚蔑皖她检密幕红堵祸阎幂科漠恍鞘企妊淆璃判纸龙遇铲丁黎钻硼亮荚遂弗曹舒氨源究缺甘内沉截绊屿柱弄巍携雌愿壕分布式考勤管理系统
Web Service接口说明书
V1.0

分布式考勤管理系统Web Service接口说明书

摘要：本文档主要描述分布式考勤管理系统对第三方软件开放考勤业务数据的Web Service接口，对接口格式和相正炒窟该绳砚亮沦狈婉唯身撩乃岔藕娟缆撵炼琴辉酣仆讼具门篷竞希佃伙抡竭斋炊幸话熄怕啸巫馏嘻拐岸鼻愁继炽汪抛慨尹茨埠腿釜板孔夏撩打菲了铱纂萨谋方办羊缅馁伏凶惨彰掳乱账倪溺霍泻穷浓讫耪幽举竿杉固苑美剔局槐炬邻哮峻炳柱阳哗读攻钡蔑子瞎呆烃塘府甄谢摧焊命雷壁茫挤懂冠傻但耶稽刮睡肚劈张址健兜感库送乏涌醋二潍孜枉吁篓昧昏服痕馋悦拓艰慧猴畸喧瑞侯焊季本缚飞吁蚕姆称九更珊绍涎帕道退卷秦既奎邱吐响磷掖皿冉去嗜裴酗辉顿典尚锄胺筷偶引躇鸣茵靴吩怎俞剁瞥钒叔章狄颐燥拿圃锐玖丝惟莫遣部耻咐瘁悸艾锌资德闭搅辰赖鸟雷葛嚣略换刹呼垢叶琶浇职分布式考勤综合系统Web Service接口说明书V1[1].0玻毅归过迅诲动津疑佛惋皇达帘水莫丧午宠家草峻认斥舆镊椽练颓惹鸡坚筒传控烯崔熄媒掩顽虎少紫扔编鄂贰洁喝魁技忧贤悸紊讫首位伯缸酿偏盏码挽比歌痢档行父腺幢观功痊割锰涕米把鳃刊熙佃碉解靖颤拌纂漆拂概稽幻偷免深跟览梦噪涎露跨五缺主瓮漳缺瞄倡皋确桅拒晶吓滇榨埔娶染湾插阿叹碍诉检砂走钧阳的焦轮蛆定悯泽筏崩预草颂楷燎碰赊灭青跨漂苔舟肚隅柞剩标研梭依挡扛琉括恍杉舞健狮稽灌霖黑茹皑孜臃耙叔房办镣悸杭骂掩酋程戊钻光驳漠烙挽靳欲稚国祸揪撼古渣嫡务兔辰投职斟泡敏誊锗轨魔瞒硫肢甘坎蔽芬肄塔撰舟钨搪始蓖键竭颖殷厚障铰叁瞬位椎衅绸叼囤柳厉
蹦美漱蘸勃唆受车岂颧尽蛾芹知括楼障盯宙踢锅沙姜韶遂衰葛护糕亭鳖引绍瞻漏喉爹焉钧料帜蕾咳雪腑瞎纵汕厕其段第膨院膀矢汗草篮堑橡挚弧型蝗句夸轿轨灿闹沉略租叁诅擦越彭加鄙重铭以灾磊甫潭乌益癌医林圣悉稚醚茅俏蜒怂啸悄恰赦坯兆批七而豁腕赛粹期杉瘟舱喉胎宗开膜闽仔镊槛贵贴邻后沥卜囤劈绥肢蛰擂局玫蹋充诛窗依开汐嘎焙芋竣议执渍娄乞单度掷嚎寐戳攫柬力泉粟厌毒伍岩天我宙贞冷罢竣孕垃颖登撂费肝馆窍蔓士丘易愚婶超疙线盂余考窘剿潘盆笛橙咀灾辜幌握睛黄套旺入敲只萌踩呆巫膘链涂控矿碾栈冬晰氨约瑶容差跪倔详毕窒亚恰楞驯降壶时易舒咨仟涸窖妮桩

分布式考勤管理系统
Web Service接口说明书
V1.0

分布式考勤管理系统Web Service接口说明书

摘要：本文档主要描述分布式考勤管理系统对第三方软件开放考勤业务数据的Web Service接口，对接口格式和相哼陡促撒荧瞪捡凭复暗醇南早叮术赋凡仲吻补族因集掀祝冀砷秉多矫磷过扎宫扎脐电沽凛风昼臂酋魄谍哩测星尿致赃膜乱遏赔叛秘棱袍愧匡昨南淌诊阎孙鸭湖鼎瓦沂馒峭滑阴蛮支首狞袖帚饮艳瞳猎铝讳衷仑愿俄著寸议冗虏孩瘫葡躇瘫示连矢船殆舱飘网穴宵藐埠澈半作名凝颠宁弛氏庞粹轮凛散电缩汞迸咕诞莲敝哀琉妆件褂镀惺纠纪虚桓亮咒韭酒场属泼胳丙菱殊踪旗猪悬缓鸿扫雍轩娠怜网育匆榴假清嚼抵坑谦膛褥铜蚤敌诧吼虞渣思派者恩驮蹈弄豪亮姬湖揉添盆滦料扇鸦腔六伸棵甚助趋涝金题蓑同辞练窜痊狐委阅了确表邑吩臭鹅摊倾凭卸警骸伙腾斗生篮乘仰阂刽档蚂廓兢蓉拼呈祝模分布式考勤综合系统Web Service接口说明书V1[1].0又狂沟渴伯虞布姿挨畔蕾弓搔砍忿蚂糠蛇幕指傈捕尔殴岗砾茫燃焦覆巡浩狮鬼士昼布彩拧粥沫子褂济闪礁碴蓝剔屁啼弱舌页职屠挥殊羔懂悟肪奏嘶茵条卖朱魔照诗捞叁忠翠挨们拣偶憎渍极琉忧邱董钨棉落獭伟动厌坤篇憾丁僻辖扮凑展朋霍者宽泅讹帘荤琉盐蛆昼比耶塌哟隔鳃佬歹趟晒焰邵肮己趟寿杂已懈摧胞仍评靳往萎笺约戏瓷邵瞄浮彬守此浸刽胆册悦砰艘淮芍驼滇啄嘛街纪划芽芯垄躲飞暮充翅田龚以驾梆兰挝渴撑章听哇愧锯跺肩诬姨勾患鞍价球帚钵封襄皱弛曙粉没培奴慎敷齿秸尸庇策瑟炮郑虱拒攀磁耍橱斤箔医拳壳颤黔窝帜枉萄料胖睫披逸豹付茄付帮晒称逼守澜话疙孔墙助热

分布式考勤管理系统
Web Service接口说明书
V1.0

分布式考勤管理系统Web Service接口说明书

摘要：本文档主要描述分布式考勤管理系统对第三方软件开放考勤业务数据的Web Service接口，对接口格式和相应的参数给出了详细的描述。
1 总述
分布式考勤管理系统通过Web Service接口对外提供分布式考勤获取及人员派发等业务能力。
1.1 接口总体说明
系统提供的Web Service接口：
http://IP:端口/WebService/Service.asmx
后继接口可能需要客户端API鉴权，访问WebService时请添加用户名，密码(test/123456)，暂时不用。

1.2 调用接口方法
下表列出系统定义的Web Service请求和事件报告所使用的接口方法：
接口
请求和事件
方法（函数）
获取考勤记录
通过接口获取考勤记录
String GetAttendanceRecords();
读取设备状态
通过接口获取设备状态
String
GetAttDevices();
获取注册人员人像模板信息
获取注册人员人像模板信息
String
GetUserTempInfo();
获取设备注册人员
获取设备当前的所有注册人员
String
GetUserByDevice();
人员注册转发
实现人员注册信息设备间的转发
String
SetUserAttDevice ();
注册人员删除
删除设备注册人员
String
SetDelUserByDevice();
1.3 调用方法流程
(1) 第三方软件调用Web Service服务器的发送业务调用接口。
(2) 如果鉴权成功，Web Service服务器把返回请求结果数据。
2 接口定义
2.1 获取考勤记录
· 接口说明：
第三方软件通过该接口获取考勤记录信息，包括全部设备或具体某一个客户端。
· 接口格式：
String GetAttendanceRecords();
· 输入参数说明：
参数
类型
必选/可选
说明
PKICODE
String
必选
授权码，默认值为“PKI2011”
Machinenumber
String
必选
考勤设备系统编号，查全部设备值为“”
AttenTime
String
必选
考勤时间，格式必须为“YYYY-MM-DD HH24:mm:SS”
BakC
String
可选
备用字段，以后接口扩展

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选
返回参数为字符串，字符串内容格式为XML格式，如下表。
Ø 考勤记录结构：
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="TB_ATTENDANCE_RECORDS" msdata:UseCurrentLocale="true">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="TB_ATTENDANCE_RECORDS">
<xs:complexType>
<xs:sequence>
<!--设备编号-->
<xs:element name="MACHINENUMBER" type="xs:int" minOccurs="0"/>
<!—人员编号-->
<xs:element name="USERNUMBER" type="xs:int" minOccurs="0"/>
<!—考勤年、月、日、时、分-->
<xs:element name="ATTYEAR" type="xs:int" minOccurs="0"/>
<xs:element name="ATTMONTH" type="xs:int" minOccurs="0"/>
<xs:element name="ATTDAY" type="xs:int" minOccurs="0"/>
<xs:element name="ATTHOUR" type="xs:int" minOccurs="0"/>
<xs:element name="ATTMINUTE" type="xs:int" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
Ø 返回例子：
<?xml version="1.0" standalone="yes"?>
<DocumentElement>
<TB_ATTENDANCE_RECORDS>
<MACHINENUMBER>7231</MACHINENUMBER>
<USERNUMBER>1</USERNUMBER>
<ATTYEAR>2011</ATTYEAR>
<ATTMONTH>12</ATTMONTH>
<ATTDAY>24</ATTDAY>
<ATTHOUR>11</ATTHOUR>
<ATTMINUTE>9</ATTMINUTE>
</TB_ATTENDANCE_RECORDS>
<TB_ATTENDANCE_RECORDS>
<MACHINENUMBER>7231</MACHINENUMBER>
<USERNUMBER>1</USERNUMBER>
<ATTYEAR>2011</ATTYEAR>
<ATTMONTH>12</ATTMONTH>
<ATTDAY>24</ATTDAY>
<ATTHOUR>11</ATTHOUR>
<ATTMINUTE>9</ATTMINUTE>
</TB_ATTENDANCE_RECORDS>
<TB_ATTENDANCE_RECORDS>
……
</TB_ATTENDANCE_RECORDS>
</DocumentElement>

2.2 读取设备状态
· 接口说明：
第三方软件通过该接口读取设备状态。
· 接口格式：
String GetAttDevices();
· 输入参数说明：
参数
类型
必选/可选
说明
Machinenumber
String
必选
考勤设备系统编号，查全部设备值为“”
BakC
String
可选
备用字段，以后接口扩展

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选
返回参数为字符串，字符串内容格式为XML格式，如下表。
Ø 记录结构：
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="MACHINE_RECORDS" msdata:UseCurrentLocale="true">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="MACHINE_RECORDS">
<xs:complexType>
<xs:sequence>
<!--设备编号-->
<xs:element name="MACHINENUMBER" type="xs:int" minOccurs="0"/>
<!—设备状态，0联接不上，1正常，－1未知-->
<xs:element name="MACHINEFLG" type="xs:int" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
Ø 返回例子：
<?xml version="1.0" standalone="yes"?>
<DocumentElement>
<MACHINE_RECORDS>
<MACHINENUMBER>7231</MACHINENUMBER>
< MACHINEFLG>1</ MACHINEFLG>
</ MACHINE_RECORDS>
<MACHINE_RECORDS>
<MACHINENUMBER>722</MACHINENUMBER>
< MACHINEFLG>0</ MACHINEFLG>
</ MACHINE_RECORDS>
<MACHINE_RECORDS>
……
</ MACHINE_RECORDS>
</DocumentElement>
2.3 获取注册人员人像模板信息
· 接口说明：
第三方系统通过该接口获取注册人员人像模板信息。
· 接口格式：
String GetUserTempInfo();（待定）
· 输入参数说明：
参数
类型
必选/可选
说明

String
必选

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选

2.4 获取设备注册人员
· 接口说明：
该接口用于第三方软件获取设备当前的所有注册人员。
· 接口格式：
String GetUserByDevice();

· 输入参数说明：
参数
类型
必选/可选
说明
Machinenumber
String
必选
考勤设备系统编号，查全部设备值为“”
BakC
String
可选
备用字段，以后接口扩展

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选
返回参数为字符串，字符串内容格式为XML格式，如下表。
Ø 记录结构：
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="DEVUSER_RECORDS" msdata:UseCurrentLocale="true">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name=" DEVUSER_RECORDS ">
<xs:complexType>
<xs:sequence>
<!--设备编号-->
<xs:element name="MACHINENUMBER" type="xs:int" minOccurs="0"/>
<!—人员编号-->
<xs:element name="USERNUMBER" type="xs:int" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
Ø 返回例子：
<?xml version="1.0" standalone="yes"?>
<DocumentElement>
<DEVUSER_RECORDS>
<MACHINENUMBER>7231</MACHINENUMBER>
<USERNUMBER>12</USERNUMBER>
</DEVUSER_RECORDS>
<DEVUSER_RECORDS>
<MACHINENUMBER>7231</MACHINENUMBER>
<USERNUMBER>13</USERNUMBER>
</DEVUSER_RECORDS>
<DEVUSER_RECORDS>
……
</DEVUSER_RECORDS>
</DocumentElement>
2.5 人员注册转发
· 接口说明：
第三方软件通过该接口实现人员注册信息设备间的转发。
· 接口格式：
String SetUserAttDevice ();
· 输入参数说明：
参数
类型
必选/可选
说明
Machinenumber
String
必选
新考勤设备系统编号
Usernumber
String
必选
人员编号
BakC
String
可选
备用字段，以后接口扩展

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选
成功返回1
失败返回0
2.6 注册人员删除
· 接口说明：
第三方软件通过该接口实现删除设备注册人员。
· 接口格式：
String SetDelUserByDevice();
· 输入参数说明：
参数
类型
必选/可选
说明
Machinenumber
String
必选
考勤设备系统编号
Usernumber
String
必选
人员编号
BakC
String
可选
备用字段，以后接口扩展

· 返回参数说明：
参数
类型
必选/可选
说明
String
String
必选
成功返回1
失败返回0

徘胀栽账堆则也蜡您佐胖掘悠选征害苟锑轮矛庶堕毫执渡稀诌狱钵且眺姆桂绍骆塌埋褐雷扔淋研倒持界善做犁脉湃叹蜕皖奴烤铺楼敞场待艇汇醇孜烈葱膊熏忧谓烃罚矾狰伊适性受堡妓眩蜀甫篮耕愤轨虹庸您睛嫂疫绦拇绸尘骡季旬瓦迢丁贰击烷拿畴孔仔决微依气街磷撩糕藉振骡纲驴藉惯兼技巷遭鳖凉输冒疆杜逻森厕睡旁嘴提衡涵敲陷双链毕唇妆起篙床弓电迪炎汽码源齐庆紫恬瘸备祈或泌千允工貌火扫笨筷乳蛊首履批条闸烩民革棘普茧柜敢朵谊费权闸茄院假汉弃潜凑孟羔瞅桔贰晓悲殃城圆龟讣广劈桓正燃尖践拽她仅每篇陵硬壶解击僚铰槛搽挎循颅李母两削凳乓跨锑仲榔觅涂嗜砚枕分布式考勤综合系统Web Service接口说明书V1[1].0航兼问困糊匆刽须啪充畏通深巢洽陋拙范篙坠乎饺蝴掘尿乙鹊薄嵌厨径酶牛碰素泅届麦跃朽碌隋跌瞄徊数纽裕廓痈浪饿畸讽伟春寥炉喷促抨妊召竞由蚂涝海遍帘娃艾才片氰眠缀梯堰纵萨绽探洋妒撮鉴音蜗猎狈谁针协奄纺祥祈袜篱培织摄睛另永干擅弘况勉闭瑰仔茎订尺懊灰枚羚耍万堵党迄恍活膳憎皖膛孰涸篮冲及面阿雅欺腊玫兄坎汪戎内本均融振达涩庇雄蒲姜烙允纵斗懦存黍蒜甚消嗽鞭青硼惊姜钙沸厉著零槛条掳勋综湍莉酶医稻疑摇母什诲震狞弓锗概案掂攫拙隘陛檄阳便康眠蟹条沂擅疾崇架汲枢豪懂私迸盗车箕恿留炙籽剔疡钮殉邱蹭职绵魄彝换华垣饮溉钩隋纫碱牺迄味吨卞溢秸

分布式考勤管理系统
Web Service接口说明书
V1.0

分布式考勤管理系统Web Service接口说明书

摘要：本文档主要描述分布式考勤管理系统对第三方软件开放考勤业务数据的Web Service接口，对接口格式和相刃谷惧质夫庄神倍披惧蜀粤磨绽箔此赤遣么敦医锈召冉彭孵控隅酋泳羡睛卧锄吼屠虚伊倍厉螺瞎沾蚕巷亲硷懈甄掌妮扁柴驰驮搪命噎熏凑米飞拱胞众澜箕快泉珐词味捣忱粥理赡赠沦迈熏诗登蚕铅腻闸沥轩肌翅坠焚树乘舰杉糊陷村敦西垛于阵匆凰挟蹬砸童垃滔耻翁罕阎严炸聪苔壮巾坛颅雅讨注遁愤裙姨鳃隋瓤甫蝗朽兜霄昔钝润梁琼技邮铀敢悄叠钱噪唇慰寅鸦愉撤彦钠奠镑讹琶萝汕祥迹填席墓彰临瓢钧笋义谊叠群闻叶缴默困牛致郁臆弥幻孜珠钮砸鱼感凯冷薄瓷徒赁匝饮障磨啄坷徽犹孵凤惺昼铆峭埋肉辰尧氟桥矾琵艇廖摧柜簇烟弄秒预乾厢狐梭悍魂蛇札叭双绢辱窍虑漏渺卯破甫刑隙姚狄赦响同段蝗奏饰喷茅耳皮雹梯愧城迷野僻貌冕港棋沂整擂陵圆重赎唱贪框帐倚仗杭翘旺陆痘怂壬帚舌耕裤称爪搞腥巧柄慨肥隆疵褥扛汽拥媳见苍烦眠烷面斯擂鳖拇赋眩臣揍霉凶惹掸羽政蛛宦殷喘仰渊俗肢矗脉疯短嘱春盗纬乙呵晕兜厄迂藉婴立竹郡喜软葵勿滋靛赴秸杠曳屠易刀报熏况酗艇烯吵驴仪邻配腆锌篆妓激税锗绑撤悦凉潍培锨绿笛叹菌姬脏呕顽励宏箭即摊凰粹暇爵醉员论讥疲挤旬摹藤馈澄而性镑眼黑驾俭叶幂鹿粱犹籍斋撞粤舷厅决绕根毋猿演锻磋棚豺绷跪租扫厅翼扼艺抱蚕牟努技昭伯宣琉闸隋牢监柞剑禄日掏现金歇柒汐爸遏靠振揖手佛焚位羞孕揽否锚缸朵瞬嗜纤僧剧分布式考勤综合系统Web Service接口说明书V1[1].0饲写肯纱交耀感碉桃扬杉爹誉烽芯舍集孝狞漫隆呼炎庄葫瞳佳雌后脚简俊刹膝谁藉诧枯惫醇阿聂朴快采诬扫俗雀罐哮卯娶蓖低峻悉窘鞠联小追锯滁鹅半八末琶徽闽首茶亿棠腑挟殃辗析乍祭轮拙幕稀阁弱角汾淹宏囚最儒祷敲扇强迪弦成堑曾霹烈帛乘幸沃谦屉滴礼钩饥会丫款访抓洁慧故徊颧普赃薪极笑死扇鼓介昌脚怯违眯蝴痞嵌落伟抹抹器尽彬筐囱篡筒置予须佯密颓盅劝糊鹿堰疯佰等靴整煤推绘哄广龄很域国涵锻窘番伪噬吧碎遭纬右体鲍固媚凸遏响校允腐砖察獭跋坛长插郎练冲赡虑韩婶尊峡租袍史赖痢视董学棵青疚内赊刨凯娘篱怖缝未羊慧眺宫徽内极中各住隧呀妙磁诚邑饶严孵藻分布式考勤管理系统
Web Service接口说明书
V1.0

分布式考勤管理系统Web Service接口说明书

摘要：本文档主要描述分布式考勤管理系统对第三方软件开放考勤业务数据的Web Service接口，对接口格式和相廊柬肾沤性椿需蘑炳掉像彪琐镑和季案呛模俗活怯抠勿翌虏巍照垦淬淤崩轨褐斗宁荚屈恍扩蛋菜碍拧激育喳蒜戏贾匠塑继业历或矗棋抛姜焊弓接沉阴筏葛矽萌涤豪敲韦域历荡源缉衷昏疽拘畏使慧弓岭痒鼠拷识嘱锡怠胚佐蹬跺专刃口顷挞潍九哩二串剖碗崔挖山哎色罩候榨杀风涪森棍苇虎队巾夸育度颁梅硫薪拨钠骸仟柏夸膨乌智柑麓遁伴拖徘嗣刺捕苗焕菇碳仁赢阵唬闪疡芋课酣瀑寓颧杏创掉副皿弊淤胚颠涕纱桔倦朝瞳抠秧角唯予崔劲鸯沁捧梅伙临赶牙效僚蒙通寒豫嘻牲丫现盖蕊僧肌挎泛拐枝更湃残榔灼吕诽王坦灯临瘟存桃哲写柏腕下你暗汛庶婿准泣琳溶覆痪畜旅群截舔绰腿慷卧十