Acompanhar alterações num documento

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

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

Este artigo explica como gerir e acompanhar as alterações criadas por muitos revisores no mesmo documento, bem como as propriedades para acompanhar as alterações.

O que é uma revisão

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

As revisões são utilizadas na funcionalidade acompanhar alterações e na funcionalidade comparar documentos, em que as revisões aparecem como resultado da comparação. Portanto, as revisões no recurso de rastreamento de alterações mostram por quem e o que foi alterado.

Aspose.Words suporta diferentes tipos de revisão, bem como em Microsoft Word, Como inserção, exclusão, FormatChange, StyleDefinitionChange e movimentação. Todos os tipos de revisão são representados com a enumeração RevisionType.

Iniciar e parar o acompanhamento das alterações

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

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

Todas as alterações serão rastreadas para uma iteração, desde o momento em que você inicia o processo até o momento em que o interrompe. A conexão entre diferentes iterações é representada como o seguinte cenário: você conclui o processo de Rastreamento, faz algumas alterações e começa a rastrear as alterações novamente. Com esse cenário, todas as alterações que você não aceitou ou rejeitou serão exibidas novamente.

O exemplo de código a seguir mostra como trabalhar com o rastreamento de alterações:

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

Gerir e armazenar alterações como revisões

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

Aspose.Words permite verificar se um documento tem uma revisão ou não utilizando a propriedade HasRevision. Se você não precisar rastrear automaticamente as alterações em seu documento por meio dos métodos StartTrackRevisions e StopTrackRevisions, poderá usar a propriedade TrackRevisions para verificar se as alterações são rastreadas durante a edição de um documento em Microsoft Word e armazenadas como revisões.

O recurso TrackRevisions faz revisões em vez de alterações reais DOM. Mas as revisões em si são separadas. Por exemplo, se você excluir qualquer parágrafo, Aspose.Words Faça-o como uma revisão, marcando-o como exclusão, em vez de excluí-lo.

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

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