历史版本8 :数据目录文件夹接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

概述编辑

版本

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

功能简介

本文讲解FineBI中「公共数据」下文件夹相关接口。

添加文件夹编辑

接口简介



接口作用添加文件夹
接口URL

/v5/api/pack/{groupId}/add

请求类型GET
注意事项

1）使用该接口添加文件夹时，无法指定文件夹的命名，只能添加默认文件夹

2）groupId为父文件夹ID

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/pack/13dd317974a144f886dbaaec51df46c6/add

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

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

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

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "id": "6b1034a0175b4654a20250a9603933f7",

        "name": "文件夹",

        "initTime": 1767578234321,

        "visible": false,

        "editable": true,

        "usable": true,

        "createBy": "admin",

        "parentId": "13dd317974a144f886dbaaec51df46c6",

        "coopAnalysis": false,

        "creatorAuth": false,

        "folders": [],

        "subjects": [],

        "tables": {},

        "indexes": {},

        "dimensions": {},

        "businessModels": {}

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-07_09-42-01.png

响应参数说明

参数
参数值说明
id创建的文件夹ID
name创建的文件夹名称
initTime创建文件夹的时间
editable

是否可编辑

true：是

false：否

createBy文件夹创建者用户名
parentID文件夹所在父文件夹ID
coopAnalysis是否协作给当前用户

true：是

false：否

creatorAuth
是否拥有和创建者相等的权限

true：是

false：否


重命名文件夹编辑

接口简介



接口作用重命名文件夹
接口URL

/v5/api/pack/{packId}/rename

请求类型GET
注意事项

packId为文件夹ID

请求参数-Query参数

参数名
参数值是否必填
newName业务包新名称是

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/pack/13dd317974a144f886dbaaec51df46c6/rename?newName=银行金融业

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

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

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

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": [],

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-07_09-48-56.png

删除文件夹编辑

接口简介



接口作用删除文件夹
接口URL

/v5/api/pack/delete

请求类型POST
注意事项

与5.X接口不同

请求参数-body参数

body是否必填描述说明

{"packIds":["文件夹ID"]}

是

packIds为待删除的文件夹ID

响应实例



请求链接

http://192.168.101.92:8883/webroot/decision/v5/api/pack/delete

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

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

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

请求body

{

"packIds":["6b1034a0175b4654a20250a9603933f7"]

}

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "success": {

            "tableNames": [],

            "etlTableNames": [],

            "widgetIds": [],

            "reportIds": [],

            "docIds": [],

            "subjectIds": [],

            "packIds": [

                "6b1034a0175b4654a20250a9603933f7"

            ],

            "indexIds": [],

            "dimensionIds": [],

            "businessModelIds": [],

            "biBusinessModelIds": [],

            "modelIndexIds": [],

            "modelDimensionIds": [],

            "modelBusinessModelIds": [],

            "modelTableIds": [],

            "modelIndexFolderIds": [],

            "modelDimensionFolderIds": [],

            "modelBusinessModelFolderIds": [],

            "modelTableFolderIds": [],

            "measureIds": [],

            "modelBusinessFolderIds": []

        },

        "fail": {

            "tableNames": [],

            "etlTableNames": [],

            "widgetIds": [],

            "reportIds": [],

            "docIds": [],

            "subjectIds": [],

            "packIds": [],

            "indexIds": [],

            "dimensionIds": [],

            "businessModelIds": [],

            "biBusinessModelIds": [],

            "modelIndexIds": [],

            "modelDimensionIds": [],

            "modelBusinessModelIds": [],

            "modelTableIds": [],

            "modelIndexFolderIds": [],

            "modelDimensionFolderIds": [],

            "modelBusinessModelFolderIds": [],

            "modelTableFolderIds": [],

            "measureIds": [],

            "modelBusinessFolderIds": []

        },

        "errorDetailBeanMap": {}

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-05_10-11-23.png

获取文件夹信息编辑

接口简介



