环境变量管理:地区、门店与设备动态参数
环境变量用于记录项目中的动态状态,例如当前地区 area、门店 store 或设备 device。它是页面业务参数,不是操作系统环境变量。
创建变量
进入项目「环境变量」新建,填写:
| 字段 | 示例 | 用途 |
|---|---|---|
| 标题 | 当前地区 | 方便管理者识别 |
| 环境变量名 | area | API 模板和组件绑定使用 |
| 环境变量值 | east | 初始选择值 |
建议使用稳定的英文变量名,标题可用中文说明。避免同名变量;组件更新的是已有变量,不能假定填写一个新名称就会自动创建。
在 API 地址中使用
在 API URL 输入模板:
https://api.example.com/sales?area={{ area | default: "all" | url_encode }}
运行接口,确认当前变量值确实进入请求。系统预设的 pid 始终取当前项目 ID,无需自行创建。
修改方式
在管理页面修改值,用于维护项目配置。通过下拉选择或「设置环境变量」事件修改,主要用于当前页面交互;不能把一次页面切换当作已将默认值永久保存到项目设置。
联动验证
先准备两个返回内容不同的变量值,再切换并观察图表。如果变量改变但数据不变,检查 API 地址是否引用了它,当前图表是否绑定到对应 API 数据源。
环境变量面板与相关功能可能受项目授权影响。需要时先确认授权信息。