Création de fichiers de configuration pour exporter des artefacts de test Excel

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.
  1. Une définition de colonne ou de cellule, par exemple D ou D4
  2. Une chaîne littérale, par exemple "exécution"
  3. 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 :
    • Utilisez le mot clé XLSArtifactID pour indiquer un ID externe unique pour chaque opération d'exportation.
    • Modifiez le nom du fichier Excel ou le nom de la feuille de calcul Excel chaque fois que vous exportez.
    • Utilisez l'option Exporter vers un fichier lorsque vous démarrez l'exportation et modifiez le nom des fichiers XML, puis importez les fichiers XML dans Gestion de la qualité : connectez-vous à Gestion de la qualité et cliquez sur une des commandes suivantes :
      • Planification > Importer des plans de test
      • Construction > Importer des scénarios de test
      • Construction > Importer des scripts de test
      Conseil : Vous pouvez utiliser la méthode précédente uniquement pour importer des plans de test, des scénarios de test et des scripts de test.
  • 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.

Procédure


Commentaires