💡 Ví dụ hoạt động đầy đủ có trên GitHub: one-line-document-merge-and-split-dotnet
Nơi các công việc tài liệu Back-Office thực sự diễn ra
Một bộ phận tài chính trong back office kết thúc tháng bằng cách ghim một trang bìa vào file PDF báo cáo của tháng trước. Một đội ngũ hợp đồng thêm một phụ lục đã ký vào thỏa thuận gốc trước khi nó được lưu trữ. Một trợ lý sales-ops lấy ra hai slide từ một bộ slide sáu mươi slide vì một bên liên quan chỉ cần trang giá. Một nhân viên lưu trữ loại bỏ một trang không bao giờ nên được gửi, ngay trước khi file rời khỏi tòa nhà.
Không có công việc nào trong số này là dự án hợp nhất. Mỗi công việc chỉ là một tệp và một thao tác, được thực hiện theo cùng một cách mỗi khi công việc chạy, thường bởi người không muốn học một API tài liệu đa mục đích chỉ để thực hiện.
GroupDocs.Merger.LowCode là một gói .NET chuyển một công việc như vậy—một việc nối, tách hoặc loại bỏ trang—thành một lời gọi constructor duy nhất, tách biệt khỏi lớp Merger đa mục đích mà các công việc này không bao giờ cần. Mỗi trong bảy sản phẩm của nó nhận nguồn và các tùy chọn trong constructor, bằng C#, và chỉ thực thi khi Save được gọi, cùng một cấu trúc bất kể công việc là PDF, tài liệu Word hay bộ PowerPoint.
Tại sao các giải pháp chung không hiệu quả ở đây
Các nhóm đối mặt với một trong những công việc này thường thử một trong ba cách trước khi tìm đến một gói chuyên biệt:
- Thực hiện thủ công trong trình chỉnh sửa trên máy tính: phù hợp cho một tài liệu, không thể lên lịch, và không ai chấp thuận một bước thủ công chạy vào lúc 2 giờ sáng.
- Viết một script một lần đối với các API tệp thô: hoạt động cho đến khi định dạng đầu vào tiếp theo xuất hiện, và script phát triển thành chính client đa mục đích mà nó muốn tránh.
- Sử dụng lớp
Mergerđầy đủ cho một lời gọi duy nhất: đúng, nhưng nó thêm một bề mặt API rộng hơn so với nhu cầu của một thao tác.
GroupDocs.Merger.LowCode tồn tại chính để lấp đầy khoảng trống cuối cùng đó: một lời gọi cho mỗi thao tác, không cần học gì khác trước.
Giải pháp: GroupDocs.Merger.LowCode cho các quy trình Back-Office
GroupDocs.Merger.LowCode gói bảy sản phẩm đơn mục đích phía sau cấu trúc constructor‑sau‑Save duy nhất. JoinPdf và JoinDocx thêm một tài liệu vào tài liệu khác; JoinPptx làm tương tự cho các bộ slide; SplitPdf, SplitDocx và SplitPptx lấy các trang hoặc slide đã chọn vào các file riêng; RemovePagesPdf loại bỏ các trang mà không chạm vào nguồn. Mỗi trong số bảy sản phẩm chấp nhận nguồn dưới dạng đường dẫn hoặc stream và kiểm tra nguồn đó, cùng với mọi file được cung cấp, theo định dạng của chúng trước khi ghi bất kỳ nội dung nào, vì vậy một pipeline không bao giờ phải đoán lý do đầu ra sai.
Để theo dõi triển khai dưới đây, bạn sẽ cần:
- .NET 6.0 hoặc mới hơn (dự án mẫu này nhắm tới net8.0)
- Gói NuGet riêng biệt
GroupDocs.Merger.LowCode - Một giấy phép tạm thời, nếu bạn muốn xem đầu ra mà không có các giới hạn đánh giá được mô tả ở dưới
dotnet add package GroupDocs.Merger.LowCode
Gói này tồn tại riêng trên NuGet so với thư viện chính GroupDocs.Merger.
Triển khai công việc Reporting-Pack từng bước
Đây là cấu trúc mà mỗi trong bảy sản phẩm tuân theo, được minh họa qua việc nối một trang bìa vào file PDF hàng tháng.
Bước 1: Chỉ định nguồn cho sản phẩm
Constructor của JoinPdf nhận tài liệu nguồn, mọi file cần thêm, và một thể hiện JoinOptions; chưa có gì chạy.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Bước 2: Quyết định nơi lưu kết quả
Save(outputPath) là nơi công việc thực sự ghi lại. Đường dẫn tương đối được giải quyết dựa trên thư mục làm việc hiện tại của tiến trình, và Save tạo thư mục đầu ra nếu nó chưa tồn tại, vì vậy một pipeline ghi vào thư mục tháng mới mỗi lần chạy không cần bước riêng để tạo nó.
string outputPath = "output/monthly/report-with-appendix.pdf";
Tại sao điều này quan trọng đối với một công việc không có người giám sát:
- Một đường dẫn bạn kiểm soát: xây dựng đường dẫn đầu ra từ cấu hình hoặc tham số công việc, không bao giờ lấy trực tiếp từ đầu vào chưa được xác thực;
SavenémArgumentNullExceptionkhi đường dẫn null hoặc rỗng. - Thư mục nó tạo: một công việc được lên lịch ghi vào một đích mới mỗi lần chạy không cần bước riêng “đảm bảo thư mục tồn tại”.
Bước 3: Thực thi và nắm bắt kết quả trả về
Gọi Save thực hiện việc nối ngay lập tức; không có bước xây dựng‑sau‑thực thi riêng.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
Trong lần chạy của chúng tôi với các file mẫu, lời gọi đó đã nối một file report.pdf 2 trang với một appendix.pdf 2 trang thành một file report-with-appendix.pdf 4 trang, kích thước 257987 byte.
Bước 4: Đưa kết quả trở lại pipeline
Kích thước file đọc ngay sau Save thường là tất cả những gì một scheduler cần trước khi đánh dấu công việc hoàn thành, hoặc trước khi so sánh với kích thước tối thiểu để quyết định liệu đầu ra có đủ tin cậy để tiếp tục hay không.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
GroupDocs.Merger.LowCode có chấp nhận Stream thay vì Đường dẫn tệp không?
Có, ở phía đầu vào. Mỗi trong bảy sản phẩm chấp nhận nguồn dưới dạng stream ở vị trí constructor tương tự như khi dùng đường dẫn tệp, hữu ích khi đầu vào của công việc đến từ blob storage hoặc queue thay vì đĩa cục bộ. Save vẫn ghi kết quả vào một chuỗi đường dẫn đầu ra bất kể cách nào; việc stream đầu ra vẫn nằm trong lớp Merger đầy đủ.
Quy trình thực tế: Từ chối file trước khi nó tới lưu trữ
Một đội ngũ hợp đồng thêm phụ lục vào các thỏa thuận đã ký không thể chấp nhận bất kỳ file nào đến hộp thư; một phụ lục .docx bị nhầm với một file PDF sẽ tạo ra mục lưu trữ hỏng. JoinPdf kiểm tra nguồn và mọi file được thêm theo định dạng PDF trước khi ghi bất kỳ nội dung nào, và ném FileTypeNotSupportedException ngay khi một trong số chúng không khớp.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
Trong lần chạy mẫu, khi các đường dẫn được xây dựng từ thư mục resources, thông báo là: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
Công việc trên sẽ không bao giờ ghi output/mixed.pdf khi bắt lỗi, vì vậy một pipeline hợp đồng có thể chuyển thông báo đó trực tiếp vào bất kỳ cảnh báo hoặc hàng đợi ticket nào đã sử dụng, thay vì phát hiện mục lưu trữ hỏng sau vài ngày.
Các kịch bản Back-Office khác mà mẫu này phù hợp
Khi việc nối ở trên đã hoạt động, cùng một cấu trúc constructor‑sau‑Save bao phủ nhiều công việc mà back office chạy theo lịch:
- Cắt bớt một trang trước khi tài liệu rời khỏi tòa nhà:
RemovePagesPdfloại bỏ các trang đã chọn và ghi một file mới mà không chạm vào nguồn, vì vậy bản gốc vẫn có sẵn để kiểm toán sau khi bản sao đã cắt được gửi đi. Trong lần chạy của chúng tôi, việc loại bỏ trang 2 khỏireport.pdftạo ra một filereport-without-page-2.pdf1 trang, 86647 byte, vàreport.pdfvẫn không thay đổi. - Tách một bộ slide cho một bên liên quan:
SplitPptxlấy các slide yêu cầu vào các file riêng, đặt tên bằng token{0}trong mẫu đầu ra hoặc, nếu không có, bằng số phần được thêm vào cùng thư mục, cùng mẫu màSplitPdfdùng để tách các trang PDF. - Hợp nhất tài liệu Word thay vì PDF:
JoinDocxtuân theo cấu trúc constructor‑sau‑Savegiống nhưJoinPdf, đặt tài liệu được thêm sau trang cuối cùng của nguồn.
Nếu không có giấy phép, mỗi công việc này chạy ở chế độ đánh giá. Trong lần chạy không có giấy phép của chúng tôi, các file PDF và Word đã được cắt xuống còn 3 trang mỗi file, mặc dù tất cả sáu đầu ra mẫu vẫn được tạo; hãy áp dụng giấy phép bằng License.Set trước khi bất kỳ công việc nào này chạy không có giám sát trong môi trường sản xuất.
Bắt đầu trong pipeline Back-Office của bạn
Bạn đã có một mẫu hợp nhất tài liệu low-code hoạt động từ đầu đến cuối, cùng bằng chứng rằng kiểm tra định dạng phía sau nó chạy trên mỗi lời gọi. Dưới đây là các bước tiếp theo:
- Xem toàn bộ bức tranh: hướng dẫn hướng dẫn trường hợp sử dụng walks each of the sample’s six operations method by method, with a full FAQ.
- Đi sâu hơn khi công việc mở rộng: API đầy đủ của GroupDocs.Merger covers more ground than this pattern needs the moment a pipeline outgrows one operation.
- Duyệt mã: mẫu đầy đủ trên GitHub includes every input file used above.
- Cài đặt: trang cài đặt covers the separate package and its supported target frameworks.
- Loại bỏ các giới hạn đánh giá: lấy một giấy phép tạm thời before running any of this in production.
- Câu hỏi: diễn đàn hỗ trợ is where the team answers implementation questions.