با استفاده از Node.js صفحات گسترده اکسل را به PDF تبدیل کنید

صفحات گسترده اکسل به طور گسترده ای برای نگهداری فاکتورها، دفتر کل، موجودی، حساب ها و سایر گزارش ها استفاده می شود. تبدیل اکسل به PDF امکان به اشتراک گذاری داده های اکسل را با دیگران به صورت قابل حمل می دهد. به عنوان یک توسعه دهنده Node.js، می توانید به راحتی صفحات گسترده اکسل خود را به صورت برنامه نویسی در فضای ابری به اسناد PDF تبدیل کنید. در این مقاله نحوه تبدیل صفحات گسترده Excel به PDF با استفاده از Node.js را یاد خواهید گرفت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

Excel به PDF تبدیل REST API و Node.js SDK

برای تبدیل XLSX به PDF، از Node.js SDK of GroupDocs.Conversion Cloud API استفاده خواهم کرد. API به شما امکان می دهد اسناد خود را به هر فرمتی که نیاز دارید تبدیل کنید. این برنامه از تبدیل بیش از 50 نوع سند و تصویر مانند Word، Excel، PowerPoint، PDF، HTML، JPG، PNG، CAD پشتیبانی می کند. همچنین دات نت، جاوا، پی اچ پی، روبی، اندروید و پایتون SDK را به عنوان [اعضای خانواده تبدیل سند4 برای Cloud API ارائه می کند.

می‌توانید GroupDocs.Conversion Cloud را در برنامه Node.js خود با استفاده از دستور زیر در کنسول نصب کنید:

npm install groupdocs-conversion-cloud

لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";

const config = new groupdocs_conversion_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";

اکسل را با استفاده از REST API در Node.js به PDF تبدیل کنید

با دنبال کردن مراحل ساده زیر می توانید صفحات گسترده اکسل را به اسناد PDF در فضای ابری تبدیل کنید:

  1. آپلود فایل XLSX را در Cloud
  2. تبدیل اکسل به PDF با استفاده از Node.js
  3. دانلود فایل PDF تبدیل شده

فایل اکسل را آپلود کنید

ابتدا فایل XLSX را با استفاده از نمونه کد زیر در فضای ابری آپلود کنید:

// باز کردن فایل در IOStream از لوکال/دیسک.
var resourcesFolder = 'C:\\Files\\sample.xlsx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // FileApi را بسازید
  var fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);
  // ایجاد درخواست آپلود فایل
  var request = new groupdocs_conversion_cloud.UploadFileRequest("sample.xlsx", fileStream, myStorage);
  // آپلود فایل
  fileApi.uploadFile(request);
});

در نتیجه، فایل XLSX آپلود شده در بخش فایل ها داشبورد شما در فضای ابری در دسترس خواهد بود.

اکسل را با استفاده از Node.js به PDF تبدیل کنید

با دنبال کردن مراحل ذکر شده در زیر می توانید به راحتی XLSX را به سند PDF به صورت برنامه نویسی تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل XLSX را تنظیم کنید
  • “pdf” را به فرمت اختصاص دهید
  • مسیر فایل خروجی را ارائه دهید
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد ConvertApi.convertDocument() با ConvertDocumentRequest تبدیل کنید

مثال کد زیر نحوه تبدیل صفحه گسترده اکسل به سند PDF را با استفاده از REST API در Node.js نشان می دهد.

// api را مقداردهی اولیه کنید
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// تنظیمات تبدیل را تعریف کنید
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.xlsx";  // input file path
settings.format = "pdf";            // convert format
settings.outputPath = "output";     // output file folder on the cloud storage

// ایجاد درخواست تبدیل سند 
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// تبدیل سند
let result = await convertApi.convertDocument(request);
// نشان دادن مسیر فایل تبدیل شده
console.log("Document converted successfully: " + result[0].url);
اکسل را با استفاده از REST API در Node.js به PDF تبدیل کنید

اکسل را با استفاده از REST API در Node.js به PDF تبدیل کنید

فایل تبدیل شده را دانلود کنید

نمونه کد بالا فایل PDF تبدیل شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:

// FileApi را بسازید
var fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);

// ایجاد درخواست دانلود فایل
let request = new groupdocs_conversion_cloud.DownloadFileRequest("output/sample.pdf", myStorage);

// دریافت فایل
let response = await fileApi.downloadFile(request);

