Suivi des Incidents

La fonctionnalité de Suivi des Incidents d’IKAN ALM permet de relier des Incidents d’un Système de Suivi des Incidents externe à une Requête de niveau IKAN ALM.

Les Incidents peuvent être reliés à une Requête de niveau selon l’une des manières suivantes:

  • via une recherche automatique d’Incidents traités dans les commentaires fournis par les développeurs lors des processus d’enregistrement (commit) et de chargement (check in) des codes Sources dans le RCV. Cette recherche automatique se fait dans une phase séparée pendant l’exécution d’une Requête de niveau de Construction et se base sur une expression régulière décrivant le format du numéro de l’Incident.

  • via l’énumération des Incidents résolus au moment de délivrer vers les Niveaux de Test/Production, facilitant ainsi la génération de Notes de Réalisation.

  • en ajoutant manuellement l’Incident à une Requête de niveau réussie dans l’écran Informations détaillées.

Un lien permettant de passer directement de l’Incident dans IKAN ALM vers l’Incident dans l’outil de Suivi des Incidents externe est disponible si l’outil externe dispose d’une interface Web.

En plus de cette fonctionnalité fondamentale de Suivi des Incidents, IKAN ALM garantit une intégration encore plus étroite avec Atlassian JIRA, Microfocus ALM, Microsoft Team Foundation et GitHub grâce aux fonctionnalités additionnelles suivantes:

  • la possibilité de tester la connexion avec le Système de Suivi des Incidents au moment de la création ou de la modification d’une définition de Système de Suivi des Incidents.

  • la synchronisation automatique des Incidents traités dans le Système de Suivi des Incidents: IKAN ALM récupère des informations additionnelles, telles que la description, le propriétaire, la priorité,

    1. de l’Incident JIRA, du Defect Microfocus ALM, de l’élément de travail Team Foundation ou de l’Incident GitHub correspondant. Ces informations seront synchronisées chaque fois que le résultat de construction évoluera dans le Cycle de vie IKAN ALM.

  • une synchronisation manuelle des Incidents reliés à une Requête de niveau via l’écran Informations détaillées.

  • la possibilité d’ajouter, suite à une Requête de niveau réussie, un commentaire à l’Incident dans JIRA, au Defect dans Microfocus ALM, à l’Incident dans GitHub ou à l’élément de travail Team Foundation. Ce commentaire contiendra un lien vers la Requête de niveau en IKAN ALM.

Pour des informations plus détaillées, se référer aux sections suivantes.

Le Système de Suivi des Incidents

Les Propriétés d’un Système de Suivi des Incidents

Une fois le Système de Suivi des Incidents défini dans la section d’Administration globale, vous devez l’activer dans le Projet. Modifier les Paramètres d’un Projet

Si vous voulez que les Incidents soient reliés automatiquement à des Requêtes de niveau de certains Niveaux, la Phase de Suivi des Incidents doit être associée à ces Niveaux. Cela se fera automatiquement lors de la création de Niveaux dans des Projets pour lesquels un Système de Suivi des Incidents est déjà activé. Si vous activez un Système de Suivi des Incidents pour un Projet avec des Niveaux existants, vous devez ajouter manuellement la Phase de Suivi des Incidents pour ces Niveaux. Pour plus d’informations, se référer aux sections Suivi des Incidents et Phases de niveau.

Créer un Système de Suivi des Incidents

