Docs
Jira Server

Jira Server

Connecting your Jira Server

  1. In order to connect Jira, we'll need these pieces of information:
    1. Personal Access Token: Here (opens in a new tab) is the official documentation for Jira containing the instructions on how to create a Personal access token.

    NOTE: It is advised to set the PAT expiry to the longest duration for a seamless experience.

    1. Domain: Where your hosted version of Jira instance. If it’s hosted behind a fire please whitelist our ip addresses. Link
  2. Navigate to Connectors Page (opens in a new tab) and select Jira Server.

    Jira Server Connector Card
  3. Enter the earlier gathered information in the form and click Connect.

    Jira Server Connector Form
  4. Our system will verify the token and syncing will begin.

Ensuring Jira Server Issue-PR Linking

We rely on issue development data for linking issues to PRs. So we have to ensure that the user used for authenticating the Jira Server on Hatica app has access to the development data.

How to check and provide access to development data?

  1. Go to any issue in your Jira server instance.
  2. Look for the development section in the issue.

    Jira Server Development Field
  3. Click on pull request. If you are able to see the PRs linked to the issue, then you are all good to go no further steps are required. If not, then you need to give access to the user.

    Jira Server Development Panel Authorized
  4. To give access to the user, click on the Bitbucket (in the case of Bitbucket application link).

    Jira Server Development Panel Unauthorized
  5. You will be redirected to Bitbucket which will ask you to authenticate Jira for the same. Click Allow to give access to the user.

    Jira Server Development Panel Unauthorized
  6. You should be able to view the PRs linked to the issue.

FAQs

Q: What access level does Hatica needs?
A: We only require read access to issues. In case of PAT we get all the access as of the user.

Q: How long does the initial sync take?
A: In general it takes about a day. It all depends on the size of the data and rate limiting on your Jira server instance.

Q: I want to limit the projects being synced. How can I do that?
A: As of now we do not have that functionality in the app itself. But we can do it for you, just reach out to us on the support.