Lorsque vous exportez un artefact de test Microsoft Word, vous devez avoir un fichier de configuration pour définir comment mapper le fichier XML sur un artefact de gestion de la qualité.
Procédure
Remarque : Le membre à droite du signe égale d'une entrée de configuration doit contenir une chaîne littérale, un tableau ou une définition de structure.
Un tableau se caractérise par une entrée Table(. Une liste se caractérise par une entrée List(. Les deux entrées doivent se terminer par une parenthèse fermante ()).
Pour créer un mappage :
- Créez une définition de structure : la définition de contenu pour une liste de structure peut se composer d'un niveau de retrait ou d'un caractère générique unique se caractérisant par un astérisque (*). Un niveau de retrait est un entier, alors que le caractère générique doit être placé entre guillemets. Les deux peuvent être définis plus précisément par un numéro de paragraphe spécifique après une virgule.
L'exemple suivant commande à l'utilitaire d'exportation de rechercher une structure dont le titre corresponde au pattern "1.*." et prenne uniquement le premier paragraphe de cette structure comme titre du scénario de test :
testcase.dc:title=List("1.*.",1)
Si vous omettez la virgule et le numéro, tout le contenu du niveau hiérarchique est placé dans la zone de titre.
Si vous utilisez un entier sans guillemets, l'utilitaire d'exportation utilise le contenu avec le nombre indiqué de retraits :
testcase.dc:title=List(1,1)
- Créez une définition de tableau : un tableau est défini par le numéro auquel il se trouve ou par le contenu de la première cellule.
Un tableau que vous définissez par un numéro est statique, de sorte que chaque artefact qui utilise ce tableau renvoie toujours à ce tableau précis. Un tableau nommé est dynamique, c'est-à-dire que si vous avez dans le document plusieurs tableaux qui correspondent au texte, plusieurs artefacts sont créés. Une fois qu'un tableau a été défini, il doit être suivi d'un point et d'une référence de cellule ou de colonne, de la même manière qu'est définie une cellule ou colonne Excel.
L'exemple suivant définit un tableau statique et une cellule statique :
testscript.dc:title=Table(1).B3
Un tableau dynamique correspond au début du texte dans la première cellule du tableau. La fonction de correspondance est sensible à la casse, mais ignore les espaces. Cet exemple extrait des informations des colonnes B de tous les tableaux dont la première cellule commence par "Step" :
testscript.steps.title=Table("Step").B
- Créez des liens faisant référence à eux-mêmes : pour définir une auto-référence, indiquez les informations du membre à gauche du signe égale d'une ligne précédemment définie :
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
Conseil : Utilisez les auto-références pour créer des artefacts qui utilisent des données qui sont déjà utilisées par un autre artefact et pour créer un lien vers cet artefact.
- Utilisez des mots clés : le mot clé XLSLink indique que l'artefact est lié à tous les artefacts du type indiqué dans le document. Dans cet exemple, tous les scripts de test dans le document sont liés à tous les scénarios de test :
testcase.XLSLink=testscript
Utilisez les mots clé
DOCStart et
DOCStop pour indiquer à quelle définition de liste commencer et à laquelle arrêter. Ces mots clé sont utilisés uniquement pour les types de liste et doivent contenir un littéral chaîne. Dans l'exemple suivant, l'entrée de configuration commence à traiter la liste lorsque le cinquième élément est trouvé et arrête le traitement lorsque le douzième élément de la liste est trouvé. Il s'agit de correspondances exactes : l'élément de liste "12.1" ne met pas fin au processus.
testscript.DOCStart="5."
testscript.DOCStop="12."
- Modifier les données : toute définition cible peut être placée à l'intérieur d'un modificateur Pre().
Les exemples suivants placent les données résultantes à l'intérieur de balises <div> et <pre>, qui préservent les informations de formatage :
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre(Table(1).C)
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre("ceci est mon texte)
Les sections sont un cas spécial pour simplifier leur utilisation et pour empêcher que leurs définitions n'interfèrent avec la notation à point utilisée sinon.
Pour mettre à jour une section, utilisez le format suivant :
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
L'entrée précédente remplit la section des critères d'acceptation qui est intégrée dans l'application Quality Management.
Voir la procédure pour indiquer le nom ou le nom affiché des sections prédéfinies dans la rubrique suivante :
Création de fichiers de configuration pour exporter des artefacts de test Excel. Pour définir une section personnalisée, remplacez le premier paramètre par un nom valide et remplacez le deuxième paramètre par un nom affiché :
testcase.Section("myns:mysection","my custom section")=Table(1).C
Les catégories sont définies avec la notation
category term=category_name.value=category_value.
Le nom de catégorie est placé entre guillemets :
testcase.category term="Function".value=Table(1).H
Utilisez la perluète (
&) pour ajouter plusieurs bits de données à la même zone. Les données peuvent être une combinaison d'éléments. Cet exemple montre des données ajoutées :
testcase.description=”my description:” & Table(1).H & testscript.description
- Accédez aux propriétés de document du fichier à exporter : suivez ces exemples pour accéder aux propriétés de document Word du fichier :
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
Vous pouvez trouver les propriétés disponibles qui sont intégrées dans Microsoft Office à l'adresse http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx.
Trois autres propriétés sont aussi disponibles : “Name,” “Full Name” et “Location.”
Si la propriété n'a pas été définie ou si Word ne prend pas en charge la propriété, la propriété ("nom de la propriété") renvoie la chaîne vide : "".
Les fichiers d'exemple .xls et .cfg correspondants sont appelés "Script de test dans les tableaux utilisant les propriétés du document."
Exemple
Pour la version 4.0 : la conception et l'artefact dans la liste ont été modifiés de façon à prévoir une séparation par
\n, un
\n ne pouvant donc figurer à l'intérieur d'un artefact, comme le montre cet exemple :
1. titre
1.1 titre scénariotest1
1.1.1 référence scripttest1 au scénariotest1
1.1.1.1 titre scripttest1 étape1
1.1.1.1.1 description scripttest1 étape1
1.1.1.1.2 attendrerésultat scripttest1 étape1
1.1.1.2 titre scripttest1 étape2
1.1.1.2.1 description scripttest1 étape2
1.1.1.2.2 attendrerésultat scripttest1 étape2
1.1.1.3 titre scripttest1 étape3
1.1.1.3.1 description scripttest1 étape3
1.1.1.3.2 attendrerésultat scripttest1 étape3
1.1.1.4 titre scripttest1 étape4
1.1.1.4.1 description scripttest1 étape4
1.1.1.4.2 attendrerésultat scripttest1 étape4
1.2 titre scénariotest2
1.2.1 référence du testscript2 au scénariotest2
1.2.1.1 titre testscript2 étape1
1.2.1.1.1 description testscript2 étape1
1.2.1.1.2 attendrerésultat testscript2 étape1
1.2.1.2 titre testscript2 étape2
1.2.1.2.1 description testscript2 étape2
1.2.1.2.2 attendrerésultat testscript2 étape2
1.2.1.3 titre testscript2 étape3
1.2.1.3.1 description testscript2 étape3
1.2.1.3.2 attendrerésultat testscript2 étape3
1.2.1.4 titre testscript2 étape4
1.2.1.4.1 description testscript2 étape4
1.2.1.4.2 attendrerésultat testscript2 étape4
La ligne vierge entre les deux titres de scénario de test correspond à la séparation entre les scénarios de test.