Pdf مع Node.js عبر C++

تحويل سجل عمل Excel إلى PDF

تستخدم ملفات PDF على نطاق واسع لتبادل المستندات بين المؤسسات والقطاعات الحكومية والأفراد. إنها صيغة مستند قياسية وغالبًا ما يُطلب من مطوري البرامج أن يجدوا طريقة لتحويل ملفات Microsoft Excel إلى مستندات PDF.

تدعم Aspose.Cells تحويل ملفات Excel إلى PDF وتحافظ على دقة الرؤية العالية في التحويل.

التحويل المباشر

يدعم Aspose.Cells for Node.js via C++ التحويل من جداول البيانات إلى PDF بشكل مستقل عن البرامج الأخرى. ببساطة، احفظ ملف Excel كملف PDF باستخدام طريقة save(string, SaveFormat) من فئة Workbook. توفر طريقة save(string, SaveFormat) عضو التعداد SaveFormat.Pdf الذي يحول ملفات Excel الأصلية إلى صيغة PDF.

اتبع الخطوات التالية لتحويل الجداول الحسابية في Excel مباشرة إلى تنسيق PDF:

  1. قم بإنشاء كائن من فئة Workbook بالاتصال ببنائه الفارغ.
  2. يمكنك فتح/تحميل ملف قالب موجود أو تخطي هذه الخطوة إذا كنت تقوم بإنشاء السجل العمل من البداية.
  3. أدخل أي عمل (البيانات الدخلية، تطبيق التنسيق، ضبط الصيغ، إدراج الصور أو كائنات الرسم الأخرى، وما إلى ذلك) على ورق العمل باستخدام واجهات برمجة التطبيقات Aspose.Cells.
  4. عندما يكتمل كود الجدول، استدعِ طريقة save(string, SaveFormat) من فئة Workbook لحفظ الجدول.

يجب أن يكون تنسيق الملف PDF، لذا حدد Pdf (قيمة محددة مسبقًا) من تعداد SaveFormat لتوليد مستند PDF النهائي.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "Book1.xls");

// Instantiate the Workbook object
// Open an Excel file
const workbook = new AsposeCells.Workbook(filePath);

// Save the document in PDF format
workbook.save(path.join(dataDir, "output.pdf"), AsposeCells.SaveFormat.Pdf);

التحويل المتقدم

يمكنك أيضًا استخدام الفصيلة PdfSaveOptions لتعيين خصائص مختلفة للتحويل. تعيين خصائص مختلفة للفصيلة PdfSaveOptions يمنحك السيطرة على إعدادات الطباعة، الخط، الأمان، والضغط لمخرج PDF.

أهم خاصية هي getCompliance() التي تمكّنك من تعيين مستوى الامتثال لمعايير PDF. حاليًا، يمكنك حفظ إلى صيغ PDF 1.4، PDF 1.5، PDF 1.6، PDF 1.7، PDF/A-1a، PDF/A-1b، PDF/A-2a، PDF/A-2b، PDF/A-2u، PDF/A-3a، PDF/A-2ab، وصيغ PDF/A-3u. يرجى ملاحظة أنه مع صيغة PDF/A، يكون حجم الملف الناتج أكبر من حجم ملف PDF عادي.

حفظ جدول البيانات إلى ملف PDF/A المتوافق

مقطع الرمز المقدم أدناه يوضح كيفية استخدام فئة PdfSaveOptions لحفظ ملفات Excel إلى تنسيق PDF/A متوافق مع PDF.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Instantiate new workbook
const workbook = new AsposeCells.Workbook();

// Insert a value into the A1 cell in the first worksheet
workbook.getWorksheets().get(0).getCells().get(0, 0).putValue("Testing PDF/A");

// Define PdfSaveOptions
const pdfSaveOptions = new AsposeCells.PdfSaveOptions();

// Set the compliance type
pdfSaveOptions.setCompliance(AsposeCells.PdfCompliance.PdfA1b);

// Save the file
workbook.save(path.join(dataDir, "output.pdf"), pdfSaveOptions);

تعيين وقت إنشاء ملف PDF

مع فئة PdfSaveOptions، يمكنك الحصول على أو تعيين وقت إنشاء PDF. يوضح الرمز التالي استخدام الخاصية PdfSaveOptions.getCreatedTime() لتعيين وقت إنشاء ملف PDF.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const inputPath = path.join(dataDir, "Book1.xlsx");
// Load excel file containing charts
const workbook = new AsposeCells.Workbook(inputPath);

// Create an instance of PdfSaveOptions
const options = new AsposeCells.PdfSaveOptions();
options.setCreatedTime(new Date());

// Save the workbook to PDF format while passing the object of PdfSaveOptions
workbook.save(path.join(dataDir, "output.pdf"), options);

تعيين خيار ContentCopyForAccessibility

