Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

O que

...

é?

Ferramenta dedicada à A atividade realiza a comparação de arquivos e diretórios, essencial para garantir a integridade e a precisão dos resultados em projetos de teste. Permite todos os arquivos de um determinado tipo entre dois diretórios diferentes. Ela permite comparar tanto diretórios inteiros quanto arquivos individuais, assegurando garantindo que o conteúdo e a estrutura dos dados estejam conforme de acordo com o esperado. "

Para que

...

serve?

Serve para validar os resultados dos testes comparando arquivos e diretórios gerados com resultados esperados. A ferramenta Esta atividade é especialmente útil para desenvolvedores e testers que precisam garantir que suas aplicações produzem saídas corretas e consistentes ao longo do tempoútil para validar se um arquivo gerado ou diretório modificado após uma execução de uma outra atividade em projeto de teste essencial para garantir a integridade e a precisão dos resultados em projetos de teste.

Exemplo de Uso 

Deck of Cards
idComo cadastrar
Card
labelComo Cadastrar
Expandir
title1. Navegação para o cadastro

 1. Navegue no menu do TestFlow e clique em: Atividades Arquivos Comparação de Diretório. 

 2. Na tabela que será mostrada, clique no botão verde em destaque.


Expandir
title2. Link para Definir cabeçalho (Nome e nível de acesso)

Clique aqui para obter as informações do cabeçalho

Expandir
title3. Preenchimento dos Campos
Expandir
titleVersão

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

Image Added

Column

Exemplo utilizando a versão padrão

Image Added

Expandir
titleDescriçã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.

Image Added

Expandir
titlePadrão de busca de arquivos

 Este parâmetro define quais tipos de arquivos serão incluídos na comparação. Você deve especificar a extensão dos arquivos que deseja comparar, como .txt

Exemplo:

Esta opção define se a comparação incluirá os subdiretórios dos diretórios especificados. Se ativada, a ferramenta compara tanto os arquivos do nível principal quanto os contidos nos subdiretórios, garantindo a análise completa da estrutura hierárquica dos diretórios.Image RemovedImage Added


Expandir
titleCaminho do diretório da esquerda

Este é o diretório onde você armazena os arquivos de referência, ou seja, aqueles que contêm os resultados esperados ou anteriores que você deseja comparar. Esses arquivos servem como base para a comparação e devem estar organizados na mesma estrutura que o diretório da direita.


Image RemovedImage Added

Expandir
titleCaminho do diretório da direita

Este diretório contém os novos arquivos gerados, que serão comparados com os arquivos do diretório da esquerda. Ele deve replicar a estrutura do diretório da esquerda para que a comparação funcione corretamente. A comparação identifica diferenças entre os arquivos de ambos os diretórios, ajudando a verificar se os novos resultados estão de acordo com os esperados.Image RemovedImage Added

Card
labelVariáveis de ambiente

As variáveis de ambiente na comparação de diretórios no TestFlow são utilizadas para configurar e personalizar o comportamento da atividade de comparação. Elas permitem definir valores específicos que podem ser usados durante a execução dos testes, assegurando que a comparação ocorra conforme o ambiente em que o teste está sendo executado.

Sendo assim temos como exemplo, variável de ambiente do RM, Versão Legado e versão Atual (Release).

Caminho de Diretório da esquerda 

Image Removed

Caminho de diretório da direita

Image Removed

Consulte o processo das Variáveis na atividade de Ambiente:

