平台设置

平台设置用于统一管理平台级开关和基础配置，包括指标/维度编码、用户组编码、公告展示、目录展示和文件解密。部分设置会影响已创建资产、菜单展示或已集成的 API，请在变更前评估影响范围。

功能入口

在顶部导航栏进入管理设置，在左侧菜单中选择平台设置 > 平台设置。

设置项总览

设置项	作用
启用指标/维度编码	为指标和维度启用唯一编码，并配置 API 使用编码或名称标识。
启用用户组编码	为自定义用户组启用唯一编码。
启用公告展示	允许用户在系统中查看重要公告和通知。
启用目录展示	在管理设置中展示各类资产的类目配置菜单。
启用文件解密	上传加密文件时，调用已配置的解密服务处理文件。

前提条件：需要具备平台配置管理权限，才可以修改平台级配置。

指标/维度编码

启用后，创建或编辑指标、维度时需要填写或生成唯一编码。编码可用于 API 标识，也便于在系统内进行检索和集成。

启用编码

1. 打开启用指标/维度编码开关。
2. 在展开的配置区域中选择 API 接口使用指标/维度编码还是指标/维度名称作为标识。
3. 填写指标日期（metric_time）维度编码。
4. 选择编码命名方式并完成必要配置。
5. 单击保存使配置生效。

配置 API 接口标识

API 接口标识决定 API 查询中使用编码还是名称识别指标和维度：

选项	说明
指标/维度编码	API 请求使用资产编码作为标识。适合需要稳定、无歧义标识的集成场景。
指标/维度名称	API 请求使用资产名称作为标识。该方式为系统默认方式。

metric_time是系统内置的时间维度。配置其编码时，请使用字母、数字或下划线，且不要使用连续下划线。

注意：变更 API 接口标识、指标日期维度编码或编码命名方式，可能导致已集成的 API 查询失效。系统会在保存前提示确认，请在变更后及时更新调用方配置。

选择编码命名方式

方式	说明
手动命名（默认）	创建指标或维度时，由维护人员手动填写唯一编码。
自动命名	平台根据模板自动生成指标和维度编码。

使用自动命名时，分别配置指标编码模板和维度编码模板。模板支持英文字母、数字、下划线以及自增序列占位符{$num_N}，其中N为序列位数，范围为 1～12；每个模板只能包含一个该占位符。页面会实时展示生成编码的预览。

停用编码

关闭启用指标/维度编码前，系统会提示风险。停用后，平台会删除已生成的指标和维度编码，API 查询会切换为名称模式。请确认外部系统不再依赖编码后再继续操作。

用户组编码

打开启用用户组编码开关后，自定义用户组需要填写唯一编码，可用于稳定识别用户组。

关闭该开关后，平台不再使用用户组编码。建议在停用前检查是否有接口、同步任务或外部系统依赖该编码。

公告展示

打开启用公告展示开关后，用户可以在系统中查看重要公告和通知信息；关闭后，系统不再展示公告。

适合在需要统一发布平台公告、版本通知或重要提示的租户中启用。

目录展示

打开启用目录展示开关后，管理设置中会显示指标、维度、数据集、指标视图、物化方案等资产的类目配置菜单。

关闭后，上述类目菜单将隐藏，但已有类目数据不会删除；重新开启后，原有类目数据仍可见。

文件解密

文件解密用于在上传加密文件时调用外部解密服务。解密成功后的文件可以在平台中预览和保存。

启用并配置解密服务

1. 打开启用文件解密开关。
2. 填写解密服务地址，地址需以http://或https://开头。
3. 填写需要解密的文件后缀。多个后缀使用英文逗号分隔，例如xlsx,xls,csv。
4. 根据服务性能设置高级参数：连接超时、读取超时和失败重试次数。
5. 单击测试连接验证服务是否可用。
6. 测试通过后，单击保存配置。

高级参数说明

参数	可配置范围	说明
连接超时	1～300 秒	建立与解密服务连接的最长等待时间。
读取超时	1～600 秒	等待解密服务返回结果的最长时间。
失败重试	0～10 次	解密请求失败后的重试次数。

重置仅清空当前未保存的解密服务配置，并恢复高级参数默认值；已保存的配置不会因此被删除。关闭文件解密时，系统会要求确认，并停止调用解密服务。