Rastrear mudanças em um documento

A funcionalidade de mudanças de faixa, também conhecida como revisão, permite que você rastreie mudanças no conteúdo e formatação feitas por você ou outros usuários. Este recurso de alterações de faixa com Aspose.Words suporta mudanças de faixa em Microsoft Word. Com essa funcionalidade, você pode acessar revisões individuais em seu documento e aplicar diferentes propriedades a elas.

Quando você ativar o recurso de alterações de faixa, todos os elementos inseridos, excluídos e modificados do documento serão visualmente destacados com informações sobre quem, quando e o que foi alterado. Objetos que carregam informações sobre o que foi alterado são chamados de “mudanças de rastreamento”. Por exemplo, assuma que você deseja rever um documento e fazer mudanças importantes – isso pode significar que você precisa fazer revisões. Além disso, você pode precisar inserir comentários para discutir algumas das mudanças. É aí que entram as mudanças de rastreamento nos documentos.

Este artigo explica como gerenciar e rastrear mudanças criadas por muitos revisores no mesmo documento, bem como as propriedades para rastreamento de mudanças.

Note que o recurso de comentário em Aspose.Words, bem como em Microsoft Word, pode estar associado a mudanças de rastreamento. No entanto, lembre-se de que os comentários são completamente independentes das mudanças de rastreamento.

O que é uma revisão

Antes de mergulhar em revisões, vamos explicar o significado de revisões. A revision é uma mudança que ocorre em um nó de um documento enquanto um grupo de revisão, representado pelo RevisionGroup classe, é um grupo de revisões sequenciais que ocorrem em muitos nós de um documento. A revisão é uma ferramenta para rastrear mudanças.

As revisões são usadas no recurso de alterações de rastreamento e dentro do recurso de documentos de comparação, onde as revisões aparecem como resultado da comparação. Assim, as revisões dentro do recurso de alterações de rastreamento mostram por quem e o que foi alterado.

Note que Microsoft Word não permite que você visualize revisões individuais, ele só permite que você veja revisões sequenciais como uma única entidade. Mas… Aspose.Words resolve esta limitação com a RevisionGroup classe.

Aspose.Words suporta diferentes tipos de revisão, bem como em Microsoft Word, como inserção, exclusão, formato Mudança, definição de estilo Mudar e mover. Todos os tipos de revisão são representados com RevisionType enumeração.

Note que as revisões têm um resultado semelhante ao Microsoft Word mas… Aspose.Words não detecta formatação durante as mudanças de rastreamento.

Comece e pare de rastrear mudanças

Editar um documento normalmente não conta como uma revisão até começar a rastreá-lo. Aspose.Words permite rastrear automaticamente todas as alterações no seu documento com passos simples. Você pode facilmente iniciar o processo de rastreamento de alterações usando o StartTrackRevisions método. Se você precisar parar o processo de rastreamento de alterações para que quaisquer edições futuras não sejam consideradas revisões, você precisará usar o StopTrackRevisions método.

Note que o StartTrackingRevisions método não altera o status do TrackRevisions propriedade e não usa seu valor para o objetivo de rastreamento de revisão. Além disso, se um nó foi movido de um local para outro dentro do documento rastreado, então as revisões serão criadas, incluindo mover-de e mover-para o intervalo.

No final do processo de rastreamento de alterações em seu documento, você terá a capacidade de até aceitar todas as revisões ou rejeitá-las para reverter o documento para sua forma original. Isso pode ser alcançado usando o AcceptAllRevisions ou RejectAll método. Além disso, você pode aceitar ou rejeitar cada revisão separadamente usando o Accept ou Reject método.

Todas as mudanças serão rastreadas para uma iteração desde o momento em que você iniciar o processo até o momento em que você parar. A conexão entre diferentes iterações é representada como o seguinte cenário: você completa o processo de rastreamento, em seguida, fazer algumas mudanças e começar a rastrear mudanças novamente. Com este cenário, todas as mudanças que você não aceitou ou rejeitar serão exibidas novamente.

Note que o AcceptAllRevisions método é semelhante ao “Aceitar todas as mudanças” em Microsoft Word.

O exemplo a seguir mostra como trabalhar com mudanças de rastreamento:

O exemplo de código a seguir mostra como as revisões são geradas quando um nó é movido dentro de um documento rastreado:

Gerenciar e armazenar alterações como Revisões

Com o recurso de alterações de rastreamento anterior, você pode entender quais mudanças foram feitas em seu documento e quem fez essas mudanças. Enquanto com o TrackRevisions recurso, você força quaisquer alterações dentro do seu documento a serem armazenadas como revisões.

Aspose.Words permite verificar se um documento tem uma revisão ou não usando o HasRevision propriedade. Se você não precisa rastrear automaticamente as alterações em seu documento através dos métodos StartTrackRevisions e StopTrackRevisions, então você pode usar o TrackRevisions propriedade para verificar se as alterações são rastreadas ao editar um documento Microsoft Word e armazenado como revisões.

O TrackRevisions recurso faz revisões em vez de real DOM mudanças. Mas as próprias revisões são separadas. Por exemplo, Se você excluir qualquer parágrafo, Aspose.Words torná-lo como uma revisão, marcando-o como exclusão, em vez de deletá-lo.

Além disso, Aspose.Words permite verificar se um objeto foi inserido, excluído ou alterado formatação usando o IsDeleteRevision, IsFormatRevision, IsInsertRevision, IsMoveFromRevision, e IsMoveToRevision propriedades.

Note que não há conexão entre as próprias revisões e as TrackRevisions propriedade. Além disso, você pode aceitar / rejeitar revisões, independentemente do recurso de alterações de rastreamento.

O exemplo de código a seguir mostra como aplicar diferentes propriedades com revisões: