Return to site

Linking JIRA with BizMerlinHR

April 16, 2022 · Integrating BizMerlinHR with 3rd Party Applications,

Setup JIRA in Third-Party Integrations

1. Go to the top right “Setup” menu and scroll down to “Third Party Integrations”: Setup -> Third Party Integrations.

Linking JIRA with BizMerlinHR 1

2. On the Third Party Integrations page, click on the button “New Integration” and select “Project Management” as Integration Type and choose “Jira”.

Linking JIRA with BizMerlinHR 2

Linking JIRA with BizMerlinHR 3

3. In the field, Host specifies your JIRA account URL (the address of your Atlassian cloud site).

For example, if your Jira dashboard is at https://ACME.atlassian.net/secure/Dashboard.jspa

then the Hostname should be https://ACME.atlassian.net

4. Enter your Username in the “Username” field.
5. Specify the API Token in the “Authtoken” field (how to generate auth token).

Linking JIRA with BizMerlinHR 4

6. Now, you are ready to Integrate with JIRA.
7. Create Webhooks in Jira.

Linking JIRA with BizMerlinHR 5

8. Add Jira Push or Pull Post Functions.

Linking JIRA with BizMerlinHR 6

 

9. Add JIRA Push function in Post Functions.

A. On the Post Functions page, select Object as “Project” from the drop-down and “create project” from the Function drop-down with field mapping as Text Area.
B. Click the “Save” button to save the Post Function.
C. Now, you are ready to create a project in JIRA, wherever you will create a Project in BizMerlinHR.

Linking JIRA with BizMerlinHR 7Linking JIRA with BizMerlinHR 8

 

10. Pulling “Projects” in BizMerlinHR from JIRA
A. In BizMerlinHR, go to the top menu “Projects” and click “Projects”.
B. There you see a button “Pull from JIRA” on top right.
C. The project ID in Jira should be stored as a project’s custom field in BizMerlinHR.
D. The custom field code should be ‘jira.project.ID’
E. Click on the button. All JIRA projects will be created in BizMerlinHR.
F. Finally, you will see a notification message on the screen.

Linking JIRA with BizMerlinHR 9
Linking JIRA with BizMerlinHR 10

 

Configure Webhooks in JIRA

1. Go to Site administration.
2. In the left panel, go to JIRA settings.
3. In the left panel, find Webhooks, click on the link.
4. Click on Create a Webhook.
5. Enter the Name of the Webhook, say Project Listener.
6. Set status Enabled.
7. Set URL as https://evosyn.bizmerlin.net/bmintegrations/jira/project.
8. Set Project related Events, check all the checkboxes (created, updated, deleted).
9. Hit the Save button.

Linking JIRA with BizMerlinHR 11Linking JIRA with BizMerlinHR 12Linking JIRA with BizMerlinHR 13

 

Create an API token

You can create API token from your Atlassian account by following steps:
A. Log in to https://id.atlassian.com/manage/api-tokens
B. Click Create API token.
C. From the dialog that appears, enter a memorable and concise Label for your token and click Create.

Linking JIRA with BizMerlinHR 14

D. Click Copy to get the auth token, then paste the token to your script or elsewhere to save.

Linking JIRA with BizMerlinHR 15

Hope This Helps!