Skip to main content

Jira Integration

TestChimp integrates with Jira to keep your testing workflow synchronized with your project management.

Connecting Jira​

Initial Setup​

  1. Navigate to Integrations → Jira
  2. Click "Connect Jira"
  3. Follow the authentication flow
  4. Select your Jira instance (Cloud or Server)
  5. Authorize TestChimp to access your Jira account
  6. Select the Jira project to connect

Configuration​

After connecting, configure:

  • Project mapping: Map TestChimp projects to Jira projects
  • Issue type mappings: Configure how TestChimp items map to Jira issue types
  • Field mappings: Map TestChimp fields to Jira custom fields

Importing User Stories​

Import Process​

  1. Navigate to User Stories section
  2. Click the dropdown next to "Add New"
  3. Select "Import from Jira"
  4. Choose the Jira project and filter criteria
  5. Select the user stories to import
  6. Click "Import"

Working with Imported Stories​

Imported user stories can be:

  • Enhanced with TestChimp AI: Use TestChimp to add detailed requirements
  • Tested with ExploreChimp: Generate test plans and run explorations
  • Exported back to Jira: Sync changes back to Jira

Exporting/Syncing User Stories​

Export Process​

  1. Select the user stories you want to export
  2. Click "Export to Jira" (appears when stories are selected)
  3. Choose export options:
    • Create new issues or update existing ones
    • Select issue type (typically "Story")
    • Map fields
  4. Click "Export"

Sync Behavior​

  • New stories: Created as new Jira issues
  • Existing stories: Updated if they were previously exported
  • Links preserved: Relationships between stories and test scenarios are maintained

Exporting Bugs​

Export Process​

  1. Navigate to the Bugs List Viewer (from the main navigation)
  2. Select the bugs you want to export from the list
  3. Click "Export to Jira" (appears when bugs are selected)
  4. Configure export:
    • Select issue type (typically "Bug")
    • Choose export mode (skip existing, replace existing, etc.)
    • Map bug fields to Jira fields
  5. Click "Export"

Exporting Bugs as CSV​

  1. Navigate to the Bugs List Viewer
  2. Select the bugs you want to export
  3. Click "Export as CSV" (appears when bugs are selected)
  4. The CSV file will be downloaded with bug details including:
    • Bug ID, Title, Description
    • Category, Severity
    • Screen and Screen State
    • Session Link, Environment
    • Created At timestamp

Bug Details in Jira​

Exported bugs include:

  • Bug description: Full description from TestChimp
  • Bug type: Type of bug (UX, Performance, Security, etc.)
  • Screen-state context: Where the bug was found
  • Screenshots and artifacts: Visual evidence
  • Severity: Bug severity level

Exporting Test Scenarios​

Export Process​

  1. Navigate to the Test Scenarios List Viewer (from the main navigation)
  2. Select the test scenarios you want to export from the list
  3. Click "Export to Jira" (appears when scenarios are selected)
  4. Configure export:
    • Custom issue type: Jira doesn't have a native test scenario type, so you'll need to define one
    • Choose export mode (skip existing, replace existing, etc.)
    • Map scenario fields to Jira fields
  5. Click "Export"

Exporting Test Scenarios as CSV​

  1. Navigate to the Test Scenarios List Viewer
  2. Select the test scenarios you want to export
  3. Click "Export as CSV" (appears when scenarios are selected)
  4. The CSV file will be downloaded with scenario details including:
    • Scenario ID, Title, Expected Behaviour
    • Steps, Priority
    • Screen Name, Screen State
    • Status, Test Results

Linking to User Stories​

If a test scenario is attached to a user story:

  • A story type issue is created (or updated if it already exists)
  • The scenario issue is linked to the user story issue
  • Relationships are preserved in Jira

Confluence Integration​

If Confluence is set up in your Jira account, TestChimp can leverage Confluence documents:

Fetching Confluence Docs via Jira Integration​

  1. The Jira integration automatically detects if Confluence is available
  2. Confluence documents are accessible through the Jira integration
  3. No separate Confluence setup is required

Using Confluence Docs in Context Windows​

When authoring user stories or creating test plans:

  1. Open the Context Window
  2. Click "Add Context"
  3. Select "Confluence Documents"
  4. Browse and select Confluence documents
  5. Documents are included in the context for AI-powered authoring

Using Confluence Docs for User Story Authoring​

Confluence documents provide rich context for user story authoring:

  • Requirements documents: Include product requirements from Confluence
  • Design specs: Add design specifications
  • API documentation: Include API docs for technical stories
  • User research: Add user research findings

Using Confluence Docs for Test Planning​

Confluence documents enhance test plan generation:

  • Test strategy documents: Include overall testing strategy
  • Feature documentation: Add feature specifications
  • Acceptance criteria: Include detailed acceptance criteria
  • Business rules: Add business logic and rules

The Jira integration (with Confluence support) keeps your testing workflow synchronized with your project management, ensuring everyone stays on the same page.