Interface da linha de Comandos do Functional Tester

A maioria das ações que podem ser executadas a partir da interface gráfica com o usuário do Functional Tester também podem ser executadas a partir da linha de comandos. incluindo:

Essas ações incluem:

Formato Núcleo da Linha de Comandos

Os formatos principais da linha de comandos são:

java <opções_java_padrão> -classpath rational_ft.jar com.rational.test.ft.rational_ft <opções_do_Functional_Tester> ou
java <opções_java_padrão> -jar rational_ft.jar <opções_do_Functional_Tester>

A variável opções Java padrão refere-se às opções da linha de comandos Java™, como -classpath <caminho_de_classe> para configurar o caminho de classe corretamente.

-classpath
Se utilizar o primeiro formato de linha de comando, inclua explicitamente o rational_ft.jar no caminho de classe. Ele pode ser localizado no diretório de instalação do Functional Tester. Se você utilizar o segundo formato da linha de comandos, especifica o caminho completo para o arquivo rational_ft.jar depois da opção -jar. Não é necessário especificar um caminho de classe ou a classe para executar (com.rational.test.ft.rational_ft ). Se estiver utilizando o Functional Tester juntamente com o PurifyPlus, utilize o primeiro formato da linha de comandos.

Consulte a Referência à API do Functional Tester (com/rational/test/ft/rational_ft) para obter uma lista completa das opções da linha de comandos.

-projectpath
Se você tiver dependências em um projeto, então deverá inclui o caminho do projeto usando a opção -projectpath.

Opções Comumente Utilizadas

A seguir, a lista as opções mais comumente usadas:

-datastore <diretório_do_armazém_de_dados>
Use esta opção sempre que um script for especificado, por exemplo, use-a com -record ou -playback.
-record <nome_do_script>
Use esta opção para gravar um novo script (ou em conjunto com -insertafter <line number> para inserir a gravação em um script existente). O nome do script não é um nome de arquivo. É um nome de classe completo que utiliza o caractere de ponto (.) para separar o pacote/espaço de nomes e o nome de classe do script. Você pode usar -record <script name> para gravar scripts Java ou VB.NET, dependendo do tipo de projeto.
-playback <nome_do_script>
Use esta opção para reproduzir um script Java. Você deve especificar a opção de reprodução no final do comando. O Rational Functional Tester ignora quaisquer argumentos especificados após a opção de reprodução.
-edit <arquivo> ou -display <arquivo>
Use esta opção para editar ou visualizar um ponto de verificação ou um mapa de objetos do Functional Tester. O <arquivo> pode ser um nome de arquivo completo (com o caminho do diretório). Utilize aspas duplas se o nome ou o caminho incluir caracteres de espaço.
-enable
Use esta opção para abrir a caixa de diálogo Ativar Ambientes e ativar um ambiente específico.
-appconfig
Use esta opção para abrir a caixa de diálogo Ferramenta de Configuração do Aplicativo.
-inspector
Use esta opção para abrir a caixa de diálogo Inspetor de Objeto de Teste.

Exemplos de uso da linha de comandos

Nestes exemplos, -classpath deve apontar para os arquivos rational_ft.jar.

Nota: Os valores <nome_do_script> utilizam as convenções padrão de nomenclatura do pacote Java ou do espaço de nomes .NET, como package.MyScript ou Namespace.MyScript.

Grave um novo script:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> [ -map <mapa_compartilhado>] [options] -record <nome_do_script>

Grave em um script existente, inserindo antes ou após de uma linha específica:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> [ -insertbefore <linha>] [ -insertafter <linha>] [options] -map <mapa_compartilhado>] [options] -record <nome_do_script>

Compile um script:

Nota: Você deve ativar o ambiente Java antes de compilar um script com este comando. Instale o Java SDK e inclua o diretório bin no caminho.
java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> [options] -compile <nome_do_script>

Reproduza um script, transmitindo argumentos da linha de comandos <valores> para o script:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -log <nome_do_registro> [options] -playback <nome_do_script> [ -args <valores>]

Reproduzir um script que utilize classes de outros projetos de teste funcional:

java -classpath <caminho_da_classe> com.rational.test.ft.rational_ft -datastore <diretório> -projectpath <caminho_do_projeto_de_referência> -playback <nome_do_script>

Reproduza um script que utilize outras classes para os projetos de teste funcional:

java -projectpath <projectpath> com.rational.test.ft.rational_ft -datastore <directory> -projectpath <reference-project-path> -playback <script-name>

Reproduzir um script que tenha um datapool associado:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -iterationCount <valor de iteração> -playback <nome_do_script>

Grave, compile e reproduza um script:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> [options] -record <nome_do_script> -compile -playback [ -args <valores>]
Nota: Para reproduzir scripts com VPs dinâmicos, inclua -rt.interative true antes de -playback na linha de comandos.

Construa um script vazio:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -map <nome_do_mapa_compartilhado> [options] -create <nome_do_script>

