Installation

Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :

pip install groupdocs-viewer-cloud

Prérequis

• Python 2.7 ou 3.4+
• Gestionnaire de packages pip
• Identifiants GroupDocs Cloud — Client ID et Client Secret depuis le Dashboard

Dépendances

Le SDK installe automatiquement les packages suivants :

API REST Cloud Python de rendu de documents

GroupDocs.Viewer Cloud SDK pour Python offre une solution puissante de rendu de documents prenant en charge plus de 190 formats tels que Word, Excel, PDF, CAO, e-mails et bien d’autres. Les développeurs peuvent facilement convertir et afficher des documents aux formats HTML, PDF et image, en préservant la structure et la mise en page du document original. Avec des fonctionnalités avancées telles que le streaming de sortie, les options d’affichage personnalisées, le rendu multi-pages et la prise en charge de divers types de fichiers, l’API GroupDocs.Viewer Cloud offre une intégration transparente pour les besoins de visualisation de documents dans toute application web Python, script ou flux d’automatisation. Inscrivez-vous gratuitement pour commencer à exploiter la flexibilité et les capacités de cette API cloud robuste.

Utilisation de base

Configuration simple du visualiseur - Guide pour configurer rapidement GroupDocs.Viewer avec une configuration minimale.
Charger un document depuis le cloud - Instructions pour charger des documents directement depuis le stockage cloud pour la visualisation.
Options d’affichage personnalisées - Étapes pour personnaliser les paramètres du visualiseur tels que le zoom, la mise en page et la navigation.
Formats de fichiers pris en charge - Liste détaillée des formats de fichiers pris en charge pouvant être affichés sans conversion.

Visualiseur HTML

Convertir des documents en HTML - Processus de conversion de documents au format HTML pour une visualisation fluide dans le navigateur.
Diffuser la sortie HTML - Guide sur la diffusion du contenu HTML pour le rendu de documents en temps réel.
Préserver la structure du document en HTML - Instructions pour conserver la mise en page et la structure d’origine lors de la conversion en HTML.
Options d’affichage HTML personnalisées - Fonctionnalités pour personnaliser l’apparence des documents affichés en HTML, y compris les styles et les polices.

Visualiseur d’images

Convertir des documents en images - Étapes pour convertir des documents en formats image comme PNG et JPEG pour la visualisation.
Diffuser la sortie image - Guide pour diffuser les formats image depuis le visualiseur de documents.
Personnaliser la résolution d’image - Options pour définir une résolution d’image spécifique lors de l’affichage de documents sous forme d’images.
Rendu d’images de documents multi-pages - Instructions pour afficher des documents multi-pages sous forme d’images séparées.

Visualiseur PDF

Convertir des documents en PDF - Convertissez tout format de document pris en charge en PDF pour la visualisation.
Diffuser la sortie PDF - Guide pour diffuser le contenu PDF pour une visualisation optimisée dans les navigateurs ou applications.
Intégrer le visualiseur PDF - Instructions pour intégrer un visualiseur PDF personnalisable dans votre application.
Prise en charge du visualiseur PDF - Fonctionnalités pour visualiser et interagir avec des documents PDF.

Rendre un document

Rendre un document en HTML, image ou PDF - Options pour afficher des documents aux formats HTML, image ou PDF.
Diffuser la sortie rendue - Diffusez la sortie du document rendu pour un accès en temps réel dans votre application.
Rendu de documents multi-pages - Prise en charge du rendu de documents multi-pages en plusieurs fichiers HTML, image ou PDF.

Options de rendu par type de document

Rendu spécialisé par type de fichier - Options de rendu personnalisées adaptées à divers types de documents comme Word, Excel, PDF, et plus encore.
Préserver les fonctionnalités du document - Assurez-vous que les fonctionnalités d’origine du document comme la mise en page, le texte et la mise en forme sont conservées lors du rendu.

Rendu de fichiers d’archives

Rendre des fichiers ZIP, RAR et TAR - Convertissez les formats d’archives comme ZIP, RAR et TAR en contenu visualisable.
Extraire et rendre des fichiers spécifiques - Extrayez des fichiers spécifiques des archives et affichez-les sans télécharger l’archive entière.

Rendu de dessins CAO

Rendre les formats CAO (DWG, DXF, etc.) - Convertissez et affichez des fichiers CAO tels que DWG et DXF pour une visualisation détaillée.
Personnaliser les options de rendu CAO - Définissez des paramètres spécifiques pour le rendu CAO, tels que le niveau de zoom, la visibilité des calques et la mise en page.

Rendu de messages e-mail

Rendre les formats MSG, EML et MHTML - Affichez des messages e-mail aux formats MSG, EML et MHTML directement dans le visualiseur.
Afficher les pièces jointes - Affichez automatiquement les pièces jointes des e-mails pour un accès facile.

