Cove · 屿里文档中心
下载应用

业务配置

按 Topic 管理键值与类型,查看 JSON、导入导出 Excel。

本页目录

入口:总览 → 插件应用 →「业务配置」。由业务配置插件提供,用 Topic 分组维护业务键值。读取需 plugin:read,修改需 plugin:write。

创建 Topic#

  1. 点击左侧 Topic 标题旁的加号。
  2. 填写名称,例如 featureFlags,创建后在左侧选择它。
  3. 名称应表达用途,避免把不同业务都放入无含义的分组。

Topic 是配置分组,不是站点或用户。当前界面没有 Topic 重命名操作。

新增与编辑配置项#

  1. 选择目标 Topic →「新增配置项」。
  2. 填写 key,例如 maxRetry,以及 value。
  3. 核对表单推断的数据类型,点击保存。
  4. 在列表或「查看 JSON」中检查保存结果。
  5. 编辑已有行时 key 不可修改;需要换 key 时新增正确项,更新使用方后删除旧项。
输入 推断结果
hello 字符串
123、1.5 数字
true、false 布尔
{"enabled":true} 对象
["a","b"] 数组
"00123" 字符串 00123,保留前导零

解析失败的 JSON 可能被当作普通字符串保存,保存前必须看类型提示。仅保存键值不会自动给网站增加业务逻辑,需要实际消费该配置的组件或插件。

查找和查看 JSON#

使用字符串、数字、布尔、对象、数组等类型标签筛选,搜索框查询 key 或 value。「查看 JSON」展示当前 Topic 内容,可复制给获准的维护人员。「收起 JSON」恢复表格。

Excel 导入与导出#

  1. 在目标 Topic 点击「导出」,保留操作前 .xlsx 文件。
  2. 导入文件使用两列:第一列 key,第二列 value。首行使用 key、value 最清楚。
  3. 点击「导入 Excel」,选择 .xlsx 或 .xls。
  4. 查看新增与更新数量,核对列表与 JSON。

所有工作表的前两列都会读取并合并到当前同一个 Topic。同 key 会更新,重复 key 后面的值可能覆盖前面的值;未出现在文件中的现有 key 不会因此删除。

Excel 导入对布尔和数值做轻量推断,其余通常保留字符串,不保证对象/数组在 Excel 往返后维持类型。复杂 JSON 配置应在表单中核对类型;把导出当作恢复依据前应先在测试 Topic 验证。

保存的生效范围#

操作会持久化配置并尝试重载已发布 Publisher。没有单独「发布」按钮,但还需要在实际消费配置的页面或业务中测试;Publisher 无法连接时请管理员核对。

删除#

删除配置行只移除该 key;删除 Topic 会删除它下面的全部配置。两种操作都需要确认,界面没有回收站。先导出,再检查依赖业务后操作。

常见问题#

  • Topic 列表为空:检查插件与权限,不要默认数据丢失。
  • 业务行为没变化:确认使用方读取正确 Topic/key,Publisher 已重载。
  • 数字或布尔被当成字符串:检查引号、输入类型与导入后的 JSON。
遇到问题?查看 后台手册目录,或通过 邮件联系 Cove。

搜索文档

输入关键词,搜索当前范围的文档。