Gere o arquivo auxiliar novamente para um script:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -helper <nome_do_script>

Gere novamente todos os arquivos auxiliares para um armazém de dados:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -regenHelpers <nome_do_script>

Exiba um arquivo de mapeamento de objetos:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -display <nome_do_arquivo_do_mapa_de_objetos>

Exiba um arquivo de ponto de verificação:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -display <nome_do_arquivo_do_ponto_de_verificação>

Edite um arquivo de mapeamento de objetos:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -edit <nome_do_arquivo_do_mapa_de_objetos>

Edite um arquivo de ponto de verificação:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -edit <nome_do_arquivo_do_ponto_de_verificação>

Crie e edite um mapa de objetos compartilhados:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -fromMap <nome_do_arquivo_do_mapa_de_objetos1> -createMap <nome_do_arquivo_do_mapa_de_objetos2>

Mescle uma versão posterior de um mapa de objetos em uma versão atual (modificada) do mesmo mapa:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -from <nome_do_arquivo_do_mapa_de_objetos1> -to <nome_do_arquivo_do_mapa_de_objetos2> -original <nome_do_arquivo_do_mapa_de_objetos1> -mergeMap

Compare o resultado de um ponto de verificação real ao resultado de um ponto de verificação esperado:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -datastore <diretório> -baseline <nome_do_arquivo_do_ponto_de_verificação_da_linha_de_base> -compare <nome_do_arquivo_do_ponto_de_verificação_esperado> <nome_do_arquivo_do_ponto_de_verificação_real>

Ative um navegador configurado, o ambiente Java ou a plataforma Eclipse:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -enableName <navegador/ambiente_Java/Eclipse>

Desative todos os navegadores configurados, ambientes Java e plataformas Eclipse:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -disableall

Execute a Ferramenta de Configuração de Aplicativos:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -appConfig <nome_do_aplicativo>

Execute o Inspetor do Objeto de Teste:

java -classpath <caminho_de_classe> com.rational.test.ft.rational_ft -inspector

Execute a Ferramenta de Configuração de Propriedades do Objeto:

java -classpath <caminho da classe> com.rational.test.ft.rational_ft -objectlibraryou

Executando o Functional Tester no Modo em Lote Não Assistido

Se o TestManager estiver instalado e você desejar executar o Functional Tester não-assistido em modo de batch com um log do TestManager, será necessário incluir as seguintes opções na linha de comandos do rational_ft:

-user username
O nome do usuário do TestManager para o login.
-password password
Opcional. A senha do TestManager para o login. Não use isso se nenhuma senha tiver sido configurada.
-project caminho completo e nome completo do projeto
O nome do projeto TestManager, que é precedido por seu caminho completo. Essa opção faz distinção entre maiúsculas e minúsculas.
-build build
O nome de uma construção existente do TestManager. Consulte Nota a seguir.
-logfolder foldername
O nome de uma pasta de log existente do TestManager (consulte Nota a seguir) ou a especificação de arquivo para um log HTML ou de texto. Se você utiliza o nome da pasta de log HTML ou de texto, não será necessário especificar a construção.
Nota: Se você desejar criar um log do TestManager, certifique-se de criar a construção do TestManager e as pastas de log do TestManager primeiro. Se essas duas pastas não existirem, a execução falhará quando você executar o Functional Tester não-assistido em modo de batch.
-log logname
O nome do log HTML ou de texto do TestManager. Se você utiliza o nome do log HTML ou de texto, não será necessário especificar a construção.

Exemplos:

Executar um script no Windows®

	java -classpath "C:\IBM\RFT\FunctionalTester\bin\rational_ft.jar" 
	com.rational.test.ft.rational_ft -datastore \\My_project\AUser\RobotJProjects -user admin -project
	\\My_project\AUser\TestManagerProjects\Test.rsp -build "Build 1" -logfolder "Default" -log 	
	"Al_SimpleClassicsA#1" -rt.log_format "TestManager" -rt.bring_up_logviewer true -playback 
	basetests.SimpleClassicsA_01

Se você não desejar que o TestManager exiba o log após a reprodução do script, também será necessário incluir a seguinte opção na linha de comandos do rational_ft:

-rt.bring_up_logviewer false

Uso da linha de comandos em Linux

O formato da linha de comandos é: /opt/IBM/RFT/jre/bin/java /opt/IBM/RFT/FunctionalTester/bin/rational_ft.jar<Opções do Functional Tester>

Se utilizar o formato de linha de comandos acima, configure explicitamente as variáveis de ambiente do Functional Tester. Como alternativa, você pode utilizar o script Functional Tester ft_cmdline.

Exemplos:

Ativar todos os ambientes em Linux®

	/opt/IBM/SDP7.0/ft_cmdline -enable ALL

Executar um script com argumentos da linha de comandos no Linux

/opt/IBM/SDp7.0/ft_cmdline -datastore
/opt/IBM/RFT/workspace/Project1 -log testscript -playback Script2 -args arg1 arg2

Feedback