Connector Specifications
| Specification | Details |
|---|---|
| Repository type | On-Prem |
| Supported content | Work Items |
| RACL support | Yes |
| Content filtering | Yes |
| Automatic permission resolution | Yes |
Prerequisites
An Atlassian account with admin access. This account fetches content and resolves access permissions for indexed content. Search AI uses basic authentication to communicate with the Jira server.Connector Configuration
Go to the Connectors page and add the Jira Server Connector. Provide the following details:| Field | Description |
|---|---|
| Name | Unique name for the connector |
| Username | Username of the Atlassian account |
| Password | Password of the Atlassian account |
| Domain | URL of your Jira server instance |
Content Ingestion
The connector ingests Work Items from Jira. Each work item is indexed with the following fields:| Field | Description |
|---|---|
title | Summary or title of the work item |
content | Full description of the work item |
url | Direct link to the work item in Jira |
doc_created_by_name | Name of the user who created the work item |
doc_created_on | Timestamp when the work item was created (UTC) |
doc_updated_on | Timestamp of the latest update (UTC) |
doc_source_type | Type of content ingested |
priority | Work item priority (High, Medium, Low, etc.) |
status | Work item status (open, closed, etc.) |
assignee | Username of the currently assigned person |
reporter_name | Name of the user who reported the work item |
comments | All comments concatenated, including commenter names |
issueType | Type of work item (Bug, Task, Story) |
resource_type | Type of work item |
project_name | Name of the Jira project |
Note: All timestamps are stored in UTC. Work item comments are concatenated into a single field; individual comment metadata is not indexed.
Content Filtering
The Jira Server connector supports standard and advanced filters to control which content is ingested. On the Manage Content page, select Ingest All Content to ingest everything, or select Ingest Filtered Content and click Configure for selective ingestion.
Standard Filters
Use standard filters to ingest work items from specific projects. Select one or more projects — all work items within those projects are ingested. You can also define a date range using the calendar selector to limit ingestion to a specific time frame.Advanced Filters
Advanced filters provide granular control through field-based rules. Since only Work Items are supported for the Jira server connector, rules apply to work items only. For example, ingest only specific types of work items from a particular project.
Filter Precedence
Advanced filters override standard filters when their criteria conflict. For example, if a standard filter selects Project A and an advanced filter specifies Project B by key, Project B takes precedence.Access Control
Work Items
- Each work item is linked to a project via a unique Project ID.
- This Project ID is stored in the RACL field of the ingested chunks.
- Associate users with a Project ID using the Permission Entity APIs. Users added to the corresponding permission entities gain access to work items associated with those projects.