系统接口培训文档

1、仅限阅读 请勿传播当您阅读本方案时，即表示您同意不传播本方案的所有内容泛微软件有限公司中国上海浦东软件园陆家嘴分园峨山路91弄101号3层邮政编码：200127电话：+86 21 50942228传真：+86 21 50942278版 本文档简要信息:文档主题(Title)人员接口文档作者(Author)杨林审批者(To Be Approved By)说明(Comments)文件名称(File Name)文档版本历史:序号日期版本变更说明修改人注释1.2016-10-07V1.0杨林.目录版 本2第一部分数据源配置5一.接口说明5二.实现方法&步骤51.配置数据源文件da

2、tasource.xml(该文件位于e-cology的WEB-INF/service/目录下)52.属性说明63.在5.0及以上版本可以直接在进行可视化的配置64.可视化配置属性说明75.如何引用该数据源7第二部分自定义定时器9一.接口说明9二.实现方法&步骤91.配置调度文件schedule.xml(该文件位于e-cology的WEB-INF/service/目录下)92.属性说明103.在5.0及以上版本对于CronJob可以直接在进行可视化的配置104.可视化配置属性说明105.如何实现任务执行的操作116.CronExpr表达式12第三部分流程流转过程中和异构系统数据交互（ac

3、tion）14一.接口说明14二.应用效果14三.实现方法&步骤161.xml文件配置162.属性说明173.在5.0及以上版本可以直接在进行可视化的配置174.可视化配置属性说明185.Action接口代码编写186.流程节点附加操作接口调用207.控制action不往下流转20第四部分获取异构系统数据至流程字段(自定义浏览框)21一.接口说明21二.应用效果21三.实现方法&步骤211.配置接口文件212.属性说明233.在5.0及以上版本可以直接在进行可视化的配置234.可视化配置属性说明245.获取异构系统的数据作为流程字段的系统设置25四.高级应用(浏览框数据联动)2

4、6第五部分短信API接口31一.接口说明31二.实现方法&步骤311.xml文件配置312.短信设备配置文件修改323.自定义代码开发实现方式344.在5.0及以上版本可以直接在进行可视化的配置35第六部分流程自定义页面接口37一.接口说明37二.实现方法&步骤37三.应用38第七部分流程提交前执行自定义函数40一.接口说明40二.实现方法&步骤40第八部分Sap自定义浏览按钮42一.接口说明42二.实现方法&步骤42第九部分Html模式的流程应用51一.接口说明51二.应用案例51第十部分文档webservices接口66一.接口说明66二.使用说明66第十一

5、部分工作流程webservices接口82一.接口说明82二.使用说明822.2.2接口说明822.2.3调用实例90第十二部分人力资源webservices接口96一.接口说明96二.使用说明961)检查web service是否已部署962)接口方法概述963)接口相关对象说明984)示例程序109Ø使用客户端同步公司信息109第一部分 人力资源webservices接口一. 接口说明可以通过该接口对系统中的人员组织架构进行操作。具体方法见下面的使用说明。二. 使用说明1) 检查web service是否已部署在浏览器中输入http:/IP/services,应显示如下页面：如果

6、未出先上述页面，则web service未部署成功，请与泛微项目人员联系。接口部署成功之后，需要在系统的的HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP，调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。2) 接口方法概述名称参数返回值功能描述SynHrmResourceString ipaddress：调用接口的IP地址，String xmlData：人员信息的xml成功:1,失败:0,2:无权限调用同步人员信息getHrmUserInfoString ipaddress：调用接口的IP地址，String subcompanyId：分部id，多

7、个用逗号分隔（不为空时该条件有效）String departmentid：部门id，多个用逗号分隔（不为空时该条件有效）String jobtitleid：岗位id，多个用逗号分隔（不为空时该条件有效）String lastChangeDate：最后修改日期，日期格式“YYYY-MM-DD”（不为空时该条件有效）String workcode:人员编码（不为空时该条件有效）UserInfo：用户信息列表根据参数条件获取用户信息列表checkUserString ipaddress：调用接口的IP地址String loginid：登录名 String password：密码True:表示存在Fa

8、lse：表示不存在检测OA用户3) 接口相关对象说明4）SynHrmResource同步人员传入xml的格式如下（一定要按照此格式传入）：<?xml version="1.0" encoding="UTF-8"?><root> <hrmlist> <hrm action="add"> <workcode>10001</workcode> <loginid>test</loginid> <lastname>test</las

9、tname> <password>123456</password> <subcompany>测试分部一</subcompany> <department>测试部门一</department> <jobtitle>测试岗位一</jobtitle> <statue>正式</statue> <managerid>1024</managerid> <sex>男</sex> <birthday>1988-09-09&l

10、t;/birthday> <telephone>12345678</telephone> <mobile>12345678</mobile> <email>test</email> <maritalstatus>已婚</maritalstatus> </hrm> <hrm action="edit"> <workcode>10001</workcode> <loginid>test</loginid>

11、<lastname>test</lastname> <password>123456</password> <subcompany>测试分部一</subcompany> <department>测试部门一</department> <jobtitle>测试岗位一</jobtitle> <statue>正式</statue> <managerid>1024</managerid> <sex>男</sex>

12、<birthday>1988-09-09</birthday> <telephone>12345678</telephone> <mobile>12345678</mobile> <email>test</email> <maritalstatus>已婚</maritalstatus> </hrm> </hrmlist></root>相关属性说明：Action：动作，add：添加，edit：编辑Workcode：人员编码，唯一值Subcom

13、pany：分部Department：部门Lastname：姓名Loginid：登录名Password：密码Seclevel：安全级别Sex：性别Jobtitle：岗位Jobactivityid：职务Jobgroupid：职务类别Jobcall：职称Joblevel：职级Jobactivitydesc：职责描述Managerid：直接上级（编码）Assistantid：助理（编码）Status：状态Locationid：办公室Workroom：办公地点Telephone：办公电话Mobile：移动电话Mobilecall：其他电话Fax：传真Email：邮箱Systemlanguage：系统语言

14、Birthday：出生日期Folk：名族Nativeplace：籍贯Regresidentplace：户口Certificatenum：身份证号码Maritalstatus：婚姻状况Policy：政治面貌Bememberdate：入团日期Bepartydate：入党日期Islabouunion：工会会员Educationlevel：学历Degree：学位Healthinfo：健康状况Residentplace：现居住地Homeaddress：家庭联系方式Tempresidentnumber：暂住证号码以上是人员同步的所有节点信息，需要同步那些字段，就填写相应的值。8）UserInfopriva

15、te int userid ; /用户id private String subcompanyid1; /分部private String departmentid; /部门private String workcode; /编号private String lastname; /姓名private String loginid; /系统账号private String password; /密码 private String seclevel; /安全级别private String sex; /性别private String jobtitle; /岗位private String job

16、activityid; /职务private String jobgroupid; /职务类型 private String jobcall; /职称private String joblevel; /职级private String jobactivitydesc;/职责描述private String managerid; /直接上级private String assistantid; /助理private String status; /状态 eg:正式、试用等 private String locationid; /办公地点private String workroom; /办公室p

17、rivate String telephone; /办公电话private String mobile; /移动电话private String mobilecall; /其他电话private String fax; /传真private String email; /电子邮件private String systemlanguage;/系统语言 默认7private String birthday; /生日private String folk; /名族private String nativeplace; /籍贯private String regresidentplace; /户口pr

18、ivate String certificatenum; /身份证号private String maritalstatus; /婚姻状况private String policy; /政治面貌private String bememberdate; /入团日期private String bepartydate; /入党日期private String islabouunion; /是否是工会会员private String educationlevel; /学历private String degree; /学位private String healthinfo; /健康状况private

19、 String height; /身高private String weight; /体重private String residentplace; /居住地private String homeaddress; /家庭住址private String tempresidentnumber; /暂住证号码private String startdate = "" ; /合同开始日期private String enddate = "" ; /合同结束日期private String createdate="" /创建日期private

20、 String lastChangdate="" /最后修改日期private int accounttype; /账号类型private int dsporder; /显示顺序以上是获得用户的基本信息字段2.4 生成客户端大家知道，在本地调用web service,最便利的方法是利用工具生成客户端代理，开发人员通过客户端代理去访问web service将会非常简单，就象调用本地的方法一样。各大主流的编程语言都提供了通过wsdl生成客户端代理的工具,如c#中的wsdl.exe和java中的wsdl2java。本文以java为例说明客户端的生成方法。2.4.1客户端所需jarcommons-discovery-0.2.jarjavax-wsdl_1.5.1jarcommons-logging_1.0.4.jara