Skip to main content

Add and Index Jira Data Source

Connect and index Jira projects as data sources.

Jira is a powerful project management and issue tracking data source in AI/Run CodeMie, enabling assistants to access project information, track issues, and manage tasks. This guide walks you through the process of adding and indexing Jira projects.

Prerequisites​

Required Integration

This data source requires you to have at least one Jira integration added to AI/Run CodeMie. For more details, please refer to the Integrations Overview guidelines.

Before adding a Jira data source, ensure you have:

  • Configured Jira integration with API token or personal access token
  • Access to the Jira project you want to index
  • Appropriate permissions to read Jira issues
  • Knowledge of JQL (Jira Query Language) for filtering
JQL Required

Jira data sources require a valid JQL query. Test your JQL in Jira before adding the data source to avoid indexing errors.

Adding a Jira Data Source​

To add Jira as a data source with AI/Run CodeMie platform, follow these detailed steps:

Jira Data Source Form

Step-by-Step Process​

1. Preparation​

Before adding a new Jira data source, you need to generate integration with Jira on the Integration tab.

How to create a Jira integration:

  • Navigate to the Integrations section
  • Add a new Jira integration
  • Provide your Jira URL and API token
  • Save the integration for use in data sources

Refer to the Integrations Overview guidelines for detailed integration setup instructions.

2. Navigate to Data Sources​

Navigate to the Data Sources section in AI/Run CodeMie.

3. Create New Data Source​

Click the + Create Datasource button and add all required data according to recommendations.

4. Select Source Type​

  • Select Project: Select the name of the project with which you want to associate that DataSource.
  • Name: Alias for file for quick search in datasource list.
  • Description: Description for this datasource
  • Choose Datasource Type: Jira source type in the add new data source window.
  • JQL Query: Add JQL expressions to filter the data you want to index. This field is required.
  • Select integration for Jira: Choose integration.

Common JQL Example:

project = "projectKey" AND assignee = "John Doe"
JQL Quick Start
  • Use project = KEY to index entire projects
  • Add AND status != Done to exclude completed issues
  • Use AND created >= -30d to index recent issues only

This example filters:

  • Issues in the projectKey project
  • Assigned to John Doe
JQL Resources

For more information on writing JQL expressions, refer to the Atlassian JQL documentation.

Error Handling for Jira Data Sources​

Common Errors​

Incorrect JQL Expression​

Symptom: Error message appears at the top of the Add data source window

Jira JQL Error

Cause: The JQL expression syntax is invalid or references non-existent projects/fields

Solutions:

  1. Verify JQL syntax is correct
  2. Check that project keys are spelled correctly
  3. Ensure field names exist in your Jira instance
  4. Test JQL in Jira search before using in AI/Run CodeMie
  5. Simplify complex expressions to identify the issue

Example of common JQL mistakes:

# ❌ Incorrect - Project key without quotes when containing spaces
project = My Project AND type = Bug

# ✅ Correct - Project key with quotes
project = "My Project" AND type = Bug

# ❌ Incorrect - Invalid field name
project = projectKey AND issueType = Bug

# ✅ Correct - Valid field name
project = projectKey AND type = Bug

# ❌ Incorrect - Wrong operator
project = projectKey AND status EQUALS "In Progress"

# ✅ Correct - Correct operator
project = projectKey AND status = "In Progress"
Common JQL Operators
  • = : equals
  • != : not equals
  • IN : matches any value in a list
  • >, <, >=, <= : comparison operators
  • ~ : contains (text search)

Expired Authorization Token​

Cause: The API token used in the Jira integration has expired or been revoked

Solutions:

  1. Navigate to the Integrations section
  2. Locate your Jira integration
  3. Generate a new API token in Jira
  4. Update the integration with the new token
  5. Retry creating the data source

Connection Timeout​

Cause: Cannot establish connection to Jira server

Solutions:

  • Check network connectivity to Jira
  • Verify Jira URL is correct in integration
  • Ensure Jira server is accessible
  • Review firewall settings
  • Try again after a few minutes

Permission Denied​

Cause: Insufficient access to Jira project or issues

Solutions:

  • Verify integration has read access to the project
  • Check Jira project permissions
  • Ensure API token has appropriate scopes
  • Request access from Jira project administrator

Now your Jira projects are configured as data sources and ready to enhance your assistants with project and issue tracking knowledge.