مرور کلی

ادغام فایل‌های PDF یک نیاز رایج برای توسعه‌دهندگانی است که با پردازش اسناد کار می‌کنند. در این پست وبلاگ، نحوه ادغام چندین فایل PDF در یک سند واحد را با استفاده از GroupDocs.Merger for Node.js via Java بررسی می‌کنیم. این کتابخانه به شما امکان می‌دهد فایل‌های PDF را به‌صورت برنامه‌نویسی ترکیب کنید بدون نیاز به نرم‌افزارهای شخص ثالث، که جریان کار شما را ساده‌تر و بهره‌وری را افزایش می‌دهد.

در راهنمای گام‌به‌گام ما، خواهید آموخت که چگونه:

  • کلاس ادغام‌کننده را با یک فایل PDF منبع مقداردهی اولیه کنید.
  • فایل‌های PDF اضافی را به ادغام‌کننده اضافه کنید.
  • فایل PDF ترکیبی را ذخیره کنید.

نحوه ادغام فایل‌های PDF در Node.js

برای ادغام فایل‌های PDF در Node.js، ابتدا باید کلاس Merger را با مسیر فایل PDF منبع ایجاد کنید. پس از آن می‌توانید فایل‌های PDF دیگری که می‌خواهید در سند ترکیبی گنجانده شوند، اضافه کنید و در نهایت فایل PDF حاصل را ذخیره کنید.

مراحل ادغام فایل‌های PDF:

  1. بارگذاری فایل PDF منبع – یک نمونه از کلاس Merger را با مسیر اولین PDF ایجاد کنید.
  2. اضافه کردن فایل‌های PDF دیگر – از متد join برای گنجاندن فایل‌های PDF اضافی در ادغام‌کننده استفاده کنید.
  3. ذخیره فایل PDF حاصل – با فراخوانی متد save، سند نهایی ترکیبی را در مکان دلخواه خود خروجی بگیرید.

در ادامه یک قطعه کد نمونه برای نشان دادن این مراحل آورده شده است:

// Import the GroupDocs.Merger for Node.js library
const GroupDocs = require("groupdocs-merger");

// Function to merge PDF files
async function mergePdf(groupdocs, inputFilePath) {
    // Create a new Merger instance with the source PDF file
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // Define the output file path for the merged PDF
    const outputPath = `${groupdocs.outputFolder}/MergePdf.pdf`;
    
    console.log(`Merged to ${outputPath}`);
    
    // Add another PDF file to merge
    merger.join("path/to/your/secondPDF.pdf");
    
    // Save the merged PDF to the specified output path
    await merger.save(outputPath);
}

// Example usage
mergePdf(GroupDocs, "path/to/your/firstPDF.pdf");

مثال کد برای ادغام PDFها

در مثال کد ارائه‌شده در بالا، مراحل اصلی زیر انجام می‌شود:

  • وارد کردن کتابخانه مورد نیاز: این گام اطمینان می‌دهد که GroupDocs.Merger در برنامه شما در دسترس است.
  • ایجاد نمونه‌ای از کلاس Merger: مسیر فایل PDF اول به سازنده Merger پاس داده می‌شود تا فرآیند ادغام آغاز شود.
  • ادغام PDFهای اضافی: هر فایل PDF اضافه با استفاده از متد join به هم می‌پیوندد. این متد به شما امکان می‌دهد چندین سند PDF را در یک فایل ترکیب کنید.
  • ذخیره سند نهایی: با فراخوانی متد save، PDF ترکیبی جدید بر روی دیسک ذخیره می‌شود.

استفاده از نشانک‌ها (bookmarks) هنگام ادغام PDFها

اگر می‌خواهید نشانک‌ها در PDF ترکیبی حفظ شوند، می‌توانید فرآیند ادغام را طوری پیکربندی کنید که این ویژگی را شامل شود.

مثال زیر نشان می‌دهد چگونه می‌توانید فایل‌های PDF را در حالی که نشانک‌ها را نگه می‌دارید، ادغام کنید:

// Import the GroupDocs.Merger for Node.js library
const GroupDocs = require("groupdocs-merger");

// Function to merge PDFs with bookmarks
async function mergePdfWithBookmarks(groupdocs, inputFilePath) {
    // Create a new Merger instance
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // Define output file path
    const outputPath = `${groupdocs.outputFolder}/MergePdfWithBookmarks.pdf`;
    
    // Create options to use bookmarks
    const pdfJoinOptions = {
        useBookmarks: true // Enable bookmarks
    };

    console.log(`Merged to ${outputPath}`);
    
    // Add second PDF with bookmarks
    merger.join("path/to/your/secondPDF.pdf", pdfJoinOptions);
    
    // Save the merged PDF to the specified output path
    await merger.save(outputPath);
}

