入口:总览 → 插件应用 →「业务配置」。由业务配置插件提供,用 Topic 分组维护业务键值。读取需 plugin:read,修改需 plugin:write。
创建 Topic#
- 点击左侧 Topic 标题旁的加号。
- 填写名称,例如
featureFlags,创建后在左侧选择它。 - 名称应表达用途,避免把不同业务都放入无含义的分组。
Topic 是配置分组,不是站点或用户。当前界面没有 Topic 重命名操作。
新增与编辑配置项#
- 选择目标 Topic →「新增配置项」。
- 填写 key,例如
maxRetry,以及 value。 - 核对表单推断的数据类型,点击保存。
- 在列表或「查看 JSON」中检查保存结果。
- 编辑已有行时 key 不可修改;需要换 key 时新增正确项,更新使用方后删除旧项。
| 输入 | 推断结果 |
|---|---|
hello |
字符串 |
123、1.5 |
数字 |
true、false |
布尔 |
{"enabled":true} |
对象 |
["a","b"] |
数组 |
"00123" |
字符串 00123,保留前导零 |
解析失败的 JSON 可能被当作普通字符串保存,保存前必须看类型提示。仅保存键值不会自动给网站增加业务逻辑,需要实际消费该配置的组件或插件。
查找和查看 JSON#
使用字符串、数字、布尔、对象、数组等类型标签筛选,搜索框查询 key 或 value。「查看 JSON」展示当前 Topic 内容,可复制给获准的维护人员。「收起 JSON」恢复表格。
Excel 导入与导出#
- 在目标 Topic 点击「导出」,保留操作前
.xlsx文件。 - 导入文件使用两列:第一列 key,第二列 value。首行使用
key、value最清楚。 - 点击「导入 Excel」,选择
.xlsx或.xls。 - 查看新增与更新数量,核对列表与 JSON。
所有工作表的前两列都会读取并合并到当前同一个 Topic。同 key 会更新,重复 key 后面的值可能覆盖前面的值;未出现在文件中的现有 key 不会因此删除。
Excel 导入对布尔和数值做轻量推断,其余通常保留字符串,不保证对象/数组在 Excel 往返后维持类型。复杂 JSON 配置应在表单中核对类型;把导出当作恢复依据前应先在测试 Topic 验证。
保存的生效范围#
操作会持久化配置并尝试重载已发布 Publisher。没有单独「发布」按钮,但还需要在实际消费配置的页面或业务中测试;Publisher 无法连接时请管理员核对。
删除#
删除配置行只移除该 key;删除 Topic 会删除它下面的全部配置。两种操作都需要确认,界面没有回收站。先导出,再检查依赖业务后操作。
常见问题#
- Topic 列表为空:检查插件与权限,不要默认数据丢失。
- 业务行为没变化:确认使用方读取正确 Topic/key,Publisher 已重载。
- 数字或布尔被当成字符串:检查引号、输入类型与导入后的 JSON。