Définissez les valeurs pour les paramètres du site ci-dessous avant d’activer le plugin.
discourse_jira_url: Entrez l’URL de votre instance Jira. Elle doit se terminer par un symbole /.
discourse_jira_username: Le nom d’utilisateur de l’utilisateur au nom duquel les problèmes seront créés.
discourse_jira_password: La clé API attribuée à l’utilisateur qui crée les problèmes. Un mot de passe peut fonctionner mais n’est pas sûr et l’API a été dépréciée par Atlassian.
discourse_jira_enabled: Activez le plugin Jira pour Discourse.
discourse_jira_allowed_groups: Sélectionnez les groupes qui auront accès aux fonctionnalités du plugin Jira. Par défaut, les administrateurs et les modérateurs.
Webhook
Définissez un jeton secret pour vérifier les webhooks entrants de Jira.
discourse_jira_webhook_token: Ce jeton doit être passé dans le paramètre de requête ‘t’ du webhook.
Par exemple, étant donné que le jeton du webhook est supersecret, et que votre URL de base Discourse est discourse.example.com, vous configurerez l’URL du webhook comme https://discourse.example.com/jira/issues/webhook?t=supersecret dans les paramètres du webhook pour votre instance Jira.
Pour simplement vérifier que le webhook est déclenché et que le corps émis est correct, vous pouvez choisir d’utiliser des sites Web externes comme RequestBin ou Webhook.site pour configurer des URL de webhook temporaires.
Débogage
discourse_jira_verbose_log: Activez ce paramètre pour enregistrer les charges utiles des webhooks entrants et des requêtes API sortantes.
\u003e:discourse2: Hébergé par nous ? Ce plugin est disponible sur notre plan Entreprise.
@vinothkannans nous avons remarqué que nos utilisateurs ne peuvent pas réellement voir le statut de ces tickets, que seuls les administrateurs peuvent les voir. Peut-on faire quelque chose pour rendre le « statut » plus visible pour les utilisateurs ?
Une option pourrait bien sûr être de rendre ce bloc de citation visible, ou il serait également agréable de pouvoir mapper les statuts Jira aux tags, et que le tag du sujet soit mis à jour pour refléter la progression du ticket (backlog, in-progress, #complete, etc.).
Pour faire suite à Jordan, j’ai quelques idées supplémentaires pour améliorer ce plugin.
Possibilité de détacher un ticket JIRA. Je ne vois aucune option pour détacher ou supprimer un ticket JIRA que j’ai lié à un message.
Choisir quels groupes peuvent voir les tickets JIRA attachés. Pour l’instant, seuls les administrateurs du site semblent pouvoir les voir, mais nous aimerions avoir la possibilité de sélectionner un ou plusieurs groupes supplémentaires qui peuvent les voir.
Niveaux de visibilité. Possibilité de spécifier quelle(s) partie(s) du ticket apparaîtra (ont) aux non-administrateurs. Par exemple, nous voulons peut-être que tous les groupes voient le numéro et le statut du ticket, mais pas le titre du ticket, qui peut contenir des informations sensibles. Ensuite, nous pouvons spécifier des groupes de confiance qui peuvent voir le titre du ticket.
@jordan-violet@colin.mckibben ce sont de bonnes suggestions pour rendre le plugin plus utile. Je garderai cela à l’esprit la prochaine fois que j’y travaillerai.
Salut, j’ai une question sur la configuration du plugin. J’obtiens des erreurs 500 lors de la création/l’attachement de tickets, donc je pense que mes paramètres ne sont pas tout à fait corrects. Qu’ai-je mal fait ?
Tout d’abord, j’ai copié et collé l’endroit où j’accédais normalement à mon instance Jira dans discourse jira url, bien que je ne sois pas entièrement certain de l’URL car elle diffère en fonction de la vue Jira sélectionnée.
Ensuite, j’ai défini un discourse jira username aléatoire, avec le discourse jira password copié et collé à partir d’un jeton d’API Atlassian généré.
Quelqu’un peut-il partager ses paramètres de plugin fonctionnels dans Discourse (sans le mot de passe/jeton, bien sûr) afin que je puisse voir comment vous l’avez fait fonctionner ? Merci !
J’ai copié le jeton du webhook dans l’URL dans la configuration du webhook Jira, donc il est indiqué https://example.com/jira/issues/webhook?t=abcdefghijk, et votre discourse_jira_url est censé être https://modernsquared.atlassian.net/ sans le chemin.
@vinothkannans J’ai une autre question : est-il possible de changer le ticket attaché à un sujet après l’attachement, ou simplement de supprimer l’attachement ? Si ce n’est pas le cas, y avez-vous pensé ?
Merci @mikael.gundhus, j’ai réussi à connecter le plugin à Jira.
Mais j’ai rencontré une bizarrerie. Je ne sais pas si je suis le seul à rencontrer ce problème, mais les boutons Créer et Joindre des tickets semblent être inversés ? Lorsque je clique sur le bouton Créer un ticket, le plugin m’envoie à l’écran de joindre un ticket :
Et lorsque je clique sur le bouton Joindre un ticket, le plugin m’envoie à l’écran de création de ticket : MS-155 est un ticket existant dans Jira. Si je tape un nouveau ticket, disons MS-200, qui n’existe pas dans Jira, il me dit Une erreur s'est produite : Vous n'êtes pas autorisé à consulter la ressource demandée.
@mikael.gundhus oui, il devrait y avoir une option pour supprimer la pièce jointe existante. @ckshen semble qu’il y ait de mauvaises rubriques dans les fenêtres modales. Nous travaillerons sur ces points lors de la prochaine itération.
Y a-t-il des projets pour rendre cela accessible aux utilisateurs qui ne sont pas administrateurs/modérateurs ? Nous avons des équipes internes qui cherchent à déplacer leurs opérations vers Discourse, et en l’état actuel, la seule façon pour elles d’utiliser l’outil JIra est de leur accorder des privilèges de modération sur l’ensemble du site.
J’ai mis à jour ce plugin avec les autorisations de groupe ! Il inclut par défaut et doit toujours inclure les administrateurs, mais avec cette mise à jour, les utilisateurs peuvent désormais créer des tickets Jira sans avoir besoin d’être administrateur. Profitez-en !
Merci Natalie, après avoir ajouté notre hôte aux hôtes internes autorisés sous Sécurité, nous avons pu lier et créer des problèmes. C’est probablement utile à savoir pour quiconque utilise une instance interne de Jira. Je travaille toujours sur la synchronisation des commentaires, mais je pense qu’il s’agit d’un problème de configuration.