衡石科技产品手册-指标分析

2024-09-01 20:44

本文主要是介绍衡石科技产品手册-指标分析,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

指标分析引用参考资料:指标分析​

资源说明​

看板的定义​

看板为新的resource, 展现形式与Dashboard一样,权限与App一样。在看板列表中可以看到我自己创建的和别人授权给我的。展示模式分卡片样式和列表样式。有搜索、排序、分类功能。

看板结构说明​
Kanban​
字段类型描述
idLONG看板id
folderIdLONG看板所在文件夹的id
areaSTRING看板所在区域,默认为SELF_SERVICE
titleSTRING看板的标题
createdByLONG看板创建者的userId
createdAtDATE看板创建时间
updatedByLONG看板更新者的userId
updatedAtDATE看板更新时间
hsVersionLONG可选,本次编辑的版本号,从0开始,修改前先GET待修改资源获取当前版本号,修改时带上刚刚获取的版本号,服务端会检查并发冲突。不带版本号不检查并发冲突
tenantIdLONG租户Id
optionsOBJECT看板配置信息
options.configOBJECT看板配置信息
options.config.versionLONG看板创建版本,与系统版本一致
options.layoutsMAP看板里的图表布局信息
KanbanDto​
字段类型描述
creatorOBJECT看板创建者信息
updaterOBJECT看板更新者信息
actionSTRING权限描述, admin-read-write是管理者权限,read-write是编辑者权限,read是查看者权限
isCollaboratedBOOLEAN是否协作
parentsOBJECT 数组看板所在的文件夹列表
menusLIST<MAP<STRING, STRING>>看板的三点菜单列表

接口说明​

1、新增看板​

请求URL​

http

POST /api/kanbans HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

看板结构说明

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT看板的共同结构见看板结构说明
接口示例​

RequestResponse

http

POST /api/kanbans HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"title": "新建看板","options": {"config": {"version": 4300},"layouts": {}}
}

2、复制看板​

请求URL​

http

POST /api/kanbans/{kanbanId}/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT看板的共同结构见看板结构说明
接口示例​

RequestResponse

http

POST /api/kanbans/57/duplicate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

3、获取看板中所有的图表数据​

请求URL​

http

POST /api/kanbans/{kanbanId}/data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

图表结构说明 ChartDto数组

URL 参数​
字段类型是否必须说明
timeoutInteger查询超时时间
返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT图表数据,每种图表的共同结构见ChartDto结构说明
接口示例​

RequestResponse

http

POST /api/kanbans/25/data?timeout=3000 HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
[{"cacheKey": "01GNXZK96N910XVNFSHPBAAB18","appId": 125783,"options": {"axes": [{"uid": "u125783_3_c10","label": "caseWhen","kind": "function","dataset": 3,"op": "group","args": [{"dataset": 3,"kind": "field","op": "c10"}],"datasetId": 3},{"appId": 125783,"uid": "u125783_3_c22","label": "jn1","kind": "measure","op": "c22","datasetId": 3}],"where": [],"having": [],"sort": [{"kind": "reference","op": "u125783_3_c22","direction": "desc","baseUid": "u125783_3_c10"}],"timebar": {"current": "dateExp","dateExp": "All Avaliable Date","dateRange": [],"show": false},"limit": 1000,"outerWhere": []},"queryString": {"refresh": false,"offset": 0}}
]

4、获取看板中单个图表数据​

请求URL​

http

POST /api/kanbans/{kanbanId}/chart-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

图表结构说明 ChartDto

URL 参数​
字段类型是否必须说明
refreshSTRING是否强制刷新,取图表数据时,true表示不会用缓存,false表示可以使用缓存
enableSampleSTRINGenableSample为true的话,后端计算时对基础数据进行采样,每次运算只取前10000行
返回对象的格式说明​

数据集数据 datasetResultDto

接口示例​

RequestResponse

http

POST /api/apps/125783/chart-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"cacheKey": "01GRRANRV0Z8VA84MY52D3WB7F","options": {"where": [],"having": [],"outerWhere": [],"axes": [{"uid": "u_1697bb6ffb9592e7_v","kind": "field","op": "省/自治区","dataset": 3}],"sort": [{"baseUid": "u_1697bb6ffb9592e7_v","kind": "reference","op": "u_1697bb6ffb9592e7_v","direction": "asc"}]},"queryString": {"limit": 100000}
}

5、获取看板中的图表数据计数​

请求URL​

http

POST /api/kanbans/{kanbanId}/chart-data/count HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

图表结构说明 ChartDto

