سازنده صفحه مستند - چگونه صفحات خاصی از مستندات را ادغام کنیم

ویژگی Page Builder با اجازه دادن به کاربران برای ترکیب بدون درز صفحات از اسناد مختلف با دقت و سهولت، ادغام اسناد را متحول می‌کند. این ویژگی امکان ادغام صفحات را به هر ترتیبی فراهم می‌کند و کنترل کامل بر ساختار سند نهایی را می‌دهد. چه در حال ترکیب چند صفحه کلیدی باشید و چه در حال ایجاد یک سند جامع، این ابزار انعطاف‌پذیری و کارایی را تضمین می‌کند. با کاهش تلاش دستی، این فرآیند تهیه اسناد سفارشی را ساده کرده و زمان ارزشمندی را صرفه‌جویی می‌کند و در نتیجه بهره‌وری کلی را در هر دو روند کاری شخصی و حرفه‌ای افزایش می‌دهد.

Page Builder - چگونه صفحات را از اسناد ادغام کنیم

موارد زیر در اینجا مورد بحث قرار می‌گیرند:

درک صفحه ساز
نمونه مورد و پیاده‌سازی کد
مشخص کردن دامنه صفحات مورد نیاز
نتیجه گیری

اگر به Merging documents online علاقه‌مند هستید، به Online Merging Tool که توسط GroupDocs پشتیبانی می‌شود، مراجعه کنید.

درک صفحه ساز

ویژگی Page Builder یک روش ساده‌شده برای ایجاد مدارک سفارشی با ترکیب صفحات از چندین سند منبع معرفی می‌کند. این ویژگی به توسعه‌دهندگان این امکان را می‌دهد که یک سند جدید را مرحله به مرحله ایجاد کنند و صفحات را به هر ترتیبی از دو یا چند سند اضافه کنند. در اینجا نحوه عملکرد فرآیند آمده است:

با بارگذاری سند منبع Word با استفاده از کلاس Merger شروع کنید و یکی از اسناد منبع را به سازنده منتقل کنید.
اسناد را یکی یکی با استفاده از روش Join ادغام کنید.
ابتدا Page Builder را راه اندازی کنید. از متد CreatePageBuilder در نمونه Merger استفاده کنید. این به عنوان نقطه شروع برای ساخت سند جدید شما عمل می کند.
روش AddPage از نمونه Page Builder اجازه می‌دهد تا هر صفحه خاص از مستندات پیوسته را به سند مقصد اضافه کنید.
برای هر سند منبع، صفحات خاصی را که می‌خواهید بر روی نمایه شامل کنید، انتخاب کنید؛
این صفحات را به سند جدید با ترتیب دلخواه اضافه کنید. می‌توانید صفحات را از اسناد مختلف ترکیب و تطبیق دهید تا نیازهای خود را برآورده کنید؛
این فرآیند را برای مدارک منبع اضافی تکرار کنید، و اطمینان حاصل کنید که انعطاف‌پذیری لازم را برای ترکیب صفحات به گونه‌ای که بهترین نیازهای شما را برآورده کند، دارید؛
استفاده از ApplyPageBuilder روش برای اعمال تغییرات از نمونه Page Builder
مدرک ادغام شده را به هر مقصدی ذخیره کنید. پس از اضافه کردن همه صفحات لازم، مدرک جدید را ذخیره کنید. خروجی نهایی یک فایل کاملاً سفارشی شده خواهد بود که شامل صفحاتی از منابع متعدد است و به دقت سازماندهی شده است که شما می‌خواهید.

این رویکرد گام به گام ایجاد مستندات متناسب با سناریوهای خاص، از جمله جمع‌آوری گزارش‌ها، ایجاد ارائه‌های شخصی‌سازی‌شده، یا گردآوری مستندات قانونی را آسان می‌کند. با Page Builder، توسعه‌دهندگان کنترل کامل بر ترتیب صفحات و محتوا دارند و نیاز به ویرایش‌های دستی زمان‌بر را از بین می‌برند و دقت در خروجی نهایی را تضمین می‌کنند.

نمونه مورد و پیاده‌سازی کد

بیایید نشان دهیم که چگونه از ویژگی Page Builder در GroupDocs.Merger با یک مثال عملی استفاده کنیم. برای ساده‌سازی این مورد فرض کنید که ما دو سند داریم:

Document A with 4 pages.
Document B with 4 pages.

ما هدف داریم که یک سند جدید با ادغام صفحات از این دو سند در توالی‌های مختلف بر اساس سناریوهای خاص ایجاد کنیم.

Page Builder - ساختار سند نمونه A و B با ۴ صفحه برای هر یک

در اینجا هر صفحه سند را با حرف سند 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 ازNotation پایه صفر برای مدارک منبع و شماره‌های صفحه استفاده می‌کنند.
از روش ApplyPageBuilder برای اعمال ترتیب مشخص شده صفحات به سند ادغام شده استفاده کنید.
Save the resulting document by calling the Save method and providing a file path.

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);
}

نتیجه گیری

این مثال‌ها تنوع ویژگی Page Builder را نشان می‌دهند. توسعه‌دهندگان می‌توانند به راحتی صفحات را از چندین سند در توالی‌های مختلف ترکیب کنند تا خروجی‌های سفارشی ایجاد کنند. این ویژگی به‌طور چشمگیری کارهای دستی را کاهش می‌دهد و دقت در تولید مستندات را تضمین می‌کند و آن را به ابزاری ضروری برای موارد استفاده متنوع تبدیل می‌کند.

یک مجوز API رایگان دریافت کنید

شما می‌توانید یک مجوز موقت رایگان بگیرید تا از API بدون محدودیت‌های ارزیابی استفاده کنید.

ساخت اپلیکیشن ساز صفحه ادغام خودتان

اینجا چند لینک مهم وجود دارد که به شما در ساخت برنامه مقایسه مستندات خودتان کمک می کند.

Documentation | API Reference | Supported File Formats

Running Examples – GitHub | Free Support Forum | Release Notes

همچنین ببینید

برای اطلاعات بیشتر و منابع اضافی، ممکن است لینک‌های زیر برای شما مفید باشند:

درک صفحه ساز#

نمونه مورد و پیاده‌سازی کد#

مشخص کردن دامنه صفحات مورد نیاز#

نتیجه گیری#

یک مجوز API رایگان دریافت کنید#

ساخت اپلیکیشن ساز صفحه ادغام خودتان#

همچنین ببینید#