<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
</style><p><span style="font-size: 11pt;"><strong>In this guide we will cover:</strong></span></p><p id="isPasted"><strong>- What is the Jira Integration?</strong></p><p><strong>- Pre-requisites-Jira side</strong></p><p><strong>- Connecting Halo to Jira</strong></p><p><strong>- Pre-requisites-Jira side</strong></p><p><strong>- Syncing To Jira</strong></p><p><strong>- Manually linking a ticket to an existing Jira issue</strong></p><p><strong>- Send a Ticket to Jira</strong></p><p><strong>- Managing linked issues</strong></p><p><strong>- Syncing Updates back to Halo</strong></p><p><strong>- Monitoring Sync</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 11pt;">Related Guides:</span></strong></p><ul><li style="font-weight: bold; font-size: 11pt;"><a href="https://usehalo.com/haloitsm/guides/1892" target="_blank" rel="noopener noreferrer"><strong>Jira Service Management Integration</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">What is the Jira Integration? </span></strong></p><p>The Jira Software integration allows you to sync tickets in Halo with issues in Jira, this is a two way sync, so creation of a ticket or issue and updates on either end will sync over to the other application. Various details against the Halo ticket can be synced to Jira including priority, estimated time, product version and custom fields. This allows you to track software changes in both applications. </p><p><br></p><p>This assists you in optimising software management as changes can be monitored in both applications, and time spent on these changes can be tracked in both applications, allowing you to leverage the capabilities of both Jira and Halo. </p><p><br></p><p>If you are using this integration you may want to check out our <a data-fr-linked="true" href="https://usehalo.com/halopsa/guides/1155" id="isPasted" target="_blank" rel="noopener noreferrer">Software Releases</a> functionality, which allows you to track and manage products, releases and release emails within Halo, which can be supported by the Jira integration. <em><strong>Note: This module will need to be enabled for functionality within this guide.</strong></em></p><p><br></p><p><strong><span style="font-size: 14pt;">Pre-requisites-Jira side<br></span></strong></p><p><span style="font-size: 12pt;"><strong>Projects</strong></span></p><p><span style="font-size: 11pt;">You must ensure that you have a project setup in Jira to create issues for. Jira projects are the equivalent to Halo products, therefore when an issue is synced to Jira it will need to be created against the relevant project. When setting up the trial for Jira, you will be taken through steps to create your first project, so you will always have at least one project available for posting.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 12pt;"><strong>Time Tracking</strong></span></p><p><span style="font-size: 11pt;">It is possible to push initial estimates across to Jira when creating new issues. You can find out how to configure this further on in the guide, however, to use this feature you must ensure that your project uses a “Scrum” board, as Jira does not support time tracking on the new issue screen for a Kanban Board based project. You must also ensure that the original estimate field has been added to your issue type.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 14pt;"><strong>Connecting Halo to Jira</strong></span></p><p><span style="font-size: 11pt;">First, you will need to enable the Jira integration module in Halo. Head to configuration > integrations and enable the Jira Software module using the '+' icon. </span></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNlM2Y4Njc4LWYyYjEtNDM0OS04NTg1LWEwOGJmMTliOGFhYyJ9.Mk6sGpNl2t_ewjldfZIN-oDLO_jj7pwKqvDgtmYJAKc" class="fr-fic fr-fil fr-dib" width="245" style="width: 247px; height: 126.75px;" height="127"></span></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable integration module</span></strong></p><p><br></p><p>Click into the module to begin configuration, to configure a connection click 'Add/Edit Connections' and hit 'New'. </p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNhOTYyMTUwLTRiMGEtNGZhZi04NTdiLTFjY2JiMzhiY2JmZiJ9.DayBp2S-ZNmrwiu_htN8LYHlsgQ8ZbY2XKLyLgcX1jE" class="fr-fic fr-fil fr-dib" width="1241" style="width: 1243px; height: 542.385px;" height="542"></span><br></p><p><span style="font-size: 10pt;"><strong>Fig 2. Jira setup</strong></span></p><p><br></p><p><span style="font-size: 11pt;">Begin by choosing your Jira instance type. Depending on which you choose, a different authentication method is required, and different boxes will be displayed based on this. Each authentication option should be self-explanatory, if using the Cloud instance type a link will be provided on the integration setup page, where an API token can be generated. </span></p><p><br></p><p><span style="font-size: 11pt;">Once you have selected your instance type enter the URL used to access your Jira instance as well as a username and password/API Token. If generating an API token, this token will take the permissions of the user that generates it, therefore ensure the agent generating this token has admin-level access in Jira. </span></p><p><br></p><p><span style="font-size: 11pt;">Once you have entered your credentials hit 'Test Connection' to verify Halo is able to connect to your Jira instance successfully. </span></p><p><br></p><p><span style="font-size: 11pt;">Now navigate back to configuration > integrations > Jira Software and set 'Default Jira Connection to use when searching for Issues on Tickets with no Product set'. This will determine which Jira connection (instance) will be used by default. Otherwise, the Jira connection used will be determined by the product assigned to the ticket. </span></p><p><br></p><p><strong><span style="font-size: 14pt;">Link Halo Products to Jira Projects</span></strong></p><p>A project in Jira is the equivalent of a (software) product in Halo, therefore you will need to link Halo products and Jira projects to ensure when an issue is sent to Jira it is created under the correct project in line with the product that is associated with the ticket in Halo. </p><p><br></p><p><strong><span style="font-size: 12pt;">Import Jira Projects as Products</span></strong></p><p>If you do not yet have your (software) products setup in Halo you can import these Jira. To import products head to the 'Projects' tab under the Jira software setup page in Halo and hit 'Import projects'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NDZjNDM5LTQ5NDAtNGIxNS1hNjBmLWMxZTA3ZGM5OWNiYSJ9.HIfiTXMdfiOuOH5f7p--M2Ns4ZlJURqRIXo80eHCi0Q" class="fr-fic fr-fil fr-dib" width="771" style="width: 773px; height: 315.992px;" height="316"></p><p><strong><span style="font-size: 10pt;">Fig 3. Import Projects</span></strong></p><p><br></p><p>To see the products that have been imported select 'Product and release setup > Products. </p><p><br></p><p><strong><span style="font-size: 12pt;">Link existing Halo Products to Jira Projects</span></strong></p><p>If you already have your Halo products created and configured in your Instance, you can link each one to the associated project in Jira. </p><p><br></p><p>To do this select 'Product and release setup > Products > select a product > Jira tab. Here, select the Jira instance the linked project is in, then in the 'Jira Project' field choose the project that should be linked to this product. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFmYzljYWMxLWUyNzAtNGQ3YS05ZWFkLTc0NTcyN2Q5YzYzZiJ9.tOuxgp2-VS8vm2Njpsm7HX6S4UPE1tQ0YPL8BneFUPo" class="fr-fic fr-fil fr-dib" width="848" style="width: 850px; height: 392.449px;" height="392"></p><p><strong><span style="font-size: 10pt;">Fig 4. Link product to Jira project </span></strong></p><p><br></p><p><span style="color: rgb(0, 0, 0);"><strong>Custom field mappings</strong></span></p><p><span style="color: rgb(0, 0, 0);">Once a product is linked to a project you can configure custom field mappings, to map Halo ticket fields to Jira project fields. These mappings can also be configured under the integration setup, this just provides an alternative place to map. <br></span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">You can link a ticket to a Jira issue without setting a product on the ticket beforehand. To be able to do this you must set the 'Default Jira Connection to use when searching for Issues on Tickets with no Product set' under Configuration > Integrations > Jira.</span></p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRiOTM2MzcyLTk0M2MtNGRiYi1hNTVkLWZhZWQzZjhmNTdkYSJ9.SYN1MsJ1LOk2Yh8gC3Mt5kLSzlIGZjjmRZaUUit9r9k" class="fr-fic fr-fil fr-dib" width="636" style="width: 638px; height: 295.765px;" height="296"></span></p><p><span style="font-size: 10pt;"><strong>Fig 5. Default Jira connection</strong></span></p><p><br></p><p><span style="font-size: 11pt;">Once this is set when an Issue is selected, the Ticket will have the Halo Product linked to the Jira Project set. You can also link multiple Jira issues to a Halo ticket.</span></p><p><br></p><p><span style="font-size: 14pt;"><strong>Syncing To Jira</strong></span></p><p><span style="font-size: 11pt;">Issues can be created in Jira from tickets in Halo using actions. The creation of an issue will be triggered by an action in Halo. When syncing, ticket data from ticket fields in Halo can be synced over to Jira. Field mappings will need to be completed to determine how data is synced. </span></p><p><br></p><p><strong><span style="font-size: 12pt;">Field mappings</span></strong></p><p>Field mappings will need to be completed to determine how data is synced from Halo to Jira. The following data can be synced to Jira.</p><ul><li>Issue type </li><li>Project custom fields</li><li>Issue Priority </li><li>Components </li></ul><p>To setup field mappings head to the 'Syncing to Jira' tab under the Jira integration setup page. </p><p><br></p><p><strong>Issue Type mappings</strong></p><p>Here, map Jira issue types to Halo ticket types (and categories), this will determine what issue type is created in Jira based on the ticket type in Halo. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIyNzUyZjRkLTkxOGEtNGE3Mi05MzZiLWE4MjBkNmZkNzM3ZSJ9.aCpF3fhtNBhWD3PjxUO8TIlPDGPlmWfz_FEvYch2wFU" class="fr-fic fr-fil fr-dib" width="528" style="width: 530px; height: 495.994px;" height="496"></p><p><strong><span style="font-size: 10pt;">Fig 6. Issue type mappings</span></strong></p><p><br></p><p>You can also add category criteria here, if set only tickets of the chosen Halo ticket type and the selected category will be created as this issue type in Jira. </p><p><br></p><p>In the figure x example when tickets with the type 'Change - Software' are sent to Jira they will be created as issue type 'Bug' unless they have the category 'Software>Feature' in which case they will be created with issue type 'Task'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI2ODY5Y2NiLTI3NWItNDdiMi05ZTc4LWJhMmFjYzFkYjYwYiJ9.XhTFfcJ5brVOcjEwDNCpWXwroeXCGYHopfFbNWLbEns" class="fr-fic fr-fil fr-dib" width="1395" style="width: 1397px; height: 223.484px;" height="223"></p><p><strong><span style="font-size: 10pt;">Fig 7. Issue type mappings example</span></strong></p><p><br></p><p><strong>Custom Field mappings</strong></p><p>Here, map Halo ticket custom fields to Jira project custom fields. This will determine what fields data from ticket custom fields in Halo are synced into in Jira.</p><p><br></p><p>These mappings are product/project specific, so you will need to map fields for each product/project you have. Additionally, you will need to ensure the Jira field you are mapping on is assigned to the work item in Jira and this field available on the new issue screen when creating new issues in Jira. As shown in figure x. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA4ZWJlNmE1LWNlY2EtNDRjMC04YmI0LWM5ZjdjYWI2NGMzZiJ9.b38GF-B8qa1HeKd-YLvLfdpd5jF93aHh1RgbBLu4P8s" class="fr-fic fr-fil fr-dib" width="1348" style="width: 1350px; height: 226.01px;" height="226"></p><p><strong><span style="font-size: 10pt;">Fig 8. Custom field mappings example</span></strong></p><p><br></p><p><strong>Priority Mappings</strong></p><p>Here, map Halo priorities to Jira Priorities, this will determine what priority the issue has when created in Jira. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQyMzMzYWNkLTQ2MDItNDBlNi04Y2MxLWMyZTg5MTA0NWNkMCJ9.ybwO-qK63NCAAVMm0SB9UTPHc-d-ggbyaFyWPjjmtoI" class="fr-fic fr-fil fr-dib" width="1365" style="width: 1367px; height: 276.099px;" height="276"></p><p><strong><span style="font-size: 10pt;">Fig 9. Priority mappings example</span></strong></p><p><br></p><p><strong>Component mappings</strong></p><p>Components can be selected against the ticket raised in Halo using a system field in Halo. The components selected here will then be synced to the project in Jira in line with the component mappings. </p><p><br></p><p>Note: You will need to be using Jira components (not Compass) in your Jira project to use component syncing. </p><p><br></p><p>To map components you will first need to enable syncing of components to Jira in Halo using the 'Sync the components field to Jira' under the 'Syncing to Jira' tab. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImExNWM2MDMwLTMzNzktNDVlMC1iOWQwLThkMjBiZDZmZTExMyJ9.VxVxfGUbgs9CWAktuVXlbY1x4Q-fvIWdLgoaqtj9t9s" class="fr-fic fr-fil fr-dib" width="779" style="width: 781px; height: 603.536px;" height="604"></p><p><strong><span style="font-size: 10pt;">Fig 10. Enable component syncing</span></strong></p><p><br></p><p>Once enabled, hit 'Jira Component mappings' to begin mapping. Here, you will need to create each of your Jira components in Halo, all the components listed here will be available when selecting a component in the 'Jira component' field. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNlODJmNTBhLTJhMGEtNGU0Mi1hYmQwLTU5ODNhNDk3ZjI0ZSJ9.oPCSbsXLgDZ7CAYRYdhgLz6ofyCkOF7VVzYF-F2DV3Q" class="fr-fic fr-fil fr-dib" width="1383" style="width: 1385px; height: 274.451px;" height="274"></p><p><strong><span style="font-size: 10pt;">Fig 11. Add new component in Halo</span></strong></p><p><br></p><p>When creating the component you will need to enter the component ID of this component in Jira and choose which Jira instance this component is stored in. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFmMDUzZTU3LTI1NzMtNDQzZC1iNDA1LWUzNmE3ZGNmY2JiYyJ9.pL7vvJUGR0HGua9Ctr5bRdhpEUq7j2k3CHgWWGcG6B4" class="fr-fic fr-fil fr-dib" width="719" style="width: 721px; height: 346.339px;" height="346"></p><p><strong><span style="font-size: 10pt;">Fig 12. Mapping component to Jira component</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Defaults for New issues created from Halo</span></strong></p><p>You can choose various default values that will be used for new issues created in Jira by Halo. To set these values head to the Miscellaneous section under 'Syncing to Jira' tab under the integration setup page. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhYzFjMmNkLTJiZjYtNDcyMC1iMjQyLWU0Y2JjYTI2NDU1NCJ9.YQ_OXEiJY4A1t6HM8xvSRG_REsndnKRxDdTbKqgHZ24" class="fr-fic fr-fil fr-dib" width="1380" style="width: 1382px; height: 511.589px;" height="512"></p><p><strong><span style="font-size: 10pt;">Fig 13. Defaults for new issues</span></strong></p><p><strong><br></strong></p><p><strong>Description for new Issues</strong> - Here enter the description you would like to be used for new issues. This will only be used if the ticket details field is not populated. </p><p><strong>Default value for Reporter</strong> - Here, choose the reporter you would like to be assigned to new issues in Jira. This will only be used if the reporter field is not populated/used. </p><p><strong>Default value for Send Attachments to Jira</strong> - Here, choose whether you would like attachments against the ticket in Halo to be sent to Jira when syncing, by default. This will only be used if the field 'send attachments to Jira' is not populated/used.</p><p><strong>Name of Jira Issue Type to use by default </strong>- Here, enter the name you would like all new issues in Jira created by Halo, to have. This will only be used if the ticket summary is not populated. </p><p><br></p><p><strong>Determine how many Jira issues can be linked to a single Halo ticket (and vice versa)</strong></p><p>Halo supports the functionality to either have many tickets in Halo linked to a single issue in Jira or have a single Halo ticket linked to multiple Jira issues. </p><p><br></p><p>The way in which tickets can be linked is set globally for the integration. To choose your ticket linking type head to configuration > integrations > Jira Software > Syncing to Jira > see 'Ticket linking type'. Here you can choose how tickets are linked to Jira issues. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFlNzE5NjdmLTk4OWMtNGI4ZS04M2ZlLWZjOTM0NmU5MjUxYSJ9.89TVgfUjHJfEu-XgDXCsFdQmPxZzcH2irdr5MZvTlgM" class="fr-fic fr-fil fr-dib" width="873" style="width: 875px; height: 673.644px;" height="674"></p><p><strong><span style="font-size: 10pt;">Fig 14. Set ticket linking type</span></strong></p><p><br></p><p><strong><span style="color: rgb(235, 107, 86);">Important: Changing the ticket linking type will remove all existing links between Halo tickets and Jira issues. If this setting is changed, you will need to re-link any tickets/issues using your configured action. </span></strong></p><p><br></p><p>Now we have configured how tickets are synced to Jira we can configure the action to trigger the sync. </p><p><br></p><p><strong><span style="font-size: 12pt;">Sync Jira Version</span></strong></p><p>If you have configured software releases in Halo, including releases, you can sync the release information over to Jira so the issue created in Jira has the version information. </p><p><br></p><p>To do this first ensure you have enabled versions (releases) against your Jira project(s). Then you will need to map each release in Halo to a version in Jira. </p><p><br></p><p>Head to Software releases > select a product > select a release > under the details set the 'Jira Version Name', here you will need to enter the Jira version the release relates to. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE5M2E3NGIxLTI2MmItNDJmMi04NTM0LWI0ZGYwY2NjMWMxZSJ9.RwPYI8Za3qOyTucPBK6bLv-Js8DDTXsznesSsZXPjY4" class="fr-fic fr-fil fr-dib" width="844" style="width: 846px; height: 734.599px;" height="735"></p><p><strong><span style="font-size: 10pt;">Fig 15. Set Jira version against release</span></strong></p><p><br></p><p>Once you have mapped your releases you will need to ensure your ticket type in Halo has the 'version' field against it. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQxZWUxNmE4LTJiYjMtNDFhYy1hNDI2LWFlZGFlZjM1NDVlZiJ9.s-2V5EuXEEr8Bj6QwlUOCtZBdVSU43n5AuRiP82yvLs" class="fr-fic fr-fil fr-dib" width="793" style="width: 795px; height: 540.213px;" height="540"></p><p><strong><span style="font-size: 10pt;">Fig 16. Version field against ticket type</span></strong></p><p><br></p><p><strong><em>Note: The version that is synced to Jira is determined by the version selected in the 'version' field, not the 'release' fields. </em></strong></p><p><br></p><p>Now, when the ticket is raised in Halo, if the version is chosen against the ticket, this will populate the 'Fix version' field against the issue that is created in Jira. </p><p><br></p><p><strong><span style="font-size: 14pt;">Send a Ticket to Jira</span></strong></p><p>Tickets in Halo are synced to Jira using an action with system, use 'Create Bug/Issue/Work Item', however, additional fields can be added to the action to determine what data is synced across. </p><p><br></p><p><span style="font-size: 11pt;">Head to configuration > tickets > actions > new, name the action and set system use 'Create Bug/Issue/Work Item'.</span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1MWIyOGVhLTA3NjEtNDhhMi05OTZhLTE4ZWE5YTI0ZTA0MyJ9.EVQCunB1-Ws6QnxnCPrai32irkVLxf2z8PI5QvIXjS8" class="fr-fic fr-fil fr-dib" style="width: 588px; height: 393.879px;" width="586" height="394"></p><p><strong><span style="font-size: 10pt;">Fig 17. Action to send ticket to Jira </span></strong></p><p><br></p><p>Figure 18 shows all the Jira-relevant fields that can be added to the action to improve/control what data is sent to Jira. The field 'Send to Jira' must be added as this triggers the sync to Jira. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI1NDgxMGE2LWE0MWEtNGIyNi05NDU5LTkxYThmOGRiN2E1OCJ9.1Dl9LzX5BYdhmpTA2NJqfiCQbc-9cyARcEuySYDqSIY" class="fr-fic fr-fil fr-dib" width="1290" style="width: 1292px; height: 574.401px;" height="574"></p><p><strong><span style="font-size: 10pt;">Fig 18. Fields used when sending a ticket to Jira</span></strong></p><p><br></p><p>Red Fields= Mandatory for sync. </p><p>Blue Fields= Not Mandatory but good to have. Remaining estimate will populate the 'time tracking' field in Jira. Original Estimate will populate the original estimate field in Jira. </p><p>Yellow Fields = Only needed if using these entities in Jira.</p><p>Green = Any custom fields, custom fields that are being synced can either be completed against this action or against the ticket type. It is your preference whether to set these here or on the ticket type. </p><p><br></p><p><strong><em>Note: These fields will only be available to add to the action once the integration module is enabled and the system use for the action has been selected. </em></strong></p><p><br></p><p>Once this action is configured ensure it is added to the relevant workflows.</p><p><br></p><p>When syncing the ticket first ensure you have set the relevant fields against the ticket, such as the priority and product. Then you can use the action created to trigger the sync.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiNjNiYmY4LTdhMGUtNDAzNC1hMWFiLTlkMjE5MzM1NzNmNCJ9.2LViXiuOxH4JD1R8ihRP9kuLvnF06Mm8zslWVjZ18GE" class="fr-fic fr-fil fr-dib" width="1026" style="width: 1028px; height: 416.265px;" height="416"></p><p><strong><span style="font-size: 10pt;">Fig 19. Action to sync ticket to Jira in use</span></strong></p><p><br></p><p>You must ensure the field 'Send to Jira' is checked for the sync to occur. </p><p><br></p><p>A pop-up message will occur after sync to confirm the ID of the work item that was created in Jira. </p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;" id="isPasted"><strong><span style="font-size: 12pt;">Syncing The Reporter</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">To have the new issue assigned to the chosen reporter you must assign the ID of the Jira User to their corresponding Agent record. Set this under the 'Integrations' tab of the agent profile, this will become available when the integration is enabled. You can find your Jira ID in the webpage URL when viewing your user profile in Jira. </p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI3YmNlNDQyLTU0NTMtNGQyYi1iNmNmLWQyYmI3ODJmNWEzMiJ9.plNA-mlMKE94PZmh7fTce01W9gGMb__Q9w-quRqTiL4" width="531" height="399" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; width: 533px; height: 399.122px; max-width: none !important;" class="fr-fil fr-dib"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><strong><span style="font-size: 10pt;">Fig 20. Set Jira ID for Halo agent</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><strong><span style="font-size: 14pt;">Send Updates to Jira from Halo</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">Once an issue has been created in Jira from Halo, further updates to the ticket can be synced over to the Jira issue, including comments, mapped custom fields and any of the Jira fields shown in figure 21. </p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">To do this you will need to configure an action with the following setup:</p><ul><li style="box-sizing: inherit; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">system use = None</li><li style="box-sizing: inherit; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">Send to Jira = True</li><li style="box-sizing: inherit; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">Field list = Note (for comments) plus and other fields you would like to be updated. </li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhmNmYzM2Q2LTAyMzgtNGRjMi1iNDFlLWE2YThkYmZjMzYwOSJ9.yTaINUK3OHiS6V-gv6_xd4ZbEqCv2L5Lzu3r5X4todc" class="fr-fic fr-fil fr-dib" style="width: 525px; height: 384.167px;" width="628" height="461"></p><p><strong><span style="font-size: 10pt;">Fig 21. Action to update linked Jira issue</span></strong></p><p><br></p><p>Once this action is configured add it to the relevant workflows to make it available for your agents to use. When used the linked Jira issue will be updated. </p><p><br></p><p><strong><span style="font-size: 12pt;">Sync the Agent that did the action</span></strong></p><p>The agent that completed the action in Halo can be synced over to Jira, so Jira will have a record of the agent who performed this action. To do this, you will need to add integration credentials for Jira, for each agent in Halo. </p><p><br></p><p>Head to an agent's profile > Integrations tab > here, see the 'Integration Credentials' table. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkzOTA5MjRlLTdkZDYtNDMzZC05ZTZmLTFlM2NhNTYwMWU4MSJ9.gpjqy_9eoUDicN8IFyeHuCeHgrh6cAFdSxf3x0yTFdI" class="fr-fic fr-fil fr-dib" width="521" style="width: 523px; height: 680.745px;" height="681"></p><p><strong><span style="font-size: 10pt;">Fig 22. Integration Credentials table </span></strong></p><p><br></p><p>Here, add an entry to the table and select 'Jira' as the integration. Now you will be prompted to choose a Jira instance and enter credentials for this agent. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ5YTBmY2U2LTU0N2YtNDM3OC05OTM0LWFlNmRlZDhkMDM2MiJ9.gsXzuUnGZMyvS8vgicEjF7gE0UR51OpQDFrZ9OF1NrU" class="fr-fic fr-fil fr-dib" width="564" style="width: 566px; height: 576.498px;" height="576"></p><p><strong><span style="font-size: 10pt;">Fig 23. Adding integration credentials for Jira</span></strong></p><p><br></p><p><strong>Jira Instance</strong> - Here, enter the Jira instance you would like to add credentials for. </p><p><strong>Username/Email Address</strong> - Here, enter the username or email address of the user in Jira associated with this agent. </p><p><strong>API Token</strong> - Here, enter an API token for this agent. This will control what updates this agent is able to send to Jira. </p><p><br></p><p>Credentials will need to be set per agent, so each agent in Halo that will be updating tickets linked to Jira will need to have a set of credentials configured. </p><p><br></p><p style="margin-left: 20px;"><strong>Generating API Token</strong></p><p style="margin-left: 20px;">To generate the API Token used for agent credentials head to the API tokens area within your Atlassian account, found here: <a data-fr-linked="true" href="https://id.atlassian.com/manage-profile/security/api-tokens" id="isPasted">https://id.atlassian.com/manage-profile/security/api-tokens</a></p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE0Mzg5MzdkLWFjNjgtNDQ1Zi04YzNlLWU3MTEwNzQxMDczMCJ9.Q_eTFHFwswbAVhbFjH2Q_6KY0de-W4M5Nkm8T6p1C_I" class="fr-fic fr-fil fr-dib" width="1195" style="width: 1197px; height: 687.183px;" height="687"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 24. Generate API Token in Atlassian for Jira</span></strong></p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">Here, you can either 'Create API token' or 'Create API token with scopes'.</p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;"><strong>Create API token</strong> - The API token generated here will inherit the permissions of the user that generated it. Useful if you would like each agent in Halo to add their own integration credentials for Jira, and generate their token themselves, this ensures the token each agent generates is in line with the permissions they have in Jira. </p><p style="margin-left: 20px;"><strong>Create API token with Scopes </strong>- When generating an API token here, you will be able to choose the scopes the token has. Useful if one person is adding the integration credentials for each agent. The following scopes are recommended, but these can be adjusted in line with the permissions of the agent it is going to be used for:</p><ul><li id="isPasted" style="font-style: italic;"><em>write:jira-work (Classic)</em></li><li style="font-style: italic;"><em>read:comment:jira (Granular)</em></li><li style="font-style: italic;"><em>read:comment.property:jira (Granular)</em></li><li style="font-style: italic;"><em>read:group:jira (Granular)</em></li><li style="font-style: italic;"><em>read:project:jira (Granular)</em></li><li style="font-style: italic;"><em>read:project-role:jira (Granular)</em></li><li style="font-style: italic;"><em>read:user:jira (Granular)</em></li><li style="font-style: italic;"><em>write:comment:jira (Granular)</em></li><li style="font-style: italic;"><em>read:avatar:jira (Granular)</em></li></ul><p style="margin-left: 20px;">Once the token is created add it to the agent profile it should be used for. </p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">A token will need to be created for each agent in Halo, you cannot use the same token for all agents.</p><p><br></p><p>Once credentials are set the agent that completed the action will automatically be synced to Jira. If no credentials are set the credentials used to authenticate the integration will be used. </p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">Manually linking a ticket to an existing Jira issue</span></strong></p><p>If you would like to link an existing ticket in Halo to an existing issue in Jira, this can be done using the 'Link to Jira Issue' system action against the Halo ticket. </p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZjOGQ3YmFhLWJhOTMtNDQ4Zi1hNzAzLTY0MzE2ZmMyMzhiNCJ9.mTibRS_ZzN_Z6UVyjAlxo3_KLuQl2OunHyhZhNwlqDI" class="fr-fic fr-fil fr-dib" width="330" style="width: 332px; height: 455.922px;" height="456"></strong></p><p><strong><span style="font-size: 10pt;">Fig 25. Link existing ticket to existing Jira issue</span></strong></p><p><strong><br></strong></p><p>Before this action is used you will need to ensure the ticket has the 'Product' field populated with the correct product, the issues available to link will be determined by the the project linked to this Halo product. </p><p><br></p><p>When used you will be able to search all issues under the Jira project linked to this ticket, when selected the link will be made. When searching you will need to enter at least one word contained in the issue summary, partial word searching is not supported. </p><p><br></p><p><strong><span style="font-size: 14pt;">Managing linked issues</span></strong></p><p>Once a Halo ticket has been linked to a Jira issue a 'Jira' tab will appear against the ticket. Here, you can see all the issues the ticket is linked to as well as who the issue is assigned to and the status of the issue in Jira. </p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNkMWRiZTcyLWViMWQtNDRlZi1hNGI4LTdiZDQzODhlMjJjNCJ9._aNVl3iVQsbxqVDVGmz4t4AB2Uyl7CLRF_dk7ac7krY" class="fr-fic fr-fil fr-dib" width="1023" style="width: 1025px; height: 238.763px;" height="239"></strong></p><p><strong><span style="font-size: 10pt;">Fig 26. Jira issues linked to ticket</span></strong></p><p><strong><br></strong></p><p>Selecting the line will open the issue in Jira. Right-clicking on the line will allow you to set this as the primary issue and unlink the issue. </p><p><br></p><p>An issue only needs to be linked as the primary issue if you have allowed a single Halo ticket to be linked to multiple Jira issues.</p><p><strong><br></strong></p><p><strong><span style="font-size: 14pt;">Syncing Updates back to Halo</span></strong></p><p>Updates in Jira can be synced back to Halo for the following events:</p><ul><li>New issues in Jira will create a ticket in Halo</li><li>Updates to issues in Jira will sync to the linked Halo ticket (this includes updates to any Jira fields that are mapped to Halo fields). </li><li>Comments added to issues in Jira will sync to the linked Halo ticket. </li></ul><p>New issues created in Jira can created tickets in Halo, additionally updates from the issue created in Jira can be synced back to Halo using webhooks. To enable this functionality head to the 'Syncing from Jira' tab under the integration setup page in Halo and enable 'Allow Jira webhooks to be processed by HaloPSA'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM2MTcwMDY0LWM4ODMtNDk2NS05YjYyLTY4OGNkZTY5OGQxMSJ9.LMCdfYUwLDG-R3DVNxN73vsuQf9MfIAxfjzgtGxIsuY" class="fr-fic fr-fil fr-dib" width="891" style="width: 893px; height: 497.239px;" height="497"></p><p><strong><span style="font-size: 10pt;">Fig 27. Enable webhook processing</span></strong></p><p><br></p><p>You can add a level of authentication to the webhook using the "Authentication" field. </p><p><br></p><p><strong>Signature Validation </strong>- When this option is selected you will need to generate a secret for the webhook in Jira. This secret will then need to be added to the integration setup in Halo, this will be checked before the webhook is processed, providing an additional layer of security. </p><p><strong>No authentication </strong>- When selected no webhook authentication will take place, this is a less secure method. </p><p><br></p><p>Once this is set head to Jira and create a webhook (<span style="font-size: 11pt;" id="isPasted"><a href="https://developer.atlassian.com/server/jira/platform/webhooks/">https://developer.atlassian.com/server/jira/platform/webhooks/</a>)</span>, the URL for the webhook will follow the format:</p><ul><li style="font-style: italic;"><em><a data-fr-linked="true" href="https://YOURHALOURL/api/notify/jira">https://YOURHALOURL/api/notify/jira</a></em></li></ul><p>You can configure a webhook that triggers for one/all of the following events:</p><ul><li>Issue - Updated</li><li>Issue - Created</li><li>Comment - Created</li></ul><p>Once configured navigate back to Halo. </p><p><br></p><p>Under the settings section of 'Syncing from Jira' you will need to set what defaults are used for tickets created by Jira as well as some of the update behaviour. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFiZmJkNzk5LWQ3MzUtNDBlNC05N2VkLTdlZWZmZmJjM2E1MCJ9.Rq2oXIldqBbyB7qLlw_hwioDbT4IhR2hyvVuCF5fCNE" class="fr-fic fr-fil fr-dib" width="1014" style="width: 1016px; height: 631.239px;" height="631"></p><p><strong><span style="font-size: 10pt;">Fig 28. Settings for updates from Jira</span></strong></p><p><br></p><p><strong>Default Type</strong> - Here, choose the default ticket type new issues from Jira will be created as in Halo. </p><p><strong>Default User</strong> - Here, choose the default user tickets in Halo, created from Jira, will be assigned to. </p><p><strong>Actions created from Jira updates are private</strong> - Here choose whether Jira updates to tickets are created as private actions or not. Private actions will not be visible to end users.</p><p><span style="color: rgb(0, 0, 0);"><strong>Only update linked Ticket status from the primary issue</strong> - When you have your ticket linking type set to allow a single Halo ticket to be linked to multiple Jira issues, the ticket status will only update in line with changes to the primary issue status, rather than when any linked issue's status changes. </span></p><p><strong>Comment must contain the following text to be added to linked Tickets</strong> - Here, you can restrict which comments against the issue in Jira are sent to Halo. If a string is entered here the comment in Jira will only sync to the ticket in Halo if the comment contains this string. This can be used to allow agents to choose when comments are synced. </p><p><strong>Remove the text value from the note</strong> - If the above field is populated this option can be checked to remove the string (text value) from the comment that is synced to Halo. </p><p><br></p><p><strong>Mentions </strong>- Here, choose how you would like mentions in Jira to be processed. Mentions in Jira can create a mention in Halo. You can choose here if you would, or would not like a notification to be sent from Halo when a mention occurs. The agent the mention is created for in Halo will be based on the Jira ID of the agent. If the Jira ID can be found against an agent in Halo, this agent will be mentioned. If the Jira ID cannot be found against an agent in Halo, no agent will be mentioned unless the setting 'Link Jira users to Halo Agents when processing Jira mentions' is enabled. </p><p><br></p><p><strong>Default Status After Jira Update</strong><strong> </strong>- Here, you can set the default status tickets will be moved to when an update is received from Jira. If the issue in Jira has a status that is mapped to a Halo status the mapped status will always be used, otherwise the Halo ticket will move into the status chosen here. </p><p><br></p><p><strong>Link Jira users to Halo Agents when processing Jira mentions</strong> - When enabled, the user mentioned in Jira will be attempted to be matched to an agent in Halo based on their email address. If an agent with a matching email is found (with no Jira ID) this agent will be linked to the user in Jira. </p><p><br></p><p><strong><span style="font-size: 12pt;">Status mappings</span></strong></p><p>Jira and Halo statuses will need to be mapped together to determine what status the ticket in Halo is updated with when the linked Jira issue's status changes. </p><p><br></p><p><strong><span style="font-size: 14pt;">Monitoring Sync</span></strong></p><p>Once setup is complete and you have begun syncing tickets/issues between Halo and Jira you can use the 'Inbound Requests' and 'Outbound Requests' tabs to monitor sync requests and outcomes. This is useful for troubleshooting any issues. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyZWJjZDc5LTdkOGUtNGRjNy1hZDc5LWQwZDdmNDlhZTA1OSJ9.F1RdhOPmuXnoGk_YvuvfrWTqE4Cn4Tis6hyY7vhpLQc" class="fr-fic fr-fil fr-dib" style="width: 1485px; height: 548.123px;" width="1610" height="595"><strong><span style="font-size: 10pt;">Fig 29. Tabs contains webhook logs</span></strong></p><p><br></p><p>Each log entry can be clicked into to obtain more information on the request and response. </p>
