lab34-flows

Integrations

Jira / Xray

Link a flow to a Test issue, and pull the tests of a project.

A flow maps to an Xray Test issue, and every step block to a step of that test. The link is declared in the flow itself, so it travels with the document:

---
title: Fraud detection
xray:
  testKey: BOP-1234
---

testKey can also be set inside a step block; that one is informative for now.

Configure it in Settings › Xray. Three flavours are supported:

  • Xray Cloud — data comes from Xray's API, authenticated with an API key you create in Jira at Apps › Xray › API Keys (client id + client secret). Keep the default Xray URL unless your instance uses a regional endpoint (https://eu.xray.cloud.getxray.app, https://us.xray.cloud.getxray.app).
  • Jira Cloud (API token) — for when you cannot get an Xray API key (it needs Jira admin rights): the data is read from Jira with your email and an Atlassian API token, created at id.atlassian.com › Security › API tokens. Xray-only data, like the test type, is not available this way.
  • Jira Server / Data Center — no external service: the data is read from Jira with a personal access token, created at your profile › Personal Access Tokens.

Test connection validates the credentials for real. Nothing is downloaded until a flow that mentions a test key is rendered, and every key is downloaded at most once per run of the tool.

Pull tests downloads every Test of the project into an xray folder in your flows — one Markdown document per test, with the Jira description as its content and no step blocks yet. With an Xray API key (Cloud) or on Server/DC the folders mirror the Test Repository; with a Jira API token there is no Test Repository to read, so they are rebuilt from Jira's hierarchy:

xray/<FEATURE>_<slug>/<STORY>_<slug>/<TEST>_<slug>.md

A test that is a child of nothing gets its feature and story from its related work — the issue links — and whatever cannot be resolved lands in _no-feature / _no-user-story. Pulling again rewrites only the frontmatter and the description block: the steps you wrote stay, a test that moved in Jira is moved rather than duplicated, and nothing is ever deleted.

Uploading executions back to Xray is not supported yet: nothing this integration does ever writes to Jira.

When Jira cannot be reached, the key is shown as plain text with the error on hover — a flow never fails to render, or to run, because of Jira.