💡 مثال كامل يعمل متاح على GitHub: one-line-document-merge-and-split-dotnet

أين توجد وظائف المستندات في المكتب الخلفي فعليًا

يقوم مكتب الشؤون المالية الخلفي بإغلاق الشهر بتثبيت صفحة غلاف على ملف PDF للبيان الشهري السابق. يضيف فريق العقود تعديلًا موقعًا إلى الاتفاقية الأصلية قبل أرشفتها. يسحب مساعد عمليات المبيعات شريحتين من عرض مكوّن من ستين شريحة لأن أحد أصحاب المصلحة احتاج فقط إلى صفحة التسعير. يزيل موظف السجلات صفحة لا ينبغي أن تُشحن أبدًا، قبل أن يغادر الملف المبنى.

لا أحد من هذه الحالات هو مشروع دمج. كل منها ملف واحد وعملية واحدة، تُنفّذ بنفس الطريقة في كل مرة يتم تشغيل الوظيفة، عادةً بواسطة شخص لا يهتم بتعلم واجهة برمجة تطبيقات مستندات عامة فقط للوصول إلى النتيجة.

GroupDocs.Merger.LowCode هي حزمة .NET تحول إحدى هذه الوظائف—الدمج أو التقسيم أو إزالة صفحة—إلى استدعاء مُنشئ واحد، متميزة عن فئة Merger العامة التي لا تحتاجها هذه الوظائف أبدًا. كل من منتجاتها السبعة يأخذ المصدر والخيارات في المُنشئ، بلغة C#، ويعمل مرة واحدة فقط عند استدعاء Save، بنفس الشكل سواء كانت الوظيفة ملف PDF أو مستند Word أو عرض PowerPoint.

لماذا لا تنجح الإصلاحات العامة هنا

عادةً ما تحاول الفرق التي تواجه إحدى هذه الوظائف أحد ثلاثة أشياء قبل اللجوء إلى حزمة مركزة:

  • القيام بذلك يدويًا في محرر سطح المكتب: مناسب لمستند واحد، لكنه مستحيل جدولة، ولا أحد يوافق على خطوة يدوية تُجرى في الساعة الثانية صباحًا.
  • كتابة سكريبت مخصص ضد واجهات ملفات خام: يعمل حتى يظهر تنسيق إدخال جديد، ثم يتحول السكريبت إلى عميل عام تمامًا ما كان يُراد تجنبه.
  • استخدام فئة Merger الكاملة لاستدعاء واحد: صحيح، لكنه يضيف سطح API أوسع مما تحتاجه عملية واحدة.

GroupDocs.Merger.LowCode موجودة لتملأ تلك الفجوة الأخيرة: استدعاء واحد لكل عملية، ولا شيء آخر لتعلمه أولًا.


الحل: GroupDocs.Merger.LowCode لأنابيب المكتب الخلفي

تُغلف GroupDocs.Merger.LowCode سبعة منتجات ذات غرض واحد خلف شكل المُنشئ ثم Save. JoinPdf و JoinDocx يضيفان مستندًا إلى آخر؛ JoinPptx يفعل ذلك للعرض؛ SplitPdf و SplitDocx و SplitPptx ينسحبان الصفحات أو الشرائح المختارة إلى ملفات منفصلة؛ RemovePagesPdf يزيل الصفحات دون لمس المصدر. كل واحد من السبعة يقبل مصدره كمسار أو تدفق ويتحقق من ذلك المصدر، بالإضافة إلى كل ملف يُعطى له، ضد تنسيقه الخاص قبل كتابة أي شيء، لذا لا تحتاج الأنابيب أبدًا إلى التخمين لماذا خرج الناتج خاطئًا.

للتبع التنفيذ أدناه، ستحتاج إلى:

  • .NET 6.0 أو أحدث (يستهدف مشروع العينة net8.0)
  • حزمة NuGet المستقلة GroupDocs.Merger.LowCode
  • رخصة مؤقتة، إذا أردت رؤية الناتج دون حدود التقييم المذكورة لاحقًا
dotnet add package GroupDocs.Merger.LowCode

