验证等效文档

使用多个比较选项（包括以下比较类型）验证两个文档是否等效：

• 比较字词。
• 比较行。
• 将字符作为char变量进行比较。

注意：支持的文档类型为 PDF。

定义

命名空间： UiPath.Testing.API

程序集： UiPath.Testing.Activities.Api（在 UiPath.Testing.Activities.Api.dll 中）

VerifyDocumentsEquivalence(string, string, ComparisonType, CompareDocumentsOptions)

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

baselinePath 字符串

用于比较时作为参考的基准文档的路径。

targetPath 字符串

与基准文档进行比较的文档路径。

comparisonType ComparisonType （可选）

比较文档时使用的比较类型。可选择以下选项：

• ComparisonType.Char：比较文档中的每个字符 (char)。
• ComparisonType.Line：比较文档中的每一行。
• ComparisonType.Word：比较文档中的每个单词。

选项 CompareDocumentsOptions

此操作应用于的特定比较选项。要创建 CompareDocumentsOptions 类型的对象，请使用 TestingOptions.CompareDocuments 类。

返回值

ComparisonResult

比较操作的结果，存储在 ComparisonResult 变量中。

示例

1. 按字符比较 PDF：
   在此示例中，我们将比较两个 PDF 文件，即电费单和水费单。比较在字符级别完成。这些 PDF 文件的路径由 firstBill 和 secondBill 变量表示。与 WithIgnoreWildcardRule 和 WithIgnoreRegexRule 方法一起提供的通配符规则和正则表达式规则用于忽略比较中的特定模式。例如，通配符规则 2022 和正则表达式规则 \d{1,2}/\d{1,2}/\d{4} 会在比较中忽略日期（假设它们的格式为 MM/DD/YYYY），因为它们在两个单独的账单中可能有所不同，并且与 Orchestrator 账单的结构无关。
   完成比较后，WithGenerateHtml 方法会创建比较的 HTML 报告，并会使用 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. 按单词比较 PDF：
   在本示例中，我们将比较与上一个示例中相同的 PDF 文件：电费单和水费单。比较在单词级别完成。这些 PDF 文件的路径由 firstBill 和 secondBill 变量表示。与 WithIgnoreWildcardRule 和 WithIgnoreRegexRule 方法一起提供的通配符规则和正则表达式规则用于忽略比较中的特定模式。例如，通配符规则 2022 会在比较中忽略日期（假设其格式为 MM/DD/YYYY），因为它们在两个单独的账单中可能有所不同，并且与账单的结构无关。正则表达式规则 [$]\d+\.\d{2} 假定货币值的格式类似于 $XX.XX，会忽略货币值。
   完成比较后，WithGenerateHtml 方法会创建比较的 HTML 报告，并会使用 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. 按行比较 PDF：
   在此示例中，与上一个示例类似，我们将比较两个 PDF 文件，即电费单和水费单。在这种情况下，比较是在行级别完成的。这些 PDF 文件的路径由 firstBill 和 secondBill 变量表示。与 WithIgnoreWildcardRule 和 WithIgnoreRegexRule 方法一起提供的通配符规则和正则表达式规则用于忽略比较中的特定模式。
   例如，通配符规则 2022 会在比较中忽略日期（假设其格式为 MM/DD/YYYY），因为它们在两个单独的账单中可能有所不同，并且与账单的结构无关。正则表达式规则 [$]\d+\.\d{2} 假定货币值的格式类似于 $XX.XX，会忽略货币值。
   完成比较后，WithGenerateHtml 方法会创建比较的 HTML 报告，并会使用 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);

在所有示例中，AreEquivalent 属性都会返回文档是否相等的信息。