Aller au contenu
AppArch AppArch Docs

Jira

L’intégration Jira transforme les constats AppArch en tickets Jira et lit les projets Jira associés pour l’analyse du flux des tickets.

Connexion

Section intitulée « Connexion »
  1. Integrations → Jira.
  2. Saisissez l’URL du site Atlassian (par ex. https://your-team.atlassian.net), l’e-mail du compte et un jeton d’API.
  3. AppArch vérifie le jeton auprès de Jira (/rest/api/3/myself) avant de l’enregistrer chiffré.

Chaque espace de travail a une seule connexion Jira. La gérer nécessite la permission Intégrations de l’espace de travail.

Associer des projets

Section intitulée « Associer des projets »

Une association relie un projet AppArch à un projet Jira. Pour chacune, vous choisissez :

  • le type de ticket par défaut (Bug sauf autre choix),
  • éventuellement un tableau, l’ajout ou non au sprint en cours du tableau, et le statut initial,
  • les règles de création automatique : ouvrir un ticket quand une revue ArchPilot échoue, et/ou pour les constats ArchScan critiques.

Créer des tickets

Section intitulée « Créer des tickets »
  • À la main : cochez des constats sur une exécution ArchScan ou une merge request ArchPilot dans le panneau et créez les tickets.
  • Automatiquement : les règles s’exécutent en arrière-plan. Le premier passage remonte 24 heures avant l’activation de la règle, et au plus 50 tickets sont ouverts par association et par passage ; le reste suit lors des passages suivants.

Le résumé d’un ticket est [AppArch] <code de règle>: <message> (200 caractères au plus) ; sa description contient le module, le dépôt, la règle et la sévérité, le fichier et la ligne, la branche, l’endroit où le constat a été vu, le message et la correction suggérée s’il y en a une.

Le constat affiche ensuite un badge avec la clé du ticket, qui renvoie vers le ticket. Les liens sont associés par l’empreinte du constat ; un constat signalé à nouveau par une exécution ultérieure garde son ticket au lieu d’en recevoir un nouveau.

AppArch n’affiche pas le statut du ticket sur le constat et n’ajoute pas de clés Jira aux commentaires qu’ArchPilot publie sur les pull requests.

Flux des tickets

Section intitulée « Flux des tickets »

Dès qu’un espace de travail associe au moins un projet Jira, AppArch lit aussi les tickets des projets associés (la première exécution remonte 180 jours) pour le rapport de flux des tickets - voir Engineering Analytics.