Pdf con Node.js via C++

Conversione di un Workbook Excel in PDF

I file PDF sono ampiamente utilizzati per lo scambio di documenti tra organizzazioni, settori governativi e individui. È un formato di documento standard e spesso agli sviluppatori software viene chiesto di trovare un modo per convertire i file Microsoft Excel in documenti PDF.

Aspose.Cells supporta la conversione di file Excel in PDF e mantiene un’elevata fedeltà visiva nella conversione.

Conversione Diretta

Aspose.Cells for Node.js via C++ supporta la conversione di fogli di calcolo in PDF indipendentemente da altri software. Basta salvare un file Excel come PDF usando il metodo save(string, SaveFormat) della classe Workbook. Il metodo save(string, SaveFormat) fornisce il membro di enumerazione SaveFormat.Pdf che converte i file Excel nativi in formato PDF.

Seguire i seguenti passi per convertire direttamente i fogli di calcolo Excel in formato PDF:

  1. Istituire un oggetto della classe Workbook chiamando il suo costruttore vuoto.
  2. È possibile aprire/caricare un file di modello esistente o saltare questo passo se si sta creando il workbook da zero.
  3. Eseguire qualsiasi lavoro (inserire dati, applicare formattazione, inserire formule, inserire immagini o altri oggetti grafici, ecc.) sul foglio di calcolo utilizzando le API di Aspose.Cells.
  4. Quando il codice del foglio di calcolo è completo, chiama il metodo save(string, SaveFormat) della classe Workbook per salvare il foglio di calcolo.

Il formato del file dovrebbe essere PDF, quindi selezionare Pdf (un valore predefinito) dall’enumerazione SaveFormat per generare il documento PDF finale.

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

Conversione Avanzata

È anche possibile optare per utilizzare la classe PdfSaveOptions per impostare attributi diversi per la conversione. Impostare diverse proprietà della classe PdfSaveOptions consente di esercitare il controllo sulle impostazioni di stampa, carattere, sicurezza e compressione per l’output in PDF.

La proprietà più importante è getCompliance() che consente di impostare il livello di conformità agli standard PDF. Attualmente è possibile salvare in formati 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 e PDF/A-3u. Si noti che con il formato PDF/A, le dimensioni del file di output sono più grandi rispetto a un normale file PDF.

Salvataggio del foglio di lavoro in file PDF/A compilati

Il frammento di codice fornito di seguito dimostra come utilizzare la classe PdfSaveOptions per salvare i file Excel in formato PDF/A conforme.

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

Imposta l’ora di creazione del PDF

Con la classe PdfSaveOptions, è possibile ottenere o impostare l’ora di creazione del PDF. Il codice seguente dimostra l’uso della proprietà PdfSaveOptions.getCreatedTime() per impostare l’ora di creazione del file 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);

Imposta l’opzione ContentCopyForAccessibility

Con la classe PdfSaveOptions, è possibile ottenere o impostare l’opzione getAccessibilityExtractContent() del PDF per controllare l’accesso ai contenuti nel PDF convertito.

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

Esporta le proprietà personalizzate in PDF

Con la classe PdfSaveOptions, è possibile esportare le proprietà personalizzate nel foglio di lavoro di origine nel PDF. L’enumeratore PdfCustomPropertiesExport è fornito per specificare il modo in cui vengono esportate le proprietà. Queste proprietà possono essere visualizzate in Adobe Acrobat Reader facendo clic su File e poi sull’opzione proprietà come mostrato nell’immagine seguente. Il file modello “sourceWithCustProps.xlsx” può essere scaricato qui per testare, e il file PDF di output “outSourceWithCustProps” è disponibile qui per l’analisi.

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

Attributi di Conversione

Lavoriamo per migliorare le funzionalità di conversione con ogni nuova versione. La conversione da Excel a PDF di Aspose.Cell ha ancora un paio di limitazioni. MapChart non è supportato quando si converte in formato PDF. Inoltre, alcuni oggetti grafici non sono ben supportati.

La tabella che segue elenca tutte le caratteristiche che sono completamente o parzialmente supportate durante l’esportazione in PDF utilizzando Aspose.Cells. Questa tabella non è definitiva e non copre tutti gli attributi del foglio di calcolo, ma identifica le funzionalità non supportate o parzialmente supportate per la conversione in PDF.

Elemento del Documento Attributo Supportato Note
Allineamento Sì
Impostazioni sfondo Sì
Bordo Colore Sì
Bordo Stile di linea Sì
Bordo Spessore linea Sì
Dati della cella Sì
Commenti Sì
Formattazione condizionale Sì
Proprietà del documento Sì
Oggetti disegno Parzialmente Effetti ombra e 3-D per gli oggetti di disegno non sono ben supportati; WordArt e SmartArt sono supportati parzialmente.
Carattere Dimensione Sì
Carattere Colore Sì
Carattere Stile Sì
Carattere Sottolineato Sì
Carattere Effetti Sì
Immagini Sì
Collegamento ipertestuale Sì
Grafici Parzialmente MapChart non è supportato.
Celle unite Sì
Interruzione di pagina Sì
Impostazioni pagina Intestazione/Piè di pagina Sì
Impostazioni pagina Margini Sì
Impostazioni pagina Orientamento pagina Sì
Impostazioni pagina Formato pagina Sì
Impostazioni pagina Area di stampa Sì
Impostazioni pagina Titoli di stampa Sì
Impostazioni pagina Scalatura Sì
Altezza riga/Larghezza colonna   Sì  
Lingua RTL (da destra a sinistra)   Sì  

Argomenti avanzati

Converti Excel in CSV, TSV e Txt con Node.js tramite C++ HTML con Node.js via C++