// Example usage
mergePdfWithBookmarks(GroupDocs, "path/to/your/firstPDF.pdf");

در این مثال به‌روز شده، گزینه‌ای برای حفظ نشانک‌ها هنگام ادغام PDFها مشخص می‌کنیم. افزودن useBookmarks: true اطمینان می‌دهد که نشانک‌های موجود در فایل‌های اصلی در سند ترکیبی حفظ می‌شوند.

نتیجه‌گیری

ادغام فایل‌های PDF در Node.js با استفاده از GroupDocs.Merger for Node.js via Java فرآیندی ساده است که می‌تواند به‌طور قابل‌توجهی کارهای مدیریت اسناد شما را بهینه‌سازی کند. چه برای ترکیب اسناد مختلف جهت گزارش‌گیری و چه برای ارسال چندین فایل به‌صورت یک پیوست، این کتابخانه ابزارهای لازم برای انجام این کارها به‌صورت برنامه‌نویسی را بدون نیاز به نرم‌افزارهای شخص ثالث فراهم می‌کند.

مطالب مرتبط

فراموش نکنید که می‌توانید یک نسخه آزمایشی رایگان را از releases.groupdocs.com دانلود کنید و یک لایسنس موقت را از اینجا دریافت کنید. یک لایسنس موقت به شما اجازه می‌دهد کتابخانه ما را بدون هیچ محدودیتی امتحان کنید.

مثال‌ها

برای تسهیل درک شما از ادغام فایل‌های PDF با استفاده از GroupDocs.Merger for Node.js via Java، در اینجا چند مثال عملی آورده شده است که قابلیت‌های کتابخانه را در عمل نشان می‌دهند.

مثال پایه‌ای ادغام PDF

در این مثال، دو فایل PDF ساده را در یک فایل ترکیب می‌کنیم.

// Import the GroupDocs.Merger for Node.js library
const GroupDocs = require("groupdocs-merger");

// Function to merge two PDF files
async function mergeTwoPdfFiles(groupdocs) {
    // Define paths for the source PDF files
    const firstPdfPath = "path/to/your/firstPDF.pdf";
    const secondPdfPath = "path/to/your/secondPDF.pdf";
    
    // Create a new Merger instance for the first PDF
    const merger = new groupdocs.merger.Merger(firstPdfPath);
    
    // Merge the second PDF into the first one
    merger.join(secondPdfPath);
    
    // Define the output path for the merged PDF
    const outputPath = `${groupdocs.outputFolder}/MergedTwoPdfFiles.pdf`;
    
    // Save the result into the specified output path
    await merger.save(outputPath);
    console.log(`Merged files saved to: ${outputPath}`);
}

// Example usage
mergeTwoPdfFiles(GroupDocs);

مثال ادغام با چندین فایل

در این سناریو، سه فایل PDF را در یک سند واحد ترکیب می‌کنیم.

// Import the GroupDocs.Merger for Node.js library
const GroupDocs = require("groupdocs-merger");

// Function to merge multiple PDF files
async function mergeMultiplePdfFiles(groupdocs) {
    // Define paths for the source PDF files
    const pdfPaths = [
        "path/to/your/firstPDF.pdf",
        "path/to/your/secondPDF.pdf",
        "path/to/your/thirdPDF.pdf"
    ];
    
    // Create a new Merger instance with the first PDF
    const merger = new groupdocs.merger.Merger(pdfPaths[0]);
    
    // Loop through and merge all additional PDFs
    for (let i = 1; i < pdfPaths.length; i++) {
        await merger.join(pdfPaths[i]);
    }
    
    // Define the output path for the merged PDF
    const outputPath = `${groupdocs.outputFolder}/MergedMultiplePdfFiles.pdf`;
    
    // Save the result into the specified output path
    await merger.save(outputPath);
    console.log(`Merged multiple files saved to: ${outputPath}`);
}

// Example usage
mergeMultiplePdfFiles(GroupDocs);

این مثال‌ها نشان می‌دهند چگونه می‌توانید به‌صورت کارآمد یک یا چند سند PDF را با استفاده از GroupDocs.Merger for Node.js via Java ترکیب کنید. انعطاف‌پذیری این کتابخانه به توسعه‌دهندگان اجازه می‌دهد فرآیند ادغام را بر اساس نیازهای خاص خود سفارشی کنند.

مطالب مرتبط

اطلاعات دانلود نسخه آزمایشی رایگان و لایسنس موقت

می‌توانید با دانلود یک نسخه آزمایشی رایگان از GroupDocs.Merger for Node.js via Java از releases.groupdocs.com شروع کنید. نسخه آزمایشی به شما امکان می‌دهد ویژگی‌های کتابخانه را بدون محدودیت بررسی کنید.

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