VerifyDocumentsEquivalence

Verifica se dois documentos são equivalentes, usando várias opções de comparação, incluindo os seguintes tipos de comparação:

• Comparando palavras.
• Comparando linhas.
• Comparando caracteres como variáveis char .

Observação: o tipo de documento compatível é PDF.

Definição

Namespace: UiPath.Testing.API

Assembly: UiPath.Testing.Activities.Api (em UiPath.Testing.Activities.Api.dll)

VerifyDocumentsEquivalence(string, string, ComparisonType, CompareDocumentsOptions)

ComparisonResult VerifyDocumentsEquivalence(
    string baselinePath,
    string targetPath,
    [ComparisonType comparisonType],
    [CompareDocumentsOptions opts])

baselinePath String

O caminho do documento base que é usado como referência para comparação.

targetPath String

O caminho do documento que é comparado ao documento base.

comparisonType ComparisonType (Opcional)

O tipo de comparação a ser usado ao comparar documentos. As seguintes opções estão disponíveis:

• ComparisonType.Char: Compara todos os caracteres (char) nos documentos.
• ComparisonType.Line: Compara cada linha nos documentos.
• ComparisonType.Word: Compara cada palavra nos documentos.

Opts CompareDocumentsOptions

As opções de comparação específicas que devem ser usadas para essa operação. Para criar um objeto do tipo CompareDocumentsOptions, use a Classe TestingOptions.CompareDocuments.

RetornarValor

ComparisonResult

O resultado da ação de comparação, armazenado dentro de uma variável ComparisonResult.

Exemplos

1. Comparação de PDFs por caracteres:
   Nesse exemplo, estamos comparando dois arquivos PDF, uma conta de luz e uma conta de água. A comparação é feita no nível do caractere. Os caminhos desses arquivos PDF são representados pelas variáveis firstBill e secondBill. A regra curinga e a regra regex fornecidas junto com os métodos WithIgnoreWildcardRule e WithIgnoreRegexRule são usados para ignorar padrões específicos na comparação.Por exemplo, a regra curinga 2022e a regra regex \d{1,2}/\d{1,2}/\d{4}ignoram datas (presumindo que elas estão no formato MM/DD/AAAA) na comparação, pois podem diferir em duas contas separadas e não são relevantes para a estrutura das contas.
   Depois que a comparação for feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são gravadas nos logs usando o método Log.

   var firstBill = @"C:\bills\2024.10\pdfs for compare\(electricity_bill.pdf";
   var secondBill = @"C:\bills\2024.10\pdfs for compare\(water_bill.pdf";
   
   var identicalCharCompareResult = testing.VerifyDocumentsEquivalence(
       firstBill, secondBill, 
       ComparisonType.Character, 
       TestingOptions.CompareDocuments()
           .WithGenerateHtml(@".\HtmlCompareResults\PDFCharCompare.html")
           .WithIgnoreWildcardRule("WildcardRule", "*2022*", true)
           .WithIgnoreRegexRule("RegexRule", @"\d{1,2}/\d{1,2}/\d{4}", true)
   );
   
   Log("pdf compare by char " + identicalCharCompareResult.AreEquivalent.ToString(),LogLevel.Error);

2. Comparação de PDFs por palavra:
   Nesse exemplo, estamos comparando os mesmos arquivos PDF que no exemplo anterior: uma conta de luz e uma conta de água. A comparação é feita no nível de palavra. Os caminhos desses arquivos PDF são representados pelas variáveis firstBill e secondBill. A regra curinga e a regra regex fornecidas junto com os métodos WithIgnoreWildcardRule e WithIgnoreRegexRule são usados para ignorar padrões específicos na comparação.Por exemplo, a regra de curinga 2022 ignora datas (presumindo que elas estejam no formato MM/DD/AAAA) na comparação, pois podem diferir em duas contas separadas e não são relevantes para a estrutura das contas.A regra regex [$]\d+\.\d{2} ignora os valores de moedas, presumindo que eles estejam em um formato semelhante a $XX.XX.
   Depois que a comparação for feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são gravadas nos logs usando o método Log.

   var firstBill = @"C:\bills\2024.10\pdfs for compare\(electricity_bill.pdf";
   var secondBill = @"C:\bills\2024.10\pdfs for compare\(water_bill.pdf";
   
   var differentWordCompareResult = testing.VerifyDocumentsEquivalence(
       firstBill, secondBill, 
       ComparisonType.Word, 
       TestingOptions.CompareDocuments()
           .WithGenerateHtml(@".\HtmlCompareResults\PDFWordCompareDiff.html")
           .WithIgnoreWildcardRule("WildcardRule", "*2022*", true)
           .WithIgnoreRegexRule("RegexRule", @"[$]\d+\.\d{2}", true)
   );
   
   Log("pdf compare by Word " + differentWordCompareResult.AreEquivalent.ToString(), LogLevel.Error);

3. Comparação de PDFs por linha:
   Nesse exemplo, semelhante ao anterior, estamos comparando dois arquivos PDF, uma conta de luz e uma conta de água. Nesse cenário, a comparação é feita no nível da linha. Os caminhos desses arquivos PDF são representados pelas variáveis firstBill e secondBill. A regra curinga e a regra regex fornecidas junto com os métodos WithIgnoreWildcardRule e WithIgnoreRegexRule são usadas para ignorar padrões específicos na comparação.
   Por exemplo, a regra de curinga 2022 ignora datas (presumindo que elas estejam no formato MM/DD/AAAA) na comparação, pois podem diferir em duas contas separadas e não são relevantes para a estrutura das contas.A regra regex [$]\d+\.\d{2} ignora os valores de moedas, presumindo que eles estejam em um formato semelhante a $XX.XX.
   Depois que a comparação for feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são gravadas nos logs usando o método Log.

   var firstBill = @"C:\bills\2024.10\pdfs for compare\(electricity_bill.pdf";
   var secondBill = @"C:\bills\2024.10\pdfs for compare\(water_bill.pdf";
   
   var largeLineCompareResult = testing.VerifyDocumentsEquivalence(
       firstBill, secondBill, 
       ComparisonType.Line, 
       TestingOptions.CompareDocuments()
           .WithGeneratePdf(@".\PDFCompareResults",@".\PDFCompareResults")
           .WithIgnoreWildcardRule("WildcardRule", "*2022*", true)
           .WithIgnoreRegexRule("RegexRule", @"[$]\d+\.\d{2}", true)
   );
   
   Log("Pdf compare by line " + largeLineCompareResult.AreEquivalent.ToString(), LogLevel.Error);

Em todos os exemplos, a propriedade AreEquivalent retorna se os documentos são iguais ou não.