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

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

相关文章

深度解析Nginx日志分析与499状态码问题解决

《深度解析Nginx日志分析与499状态码问题解决》在Web服务器运维和性能优化过程中,Nginx日志是排查问题的重要依据,本文将围绕Nginx日志分析、499状态码的成因、排查方法及解决方案展开讨论... 目录前言1. Nginx日志基础1.1 Nginx日志存放位置1.2 Nginx日志格式2. 499

Olingo分析和实践之EDM 辅助序列化器详解(最佳实践)

《Olingo分析和实践之EDM辅助序列化器详解(最佳实践)》EDM辅助序列化器是ApacheOlingoOData框架中无需完整EDM模型的智能序列化工具,通过运行时类型推断实现灵活数据转换,适用... 目录概念与定义什么是 EDM 辅助序列化器?核心概念设计目标核心特点1. EDM 信息可选2. 智能类

Olingo分析和实践之OData框架核心组件初始化(关键步骤)

《Olingo分析和实践之OData框架核心组件初始化(关键步骤)》ODataSpringBootService通过初始化OData实例和服务元数据,构建框架核心能力与数据模型结构,实现序列化、URI... 目录概述第一步:OData实例创建1.1 OData.newInstance() 详细分析1.1.1

Olingo分析和实践之ODataImpl详细分析(重要方法详解)

《Olingo分析和实践之ODataImpl详细分析(重要方法详解)》ODataImpl.java是ApacheOlingoOData框架的核心工厂类,负责创建序列化器、反序列化器和处理器等组件,... 目录概述主要职责类结构与继承关系核心功能分析1. 序列化器管理2. 反序列化器管理3. 处理器管理重要方

一文解密Python进行监控进程的黑科技

《一文解密Python进行监控进程的黑科技》在计算机系统管理和应用性能优化中,监控进程的CPU、内存和IO使用率是非常重要的任务,下面我们就来讲讲如何Python写一个简单使用的监控进程的工具吧... 目录准备工作监控CPU使用率监控内存使用率监控IO使用率小工具代码整合在计算机系统管理和应用性能优化中,监

SpringBoot中六种批量更新Mysql的方式效率对比分析

《SpringBoot中六种批量更新Mysql的方式效率对比分析》文章比较了MySQL大数据量批量更新的多种方法,指出REPLACEINTO和ONDUPLICATEKEY效率最高但存在数据风险,MyB... 目录效率比较测试结构数据库初始化测试数据批量修改方案第一种 for第二种 case when第三种

解决1093 - You can‘t specify target table报错问题及原因分析

《解决1093-Youcan‘tspecifytargettable报错问题及原因分析》MySQL1093错误因UPDATE/DELETE语句的FROM子句直接引用目标表或嵌套子查询导致,... 目录报js错原因分析具体原因解决办法方法一:使用临时表方法二:使用JOIN方法三:使用EXISTS示例总结报错原

MySQL中的LENGTH()函数用法详解与实例分析

《MySQL中的LENGTH()函数用法详解与实例分析》MySQLLENGTH()函数用于计算字符串的字节长度,区别于CHAR_LENGTH()的字符长度,适用于多字节字符集(如UTF-8)的数据验证... 目录1. LENGTH()函数的基本语法2. LENGTH()函数的返回值2.1 示例1:计算字符串

Android kotlin中 Channel 和 Flow 的区别和选择使用场景分析

《Androidkotlin中Channel和Flow的区别和选择使用场景分析》Kotlin协程中,Flow是冷数据流,按需触发,适合响应式数据处理;Channel是热数据流,持续发送,支持... 目录一、基本概念界定FlowChannel二、核心特性对比数据生产触发条件生产与消费的关系背压处理机制生命周期

怎样通过分析GC日志来定位Java进程的内存问题

《怎样通过分析GC日志来定位Java进程的内存问题》:本文主要介绍怎样通过分析GC日志来定位Java进程的内存问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、GC 日志基础配置1. 启用详细 GC 日志2. 不同收集器的日志格式二、关键指标与分析维度1.