QTM4J: Get Linked Requirements
qtm4j_get_linked_requirementsRetrieve Jira requirements (stories, bugs) linked to a QTM4J test case to verify traceability and coverage.
Instructions
Retrieve the Jira requirements linked to a specific test case in QTM4J. Test case key is resolved to internal ID automatically.
Toolset: Test Cases
Parameters:
key (string) required: Test case key in '{PROJECT_KEY}-TC-{number}' format (e.g., 'SCRUM-TC-145'). Required.
versionNo (number): Test case version number to retrieve linked requirements for. Defaults to the latest version.
maxResults (number): Maximum results per page (1-100). Default: 50.
startAt (number): Zero-indexed offset for pagination. Default: 0.
sort (string): Sort pattern in 'field:asc|desc' format. Default: 'key:desc'.
Output Description: Paginated list with total, startAt, maxResults, and data array of linked requirement objects (id, key, summary, status, priority, issueType).
Use Cases: 1. Check which Jira stories or bugs a test case covers 2. Audit requirement traceability for a test case 3. Retrieve requirement keys to use in other operations 4. Verify that the correct requirements are linked to a test case before a release
Examples:
Get all requirements linked to a test case
{
"key": "SCRUM-TC-145"
}Expected Output: Paginated list of linked requirements with Jira metadata
Get requirements for a specific version
{
"key": "SCRUM-TC-85",
"versionNo": 2,
"maxResults": 20
}Expected Output: Requirements linked to version 2 of the test case
Hints: 1. PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project. 2. KEY FORMAT: '{PROJECT_KEY}-TC-{number}' — e.g. 'SCRUM-TC-145'. 3. versionNo defaults to the latest version. Use search_test_cases to find available versions. 4. Paginate using startAt — increment by maxResults until startAt >= total.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Test case key in '{PROJECT_KEY}-TC-{number}' format (e.g., 'SCRUM-TC-145'). Required. | |
| sort | No | Sort pattern in 'field:asc|desc' format. Default: 'key:desc'. | |
| startAt | No | Zero-indexed offset for pagination. Default: 0. | |
| versionNo | No | Test case version number to retrieve linked requirements for. Defaults to the latest version. | |
| maxResults | No | Maximum results per page (1-100). Default: 50. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Linked requirements on this page. | |
| total | Yes | Total linked requirements (across all pages). | |
| startAt | Yes | ||
| maxResults | Yes |