Configurer l’intégration des stories d’utilisateurs Jira
Effectuez la procédure suivante pour configurer vos options d’intégration Jira.
Avant de commencer
Rôle requis : administrateur du moteur d’analyse (sn_se.scan_engine_admin)
- Pour activer l’intégration, vous aurez besoin de certains détails du projet Jira que vous souhaitez intégrer au Moteur d'analyse. Dans les paramètres du projet sur votre tableau Jira, recherchez et notez les informations suivantes :
- Clé du projet
- Type d’élément de travail
- Nom du domaineRemarque :Vous pouvez obtenir le nom de domaine à partir de votre URL Jira. Par exemple, si votre URL est
companyname.atlassian.net/jira, votre nom de domaine estcompanyname.
- Pour vous connecter à votre projet Jira, vous aurez également besoin d’un jeton d’API :
- Accédez à l’URL suivante : https://id.atlassian.com/manage-profile/security/api-tokens.
- Sélectionnez Créer un jeton API, saisissez un nom pour le jeton, puis sélectionnez Créer.
- Une fois le jeton créé, copiez-le et stockez-le.
Vous en aurez besoin pour le processus de connexion ServiceNow.
Procédure
Bonnes pratiques en matière de script d’intégration Jira
Les bonnes pratiques suivantes sont des directives pour la création de scripts d’intégration Jira.
- Contrairement aux intégrations ServiceNow, l’intégration Jira exécute le script de mappage de champ une fois par résultat. Les instances source et destination ne s’appliquent pas avec cette intégration.
- Les champs Clé du projet et Nom du domaine déterminent le projet Jira auquel vous allez envoyer votre charge utile.
- Lors de la création d’un script, utilisez les données de la recherche en extrayant des champs de la variable grFounding.
- Vous pouvez créer une description et un résumé à afficher dans votre projet Jira. Ils deviendront des éléments essentiels de votre type d’élément de travail. Vous pouvez utiliser d’autres champs dans le projet Jira, mais vous devez comprendre l’API Jira pour connaître les champs disponibles.
- Voici quelques champs généraux que vous pouvez utiliser :
- résumé
- description
- projet
- Type de problème
Ceux-ci peuvent être définis à l’aide du format suivant :
payload = { 'fields':{ 'summary': text to display in the title, 'description': a description of the work item, 'project': { 'key': the project key}, 'issuetype': { 'name': a work item type: Epic, Story, Bug, Task, Sub-Task} }
Plusieurs variables prédéfinies sont disponibles pour les intégrations Azure DevOps :
| charge utile | Le mappage des champs pour remplir votre projet Jira. |
| grFinding | L’enregistrement Glide du résultat qui envoie la demande. |
| workItemType | Le type d’élément de travail sélectionné pour l’intégration Jira. |
| Clé | La clé de projet créée pour l’intégration Jira. |