接口作用获取文件夹信息
接口URL

/v5/api/conf/packs/{packId}/structure

请求类型GET
注意事项

1）packId为文件夹ID

2）与5.X接口不同

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/conf/packs/13dd317974a144f886dbaaec51df46c6/structure

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

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

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

响应成功


callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "id": "13dd317974a144f886dbaaec51df46c6",

        "name": "示例数据",

        "initTime": 1761804371586,

        "visible": false,

        "editable": true,

        "usable": true,

        "createBy": "admin",

        "parentId": "__root_group__",

        "position": "数据目录/示例数据",

        "coopAnalysis": false,

        "creatorAuth": false,

        "folders": [],

        "subjects": [],

        "tables": {},

        "indexes": {},

        "dimensions": {},

        "businessModels": {}

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-05_10-24-58.png

响应参数说明

参数
参数值说明
id文件夹ID
name文件夹名称
initTime文件夹创建时间
editable文件夹是否可编辑
createBy文件夹创建者用户名
parentID文件夹所在父文件夹ID
position文件夹位置信息
coopAnalysis

是否协作给当前用户

true：是

false：否

creatorAuth

是否拥有和创建者相等的权限

true：是

false：否

folders文件夹下子文件夹信息


获取文件夹中表信息编辑

接口简介



接口作用获取文件夹中表信息
接口URL

/v5/api/conf/packs/{packId}

请求类型GET
注意事项

packId为文件夹ID

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/conf/packs/6fb11e7b1e6e4ff3bcb907a5747527b0

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

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

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

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "id": "6fb11e7b1e6e4ff3bcb907a5747527b0",

        "name": "教育培训",

        "initTime": 1727573099210,

        "visible": false,

        "editable": true,

        "usable": true,

        "createBy": "admin",

        "parentId": "2802469f40b14094aa7372ea2488a830",

        "position": "数据目录/行业数据/教育培训",

        "coopAnalysis": false,

        "creatorAuth": false,

        "folders": [],

        "subjects": [],

        "tables": {

            "availableTables": [

                {

                    "name": "d8a353cb33b7445ba20fd29c9c675247",

                    "transferName": "客户跟踪信息2",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1767518035654,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1767518035654,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "direct"

                },

                {

                    "name": "30f2a03bc5f744539a10800b8b369967",

                    "transferName": "产品",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1765941342336,

                    "comment": "234",

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "FRDemo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1765941342336,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "direct"

                },

                {

                    "name": "2bc4819522694110832a030135bb1daf",

                    "transferName": "客户跟踪信息",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1767511624397,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1767513120823,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "BI Demo_教师信息表",

                    "transferName": "教育_2022届教师信息表",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1679328000000,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1767513480637,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "BI Demo_各省招生人数表",

                    "transferName": "各省招生人数表",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1679328000000,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1727573112891,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "BI Demo_学生信息表",

                    "transferName": "教育_学生信息表",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1679328000000,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1727573117406,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "BI Demo_各学院招生人数表",

                    "transferName": "各学院招生人数表",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1679328000000,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1727573128432,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "61a3170bff084f25ac40e57354d8c795",

                    "transferName": "BIDemo_客户跟踪表1",

                    "type": 1,

                    "createBy": "admin",

                    "initTime": 1767510514761,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": false,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "dbTableName": "客户跟踪表",

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1767512561110,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "12bf1c9fd15a4f9f880906a28731e148",

                    "transferName": "客户跟踪信息1",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1767517859713,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1767517859713,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                },

                {

                    "name": "BI Demo_毕业生信息表",

                    "transferName": "教育_毕业生信息表",

                    "type": 2,

                    "createBy": "admin",

                    "initTime": 1679328000000,

                    "comment": null,

                    "validStatus": "VALID",

                    "parentId": "6fb11e7b1e6e4ff3bcb907a5747527b0",

                    "editable": true,

                    "usable": true,

                    "sqlEditable": true,

                    "position": "数据目录/行业数据/教育培训",

                    "publishStatus": 0,

                    "coopAnalysis": false,

                    "creatorAuth": false,

                    "connectionName": "BI Demo",

                    "moduleType": 1,

                    "extractDataSetting": 0,

                    "inherit": false,

                    "belongAnalysis": false,

                    "configUpdateTime": 1727573115029,

                    "activeType": 0,

                    "updateMode": 0,

                    "consanguinityLevel": 1,

                    "consanguinityOverLimit": false,

                    "canSwitchRealtime": false,

                    "dbMode": 0,

                    "engineType": "spider"

                }

            ]

        },

        "indexes": {

            "availableIndexes": []

        },

        "dimensions": {

            "availableDimensions": []

        },

        "businessModels": {

            "availableModels": []

        }

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-05_10-31-42.png


