Variáveis de execução

Para usar valores específicos em seus scripts de teste durante uma execução de teste, defina variáveis de execução em scripts de teste ou palavras-chave. Também é possível passar variáveis de execução de uma suíte de teste ou de um caso de teste para scripts de teste associados ou palavras-chave. Se você for administrador ou líder de teste, será possível configurar variáveis de execução no nível do projeto.

É possível usar variáveis de execução com todos os scripts manuais, scripts de linha de comandos e scripts JUnit Selenium. Se você usar um adaptador que suporta variáveis de execução, você poderá usá-las com scripts de teste automatizado. Para determinar se um adaptador suporta variáveis de execução, consulte a documentação específica do adaptador.

Variáveis de execução de nível de artefato e projeto

As variáveis de execução podem ser definições em níveis de projeto ou artefato. Se você for administrador do projeto e tiver permissão para salvar as variáveis de execução do projeto, será possível definir as variáveis de execução do projeto. As variáveis de execução do projeto têm conjuntos de valores que são definidos para uso nos artefatos de teste. Os autores de teste podem definir as variáveis de execução de artefato no contexto de suítes de teste, casos de teste e scripts de teste. Essas variáveis de execução de artefato de teste podem ter qualquer valor.
  • Para usar valores que estão presentes em toda uma suíte de teste ou caso de teste, defina variáveis de execução de artefato na seção Variáveis de Execução desse caso de teste ou suíte de teste.
  • Para usar uma variável de execução em um script de teste manual ou palavra-chave, defina a variável na seção Variáveis de Execução do editor de Teste Manual. Depois de definir uma variável, é possível inserir referências nela em um script de teste manual ou etapa de palavra-chave. Durante uma execução de teste, o valor atual da variável de execução substitui a referência na etapa.
  • Para configurar o valor de uma variável de execução específica, é possível inserir etapas de variável de execução em um teste manual ou palavra-chave. É possível criar e inserir uma etapa de variável de execução a partir da janela Variáveis de Execução. Durante uma execução de teste, você é solicitado a designar um valor para a variável de execução. Depois de configurar o valor, todas as referências a essa variável de execução terão o valor que você forneceu.
No nível de artefato, se os valores para a mesma variável forem definidos em vários locais, os valores da variável de nível mais alto substituirão os valores da variável de nível inferior. Por exemplo, uma variável é definida em uma suíte de teste e em um caso de teste que está dentro da suíte de teste. O valor da variável que é definida na suíte de teste substitui o valor inicial da variável que é definida no caso de teste. Em outro exemplo, uma variável é definida em um caso de teste e em um script de teste que está dentro do caso de teste. O valor da variável que é definida no caso de teste substitui o valor inicial da variável que é definida no script de teste.
  • Os valores das variáveis de execução da suíte de teste substituem os valores das variáveis de execução de caso de teste, script de teste e palavra-chave
  • Os valores das variáveis de execução de caso de teste substituem os valores das variáveis de execução de script de teste e palavra-chave
  • Os valores das variáveis de execução de script de teste substituem os valores das variáveis de execução de palavra-chave

Um artefato pode incorporar variáveis de execução de projeto e artefato. Entretanto, se duas ou mais dessas variáveis tiverem o mesmo nome, ocorrerá um conflito que impede o artefato de ser salvo. É possível alterar o nome de uma variável de execução de nível de projeto para corresponder ao nome de uma variável de execução de nível de artefato. Nesse caso, o valor da variável de nível de artefato substitui o valor da variável de nível de projeto quando o teste é executado.

Variáveis de execução em execuções de suítes de teste sequenciais

Se você executar suítes de teste sequenciais, será possível passar variáveis de execução de um script de teste para outro. Por exemplo, a primeira etapa em uma suíte de teste executa um script de teste que cria um usuário e configura uma variável de execução denominada userID. As etapas subsequentes na suíte de teste executam scripts de teste que referenciam o valor da variável de execução userID, atualizam as informações do usuário e verificam se as informações do usuário estão corretas. É possível ativar esse comportamento na seção Caso de Teste de uma suíte de teste ou na janela Executar Suíte de Teste.

Variáveis de Execução em Scripts da Linha de Comandos

