Jira Integration

RoostGPT integrates with Jira to pull user stories and requirements directly into the test generation workflow, producing more contextually accurate tests.

How It Works

When you provide a Jira ticket ID during test setup, RoostGPT fetches:

• Issue summary and description
• Acceptance criteria
• Custom fields
• Comments and attachments

This context is passed to the AI model alongside your code or API spec to generate tests aligned with business requirements.

Configuration

See the Ticketing Configuration page for how to connect your Jira account in RoostGPT (Web UI and CLI).

Using Jira in Test Generation

Web UI

When creating a test in the Web UI:

1. Under Business Requirement Source, select Jira
2. Provide:
   • Base URL: https://yourcompany.atlassian.net
   • Email: Your Jira login email
   • API Token: Your Atlassian API token
3. Enter the Ticket ID (e.g., PROJ-1234)
4. RoostGPT fetches and displays the ticket details for confirmation
5. Continue with test configuration

CLI

JIRA_BASE_URL=https://yourcompany.atlassian.net
JIRA_EMAIL=you@yourcompany.com
JIRA_API_TOKEN=your_api_token
JIRA_TICKET_ID=PROJ-1234

# Or via user input file:
ROOST_USER_INPUT_TYPE=file
ROOST_USER_INPUT_FILE=/path/to/jira-export.xml

---

Export a Jira Ticket as XML

If you need to provide a ticket offline (e.g., for the CLI), export it as XML:

Steps

1. Navigate to the Issue — open the Jira issue in your browser (e.g., PROJ-123)

2. Access Export Function — click the Actions menu (⋯) in the top-right corner → Export

3. Choose XML Format — select XML and click Export

4. Save the File — downloads as [PROJECT-KEY]-[ISSUE-NUMBER].xml (e.g., SUPPORT-456.xml)

What's in the XML Export

<rss version="0.92">
  <channel>
    <item>
      <title>[PROJ-123] Issue Summary</title>
      <key>PROJ-123</key>
      <summary>Brief description</summary>
      <description>Detailed description</description>
      <project>Project Name</project>
      <type>Bug/Task/Story</type>
      <status>Open/In Progress/Done</status>
      <assignee>username</assignee>
      <created>Date/Time</created>
      <customfields>...</customfields>
      <comments>...</comments>
    </item>
  </channel>
</rss>

The XML file includes: summary, description, status, priority, assignee, reporter, dates, custom fields, comments, work logs, labels, and issue links.

Troubleshooting

Problem	Solution
Export option missing	Verify you have project Browse permissions
Download fails	Disable browser pop-up blockers; try a different browser
Large file	XML includes all comments and custom fields — expected for busy tickets

---

xRay Integration

If you generate Gherkin feature files via RoostGPT's Functional Test generation, you can upload them to Xray (Jira's test management add-on):

1. Generate a Functional Test in RoostGPT — this produces a .feature file
2. In Jira/xRay, go to Test → Import → Cucumber
3. Upload the .feature file
4. xRay creates a Test entity linked to your Jira ticket

See the xRay integration guide for full details.