تعيش الحزمة بشكل منفصل على NuGet عن مكتبة GroupDocs.Merger الرئيسية.


تنفيذ خطوة وظيفة حزمة التقارير خطوة بخطوة

إليك الشكل الذي تتبعه كل واحدة من المنتجات السبعة، موضحًا باستخدام الدمج الذي يضيف صفحة غلاف إلى ملف 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 المكوّن من صفحتين بملف appendix.pdf المكوّن من صفحتين إلى ملف report-with-appendix.pdf المكوّن من 4 صفحات وحجم 257987 بايت.

الخطوة 4: إرجاع النتيجة إلى الأنابيب

عادةً ما يكون حجم الملف المقروء مباشرةً بعد Save كل ما يحتاجه المجدول قبل وضع علامة إكمال على الوظيفة، أو قبل مقارنته بحجم أدنى لتحديد ما إذا كان الناتج موثوقًا بما يكفي للمضي قدمًا.

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

هل تقبل GroupDocs.Merger.LowCode تدفقًا بدلاً من مسار ملف؟

نعم، على جانب الإدخال. كل واحدة من المنتجات السبعة تقبل مصدرها كتيار في نفس موضع المُنشئ حيث يُوضع مسار الملف، وهو مفيد عندما يأتي إدخال الوظيفة من تخزين كتل أو طابور بدلاً من القرص المحلي. لا يزال 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 يزيل الصفحات المختارة ويكتب ملفًا جديدًا دون لمس المصدر، لذا يظل الأصل متاحًا للمراجعة بعد شحن النسخة المقتصّة. في تشغيلنا، إزالة الصفحة 2 من report.pdf أنتجت ملفًا من صفحة واحدة بحجم 86647 بايت اسمه report-without-page-2.pdf، وظل report.pdf نفسه دون تغيير.
  • تقسيم عرض لأحد أصحاب المصلحة: SplitPptx ينسحب الشرائح المطلوبة إلى ملفات منفصلة، تُسمى باستخدام رمز {0} في نمط الإخراج أو، إذا لم يُستخدم، برقم جزء مضاف في نفس المجلد، وهو نفس النمط الذي يستخدمه SplitPdf لتقسيم صفحات PDF.
  • دمج مستندات Word بدلاً من PDF: JoinDocx يتبع الشكل نفسه للمُنشئ ثم Save كما هو في JoinPdf، حيث يضع المستند المضاف بعد آخر صفحة في المصدر.

بدون رخصة، كل واحدة من هذه العمليات تعمل في وضع التقييم. في تشغيلنا غير المرخص، تم تقليل ملفات PDF وWord المدمجة إلى 3 صفحات لكلٍ منها، رغم أنه لا يزال يتم إنتاج جميع المخرجات الستة؛ ضع رخصة باستخدام License.Set قبل تشغيل أي من هذه الوظائف تلقائيًا في بيئة الإنتاج.


البدء في أنابيب المكتب الخلفي الخاصة بك

لديك نمط دمج مستند منخفض الكود يعمل من البداية إلى النهاية، بالإضافة إلى دليل على أن فحص التنسيق يعمل على كل استدعاء. إليك ما يمكنك القيام به الآن:

  • اطلع على الصورة الكاملة: دليل الحالة use-case guide يشرح كل واحدة من العمليات الست في العينة طريقةً طريقةً، مع أسئلة شائعة كاملة.
  • تعمق عندما تنمو الوظيفة: full GroupDocs.Merger API يغطي المزيد مما يحتاجه هذا النمط في اللحظة التي يتجاوز فيها خط الأنابيب عملية واحدة.
  • تصفح الشيفرة: complete sample on GitHub يتضمن كل ملف إدخال استخدمناه أعلاه.
  • ثبّتها: installation page يوضح الحزمة المنفصلة وإطارات العمل المستهدفة المدعومة.
  • أزل حدود التقييم: احصل على temporary license قبل تشغيل أي من هذا في الإنتاج.
  • أسئلة: support forum هو المكان الذي يجيب فيه الفريق على أسئلة التنفيذ.

موارد