| Card |
|---|
| | Expandir |
|---|
| title | 1. Navegação para o cadastro. |
|---|
| - Navegue no menu do TestFlow e clique em: Atividades → Windows → Script WinForms.
- Na tabela que será mostrada, clique no botão verde em destaque para criar Atividade de Script WinForms.
|
| Expandir |
|---|
| title | 3. Preenchimento dos Campos |
|---|
| | Expandir |
|---|
| Especifica a versão da atividade em questão. O objetivo de versionar uma atividade é para quando necessitamos ter mais de uma atividade em versões diferentes. Isso irá nos auxiliar a ter um histórico de atualizações e assegurar que as mudanças feitas sejam rastreáveis e reversíveis, se necessário. | Informações |
|---|
Se for necessário utilizar mais de uma versão do RM no seu ambiente, é recomendado que a versão da atividade seja compatível com o sistema RM em uso. Caso contrário, pode-se optar por uma versão padrão de sua preferência. |
| Section |
|---|
| Column |
|---|
Exemplo utilizando a versão do RM 
|
| Column |
|---|
Exemplo utilizando a versão padrão 
|
|
|
| Expandir |
|---|
| title | Descrição de Atividade |
|---|
| Fornece uma descrição detalhada da atividade, explicando seu propósito e operações, facilitando a compreensão e manutenção futura. 
|
| Expandir |
|---|
| title | Servidor para gravação |
|---|
| Selecione o servidor onde o script será gravado. O servidor deve estar previamente cadastrado. (Clique aqui para obter mais informações sobre os servidores). 
|
| Informações |
|---|
O Agent deve estar iniciado e o ambiente RM em execução. |
|
|
| Card |
|---|
| label | Preparação do Ambiente RM |
|---|
| Passo a passo para configuração do ambiente WinForms: Fazer o download do Plugin WinForms. É importante garantir o desbloqueio dos arquivos do Agent e os plugins do WinForms, usando a opção Unblock do Windows.
Nesse caso, é necessário rodar o seguinte comando no diretório do Agent, usando o cmd:
dir -Recurse | Unblock-File
Verificar o ambiente do RM: - Verifique se a pasta TestFlow está no diretório bin do RM.
- Certifique-se de que o RM está instalado e funcionando corretamente no Servidor onde irá gravar o seu Script WinForms.
Executar o Agent do TestFlow: - Verifique se o Agent do TestFlow está em execução no servidor e se ele está sendo executado como administrador.
Carregar o host do RM: - Abra o Host do RM como administrador no servidor onde irá utilizar.
- Abra o CMD e digite o comando:
netstat -ao. Em seguida, verifique se há um serviço em execução na porta 5000. Criar um atalho para o RM.exe: - Localize o arquivo Rm.exe no servidor.
- Crie um atalho para ele e, na linha de comando do atalho, adicione o seguinte parâmetro:
"/automationtest". Este parâmetro permite a gravação das telas do RM. e desativa qualquer janela ou formulário que seja aberto após o login.
- Iniciar o RM pelo atalho:
- Execute o RM através do atalho criado, certificando-se de que está a ser executado como administrador.
Com esses passos, o ambiente estará preparado para a gravação do Script WinForms. |
| Card |
|---|
| label | Variáveis de Ambiente |
|---|
| As variáveis dos ambientes no Script WinForms são utilizadas para ajustar as configurações das requisições conforme os diferentes ambientes de execução (desenvolvimento, teste, produção), facilitando a adaptação e reutilização dos scripts sem a necessidade de alterações manuais no código para cada ambiente.
Clique aqui para obter as informações das Variáveis de ambiente Ambiente do Script WinForms. |
| Card |
|---|
| label | Gravando Script WinForms |
|---|
| | Expandir |
|---|
| title | 1. Renderização de Componentes |
|---|
| - Com o ambiente devidamente configurado, o TestFlow permite a leitura e execução remota de componentes C#. Os componentes exibidos na tela são renderizados em tempo real, e os scripts são gravados utilizando os nomes desses componentes.
- Ao clicar em um item renderizado, a ação será registrada à direita, exibindo o passo a passo. O clique no TestFlow também será executado no RM. Essa ação será gravada no TestFlow e reproduzida no RM.
| Expandir |
|---|
| title | Interações com os Componentes |
|---|
| Após selecionar a ação desejada, o sistema cria automaticamente uma nova entrada na Timeline, localizada à direita da interface. Esta entrada incluirá todos os parâmetros específicos da ação escolhida. 
Ao clicar no componente desejado, um pop-up será exibido com três opções de ações disponíveis para o componente: - Click: Executa um clique simples no componente.
- Duplo Click: Realiza dois cliques consecutivos no componente.
- Setar Texto: Permite inserir texto no componente, preenchendo o campo com o valor informado no modal.
Na Timeline de Ações é possível: Alterar a ordem que as Ações são executadas: | Expandir |
|---|
| title | Reorganização da Sequência de Ações |
|---|
| Você pode reorganizar a sequência de execução das ações gravadas, simplesmente arrastando-as para a posição desejada, garantindo total controle sobre a ordem de execução. Essa funcionalidade é útil para ajustar a lógica das operações sem a necessidade de regravar o script. 
|
Adicionar Ações de timer (delay antes de executar a próxima ação); | Expandir |
|---|
| Os campos relacionados ao Tipo de Tempo: Fixo ou Randômico servem para definir como o intervalo entre as ações será configurado no script. Fixo: Define um intervalo constante entre cada ação do script. Ao escolher este tipo, o tempo entre as ações será sempre o mesmo, conforme configurado. - Aqui você define o tempo exato de espera entre a execução de cada ação.
Randômico: Neste modo, o intervalo entre as ações é variável. O sistema irá gerar tempos aleatórios dentro de um intervalo mínimo e máximo, permitindo uma variação no tempo de espera entre cada ação. - Aqui você define o tempo de espera entre as ações varia aleatoriamente dentro do intervalo definido
|
Configurar o tempo de espera do Script após abrir uma janela antes de executar a próxima ação; | Expandir |
|---|
| title | Seção Aguardar Janelas |
|---|
| Esta funcionalidade permite definir o tempo de espera do script após a abertura de uma janela, garantindo que ela esteja totalmente carregada antes da próxima ação. A opção Aguardar Janelas é crucial para manter a estabilidade do script, evitando que ele interaja com uma interface ainda não preparada. Fixo: Aqui, você define um tempo constante de espera entre a abertura da janela e a próxima ação. Quando configurado, o Script sempre aguardará o mesmo tempo definido, garantindo consistência na execução. Randômico: Aqui, você define um tempo de espera aleatório dentro de um intervalo, garantindo que a janela seja carregada antes de continuar o Script, simulando variações no tempo de resposta. 
|
Configurar o tempo entre ações baseado no desempenho durante a execução do Script Winforms no computador: | Expandir |
|---|
| Quando a memória atingir (%): Define o limite de uso de memória (em percentual) que, ao ser alcançado durante a execução do script, aciona o aumento dos timeouts. Esse parâmetro permite que o sistema ajuste automaticamente o tempo de espera entre as ações quando o uso de memória atinge o valor definido. Quando a CPU atingir (%): Estabelece o percentual de uso da CPU que, ao ser alcançado durante a execução do Script, também acionará o aumento dos Timeouts. Isso é útil para evitar sobrecarga quando o processamento do computador está próximo do limite.
|
|
|
| Expandir |
|---|
| Um analista do produto RM precisa automatizar a validação de cadastros no sistema, especificamente para o cadastro de "Tipo de Característica Imobiliária". Para isso, ele utilizará o ScriptWinForms do TestFlow para simular interações com o sistema RM e validar a criação correta dos dados. Após configurar o Script, o analista pode optar por executar a sequência completa de ações programadas. O TestFlow então reproduz automaticamente todos os cliques, inserções de texto e interações previamente configuradas no sistema RM, simulando com precisão o comportamento do usuário. Durante essa execução, o sistema realiza o cadastro da nova característica imobiliária conforme as etapas definidas, garantindo que os dados sejam inseridos corretamente e que o fluxo do processo seja fiel ao que seria realizado manualmente. Além disso, o TestFlow permite monitorar o progresso da execução em tempo real, identificando possíveis falhas ou erros no processo. Se algum problema for detectado, o analista pode revisar o Script, ajustar ações ou parâmetros, e reexecutar o teste até que o cadastro seja validado com sucesso. Isso assegura não apenas a automação do processo, mas também a confiabilidade na criação de novos cadastros no ambiente RM.
Ações gravadas do Scrip tWinforms no TestFlow
 Image Added