// فایل را در پوشه کاری کپی کنید
fs.writeFile("C:\\Files\\converted.pdf", response, "binary", function (err) { });
console.log(response);

صفحات گسترده اکسل خاص را در Node.js به PDF تبدیل کنید

شما می توانید با دنبال کردن مراحل ذکر شده در زیر، صفحات گسترده اکسل خاص را به صورت برنامه نویسی به اسناد PDF تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل XLSX را تنظیم کنید
  • “pdf” را به فرمت اختصاص دهید
  • ارائه مسیر فایل خروجی
  • یک نمونه از PdfConvertOptions ایجاد کنید
  • صفحات گسترده خاصی را برای تبدیل ارائه دهید
  • PdfConvertOptions را تنظیم کنید
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد ConvertApi.convertDocument() با ConvertDocumentRequest تبدیل کنید

مثال کد زیر نحوه تبدیل یک صفحه گسترده اکسل خاص به سند PDF را با استفاده از REST API در Node.js نشان می دهد.

// api را مقداردهی اولیه کنید
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// تنظیمات تبدیل را تعریف کنید
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.xlsx";
settings.format = "pdf";

// گزینه های تبدیل PDF را تعریف کنید
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.pages = [1];  // define pages (sheets) to convert

settings.convertOptions = convertOptions
settings.outputPath = "specific_pages.pdf";

// ایجاد درخواست تبدیل سند
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// تبدیل سند
let result = await convertApi.convertDocument(request);
console.log("Document converted successfully: " + result[0].url);
صفحات گسترده اکسل خاص را در Node.js به PDF تبدیل کنید

صفحات گسترده اکسل خاص را در Node.js به PDF تبدیل کنید

تبدیل Excel به PDF با گزینه های پیشرفته

لطفاً مراحل ذکر شده در زیر را برای تبدیل XLSX به سند PDF با برخی تنظیمات پیشرفته دنبال کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل XLSX را تنظیم کنید
  • “pdf” را به فرمت اختصاص دهید
  • ارائه مسیر فایل خروجی
  • یک نمونه از SpreadsheetLoadOptions ایجاد کنید
  • گزینه های بارگذاری مختلف مانند hideComments، onePagePerSheet و غیره را تنظیم کنید.
  • یک نمونه از PdfConvertOptions ایجاد کنید
  • گزینه های مختلف تبدیل مانند displayDocTitle، fromPage، pagesCount، حاشیه ها (بالا، چپ، راست، پایین) و غیره را تنظیم کنید.
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد ConvertApi.convertDocument() با ConvertDocumentRequest تبدیل کنید

مثال کد زیر نحوه تبدیل صفحه گسترده اکسل به سند PDF را با گزینه های تبدیل پیشرفته نشان می دهد.

// api را مقداردهی اولیه کنید
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// تنظیمات تبدیل را تعریف کنید
var settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.storageName = myStorage;
settings.filePath = "sample.xlsx";
settings.format = "pdf";

// تعریف گزینه های بارگذاری صفحه گسترده
var loadOptions = new groupdocs_conversion_cloud.SpreadsheetLoadOptions();
loadOptions.hideComments = true;		  // hide comments	
loadOptions.onePagePerSheet = true;		// set one page per sheet

settings.loadOptions = loadOptions;

// گزینه های تبدیل PDF را تعریف کنید
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.centerWindow = true;		  // set position of the document's window. Default: false.
convertOptions.displayDocTitle = true;	// display document title. Default: false
convertOptions.fromPage = 2;			      // Start conversion from
convertOptions.pagesCount = 3;			    // Number of pages(sheets) to convert
convertOptions.marginTop = 5;			      // top margin
convertOptions.marginLeft = 5;			    // left margin

settings.convertOptions = convertOptions;
settings.outputPath = "converted.pdf";

// ایجاد درخواست تبدیل سند
var request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// سند ایجاد کنید
convertApi.convertDocument(request)
با استفاده از Node.js صفحات گسترده اکسل را به PDF تبدیل کنید

تبدیل Excel به PDF با گزینه های پیشرفته

اکسل را بدون استفاده از فضای ذخیره سازی ابری به PDF تبدیل کنید

