QTM4J: Get Linked Bugs of Test Step Execution
qtm4j_get_linked_bugs_of_test_step_executionRetrieve Jira bugs linked to a specific test step execution and filter by priority or status to identify and resolve step-level defects within a test cycle.
Instructions
Retrieve Jira bugs linked to a test step execution with optional priority and status filtering. Looks up testStepExecutionId from testCycleKey, testCaseKey, and step sequence number; resolves filter names to numeric IDs.
Toolset: Test Executions
Parameters:
testCycleKey (string) required: Test cycle key in the format '{PROJECT_KEY}-TR-{number}', e.g. 'SCRUM-TR-101'. Used directly as the API path parameter.
testCaseKey (string) required: Test case key in the format '{PROJECT_KEY}-TC-{number}', e.g. 'SCRUM-TC-145'.
testStepSeqNo (number) required: sequence number of the test step within the test case (e.g. 2 = the second step).
filter (object): Filter criteria for linked bugs. Omit to return all linked bugs. priority and status names are resolved to numeric IDs; unresolvable names are skipped with a warning.
startAt (number): Zero-based index of the first result to return (pagination offset). (default: 0)
maxResults (number): Maximum number of bugs to return per page. Range 1–100; defaults to 20. (default: 20)
Output Description: JSON object with startAt, maxResults, total, and data array of linked bug objects. Each bug has: id, key, summary, status, priority, issueType, level, stepSeqNo, parameterGroup.
Use Cases: 1. List all Jira bugs linked to a specific test step execution 2. Filter step-level linked bugs by priority or status
Examples:
Get linked bugs for step 2
{
"testCycleKey": "PROJ-TR-101",
"testCaseKey": "PROJ-TC-42",
"testStepSeqNo": 2
}Expected Output: Bugs linked to step 2 of the execution
Filter by priority
{
"testCycleKey": "PROJ-TR-101",
"testCaseKey": "PROJ-TC-42",
"testStepSeqNo": 1,
"filter": {
"priority": [
"High"
]
}
}Expected Output: High-priority bugs linked to step 1
Filter by status
{
"testCycleKey": "PROJ-TR-101",
"testCaseKey": "PROJ-TC-42",
"testStepSeqNo": 1,
"filter": {
"status": [
"In Progress"
]
}
}Expected Output: In Progress bugs linked to step 1
Hints: 1. Call set_project_context before this tool. 2. An empty result (total = 0) means no bugs are linked — it is not an error. 3. priority and status names are resolved to numeric IDs; unresolved names are skipped with a warning. 4. Use get_linked_bugs_of_test_case_execution to retrieve all bugs on the test case execution across all steps.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | No | Filter criteria for linked bugs. Omit to return all linked bugs. priority and status names are resolved to numeric IDs; unresolvable names are skipped with a warning. | |
| startAt | No | Zero-based index of the first result to return (pagination offset). | |
| maxResults | No | Maximum number of bugs to return per page. Range 1–100; defaults to 20. | |
| testCaseKey | Yes | Test case key in the format '{PROJECT_KEY}-TC-{number}', e.g. 'SCRUM-TC-145'. | |
| testCycleKey | Yes | Test cycle key in the format '{PROJECT_KEY}-TR-{number}', e.g. 'SCRUM-TR-101'. Used directly as the API path parameter. | |
| testStepSeqNo | Yes | sequence number of the test step within the test case (e.g. 2 = the second step). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Linked bugs on the current page; empty when total is 0. | |
| total | Yes | Total number of linked bugs matching the filter across all pages. 0 means none are linked. | |
| startAt | Yes | Zero-based index of the first item in this page. | |
| maxResults | Yes | Page size applied to this response. |