Skip to main content

Vansah Cucumber Integration

Updated over 2 months ago

Sync Cucumber automation results into Vansah Test Management for Jira.

Keep execution evidence, step outcomes, and run metadata aligned to your Jira-based QA governance.

Supported Cucumber Integrations

Java (Cucumber JVM)

  • Works with Maven/Gradle setups

  • Ideal for Selenium, REST-assured, JUnit/TestNG projects

  • Repo: vansah-cucumber-java (example integration)

Other languages (coming soon)


How it works (same for all languages)

1) Map Cucumber scenarios to Vansah test cases

You tag each scenario with a Vansah Test Case Key so Vansah knows where to post results.

Recommended tag format

  • @TC-<TEST_CASE_KEY>
    Examples:

  • @TC-PROJ-C1

  • @TC-QA-102

2) Run tests normally

You execute via your usual pipeline (local, CI, scheduled runs).

3) Sync results to Vansah automatically

During execution, the integration posts:

  • Scenario result (pass/fail/skip)

  • Optional step-level outcomes

  • Optional evidence (screenshots/attachments)

  • Optional run metadata (environment, sprint, release, build, etc.)


Common setup (applies to every language)

Prerequisites

  • Vansah installed in your Jira site

  • A Vansah Connect token for API authentication

  • Network access from your runner/CI to your Jira/Vansah instance (as required)

Required configuration

Use one consistent configuration pattern across languages:

Required

  • VANSAH_CONNECT_TOKEN (or your token variable name)

  • JIRA_PROJECT_KEY (or Vansah project key / mapping)

  • VANSAH_BASE_URL (if applicable to your deployment)

Optional (recommended)

  • ENVIRONMENT_NAME (e.g., Staging / Prod)

  • RELEASE_NAME (e.g., 1.12.0)

  • SPRINT_NAME

  • BUILD_NUMBER / CI_RUN_ID

Tip: standardize your variable names across integrations so your CI templates are reusable.


Feature matrix (enable per language)

Capability

What you get

Typical toggle

Scenario-level reporting

One result per scenario

Default

Step-level reporting

Each step outcome captured

STEP_LEVEL_REPORTING=true

Evidence on failure

Screenshot/attachment on fail

SCREENSHOT_ON_FAILURE=true

Test plan association

Results grouped under a plan

STANDARD_TEST_PLAN_KEY / ADVANCED_TEST_PLAN_KEY

Folder / suite mapping

Runs organized in Vansah folders

TEST_FOLDER_PATH

Issue linkage

Results linked to Jira issues

JIRA_ISSUE_KEY

Run metadata

Sprint/Release/Environment included

SPRINT_NAME, etc.

Language-specific sections

Java (Cucumber JVM)

Install

  • Add the Vansah integration dependency to your project (Maven/Gradle)

  • Configure environment variables or .env

Tagging

Add the Vansah tag directly to scenarios:

@TC-PROJ-C1 Scenario: Successful login   Given I am on the login page   When I enter valid credentials   Then I should see the dashboard

Run

mvn clean test

Recommended CI usage

  • Store token in secrets

  • Set ENVIRONMENT_NAME, RELEASE_NAME, BUILD_NUMBER in pipeline variables

Did this answer your question?