Formatage des données d’exigence

Avant de pouvoir exporter les données d’exigence d’un document Word vers ALM, les données doivent être placées sous forme de paragraphes ou de tableaux. En outre, si vous voulez exporter des types d’exigence et des champs définis par l’utilisateur, vous devez tout d’abord importer leurs définitions depuis votre projet ALM.

Vous utilisez ensuite les boutons de la barre d’outils du complément Microsoft Word pour marquer les champs d’exigence. Vous pouvez formater les exigences de sorte que, lorsque vous les exportez vers ALM, les exigences se trouvent au même niveau hiérarchique ou à des niveaux hiérarchiques différents dans l’arborescence des exigences.

Placer les données d’exigence dans un document Word

Le document Word peut contenir des données d’exigence sous forme de paragraphes ou de tableaux.

Données sous forme de paragraphes

Lorsque les données sont fournies sous forme de paragraphes, chaque champ de l’exigence doit figurer sur une ligne distincte. Pour chaque exigence, le nom de l’exigence doit apparaître en premier, suivi des autres champs d’exigence. L’exemple suivant montre les données pour deux exigences placées sous forme de paragraphes :

Données sous forme de tableaux

Lorsque le document contient un tableau, chaque ligne doit contenir les données d’une exigence. La première colonne doit être le nom de l’exigence. L’exemple suivant montre les données pour les deux mêmes exigences, figurant dans un tableau :

Retour en haut

Importer des types d’exigence

Vous pouvez importer les définitions de types d’exigence et leurs champs définis par l’utilisateur associés, d’un projet ALM vers votre document Word. Vous pouvez ensuite définir et exporter le type d’exigence pour chaque exigence dans votre document Word. Après avoir défini un type d’exigence pour une exigence, vous pouvez exporter des valeurs pour des champs définis par l’utilisateur qui sont disponibles pour les exigences de ce type.

Pour importer des types d’exigence depuis un projet ALM :

  1. Cliquez sur pour ouvrir l’Assistant de définitions des types d’exigence.

  2. Saisissez votre URL ALM au format http://<nom du serveur ALM>[:port]/qcbin et cliquez sur Next.

    Pour les utilisateurs ayant recours à l’authentification unique, activez Add basic auth header mode.

    Note : Le mode d’en-tête Ajouter une authentification de base est facultatif, et ne doit être activé que si vous obtenez un message réponse non valide du serveur.

  3. Saisissez votre nom et votre mot de passe ALM et cliquez sur Next.

  4. Sélectionnez un domaine et un projet ALM et cliquez sur Import.

    Le complément importe les types d’exigence et les champs définis par l’utilisateur à partir du projet ALM.

  5. Une fois que le complément a importé les types d’exigence et les champs définis par l’utilisateur, la boîte de dialogue Assistant de définitions des types d’exigence - Étape 5 sur 5 s’ouvre. Cliquez sur Finish. Les types d’exigence et les champs définis par l’utilisateur sont mis à jour dans le document Word.

Retour en haut

Marquer des champs d’exigence

Après avoir placé vos données sous forme de paragraphes ou de tableaux, vous devez marquer vos champs d’exigence. Pour marquer un champ d’exigence, mettez le texte en surbrillance et cliquez sur le bouton approprié dans la barre d’outils Exigences d’ALM. Une icône est ajoutée en regard de la ligne de texte marqué. Un signet est inséré dans le document pour permettre au complément d’identifier le texte marqué lorsqu’il est exporté vers ALM.

Lorsque vous marquez des champs d’exigence, tenez compte de ce qui suit :

  • Pour chaque exigence, le nom de l’exigence doit être fourni. Vous pouvez également exporter le type d’exigence, le statut de l’examen, l’auteur, la priorité, la description et le texte enrichi. En outre, si vous exportez le type d’exigence, vous pouvez exporter des données pour des champs définis par l’utilisateur disponibles pour ce type.

  • Si une exigence portant le même nom existe dans l’arborescence des exigences, les champs de l’exigence sont modifiés pour contenir les nouvelles valeurs. Si votre document contient deux exigences, au même niveau hiérarchique, portant le même nom, seule la deuxième exigence est créée.

  • Si le statut de l’examen n’est pas fourni, la valeur par défaut est Not Reviewed.

  • Les données de chaque champ doivent figurer sur la même ligne que l’icône qui marque le champ. Les seules exceptions concernent le champ Description, les champs définis par l’utilisateur de type mémo, et le texte enrichi.

    Champ de description

    Les données peuvent s’étendre jusqu’à des lignes supplémentaires et peuvent inclure des retours et des retraits.
    Champs définis par l’utilisateur de type mémo Les données peuvent s’étendre jusqu’à des lignes supplémentaires mais seule la première ligne est exportée vers ALM.
    Données de texte enrichi

    Les données peuvent inclure tout contenu que vous pouvez inclure dans un document Word normal. Lorsque les données de texte enrichi sont exportées vers ALM, elles sont ajoutées en tant que pièce jointe à l’exigence. La pièce jointe est nommée Legacy_Rich_Content.doc.

    Note : À chaque nouvelle exportation de cette exigence vers ALM, le fichier Legacy_Rich_Content.doc est remplacé.

  • Les données destinées aux champs ALM qui comportent des listes de sélection doivent correspondre exactement aux entrées de ces listes de sélection. Par exemple, le champ Priorité ne peut accepter qu’une seule des entrées suivantes : 5-Urgente, 4-Très élevée, 3-Élevée, 2-Moyenne, ou 1-Basse.

  • Vous ne pouvez pas exporter des données pour des champs définis par l’utilisateur qui n’existent pas dans le projet ALM ou qui ne sont pas disponibles pour le type d’exigence.

