Configurer des modèles de reconnaissance de validation

La détection et le maintien de la traçabilité entre les ensembles de modifications et les éléments de travail reposent sur un message de validation que le développeur fournit lors de la validation d'une modification pour le référentiel SCM. permet de personnaliser les paramètres de façon à lier les modifications comprises dans l'ensemble de modifications aux éléments de travail.

Vous configurez les paramètres de modèle de validation en ajoutant un référentiel SCM ou en en modifiant un. Pour plus d'informations sur l'ajout ou la modification de référentiels, reportez-vous à la section Add and edit repositories.

Pour plus d'informations sur le modèle de validation par défaut, reportez-vous à la section Default commit patterns.

Contenu de cette rubrique<:hs>:

Associer des modifications de code à d'autres identificateurs

Par défaut, des validations sont associées à des user stories ou anomalies en fonction de leurs ID Agile Manager. Si vous gérez un autre ensemble d'identificateurs pour vos user stories ou anomalies, les développeurs peuvent valider les modifications en se référant à ces autres identificateurs. Par exemple, si vous synchronisez votre espace de travail avec un outil de suivi des anomalies externe, comme , les développeurs peuvent faire référence dans leurs messages de validation aux identificateurs générés par cet outil.

Les autres identificateurs sont stockés dans Agile Manager dans un champ personnalisé. Le message de validation doit inclure une expression indiquant que doit rechercher les identificateurs dans le champ personnalisé. Par exemple<:hs>: Résoudre le problème Jira.

  1. Dans la page Détails du référentiel, développez la zone Modèle de validation. Assurez-vous d'avoir sélectionné la vue De base.
  2. Dans la section Anomalies ou User stories, ajoutez un mot-clé ou une expression indiquant que la validation utilise un autre identificateur.
  3. Dans la liste Champ, sélectionnez le champ personnalisé qui stocke les autres identificateurs. recherche ce champ en cas de reconnaissance du mot-clé entré dans le message de validation.

Configurer le modèle de validation

  1. Dans la page Détails du référentiel, développez la zone Modèle de validation. Assurez-vous d'avoir sélectionné la vue De base.
  2. Sélectionnez les valeurs suivantes<:hs>:

    Paramètre Description
    Mots-clés

    Modifie la liste des mots-clés utilisés par pour lier une validation à une anomalie, un user story ou une tâche. Si un mot de la liste figure dans le message de validation, les modifications de code sont automatiquement associées à une anomalie, un user story ou une tâche.

    Vous pouvez spécifier le champ dans lequel recherche des identificateurs. Reportez-vous à la section Associate code changes with alternative identifiers ci-dessus.

    Préfixe des ID

    Caractère ou texte qui précède les numéros d'élément de travail dans le message de validation.

    Exemples<:hs>: #, $, NUM

    Inclure le modèle de validation Tasktop par défaut

    Génère des messages de validation par défaut dans l'outil de validation du référentiel du développeur lorsque le plug-in Tasktop a été installé sur cet outil.

    Cette option est activée par défaut.

    Messages de validation respectant la casse

    Demande à de lire le message de validation en respectant la casse.

    Cette option est désactivée par défaut.

    Plusieurs anomalies, user stories ou tâches sont séparés par Spécifie le caractère qui sépare plusieurs numéros d'anomalie, user story ou tâche dans le message de validation.
    Les mots-clés se trouvent [Au début / N'importe où dans le message]

    Spécifie où recherche les mots-clés spécifiés dans les messages de validation.

    Message de validation utilisateur séparé par Spécifie le caractère qui indique que les commentaires du développeur suivent.

Utiliser un éditeur pour configurer le modèle de validation

  1. Dans la page Détails du référentiel, développez la zone Modèle de validation.
  2. Sélectionnez la vue Avancé.

    L'éditeur de texte inclut le code converti depuis les paramètres de la vue De base.

  3. Modifiez le code du modèle de validation. Pour ce faire, aidez-vous des exemples suivants.

    Exemple 1

    Modèle<:hs>:

    ([fixing] REGEX('defects?') IDLIST(DEFECT) | [implementing] REGEX('user stories?') IDLIST(REQ) ) : TEXT

    Exemple de message de validation<:hs>:

    "fixing defect #56721: something really serious was fixed"
    "defects #57893,#61432: division by zero"
    "user story #1: domains"
    Exemple 2

    Modèle<:hs>:

    (UNTIL(RE '((BUG)|(REQ))#') (IDLIST(DEFECT lead='((BUG)?#)?' sep=',' ) | IDLIST(REQ lead='((REQ)?#)?' sep=',' ) ) ){0,} [TEXT]

    Exemple de message de validation<:hs>:

    "This commit fixes BUG#1,#2 and implements REQ#4,REQ#5 making the product faster (resolving BUG#7)."

    Ce modèle correspond à toutes les entrées et tous les extraits de modèles 'BUG#' et 'REQ#' trouvés. Un tel modèle ouvert peut ne pas être adapté pour l'application de stratégies communes mais il peut être utile lorsque les données de référentiels hérités sont chargées en mode «<:hs>lecture seule<:hs>», par exemple, à des fins de création de rapports.

    Exemple 3

    Modèle Tasktop<:hs>:

    (REGEX('.*? - task DEF') IDLIST(DEFECT lead='' sep='') | REGEX('.*? - task REQ') IDLIST(REQ lead='' sep='') | REGEX('.*? - task TASK') IDLIST(TASK lead='' sep='')) : TEXT

    Correspond aux messages Tasktop par défaut<:hs>:

    "OPEN - task DEF10: http://host:9090/qcbin;DEFAULT;ALI_DEV-DEF10"
    "Incomplete - task REQ42: http://host:9090/qcbin;DEFAULT;ALI_DEV-REQ42"
  4. Utilisez les options suivantes pour configurer les modèles de validation avancés<:hs>:

    Option Description
    Comparer aux validations existantes Permet de tester le texte du modèle de validation avancé par rapport aux paramètres déjà entrés pour les validations de référentiel existantes.
    Messages de validation respectant la casse Applique le respect de la casse sur le texte de validation avancé.
    Restaurer les paramètres par défaut Annule vos modifications et remplace les mots-clés par défaut tels qu'ils s'affichaient avant vos modifications.
    Test Permet de tester l'intégrité de la syntaxe d'un message personnalisé avant de l'entrer dans le modèle de validation. Entrez votre texte dans le champ de modification en bas de l'onglet et cliquez sur Test.