历史版本7 :仪表板信息接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

概述编辑

版本

FineBI服务器版本
功能变更
7.0-

功能简介

本文讲解FineBI中仪表板信息相关接口。

获取用户信息和用户创建的仪表板编辑

接口简介



接口作用获取用户信息和用户创建的仪表板
接口URL/v5/api/dashboard/user/info
请求类型GET

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/dashboard/user/info

注：使用接口时需要登录，需要传递token参数。

  • 正式工程推荐配置单点登录，否则嵌入式集成后，需要反复登录

  • 测试阶段可通过「Authorization>Bearer Token」输入 token 值

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "userInfo": {

            "displayName": "admin(admin)",

            "postNames": [],

            "departmentNames": [],

            "customRoleNames": [

                "superusers"

            ],

            "departmentPosts": []

        },

        "dashboards": [

            {

                "reportId": "1474e86a9fa846b68766da93a82bb5c8",

                "name": "淘宝店铺流量分析",

                "initTime": 1660802724185,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "cb401e9554a143ea8b7a7bd135cfdfe9",

                "name": "淘宝店铺流量分析",

                "initTime": 1661312074422,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "fe40b4212bfd4f659e162d40fcf7cf81",

                "name": "住房公积金业务总体情况",

                "initTime": 1568622841142,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "7b489909260045cb8de75f0084156e26",

                "name": "新仪表板",

                "initTime": 1767593854727,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "1ec96bb3e178414f828fb6255531b7f4",

                "name": "仪表板",

                "initTime": 1740626159349,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "dda92cc6849e467a9eea831d0c424f68",

                "name": "工序生产监控",

                "initTime": 1569572628326,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            },

            {

                "reportId": "f2956a466b6c47f29502ccc0534869f5",

                "name": "图表实用场景",

                "initTime": 1660808551876,

                "lastUpdateTime": 0,

                "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                "watermark": true

            }

        ]

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-06_13-38-52.png

发布管理节点所有仪表板信息编辑

接口简介



接口作用获取发布管理节点下的仪表板信息
接口URL/v5/api/dashboard/search
请求类型GET
注意事项使用该接口的用户，必须有发布管理节点权限

请求参数-Query参数

参数名
参数值是否必填
page发布管理的页面页码是
count每页信息数量是

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/dashboard/search?page=2&count=1

注：使用接口时需要登录，需要传递token参数。

  • 正式工程推荐配置单点登录，否则嵌入式集成后，需要反复登录

  • 测试阶段可通过「Authorization>Bearer Token」输入 token 值

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "reportIndexList": [

            {

                "userInfo": {

                    "displayName": "admin(admin)",

                    "postNames": [],

                    "departmentNames": [],

                    "customRoleNames": [

                        "superusers"

                    ],

                    "departmentPosts": []

                },

                "reportIndex": {

                    "reportId": "274aee6161f54f8eaf38ae3414917ab0",

                    "name": "新手入门示例",

                    "initTime": 1767592429688,

                    "lastUpdateTime": 0,

                    "createBy": "621beb84-59b7-412c-b2f3-78a7b7aeab1a",

                    "watermark": true

                }

            }

        ],

        "applyingCount": 0,

        "totalCount": 73

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-06_13-46-50.png

获取主题下的仪表板列表编辑

接口简介



接口作用获取某个主题下的仪表板列表
接口URL/v5/api/platform/dashboard/list
请求类型GET

请求参数-Query参数

参数名
参数值是否必填
subjectId主题ID
是

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/platform/dashboard/list?subjectId=5540f238907b472bbedd7595e0260614

注：使用接口时需要登录，需要传递token参数。

  • 正式工程推荐配置单点登录，否则嵌入式集成后，需要反复登录

  • 测试阶段可通过「Authorization>Bearer Token」输入 token 值

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "name": "地产公司数据监控",

        "editable": true,

        "coopAnalysis": false,

        "creatorAuth": true,

        "tables": {

            "availableTables": []

        },

        "reports": {

            "availableReports": [

                {

                    "name": "地产公司销售监控",

                    "initTime": 1533632466066,

                    "lastUpdateTime": 0,

                    "id": "6aae904df9284bef823921fac05fb247",

                    "createBy": "admin",

                    "shared": false,

                    "publishStatus": 1,

                    "editable": true,

                    "publicLink": {

                        "type": 0,

                        "shared": false,

                        "passProtected": false,

                        "deadline": 0,

                        "exportable": false

                    },

                    "parentId": "5540f238907b472bbedd7595e0260614",

                    "position": "我的分析/行业应用/地产建筑/地产公司数据监控",

                    "coopAnalysis": false,

                    "creatorAuth": true

                },

                {

                    "name": "集团CEO看板",

                    "initTime": 1533289033311,

                    "lastUpdateTime": 0,

                    "id": "e9bf9ea3f0de40d08281ebc9753f4942",

                    "createBy": "admin",

                    "shared": false,

                    "publishStatus": 1,

                    "editable": true,

                    "publicLink": {

                        "type": 0,

                        "shared": false,

                        "passProtected": false,

                        "deadline": 0,

                        "exportable": false

                    },

                    "parentId": "5540f238907b472bbedd7595e0260614",

                    "position": "我的分析/行业应用/地产建筑/地产公司数据监控",

                    "coopAnalysis": false,

                    "creatorAuth": true

                }

            ]

        },

        "docs": {

            "availableDocs": []

        },

        "widgets": {

            "availableWidgets": []

        },

        "biBusinessModels": {

            "availableModels": []

        },

        "customOrder": [],

        "tableCustomOrder": [],

        "customHide": [],

        "parentId": "bcf238bf6c354346863591f0039d7a88"

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-06_13-53-10.png

