> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Connector

> Learn how to set up a Jira connector as a data source.

For the setup of the Jira connector

<Steps>
  <Step title="Export Your Jira Credentials" titleSize="h2">
    <Note>
      **Please provide us the following information.** We will set up the service connection credentials for you. When creating a new Jira knowledge source you will have to select the assigned service connection.
    </Note>

    **You will need the following things to set up and connect Jira:**

    * Server URL,
    * User account e-mail &
    * User account access token;

    **or a combination of**

    * Personal Access Token (PAT) &
    * Server URL.

    If you provide us with a user account, make sure the user account has the access rights to your project or generally your relevant data.
  </Step>

  <Step title="Select your scope" titleSize="h2">
    When setting up a new Jira knowledge source, a JQL statement is needed. A JQL usually consits of three parts:

    1. Field: The item to search against (e.g., project, status, assignee)
    2. Operator: The comparison word (e.g., =, !=, IN, >).
    3. Value: The specific item you're looking for (e.g., a project name, status, or user).

    #### How to Find the JQL Statement in Jira

    For our Jira connector, you will select your relevant scope using a JQL statement. JQL (Jira Query Language) is a structured search method that allows you to filter and locate specific issues across your Jira projects using precise logical criteria. In Jira, select your project, go to "All Work" (German: Alle Vorgänge), click the Filter-Button on the top left above your list of issues / tasks:

    1. Apply your needed filters to end up with the selection of issues relevant for your Agent,
    2. In the same filter pop-up window, you can then click on JQL to receive and export your needed JQL statement.

    <Tip>
      Example for project-number: Each task has a process number, e.g., PROJ-2223. The prefix “PROJ” is sufficient as the project name. <kbd>project="PROJ"</kbd> would be the resulting JQL statement if you want to have every issue from the project exported to Genow.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/genowgmbh/1OjrPf1PybZtB8uU/images/jira_jql.png?fit=max&auto=format&n=1OjrPf1PybZtB8uU&q=85&s=8de6136e5e67f15b12795efe8a4ce97c" style={{ width:"100%" }} width="1651" height="183" data-path="images/jira_jql.png" />
    </Frame>
  </Step>
</Steps>