Discourse Jira

|||
-|-|-|
:discourse: | Résumé | Discourse Jira synchronise les projets, les types de problèmes, les champs, les statuts de problèmes et gère les problèmes.
:hammer_and_wrench: | Lien du dépôt | https://github.com/discourse/discourse-jira
:open_book: | Guide d’installation | Comment installer des plugins dans Discourse

Fonctionnalités

  • Les projets Jira, les types de problèmes, les champs et les options de champs seront synchronisés automatiquement.
  • Créez un nouveau problème Jira pour un message Discourse avec le formulaire de création de problème dynamique.
  • Attachez un problème Jira existant à un message Discourse.
  • Synchronisez le statut du problème Jira à l’aide des webhooks.

Captures d’écran

Menu du message

Configuration

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.

10 « J'aime »

@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.

  1. 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.
  2. 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.
  3. 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.
2 « J'aime »

Vos suggestions amélioreraient vraiment l’expérience avec ce plugin.

Nous avons vraiment besoin que le contenu puisse être révélé à un groupe spécifié (qui n’est pas administrateur).

Existe-t-il une version OpenProject de ceci ? Ce serait formidable de l’avoir car nous utilisons OpenProject pour gérer nos tâches.

@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.

1 « J'aime »

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é.



Ensuite, j’ai ajouté un Webhook Jira et défini l’URL du webhook Jira sur l’URL de mon instance Discourse plus /jira/issues/webhook?t=.

Ensuite, j’ai défini le secret du Webhook, et j’ai copié et collé ce secret dans le champ de configuration du plugin discourse jira webhook token.

Des idées ? Votre aide est très appréciée ! Merci.

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.

4 « J'aime »

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 !

5 « J'aime »

Salut tout le monde,

Quelqu’un a-t-il réussi à faire fonctionner ce plugin avec Jira Server ou Datacenter ?

Je ne vois aucune option de pièce jointe et je vois une erreur dans les logs.

Job exception: DiscourseJira::InvalidURI

Jusqu’à présent, nous n’avons créé ce plugin qu’à l’aide des API pour Jira Cloud. Vous pourriez donc ne pas réussir avec Jira DC.

Documentation REST de Jira Cloud : https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issues/#api-rest-api-2-issue-createmeta-get
Documentation REST de Jira DC/Server : https://developer.atlassian.com/server/jira/platform/jira-rest-api-examples

1 « J'aime »

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.

2 « J'aime »

Cette fonctionnalité fonctionne-t-elle également avec les projets Jira Service Management ?

Il semble y avoir une incompatibilité entre jira et reactions

1 « J'aime »