Gravando tarefas STAX para o Rational Quality Manager

O Software Testing Automation Framework Execution Engine (STAX) é uma linguagem XML simples que pode ser usada para gravar código de automação. O código de automação é executado em um servidor central do STAX e pode usar comandos do Software Testing Automation Framework (STAF) para interagir com as máquinas de teste.
Antes de Iniciar
Consulte o STAX Service User's Guide em http://staf.sourceforge.net/current/STAX/staxug.html para obter informações detalhadas sobre como usar e gravar comandos do STAX.
Por Que e Quando Desempenhar Esta Tarefa
Uma tarefa é uma parte única de automação. Ela possui um título e uma lista de argumentos. Cada tarefa corresponde a um arquivo XML único do STAX localizado no staxPath configurado no arquivo integration_config.xml.
  1. Os arquivos do STAX na pasta staxPath devem ter o seguinte formato:
    • <?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. O arquivo do STAX deve especificar o elemento <defaultCall>, apontando para a função principal da tarefa. O arquivo XML pode conter várias funções, mas apenas a função defaultcall é executada pelo IBM® Rational Quality Manager.
  3. A função padrão deve especificar o elemento <function-prolog>, que deve conter um título curto para a tarefa que é exibida na interface com o usuário.
  4. A função padrão pode opcionalmente especificar o elemento <function-epilog> que contém uma descrição detalhada da tarefa. Este valor não é usado atualmente na interface com o usuário mas pode ser usado no futuro.
  5. A função padrão deve especificar o elemento <function-list-args>.
  6. O Rational Quality Manager sempre transmite o nome do host da máquina de destino como o primeiro argumento. O primeiro argumento em <function-list-args> deve ser:
    • <function-required-arg name="target">The target machine</function-required-arg>
  7. Você pode especificar argumentos adicionais usando os elementos <function-optional-arg>. Use esses em vez do <function-required-arg> (mesmo se o argumento for necessário) porque eles permitem que um valor padrão seja especificado. Este valor padrão é exibido na interface com o usuário. O atributo padrão deve ser uma cadeia python (entre aspas simples):
    • <function-optional-arg name="MyArg2" default="'default2'">The second arg description</function-optional-arg>
  8. O elemento final da tarefa deve ser um elemento <return> que retorna 0 para ser transmitido, ou diferente de zero para falhar.

Feedback