Script WinForms em execução no RM  Image Added
|
| Expandir |
|---|
| title | 3. Troubleshooting (Resolução de Problema) |
|---|
| Os componentes WinForms podem não ser totalmente renderizados na tela, resultando em elementos que não aparecem ou não estão totalmente visíveis, o que pode comprometer a interação e o correto funcionamento do Script Automatizado. Este problema pode ocorrer devido a atrasos no carregamento da interface, uso excessivo de recursos do sistema, ou resolução de tela inadequada, exigindo ajustes no tempo de espera ou validação da interface antes da execução das ações. A tela não renderiza completamente todos os componentes, resultando em elementos ausentes ou incompletos, o que pode prejudicar a usabilidade e execução do sistema. Além disso, arquivos podem estar bloqueados pelo Windows, impedindo o acesso ou modificação, o que geralmente ocorre devido a permissões insuficientes, processos em execução ou restrições de segurança do sistema operacional. 
Arquivos bloqueados pelo Windows 
Para resolver o problema, é necessário desbloquear as DLLs na pasta do TestFlow, pois o Windows pode estar bloqueando o download e execução desses arquivos por questões de segurança. Siga os seguintes passos: - Pressione as teclas "Windows + R" e digite o comando "gpedit.msc"
 - Na esquerda expanda as pastas para Configuração do Usuário > Modelos Administrativos > Componentes do Windows > Gerenciador de Anexos e abra o item Não preservar informações de zona em anexos de arquivo.
 - Altere o estado do Checkbox de Não configurado para Habilitado e, em seguida, clique em Aplicar e OK.
 Faça o download dos Plugins novamente através do TestFlow. (Clique aqui para saber mais sobre os plugins WinForms) - Extraia o zip instalado no diretório do RM.exe
Após a conclusão dos passos, os componentes WinForms serão completamente carregados e estarão prontos para utilização. Certifique-se de que todas as dependências foram corretamente instaladas para garantir o funcionamento ideal. 
|
|
|
