مصمم صفحات الوثائق - كيفية دمج صفحات معينة من الوثائق

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

Page Builder - كيفية دمج الصفحات من المستندات

الموضوعات التالية تناقش هنا:

فهم منشئ الصفحة
Sample case and code implementation
تحديد نطاق الصفحات المطلوبة
استنتاج

إذا كنت مهتمًا بـ Merging documents online، قم بزيارة Online Merging Tool الذي تدعمه GroupDocs.

فهم مُنشئ الصفحات

تقدم ميزة منشئ الصفحات طريقة مبسطة لإنشاء مستندات مخصصة من خلال دمج الصفحات من مستندات مصدر متعددة. تتيح هذه الميزة للمطورين إنشاء مستند جديد خطوة بخطوة، وإضافة الصفحات بأي تسلسل من وثقتين أو أكثر. إليك كيف تعمل العملية:

ابدأ بتحميل مستند Word المصدر باستخدام فئة Merger ومرر إلى المنشئ أحد مستندات المصدر.
انضم إلى الوثائق واحدة تلو الأخرى للدمج باستخدام طريقة Join.
قم بتهيئة Page Builder. عبر الطريقة CreatePageBuilder من مثيل Merger . هذا يعد نقطة البداية لبناء المستند الجديد الخاص بك.
تسمح طريقة AddPage الخاصة بنموذج Page Builder بإضافة أي صفحة معينة من المستندات المنضمة مسبقًا إلى المستند الوجهة.
لكل مستند مصدر، اختر الصفحات المحددة التي تريد تضمينها في الفهرس؛
add these pages to the new document in the desired sequence. You can mix and match pages from different documents to meet your needs;
كرر هذه العملية لمستندات المصدر الإضافية، مع التأكد من أن لديك المرونة لدمج الصفحات بطريقة تناسب متطلباتك؛
استخدام ApplyPageBuilder طريقة لتطبيق التغييرات من مثيل Page Builder
احفظ المستند المدمج في أي وجهة. بمجرد إضافة جميع الصفحات اللازمة، احفظ المستند الجديد. ستكون النتيجة النهائية ملفًا مخصصًا بالكامل يحتوي على صفحات من مصادر متعددة، منظمة تمامًا كما تريدها.

تجعل هذه الطريقة خطوة بخطوة من السهل إنشاء مستندات مصممة لحالات استخدام محددة، مثل تجميع التقارير، إنشاء العروض التقديمية المخصصة، أو تجميع المستندات القانونية. مع Page Builder، يتمتع المطورون بالتحكم الكامل في ترتيب الصفحة والمحتوى، مما يلغي الحاجة إلى التعديلات اليدوية المستهلكة للوقت ويضمن الدقة في الناتج النهائي.

حالة عينة وتنفيذ الشيفرة

دعونا نوضح كيفية استخدام ميزة منشئ الصفحات في GroupDocs.Merger من خلال مثال عملي. لتبسيط الحالة نفترض أن لدينا وثيقتين:

Document A with 4 pages.
Document B مع 4 صفحات.

نهدف إلى إنشاء مستند جديد عن طريق دمج صفحات من هذين المستندين بتسلسلات مختلفة بناءً على سيناريوهات محددة.

Page Builder - هيكل مستندات عينة A و B مع 4 صفحات لكل منهما

هنا قمنا بوضع علامة على كل صفحة من الوثيقة بحرف الوثيقة A، B ورقم الصفحة. من الوثائق A و B نحتاج إلى تلقي الوثيقة المفصلة C بالهيكل التالي.

تظهر الشفرة البرمجية التالية كيفية دمج صفحات معينة من عدة مستندات في المستند الناتج.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

تحديد نطاق الصفحات المطلوبة

عند العمل على معالجة الوثائق، فإن إضافة صفحات متعددة بكفاءة أمر حاسم للتعامل مع تدفقات العمل المعقدة. بدلاً من إضافة الصفحات بشكل فردي، يمكنك استخدام طريقة AddPageRange، التي تقبل مصفوفة من كائنات IPageInfo، كل منها يمثل صفحة معينة. هذه الطريقة تبسط العملية، وتقلل من تكرار الشيفرة، وتحسن الأداء من خلال السماح بعمليات الدفعة. أدناه مثال على الشيفرة يوضح كيفية استخدام هذه الطريقة لإضافة صفحات متعددة من مستندات مختلفة في عملية واحدة مبسطة.

إليك الخطوات لتجميع عدة صفحات من مستندات متنوعة مع تحديدها كنطاق:

أنشئ كائن Merger وقدم المسار أو التدفق لملف المصدر.
استخدم Join لإضافة مستند مصدر آخر. كرر هذه الخطوة لكل مستند تريد دمجه.
إنشاء كائن PageBuilder عن طريق استدعاء طريقة CreatePageBuilder.
استدعِ طريقة AddPageRange وتمرير مصفوفة من IPageInfo الأشياء التي تصف الصفحات المناسبة. يرجى ملاحظة أن IPageInfo الأشياء تستخدم ترقيمًا يعتمد على الصفر للوثائق المصدر وأرقام الصفحات.
استخدم طريقة ApplyPageBuilder لتطبيق الترتيب المحدد للصفحات على الوثيقة المدمجة.
احفظ الوثيقة الناتجة عن طريق استدعاء الطريقة Save وتوفير مسار الملف.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

خاتمة

توضح هذه الأمثلة قدرة ميزة منشئ الصفحات. يمكن للمطورين بسهولة دمج الصفحات من مستندات متعددة بترتيبات متنوعة لإنشاء مخرجات مخصصة. تقلل هذه الميزة بشكل كبير من العمل اليدوي وتضمن الدقة في توليد المستندات، مما يجعلها أداة أساسية لحالات الاستخدام المتنوعة.

احصل على ترخيص API مجاني

يمكنك get a free temporary license لاستخدام واجهة برمجة التطبيقات بدون قيود التقييم.

قم ببناء تطبيق منشئ صفحة دمج خاص بك

هنا بعض الروابط المهمة التي ستساعدك في بناء تطبيق مقارنة الوثائق الخاص بك.

Documentation | API Reference | Supported File Formats

Running Examples – GitHub | Free Support Forum | Release Notes

انظر أيضا

لمزيد من المعلومات والموارد الإضافية، قد تجد الروابط التالية مفيدة:

فهم مُنشئ الصفحات#

حالة عينة وتنفيذ الشيفرة#

تحديد نطاق الصفحات المطلوبة#

خاتمة#

احصل على ترخيص API مجاني#

قم ببناء تطبيق منشئ صفحة دمج خاص بك#

انظر أيضا#