Capítulo 5. Configurações do Behave
Todos os módulos do Demoseille Behave possuem configurações
específicas (Parsers, Runners e Integrations), boa parte delas possui
um valor padrão que pode ser alterado no projeto.
Dica
Também é possível alterar estas configurações utilizando o
parâmetro-D para a chamada da máquina virtual Java.
Por exemplo:
-Dbehave.integration.alm.enabled=true
5.1. Configurações do Parser
- behave.parser.language:
propriedade que seleciona a linguagem que o
parser trabalhará, o padrão é pt.
- behave.parser.identification.scenario.pattern:
propriedade define a expressão regular que identificará um
início de cenário no arquivo de história. O Padrão é
^(\\s)*(CEN\u00C1RIO|Cen\u00E1rio|cen\u00E1rio)\:(.*)
- behave.parser.story.timeout:
Define o tempo máximo em minutos para execução das histórias.
- behave.parser.prefixes.bdd.pattern:
propriedade define a expressão regular que identificará um
início de cada passo no arquivo de história. O Padrão é
^(\\s)*(DADO |QUANDO |ENT\u00C3O |E |MAS |Dado |Quando
|Ent\u00E3o |Mas |dado |quando |ent\u00E3o |e |mas)(.*)
- behave.parser.story.extension.original:
propriedade define a extensão do arquivo original que será lido,
o
padrão é
bdd
no core, mas no caso do JBehave o padrão é
story.
- behave.parser.story.extension.converted:
propriedade define a extensão do arquivo gerado após o pré-processamento do framework,
o padrão é story
no core, mas no caso do JBehave o padrão é storyConverted.
- behave.parser.commonssteps.enabled:
propriedade que habilita os passos comuns utilizados pelos
parsers. O padrão é ativado.
- behave.parser.beforeaftersteps.enabled:
propriedade que habilita os passos anteriores e posteriores às
execuções das histórias. No caso do runner WebDriver ele conduz o
navegador nestes passos. O padrão é ativado.
- behave.parser.delayBetweenSteps:
propriedade que coloca uma espera entre a execução dos passos. Se for 0 (Zero) ele estará desabilitado.
O padrão é 0 (Zero).
- behave.parser.screenshot.enabled
propriedade que faz habilita ou desabilita a captura de tela quando ocorre um erro.
O padrão é true.
- behave.parser.coloredconsole.enabled
propriedade para habilitar a saída colorida no console.
O padrão é false.
- behave.parser.erroDuplicateScenarios
propriedade que faz com que o parser verifique se existem cenários duplicados na execução.
O padrão é true.
5.2. Configurações do Runner
- behave.runner.screen.maxWait
: Tempo máximo de espera em uma ação na tela. O valor padrão é
10000 milissegundos.
- behave.runner.screen.minWait
: Tempo mínimo de espera entre as ações da tela, contudo esta propriedade é utilizada somente nos casos em que o framework precisa tentar mais de uma vez localizar e executar uma ação em um elemento.
O valor padrão é
100 milissegundos
.
- behave.runner.proxy.url
: propriedade que, quando informada, ativará o uso de proxy no navegador.
O valor padrão da url do proxy é vazio.
- behave.runner.screen.type
: Opções do
WebDriver: MozillaFirefox, InternetExplorer,
GoogleChrome. No caso do
IE e Chrome são necessárias configurações
adicionais.
O valor padrão é
MozillaFirefox
.
- behave.runner.screen.remote.name
: Para testes remotos, esta propriedade informa
qual navegador será
utilizado. O valor padrão é vazio.
- behave.runner.screen.remote.url
: Para testes remotos, esta propriedade informa
a URL na qual o Selenium Server encontra-se,
o valor padrão é vazio.
- behave.runner.screen.commandLineOptions
: permite passar os parâmetros de inicialização do navegador, substituindo todos os fornecidos pelo framework. Por enquanto somente existe implementação para o Google Chrome.
O valor padrão é vazio.
- behave.runner.screen.driverPath
: Localização do driver que faz ligação
entre o navegador e o
webdriver. O valor padrão é vazio.
- behave.runner.profile.enabled
: propriedade que ativa ou desativa o uso de
profile no navegador. O valor padrão é desabilitado.
- behave.runner.screen.profilePath
: Localização do profile. O valor padrão é
vazio
.
- behave.runner.app.mainClass
: Nome de domínio qualificado da classe principal da
aplicação sobre testes. O valor padrão é vazio.
- behave.runner.proxy.enabled
: habilita a utilização do proxy no runner (Navegador).
O valor padrão é desabilitado.
- behave.runner.proxy.url
: URL do proxy a ser utilizado quando a opção do Proxy está habilitada.
O valor padrão é vazio.
- behave.runner.screen.binaryPath
: localização do binário do navegador quando se quer utilizar uma versão específica (ex: //home//USER//firefox//firefox-bin).
O valor padrão é desabilitado.
- behave.runner.catchUIException
: exceções a serem capturadas em caso de erro genérico (StaleElementReferenceException). O valor padrão é
org.openqa.selenium.StaleElementReferenceException.
- behave.runner.window.maximize.enabled
: ativa o uso maximizado da janela do navegador, o valor padrão é false.
- behave.runner.screen.screenshot.zoomout
: níves de zoom out que o framework realizará antes de capturar a tela, o valor padrão é 0.
- behave.runner.legacyRunner
: Habilita ou desabilita o modo de execução legado para retrocompatibilidade. O valor padrão é true.
- behave.runner.legacyRunner
: Ativa o o log (DEBUG) de mensagems de estatísticas de execução. O valor padrão é false.
5.3. Configurações do Integration
- behave.integration.alm.enabled
: propriedade que habilita/desabilita a funcionalidade de
integração com a ALM.
O valor padrão é
desabilitado
.
- behave.integration.alm.url.security
: Campo obrigatório para integração com a ALM. Endereço
completo do
caminho para autenticação na ALM.
O valor padrão é
vazio
.
- behave.integration.alm.url.services
: Campo obrigatório para integração com a ALM. Endereço
completo do
caminho para os serviços REST.
O valor padrão é
vazio
.
- behave.integration.alm.projectArea
: Campo obrigatório
para integração com a ALM. Alias da
área de
projeto. Tomar cuidado com
áreas renomeadas, pois o Alias não
é
alterado,
o valor padrão é
vazio
.
- behave.integration.alm.testPlanId
: Campo obrigatório
para integração com a ALM. Id do
plano de testes
que pertence a área de
projeto.
O valor padrão é
vazio
.
- behave.integration.authenticator.host
: Endereço (IP) do Autenticator.
O valor padrão é
localhost
.
- behave.integration.authenticator.port
: Porta
utilizada para comunicação com o Autenticator.
O valor padrão
é
9990
.
- behave.integration.alm.autoAssociateTestCaseInPlan
: propriedade que habilita/desabilita a a associação automática de Casos de Teste ao Plano de Teste do RQM.
O valor padrão
é
true
.
- behave.integration.alm.categoryTipoExecucao
: propriedade do valor informado no "Tipo de Execução" quando um Caso de Teste é enviado para a ALM.
O valor padrão
é
Automatizado
.
5.4. Configurações do Integration - Autenticator ALM
Atenção
O Autenticator é necessário para que a integração com a ALM
funcione
corretamente, não sendo possível fazer a integração sem
esse
utilitário.
Caso o Autenticator não esteja disponível a seguinte
mensagem será
exibida na exceção lançada:
br.gov.frameworkdemoiselle.behave.exception.BehaveException:
Autenticador inacessível. Verifique se o processo foi iniciado
Para fazer uso do módulo de integração basta acrescentar a
dependência no pom.xml do projeto.
<dependency>
<groupId>br.gov.frameworkdemoiselle.component.behave</groupId>
<artifactId>demoiselle-behave-integration-alm</artifactId>
<version>1.x.x</version>
<scope>test</scope>
</dependency>
-
Todas as chamadas Rest ao RQM necessitam de um usuário e
senha
válidos para a plataforma Jazz.
-
Por segurança não recomendamos armazenar de forma
persistente
estas informações.
-
O componente “demoiselle-behave-integration-alm” provê
uma forma
segura de armazenar o usuário e senha do testador.
-
O armazenamento é realizado em memória de forma
criptografada e
podendo ser acessado apenas localmente na estação
do testador
durante a execução dos testes.