مع فئة PdfSaveOptions، يمكنك الحصول على أو تعيين خيار getAccessibilityExtractContent() للتحكم في وصول المحتوى في ملف PDF المحول.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// Source directory
const sourceDir = path.join(__dirname, "data");

// Output directory
const outputDir = path.join(__dirname, "output");

const inputPath = path.join(sourceDir, "BookWithSomeData.xlsx");

// Load excel file containing some data
const workbook = new AsposeCells.Workbook(inputPath);

// Create an instance of PdfSaveOptions and pass SaveFormat to the constructor
const pdfSaveOpt = new AsposeCells.PdfSaveOptions();

// Create an instance of PdfSecurityOptions
const securityOptions = new AsposeCells.PdfSecurityOptions();

// Set AccessibilityExtractContent to true
securityOptions.setAccessibilityExtractContent(false);

// Set the security option in the PdfSaveOptions
pdfSaveOpt.setSecurityOptions(securityOptions);

// Save the workbook to PDF format while passing the object of PdfSaveOptions
workbook.save(path.join(outputDir, "outFile.pdf"), pdfSaveOpt);

تصدير الخصائص المخصصة إلى ملف PDF

مع فئة PdfSaveOptions، يمكنك تصدير الخصائص المخصصة في دفتر العمل المصدر إلى PDF. وتوفر مُعدّلة PdfCustomPropertiesExport لتحديد الطريقة التي يتم بها تصدير الخصائص. يمكن ملاحظة هذه الخصائص في Adobe Acrobat Reader بالنقر فوق ملف ثم الخصائص كما هو موضح في الصورة التالية. يمكن تنزيل ملف القالب “sourceWithCustProps.xlsx” من هنا للفحص وملف PDF الناتج “outSourceWithCustProps” متاح هنا للتحليل.

todo:image_alt_text

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "sourceWithCustProps.xlsx");

// Load excel file containing custom properties
const workbook = new AsposeCells.Workbook(filePath);

// Create an instance of PdfSaveOptions
const pdfSaveOptions = new AsposeCells.PdfSaveOptions();

// Set CustomPropertiesExport property to PdfCustomPropertiesExport.Standard
pdfSaveOptions.setCustomPropertiesExport(AsposeCells.PdfCustomPropertiesExport.Standard);

// Save the workbook to PDF format while passing the object of PdfSaveOptions
workbook.save("outSourceWithCustProps.pdf", pdfSaveOptions);

سمات التحويل

نحن نعمل على تعزيز ميزات التحويل مع كل إصدار جديد. لا تزال عملية تحويل Excel إلى PDF من Aspose.Cells تحتوي على بعض القيود. لا يتم دعم MapChart عند التحويل إلى تنسيق PDF. أيضًا، بعض الكائنات الرسومية لا تتمتع بدعم جيد.

الجدول التالي يقوم بسرد جميع الميزات المدعومة جزئيًا أو بالكامل عند التصدير إلى PDF باستخدام Aspose.Cells. هذا الجدول ليس نهائيًا ولا يغطي جميع خصائص جدول البيانات ولكنه يحدد تلك الميزات التي لا تتم دعمها أو يتم دعمها جزئيًا للتحويل إلى PDF.

عنصر المستند السمة مدعوم ملاحظات
المحاذاة   نعم  
إعدادات الخلفية   نعم  
الحدود لون نعم  
الحدود نمط الخط نعم  
الحدود سمك الخط نعم  
بيانات الخلية   نعم  
التعليقات   نعم  
تنسيق شرطي   نعم  
خصائص المستند   نعم  
كائنات الرسم   جزئيا لا يتم دعم الظل والتأثيرات ثلاثية الأبعاد لكائنات الرسم بشكل جيد؛ WordArt و SmartArt يتم دعمهما جزئيا.
الخط الحجم نعم  
الخط اللون نعم  
الخط النمط نعم  
الخط التسطير نعم  
الخط التأثيرات نعم
الصور   نعم  
الارتباط   نعم  
الرسوم البيانية   جزئيا لم يتم دعم MapChart.
الخلايا المدمجة   نعم  
فاصل الصفحة   نعم  
إعداد الصفحة الرأس/التذييل نعم  
إعداد الصفحة الهوامش نعم  
إعداد الصفحة اتجاه الصفحة نعم  
إعداد الصفحة حجم الصفحة نعم  
إعداد الصفحة منطقة الطباعة نعم  
إعداد الصفحة عناوين الطباعة نعم  
إعداد الصفحة تحجيم نعم  
ارتفاع الصف/عرض العمود   نعم  
لغة من اليمين إلى اليسار   نعم  

مواضيع متقدمة

تحويل Excel إلى CSV و TSV و Txt مع Node.js عبر C++ HTML مع Node.js عبر C++