Installation

Das Paket ist verfügbar bei PyPI und kann über pip mit folgendem Befehl installiert werden:

pip install groupdocs-comparison-cloud

Anforderungen

• Python 2.7 oder 3.4+
• pip Paketmanager
• GroupDocs Cloud-Anmeldeinformationen — Client ID and Client Secret vom Dashboard

Abhängigkeiten

Das SDK installiert automatisch die folgenden Pakete:

Dokumentvergleich & Revision Python Cloud REST API

GroupDocs.Comparison Cloud SDK für Python ist eine leistungsstarke Cloud REST API, die Entwicklern die Integration von Dokumentvergleichsfunktionen in Python-Web-Apps, Skripte und Automatisierungs-Workflows ermöglicht. Mit Unterstützung für über 90 Dateiformate können Sie ganze Ordner vergleichen, Dokumentrevisionen annehmen oder ablehnen und Änderungen mit Seitenvorschauen visualisieren. Mit Funktionen wie granularer Änderungskontrolle, Stilanpassung und Multi-Dokument-Unterstützung können Entwickler Massenvergleiche von Dateien effizient automatisieren. Weitere Funktionen umfassen den Vergleich kennwortgeschützter Dokumente, das Zusammenführen von Quellcodedateien und das Extrahieren detaillierter Änderungskoordinaten. Dieses Tool eignet sich ideal für kollaborative Umgebungen, die juristische Dokumentenprüfung und Versionskontrollsysteme.

Ordner- und Dokumentvergleich

Ganze Ordner vergleichen - Vergleichen Sie den Inhalt ganzer Verzeichnisse mit automatischer Erkennung von Unterschieden.
Geänderte Elemente filtern - Speichern Sie Ergebnisse in TXT- oder HTML-Formaten und zeigen Sie nur geänderte Elemente an.
Massenvergleich von Dateien - Automatisieren Sie Massenvergleiche von Dateien effizient innerhalb von Python-Anwendungen.

Dokumentrevisionskontrolle

Revisionen in DOCX annehmen oder ablehnen - Nehmen Sie Revisionen in Word-DOCX-Dateien programmatisch an oder lehnen Sie sie ab.
Revisionsliste extrahieren - Rufen Sie alle Revisionen ab, wenden Sie gewünschte Änderungen an und lehnen Sie andere ab.
Versionsverwaltung - Ermöglichen Sie vollständige Kontrolle über Dokumentenbearbeitung und Versionsverwaltung.

Generierung von Dokumentseitenvorschauen

Seitenvorschauen generieren - Erstellen Sie hochwertige Vorschaubilder, bevor Sie Vergleichsergebnisse speichern.
Benutzerdefinierte Vorschauformate - Geben Sie Formate (PNG, JPG, BMP) an und wählen Sie benutzerdefinierte Abmessungen.
Visuelle Prüf-Workflows - Integrieren Sie Dokumentenvorschauen in Anwendungen, die visuelles Content-Management erfordern.

Änderungsverwaltung und -prüfung

Erkannte Änderungen annehmen oder ablehnen - Steuern Sie Dokumentänderungen mit granularer Präzision.
Revisionen und Änderungsnachverfolgung anzeigen - Heben Sie Unterschiede im Word-Stil mit Änderungsnachverfolgung hervor.
Autor von Änderungen festlegen - Weisen Sie erkannten Änderungen Autorschaft zu, um die Nachvollziehbarkeit zu verbessern.

Anpassung und Flexibilität

Änderungsstile anpassen - Steuern Sie Schriftarten, Farben und Textstile (fett, kursiv, durchgestrichen).
Vergleichsempfindlichkeit anpassen - Balancieren Sie Geschwindigkeit und Genauigkeit mit Empfindlichkeitseinstellungen von 0 bis 100.

Multi-Dokument-Unterstützung

Mehrere Dokumente vergleichen - Vergleichen Sie mehr als zwei Dokumente gleichzeitig.
Kennwortgeschützte Dokumente - Vergleichen Sie kennwortgeschützte Quell- und Zieldateien.
Quellcodedateien zusammenführen - Vergleichen und führen Sie mehrere Versionen von Quellcodedateien mit Änderungskontrolle zusammen.

Detaillierte Änderungsanalyse

Änderungskoordinaten abrufen - Ermitteln Sie die genaue Position von Änderungen innerhalb von Dokumenten.
Liste der Änderungen abrufen - Erhalten Sie eine detaillierte Liste einschließlich Änderungstyp, Seitennummer und betroffenem Text.
Quell- und Zieltext extrahieren - Extrahieren Sie Original- und geänderten Text für jede erkannte Änderung.

