Skip to content

Latest commit

 

History

History
286 lines (196 loc) · 7.02 KB

scripts.MD

File metadata and controls

286 lines (196 loc) · 7.02 KB

Como usar os Scripts

Na pasta RUN, temos os seguintes arquivos relativos aos scripts:
.
..
└── run
├── install.sh
├── probat_config.sh
├── probat_functions.sh
├── probat_external.sh
└── probat_run.sh

Para seguir com o uso, seguiremos os seguintes passos:

1 . Instalação do comando "probat"

Visando facilitar o uso da automação do PROBAT, por este projeto disponibilizamos um script que "instala" o comando 'probat' em seu SO linux, também podendo ser utilizado em WSL [Subsistema do Windows para Linux] ou similares.

Caso você utilize Windows como SO e não tenha intimidade com WSL, faça uso dos artigos abaixo para conhecer melhor: O que é o Subsistema do Windows para Linux? Instalar o Linux no Windows com o WSL

Ao baixar esse projeto, através do terminal do Linux ou da janela do WSL no Windows, vá até a pasta onde estão os scripts:

cd /mnt/d/tlpp-probat-samples/run

É importante que você esteja posicionado no diretório RUN, pois o script utiliza essa pasta para direcionar a execução do script de configuração e execução.

Após entrar na pasta RUN, execute o comando:

./install.sh

Agora você pode utilizar o comando 'probat' de qualquer diretório e em qualquer sessão do terminal ou wsl.

2 . Configuração do ambiente

No arquivo [probat_config.sh], nós iremos configurar todos os parâmetros de nosso ambiente para o correto funcionamento do script de automação do PROBAT. Por ele, temos as seguintes variáveis para indicar:

APP_DIR

Por ele indicaremos o endereço absoluto do diretório onde se localiza o binário do appServer.

Ex:

export APP_DIR="/mnt/d/tlppcore/bin_20.3.1.x/"

A sintaxe será igual para ambientes linux ou windows, nesse caso sintaxe padrão UNIX.

APP_EXE

Indicamos o nome do executável do AppServer, pois ele pode mudar conforme SO utilizado e customizado em ambientes grandes.

Ex Windows:

export APP_EXE="appserver.exe"

Ex Linux:

export APP_EXE="appserverlinux"
APP_ENV

Indicamos o nome do ambiente que será usado para compilação e execução do PROBAT.

Ex:

export APP_ENV="TLPPCORE"
APP_INI

Indicamos o nome do arquivo INI de configuração do AppServer, podendo utilizar um INI específico para execução do Script.

export APP_INI="appserver_SH.ini"
APP_INI_EXT

Indicamos o nome do arquivo INI de configuração do AppServer, podendo utilizar um INI específico para execução do script para os envios dos eventos do script para o PROBAT.

export APP_INI_EXT="appserver_SH_external.ini"
SRC_DIR

Indicamos o caminho absoluto do diretório que estão localizados os fontes do projeto e de testes para serem compilados.

Ex Windows:

export SRC_DIR="D:\probat_samples\src"

Ex Linux:

export SRC_DIR="/probat_samples/src"

A sintaxe mudará para ambientes linux (padrão UNIX) ou windows (padrão MSDOS).

INCLUDES_DIR

Informamos com o caminho absoluto do(s) diretório(s) onde estão os arquivos de Include (TH ou CH) para uso da compilação dos fontes.

Ex Windows:

export INCLUDES_DIR="D:\tlppcore\includes;D:\tlppcore\includes_dev"

Ex Linux:

export INCLUDES_DIR="/tlppcore/includes;/tlppcore/includes_dev"

A sintaxe mudará para ambientes linux (padrão UNIX) ou windows (padrão MSDOS).

TESTS_RESULT

Informamos com caminho absoluto do arquivo XML que o PROBAT gerará ao final com os resultados da execução.

Ex:

export TESTS_RESULT="/mnt/d/tlppcore/bin_20.3.1.x/root/system/testsresults.xml"

A sintaxe será igual para ambientes linux ou windows, nesse caso sintaxe padrão UNIX.

3 . Configuração do seu ambiente PROBAT

Siga as instruções conforme documentação: 3 - Configurando 3c - INI

4 . Execução do comando

Após a instalação do comando [probat] em seu SO ou WSL, configuração do [probat_config.sh] e configuração do seu ambiente PROBAT, agora é possível executar o comando e disparar a automação do PROBAT através de seu terminal.

Portanto, temos as seguintes opções:

Versão

Ao executar o comando abaixo, obtemos a versão do [probat command] instalado em seu ambiente:

probat -version
Compilação

A opção default do comando, é efetuar a compilação dos fontes sempre que executarmos o comando [probat], ou indicarmos de forma explícita que queremos a compilação, sendo:

probat

ou

probat -compile

Caso não queria que a compilação ocorra, então precisa informar ao comando, sendo:

probat -nocompile
Execução PROBAT

A opção default do comando, é executar o PROBAT sempre que executarmos o comando [probat], ou indicarmos de forma explícita que queremos a execução dos testes, sendo:

probat

ou

probat -run

Caso não queria que a execução dos testes, então precisa informar ao comando, sendo:

probat -norun
Envio dos eventos para o PROBAT

A opção default do comando, é não enviar os eventos de seu script para o PROBAT, ou indicarmos de forma explícita se queremos ou não que sejam enviados, sendo:

probat

ou

probat -noexternal

Caso queria que os eventos sejam enviados ao PROBAT, então precisa informar ao comando, sendo:

probat -external

Saiba mais sobre esse recurso em: Enviando eventos da automação para o PROBAT

Mensagens de Debug

A opção default do comando, é não imprimir as mensagens de debug de alguns acontecimentos de seu script, ou indicarmos de forma explícita se queremos ou não essas mensagens, sendo:

probat

ou

probat -nodebug

Caso queria que as mensagens sejam exibidas, então precisa informar ao comando, sendo:

probat -debug

Combinando comandos

É possível combinar os comandos entre si, conforme exemplos:

probat -compile -run
probat -nocompile -run
probat -compile -norun
probat -nocompile -norun

probat -compile -run -debug

probat -compile -run -external

A ordem dos parâmetros podem ser mudadas que os efeitos permanecem iguais:

probat -run -compile
probat -run -nocompile
probat -norun -compile
probat -norun -nocompile

probat -run -debug -compile

probat -run -external -compile
Importante

Os parâmetros não são obrigatórios, portanto podemos utilizá-los conforme necessidade, vejamos:

probat

Aqui estamos utilizando todos os parâmetros com seus valores default, ou seja:

  • -compile
  • -run
  • -noexternal
  • -nodebug
probat -nocompile

Aqui indicamos que queremos somente executar os testes, mas não compilar antes.

probat -norun

Aqui indicamos que queremos somente compilar os fontes, mas não executar os testes.