Ecriture de tâches STAX pour Rational Quality Manager

Software Testing Automation Framework Execution Engine (STAX) est un langage XML simple permettant d'écrire un code d'automatisation. Ce dernier est exécuté sur un serveur STAX central et peut utiliser des commandes Software Testing Automation Framework (STAF) pour interagir avec des machines de test.
Avant de commencer
Pour des informations détaillées sur l'utilisation et l'écriture de commandes STAX, voir le manuel STAX Service User's Guide disponible sur le site http://staf.sourceforge.net/current/STAX/staxug.html.
A propos de cette tâche
Une tâche est un élément d'automatisation unique. Elle possède un titre et une liste d'arguments. Chaque tâche correspond à un fichier XML STAX unique placé dans l'élément staxPath configuré dans le fichier integration_config.xml.
  1. Les fichiers STAX dans le dossier staxPath doivent être au format suivant :
    • <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE stax SYSTEM "stax.dtd">
      <stax>
      	<defaultcall function="myTask"/>
      	
      	<function name="myTask" scope="local">
      		<function-prolog>My Task Title</function-prolog>
      		
      		<function-epilog>
      			This is a description of My Task.
      		</function-epilog>
      		
      		<function-list-args>
      			<function-required-arg name="target">The target machine</function-required-arg>
      			<function-optional-arg name="MyArg1" default="'default1'">The first arg description</function-optional-arg>
      			<function-optional-arg name="MyArg2" default="'default2'">The second arg description</function-optional-arg>
      		</function-list-args>
      		
      		<sequence>
      			<!-- Rest of the automation code here -->
      
      			<return>0</return>
      		</sequence>
      	</function>
      </stax>
  2. Le fichier STAX doit spécifier l'élément <defaultCall> qui désigne la fonction principale de la tâche. Le fichier XML peut contenir plusieurs fonctions, mais seule defaultcall est exécutée par IBM® Rational Quality Manager.
  3. La fonction par défaut doit spécifier l'élément <function-prolog> qui doit contenir un titre court pour la tâche qui apparaît dans l'interface utilisateur.
  4. La fonction par défaut peut spécifier en option l'élément <function-epilog> qui contient une description détaillée de la tâche. Cette valeur n'est pas utilisée actuellement dans l'interface utilisateur, mais elle le sera peut-être à l'avenir.
  5. La fonction par défaut doit spécifier l'élément <function-list-args>.
  6. Rational Quality Manager transmet toujours le nom d'hôte de la machine cible comme premier argument. Le premier argument dans <function-list-args> doit être le suivant :
    • <function-required-arg name="target">The target machine</function-required-arg>
  7. Vous pouvez spécifier des arguments supplémentaires en utilisant des éléments <function-optional-arg>. Utilisez ces derniers à la place de <function-required-arg> (même si l'argument est obligatoire) car ils autorisent la spécification d'une valeur par défaut. Cette dernière apparaît dans l'interface utilisateur. L'attribut par défaut doit être une chaîne python (placée entre apostrophes) :
    • <function-optional-arg name="MyArg2" default="'default2'">The second arg description</function-optional-arg>
  8. L'élément final de la tâche doit être un élément <return> qui renvoie 0 en cas de réussite et une valeur différente de zéro en cas d'échec.

Retour d'informations