如何获取Scenario Outline的Example ID以更新XRay测试用例状态

1. 借助Cucumber官方API（推荐） #

Cucumber原生提供了访问示例元数据的能力，无需依赖内部私有结构，不同语言实现如下：

Java 版本（Cucumber 4+） #

通过@Before钩子结合TestCase对象获取索引：

import io.cucumber.java.Before;
import io.cucumber.plugin.event.TestCase;

public class ScenarioHooks {
    private int currentExampleIndex;

    @Before
    public void captureExampleIndex(TestCase testCase) {
        // 示例索引从0开始，非Scenario Outline场景返回-1
        currentExampleIndex = testCase.getExampleIndex().orElse(-1);
    }

    // 在步骤方法中直接使用该索引
    public void loginStep() {
        String xrayRequest = String.format(
            "PUT %s/rest/raven/2.0/api/testrun/%s/example/%d?status=PASS",
            JIRA_BASEURL, TR2_ID, currentExampleIndex
        );
        // 执行XRay API请求逻辑
    }
}

TestCase.getExampleIndex()会返回Optional<Integer>，精准对应Examples块中的行顺序索引。

Python 版本（behave框架） #

通过context对象获取当前示例的行索引：

def before_scenario(context, scenario):
    if scenario.scenario_outline:
        # 定位当前示例行在Examples表格中的索引（从0开始）
        context.example_index = scenario.scenario_outline.examples[0].table.rows.index(scenario.table_row)

# 步骤中使用索引
@given('I login with the user "{user}" in site')
def step_impl(context, user):
    xray_request = f"PUT {JIRA_BASEURL}/rest/raven/2.0/api/testrun/{TR2_ID}/example/{context.example_index}?status=PASS"
    # 发送API请求

2. 手动添加索引列（最直观方案） #

如果不想依赖框架API，可以直接在Examples表格中新增索引列，手动指定对应值：

Feature: Login feature example

Scenario Outline: Login Test
  When I login with the user "<user>" (example index: <index>) in site

Examples:
  |user       |index|
  |validUser  |0    |
  |invalidUser|1    |

在步骤方法中直接接收<index>参数即可，这种方式完全避免了框架依赖，并行执行时也不会出现计数混乱的问题。

不建议访问内部私有结构的原因 #

你提到的内部数据结构属于Cucumber的私有实现细节，不同版本的框架可能会修改这些结构，导致代码在版本升级后直接失效，同时这种写法可读性极差，维护成本很高，官方明确不推荐此类用法。

内容的提问来源于stack exchange，提问作者j.barrio