💡 完整的工作示例可在 GitHub 上获取: one-line-document-merge-and-split-dotnet

后台办公文档任务的实际所在

财务后台通过将封面页装订到上个月的对账单 PDF 上来结束本月。合同团队在原始协议归档前附加已签署的修订。销售运营助理从六十页的演示文稿中抽取两张幻灯片,因为某位利益相关者只需要定价页。记录文员在文件离开大楼前删除一页本不应发出的页面。

这些都不是合并项目。每次作业运行时,它们都是单个文件和单个操作,以相同的方式完成,通常由对学习通用文档 API 没有兴趣的人执行。

GroupDocs.Merger.LowCode 是一个 .NET 包,它将此类作业(合并、拆分或页面删除)转换为单个构造函数调用,区别于这些作业根本不需要的通用 Merger 类。它的七个产品都在构造函数中接受源文件和选项(使用 C#),并且仅在调用 Save 时运行,无论作业是 PDF、Word 文档还是 PowerPoint 演示文稿,形式都相同。

为什么通用解决方案在这里行不通

面对这些作业的团队通常在寻找专用包之前会尝试以下三种方法之一:

  • 在桌面编辑器中手动操作:对单个文档来说可以,但无法排程,且没有人会批准在凌晨 2 点运行的手动步骤。
  • 针对原始文件 API 编写一次性脚本:在出现新的输入格式之前可以工作,但脚本会逐渐演变成它本应避免的通用客户端。
  • 为单次调用而使用完整的 Merger 类:虽然正确,但它引入了比单个操作所需更广的 API。

GroupDocs.Merger.LowCode 正是为了解决最后这一空白而存在:每个操作只需一次调用,无需先学习其他内容。


解决方案:用于后台办公流水线的 GroupDocs.Merger.LowCode

GroupDocs.Merger.LowCode 将七个单一用途的产品封装在这种构造函数后调用 Save 的模式中。JoinPdf 和 JoinDocx 将文档追加到另一个文档;JoinPptx 对演示文稿执行相同操作;SplitPdf、SplitDocx 和 SplitPptx 将选定的页面或幻灯片提取到各自的文件中;RemovePagesPdf 在不触及源文件的情况下删除页面。七个产品都接受路径或流作为源,并在写入之前检查源及其提供的每个文件是否符合相应的格式,因此流水线无需猜测输出错误的原因。

要跟随下面的实现,您需要:

  • .NET 6.0 或更高版本(此示例项目目标为 net8.0)
  • 单独的 GroupDocs.Merger.LowCode NuGet 包
  • 一个临时许可证,如果您想在不受后文所述评估限制的情况下查看输出
dotnet add package GroupDocs.Merger.LowCode

该包在 NuGet 上独立于主 GroupDocs.Merger 库发布。


步骤式实现 Reporting-Pack 作业

以下是七个产品遵循的模式示例,以将封面页追加到月度 PDF 的合并操作为例进行说明。

步骤 1:指定产品的源文件

JoinPdf 的构造函数接受源文档、所有要追加的文件以及一个 JoinOptions 实例;此时尚未执行任何操作。

var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());

步骤 2:决定结果的保存位置

Save(outputPath) 是作业实际提交的地方。相对路径相对于进程的当前工作目录解析,Save 会在输出文件夹不存在时创建它,因此每次运行时向新月份文件夹写入的流水线无需额外的创建步骤。

string outputPath = "output/monthly/report-with-appendix.pdf";

为什么这对无人值守作业很重要:

  • 可控的路径:从配置或作业参数构建输出路径,切勿直接使用未经验证的输入;Save 在路径为 null 或空时会抛出 ArgumentNullException。
  • 它创建的文件夹:每次运行时写入新目标的计划任务不需要额外的“确保目录存在”步骤。

步骤 3:运行并捕获返回结果

调用 Save 会立即执行合并;不存在单独的构建后执行步骤。

join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;

在我们对示例文件的运行中,该调用将 2 页的 report.pdf 与 2 页的 appendix.pdf 合并为 4 页、257987 字节的 report-with-appendix.pdf。

步骤 4:将结果反馈回流水线

在 Save 之后读取的文件大小通常是调度程序在标记作业完成或在将其与最小尺寸比较以决定输出是否足够可信以继续处理时所需的全部信息。

if (sizeInBytes == 0)
{
    throw new InvalidOperationException("Join produced an empty file.");
}

GroupDocs.Merger.LowCode 是否接受流而非文件路径?

是的,针对输入端。七个产品都可以在构造函数中接受流作为源文件,位置与文件路径相同,这在作业输入来自 Blob 存储或队列而非本地磁盘时非常有用。Save 仍然会将结果写入输出路径字符串;若要对输出进行流式处理,需要使用完整的 Merger 类。


实际工作流:在文件进入归档前进行拒绝

合同团队在已签署协议上追加修订时,不能冒险接受收件箱中任意文件;如果将 .docx 修订误放在 PDF 合并旁边,会导致归档条目损坏。JoinPdf 在写入之前会检查源文件和所有追加文件是否符合 PDF 格式,并在发现不匹配时立即抛出 FileTypeNotSupportedException。

try
{
    new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
        .Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
    Console.WriteLine(exception.Message);
}

在示例运行中,路径来自其 resources 文件夹,消息为:Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'。

上述作业在捕获异常时不会写入 output/mixed.pdf,因此合同流水线可以将该消息直接发送到已有的警报或工单队列,而不是在数天后才发现归档条目错误。


其他适用此模式的后台办公场景

一旦上述合并工作正常运行,同样的构造函数后调用 Save 形式即可覆盖后台办公按计划执行的多个作业:

  • 在文档离开大楼前裁剪页面:RemovePagesPdf 删除指定页面并写入新文件,源文件保持不变,裁剪后的副本发出后原件仍可用于审计。在我们的运行中,删除 report.pdf 的第 2 页生成了 1 页、86647 字节的 report-without-page-2.pdf,而 report.pdf 本身保持不变。
  • 为单个利益相关者拆分演示文稿:SplitPptx 将请求的幻灯片提取到各自的文件中,文件名由输出模式中的 {0} 标记决定,若未使用该标记,则在同一文件夹中追加序号,这与 SplitPdf 拆分 PDF 页面时使用的模式相同。
  • 合并 Word 文档而非 PDF:JoinDocx 与 JoinPdf 采用完全相同的构造函数后 Save 形式,将追加的文档放在源文档的最后一页之后。

如果没有许可证,这些作业都会以评估模式运行。在我们未授权的运行中,合并后的 PDF 和 Word 输出均被裁减为 3 页,尽管仍生成了全部六个示例输出;在生产环境中无人值守运行之前,请使用 License.Set 应用许可证。


在后台办公流水线中快速入门

您已经拥有一个端到端可用的低代码文档合并模式,并且每次调用都会进行格式检查。以下是后续可参考的资源:

  • 了解完整全貌:配套的用例指南逐步讲解示例的六个操作,并提供完整的 FAQ。
  • 作业扩展后深入了解:完整的 GroupDocs.Merger API 涵盖的功能远超此模式,适用于流水线超出单一操作的情况。
  • 浏览代码:在GitHub 上的完整示例中包含了上述所有输入文件。
  • 安装:安装页面 介绍了该独立包及其支持的目标框架。
  • 解除评估限制:在生产环境运行前获取临时许可证。
  • 疑问:请前往支持论坛,团队会在此解答实现相关问题。

资源