Comparar documentos em PDF

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)

ComparePdfDocuments(string, string, ComparisonType, CompareDocumentsOptions)

ComparisonResult ComparePdfDocuments(
    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 com o 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 CompararOpçõesDeDocumento : as opções de comparação específicas que devem ser usadas para essa operação. Para criar um objeto do tipo CompareDocumentsOptions, use aClasse 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:

Neste exemplo, estamos comparando dois arquivos PDF, uma conta de luz e uma conta de àgua. A comparação é feita no nível do caractere. As variáveis firstBill e secondBill representam os caminhos desses arquivos PDF. As regras do curinga e do regex fornecidas juntamente com os métodos WithIgnoreWildcardRule e WithIgnoreRegexRule são usadas para ignorar padrões específicos na comparação. Por exemplo, a regra curinga 2022 e a regra regex \d{1,2}/\d{1,2}/\d{4} ignoram datas, supondo que elas estejam no formato MM/DD/AAAA na comparação, já que elas podem diferir em duas faturas separadas e não são relevantes para a estrutura das contas.

Depois que a comparação é feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são registradas 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:

Neste exemplo, estamos comparando os mesmos arquivos PDF do exemplo anterior: uma conta de luz e uma conta de água. A comparação é feita no nível da palavra. As variáveis firstBill e secondBill representam os caminhos desses arquivos PDF. As regras do curinga e do regex fornecidas juntamente com os métodos WithIgnoreWildcardRule e WithIgnoreRegexRule são usadas para ignorar padrões específicos na comparação. Por exemplo, a regra curinga 2022 ignora datas, supondo que elas estejam no formato MM/DD/AAAA na comparação, pois elas podem diferir em duas faturas separadas e não são relevantes para a estrutura das contas. A regra regex [$]\d+\.\d{2} ignora os valores de moedas, supondo que eles estejam em um formato semelhante a $XX.XX.

Depois que a comparação é feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são registradas 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. As variáveis firstBill e secondBill representam os caminhos desses arquivos PDF. 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 é feita, o método WithGenerateHtml cria um relatório HTML da comparação e quaisquer diferenças encontradas são registradas 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.