💡 ตัวอย่างทำงานเต็มที่พร้อมบน 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 คือที่ทีมตอบคำถามการนำไปใช้

แหล่งข้อมูล