Ao executar um teste da linha de comandos que inclui variáveis de execução, os valores das variáveis de execução são fornecidos como variáveis de ambiente para o processo que executa o teste da linha de comandos. Os nomes dessas variáveis de ambiente começam com "RQM_" para distingui-las de outras variáveis de ambiente.

Por exemplo, se uma suíte de teste contiver uma variável de execução denominada myVar, uma variável de ambiente denominada RQM_myVar será criada.
Lembre-se: Idealmente, os nomes de variáveis de execução incluem apenas identificadores Java válidos: A-Z, a-z, 0-9, _ e $. Se uma variável de execução contiver um identificador que não esteja em Java, um sublinhado (_) substituirá esse identificador no novo nome de variável de ambiente. Por exemplo, se você tiver uma variável de execução denominada user.Name, a variável de ambiente resultante será RQM_user_Name.
Além disso, uma variável de ambiente denominada RQM_ExecutionVariablesFile é criada e seu valor é um nome de caminho absoluto para um arquivo de texto; por exemplo, RQM_ExecutionVariablesFile=C:\Users\tneal.DEV\AppData\Local\Temp\QMAdapter1220694107401772431.vars. Esse arquivo contém pares de nome e valor: um para cada variável de execução definida quando o script de linha de comandos é executado. Por exemplo:

#Execution Variables
#Wed Mar 02 15:48:54 EST 2011
testcase2Var=set statically in testcase2
testcase1Var=set statically in testcase1
testsuite1Var=set statically in testsuite1

Quando o teste da linha de comandos é concluído, o arquivo de texto é lido. Se a suíte de teste permitir que variáveis de execução sejam passadas, o conteúdo será usado para passar os valores das variáveis de execução ao próximo script de teste. É possível modificar o arquivo de texto para criar variáveis de execução ou para alterar o valor das variáveis de execução que são passadas para outros scripts de teste.

Variáveis de Execução Integradas

Em alguns casos, seu teste poderá precisar recuperar mais informações sobre o ambiente de execução de teste no qual ele está em execução. Por exemplo, o teste pode precisar do nome da suíte de teste ou do caso de teste que está sendo executado. As variáveis de execução integradas fornecem informações sobre o ambiente. Para ativar variáveis integradas, selecione a caixa de seleção Incluir variáveis integradas na seção Variáveis de Execução do editor de script de teste.

Quando essa caixa de seleção é marcada, estas variáveis de execução extras são criadas:
RQM_TESTSCRIPT_NAME
RQM_TESTSCRIPT_WEBID
RQM_TESTCASE_NAME
RQM_TESTCASE_WEBID
RQM_TESTCASE_RESULT_WEBID
RQM_TESTCASE_RESULT_NAME
RQM_TESTSUITE_NAME
RQM_TESTSUITE_WEBID
RQM_TESTSUITE_RESULT_WEBID
RQM_TESTSUITE_RESULT_NAME
RQM_TESTPLAN_NAME
RQM_TESTPLAN_WEBID
RQM_TESTPHASE_NAME
RQM_TESTPHASE_WEBID
RQM_TESTCASE_EXECUTIONRECORD_NAME
RQM_TESTCASE_EXECUTIONRECORD_WEBID
RQM_SUITEEXECUTIONRECORD_NAME
RQM_SUITEEXECUTIONRECORD_WEBID
RQM_PROJECT_NAME
RQM_PROJECT_ALIAS
RQM_BUILDRECORD_NAME
RQM_BUILDRECORD_WEBID
RQM_BUILDDEFINITION_NAME
RQM_BUILDDEFINITION_WEBID
RQM_CONFIGURATION_NAME
RQM_CONFIGURATION_CPU
RQM_CONFIGURATION_BROWSER
RQM_CONFIGURATION_ADAPTER
RQM_CONFIGURATION_DATABASE
RQM_CONFIGURATION_APPLICATIONSERVER
RQM_CONFIGURATION_MANAGEMENTAGENT
RQM_CONFIGURATION_OS
RQM_CREATEDBY_USERID
RQM_CREATEDBY_NAME
RQM_LABRESOURCE_NAME
RQM_LABRESOURCE_WEBID


Tem um problema ou pergunta? Poste no fórum Jazz.net.