Converta documentos do Word para PDF em Ruby usando a API REST

Como converter documentos do Word para PDF usando Ruby

DOCX é um dos processadores de texto mais populares do mundo. No entanto, o MS DOCX reformata os documentos e pode ser alterado quando aberto em um sistema de computador diferente. Enquanto os arquivos PDF são compatíveis com dispositivos móveis, fáceis de ler e não podem ser alterados. É por isso que os usuários convertem documentos do Word em PDF em Ruby ao enviar informações importantes, como contas online, histórico de transações e folhetos, etc.

Agora você sabe por que deve converter documentos do Word em arquivo PDF. Você pode converter Word DOCX para PDF usando a funcionalidade integrada fornecida pelo Microsoft Office, mas pode ser necessário converter seus documentos do Word DOCX para PDF programaticamente. Usar as APIs de conversão do Groupdocs para converter seus documentos do Word em PDF é rápido, fácil e instantâneo. Tudo o que você precisa é de uma conexão estável com a Internet e seus arquivos. Neste artigo, aprenderemos como converter documentos do Word para PDF em Ruby usando a API REST.

Os seguintes tópicos devem ser abordados neste artigo do blog:

API REST de conversão de Word para PDF - Instalações da API Ruby

Você pode facilmente converter arquivos DOCX em PDF usando o Ruby SDK do GroupDocs.Conversion Cloud. Ele ajuda você a converter de forma rápida e confiável documentos de formatos de arquivo suportados para outros formatos de documento - apenas em alguns segundos e em alta qualidade. A API GroupDocs.Conversion Cloud REST permite que você converta documentos em uma ampla gama de formatos de arquivo suportados sem nenhum software dependente. É compatível com todos os principais softwares de escritório e é totalmente independente do sistema operacional.

GroupDocs.Conversion fornece soluções de conversão de documentos de alta qualidade. Você pode verificar nossa lista de SDKs disponíveis aqui para transformar documentos em um novo formato usando nossas APIs REST na nuvem. Você também pode chamar essas APIs REST diretamente de seu navegador com a referência GroupDocs.Conversion Cloud API Swagger UI. Um gem groupdocsconversioncloud está disponível em rubygems. Você pode instalar a API GroupDocs.Conversion Cloud para converter documentos do Word em PDF no aplicativo Ruby usando esta gem com o seguinte comando no console Rails:

gem install groupdocs_conversion_cloud

Addressable ~> 2.5.0, >= 2.5.0 é gem de dependência de tempo de execução para groupdocsconversioncloud. Você também pode copiar a gem de conversão em seu Gemfile para se comunicar com a API GroupDocs.Conversion Cloud e, em seguida, executar a instalação do pacote:

gem "groupdocs_conversion_cloud", "~> 22.3"
bundle install

Em seguida, você precisa adicionar um ID do cliente e um segredo do cliente antes de fazer qualquer solicitação à API GroupDocs Conversion Cloud. Isso será usado para chamar a API GroupDocs Cloud em seu projeto existente. Você pode obter credenciais do cliente criando um novo Aplicativo no painel do Groupdocs. Depois de obter o ID do cliente e um segredo do cliente, adicione-os ao snippet de código ruby, conforme mostrado abaixo:

# Obtenha seu client_id e client_secret em https://dashboard.groupdocs.cloud após o registro gratuito.
# Carregue a gem em seu aplicativo ruby para http://api.groupdocs.cloud

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Adicione seu nome de armazenamento aqui
@groupdocs_storage = "MyStorage"

Converta documentos do Word para PDF em Ruby usando a API REST

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

  1. Upload o arquivo DOCX para a nuvem
  2. Converter arquivo DOCX para PDF
  3. Baixar o arquivo PDF convertido
  4. Excluir arquivo do armazenamento em nuvem

1. Carregar o arquivo DOCX

Primeiro, carregue o arquivo DOCX para o armazenamento em nuvem usando o exemplo de código abaixo:

# Inicialização da API: crie uma instância das APIs de conversão
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Carregar arquivo para armazenamento em nuvem

@wordfile = "#{Rails.root}/public/groupdocs-files/four-pages.docx"
@fileStream = File.new(@wordfile, "r")

@request = GroupDocsConversionCloud::UploadFileRequest.new('conversion/four-pages.docx', @fileStream, @groupdocs_storage)
@response = @fileApi.upload_file(@request)

@fileStream.close()

puts("File Uploading completed." + (@response).to_s )

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

2. Converta DOCX para PDF usando Ruby

