Convertir des documents Word en PDF dans Ruby à l'aide de l'API REST

Comment convertir des documents Word en PDF avec Ruby

DOCX est l’un des traitements de texte les plus populaires au monde. Cependant, MS DOCX reformate les documents et peut être modifié lorsqu’il est ouvert sur un système informatique différent. Alors que les fichiers PDF sont adaptés aux appareils mobiles, faciles à lire et ne peuvent pas être modifiés. C’est pourquoi les utilisateurs convertissent des documents Word en PDF en ruby lorsqu’ils envoient des informations importantes telles que des factures en ligne, l’historique des transactions, des documents, etc.

Vous savez maintenant pourquoi vous devriez convertir des documents Word en fichier PDF. Vous pouvez convertir Word DOCX en PDF à l’aide de la fonctionnalité intégrée fournie par Microsoft Office, mais vous devrez peut-être convertir vos documents Word DOCX en PDF par programme. Utiliser les API de conversion de Groupdocs pour convertir vos documents Word en PDF est rapide, facile et instantané. Tout ce dont vous avez besoin est une connexion Internet stable et vos fichiers. Dans cet article, nous allons apprendre à convertir des documents Word en PDF dans Ruby à l’aide de l’API REST.

Les sujets suivants seront abordés dans cet article de blog :

API REST de conversion de Word en PDF - Installations de l’API Ruby

Vous pouvez facilement convertir fichiers DOCX en PDF à l’aide du SDK Ruby de GroupDocs.Conversion Cloud. Il vous aide à convertir rapidement et de manière fiable des documents de formats de fichiers pris en charge vers d’autres formats de documents - en quelques secondes seulement et en haute qualité. L’API REST GroupDocs.Conversion Cloud vous permet de convertir des documents dans une large gamme de formats de fichiers pris en charge sans aucun logiciel de dépendance. Il est compatible avec tous les principaux logiciels de bureau et est complètement indépendant du système d’exploitation.

GroupDocs.Conversion fournit des solutions de conversion de documents de haute qualité. Vous pouvez consulter notre liste de SDK disponibles ici pour transformer des documents dans un nouveau format à l’aide de nos API REST cloud. Vous pouvez également appeler ces API REST directement depuis votre navigateur avec la référence de l’API GroupDocs.Conversion Cloud Swagger UI. Un gem groupdocsconversioncloud est disponible sur rubygems. Vous pouvez installer l’API GroupDocs.Conversion Cloud pour convertir des documents Word en PDF dans l’application Ruby à l’aide de cette gemme avec la commande suivante dans la console rails :

gem install groupdocs_conversion_cloud

Adressable ~> 2.5.0, >= 2.5.0 est une gemme de dépendance d’exécution pour groupdocsconversioncloud. Vous pouvez également copier la gemme de conversion dans votre Gemfile pour communiquer avec l’API GroupDocs.Conversion Cloud, puis exécuter l’installation groupée :

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

Ensuite, vous devez ajouter un identifiant client et un secret client avant de faire des demandes à l’API GroupDocs Conversion Cloud. Cela sera utilisé pour appeler l’API GroupDocs Cloud dans votre projet existant. Vous pouvez obtenir les informations d’identification du client en créant une nouvelle Application sur le tableau de bord Groupdocs. Une fois que vous avez un identifiant client et un secret client, ajoutez-les dans l’extrait de code ruby comme indiqué ci-dessous :

# Obtenez votre client_id et client_secret sur https://dashboard.groupdocs.cloud après une inscription gratuite.
# Chargez la gemme dans votre application ruby pour http://api.groupdocs.cloud

require 'groupdocs_conversion_cloud'
@client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Ajoutez votre nom de stockage ici
@groupdocs_storage = "MyStorage"

Convertir des documents Word en PDF dans Ruby à l’aide de l’API REST

Vous pouvez convertir des documents Word en PDF par programme sur le cloud en suivant les étapes simples indiquées ci-dessous :

  1. Télécharger le fichier DOCX dans le cloud
  2. Convertir DOCX en fichier PDF
  3. Télécharger le fichier PDF converti
  4. Supprimer fichier du stockage cloud

1. Télécharger le fichier DOCX

Tout d’abord, chargez le fichier DOCX sur le stockage cloud à l’aide de l’exemple de code ci-dessous :

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Téléchargez le fichier sur le stockage en nuage

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