获取公共数据根文件夹信息编辑

接口简介



接口作用获取「公共数据」根文件夹信息
接口URL

/v5/api/conf/groups

请求类型GET

响应实例



请求示例

http://192.168.101.92:8883/webroot/decision/v5/api/conf/groups

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

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

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

响应成功

callback({

    "success": true,

    "code": "200",

    "message": "success",

    "data": {

        "id": "__root_group__",

        "name": "__root_group__",

        "initTime": 0,

        "visible": false,

        "editable": true,

        "usable": false,

        "coopAnalysis": false,

        "creatorAuth": false,

        "folders": [

            {

                "id": "13dd317974a144f886dbaaec51df46c6",

                "name": "示例数据",

                "initTime": 1761804371586,

                "visible": true,

                "editable": true,

                "usable": true,

                "createBy": "admin",

                "parentId": "__root_group__",

                "coopAnalysis": false,

                "creatorAuth": false,

                "folders": [],

                "subjects": [],

                "tables": {},

                "indexes": {},

                "dimensions": {},

                "businessModels": {}

            },

            {

                "id": "de20c13fdcdd436987289588b232c38c",

                "name": "功能数据",

                "initTime": 1727573098213,

                "visible": true,

                "editable": true,

                "usable": true,

                "createBy": "admin",

                "parentId": "__root_group__",

                "coopAnalysis": false,

                "creatorAuth": false,

                "folders": [],

                "subjects": [],

                "tables": {},

                "indexes": {},

                "dimensions": {},

                "businessModels": {}

            },

            {

                "id": "abedc138c4fa49ada7fb8780150fcdc7",

                "name": "配置表",

                "initTime": 1757561576635,

                "visible": true,

                "editable": true,

                "usable": true,

                "createBy": "admin",

                "parentId": "__root_group__",

                "coopAnalysis": false,

                "creatorAuth": false,

                "folders": [],

                "subjects": [],

                "tables": {},

                "indexes": {},

                "dimensions": {},

                "businessModels": {}

            },

            {

                "id": "17bb42b152e3425fa0e2dd827191131a",

                "name": "部门数据",

                "initTime": 1727573098531,

                "visible": true,

                "editable": true,

                "usable": true,

                "createBy": "admin",

                "parentId": "__root_group__",

                "coopAnalysis": false,

                "creatorAuth": false,

                "folders": [],

                "subjects": [],

                "tables": {},

                "indexes": {},

                "dimensions": {},

                "businessModels": {}

            },

            {

                "id": "2802469f40b14094aa7372ea2488a830",

                "name": "行业数据",

                "initTime": 1727573097890,

                "visible": true,

                "editable": true,

                "usable": true,

                "createBy": "admin",

                "parentId": "__root_group__",

                "coopAnalysis": false,

                "creatorAuth": false,

                "folders": [],

                "subjects": [],

                "tables": {},

                "indexes": {},

                "dimensions": {},

                "businessModels": {}

            }

        ],

        "order": []

    },

    "errorCode": null,

    "detailErrorMsg": null,

    "errorMsg": null

})

截图示意2026-01-05_10-41-47.png