💡 ตัวอย่างทำงานเต็มที่พร้อมบน GitHub:
one-line-document-merge-and-split-dotnet
ที่งานเอกสารของ Back-Office จริง ๆ แล้วอยู่ที่ไหน
สำนักงานการเงินของ Back-Office ปิดเดือนโดยการเย็บหน้าปกเข้ากับ PDF ใบแจ้งยอดของเดือนก่อนหน้า ทีมสัญญาเพิ่มภาคผนวกที่ลงนามแล้วเข้าไปในสัญญาต้นฉบับก่อนส่งไปเก็บถาวร ผู้ช่วยฝ่ายขาย‑ops ดึงสองสไลด์ออกจากชุดสไลด์หกสิบสไลด์เพราะผู้มีส่วนได้ส่วนเสียคนหนึ่งต้องการเพียงหน้าราคาตามต้องการ พนักงานบันทึกข้อมูลลบหน้าที่ไม่ควรส่งออกก่อนที่ไฟล์จะออกจากอาคาร
ไม่มีงานใดในนี้เป็นโครงการรวมไฟล์ (merge) แต่ละงานเป็นไฟล์เดียวและการดำเนินการเดียว ทำซ้ำแบบเดียวกันทุกครั้งที่งานทำงาน โดยส่วนใหญ่ทำโดยคนที่ไม่มีความสนใจเรียนรู้ API เอกสารทั่วไปเพียงเพื่อให้สำเร็จ
GroupDocs.Merger.LowCode เป็นแพคเกจ .NET ที่เปลี่ยนงานเช่นนี้—การรวม, การแยก, หรือการลบหน้า—ให้เป็นการเรียกคอนสตรัคเตอร์เดียว แยกออกจากคลาส Merger ที่ออกแบบเพื่อการใช้งานทั่วไปที่งานเหล่านี้ไม่ต้องการ แต่ละผลิตภัณฑ์ทั้งเจ็ดรับแหล่งที่มาและตัวเลือกในคอนสตรัคเตอร์ด้วย C# และทำงานเพียงครั้งเดียวเมื่อเรียก Save ไม่ว่าจะเป็นงาน PDF, Word, หรือ PowerPoint
ทำไมวิธีแก้ทั่วไปไม่สามารถใช้ได้ที่นี่
ทีมที่เผชิญกับงานเหล่านี้มักจะลองทำอย่างใดอย่างหนึ่งในสามอย่าง ก่อนที่จะเลือกใช้แพคเกจที่เน้นเฉพาะ:
- ทำด้วยตนเองในโปรแกรมแก้ไขบนเดสก์ท็อป: เหมาะกับเอกสารเดียว แต่จัดตารางไม่ได้ และไม่มีใครอนุมัติขั้นตอนมือที่ทำตอนตี 2
- เขียนสคริปต์เฉพาะครั้งเดียวโดยใช้ API ไฟล์ดิบ: ทำงานได้จนรูปแบบไฟล์ใหม่ปรากฏ และสคริปต์จะเติบโตเป็นไคลเอนต์ทั่วไปที่พยายามหลีกเลี่ยง
- ใช้คลาส
Mergerเต็มรูปแบบสำหรับการเรียกครั้งเดียว: ถูกต้อง แต่เพิ่มพื้นผิว API ที่กว้างกว่าที่การดำเนินการเดียวต้องการ
GroupDocs.Merger.LowCode มีไว้เพื่อเติมช่องว่างสุดท้ายนี้: การเรียกหนึ่งครั้งต่อการดำเนินการ ไม่ต้องเรียนรู้อะไรเพิ่มเติมก่อน
วิธีแก้: GroupDocs.Merger.LowCode สำหรับไพป์ไลน์ Back-Office
GroupDocs.Merger.LowCode จัดรวมผลิตภัณฑ์เจ็ดตัวที่มีจุดประสงค์เดียวไว้หลังรูปแบบคอนสตรัคเตอร์‑แล้ว‑Save JoinPdf และ JoinDocx เพิ่มเอกสารต่ออีกไฟล์หนึ่ง; JoinPptx ทำเช่นเดียวกันสำหรับชุดสไลด์; SplitPdf, SplitDocx และ SplitPptx ดึงหน้าหรือสไลด์ที่เลือกออกเป็นไฟล์ของตนเอง; RemovePagesPdf ลบหน้าที่เลือกโดยไม่กระทบแหล่งที่มา ทุกตัวรับแหล่งที่มาเป็นพาธหรือสตรีมและตรวจสอบแหล่งที่มานั้นรวมถึงไฟล์ที่ให้ทั้งหมดกับรูปแบบของตนก่อนเขียนใด ๆ ทำให้ไพป์ไลน์ไม่ต้องเดาว่าเหตุใดผลลัพธ์จึงผิดพลาด
เพื่อทำตามการนำไปใช้ด้านล่าง คุณจะต้องมี:
- .NET 6.0 หรือใหม่กว่า (โครงการตัวอย่างนี้ตั้งเป้าหมายที่ net8.0)
- แพคเกจ
GroupDocs.Merger.LowCodeแยกต่างหากจาก NuGet - temporary license หากต้องการดูผลลัพธ์โดยไม่มีข้อจำกัดการประเมินที่อธิบายต่อไป
dotnet add package GroupDocs.Merger.LowCode
แพคเกจนี้อยู่แยกจาก NuGet จากไลบรารีหลัก GroupDocs.Merger
การนำ Pattern การรวมเอกสารแบบ Low‑Code ไปใช้ในงาน 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จะโยนArgumentNullExceptionหากพาธเป็น null หรือว่างเปล่า - โฟลเดอร์ที่สร้างขึ้น: งานที่กำหนดให้เขียนไปยังปลายทางใหม่ทุกครั้งไม่ต้องมีขั้นตอน “ตรวจสอบว่ามีโฟลเดอร์หรือไม่” แยกออกมา
ขั้นตอนที่ 3: เรียกใช้และจับผลลัพธ์ที่คืนกลับมา
การเรียก Save จะทำการรวมทันที ไม่มีขั้นตอน “สร้าง‑แล้ว‑รัน” แยกต่างหาก
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
ในการทดสอบของเรา การเรียกนี้รวม report.pdf (2 หน้า) กับ appendix.pdf (2 หน้า) ให้เป็นไฟล์ report-with-appendix.pdf (4 หน้า, ขนาด 257987 ไบต์)
ขั้นตอนที่ 4: ส่งผลลัพธ์กลับเข้าสู่ไพป์ไลน์
ขนาดไฟล์ที่อ่านหลังจาก Save มักเป็นข้อมูลที่ตัวจัดตารางต้องการก่อนทำเครื่องหมายว่างานเสร็จ หรือก่อนเปรียบเทียบกับขนาดขั้นต่ำเพื่อพิจารณาว่าผลลัพธ์เชื่อถือได้พอที่จะดำเนินต่อหรือไม่
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
GroupDocs.Merger.LowCode รองรับการรับสตรีมแทนพาธไฟล์หรือไม่?
ใช่, สำหรับด้านอินพุต ผลิตภัณฑ์ทั้งเจ็ดรับแหล่งที่มาเป็นสตรีมในตำแหน่งคอนสตรัคเตอร์เดียวกับที่รับพาธไฟล์ ซึ่งเหมาะเมื่ออินพุตของงานมาจาก Blob Storage หรือคิวแทนดิสก์ท้องถิ่น 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 เมื่อเกิดการจับข้อยกเว้น ดังนั้นไพป์ไลน์ของทีมสัญญาสามารถส่งข้อความนี้ตรงเข้าสู่ระบบแจ้งเตือนหรือคิวตั๋วที่ใช้อยู่แล้ว แทนที่จะค้นพบรายการเก็บถาวรที่เสียหายหลายวันต่อมา
สถานการณ์ Back‑Office อื่น ๆ ที่ Pattern นี้เหมาะสม
เมื่อการรวมด้านบนทำงานได้ รูปแบบคอนสตรัคเตอร์‑แล้ว‑Save นี้สามารถนำไปใช้กับงานหลาย ๆ งานที่ Back‑Office รันตามกำหนดเวลาได้:
- ตัดหน้าก่อนเอกสารออกจากอาคาร:
RemovePagesPdfลบหน้าที่เลือกและเขียนไฟล์ใหม่โดยไม่กระทบแหล่งที่มา ทำให้ไฟล์ต้นฉบับยังคงอยู่สำหรับการตรวจสอบหลังจากสำเนาที่ตัดแล้วถูกส่งออก ในการทดสอบของเรา การลบหน้า 2 จากreport.pdfให้ไฟล์report-without-page-2.pdf(1 หน้า, 86647 ไบต์) ส่วนreport.pdfยังคงไม่เปลี่ยนแปลง - แยกชุดสไลด์สำหรับผู้มีส่วนได้ส่วนเสียคนหนึ่ง:
SplitPptxดึงสไลด์ที่ร้องขอออกเป็นไฟล์ของตนเอง ตั้งชื่อด้วยโทเค็น{0}ในรูปแบบพาธผลลัพธ์ หรือหากไม่มีโทเค็นจะเพิ่มหมายเลขส่วนต่อท้ายในโฟลเดอร์เดียวกัน รูปแบบเดียวกับที่SplitPdfใช้สำหรับแยกหน้าของ PDF - รวมเอกสาร Word แทน PDF:
JoinDocxทำตามรูปแบบคอนสตรัคเตอร์‑แล้ว‑SaveเหมือนJoinPdfโดยวางเอกสารที่เพิ่มหลังหน้าสุดท้ายของแหล่งที่มา
หากไม่มีใบอนุญาต ทุกงานเหล่านี้จะทำงานในโหมดประเมินผล ในการทดสอบที่ไม่มีใบอนุญาตของเรา PDF และ Word ที่รวมแล้วถูกตัดเหลือ 3 หน้าแต่ละไฟล์ แม้ว่าตัวอย่างทั้งหมดหกไฟล์จะยังคงสร้างได้; ให้ตั้งค่าใบอนุญาตด้วย License.Set ก่อนรันแบบอัตโนมัติในสภาพแวดล้อมการผลิต
เริ่มต้นใช้งานในไพป์ไลน์ Back‑Office ของคุณ
คุณมีรูปแบบการรวมเอกสารแบบ low‑code ที่ทำงานครบวงจร พร้อมหลักฐานว่าการตรวจสอบรูปแบบทำงานทุกครั้ง นี่คือขั้นตอนต่อไป:
- ดูภาพรวมทั้งหมด: use-case guide คู่มือช่วยอธิบายแต่ละขั้นตอนของหกการดำเนินการในตัวอย่าง พร้อม FAQ ฉบับเต็ม
- เจาะลึกเมื่องานขยาย: full GroupDocs.Merger API ครอบคลุมความสามารถมากกว่าที่ Pattern นี้ต้องการเมื่อไพป์ไลน์เติบโตเกินการดำเนินการเดียว
- ดูโค้ด: complete sample on GitHub มีไฟล์อินพุตทั้งหมดที่ใช้ในบทความ
- ติดตั้ง: installation page อธิบายแพคเกจแยกต่างหากและเฟรมเวิร์กเป้าหมายที่รองรับ
- ลบข้อจำกัดการประเมินผล: รับ temporary license ก่อนนำไปใช้ในสภาพแวดล้อมการผลิต
- คำถาม: support forum คือที่ทีมตอบคำถามการนำไปใช้