Rendu de messages de bases de données Lotus Notes

Rendre les messages de bases de données NSF - Convertissez et affichez les messages de bases de données Lotus Notes (NSF) aux formats pris en charge.
Accéder aux éléments intégrés - Affichez les images, fichiers et liens intégrés dans les messages de bases de données Lotus Notes.

Rendu de documents MS Project

Rendre les fichiers MS Project (MPP) - Convertissez les fichiers MS Project (MPP) en HTML, images ou PDF pour une visualisation facile.
Afficher les données de projet - Affichez les vues de tâches, de ressources et de diagrammes de Gantt à partir de fichiers MS Project.

Rendu de fichiers de données Outlook

Rendre les fichiers PST et OST - Convertissez les fichiers de données Outlook PST et OST aux formats HTML, image ou PDF pour la visualisation.
Afficher e-mails, calendriers et contacts - Affichez les messages e-mail individuels, les événements de calendrier et les coordonnées à partir de fichiers de données Outlook.

Rendu de documents PDF

Convertir PDF en HTML, image ou autres formats - Affichez des documents PDF en HTML, image ou autres formats pris en charge pour la visualisation web ou applicative.
Annotations et signets PDF - Prise en charge du rendu de documents PDF avec annotations, signets et autres éléments intégrés.

Rendu de feuilles de calcul

Rendre les fichiers Excel (XLS, XLSX) - Convertissez les feuilles de calcul comme XLS et XLSX aux formats HTML, image ou PDF.
Afficher graphiques et formules - Affichez les graphiques, formules et formats de cellules complexes des feuilles de calcul pour une visualisation précise.

Rendu de fichiers texte

Rendre les fichiers texte brut et CSV - Convertissez les fichiers texte brut et CSV en HTML, image ou PDF pour une visualisation simplifiée.
Préserver la mise en forme du texte - Conservez la mise en page et la mise en forme du texte d’origine lors du rendu.

Rendu de documents Visio

Rendre les fichiers Visio (VSD, VSDX) - Convertissez et affichez les fichiers de diagrammes Visio aux formats HTML, image ou PDF.
Afficher diagrammes et organigrammes - Affichez les diagrammes, organigrammes et formes à partir de fichiers Visio pour une présentation claire.

Rendu de documents de traitement de texte

Rendre les fichiers Word (DOC, DOCX, ODT) - Convertissez les fichiers de traitement de texte tels que DOC, DOCX et ODT aux formats HTML, image ou PDF.
Préserver la structure du document - Assurez un rendu précis de la structure du document, y compris les en-têtes, pieds de page et la mise en forme.

Travail avec les pages de documents

Extraire des pages de documents - Extrayez des pages spécifiques de documents pour un rendu individuel.
Personnaliser l’affichage des pages - Contrôlez la pagination et les paramètres d’affichage des pages pour la visualisation de documents.

Rendu de pages de documents

Rendre des pages en HTML, image ou PDF - Convertissez des pages individuelles de documents aux formats HTML, image ou PDF pour la visualisation.
Diffuser la sortie de page - Diffusez des pages individuelles de documents pour des temps de chargement plus rapides et une visualisation en temps réel.

Minification du HTML et du SVG

Minifier le contenu HTML - Réduisez la taille du contenu HTML rendu pour des chargements de page plus rapides.
Optimiser la sortie SVG - Minifiez et optimisez la sortie SVG pour améliorer les performances sans perte de qualité.

Rendu de documents en HTML responsive

Convertir en HTML responsive - Affichez des documents en HTML responsive qui s’adapte à diverses tailles d’écran et appareils.
Visualisation adaptée aux mobiles - Assurez-vous que les documents sont optimisés pour les appareils mobiles et tablettes grâce au rendu HTML responsive.

Travail avec les pièces jointes

Extraire et rendre les pièces jointes - Extrayez et affichez les pièces jointes de documents ou de messages e-mail pour une visualisation facile.
Afficher les types de pièces jointes - Prise en charge de la visualisation de divers types de pièces jointes comme les images, documents et archives.

Licence et authentification

Mode d’évaluation - Affichez des documents avec filigranes pendant l’essai.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est sous licence MIT License.

Formats de fichiers pris en charge

GroupDocs.Viewer Cloud prend en charge plus de 190 formats de fichiers dans les catégories suivantes :

• Traitement de texte : DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT, ODT, OTT
• Feuilles de calcul : XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Présentations : PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF et mise en page : PDF, XPS, TEX
• Images : BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF, et plus encore
• CAO et diagrammes : DWG, DXF, DWF, DGN, IFC, STL ; VSD, VSDX, VSS, VST, et formats Visio associés
• E-mail et Outlook : MSG, EML, EMLX, MHT, PST, OST
• Web : HTML, HTM, MHT, MHTML
• Archives : ZIP, RAR, TAR, et autres formats d’archives
• Gestion de projet : MPP, MPT
• Livres numériques : EPUB, MOBI
• Notes : ONE (Microsoft OneNote)
• Lotus Notes : Messages de bases de données NSF

