Convierta documentos de Word a PDF en Ruby usando REST API

Cómo convertir documentos de Word a PDF usando Ruby

DOCX es uno de los procesadores de texto más populares del mundo. Sin embargo, MS DOCX reformatea los documentos y puede modificarse cuando se abre en un sistema informático diferente. Si bien los archivos PDF son compatibles con dispositivos móviles, son fáciles de leer y no se pueden modificar. Es por eso que los usuarios convierten documentos de Word a PDF en Ruby cuando envían información importante como facturas en línea, historial de transacciones, folletos, etc.

Ahora sabe por qué debería convertir documentos de Word a archivos PDF. Puede convertir Word DOCX a PDF utilizando la funcionalidad integrada proporcionada por Microsoft Office, pero es posible que deba convertir sus documentos de Word DOCX a PDF mediante programación. El uso de las API de conversión de Groupdocs para convertir sus documentos de Word a PDF es rápido, fácil e instantáneo. Todo lo que necesita es una conexión a Internet estable y sus archivos. En este artículo, aprenderemos cómo convertir documentos de Word a PDF en Ruby usando la API REST.

Los siguientes temas se tratarán en este artículo de blog:

API REST de conversión de Word a PDF: instalaciones de la API de Ruby

Puede convertir fácilmente archivos DOCX a PDF usando el Ruby SDK de GroupDocs.Conversion Cloud. Le ayuda a convertir de forma rápida y fiable documentos de formatos de archivo compatibles a otros formatos de documentos, en solo unos segundos y en alta calidad. GroupDocs.Conversion Cloud REST API le permite convertir documentos en una amplia gama de formatos de archivo admitidos sin ningún software de dependencia. Es compatible con todos los principales software de oficina y es completamente independiente del sistema operativo.

GroupDocs.Conversion proporciona soluciones de conversión de documentos de alta calidad. Puede consultar nuestra lista de SDK disponibles aquí para transformar documentos a un nuevo formato utilizando nuestras API REST en la nube. También puede llamar a estas API de REST directamente desde su navegador con la referencia de la API de GroupDocs.Conversion Cloud Swagger UI. Una gema groupdocsconversioncloud está disponible en rubygems. Puede instalar GroupDocs.Conversion Cloud API para convertir documentos de Word a PDF en la aplicación Ruby usando esta gema con el siguiente comando en la consola de Rails:

gem install groupdocs_conversion_cloud

Direccionable ~> 2.5.0, >= 2.5.0 es una gema de dependencia en tiempo de ejecución para groupdocsconversioncloud. También puede copiar la gema de conversión en su Gemfile para comunicarse con GroupDocs.Conversion Cloud API y luego ejecutar la instalación del paquete:

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

A continuación, debe agregar una identificación de cliente y un secreto de cliente antes de realizar cualquier solicitud a la API de GroupDocs Conversion Cloud. Esto se usará para llamar a la API de GroupDocs Cloud en su proyecto existente. Puede obtener credenciales de cliente creando una nueva Aplicación en el panel de Groupdocs. Una vez que tenga la identificación del cliente y un secreto del cliente, agréguelos en el fragmento de código ruby como se muestra a continuación:

# Obtenga su client_id y client_secret de https://dashboard.groupdocs.cloud después del registro gratuito.
# Cargue la gema en su aplicación Ruby para http://api.groupdocs.cloud

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Agregue su nombre de almacenamiento aquí
@groupdocs_storage = "MyStorage"

Convierta documentos de Word a PDF en Ruby usando REST API

Puede convertir documentos de Word a PDF mediante programación en la nube siguiendo los sencillos pasos que se indican a continuación:

  1. Subir el archivo DOCX a la nube
  2. Convertir archivo DOCX a PDF
  3. Descargar el archivo PDF convertido
  4. Eliminar archivo del almacenamiento en la nube

1. Sube el archivo DOCX

Primero, cargue el archivo DOCX en el almacenamiento en la nube utilizando el siguiente ejemplo de código:

# Inicialización de API: cree una instancia de las API de conversión
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Subir archivo al almacenamiento en la nube

@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, el archivo DOCX cargado estará disponible en la sección de archivos de su panel en la nube.

2. Convierta DOCX a PDF usando Ruby

