变量管理

AngusTester变量管理模块实现测试数据的集中管理和动态调用，支持多种数据源提取方式，提升测试灵活性和数据复用率。

一、变量创建操作

1. 添加静态变量

操作说明：定义固定值或Mock数据函数
操作步骤：

1. 数据 → 变量 点击「添加静态变量」
   
2. 配置关键参数：
   • 名称格式：大写英文_描述（如API_TOKEN）
   • 值类型：
     • 常量（直接输入）
     • Mock函数（如${randomPhone}）
   • 勾选「密码类型」加密敏感数据
     
3. **预览**标签调试输出效果
   
   ⚠️ Mock函数每迭代更新一次

2. 添加文件提取变量

操作说明：从外部文件动态提取数据
操作步骤：

1. 添加静态变量▼ 选择「文件提取变量」
2. 配置提取规则：
   • 文件路径（支持CSV/TXT）
   • 起始位置（行号+列号索引）
   • 数据处理（正则提取/JSONPath）
     
3. **预览**验证数据提取准确性
   
   ❗ 文件变更需手动刷新变量

3. 添加Http提取变量

操作说明：通过API接口获取动态值
操作步骤：

1. 添加静态变量▼ 选择「Http提取变量」
2. 配置请求参数：
   • URL（完整接口地址）
   • 方法（GET/POST）
   • 提取器（JSONPath/XPath）
     
3. **预览**测试接口返回值
   
   ⚠️ 需网络可达且接口可用

4. 添加Jdbc提取变量

操作说明：从数据库查询结果生成变量
操作步骤：

1. 添加静态变量▼ 选择「Jdbc提取变量」
2. 配置数据库连接：
   • 数据源（需先配置数据源）
   • SQL查询（SELECT字段）
   • 取值规则（首行首列/行号列号）
     
     ❗ 敏感字段需加密存储

二、变量维护管理

1. 批量导入变量

操作说明：通过YAML文件批量配置
操作步骤：

1. 变量 点击「导入」
2. 上传YAML格式文件
3. 系统自动：
   • 校验格式有效性
   • 执行覆盖/跳过策略
     ⚠️ 文件需符合变量字段规范

2. 克隆变量

操作说明：快速创建相似变量
操作步骤：

1. 变量列表 点击「克隆」
2. 系统自动：
   • 生成副本（名称追加"-Copy.xxx"）
   • 保留所有配置
     需手动调整关键参数

3. 编辑变量

操作说明：修改已有变量配置
操作步骤：

1. 变量列表 点击「编辑」
2. 可修改字段：
   • 名称/描述
   • 值或提取规则
   • 密码类型开关
     生效中变量修改需重新发布

4. 批量删除

操作说明：清理废弃变量
操作步骤：

1. 勾选目标变量
2. 点击「批量删除」
3. 二次确认操作
   ❗ 关联接口的变量需先解除引用

三、变量应用集成

1. 接口参数化引用

操作说明：在接口请求中动态调用变量
操作步骤：

1. 接口 → 服务管理 打开目标接口
2. **参数化**标签点击「引入变量」
   
3. 参数值填写{变量名}
   
   ⚠️ 未关联变量显示红色警告

2. 场景参数化引用

操作说明：在测试场景中批量使用变量
操作步骤：

1. 场景管理 打开目标场景
2. **执行配置 → 变量**添加引用
3. 步骤参数填写{变量名}
   ❗ 跨接口变量需保持命名一致

四、数据导出管理

1. 导出单个变量

操作说明：备份或分享变量配置
操作步骤：

1. 变量详情页 点击「导出」
2. 选择格式：
   • YAML（完整配置）
   • JSON（API集成格式）

2. 导出所有变量

操作说明：全量备份变量体系
操作步骤：

1. 变量管理 点击「导出」
2. 自动下载ZIP压缩包
3. 包含：
   • 所有变量YAML文件
   • 导入说明文档

变量字段信息

参数	字段名	类型	必填	长度限制	说明
ID	id	bigint	条件	/	唯一标识符； 系统自动生成； 修改时必须
项目ID	projectId	long	是	/	所属项目唯一标识
变量名称	name	string	是	≤100	变量唯一标识名称
描述	description	string	否	≤800	变量功能描述
变量值	value	string	条件	≤4096	变量值， 非提取类型时必须
密码类型	passwordValue	boolean	是	/	是否为密码类型值
提取规则	extraction	object	否	/	数据提取规则配置
是否已提取	extracted	boolean	只读	/	数据是否已完成提取
数据来源	dataSource	enum	只读	/	数据来源枚举： 静态值/值提取/文件提取/Http提取/Jdbc提取
租户 ID	tenantId	long	只读	/	所属租户 ID
创建人ID	createdBy	long	只读	/	变量创建人ID
创建人姓名	createdByName	string	只读	/	创建人姓名
创建时间	createdDate	datetime	只读	/	变量创建时间
最后修改人ID	lastModifiedBy	long	只读	/	最后修改人ID
最后修改人姓名	lastModifiedByName	string	只读	/	最后修改人姓名
最后修改时间	lastModifiedDate	datetime	只读	/	最后修改时间

提取配置（extraction）

请查看测试规范：参数化 -> 提取配置

数据来源（dataSource）

枚举值	说明
STATIC_VALUE	静态值
EXTRACT_VALUE	值提取
EXTRACT_FILE	文件提取
EXTRACT_HTTP	Http提取
EXTRACT_HTTP_SAMPLING	Http采样提取
EXTRACT_JDBC	Jdbc提取