Cette option n’est disponible que si vous disposez de droits d’accès d’Administrateur global dans IKAN ALM.

  1. Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Créer.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking Create
  2. Complétez les champs dans le panneau Créer un Système de Suivi des Incidents.

    Champ Description

    Nom

    Saisissiez la dénomination du Système de Suivi des Incidents externe.

    Ce champ est le seul champ obligatoire. Mais, si vous ne saisissez que le Nom, la capacité d’intégration sera très élémentaire, signifiant que les Incidents devront être créés et reliés manuellement aux Requêtes de niveaux d’IKAN ALM.

    Description

    Saisissez la description du Système de Suivi des Incidents externe.

    Classe "Plugin Factory"

    Sélectionnez le nom de la classe à utiliser pour ce Système de Suivi des Incidents. Les classes sont disponibles dans IKAN ALM en fonction du type de système:

    • système "générique" (Bugzilla, Track, Mantis, …​):

      be.ikan.scm4all.plugin.issuetracking.generic.GenericITSPluginFactory

    • IKAN ALM offre une intégration de base avec ces Systèmes de Suivi des Incidents. JIRA: be.ikan.scm4all.plugin.issuetracking.jira.JiraITSPluginFactory MicroFocus ALM: be.ikan.scm4all.plugin.issuetracking.mfalm.MFAlmITSPluginFactory GitHub: be.ikan.scm4all.plugin.issuetracking.github.GitHubITSPluginFactory Microsoft Team Foundation: be.ikan.scm4all.plugin.issuetracking.tfs.TFSITSPluginFactory

    Note: L’intégration avec JIRA, MF ALM, Team Foundation et GitHub récupère également les informations concernant les Incidents, telles que le statut, la description et le propriétaire. Les Incidents sont synchronisés avec le Système de Suivi des Incidents externe chaque fois qu’une Requête de niveau est délivrée dans le Cycle de vie.

    URL complet

    Saisissez le modèle URL utilisé pour passer d’un Incident dans IKAN ALM vers le Système de Suivi des Incidents externe.

    Il est manifeste que le Système de Suivi des Incidents doit offrir une interface Web qui vous guidera (peut-être après avoir fourni les paramètres de connexion nécessaires) vers la description détaillée d’un Incident. Dans cet URL, la variable du numéro de l’Incident doit être fourni sous forme de "${issueId}".

    Quelques exemples:

    Pour JIRA: http(s)://host:port/browse/PROJECTKEY-${issueId}

    Pour Trac: http(s)://host/ticket/${issueId}

    Pour Bugzilla: http(s)/host/bugs/show_bug.cgi?id=${issueId}

    Pour Team Foundation: http(s)://host[:port/tfs]/DefaultCollection/PROJECT_NAME/_workitems#_a=edit&id=${issueId}

    Utilisateur

    Saisissez l’identifiant utilisateur permettant de se connecter au système.

    Mot de Passe

    Saisissez le Mot de passe de l’utilisateur cité ci-dessus.

    Les caractères sont remplacés par des astérisques.

    Répétez le Mot de Passe

    Ressaisissez le Mot de passe de l’utilisateur cité ci-dessus pour contrôle.

    Modèle de recherche de Suivi d’Incident

    Saisissez le modèle de recherche de suivi d’Incident.

    Ce modèle doit être une expression régulière valide. Pour plus d’informations concernant les expressions régulières valides qui peuvent être interprétées par IKAN ALM, se référer à https://docs.oracle.com/en/java/javase/1/docs/api/java.base/java/util/regex/Pattern.html.

    Si fourni, ce modèle sera utilisé pour détecter les numéros d’Incident dans les commentaires enregistrés dans le RCV. Cet appariement d’expressions est réalisé dans une phase séparée à la fin d’une Requête de niveau de Construction réussie.

    L’appariement d’expressions ne tient pas compte de la casse, comme illustré dans les exemples ci-dessous:

    Notez que pour un système de Suivi des Incidents Team Foundation ce champ peut être ignoré (ainsi que le Modèle d’Identifiant de Suivi d’Incident) s’il est connecté à un Projet avec un système de contrôle de versions Team Foundation: dans ce cas, les éléments de travail seront directement liés à une opération Commit. Par conséquent, IKAN ALM ne doit plus analyser les commentaires des Incidents pour détecter les éléments de travail associés.

    Exemples (le texte en caractères gras est le texte qui sera apparié):

    Exemple 1: webpad(\s)*[0-9]+((\s)*,(\s)*[0-9]+)*

    - Incident résolu webpad 333 par adaption de…​

    - Fichier X ajouté, et fichier Y changé pour résoudre le Webpad 45, 46.

    Exemple 2: \[#([A-Z0-9]+)-([0-9]+)\]

    - Petite correction dans le menu [#WEBPAD-7].- Corrigé également le problème général IKAN ALM [#ALM-3788].- Finalement, traité aussi l’Incident [#gen-344].

    Modèle d’Identifiant de Suivi d’Incident

    Saisissez le Modèle d’Identifiant de Suivi d’Incident.

    Ce modèle est nécessaire pour la récupération du numéro d’Incident exact à partir des commentaires récupérés de l’Incident apparié dans le RCV. Il fait partie du modèle d’Incident et doit également être une expression régulière valide.

    Ceci permet de sélectionner les chiffres en gras dans le commentaire du RCV.

    Pour un système de Suivi des Incidents Team Foundation ce champ peut être ignoré (ainsi que le Modèle de recherche de Suivi d’Incidents) s’il est connecté à un Projet avec ce système de contrôle de versions.

    Exemple 1: [0-9]+

    - Webpad 45 , 46

    - [#gen-344]

    Exemple 2: [A-Z0-9]+-[0-9]+

    - WEBPAD-7

    - ALM-3788

    Ajouter des Commentaires

    Cette fonctionnalité n’a pas d’effet si vous utilisez le plugin GenericITSPlugin.

    Sélectionnez l’option Oui si vous voulez qu’un commentaire soit automatiquement ajouté à l’Incident dans le Système de Suivi des Incidents. Ce commentaire contiendra un lien vers la Requête de niveau en IKAN ALM.

    L’ajout de ce commentaire sera également listé dans la Log de la Phase Suivi des Incidents.

    Pour des informations plus détaillées concernant les paramètres système spécifiques du Système de Suivi d’Incidents, se référer au Guide d’intégration approprié (HowToALM_Integrating MF ALM, HowToALM_Integrating JIRA, HowToALM_Integrating GitHub ou HowToALM_Integrating Team Foundation). Ces guides sont uniquement disponibles en anglais.

  3. Après avoir complété les champs, cliquez sur le bouton Créer.

    Le nouveau Système de Suivi de Incidents est ajouté à l’Aperçu des Systèmes de Suivi des Incidents dans la partie inférieure de l’écran.

    Un avertissement indiquant que certaines propriétés obligatoires doivent être définies, pourrait s’afficher. Pour plus d’informations concernant la modification des propriétés d’un Système de Suivi des Incidents, se référer à la section Le panneau "Aperçu des Propriétés du Système de Suivi des Incidents".

    GlobAdmin IssueTracking Create Warning

    Une fois le Système de Suivi des Incidents défini, vous devez l’activer dans le Projet. Modifier les Paramètres d’un Projet

  4. Si vous avez défini un Système de Suivi des Incidents JIRA, MF ALM, GitHub ou Team Foundation, vous pouvez tester si IKAN ALM parvient à établir la connexion.

Aperçu des Systèmes de Suivi des Incidents

  1. Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Aperçu.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking Overview
  2. Définissez les critères de recherche requis dans le panneau de recherche.

    La liste des éléments dans l’aperçu est synchronisée automatiquement en fonction des critères sélectionnés.

    Vous pouvez également:

    • cliquer sur le lien Montrer/Cacher les options avancées pour afficher ou masquer tous les critères de recherche disponibles,

    • cliquer sur le lien Rechercher pour synchroniser la liste en fonction des critères de recherche actuels,

    • cliquer sur le lien Réinitialiser la recherche pour nettoyer les champs.

  3. Vérifier les détails dans le panneau Aperçu des Systèmes de Suivi des Incidents.

    Pour une description détaillée des champs, se référer à la section Créer un Système de Suivi des Incidents.

  4. En fonction de vos droits d’accès, les liens/icônes suivants peuvent être disponibles:

    Icône Description

    edit Modifier

    Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de modifier la définition d’un Système de Suivi des Incidents.

    Modifier la définition d’un Système de Suivi des Incidents

    delete Supprimer

    Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de supprimer une définition de Système de Suivi des Incidents.

    Supprimer une définition de Système de Suivi des Incidents

    history Historique

    Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher l’Historique de toutes les opérations de création, de mise à jour et de suppression exécutées sur le Système de Suivi des Incidents et ses Propriétés.

    Afficher l’Historique d’un Système de Suivi des Incidents

Modifier la définition d’un Système de Suivi des Incidents

  1. Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Aperçu.

  2. Pour y accéder, cliquez sur le lien edit Modifier devant le Système de Suivi des Incidents que vous voulez modifier.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking Info
  3. Cliquez sur le bouton Modifier du panneau Informations sur le Système de Suivi des Incidents.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking Edit
  4. Si nécessaire, modifiez les champs.

    Pour une description, se référer à la section Créer un Système de Suivi des Incidents.

    Le panneau Projets Connectés affiche les Projets auxquels le Système de Suivi des Incidents est associé.

  5. Cliquez sur le bouton Enregistrer pour sauvegarder vos modifications.

    Les boutons suivants sont également disponibles:

    • Actualiser pour récupérer les Paramètres tels qu’ils sont enregistrés dans la base de données.

    • Annuler pour retourner à l’écran précédent sans enregistrer vos modifications.

  6. Si vous avez défini un Système de Suivi des Incidents JIRA, MF ALM, GitHub ou Team Foundation, y compris ces propriétés requises, vous pouvez tester si IKAN ALM parvient à établir la connexion.

    Cliquez sur le bouton Vérifier la connexion.

    INFO : Connexion correctement établie avec le Système de Suivi des Incidents.

    Si le test échoue, l’écran suivant s’affiche:

    GlobAdmin IssueTracking TestConnection Fail

    Corrigez les erreurs spécifiés dans la trace de pile et refaites le test.

  7. Dans le panneau Aperçu des Propriétés du Système de Suivi des Incidents, vous pouvez créer et modifier les Propriétés d’un Système de Suivi des Incidents.

    Pour plus d’informations, se référer à la section Le panneau "Aperçu des Propriétés du Système de Suivi des Incidents"

Supprimer une définition de Système de Suivi des Incidents

  1. Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Aperçu.

  2. Cliquez sur le lien delete Supprimer pour supprimer le Système de Suivi des Incidents sélectionné.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking Delete
  3. Cliquez sur le bouton Supprimer pour confirmer la suppression du Système de Suivi des Incidents sélectionné.

    Vous pouvez également cliquer sur le bouton Précédent pour retourner à l’écran précédent sans supprimer le Système de Suivi des Incidents.

    Note: Si le Système de Suivi des Incidents est associé à un ou plusieurs Projet(s), l’écran suivant s’affiche:

    GlobAdmin IssueTracking Delete Error

    Vous devez modifier la définition des Projets affichés, avant de pouvoir supprimer le Système de Suivi des Incidents.

Afficher l’Historique d’un Système de Suivi des Incidents

  1. Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Aperçu.

  2. Cliquez sur le lien history Historique pour afficher l’Aperçu de l’Historique du Système de Suivi des Incidents.

    Pour une description détaillée de l’Aperçu de l’Historique, se référer à la section Enregistrement de l’historique et des événements.

  3. Cliquez sur le bouton Précédent pour retourner à l’écran précédent.

Le panneau "Aperçu des Propriétés du Système de Suivi des Incidents"

Le panneau "Aperçu des Propriétés du Système de Suivi des Incidents" est disponible dans l’écran Modifier le Système de Suivi des Incidents.

  1. Accéder à l’écran Modifier un Système de Suivi des Incidents.

    Dans le Menu d’Administration globale, sélectionnez Suivi des Incidents > Aperçu et cliquez sur le lien edit Modifier devant le Système de Suivi des Incidents pour lequel vous voulez afficher les Propriétés.

  2. Cet écran contient le panneau Aperçu des Propriétés du Système de Suivi des Incidents.

    GlobAdmin IssueTracking Info ITSPropertiesPanel

    Cet écran permet de créer, modifier ou supprimer les Propriétés du Système de Système de Suivi de Suivi des Incidents.

    En fonction des Propriétés disponibles dans le Système de Suivi des Incidents et de vos droits d’accès, les liens suivants peuvent être disponibles dans le panneau Aperçu des Propriétés du Système de Suivi des Incidents.

    Vous ne pouvez pas définir de Propriétés qui ont été implémentées par la Plugin Factory Class.

    Icône Description

    icon createparameter Créer

    Ce lien n’est disponible que si une Propriété a été définie par la Plugin Factory Class, mais que sa valeur n’a pas encore été spécifiée. Sinon, seuls les liens Modifier et Supprimer seront disponibles.

    Cette option est disponible pour tous les Utilisateurs IKAN ALM ayant des droits d’accès d’accès d’Administrateur global. Elle permet de créer une définition de Propriété de Suivi des Incidents.

    Créer une Propriété d’un Système de Suivi des Incidents

    edit Modifier

    Cette option est disponible pour tous les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de modifier une définition de Propriété de Suivi des Incidents.

    Modifier une Propriété de Système de Suivi des Incidents

    delete Supprimer

    Cette option est disponible pour tous les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de supprimer une définition de Propriété de Suivi des Incidents.

    Supprimer une Propriété de Système de Suivi des Incidents

Créer une Propriété d’un Système de Suivi des Incidents.

  1. Dans le panneau Aperçu des Propriétés du Système de Suivi des Incidents, cliquez sur le lien icon createparameter Créer pour la Propriété requise.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking EditProperties Create

    Les champs suivants sont affichés:

    Champ Description

    Nom

    Ce nom est prédéfini par IKAN ALM en fonction du type de Système de Suivi des Incidents.

    Valeur

    En fonction du Système de Suivi des Incidents et de la Propriété, ce champ est obligatoire ou optionnel.

    Saisissez la valeur nécessaires pour une utilisation correcte du Système de Suivi des Incidents.

    Exemple pour la propriété JIRA jiraRESTUrl: http(s)://machine:8090/rest

    Exemple pour la propriété GitHub gitHubRESTUrl: https://api.github.com/repos/{organization}/{repository}

    Exemple pour la propriété Team Foundation collectionURL: http(s)://ServerName[:8080/tfs]/DefaultCollection

    Valeur par défaut

    Ce champ contient la valeur par défaut.

    Requis

    Option gérée par IKAN ALM.

    Les Propriétés requises doivent être fournies pour assurer une intégration fonctionnelle complète du Suivi des Incidents.

    Valeurs possibles: Oui ou Non.

    Sécurisé

    Option gérée par IKAN ALM.

    La valeur des propriétés sécurisées sera cachée de l’Utilisateur (remplacée par des *).

    Valeurs possibles: Oui ou Non.

    Description

    Option gérée par IKAN ALM.

    La description de la Propriété de Système de Suivi des Incidents.

  2. Saisissez la valeur dans le champ Valeur et cliquez sur le bouton Créer pour confirmer la création de la nouvelle propriété.

    Les boutons suivants sont également disponibles:

    • Réinitialiser pour nettoyer les champs et restaurer les valeurs initiales.

    • Annuler pour retourner à l’écran précédent sans enregistrer vos modifications.

Modifier une Propriété de Système de Suivi des Incidents

  1. Dans le panneau Aperçu des Propriétés du Système de Suivi des Incidents, cliquez sur le lien edit Modifier pour la Propriété requise.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking EditProperties Edit

    Pour une description des champs, se référer à la section Créer une Propriété d’un Système de Suivi des Incidents.

  2. Si requis, modifiez la valeur dans le champ Valeur et cliquez sur le bouton Enregistrer.

    Les boutons suivants sont également disponibles:

    • Actualiser: pour récupérer les Paramètres tels qu’ils sont enregistrés dans la base de données.

    • Annuler: pour retourner à l’écran précédent sans enregistrer les modifications des champs.

Supprimer une Propriété de Système de Suivi des Incidents

  1. Dans le panneau Aperçu des Propriétés du Système de Suivi des Incidents, cliquez sur le lien delete Supprimer pour la Propriété requise.

    L’écran suivant s’affiche:

    GlobAdmin IssueTracking EditProperties Delete
  2. Cliquez sur le bouton Supprimer pour confirmer la suppression de la Propriété.

    Vous pouvez également cliquer sur le bouton Annuler pour retourner à l'Aperçu des Systèmes de Suivi des Incidents sans supprimer la Propriété.