با دنبال کردن مراحل ذکر شده در زیر، می توانید صفحات گسترده اکسل را بدون استفاده از فضای ذخیره سازی ابری به اسناد PDF تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • فایل ورودی XLSX را از مسیر محلی بخوانید
  • ConvertDocumentDirectRequest را ایجاد کنید
  • فرمت هدف و مسیر فایل ورودی را به عنوان پارامترهای ورودی ارائه دهید
  • با فراخوانی متد convertDocumentDirect() با ConvertDocumentDirectRequest نتیجه بگیرید
  • فایل خروجی را با استفاده از روش FileStream.writeFile() در مسیر محلی ذخیره کنید

مثال کد زیر نحوه تبدیل صفحه گسترده اکسل را به سند PDF بدون استفاده از فضای ذخیره سازی ابری نشان می دهد. یعنی فایل ورودی را در بدنه درخواست ارسال می‌کنید و فایل خروجی را در پاسخ API دریافت می‌کنید.

// api را مقداردهی اولیه کنید
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// خواندن فایل از مسیر محلی
let file = fs.readFileSync('C:\\Files\\sample.xlsx');

// درخواست مستقیم سند تبدیل را ایجاد کنید
let request = new groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", file);

// تبدیل سند
let result = await convertApi.convertDocumentDirect(request);

// فایل خروجی را در مسیر مشخص ذخیره کنید
fs.writeFile("C:\\Files\\sample_direct.pdf", result, "binary", function (err) { });
console.log("Document converted: " + result.length);

اکسل را به PDF تبدیل کنید و واترمارک را اضافه کنید

با دنبال کردن مراحل ذکر شده در زیر می توانید صفحات گسترده اکسل را به اسناد PDF دارای واترمارک تبدیل کنید:

  • یک نمونه از ConvertApi ایجاد کنید
  • یک نمونه از ConvertSettings ایجاد کنید
  • مسیر فایل XLSX را تنظیم کنید
  • “pdf” را به فرمت اختصاص دهید
  • ارائه مسیر فایل خروجی
  • یک نمونه از WatermarkOptions ایجاد کنید
  • متن واترمارک، رنگ، عرض، ارتفاع و غیره را تنظیم کنید.
  • PdfConvertOptions را تعریف کرده و WatermarkOptions را اختصاص دهید
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید
  • با فراخوانی متد ConvertApi.convertDocument() با ConvertDocumentRequest تبدیل کنید

مثال کد زیر نحوه تبدیل صفحه گسترده اکسل را به سند PDF و افزودن واترمارک به سند PDF تبدیل شده با استفاده از REST API در Node.js نشان می دهد.

// api را مقداردهی اولیه کنید
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// تنظیمات تبدیل را تعریف کنید
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.xlsx";
settings.format = "pdf";
settings.outputPath = "converted";

// گزینه های واترمارک را تعریف کنید
let watermark = new groupdocs_conversion_cloud.WatermarkOptions();
watermark.text = "CONFIDENTIAL";
watermark.bold = true;
watermark.fontSize = 44;
watermark.color = "Gray";
watermark.background = false;
watermark.rotationAngle = 30;
watermark.left = 100;
watermark.top = 250;

// گزینه های تبدیل PDF را تعریف کنید
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.watermarkOptions = watermark;

// اختصاص گزینه های تبدیل
settings.convertOptions = convertOptions

// ایجاد درخواست تبدیل سند
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// تبدیل سند
let result = await convertApi.convertDocument(request);
// نشان دادن مسیر سند خروجی
console.log("Document converted successfully: " + result[0].url);
تبدیل Excel به PDF و اضافه کردن واترمارک

اکسل را به PDF تبدیل کنید و واترمارک را اضافه کنید

آنلاین را امتحان کنید

لطفاً ابزار آنلاین رایگان تبدیل XLSX به PDF زیر را که با استفاده از API فوق توسعه یافته است، امتحان کنید. https://products.groupdocs.app/conversion/xlsx-to-pdf

نتیجه

در این مقاله با نحوه تبدیل اسناد اکسل به PDF در فضای ابری آشنا شده اید. شما همچنین یاد گرفته اید که چگونه با استفاده از Node.js یک واترمارک به سند PDF تبدیل شده اضافه کنید. علاوه بر این، شما یاد گرفته اید که چگونه صفحات گسترده اکسل را بدون استفاده از فضای ذخیره سازی ابری به اسناد PDF تبدیل کنید. علاوه بر این، یاد گرفته‌اید که چگونه فایل XLSX را به صورت برنامه‌نویسی روی ابر آپلود کنید و سپس فایل تبدیل شده را از ابر دانلود کنید. می توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.

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