Converter planilhas do Excel em PDF usando Node.js

As planilhas do Excel são amplamente usadas para manter faturas, livros contábeis, estoque, contas e outros relatórios. A conversão de Excel para PDF permite compartilhar dados do Excel com outras pessoas de forma portátil. Como desenvolvedor Node.js, você pode facilmente converter suas planilhas do Excel em documentos PDF programaticamente na nuvem. Neste artigo, você aprenderá como converter planilhas do Excel em PDF usando o Node.js.

Os seguintes tópicos serão abordados neste artigo:

API REST de conversão de Excel para PDF e SDK Node.js

Para converter XLSX em PDF, usarei a API Node.js SDK of GroupDocs.Conversion Cloud. A API permite que você converta seus documentos para qualquer formato que você precisar. Suporta a conversão de mais de 50 tipos de documentos e imagens como Word, Excel, PowerPoint, PDF, HTML, JPG, PNG, CAD. Ele também fornece SDKs .NET, Java, PHP, Ruby, Android e Python como seus membros da família de conversão de documentos para a Cloud API.

Você pode instalar o GroupDocs.Conversion Cloud em seu aplicativo Node.js usando o seguinte comando no console:

npm install groupdocs-conversion-cloud

Obtenha seu ID de cliente e Segredo do cliente no painel antes de começar a seguir as etapas e os exemplos de código disponíveis. Depois de ter seu ID e segredo, adicione o código conforme mostrado abaixo:

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

Converter Excel em PDF usando uma API REST em Node.js

Você pode converter planilhas do Excel em documentos PDF na nuvem seguindo as etapas simples abaixo:

  1. Carregar o arquivo XLSX para a nuvem
  2. Converter Excel em PDF usando Node.js
  3. Baixe o arquivo PDF convertido

Carregar o arquivo Excel

Em primeiro lugar, carregue o arquivo XLSX na nuvem usando o seguinte exemplo de código:

// abra o arquivo no IOStream de local/disco.
var resourcesFolder = 'C:\\Files\\sample.xlsx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // construir FileApi
  var fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);
  // criar solicitação de upload de arquivo
  var request = new groupdocs_conversion_cloud.UploadFileRequest("sample.xlsx", fileStream, myStorage);
  // subir arquivo
  fileApi.uploadFile(request);
});

Como resultado, o arquivo XLSX carregado estará disponível na seção de arquivos do seu painel na nuvem.

Converter Excel em PDF usando Node.js

Você pode facilmente converter documentos XLSX em PDF programaticamente seguindo as etapas mencionadas abaixo:

  • Crie uma instância do ConvertApi
  • Crie uma instância do ConvertSettings
  • Defina o caminho do arquivo XLSX
  • Atribuir “pdf” ao formato
  • Forneça o caminho do arquivo de saída
  • Criar ConvertDocumentRequest com ConvertSettings
  • Converter chamando o método ConvertApi.convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter uma planilha do Excel em um documento PDF usando uma API REST no Node.js.

// inicializar API
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// definir configurações de conversão
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

// criar solicitação de conversão de documento 
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// converter documento
let result = await convertApi.convertDocument(request);
// mostrar o caminho do arquivo convertido
console.log("Document converted successfully: " + result[0].url);
Converter Excel em PDF usando uma API REST em Node.js

Converter Excel em PDF usando uma API REST em Node.js

Baixe o arquivo convertido

O exemplo de código acima salvará o arquivo PDF convertido na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:

// construir FileApi
var fileApi = groupdocs_conversion_cloud.FileApi.fromConfig(config);

// criar solicitação de download de arquivo
let request = new groupdocs_conversion_cloud.DownloadFileRequest("output/sample.pdf", myStorage);

// ⇬ Fazer download do arquivo
let response = await fileApi.downloadFile(request);

// copie o arquivo para o diretório de trabalho
fs.writeFile("C:\\Files\\converted.pdf", response, "binary", function (err) { });
console.log(response);

Converter planilhas específicas do Excel em PDF no Node.js

Você pode converter planilhas específicas do Excel em documentos PDF programaticamente seguindo as etapas mencionadas abaixo:

  • Crie uma instância do ConvertApi
  • Crie uma instância do ConvertSettings
  • Defina o caminho do arquivo XLSX
  • Atribuir “pdf” ao formato
  • Forneça o caminho do arquivo de saída
  • Crie uma instância de PdfConvertOptions
  • Forneça planilhas específicas para converter
  • Definir PDFConvertOptions
  • Criar ConvertDocumentRequest com ConvertSettings
  • Converta chamando o método ConvertApi.convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter uma planilha específica do Excel em um documento PDF usando uma API REST no Node.js.

// inicializar API
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// definir configurações de conversão
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.xlsx";
settings.format = "pdf";

// definir opções de conversão de PDF
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.pages = [1];  // define pages (sheets) to convert

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

// criar solicitação de conversão de documento
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// converter documento
let result = await convertApi.convertDocument(request);
console.log("Document converted successfully: " + result[0].url);
Converter planilhas específicas do Excel em PDF no Node.js

Converter planilhas específicas do Excel em PDF no Node.js

Conversão de Excel para PDF com opções avançadas

