Installation

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

pip install groupdocs-comparison-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 Cloud REST Python de comparaison et de révision de documents

GroupDocs.Comparison Cloud SDK for Python est une puissante API cloud REST conçue pour les développeurs afin d’intégrer la fonctionnalité de comparaison de documents dans des applications web Python, des scripts et des flux de travail d’automatisation. Compatible avec plus de 90 formats de fichiers, cette API vous permet de comparer des dossiers entiers, d’accepter ou de rejeter des révisions de documents et de visualiser les modifications avec des aperçus de pages. Grâce à des fonctionnalités telles que le contrôle granulaire des modifications, la personnalisation des styles et la prise en charge de plusieurs documents, les développeurs peuvent automatiser efficacement les comparaisons de fichiers en masse. D’autres fonctionnalités incluent la comparaison de documents protégés par mot de passe, la fusion de fichiers de code source et l’extraction des coordonnées détaillées des modifications. Cet outil est idéal pour les environnements collaboratifs, la révision de documents juridiques et les systèmes de contrôle de version.

Comparaison de dossiers et de documents

Comparer des dossiers entiers - Comparez le contenu de répertoires entiers avec détection automatique des différences.
Filtrer les éléments modifiés - Enregistrez les résultats aux formats TXT ou HTML et affichez uniquement les éléments modifiés.
Comparaison de fichiers en masse - Automatisez efficacement les comparaisons de fichiers en masse au sein d’applications Python.

Contrôle des révisions de documents

Accepter ou rejeter des révisions dans DOCX - Acceptez ou rejetez par programmation les révisions dans les fichiers Word DOCX.
Extraire la liste des révisions - Récupérez toutes les révisions, appliquez les modifications souhaitées et rejetez les autres.
Gestion des versions - Obtenez un contrôle total de l’édition et de la gestion des versions des documents.

Génération d’aperçus de pages de documents

Générer des aperçus de pages - Créez des images d’aperçu de haute qualité avant d’enregistrer les résultats de comparaison.
Formats d’aperçu personnalisés - Spécifiez les formats (PNG, JPG, BMP) et sélectionnez des dimensions personnalisées.
Flux de révision visuelle - Intégrez des aperçus de documents dans des applications nécessitant une gestion visuelle du contenu.

Gestion et révision des modifications

Accepter ou rejeter les modifications détectées - Contrôlez les modifications de documents avec une précision granulaire.
Afficher les révisions et le suivi des modifications - Mettez en évidence les différences à l’aide du suivi des modifications à la Word.
Définir l’auteur des modifications - Attribuez la paternité des modifications détectées pour une meilleure traçabilité.

Personnalisation et flexibilité

Personnaliser les styles de modification - Contrôlez les polices, les couleurs et les styles de texte (gras, italique, barré).
Ajuster la sensibilité de comparaison - Équilibrez vitesse et précision avec des paramètres de sensibilité de 0 à 100.

Prise en charge de plusieurs documents

Comparer plusieurs documents - Comparez plus de deux documents simultanément.
Documents protégés par mot de passe - Comparez des fichiers source et cible protégés par mot de passe.
Fusionner des fichiers de code source - Comparez et fusionnez plusieurs versions de fichiers de code source avec contrôle des modifications.

Analyse détaillée des modifications

Obtenir les coordonnées des modifications - Récupérez l’emplacement exact des modifications dans les documents.
Obtenir la liste des modifications - Recevez une liste détaillée incluant le type de modification, le numéro de page et le texte concerné.
Extraire le texte source et cible - Extrayez le texte original et modifié pour chaque modification détectée.

Enregistrement et contrôle des métadonnées

Définir les métadonnées du document à l’enregistrement - Contrôlez l’auteur, le titre ou l’organisation des documents de sortie.
Définir un mot de passe pour le document de sortie - Appliquez une protection par mot de passe aux documents résultants.

Licence et authentification

Mode d’évaluation - Essayez l’API avec un compte d’essai gratuit.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est distribué sous la Licence MIT.

Formats de documents pris en charge

GroupDocs.Comparison Cloud prend en charge plus de 90 formats de fichiers avec des capacités de comparaison et de détection automatique :

