Aceitar-ou-Rejeitar-Alterações

O Microsoft Word oferece um recurso maravilhoso para rastrear alterações e manter revisões de documentos do Word. Como desenvolvedor Python, você pode aceitar ou rejeitar as alterações controladas de documentos do Word (.docx) programaticamente na nuvem. Este artigo se concentrará em como aceitar ou rejeitar alterações rastreadas de um documento do Word usando uma API REST em Python.

Os seguintes tópicos serão abordados neste artigo:

API REST de comparação de documentos e SDK Python

Para trabalhar com revisões, usarei a API Python SDK of GroupDocs.Comparison Cloud. Ele compara dois documentos de formatos de arquivo suportados e encontra diferenças entre eles. Como resultado, ele cria um arquivo resultante contendo diferenças. Ele também permite que você aceite ou rejeite as alterações recuperadas. Você pode integrar facilmente o SDK em seus aplicativos Python existentes. Ele permite que você compare documentos, planilhas, apresentações, diagramas do Microsoft Visio, e-mails e arquivos de muitos outros formatos. Ele também fornece SDKs .NET, Java, PHP, Node.js e Ruby como seus membros da família de comparação de documentos para a Cloud API.

Você pode instalar GroupDocs.Comparison Cloud em seu projeto Python usando o seguinte comando no console:

pip install groupdocs_comparison_cloud

Obtenha seu ID de cliente e Segredo do cliente no painel antes de começar a seguir as etapas e os exemplos de código disponíveis. Depois de ter seu ID e segredo, adicione o código conforme demonstrado abaixo:

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 = ""

Aceitar ou rejeitar alterações rastreadas usando uma API REST em Python

Você pode aceitar ou rejeitar revisões específicas de documentos do Word seguindo as etapas simples mencionadas abaixo:

  1. Carregar os arquivos DOCX para a nuvem
  2. Aceitar ou rejeitar alterações usando Python
  3. Baixar o arquivo resultante

Carregue o Documento

Em primeiro lugar, carregue o documento do Word com as revisões na nuvem usando o exemplo de código abaixo:

# Criar uma instância da 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)

Como resultado, o arquivo DOCX carregado estará disponível na seção de arquivos do seu painel na nuvem.

Aceitar ou rejeitar alterações usando Python

Siga as etapas mencionadas abaixo para aceitar ou rejeitar revisões programaticamente.

  • Crie uma instância de ReviewApi
  • Defina o arquivo .docx de origem
  • Definir ApplyRevisionsOptions
  • Atribuir origem e definir o arquivo de saída
  • Criar GetRevisionsRequest
  • Obtenha revisões chamando o método ReviewApi.get\revisions()
  • Defina a ação de revisão como “Aceitar” ou “Rejeitar” para cada revisão
  • Atribuir revisões atualizadas a ApplyRevisionsOptions
  • Criar ApplyRevisionsRequest
  • Obtenha resultados chamando o método ReviewApi.apply\revisions()

O exemplo de código a seguir mostra como aceitar alterações controladas usando uma API REST.

# Criar uma instância da API
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# Definir arquivo de origem
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)

# Obter todas as contagens de revisões
print("Revisions count: " + str(len(revisions)))

# Aceitar revisões
for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)
Aceitar alterações usando Python

Aceitar alterações usando Python

No caso de rejeitar qualquer alteração, você pode usar o seguinte exemplo de código:

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

Baixe o arquivo resultante

Como resultado, o exemplo de código acima salvará um arquivo DOCX recém-criado com alterações na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:

# inicialização da 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)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(response, "C:\\Files\\")

Aceite ou rejeite todas as alterações usando Python

Siga as etapas mencionadas abaixo para aceitar ou rejeitar todas as alterações de uma vez programaticamente.

  • Crie uma instância de ReviewApi
  • Defina o arquivo .docx de origem
  • Definir ApplyRevisionsOptions
  • Em seguida, atribua a origem e defina o arquivo de saída
  • Defina accept\all como “True” para aceitar todas as alterações
  • Ou defina rejeitar\tudo como “Verdadeiro” para rejeitar todas as alterações
  • Em seguida, atribua revisões atualizadas a ApplyRevisionsOptions
  • Criar ApplyRevisionsRequest
  • Obtenha resultados chamando o método ReviewApi.apply\revisions()

O exemplo de código a seguir mostra como aceitar todas as alterações usando uma API REST. Siga as etapas mencionadas anteriormente para carregar e baixar o arquivo.

# Criar uma instância da API
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# Definir arquivo de origem
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"

# Aceitar todas as revisões
options.accept_all = True   

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

Você pode rejeitar todas as revisões usando o seguinte exemplo de código:

options.reject_all = True

Experimente on-line

Experimente a seguinte ferramenta de comparação de palavras on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/comparison/docx

Conclusão

Neste artigo, você aprendeu como aceitar ou rejeitar alterações controladas de documentos do Microsoft Word na nuvem usando Python. Você também aprendeu como carregar programaticamente o arquivo DOCX na nuvem e, em seguida, baixar o arquivo resultante da nuvem. Você pode aprender mais sobre GroupDocs.Comparison Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para nos contatar no fórum.

Veja também