Siga as etapas mencionadas abaixo para converter documentos XLSX em PDF com algumas configurações avançadas:

  • Crie uma instância do ConvertApi
  • Crie uma instância do ConvertSettings
  • Defina o caminho do arquivo XLSX
  • Atribuir “pdf” ao formato
  • Forneça o caminho do arquivo de saída
  • Crie uma instância do SpreadsheetLoadOptions
  • Defina várias opções de carregamento, como hideComments, onePagePerSheet, etc.
  • Crie uma instância do PdfConvertOptions
  • Defina várias opções de conversão, como displayDocTitle, fromPage, pagesCount, margens (superior, esquerda, direita, inferior), etc.
  • Criar ConvertDocumentRequest com ConvertSettings
  • Converter chamando o método ConvertApi.convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter uma planilha do Excel em um documento PDF com opções avançadas de conversão.

// inicializar API
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// definir configurações de conversão
var settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.storageName = myStorage;
settings.filePath = "sample.xlsx";
settings.format = "pdf";

// definir opções de carregamento da planilha
var loadOptions = new groupdocs_conversion_cloud.SpreadsheetLoadOptions();
loadOptions.hideComments = true;		  // hide comments	
loadOptions.onePagePerSheet = true;		// set one page per sheet

settings.loadOptions = loadOptions;

// definir opções de conversão de 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";

// criar solicitação de conversão de documento
var request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// criar documento
convertApi.convertDocument(request)
Converter planilhas do Excel em PDF usando Node.js

Conversão de Excel para PDF com opções avançadas

Converta Excel em PDF sem usar o Cloud Storage

Você pode converter planilhas do Excel em documentos PDF sem usar o armazenamento em nuvem seguindo as etapas mencionadas abaixo:

  • Crie uma instância do ConvertApi
  • Leia o arquivo XLSX de entrada do caminho local
  • Criar ConvertDocumentDirectRequest
  • Forneça o formato de destino e o caminho do arquivo de entrada como parâmetros de entrada
  • Obtenha resultados chamando o método convertDocumentDirect() com ConvertDocumentDirectRequest
  • Salve o arquivo de saída no caminho local usando o método FileStream.writeFile()

O exemplo de código a seguir mostra como converter uma planilha do Excel em um documento PDF sem usar o armazenamento em nuvem. Isso significa que você passará o arquivo de entrada no corpo da solicitação e receberá o arquivo de saída na resposta da API.

// inicializar API
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// ler arquivo do caminho local
let file = fs.readFileSync('C:\\Files\\sample.xlsx');

// criar solicitação direta de documento de conversão
let request = new groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", file);

// converter documento
let result = await convertApi.convertDocumentDirect(request);

// salvar arquivo de saída no caminho especificado
fs.writeFile("C:\\Files\\sample_direct.pdf", result, "binary", function (err) { });
console.log("Document converted: " + result.length);

Converter Excel em PDF e adicionar marca d’água

Você pode converter planilhas do Excel em documentos PDF com marca d’água seguindo as etapas mencionadas abaixo:

  • Crie uma instância do ConvertApi
  • Crie uma instância do ConvertSettings
  • Defina o caminho do arquivo XLSX
  • Atribuir “pdf” ao formato
  • Forneça o caminho do arquivo de saída
  • Crie uma instância de WatermarkOptions
  • Defina o texto da marca d’água, cor, largura, altura, etc.
  • Defina as PdfConvertOptions e atribua WatermarkOptions
  • Criar ConvertDocumentRequest com ConvertSettings
  • Converter chamando o método ConvertApi.convertDocument() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter uma planilha do Excel em um documento PDF e adicionar uma marca d’água ao documento PDF convertido usando uma API REST no Node.js.

// inicializar API
let convertApi = groupdocs_conversion_cloud.ConvertApi.fromKeys(clientId, clientSecret);

// definir configurações de conversão
let settings = new groupdocs_conversion_cloud.ConvertSettings();
settings.filePath = "sample.xlsx";
settings.format = "pdf";
settings.outputPath = "converted";

// definir opções de marca d'água
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;

// definir opções de conversão de PDF
let convertOptions = new groupdocs_conversion_cloud.PdfConvertOptions();
convertOptions.watermarkOptions = watermark;

// atribuir opções de conversão
settings.convertOptions = convertOptions

// criar solicitação de conversão de documento
let request = new groupdocs_conversion_cloud.ConvertDocumentRequest(settings);

// converter documento
let result = await convertApi.convertDocument(request);
// mostrar o caminho do documento de saída
console.log("Document converted successfully: " + result[0].url);
Converter Excel em PDF e adicionar marca d'água

Converter Excel em PDF e adicionar marca d’água

Experimente on-line

Experimente a seguinte ferramenta de conversão on-line gratuita de XLSX para PDF, desenvolvida usando a API acima. https://products.groupdocs.app/conversion/xlsx-to-pdf

Conclusão

Neste artigo, você aprendeu como converter Excel em documentos PDF na nuvem. Você também aprendeu como adicionar uma marca d’água ao documento PDF convertido usando Node.js. Além disso, você aprendeu como converter planilhas do Excel em documentos PDF sem usar o armazenamento em nuvem. Além disso, você aprendeu como carregar programaticamente o arquivo XLSX na nuvem e, em seguida, baixar o arquivo convertido da nuvem. Você pode aprender mais sobre GroupDocs.Conversion Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para nos contatar no fórum.

Veja também