获取仪表板信息编辑

接口简介



接口作用获取仪表板的信息
接口URL/v5/api/platform/dashboard/reports/info
请求类型GET

请求参数-Query参数

参数名
参数值是否必填描述说明
info{"index":[  { "id":"仪表板ID" }] }注：参数值格式为JSON，使用时需要进行编码 encodeURIComponent()是

id：仪表板ID

响应实例



请求示例

编码前参数值：

{"index":[  { "id":"6aae904df9284bef823921fac05fb247" }] }

编码后参数值：

%7B%22index%22%3A%5B%7B%22id%22%3A%226aae904df9284bef823921fac05fb247%22%7D%5D%7D

链接：

http://192.168.101.92:8883/webroot/decision/v5/api/platform/dashboard/reports/info?info=%7B%22index%22%3A%5B%7B%22id%22%3A%226aae904df9284bef823921fac05fb247%22%7D%5D%7D

注：使用接口时需要登录，需要传递token参数。

  • 正式工程推荐配置单点登录，否则嵌入式集成后，需要反复登录

  • 测试阶段可通过「Authorization>Bearer Token」输入 token 值

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "index": [

            {

                "name": "地产公司销售监控",

                "initTime": 1533632466066,

                "lastUpdateTime": 0,

                "id": "6aae904df9284bef823921fac05fb247",

                "createBy": "admin",

                "shared": false,

                "publishStatus": 0,

                "editable": false,

                "publicLink": {

                    "type": 0,

                    "shared": false,

                    "passProtected": false,

                    "deadline": 0,

                    "exportable": false

                },

                "coopAnalysis": false,

                "creatorAuth": false

            }

        ]

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-06_13-57-12.png

获取仪表板中所有组件信息编辑

接口简介



接口作用获取仪表板中所有组件的信息
接口URL/v5/api/dashboard/report/consanguinity
请求类型GET

请求参数-Query参数

参数名
参数值是否必填
reportId仪表板ID是

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/dashboard/report/consanguinity?reportId=6aae904df9284bef823921fac05fb247

注：使用接口时需要登录，需要传递token参数。

  • 正式工程推荐配置单点登录，否则嵌入式集成后，需要反复登录

  • 测试阶段可通过「Authorization>Bearer Token」输入 token 值

响应成功

注：由于返回的内容过长，此处稍作精简，只保留 widgetId 

{

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "reportId": "6aae904df9284bef823921fac05fb247",

        "reportName": "地产公司销售监控",

        "widgets": [

            {

                "widgetId": "ffcfdc7d9317448197cfadb1d3d1f227",

                "widgetName": "不同产品销售分布",

                "tables": []

            },

            {

                "widgetId": "4c11d91e808d450bb315e4eeea52d761",

                "widgetName": "不同年份房间/合同/标准总价",

                "tables": []

            },

            {

                "widgetId": "23549d648872405989c88c009ced0d41",

                "widgetName": "未命名组件2",

                "tables": []

            },

            {

                "widgetId": "cdf2e3759bac4d7f86f935b2f4bc8eef",

                "widgetName": "不同季度销售趋势",

                "tables": []

            },

            {

                "widgetId": "121e60da8bd44699b66e0ea7c793c901",

                "widgetName": "项目剩余库存面积",

                "tables": []

            },

            {

                "widgetId": "fac6c24a3ab440f5a40a055eb478efda",

                "widgetName": "销售面积总数",

                "tables": []

            },

            {

                "widgetId": "9717dba9f23b4bdd839b2522f6209342",

                "widgetName": "销售明细",

                "tables": []

            },

            {

                "widgetId": "d86364e75b6e447c9b7c327407fa6bb2",

                "widgetName": "项目总数",

                "tables": []

            },

            {

                "widgetId": "0e8fe0d307d847129528f708b925f6e2",

                "widgetName": "省份销售分布",

                "tables": []

            },

            {

                "widgetId": "36417a1ac5184b7f94b982ac78aecd11",

                "widgetName": "不同合同类型分布",

                "tables": []

            },

            {

                "widgetId": "fc1221d2d7484b5da4d107b489a84846",

                "widgetName": "项目销售面积分布",

                "tables": []

            },

            {

                "widgetId": "dadd44db04fd4872bdf701a1a8b636ed",

                "widgetName": "可售面积总数",

                "tables": []

            }

        ]

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

}

截图示意2026-01-06_14-29-08.png