QTM4J: Get Linked Requirements for Test Cycle
qtm4j_get_linked_requirements_for_test_cycleRetrieve linked Jira requirements for a test cycle to audit traceability and verify coverage before release.
Instructions
Retrieve Jira requirements linked to a QTM4J test cycle. Test cycle key is resolved to internal UID automatically.
Toolset: Test Cycles
Parameters:
cycleKey (string) required: Test cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically.
maxResults (number): Maximum results per page (1-100). Default: 50. (default: 50)
startAt (number): Zero-indexed offset for pagination. Default: 0. (default: 0)
sort (string): Sort pattern in 'field:asc|desc' format. Allowed fields: key, status, priority. Default: 'key:desc'.
Output Description: Paginated result 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 are covered by a test cycle 2. Audit requirement traceability for a test cycle 3. Retrieve requirement keys linked to a cycle before a release 4. Verify correct requirements are linked to a test cycle
Examples:
Get all requirements linked to a test cycle
{
"cycleKey": "SCRUM-TR-1"
}Expected Output: Paginated list of linked requirements with Jira metadata
Get requirements sorted by priority with custom page size
{
"cycleKey": "SCRUM-TR-5",
"sort": "priority:asc",
"maxResults": 20
}Expected Output: Requirements linked to cycle sorted by priority ascending
Hints: 1. PREREQUISITE: set_project_context must be called before this tool. NEVER auto-select a project. 2. CYCLE KEY FORMAT: '{PROJECT_KEY}-TR-{id}' — e.g. 'SCRUM-TR-1'. Resolved to internal UID automatically. 3. Allowed sort fields: key, status, priority. Default sort: 'key:desc'. 4. Paginate using startAt — increment by maxResults until startAt >= total.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort pattern in 'field:asc|desc' format. Allowed fields: key, status, priority. Default: 'key:desc'. | |
| startAt | No | Zero-indexed offset for pagination. Default: 0. | |
| cycleKey | Yes | Test cycle key in '{PROJECT_KEY}-TR-{id}' format (e.g., 'SCRUM-TR-1'). Resolved to the internal cycle UID automatically. | |
| 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 |