Puede convertir archivos DOCX a PDF mediante programación siguiendo los pasos que se mencionan a continuación:

  • En primer lugar, cree una instancia de FileApi.
  • A continuación, cree una instancia de ConvertSettings.
  • Luego, configure la ruta del archivo DOCX de entrada.
  • Proporcione el formato para el archivo de salida como “pdf”.
  • Ahora, proporcione la ruta del directorio de salida como “conversión”.
  • A continuación, cree ConvertDocumentRequest con la configuración proporcionada.
  • Finalmente, llame al método convert\document() con ConvertDocumentRequest como argumento.

El siguiente fragmento de código muestra cómo convertir DOCX a PDF usando REST API en Ruby.

# Inicialización de API: cree una instancia de las API de conversión
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Preparar la configuración del archivo de conversión
settings = GroupDocsConversionCloud::ConvertirSettings.new
settings.file_path = "four-pages.docx"
settings.format = "pdf"
settings.output_path = "conversion"

# Convertir
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertirDocumentRequest.new(settings))

puts("Word file successfully converted to pdf file.")
Convertido DOCX a PDF usando Ruby

Convierta DOCX a PDF usando Ruby

3. Descargar el archivo convertido

El archivo PDF convertido se ha guardado en la nube. El siguiente fragmento de código demuestra cómo descargar un archivo usando Ruby:

# Inicialización de API: cree una instancia de las API de conversión
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Solicitud de descarga de archivos

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

4. Eliminar archivo del almacenamiento en la nube

Puede eliminar el archivo PDF convertido usando el ejemplo de código como se muestra a continuación:

# Inicialización de API: cree una instancia de las API de conversión
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Eliminar solicitud de archivo del almacenamiento

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

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

Conversión de Word a PDF con opciones avanzadas en Ruby

También puede convertir documentos de Word a archivos PDF en Ruby con opciones avanzadas siguiendo los pasos que se muestran a continuación:

  • Primero, cree una instancia de FileApi.
  • Ahora, cree ConvertDocumentRequest con ConvertSettings
  • Luego, configure la ruta del archivo DOCX de entrada.
  • Proporcione el formato del archivo resultante como “pdf”.
  • Ahora, cree una instancia de DocxLoadOptions.
  • Establecer contraseña para loadOptions
  • A continuación, cree una instancia de PdfConvertOptions
  • Luego, configure varias opciones de conversión, como centro\ventana, pantalla\doc\título, margen, imagen\calidad y fuentes, etc.
  • Proporcione la configuración de load\options, convert\options y output\path.
  • Finalmente, convierta DOCX llamando al método convert\document() con ConvertDocumentRequest

El siguiente ejemplo de código muestra cómo convertir un documento de Word en un documento PDF con opciones de conversión avanzadas. Siga los pasos mencionados anteriormente para cargar y descargar un archivo.

# Inicialización de API: cree una instancia de las API de conversión
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Opciones de archivo avanzadas
# Preparar y configurar los ajustes de conversión

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

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

Como resultado, el archivo DOCX de Word se convertirá en un archivo PDF utilizando las opciones de archivo avanzadas.

Convertidor gratuito de DOCX a PDF en línea

¿Cómo convertir Word a PDF en línea? Nuestro convertidor de PDF gratuito y en línea creará archivos PDF a partir de sus documentos de Word. Este convertidor de PDF en línea se desarrolla utilizando la API de conversión de Groupdocs y conserva el diseño de su archivo. Convierta documentos DOCX a PDF gratis exactamente como el archivo PDF original.

Conclusión

En este artículo, hemos aprendido cómo convertir documentos de Word a archivos PDF en la nube. También ha visto cómo convertir DOCX a PDF con opciones avanzadas usando Ruby. Este artículo también explicó cómo cargar mediante programación el archivo DOCX en la nube y luego descargar el archivo PDF convertido desde la nube. Además, puede obtener más información sobre GroupDocs.Conversion Cloud API utilizando la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador.

Hacer una pregunta

Si tiene alguna consulta sobre el convertidor de DOCX a PDF, no dude en consultarnos en el Foro.

Ver también

Recomendamos seguir el enlace relacionado de las conversiones de documentos compatibles: