Lorsque vous exportez un artefact de test Microsoft Excel, vous devez avoir un fichier de configuration pour définir comment mapper le fichier XML à un artefact de gestion de la qualité.
Pourquoi et quand exécuter cette tâche
Les fichiers de configuration contiennent des instructions qui associent des informations d'artefact Gestion de la qualité aux emplacements des données. Chaque instruction dans un fichier de configuration est constituée de deux membres reliés par un signe égale. Le membre de gauche de l'instruction se compose de mots clé. Il y a trois possibilités pour le membre à droite du signe égale d'une configuration.
- Une définition de colonne ou de cellule, par exemple D ou D4
- Une chaîne littérale, par exemple "exécution"
- Une référence à un autre artefact (auto-référence), par exemple testscript.description
Pour définir une ligne ou une cellule, insérez simplement l'identificateur de colonne ou l'identificateur de cellule :
testscript.dc:title=G
Pour définir une chaîne littérale, placez-la simplement entre guillemets :
testscript.steps.type="exécution"
Pour définir une auto-référence, insérez simplement les informations du membre à gauche du signe égale d'une ligne définie précédemment :
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
Remarque : Les auto-références sont utilisées pour créer des artefacts qui utiliseront des données déjà utilisées par un autre artefact et créeront un lien vers cet artefact. Les auto-références ne peuvent pas être utilisées avec le mot clé XLSLink.
Mots clé et cas spéciaux
Plusieurs mots clé vont à gauche du signe égale. Ils commencent tous par "XLS" et occupent l'espace d'une zone après l'artefact. Ils sont définis de la façon suivante :
- XLSStartRow définit après quelle ligne commencent les données d'artefact.
- XLSDelimeter définit l'élément qui désigne l'artefact suivant (actuellement, seul \n est pris en charge).
- XLSLink indique que l'artefact est lié à tous les artefacts du type indiqué à l'intérieur de la feuille de travail.
- XLSLinkReverse commande à l'utilitaire d'exportation de placer le lien XML dans l'artefact et non dans celui qui fait le lien. Utilisez ce mot clé uniquement avec des liens d'auto-référence. Utilisez ce mot clé lorsque vous créez un artefact à partir d'un autre (par exemple : requirement.dc:title=testcase.dc:title), mais que vous avez besoin que le lien soit créé dans l'artefact qui est l'original (celui à droite du signe égale). Si vous définissez requirement.XLSLinkReverse=true, le lien est placé dans l'artefact principal et non dans celui définissant le lien d'auto-référence.
- XLSArtifactID indique l'ID externe de l'artefact. Si l'ID externe de l'artefact n'est pas indiqué, un ID externe par défaut est affecté avec le format suivant :
Nom du fichier Excel_Nom de la feuille de calcul Excel[_nombre_artefacts].xml
où nombre_artefacts est le nombre d'artefacts dans un seul tableur si le tableur contient plusieurs artefacts. Si le tableur contient un seul artefact, cet argument n'est pas nécessaire.Important : Si le tableur contient un artefact avec le même
ID externe qu'un autre artefact, l'artefact est mis à jour d'après le contenu du tableur. Par exemple, si vous exportez plusieurs fois le même tableur Excel avec la même configuration, l'
ID externe est mis à jour chaque fois.
ATTENTION :
Si vous utilisez artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2" alors que la valeur est indiquée en tant que chaîne (et non en tant que cellule), vérifiez qu'il n'y a pas de feuille blanche et que artifact.XLSWorksheetID n'est pas utilisé pour désigner la feuille de travail afin de lire le XLSArtifactID.
Pour créer de nouveaux artefacts, lorsque vous exportez les mêmes fichiers Excel vers le même référentiel, exécutez une des opérations suivantes :
- XLSWorksheetID indique le nom de la feuille de calcul à traiter. Vous devez utiliser une chaîne littérale pour ce mot clé.
Remarque : A partir de la version 4.0, la syntaxe pour
testsuite lié à
testcases a été modifiée de
testsuite.testcases=testcase
en
testsuite.XLSLink=testcase
- Voici quelques exemples :
- testscript.XLSStartRow=7
- testscript.title=B
- testscript.steps.type="exécution"
- testscript.steps.description=B
- testscript.steps.title=B
- testscript.steps.name=B
- testscript.steps.expectedResult=F
- testscript.XLSDelimeter=\n
- testcase.dc:title=C1
- testcase.dc:description=C2
- testcase.XLSLink=testscript
- testcase.XLSArtifactID=D1
- testcase.XLSWorksheetID="test_case_1"
Les étapes de script, catégories, sections, exportations d'image, recherches dynamiques d'un mot ou d'une phrase et l'accès aux propriétés de tableur sont des cas spéciaux. Une étape de script nécessite plusieurs zones pour chaque étape.
Comme un script peut comporter de nombreuses étapes, toutes les lignes sont considérées comme une seule étape jusqu'à ce que soit rencontrée une ligne vierge, qui marque le début de l'étape suivante.
Les sections sont des cas spéciaux, pour en simplifier l'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")=C
Cet exemple d'entrée de configuration remplit la section des critères d'acceptation qui est intégrée dans l'application Quality Management.
- Pour déterminer le nom ou le nom affiché de sections prédéfinies :
- Mettez à jour la section prédéfinie d'une ressource dans Gestion de la qualité.
- Lisez la ressource comme XML avec abbreviate=false.
- Recherchez l'élément dans le document XML portant le nom de section, par exemple : com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria.
- Recherchez l'attribut extensionDisplayName dans l'élément qui contient le nom affiché de la section, par exemple RQM-KEY-TC-ACCEPT-CRITERIA-TITLE.
- Pour définir une section personnalisée, remplacez le premier paramètre par un nom valide et le deuxième paramètre par un nom affiché :
testcase.Section("myns:mysection","my custom section")=C
- Pour définir une catégorie, utilisez le formatcategory term=category_name.value=category_value :
testcase.category term="Function".value=H
- Pour ajouter un attribut personnalisé à un artefact : si nous avons deux customAttributes, testcaseCustomAttribute1 et testcaseCustomAttribute1 dans un scénario de test, les customAttributes testcaseCustomAttribute1 et testcaseCustomAttribute2 doivent être créés dans Gestion de la qualité avant d'exécuter l'importateur Excel de Gestion de la qualité.
Nous pouvons configurer le fichier .cfg comme suit :
testcase.customAttributes.type="SMALL_STRING" //définir le type d'attribut personnalisé (type de données).
testcase.customAttributes.identifier=A //placer un identificateur dans la colonne A d'Excel. L'identificateur correspond au nom de l'attribut lorsque vous le créez. Par exemple, lorsque vous créez le customerAttribute à l'aide du nom "name1" et que vous le changez en "name2" par la suite, l'identificateur "name1" est conservé sur le serveur de Gestion de la qualité.
Si vous définissez l'identificateur d'attribut personnalisé sous forme de Numéro_attribut_personnalisé_ et que le premier attribut est Attribut_personnalisé_0_ et le deuxième Attribut_personnalisé_1_, cet identificateur sera correct lorsqu'il est inséré dans la cellule Excel.
testcase.customAttributes.name=B //placer le nom d'attribut dans la colonne B
testcase.customAttributes.value=C //placer la valeur d'attribut dans la colonne C ; voici le résultat :
<customAttributes>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_0_</identifier>
<name>testcaseCustomAttribute1</name>
<value>111111111111111111111111111</value>
</customAttribute>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_1_</identifier>
<name>testcaseCustomAttribute2</name>
<value>3333333333333333333333333</value>
</customAttribute>
</customAttributes>
Un nouvel exemple TestCases 001 avec custom attributes.xls et TestCases 001 avec custom attributes.cfg ont été ajoutés.
- Pour accéder aux propriétés du tableur dans lequel vous travaillez, utilisez les lignes suivantes :
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 Excel 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 Requirements001 à l'aide des propriétés de document.
- Pour exporter des images à partir d'Excel, tenez compte des aspects suivants des images dans les tableurs :
L'emplacement des images dans Excel est représenté par la cellule qui contient le coin supérieur gauche de l'image. Même si une image occupe plusieurs cellules, vous devez indiquer la cellule qui contient le coin supérieur gauche de l'image pour exporter l'image. Les cellules peuvent contenir un nombre illimité d'images. Si vous indiquez la cellule qui contient le coin supérieur gauche de toutes les images, toutes les images seront exportées.
Dans Excel, vous pouvez exporter des images de deux manières. La première méthode consiste à utiliser la fonction d'image. L'image est configurée comme une fonction à placer après le signe égale dans une entrée de fichier de configuration. Les images peuvent être définies par la cellule ou par la ligne. La fonction d'image insère une image dans la zone RTF à laquelle elle est affectée. Si l'attribut n'utilise pas une zone RTF, la fonction d'image sera ignorée. Examinez les exemples suivants de fonction d'image :
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
La deuxième méthode consiste à utiliser l'attribut de pièce jointe :
- testcase.attachment=C4
- testcase.attachment=C
L'attribut de pièce jointe ajoute des images en tant que pièces jointes à l'artefact au lieu d'insérer l'image dans des zones RTF.
Les fichiers d'exemple .xls et .cfg correspondants sont respectivement appelés Scénarios de test réalisés à partir de scripts avec des images et Scénarios de test réalisés à partir de scripts avec des pièces jointes.