数据变量

数据变量用于处理“本次运行才知道”的业务数据。例如创建订单后生成订单号，后续再用这个订单号查询、选择或断言结果。

基本流程是：

保存页面值为变量
  -> 后续步骤使用 {{变量名}}
  -> 回放时解析为本次运行实际值

适用场景

常见用途包括：

场景	示例
创建后查询	创建项目后保存项目名，再在搜索框中输入 {{projectName}}
业务编号流转	提交订单后保存订单号，再查询订单详情
下拉选择	保存页面生成的数据源名称，再在后续下拉框选择 {{sourceName}}
动态断言	保存发布批次号，断言结果文本包含 {{releaseCode}}
表单复用	从页面读取一个值，后续填入另一个表单

变量适合表达业务数据依赖，不适合替代元素定位。如果目标元素本身找不到，仍应优先维护选择器或重新录制该段。

保存变量

录制时可以通过“保存页面值为变量”把当前页面元素的文本或值保存为变量。

保存时需要配置：

字段	说明
变量名	后续通过 {{变量名}} 引用。
抽取来源	当前选中的页面元素。
抽取方式	完整值、智能抽取或正则匹配。

变量名建议使用英文、数字和下划线，例如 orderId、projectName、source_name。变量名应能表达业务含义，避免使用 test、a 这类不易维护的名称。

变量名保存时会做校验：

• 只能使用字母、数字和下划线，且不能以数字开头。
• 同一条用例中重复变量名会提示覆盖风险。
• 变量需要先定义再引用；如果某个步骤引用了后面才定义的变量，保存或回放前会提示。

抽取方式

完整值

直接保存元素的完整文本或输入值。

适合页面已经只展示目标值的情况，例如：

ORD-2048

智能抽取

用自然语言描述想要的片段，由 CueCast 生成正则规则和捕获组。

例如原始文本是：

订单已提交：ORD-2048

可以输入：

只取订单号

系统会生成对应抽取规则。生成后建议查看规则预览，确认本次抽取值是否符合预期。

正则匹配

适合对文本结构较熟悉的用户。可以配置正则和捕获组。

例如：

jobgroupdwln0f3i（并行）

如果只想取括号前的编码，可以使用：

^(.+?)（

捕获组选择 1，表示取第一对括号 (...) 匹配到的内容。

正则规则保存时会做基本安全校验。过于复杂、容易造成长时间匹配的表达式会被拦截，避免回放时因为灾难性回溯拖慢执行。

使用变量

后续步骤中可以在输入值、断言值、css、xpath 等字段使用变量：

{{orderId}}
项目：{{projectName}}
发布批次 {{releaseCode}} 已完成

回放时，CueCast 会把模板替换为当前运行时变量值。

支持引用变量的常见位置包括：

• 输入步骤的输入值。
• 下拉选项文本。
• 文本断言或 JSON 断言的期望值。
• 智能步骤的自然语言指令。
• 部分 CSS / XPath 定位字段。

如果变量为空、未定义或拼写错误，回放前会进行预检；执行中失败时，错误信息会尽量展示“替换前模板”和“替换后值”，帮助判断是变量问题还是页面定位问题。

用例详情与报告中的变量信息

在用例详情中，保存变量步骤会展示变量名和抽取方式，便于维护人员知道这一步沉淀了什么数据。

在执行详情中，如果某一步使用了变量，可以结合失败信息查看本次运行时变量解析后的值。例如下拉项未找到时，系统会提示变量实际解析成了什么，避免只看到 {{orderId}} 这类模板而不知道本次真实值。

回放前变量预检

回放前会检查当前用例里的变量依赖：

• 引用了不存在的变量。
• 变量名拼写不一致。
• 变量定义在引用步骤之后。
• 变量链路无法解析。

如果发现明显错误，系统会在执行前提示或阻断，避免跑到一半才因为变量缺失失败。

维护建议

• 优先保存业务稳定值，例如订单号、项目名、任务名。
• 不要保存整行大段文本，除非后续使用智能抽取或正则提取片段。
• 变量名保持唯一且有业务含义。
• 抽取失败时先看原始值是否变化，再检查规则是否过窄。
• 下拉选择失败时，重点检查变量是否解析为空、解析值是否和下拉项一致。