URL 参数​
字段类型是否必须说明
refreshSTRING是否强制刷新,取图表数据时,true表示不会用缓存,false表示可以使用缓存
返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
data.totalHitsINTEGER图表数据的总行数
接口示例​

RequestResponse

http

POST /api/kanbans/125783/chart-data/count HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"cacheKey": "01GRRANRV0Z8VA84MY52D3WB7F","options": {"where": [],"having": [],"outerWhere": [],"axes": [{"uid": "u_1697bb6ffb9592e7_v","kind": "field","op": "省/自治区","dataset": 3}],"sort": [{"baseUid": "u_1697bb6ffb9592e7_v","kind": "reference","op": "u_1697bb6ffb9592e7_v","direction": "asc"}]},"queryString": {"limit": 100000}
}

6、轮询获取看板中的图表数据​

请求URL​

http

POST /api/kanbans/{kanbanId}/poll-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

1
2
3

请求参数​
request body 请求体​

图表结构说明 ChartDto数组

URL 参数​
字段类型是否必须说明
originRequestIdSTRING源请求Id
timeoutInteger查询超时时间
返回对象的格式说明​

数据集数据 datasetResultDto

接口示例​

RequestResponse

http

POST /api/kanbans/25/poll-data HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
[{"cacheKey": "01GNXZK96N910XVNFSHPBAAB18","appId": 125783,"options": {"axes": [{"uid": "u125783_3_c10","label": "caseWhen","kind": "function","dataset": 3,"op": "group","args": [{"dataset": 3,"kind": "field","op": "c10"}],"datasetId": 3},{"appId": 125783,"uid": "u125783_3_c22","label": "jn1","kind": "measure","op": "c22","datasetId": 3}],"where": [],"having": [],"sort": [{"kind": "reference","op": "u125783_3_c22","direction": "desc","baseUid": "u125783_3_c10"}],"timebar": {"current": "dateExp","dateExp": "All Avaliable Date","dateRange": [],"show": false},"limit": 1000,"outerWhere": []},"queryString": {"refresh": false,"offset": 0}}
]

7、更新看板​

请求URL​

http