(Para saber mais sobre os Ambientes clique aqui

Image Removed

Consulte as variáveis de ambiente permitidas nessa Atividade:

Comparação de Diretório - Variáveis de Ambiente.

Saiba mais sobre Ambientes.

Card
labelExemplo prático
Card
labelExemplo prático

Imagine que você

tem

é um Analista do RM e executou um projeto de teste que

gera relatórios em formato de texto. Com o TestFlow, você pode comparar os relatórios recém-gerados (armazenados no "Caminho do diretório da direita") com relatórios anteriores (armazenados no "Caminho do diretório da esquerda") para garantir que os novos resultados são corretos.

contém um Webservice que gera dois arquivos em um determinado diretório.

No Diretório Gabarito , há um arquivo chamado Exemplo.txt com o seguinte conteúdo:

Image Added

E um outro arquivo chamado txt Exemplo2

Já no Diretório Resultado, há apenas um arquivo chamado 'Exemplo.txt' com um conteúdo diferente:

Image Added


Notamos que o conteúdo do Diretório Resultado apresenta uma diferença na escrita em comparação com o Diretório Gabarito.

Sendo assim, no log da atividade de comparação de diretórios no TestFlow, é possível observar que houve um erro indicando que o diretório da direita está diferente do diretório da esquerda.Image Added

Foi realizada a correção no Diretório Resultado, garantindo que contenha os mesmos arquivos e conteúdos em ambos diretórios

Dessa forma, o log da atividade de comparação de diretórios no TestFlow mostra um registro de sucesso, indicando que o diretório à direita não difere do diretório à esquerda após a correção do arquivo.Image Added


Card
labelDetalhes da Execução

Para garantir a precisão na validação dos arquivos na Atividade de comparação de diretório, analisamos os detalhes de execução de cada arquivo em ambos os diretórios. Isso nos permite identificar diferenças de forma confiável e assegurar que os resultados dos testes estejam de acordo com as expectativas.

No campo Atividades Executadas, clique no botão mostrado para ver mais detalhes da execução.

Image Added


Sendo assim, contamos com os seguintes resultados da execução:

Expandir
titleStatus

Status Sucesso:

Image Added

Indica que não foram encontradas diferenças entre os diretórios comparados; todos os arquivos e subdiretórios estão idênticos e sincronizados.

Status Falha:

Image AddedIndica que foram encontradas diferenças entre os diretórios comparados, como arquivos ausentes, conteúdos divergentes ou variações nos atributos dos arquivos.

Expandir
titleResultado dos Arquivos

Arquivo Idêntico: Arquivo presente em ambos os diretórios com conteúdo exatamente igual.

Arquivo Diferente: Arquivo presente em ambos os diretórios, mas com diferenças no conteúdo.

Apenas Esquerda: Arquivo encontrado apenas no diretório de origem (à esquerda).

Apenas Direita: Arquivo encontrado apenas no diretório de destino (à direita).

Image Added

...

Saiba mais

Dica

Antes de realizar uma comparação, certifique-se de que seus diretórios estejam organizados de maneira forma consistente. Use Adote uma estrutura de pastas clara e padronizada para evitar confusões e garantir que a ferramenta possa comparar compare os arquivos corretamente.

Dica

Ative a opção de "Comparar Subdiretórios" somente apenas se realmente precisar comparar toda a estrutura hierárquica. Caso contrário, desative-a para acelerar o processo de comparação e focar concentrar-se apenas nos arquivos principais.

Dica

Utilize variáveis de ambiente para adaptar ajustar as comparações ao seu ambiente de testes. Isso permite que você configure configurar caminhos dinâmicos e outros parâmetros específicos sem precisar ajustar manualmente para cada comparaçãoa necessidade de ajustes manuais para cada comparação.

Dica

Para que a comparação de diretórios funcione corretamente, ambos os diretórios devem ter a mesma estrutura de pastas, incluindo nomes idênticos para os subdiretórios. Além disso, os arquivos a serem comparados devem ter o mesmo nome e extensão.

FAQ

Informações

P: O que acontece se os diretórios comparados tiverem estruturas diferentes?

R: Se os diretórios não tiverem a mesma estrutura, O TestFlow pode não conseguir comparar todos os arquivos corretamente. Para garantir uma comparação precisa, os diretórios devem ter a mesma organização de pastas e nomes de arquivos.

P: O que devo fazer se a comparação falhar?

R: Verifique se os caminhos dos diretórios estão corretos, se os arquivos possuem as extensões especificadas, e se as estruturas dos diretórios são idênticas. Se tudo estiver correto, revise as configurações de variáveis de ambiente.