Pour marquer les champs d’exigence :

  1. Ouvrez un document Word contenant du texte d’exigence.

  2. Vous pouvez utiliser le vérificateur de structure pour vous assurer que vous n’insérez pas de signets qui invalident la structure. Par exemple, le vérificateur de structure s’assure que vous n’ajoutez pas plus d’un nom à une exigence, ou que vous ne fermez pas une exigence avant de l’avoir ouverte. Pour activer ou désactiver le vérificateur de structure, dans la barre d’outils ALM Exigences, cliquez sur le bouton Turn On Structure Checker ou Turn Off Structure Checker.

  3. Mettez en surbrillance une ligne de texte ou une cellule de tableau dans votre document, puis cliquez sur le bouton approprié dans la barre d’outils Exigences d’ALM :

    Champ Bouton de la barre d’outils Icône
    Nom de l’exigence
    Statut de l’examen de l’exigence
    Auteur de l’exigence
    Priorité de l’exigence
    Description de l’exigence

  4. Pour affecter une exigence à un type, ajoutez et mettez en surbrillance une nouvelle ligne de texte dans les données de l’exigence, ou ajoutez une nouvelle colonne de tableau et mettez en surbrillance la cellule de la nouvelle colonne correspondant à l’exigence. Dans la barre d’outils Exigences d’ALM, dans la zone Type, sélectionnez un type d’exigence. Cliquez sur le bouton Type pour ajouter le type d’exigence au document. Le type d’exigence est ajouté et est indiqué par l’icône Type d’exigence .

  5. Pour affecter une valeur à un champ défini par l’utilisateur, mettez en surbrillance la ligne de texte ou la cellule de tableau dans votre document contenant la valeur. Dans la barre d’outils Exigences d’ALM, dans la zone Field, sélectionnez un champ défini par l’utilisateur. Cliquez sur le bouton Field pour marquer la valeur avec l’icône Champ défini par l’utilisateur .

  6. Pour ajouter du texte enrichi à exporter vers ALM, mettez le texte enrichi en surbrillance et cliquez sur le bouton Open Rich Text. L’icône Ouvrir le texte enrichi est ajoutée pour indiquer le début du texte enrichi.

    Placez le curseur à la fin du texte enrichi que vous souhaitez ajouter et cliquez sur le bouton Close Rich Text. L’icône Fermer le texte enrichi est ajoutée pour indiquer la fin du texte enrichi.

  7. Répétez l’opération pour toutes les données d’exigence. Tout texte qui n’est pas marqué dans le document est ignoré.

  8. Cliquez sur le bouton Close Requirement pour fermer chaque exigence avec l’icône Close Requirement . L’emplacement de cette marque dépend du fait que les exigences se trouvent au même niveau hiérarchique ou à des niveaux hiérarchiques différents.

    Pour plus d’informations, voir Exemple : exigences au même niveau hiérarchique ou Exemple : exigences à différents niveaux hiérarchiques..

  9. Pour annuler la marque d’un ou plusieurs champs, utilisez les boutons d’annulation ou supprimez la marque manuellement. Pour plus d’informations, voir Suppression du formatage d’un document Word.

  10. Lorsque tous les champs d’exigence ont été marqués, exportez les exigences vers ALM. Pour plus d’informations, voir Exportation de données de Microsoft Word vers ALM.

Retour en haut

Exemple : exigences au même niveau hiérarchique

Pour définir des exigences au même niveau hiérarchique dans l’arborescence des exigences, utilisez le bouton Close Requirement pour placer la marque Close Requirement directement après chaque exigence. Cela permet de placer une exigence au même niveau que l’exigence précédente.

Lorsque le document contient des paragraphes, insérez une ligne après la dernière ligne de l’exigence et marquez-la à l’aide de la marque Close Requirement :

Lorsque le document contient un tableau, ajoutez une colonne à la fin du tableau, et insérez la marque Close Requirement pour chaque exigence :

Après avoir exporté les exigences vers ALM, les exigences sont affichées au même niveau hiérarchique, sous l’exigence racine.

Retour en haut

Exemple : exigences à différents niveaux hiérarchiques

Vous pouvez définir une exigence afin qu’elle soit une exigence enfant de l’exigence précédente. Utilisez le bouton Close Requirement pour placer la marque Fermer l’exigence de l’exigence parent après toutes ses exigences enfants.

Par exemple, pour définir Req_2 comme enfant de Req_1, et Req_3 et Req_4 comme enfants de Req_2, placez la marque Fermer l’exigence pour Req_2 après les définitions de ses exigences enfants. Placez la marque Fermer l’exigence pour Req_1 à la toute fin.

Lorsque le document contient des paragraphes, placez chaque marque Fermer l’exigence sur sa propre ligne à l’emplacement approprié. Notez que les marques Fermer l’exigence pour Req_1 et Req_2 sont insérées après Req_3 et Req_4.

Lorsque les données sont fournies sous forme de tableau, ajoutez une colonne à la fin du tableau et placez chaque marque Fermer l’exigence à l’emplacement approprié :

Après avoir exporté les exigences vers ALM, Req_2 est affichée en tant qu’enfant de Req_1, et Req_3 et Req_4 sont affichées en tant qu’enfants de Req_2.

Retour en haut

Étapes suivantes :