PUT /api/kanbans/{kanbanId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

1
2
3

请求参数​
request body 请求体​

看板结构说明

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT看板的共同结构见看板结构说明
接口示例​

RequestResponse

http

PUT /api/kanbans/59 HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...// Request Body:
{"id": 59,"folderId": 0,"area": "SELF_SERVICE","title": "新建看板","options": {"config": {"version": 4300},"layouts": {"01GRT32MSJF75XDVYAZVDNJYMQ": {"i": "01GRT32MSJF75XDVYAZVDNJYMQ","x": 0,"y": 0,"w": 6,"h": 6,"moved": false,"static": false,"zIndex": 901,"type": "chart","version": 4300,"createdAt": "2023/2/9 11:21:33","updatedAt": "2023/2/9 11:21:33","measures": [{"enable": true,"appId": 126243,"datasetId": 32,"fieldName": "c1","labelPlaceholder": "日期"}],"dimensions": [],"filters": []}}},"createdBy": 11549,"createdAt": "2023-02-08 18:33:26","updatedBy": 11549,"updatedAt": "2023-02-08 18:33:26","isDelete": false
}

8、分页查询看板​

请求URL​

http

GET /api/kanbans HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

URL 参数​
字段类型是否必须说明
limitINTEGER分页获取个数,默认是1000
offsetINTEGER分页偏移量,默认是0
orderBySTRING排序字段
返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT看板的共同结构见看板结构说明
totalHitsINTEGER看板总数量
offsetINTEGER当前分页偏移量
接口示例​

RequestResponse

http

GET /api/kanbans HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

9、根据Id查询看板​

请求URL​

http

GET /api/kanbans/{kanbanId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
dataOBJECT看板的共同结构见看板结构说明
接口示例​

RequestResponse

http

GET /api/kanbans/59 HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

10、根据Id删除看板​

请求URL​

http

DELETE /api/kanbans/{kanbanId} HTTP/1.1

请求参数​
request body 请求体​

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
msgSTRING成功返回 success
接口示例​

RequestResponse

http

DELETE /api/kanbans/59 HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

1
2
3

11、导出看板数据​

请求URL​

http

POST /api/kanbans/{kanbanId}/async-download HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​
字段类型是否必须说明
chartOptionsOBJECT图表配置
chartNamesOBJECT图表名称
chartOuterWheresOBJECT图表过滤条件
URL 参数​
字段类型是否必须说明
timeoutInteger导出超时时间
返回对象的格式说明​

返回一个zip文件,文件名是看板的名称,解压后的excel文件中每个sheet对应一个图表的聚合数据

12、轮询导出看板数据​

请求URL​

http

GET /api/kanbans/{kanbanId}/poll-download HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
request body 请求体​

URL 参数​
字段类型是否必须说明
originRequestIdSTRING源请求Id
返回对象的格式说明​

如果导出任务没有完成,返回PENDING状态;若任务已完成,返回一个zip文件,文件名是看板的名称,解压后的excel文件中每个sheet对应一个图表的聚合数据

13、解除协作​

请求URL​

http

DELETE /api/kanbans/{kanbanId}/collaborate/cancel HTTP/1.1

1

请求参数​
request body 请求体​

返回对象的格式说明​
字段类型说明
versionSTRING当前系统版本哈希值
msgSTRING成功返回 success
接口示例​

RequestResponse

http

DELETE /api/kanbans/59/collaborate/cancel HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

这篇关于衡石科技产品手册-指标分析的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1128003

相关文章

Java程序进程起来了但是不打印日志的原因分析

《Java程序进程起来了但是不打印日志的原因分析》:本文主要介绍Java程序进程起来了但是不打印日志的原因分析,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java程序进程起来了但是不打印日志的原因1、日志配置问题2、日志文件权限问题3、日志文件路径问题4、程序

Java字符串操作技巧之语法、示例与应用场景分析

《Java字符串操作技巧之语法、示例与应用场景分析》在Java算法题和日常开发中,字符串处理是必备的核心技能,本文全面梳理Java中字符串的常用操作语法,结合代码示例、应用场景和避坑指南,可快速掌握字... 目录引言1. 基础操作1.1 创建字符串1.2 获取长度1.3 访问字符2. 字符串处理2.1 子字

Python 迭代器和生成器概念及场景分析

《Python迭代器和生成器概念及场景分析》yield是Python中实现惰性计算和协程的核心工具,结合send()、throw()、close()等方法,能够构建高效、灵活的数据流和控制流模型,这... 目录迭代器的介绍自定义迭代器省略的迭代器生产器的介绍yield的普通用法yield的高级用法yidle

C++ Sort函数使用场景分析

《C++Sort函数使用场景分析》sort函数是algorithm库下的一个函数,sort函数是不稳定的,即大小相同的元素在排序后相对顺序可能发生改变,如果某些场景需要保持相同元素间的相对顺序,可使... 目录C++ Sort函数详解一、sort函数调用的两种方式二、sort函数使用场景三、sort函数排序

kotlin中const 和val的区别及使用场景分析

《kotlin中const和val的区别及使用场景分析》在Kotlin中,const和val都是用来声明常量的,但它们的使用场景和功能有所不同,下面给大家介绍kotlin中const和val的区别,... 目录kotlin中const 和val的区别1. val:2. const:二 代码示例1 Java

Go标准库常见错误分析和解决办法

《Go标准库常见错误分析和解决办法》Go语言的标准库为开发者提供了丰富且高效的工具,涵盖了从网络编程到文件操作等各个方面,然而,标准库虽好,使用不当却可能适得其反,正所谓工欲善其事,必先利其器,本文将... 目录1. 使用了错误的time.Duration2. time.After导致的内存泄漏3. jsO

Spring事务中@Transactional注解不生效的原因分析与解决

《Spring事务中@Transactional注解不生效的原因分析与解决》在Spring框架中,@Transactional注解是管理数据库事务的核心方式,本文将深入分析事务自调用的底层原理,解释为... 目录1. 引言2. 事务自调用问题重现2.1 示例代码2.2 问题现象3. 为什么事务自调用会失效3

找不到Anaconda prompt终端的原因分析及解决方案

《找不到Anacondaprompt终端的原因分析及解决方案》因为anaconda还没有初始化,在安装anaconda的过程中,有一行是否要添加anaconda到菜单目录中,由于没有勾选,导致没有菜... 目录问题原因问http://www.chinasem.cn题解决安装了 Anaconda 却找不到 An

Spring定时任务只执行一次的原因分析与解决方案

《Spring定时任务只执行一次的原因分析与解决方案》在使用Spring的@Scheduled定时任务时,你是否遇到过任务只执行一次,后续不再触发的情况?这种情况可能由多种原因导致,如未启用调度、线程... 目录1. 问题背景2. Spring定时任务的基本用法3. 为什么定时任务只执行一次?3.1 未启用

C++ 各种map特点对比分析

《C++各种map特点对比分析》文章比较了C++中不同类型的map(如std::map,std::unordered_map,std::multimap,std::unordered_multima... 目录特点比较C++ 示例代码 ​​​​​​代码解释特点比较1. std::map底层实现:基于红黑