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, deverá incluir o caminho do projeto usando a opção -projectpath. Se você incluiu outras dependências do projeto no projeto de teste funcional, poderá especificar o nome do projeto usando a opção -projectpath. Por exemplo, considere o cenário em que você tem um script de teste funcional que usa uma classe de outro projeto. Para resolver essa dependência, durante uma invocação da linha de comandos, você deve especificar o nome do projeto dependente 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>

Gravar um script simplificado:

java -classpath <caminho de classe> com.rational.test.ft.rational_ft -simplescript true -datastore <diretório> [-map<nomedomapacompartilhado>] [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