Přijměte-nebo-odmítněte-změny

Microsoft Word nabízí skvělou funkci pro sledování změn a uchovávání revizí dokumentů aplikace Word. Jako vývojář Pythonu můžete přijímat nebo odmítat sledované změny dokumentů Word (.docx) programově v cloudu. Tento článek se zaměří na to, jak přijmout nebo odmítnout sledované změny dokumentu Word pomocí REST API v Pythonu.

V tomto článku se budou zabývat následujícími tématy:

Porovnání dokumentů REST API a Python SDK

Pro práci s revizemi budu používat Python SDK of GroupDocs.Comparison Cloud API. Porovnává dva dokumenty podporovaných formátů souborů a najde mezi nimi rozdíly. V důsledku toho vytvoří výsledný soubor obsahující rozdíly. Umožňuje vám také přijmout nebo odmítnout načtené změny. SDK můžete snadno integrovat do svých stávajících aplikací Pythonu. Umožňuje vám porovnávat dokumenty, tabulky, prezentace, diagramy aplikace Microsoft Visio, e-maily a soubory mnoha dalších formátů. Poskytuje také sady .NET, Java, PHP, Node.js a Ruby SDK jako členové rodiny porovnávání dokumentů pro Cloud API.

GroupDocs.Comparison Cloud můžete nainstalovat do svého projektu Python pomocí následujícího příkazu v konzole:

pip install groupdocs_comparison_cloud

Než začnete postupovat podle kroků a dostupných příkladů kódu, získejte své ID klienta a tajný klíč klienta z dashboard. Jakmile budete mít své ID a tajemství, přidejte kód, jak je ukázáno níže:

client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"

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

Přijměte nebo odmítněte sledované změny pomocí REST API v Pythonu

Můžete přijmout nebo odmítnout konkrétní revize dokumentů aplikace Word podle jednoduchých kroků uvedených níže:

  1. Nahrajte soubory DOCX do cloudu
  2. Přijmout nebo odmítnout změny pomocí Pythonu
  3. Stáhnout výsledný soubor

Nahrajte dokument

Nejprve nahrajte dokument Word s revizemi do cloudu pomocí příkladu kódu uvedeného níže:

# Vytvořte instanci rozhraní API
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)

request = groupdocs_comparison_cloud.UploadFileRequest("source_with_revs.docx", "C:\\Files\\source_with_revs.docx", "")
response = file_api.upload_file(request)

V důsledku toho bude nahraný soubor DOCX dostupný v sekce souborů vašeho řídicího panelu v cloudu.

Přijměte nebo odmítněte změny pomocí Pythonu

Chcete-li programově přijmout nebo odmítnout revize, postupujte podle níže uvedených kroků.

  • Vytvořte instanci ReviewApi
  • Nastavte zdrojový soubor .docx
  • Definujte ApplyRevisionsOptions
  • Přiřadit zdroj a nastavit výstupní soubor
  • Vytvořte GetRevisionsRequest
  • Získejte revize voláním metody ReviewApi.get\revisions()
  • Nastavte akci revize na “Přijmout” nebo “Odmítnout” pro každou revizi
  • Přiřaďte aktualizované revize k ApplyRevisionsOptions
  • Vytvořte ApplyRevisionsRequest
  • Výsledky získáte voláním metody ReviewApi.apply\revisions()

Následující příklad kódu ukazuje, jak přijmout sledované změny pomocí REST API.

# Vytvořte instanci rozhraní API
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# Nastavit zdrojový soubor
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"

options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

request = groupdocs_comparison_cloud.GetRevisionsRequest(options)
revisions = api_instance.get_revisions(request)

# Získejte počet všech revizí
print("Revisions count: " + str(len(revisions)))

# Přijmout revize
for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)
Přijměte změny pomocí Pythonu

Přijměte změny pomocí Pythonu

V případě odmítnutí jakýchkoli změn můžete použít následující příklad kódu:

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

Stáhněte si výsledný soubor

Výsledkem je, že výše uvedený příklad kódu uloží nově vytvořený soubor DOCX se změnami v cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:

# Inicializace API
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)

request = groupdocs_comparison_cloud.DownloadFileRequest("output\\result.docx", my_storage)
response = file_api.download_file(request)

# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\")

Přijměte nebo odmítněte všechny změny pomocí Pythonu

Chcete-li programově přijmout nebo odmítnout všechny změny najednou, postupujte podle níže uvedených kroků.

  • Vytvořte instanci ReviewApi
  • Nastavte zdrojový soubor .docx
  • Definujte ApplyRevisionsOptions
  • Poté přiřaďte zdroj a nastavte výstupní soubor
  • Pro přijetí všech změn nastavte accept\all na “True”.
  • Nebo nastavte odmítnout\vše na “True” pro odmítnutí všech změn
  • Potom přiřaďte aktualizované revize k ApplyRevisionsOptions
  • Vytvořte ApplyRevisionsRequest
  • Získejte výsledky voláním metody ReviewApi.apply\revisions()

Následující příklad kódu ukazuje, jak přijmout všechny změny pomocí REST API. Při nahrání a stažení souboru postupujte podle výše uvedených kroků.

# Vytvořte instanci rozhraní API
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# Nastavit zdrojový soubor
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"

options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

# Přijměte všechny revize
options.accept_all = True   

request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)

Všechny revize můžete odmítnout pomocí následujícího příkladu kódu:

options.reject_all = True

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatný online porovnávací nástroj Word, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/comparison/docx

Závěr

V tomto článku jste se naučili, jak přijmout nebo odmítnout sledované změny dokumentů Microsoft Word v cloudu pomocí Pythonu. Také jste se naučili, jak programově nahrát soubor DOCX do cloudu a následně stáhnout výsledný soubor z cloudu. Více o GroupDocs.Comparison Cloud API se můžete dozvědět pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na fóru.

Viz také