Par conséquent, le fichier DOCX téléchargé sera disponible dans la section fichiers de votre tableau de bord sur le cloud.

2. Convertir DOCX en PDF avec Ruby

Vous pouvez convertir DOCX en fichier PDF par programme en suivant les étapes mentionnées ci-dessous :

  • Tout d’abord, créez une instance de FileApi.
  • Ensuite, créez une instance de ConvertSettings.
  • Ensuite, définissez le chemin d’accès au fichier DOCX d’entrée.
  • Indiquez le format du fichier de sortie au format “pdf”.
  • Maintenant, indiquez le chemin du répertoire de sortie en tant que “conversion”.
  • Ensuite, créez ConvertDocumentRequest avec les paramètres fournis.
  • Enfin, appelez la méthode convert\document() avec ConvertDocumentRequest comme argument.

L’extrait de code suivant montre comment convertir DOCX en PDF à l’aide de l’API REST dans Ruby.

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Préparer les paramètres de fichier de conversion
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.")
Conversion de DOCX en PDF avec Ruby

Convertir DOCX en PDF avec Ruby

3. Télécharger le fichier converti

Le fichier PDF converti a été enregistré sur le cloud. L’extrait de code suivant montre comment télécharger un fichier à l’aide de Ruby :

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Télécharger la demande de fichier

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

4. Supprimer le fichier du stockage cloud

Vous pouvez supprimer le fichier PDF converti en utilisant l’exemple de code comme indiqué ci-dessous :

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Supprimer la demande de fichier du stockage

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

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

Conversion Word en PDF avec options avancées dans Ruby

Vous pouvez également convertir des documents Word en fichiers PDF en ruby avec des options avancées en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de FileApi.
  • Maintenant, créez ConvertDocumentRequest avec ConvertSettings
  • Ensuite, définissez le chemin d’accès au fichier DOCX d’entrée.
  • Indiquez le format du fichier résultant en “pdf”.
  • Maintenant, créez une instance de DocxLoadOptions.
  • Définir le mot de passe pour loadOptions
  • Ensuite, créez une instance de PdfConvertOptions
  • Ensuite, définissez diverses options de conversion telles que centre\fenêtre, affichage\doc\titre, marge, image\qualité et polices, etc.
  • Fournissez les paramètres load\options, convert\options et output\path.
  • Enfin, convertissez DOCX en appelant la méthode convert\document() avec ConvertDocumentRequest

L’exemple de code suivant montre comment convertir un document Word en document PDF avec des options de conversion avancées. Veuillez suivre les étapes mentionnées précédemment pour charger et télécharger un fichier.

# Initialisation de l'API : créer une instance des API de conversion
@fileApi = GroupDocsConversionCloud::FileApi.from_keys(@client_id, @client_secret)

# Options de fichier avancées
# Préparer et définir les paramètres de conversion

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 le document 
result = @fileApi.convert_document(GroupDocsConversionCloud::ConvertDocumentRequest.new(settings))

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

En conséquence, le fichier Word DOCX sera converti en fichier PDF à l’aide des options de fichier avancées.

Convertisseur DOCX en PDF gratuit en ligne

Comment convertir Word en PDF en ligne ? Notre convertisseur PDF gratuit et en ligne créera des PDF à partir de vos documents Word. Ce convertisseur PDF en ligne est développé à l’aide de l’API de conversion Groupdocs et préserve la mise en page de votre fichier. Convertir des documents DOCX en PDF gratuitement exactement comme le fichier PDF d’origine.

Conclusion

Dans cet article, nous avons appris comment convertir des documents Word en fichiers PDF sur le cloud. Vous avez également vu comment convertir DOCX en PDF avec des options avancées à l’aide de Ruby. Cet article a également expliqué comment télécharger par programmation le fichier DOCX sur le cloud, puis télécharger le fichier PDF converti à partir du cloud. En outre, vous pouvez en savoir plus sur l’API GroupDocs.Conversion Cloud à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur.

poser une question

Si vous avez des questions sur le convertisseur DOCX en PDF, n’hésitez pas à nous les poser sur le Forum.

Voir également

Nous vous recommandons de suivre le lien connexe des conversions de documents prises en charge :