教程目录
部署和简要说明(1)
获取token&数据字段(2)
概括
- 本文的操作需要正确部署U8HttpApi
- 对本套接口系统管理目录说明
系统管理
获取token
参考获取token
根据sql进行查询
- 此POST方式接口运行调用者传入SQL语句,或者将SQL语句写到xml文件中,进行语句执行
传入JSON参数:
{"selectSQL": "","customSQLFileName": "","customSQLPath": "","paramObj": { }
}
传入sql语句
- 接口目录下文件webconfig中默认的数据库用户和密码,若除查询操作,无其他插入、修改操作,建议设置只读用户!!!
- selectSQL不为空则执行此sql
自定义sql
- 所有自定义的sql语句全部写到接口目录下,SqlXML文件夹。**其中U8SQL.xml文件不能改动,此文件可能随着本套接口更新而覆盖。**可以写到CustomSQL.xml文件中,或者增加一个xml文件
- 例子
CustomSQL.xml文件如下:我们定义一个查询语句,需要传入两个参数@cPsn_Num和@SysCompage
<?xml version="1.0" encoding="utf-8" ?>
<U8API><Person desc="测试示范sql"><Get>select p.*,d.cDepName,d.cDepCode ,h.vdescription from hr_hi_person p left join Department d on p.cDept_num =d.cDepCodeleft join HR_CT000 h on p.rPersonType = h.ccodeIDwhere p.cPsn_Num =@cPsn_Num and p.SysCompage=@SysCompage</Get></Person>
</U8API>
- 传入参数
selectSQL :留空
customSQLFileName :表示使用CustomSQL.xml文件,可以增加xml文件改变此值
customSQLPath :自定义sql的path
paramObj : 传入的参数列表
{"selectSQL": "","customSQLFileName": "CustomSQL","customSQLPath": "U8API/Person/Get","paramObj": {"@cPsn_Num": "00001","@SysCompage": 168}
}
执行成功将返回data
{"code": 0,"msg": "OK","data": [{"cPsn_Num": "00001","cPsn_Name": "王铭",其他参数......}]
}
获取审批任务
此接口主要获取当前用户的审批任务
多单保存
- 此接口用的场景不多,为了不同单据同时生成
单据组成
一张单据JSON参数,由Inum标识唯一,Data表示单据数据
{"Inum": "OtherIn","Data": {"iHead": { },"iBody": [{ }]}}
多单据JSON参数
[{"Inum": "OtherIn","Data": {"iHead": { },"iBody": [{ }]}},{"Inum": "OtherOut","Data": {"iHead": { },"iBody": [{ }]}}
]
总结
- 本次介绍了系统管理目录中较为重要的几个接口,尤其是自定义查询接口,因为本套接口不会提供太多的查询接口,建议使用者自行编写sql操作
- 下篇文章将介绍基础档案模块