报表操作
18. 新增报表
POST/api/Open/AddReport
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
InputParams |
String |
关联填报传参 |
Y |
|
dicTablesData |
String |
预置表数据 JSON(字典:表名 → 行数组),可为空 |
Y |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功;1 无新增权限/前置控制拦截;2 异常 |
N |
|
Message |
String |
具体错误 |
Y |
|
RecordID |
String |
新报表ID |
N |
|
ReturnData |
String |
动态 JSON(按模板表结构生成的初始数据) |
Y |
|
SingleImages |
Array |
主表和普通明细表图片字段(ImageEntity:ResourceID、Url、ThumbUrl 等) |
Y |
|
SingleAffixes |
Array |
主表和普通明细表附件字段(AffixEntity:ResourceID、Url、Mark 等) |
Y |
|
ImageArray |
Array |
特殊图片明细表字段 |
Y |
|
AffixArray |
Array |
特殊附件明细表字段 |
Y |
- 会校验用户新增权限及模板 RunBeforeAdd 前置控制,并自动创建该报表的图片/附件目录。
19. 获取单张报表详细数据
POST/api/Open/GetReportData
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
RecordID |
String |
报表ID |
Y |
|
OprtType |
String |
编辑状态:0 新建 1 修改 2 查阅 |
N |
|
CustomRcid |
String |
自定义RCID |
Y |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功 |
N |
|
Message |
String |
具体错误 |
Y |
|
ReturnData |
String |
动态 JSON(报表详细数据) |
Y |
|
SingleImages / ImageArray / SingleAffixes / AffixArray |
Array |
图片/附件字段集合(结构同第 18 节) |
Y |
23. 获取报表总表数据
POST/api/Open/GetReportListData
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
FilterValue |
String |
模糊查询值 |
Y |
|
PageIndex |
Int |
页码(从 0 开始) |
N |
|
PageSize |
Int |
每页多少条记录 |
N |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功;1 无模板操作权限/没有摘要列表字段 |
N |
|
Message |
String |
具体错误 |
Y |
|
TotalCount |
Int |
总表行数 |
Y |
|
ReturnData |
String |
总表数据 JSON 字符串:{ "ReturnData": [ { "app": {...}, "sys": {...} } ] } |
Y |
- app:摘要字段键值对(隐藏字段不返回);日期字段格式化为 yyyy-MM-dd(含时间则 yyyy-MM-dd HH:mm:ss);图片字段值为缩略图相对路径,另附
{字段名}_id为资源ID。 - sys:系统字段——RecordID、UserName、PhotoUrl、CreateTime;模板纳入工作流时含 WorkflowStatus(流程状态);有 ReportStatus / LockStatus 列时一并返回。
- 会校验模板读写权限;列表图片缩略图(最大 800/400px)异步生成。
24. 保存报表
POST/api/Open/SaveReport
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
RecordID |
String |
报表ID(不存在/为空即为新增) |
N |
|
InputData |
String |
各表字段数据 JSON:{ "表名": [ { "字段名": "值", ... } ] } |
N |
|
CustomRcid |
String |
自定义RCID |
Y |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 保存成功;1 无权限/保存失败/模板加载失败 |
N |
|
Message |
String |
具体错误 |
Y |
|
Data |
String |
保存后的报表RID |
Y |
- 服务端通过 CheckExistsReportID 自动判断新增/修改,并分别校验新增(CanCreate)/修改(CanMod)权限。
- InputData 按模板表结构解析:图片字段(BaseDataType=5)取
{字段}_id;附件字段(=6)取{字段}与{字段}_id;定位字段(=7)取{字段}与{字段}_L。
25. 删除报表
POST/api/Open/DeleteReport
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
RecordID |
String |
报表ID |
N |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功;1 删除失败 |
N |
|
Message |
String |
具体错误 |
Y |
26. 执行报表命令
POST/api/Open/ExecReportCommand
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateName |
String |
模板名称 |
N |
|
CommandName |
String |
报表命令名称 |
N |
|
InputParams |
String |
命令入参 |
Y |
|
OutputParams |
String |
命令出参定义 |
Y |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功;1 执行失败 |
N |
|
Message |
String |
具体错误 |
Y |
|
ReturnData |
Object |
命令返回的键值字典 |
Y |
27. 执行Nx命令
POST/api/Open/ExecNxCommand
请求参数
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
AccessToken |
String |
访问令牌 |
N |
|
TemplateID |
String |
模板ID |
N |
|
CommandName |
String |
Nx命令名称 |
N |
|
QueryString |
String |
命令查询串 |
Y |
|
ReturnField |
String |
指定返回的字段名 |
N |
返回JSON数据
|
字段 |
类型 |
描述 |
可为空 |
|---|---|---|---|
|
Code |
Int |
0 成功;1 执行失败 |
N |
|
Message |
String |
具体错误 |
Y |
|
ReturnData |
String |
返回字段内容(未命中 ReturnField 时返回完整对象字符串) |
Y |