Speichern und Metadatenkontrolle

Dokumentmetadaten beim Speichern festlegen - Steuern Sie Autor, Titel oder Organisation bei Ausgabedokumenten.
Kennwort für Ausgabedokument festlegen - Wenden Sie Kennwortschutz auf resultierende Dokumente an.

Lizenzierung und Authentifizierung

Evaluation Mode - Testen Sie die API mit einem kostenlosen Testkonto.
Secure Authentication - Verwenden Sie Client ID and Client Secret für sicheren API-Zugriff.
MIT License - Das Python SDK ist unter der MIT License lizenziert.

Unterstützte Dokumentformate

GroupDocs.Comparison Cloud unterstützt über 90 Dateiformate mit Vergleichs- und Auto-Erkennungsfunktionen:

• Textverarbeitung: DOC, DOCM, DOCX, DOT, DOTM, DOTX, ODT, OTT, RTF
• Tabellenkalkulationen: XLS, XLT, XLSX, XLTM, XLSB, XLSM, ODS, CSV
• Präsentationen: POT, POTX, PPS, PPSX, PPTX, PPT, ODP, OTP
• Diagramme: VSDX, VSD, VSS, VST, VDX
• Notizen: ONE (Microsoft OneNote)
• PDF und Seitenlayout: PDF, MOBI, DJVU
• Bilder: BMP, GIF, JPG/JPEG, PNG, DCM, DWG, DXF
• E-Mail: EML, EMLX, MSG
• Web: HTML, MHT, MHTML
• Quellcode: CS, JAVA, CPP, JS, PY, RB

Unterstützte Operationen variieren je nach Format. Die vollständige Formatmatrix finden Sie in der Dokumentation.

Schnellstart

API-Anmeldeinformationen abrufen

Um GroupDocs.Comparison Cloud zu nutzen, registrieren Sie sich im GroupDocs.Cloud Dashboard und holen Sie sich Ihre Client ID und Client Secret.

API initialisieren

Verwenden Sie den folgenden Code, um mit dem GroupDocs.Comparison Cloud SDK für Python zu beginnen:

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)

Zwei Dokumente vergleichen

Nach der Initialisierung verwenden Sie dieses grundlegende Beispiel, um Word-Dokumente zu vergleichen und das Ergebnis zu speichern:

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)

Mit dieser Schnellstartanleitung sind Sie bereit, Dokumente mit GroupDocs.Comparison Cloud in Ihren Python-Anwendungen zu vergleichen. Weitere Details finden Sie in der Dokumentation.

Unterstützte Dateiformate abrufen

Rufen Sie die vollständige Liste der über die Comparison API verfügbaren unterstützten Dateiformate ab.

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

PDF-Dokumente vergleichen

Vergleichen Sie zwei PDF-Dokumente und speichern Sie das Ergebnis mit hervorgehobenen nachverfolgten Änderungen.

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)

Kennwortgeschützte Dokumente vergleichen

Vergleichen Sie zwei kennwortgeschützte Word-Dokumente, indem Sie Anmeldeinformationen für jede Datei angeben.

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)

Liste der Änderungen abrufen

Rufen Sie eine detaillierte Liste aller zwischen Quell- und Zieldokumenten erkannten Änderungen ab.

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

Änderungen annehmen oder ablehnen

Nehmen Sie einzelne Änderungen nach dem Vergleich von Dokumenten an oder lehnen Sie sie ab und speichern Sie das aktualisierte Ergebnis.

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)

Mehrere Dokumente mit Optionen vergleichen

Vergleichen Sie ein Quelldokument mit mehreren Zieldokumenten und passen Sie das Erscheinungsbild eingefügter Elemente an.

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)

Revisionen in DOCX-Dokumenten anwenden

Nehmen Sie nachverfolgte Revisionen in einem Word-Dokument programmatisch an oder lehnen Sie sie ab.

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)

Beispielprojekte auf GitHub

Das Repository GroupDocs.Comparison Cloud Python Samples enthält sofort ausführbare Beispiele für:

Beispiele ausführen

1. Klonen oder laden Sie das Beispiel-Repository herunter
2. Bearbeiten Sie Examples/RunExamples.py und setzen Sie Ihre client_id und client_secret
3. Wechseln Sie in das Verzeichnis Examples
4. Führen Sie pip install groupdocs-comparison-cloud -U aus
5. Führen Sie python RunExamples.py aus

Für weitere Details besuchen Sie Getting Started.

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