• Traitement de texte : DOC, DOCM, DOCX, DOT, DOTM, DOTX, ODT, OTT, RTF
• Feuilles de calcul : XLS, XLT, XLSX, XLTM, XLSB, XLSM, ODS, CSV
• Présentations : POT, POTX, PPS, PPSX, PPTX, PPT, ODP, OTP
• Diagrammes : VSDX, VSD, VSS, VST, VDX
• Notes : ONE (Microsoft OneNote)
• PDF et mise en page : PDF, MOBI, DJVU
• Images : BMP, GIF, JPG/JPEG, PNG, DCM, DWG, DXF
• E-mail : EML, EMLX, MSG
• Web : HTML, MHT, MHTML
• Code source : CS, JAVA, CPP, JS, PY, RB

Les opérations prises en charge varient selon le format. Pour la matrice complète des formats, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Comparison Cloud, inscrivez-vous sur le Tableau de bord GroupDocs.Cloud et obtenez votre Client ID et Client Secret.

Initialiser l’API

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

import groupdocs_comparison_cloud

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

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

# Create instance of the Compare API
compare_api = groupdocs_comparison_cloud.CompareApi.from_config(configuration)

Comparer deux documents

Une fois initialisé, utilisez cet exemple de base pour comparer des documents Word et enregistrer le résultat :

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Avec ce guide de démarrage rapide, vous êtes prêt à commencer à comparer des documents avec GroupDocs.Comparison 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 disponibles via l’API Comparison.

import groupdocs_comparison_cloud

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

result = info_api.get_supported_file_formats()

print("Formats count: " + str(len(result.formats)))

Comparer des documents PDF

Comparez deux documents PDF et enregistrez le résultat avec les modifications suivies mises en évidence.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/pdf/source.pdf"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/pdf/target.pdf"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.pdf"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Comparer des documents protégés par mot de passe

Comparez deux documents Word protégés par mot de passe en fournissant les identifiants pour chaque fichier.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_protected.docx"
source.password = "1231"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target_protected.docx"
target.password = "5784"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Obtenir la liste des modifications

Récupérez une liste détaillée de toutes les modifications détectées entre les documents source et cible.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

print("Changes count: " + str(len(changes)))

Accepter ou rejeter des modifications

Acceptez ou rejetez des modifications individuelles après la comparaison des documents et enregistrez le résultat mis à jour.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.UpdatesOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

for change in changes:
    change.comparison_action = "Reject"
changes[0].comparison_action = "Accept"

options.changes = changes

response = compare_api.put_changes_document(groupdocs_comparison_cloud.PutChangesDocumentRequest(options))

print("Output file link: " + response.href)

Comparer plusieurs documents avec options

Comparez un document source à plusieurs cibles et personnalisez l’apparence des éléments insérés.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
target1 = groupdocs_comparison_cloud.FileInfo()
target1.file_path = "target_files/word/target_1.docx"
target2 = groupdocs_comparison_cloud.FileInfo()
target2.file_path = "target_files/word/target_2.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target, target1, target2]
options.output_path = "output/result.docx"
settings = groupdocs_comparison_cloud.Settings()
settings.inserted_items_style = groupdocs_comparison_cloud.ItemsStyle()
settings.inserted_items_style.font_color = "16711680"
options.settings = settings

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Appliquer des révisions dans des documents DOCX

Acceptez ou rejetez par programmation les révisions suivies dans un document Word.

import groupdocs_comparison_cloud

review_api = groupdocs_comparison_cloud.ReviewApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

revisions = review_api.get_revisions(groupdocs_comparison_cloud.GetRevisionsRequest(source))

for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

response = review_api.apply_revisions(groupdocs_comparison_cloud.ApplyRevisionsRequest(options))

print("Output file link: " + response.href)

Exemples de projets sur GitHub

Le dépôt GroupDocs.Comparison Cloud Python Samples comprend 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. Modifiez Examples/RunExamples.py et définissez vos client_id et client_secret
3. Accédez au répertoire Examples
4. Exécutez pip install groupdocs-comparison-cloud -U
5. Exécutez python RunExamples.py

Pour plus de détails, consultez Prise en main.

Tags

Document Comparison API | Python Cloud API | GroupDocs.Comparison Cloud | REST API | Document Comparison | Folder Comparison | Revision Control | Track Changes | Preview Generation | Multi-format Support | Password Protected Documents | Source Code Comparison | Change Tracking | Customization | Document Merging | Change Coordinates | Metadata Extraction | Document Security | Document Review | Secure API Access | Cloud Storage Integration | Cross-platform API