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 |
|---|
|
| Card |
|---|
| | Expandir |
|---|
| title | 1. 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 |
|---|
| 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.  Image Added
|
| Expandir |
|---|
| title | Padrã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 Removed Image Added
|
| Expandir |
|---|
| title | Caminho 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 Removed Image Added
|
| Expandir |
|---|
| title | Caminho 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 Removed Image Added |
|
|
| Card |
|---|
| label | Variá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: Consulte as variáveis de ambiente permitidas nessa Atividade: Comparação de Diretório - Variáveis de Ambiente. Saiba mais sobre Ambientes.Para saber mais sobre os Ambientes clique aqui |
| Card |
|---|
| | Card |
|---|
| Imagine que você é um Analista do RM e executou um projeto de teste que contém um Webservice que gera dois arquivos em um determinado diretório. No Diretório Gabarito , há um arquivo chamado Exemplo.txt Log de Execução| Expandir |
|---|
| | Imagine que temos dois diretórios, Diretório 1 eDiretório 2.Dentro do Diretório 1, temos um arquivo chamado txt Exemplo com o seguinte conteúdo:  Image Modified
E um outro arquivo chamado txt Exemplo2 Já o no Diretório 2Resultado, temos há apenas um arquivo chamado 'Exemplo.txt Exemplo ' com o seguinte um conteúdo diferente:  Image Modified
Notámos
Notamos que o conteúdo do Diretório 2 Resultado apresenta uma diferença na escrita em comparação com o Diretório 1Gabarito. 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 Modified | Expandir |
|---|
| Após a correção, Tendo o Diretório 1 eDiretório 2.Dentro do Diretório 1, temos um arquivo chamado txt Exemplo com o seguinte conteúdo:  Image Removed
Image Removed Já o Diretório 2, podemos observar que tem um arquivo chamado txt Exemplo com o mesmo conteúdo do Diretório 1.  Image Removed
Image RemovedFoi 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 Modified
|
| Card |
|---|
| label | Detalhes 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 |
|---|
| 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 |
|---|
| title | Resultado 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 a necessidade de ajustes manuais para cada comparação. |
| Dica |
|---|
Para que a comparação de diretórios funcione corretamente, ambos os dois diretórios devem conter ter a mesma estrutura de árvore, no caso da comparação de subdiretório, inclusive com os mesmos nomes de pasta. Os pastas, incluindo nomes idênticos para os subdiretórios. Além disso, os arquivos a serem comparados devem possuir 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. |
