用友U8接口-系统管理(3)

教程目录

部署和简要说明(1)
获取token&数据字段(2)

概括

1. 本文的操作需要正确部署U8HttpApi
2. 对本套接口系统管理目录说明

系统管理

获取token

参考获取token

根据sql进行查询

1. 此POST方式接口运行调用者传入SQL语句，或者将SQL语句写到xml文件中，进行语句执行
   
   传入JSON参数：

{
    "selectSQL": "",
    "customSQLFileName": "",
    "customSQLPath": "",
    "paramObj": {      
    }
}

传入sql语句

1. 接口目录下文件webconfig中默认的数据库用户和密码，若除查询操作，无其他插入、修改操作，建议设置只读用户！！！
2. selectSQL不为空则执行此sql

自定义sql

1. 所有自定义的sql语句全部写到接口目录下，SqlXML文件夹。**其中U8SQL.xml文件不能改动，此文件可能随着本套接口更新而覆盖。**可以写到CustomSQL.xml文件中，或者增加一个xml文件
   
2. 例子
   CustomSQL.xml文件如下：我们定义一个查询语句，需要传入两个参数@cPsn_Num和@SysCompage

 
<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.cDepCode
      left join HR_CT000 h on p.rPersonType = h.ccodeID
      where p.cPsn_Num =@cPsn_Num and p.SysCompage=@SysCompage
    Get>
  Person>
U8API>  

3. 传入参数
   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": "王铭",
			其他参数......
		}
	]
}

获取审批任务

此接口主要获取当前用户的审批任务

多单保存

1. 此接口用的场景不多，为了不同单据同时生成

单据组成

一张单据JSON参数，由Inum标识唯一，Data表示单据数据

{
		"Inum": "OtherIn",
		"Data": {
			"iHead": {				
			},
			"iBody": [
				{							
				}
			]
		}
	}

多单据JSON参数

[
	{
		"Inum": "OtherIn",
		"Data": {
			"iHead": {				
			},
			"iBody": [
				{							
				}
			]
		}
	},
	{
		"Inum": "OtherOut",
		"Data": {
			"iHead": {				
			},
			"iBody": [
				{				
				}
			]
		}
	}
]

总结

1. 本次介绍了系统管理目录中较为重要的几个接口，尤其是自定义查询接口，因为本套接口不会提供太多的查询接口，建议使用者自行编写sql操作
2. 下篇文章将介绍基础档案模块