Tous les formats pris en charge peuvent être rendus en HTML, PNG/JPG ou PDF. Pour la matrice complète des formats, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Viewer Cloud, inscrivez-vous sur le GroupDocs.Cloud Dashboard et obtenez votre Client ID et votre Client Secret.

Initialiser l’API

Utilisez le code suivant pour commencer à utiliser GroupDocs.Viewer Cloud SDK pour Python :

import groupdocs_viewer_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the View API
view_api = groupdocs_viewer_cloud.ViewApi.from_config(configuration)

Rendre un document en HTML

Une fois initialisé, utilisez cet exemple de base pour afficher un document depuis le stockage cloud :

import groupdocs_viewer_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

view_api = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered: " + str(len(response.pages)) + " pages")

Avec ce guide de démarrage rapide, vous êtes prêt à commencer à afficher des documents avec GroupDocs.Viewer Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.

Obtenir les formats de fichiers pris en charge

Récupérez la liste complète des formats de fichiers pris en charge via la Viewer API.

import groupdocs_viewer_cloud

info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

try:
    response = info_api.get_supported_file_formats()

    print("Supported file-formats:")
    for fmt in response.formats:
        print("{0} ({1})".format(fmt.file_format, fmt.extension))
except groupdocs_viewer_cloud.ApiException as e:
    print("Exception when calling get_supported_file_formats: {0}".format(e.message))

Rendre un document en PDF

Cet exemple montre comment afficher un document Word au format PDF à l’aide de l’API GroupDocs.Viewer Cloud.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "PDF"
view_options.render_options = groupdocs_viewer_cloud.PdfOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered to PDF: " + response.file.path)

Rendre une feuille de calcul en HTML

Cet exemple de code convertit une feuille de calcul Excel en HTML à l’aide de l’API GroupDocs.Viewer Cloud.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Spreadsheet rendered to HTML: " + str(len(response.pages)) + " pages")

Rendre un document avec une mise en page HTML responsive

Affichez un document en HTML responsive qui s’adapte à diverses tailles d’écran et appareils.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.is_responsive = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Responsive HTML rendered: " + str(len(response.pages)) + " pages")

Rendre des pages sélectionnées

Convertissez uniquement des pages spécifiques d’un document, économisant du temps de traitement lorsque seule une partie du document est nécessaire.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.pages_to_render = [2, 3]

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Selected pages rendered: " + str(len(response.pages)) + " pages")

Rendre un document Word avec suivi des modifications

Affichez un document Word incluant le suivi des modifications dans le HTML de sortie.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/with_tracked_changes.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.word_processing_options = groupdocs_viewer_cloud.WordProcessingOptions()
view_options.render_options.word_processing_options.render_tracked_changes = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Tracked changes rendered: " + str(len(response.pages)) + " pages")

Obtenir les informations du document

Récupérez les métadonnées du document telles que le nombre de pages avant le rendu.

import groupdocs_viewer_cloud

info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"

request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
result = info_api.get_info(request)

print("Document pages: " + str(len(result.pages)))

Convertir et télécharger sans stockage cloud

Affichez un document local directement et recevez le fichier de sortie sans le téléverser d’abord vers le stockage cloud.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

with open("sample.docx", "rb") as file:
    request = groupdocs_viewer_cloud.ConvertAndDownloadRequest("jpg", file)
    output_path = view_api.convert_and_download(request)

print("Convert and download completed: " + output_path)

Projets d’exemple sur GitHub

Le dépôt GroupDocs.Viewer Cloud Python Samples inclut des exemples prêts à l’emploi couvrant :

Comment exécuter les exemples

1. Clonez ou téléchargez le dépôt d’exemples
2. Accédez au répertoire Examples
3. Modifiez RunExamples.py et définissez votre client_id et client_secret
4. Exécutez pip install groupdocs-viewer-cloud -U
5. Exécutez python RunExamples.py

Pour plus de détails, consultez Getting Started.

Tags

Document Rendering API | Python Cloud API | GroupDocs.Viewer Cloud | REST API | HTML Rendering | PDF Conversion | Image Rendering | Document Viewing | Multi-Page Rendering | Document Streaming | CAD Rendering | E-Mail Message Rendering | Visio Rendering | MS Project Rendering | Outlook Data Rendering | Spreadsheet Rendering | Word Processing Rendering | Custom View Options | Responsive HTML | Attachment Rendering | Secure API Access | Cloud Storage Integration