Você pode converter arquivo DOCX para PDF programaticamente seguindo as etapas mencionadas abaixo:

  • Primeiro de tudo, crie uma instância do FileApi.
  • Em seguida, crie uma instância do ConvertSettings.
  • Em seguida, defina o caminho do arquivo DOCX de entrada.
  • Forneça o formato para o arquivo de saída como “pdf”.
  • Agora, forneça o caminho do diretório de saída como “conversão”.
  • Em seguida, crie ConvertDocumentRequest com as configurações fornecidas.
  • Por fim, chame o método convert\document() com ConvertDocumentRequest como argumento.

O trecho de código a seguir mostra como converter DOCX em PDF usando a API REST em Ruby.

# Inicialização da API: crie uma instância das APIs de conversão
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Prepare as configurações do arquivo de conversão
settings = GroupDocsConversionCloud::ConverterSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
settings.output_path = "conversion"

# Converter
result = @fileApi.convert_document(GroupDocsConversionCloud::ConverterDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file.")
DOCX convertido para PDF usando Ruby

Converta DOCX para PDF usando Ruby

3. Baixe o arquivo convertido

O arquivo PDF convertido foi salvo na nuvem. O trecho de código a seguir demonstra como baixar um arquivo usando Ruby:

# Inicialização da API: crie uma instância das APIs de conversão
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Solicitação de download de arquivo

@request = GroupDocsConversionCloud::DownloadFileRequest.new("conversion/four-pages.pdf", @groupdocs_storage)
@response = @fileApi.download_file(@request)
    
puts("File downloading successfully completed." + (@response).to_s )

4. Excluir arquivo do armazenamento em nuvem

Você pode excluir o arquivo PDF convertido usando o exemplo de código mostrado abaixo:

# Inicialização da API: crie uma instância das APIs de conversão
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Excluir solicitação de arquivo do armazenamento

@request = GroupDocsConversionCloud::DeleteFileRequest.new("conversion/four-pages.docx", @groupdocs_storage)
@response = @fileApi.delete_file(@request)

puts("File successfully deleted from storage." + (@response).to_s )

Conversão de Word para PDF com opções avançadas em Ruby

Você também pode converter documentos do Word em arquivos PDF em ruby com opções avançadas seguindo as etapas mostradas abaixo:

  • Primeiro, crie uma instância do FileApi.
  • Agora, crie ConvertDocumentRequest com ConvertSettings
  • Em seguida, defina o caminho do arquivo DOCX de entrada.
  • Forneça o formato do arquivo resultante como “pdf”.
  • Agora, crie uma instância do DocxLoadOptions.
  • Definir senha para loadOptions
  • Em seguida, crie uma instância do PdfConvertOptions
  • Em seguida, defina várias opções de conversão, como centro\janela, exibição\doc\título, margem, imagem\qualidade e fontes, etc.
  • Forneça configurações de load\options, convert\options e output\path.
  • Finalmente, converta DOCX chamando o método convert\document() com ConvertDocumentRequest

O exemplo de código a seguir mostra como converter um documento do Word em um documento PDF com opções avançadas de conversão. Siga as etapas mencionadas anteriormente para fazer upload e download de um arquivo.

# Inicialização da API: crie uma instância das APIs de conversão
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Opções avançadas de arquivo
# Prepare e defina as configurações de conversão

settings = GroupDocsConversionCloud::ConvertSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
 
loadOptions = GroupDocsConversionCloud::DocxLoadOptions.new
loadOptions.password = "password"

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 = "advance_options"
 
# Converter Documento 
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file with advance file options.")

Como resultado, o arquivo Word DOCX será convertido em arquivo PDF usando as opções avançadas de arquivo.

Conversor online gratuito de DOCX para PDF

Como converter Word para PDF online? Nosso conversor de PDF gratuito e online criará PDFs a partir de seus documentos do Word. Este conversor de PDF online foi desenvolvido usando a API de conversão do Groupdocs e preserva o layout do seu arquivo. Converter documentos DOCX para PDF grátis exatamente como o arquivo PDF original.

Conclusão

Neste artigo, aprendemos como converter documentos do Word em arquivos PDF na nuvem. Você também viu como converter DOCX para PDF com opções avançadas usando Ruby. Este artigo também explicou como carregar programaticamente o arquivo DOCX na nuvem e, em seguida, baixar o arquivo PDF convertido da nuvem. Além disso, 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 conversor DOCX para PDF, sinta-se à vontade para nos perguntar no Fórum.

Veja também

Recomendamos o seguinte link relacionado de conversões de documentos suportadas: