Converter planilhas do Excel em PDF usando Ruby

As planilhas Excel são amplamente utilizadas para a criação de recibos, faturas, livros contábeis, inventário, contas e outros relatórios. A API de conversão XLS ou XLSX para PDF permite compartilhar dados do Excel com outras pessoas em um formato portátil. Como desenvolvedor Ruby, você pode facilmente converter suas planilhas do Excel em documentos PDF programaticamente na nuvem. Neste artigo, aprenderemos como converter planilhas do Excel em PDF usando Ruby.

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

• API REST de conversão de Excel para PDF e SDK Ruby
• Converter Excel em PDF usando uma API REST em Ruby
• Converter planilhas específicas do Excel em PDF em Ruby
• Conversão de Excel para PDF em Ruby usando opções avançadas
• Converter Excel em PDF e adicionar marca d’água
• Conversor XLSX para PDF Online Grátis

API REST de conversão de Excel para PDF e SDK Ruby

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

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

gem 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:

# Carregue a gem em seu aplicativo ruby para http://api.groupdocs.cloud
require 'groupdocs_conversion_cloud'

# Obtenha seu client_id e client_secret em https://dashboard.groupdocs.cloud após o registro gratuito.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Converter Excel em PDF usando uma API REST em Ruby

Você pode converter planilhas do Excel em documentos PDF na nuvem seguindo as etapas simples abaixo: 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
• Crie uma instância do SpreadsheetLoadOptions
• Definir ocultar comentários e valores de uma\página\por\folha
• Forneça load\options e 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 em Ruby.

# Criar instância da API de conversão
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# Inicializar e definir configurações de conversão
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"

# Definir opções de carga de conversão de planilha
@loadOptions = GroupDocsConversionCloud::SpreadsheetLoadOptions.new
@loadOptions.hide_comments = true
@loadOptions.one_page_per_sheet = true
 
@settings.load_options = @loadOptions
@settings.output_path = "xlsx-to-pdf"
 
# Converter XLSX para PDF
result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))

puts("Spreadsheet successfully converted to PDF")

Converter planilhas específicas do Excel em PDF em Ruby

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
• Crie uma instância de PdfConvertOptions
• Forneça páginas de planilhas específicas para converter
• Defina PdfConvertOptions e 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 específica do Excel em um documento PDF usando uma API REST em Ruby.

# Converter páginas específicas de XLSX para PDF em Ruby
# Crie instâncias de API necessárias
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# Definir configurações de conversão
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"
@convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
@convertOptions.pages = [1, 3]
 
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# Converter páginas específicas em PDF
@result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))
puts("Spreadsheet pages successfully converted to PDF")

Conversão de Excel para PDF em Ruby usando 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
• Crie uma instância do SpreadsheetLoadOptions
• Defina várias opções de carregamento, como hideComments, onePagePerSheet, etc.
• Crie uma instância de PdfConvertOptions
• Defina diferentes opções de conversão para convertOptions
• Forneça load\options, convertOptions e o caminho do arquivo de saída
• 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 do Excel em um documento PDF com opções avançadas de conversão:

# Criar instância da API de conversão
@apiInstance = GroupDocsConversionCloud::ConvertApi.from_keys(@app_sid, @app_key)
 
# Inicializar e definir configurações de conversão
@settings = GroupDocsConversionCloud::ConvertSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"

# Definir opções de carga de conversão de planilha
@loadOptions = GroupDocsConversionCloud::SpreadsheetLoadOptions.new
@loadOptions.hide_comments = true
@loadOptions.one_page_per_sheet = true

@convertOptions = GroupDocsConversionCloud::PdfConvertOptions.new
@convertOptions.center_window = true
@convertOptions.compress_images = false
@convertOptions.display_doc_title = true
@convertOptions.dpi = 1024.0
@convertOptions.fit_window = false
@convertOptions.from_page = 1
@convertOptions.grayscale = false
@convertOptions.image_quality = 100
@convertOptions.linearize = false
@convertOptions.margin_top = 5
@convertOptions.margin_left = 5
@convertOptions.password = "password"
@convertOptions.unembed_fonts = true
@convertOptions.remove_unused_streams = true
@convertOptions.remove_unused_objects = true
@convertOptions.remove_pdfa_compliance = false

@settings.load_options = @loadOptions
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# Converter XLSX para PDF
result = @apiInstance.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(@settings))
puts("XLSX converted to PDF using advance options")

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
• Crie uma instância de WatermarkOptions
• Defina o texto da marca d’água, cor, largura, altura, etc.
• Defina as PdfConvertOptions e atribua WatermarkOptions
• Definir opções de conversão e 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 planilha do Excel em documento PDF e adicionar uma marca d’água ao documento PDF convertido usando uma API REST em Ruby.

#XLSX to PDF Conversion with Watermark using Ruby
# Crie instâncias de API necessárias
@apiInstance = GroupDocsConversionCloud::ConverterApi.from_keys(@app_sid, @app_key)
 
# Preparar configurações de conversão
@watermark = GroupDocsConversionCloud::WatermarkOptions.new       
@watermark.text = "CONFIDENTIAL"
@watermark.color = "Red"
@watermark.width = 100
@watermark.height = 100
@watermark.background = false
@watermark.bold = true;
@watermark.top = 300;
@watermark.left = 200;

@settings = GroupDocsConversionCloud::ConverterSettings.new
@settings.file_path = "xlsx-to-pdf/four-pages.xlsx"
@settings.format = "pdf"
@convertOptions = GroupDocsConversionCloud::PdfConverterOptions.new
@convertOptions.watermark_options = @watermark
 
@settings.convert_options = @convertOptions
@settings.output_path = "xlsx-to-pdf"
 
# Converter
result = @apiInstance.convert_document(GroupDocsConversionCloud::ConverterDocumentRequest.new(@settings))
puts("Spreadsheet successfully converted to PDF with Watermark")

Conversor XLSX para PDF Online Grátis

Como converter Excel para PDF online? Você pode tentar a seguinte ferramenta on-line gratuita de conversão de XLSX para PDF, que é desenvolvida usando a API acima.

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 Ruby. Além disso, aprendemos como converter arquivos XLSX em PDF programaticamente na nuvem usando opções avançadas. 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.

Faça uma pergunta

Se você tiver alguma dúvida sobre o XLSX to PDF Converter, sinta-se à vontade para nos perguntar no Fórum.

Veja também

• Converta documentos do Word para PDF em Ruby usando a API REST
• Como converter PDF para documento do Word em Ruby
• Como converter Word DOCX para apresentação do PowerPoint PPTX usando Ruby