Skip to content

YouTrack Connector

YouTrack is a project management and issue tracking tool, primarily designed to streamline software development and agile workflows.

Specifications

Type of Repository Cloud
Content Supported Projects, Issues , Knowledge Articles
RACL Support Yes
Automatic Permission Entities Resolution Yes
Content Filtering No

To integrate YouTrack account with Search AI and ingest content from the account, take the following steps:

  • Generate Permanent Access Token in YouTrack
  • Configure the YouTrack connector in Search AI

Generate Permanent Access Token

YouTrack connector interacts with YouTrack via the REST APIs. To enable this communication, Search AI uses a Permanent Token Authorization. Follow the steps listed below to generate this token on YouTrack.

  1. Go to the Account Security tab under the Profile page.
  2. Click on New Token under Tokens. Token Generation
  3. Give a name for the token and save the generated token. Token Generation

Configure YouTrack Connector in Search AI

Go to the Authorization page of the connector, provide the following configuration fields, and click Connect.

  • Name- Unique name for the connector.
  • Authorization Type- Set this to Token.
  • Permanent Token- Provide the API Token here.
  • Host URL - The base URL of the YouTrack service.
  • Content Type - YouTrack supports ingesting knowledge articles and issues from the projects. Select the appropriate content type.

Ingesting Content

After successfully connecting the Search AI connector to the YouTrack account, go to the Configuration tab and set up content synchronization. For immediate sync, use the Sync Now option and the Schedule Sync option to set up a scheduler to sync the content in the future.

Upon sync, Search AI ingests Issues and Knowledge Articles from Projects in YouTrack.

The ‘type’ field in the ingested content suggests whether the data is an issue or an article in the project. For the issues, Search AI ingests all the properties of the issue as meta data in the application. The description and comments are added to the content field. Similarly, for articles, the properties of the article are ingested as metadata and the description and comments are ingested into the content field to facilitate search on these fields.

Filtering Content

SearchAI enables selective ingestion of content from the YouTrack application, allowing you to sync issues and knowledge articles from specific projects.

To configure selective content ingestion, follow these steps:

  1. Navigate to Configurations tab in the connector interface.
  2. Click on the Sync Specific Content option and select the Configure link.
  3. Select Projects:
    • On the configuration page, you’ll see a list of all projects available in your YouTrack account.
    • Select the projects you want to ingest content from.
  4. Save Changes:
    • After selecting the desired projects, click Save to apply the changes.

Note: The configured filters will take effect during the next synchronization cycle. Ensure that the sync is scheduled or triggered to reflect the updates.

RACL Support

  • SearchAI supports access control for content ingested from YouTrack accounts at the project level.
  • In YouTrack, both issues and articles are linked to a specific project through a unique Project ID.
  • When this content is ingested into SearchAI, the Project ID is stored in the sys_racl field of the chunks related to the ingested content. These Project IDs serve as permission entities that control access.
  • SearchAI supports automatic resolution of permission entities for YouTrack content. It automatically identifies users who have access to the given project and associates them with the corresponding Project ID permission entity in SearchAI.
  • Manual permission entity mapping through APIs is not required.