Tieni traccia delle modifiche in un documento
La funzionalità di tracciamento delle modifiche, nota anche come revisione, ti consente di tenere traccia delle modifiche al contenuto e alla formattazione apportate da te o da altri utenti. Questa funzionalità di tracciamento delle modifiche con Aspose.Words supporta le modifiche di tracciamento in Microsoft Word. Con questa funzionalità, puoi accedere alle singole revisioni del tuo documento e applicare loro diverse proprietà.
Quando abiliti la funzione di tracciamento delle modifiche, tutti gli elementi inseriti, eliminati e modificati del documento verranno evidenziati visivamente con informazioni su chi, quando e cosa è stato modificato. Gli oggetti che contengono informazioni su ciò che è stato modificato sono chiamati “tracciamento delle modifiche”. Ad esempio, supponi di voler rivedere un documento e apportare modifiche importanti: ciò potrebbe significare che è necessario apportare delle revisioni. Inoltre, potrebbe essere necessario inserire commenti per discutere alcune modifiche. È qui che entra in gioco il monitoraggio delle modifiche nei documenti.
Questo articolo spiega come gestire e tenere traccia delle modifiche create da più revisori sullo stesso documento, nonché le proprietà per tenere traccia delle modifiche.
Che cos’è una revisione
Prima di immergerci nelle revisioni, spieghiamo il significato delle revisioni. Un revision è una modifica che avviene in un nodo di un documento mentre un gruppo di revisione, rappresentato dalla classe RevisionGroup, è un gruppo di revisioni sequenziali che si verificano in molti nodi di un documento. Fondamentalmente, la revisione è uno strumento per tenere traccia delle modifiche.
Le revisioni vengono utilizzate nella funzionalità di rilevamento delle modifiche e nella funzionalità di confronto dei documenti, dove le revisioni vengono visualizzate come risultato del confronto. Pertanto, le revisioni all’interno della funzionalità di rilevamento delle modifiche mostrano da chi e cosa è stato modificato.
Aspose.Words supporta diversi tipi di revisione, oltre che in Microsoft Word, come Inserimento, Eliminazione, FormatChange, StyleDefinitionChange e Moving. Tutti i tipi di revisione sono rappresentati con l’enumerazione RevisionType.
Avvia e interrompi il monitoraggio delle modifiche
La modifica di un documento di solito non conta come una revisione finché non inizi a monitorarlo. Aspose.Words ti consente di tenere traccia automaticamente di tutte le modifiche apportate al tuo documento con semplici passaggi. Puoi avviare facilmente il processo di tracciamento delle modifiche utilizzando il metodo StartTrackRevisions. Se è necessario interrompere il processo di tracciamento delle modifiche in modo che eventuali modifiche future non siano considerate revisioni, sarà necessario utilizzare il metodo StopTrackRevisions.
StartTrackingRevisions non modifica lo stato della proprietà TrackRevisions e non utilizza il suo valore ai fini del monitoraggio delle revisioni. Inoltre, se un nodo è stato spostato da una posizione a un’altra all’interno del documento tracciato, verranno create delle revisioni di spostamento, inclusi gli intervalli di spostamento da e di spostamento a.
Al termine del processo di monitoraggio delle modifiche nel tuo documento, avrai la possibilità anche di accettare tutte le revisioni o di rifiutarle per ripristinare il documento nella sua forma originale. Ciò può essere ottenuto utilizzando il metodo AcceptAllRevisions o RejectAll. Inoltre, puoi accettare o rifiutare ciascuna revisione separatamente utilizzando il metodo Accept o Reject.
Tutte le modifiche verranno tracciate per un’iterazione dal momento in cui avvii il processo al momento in cui lo interrompi. La connessione tra le diverse iterazioni è rappresentata dal seguente scenario: si completa il processo di tracciamento, si apportano alcune modifiche e si avvia nuovamente il tracciamento delle modifiche. In questo scenario, tutte le modifiche che non hai accettato o rifiutato verranno nuovamente visualizzate.
AcceptAllRevisions è simile a “Accetta tutte le modifiche” in Microsoft Word.
L’esempio di codice seguente mostra come utilizzare il rilevamento delle modifiche:
Il seguente esempio di codice mostra come vengono generate le revisioni quando un nodo viene spostato all’interno di un documento monitorato:
Gestisci e archivia le modifiche come revisioni
Con la precedente funzionalità di rilevamento delle modifiche, puoi capire quali modifiche sono state apportate al tuo documento e chi le ha apportate. Mentre con la funzione TrackRevisions, imposti che eventuali modifiche all’interno del tuo documento vengano archiviate come revisioni.
Aspose.Words ti consente di verificare se un documento ha una revisione o meno utilizzando la proprietà HasRevision. Se non è necessario tenere traccia automaticamente delle modifiche nel documento tramite i metodi StartTrackRevisions e StopTrackRevisions, è possibile utilizzare la proprietà TrackRevisions per verificare se le modifiche vengono tracciate durante la modifica di un documento in Microsoft Word e archiviate come revisioni.
La funzione TrackRevisions apporta revisioni invece di reali modifiche DOM. Ma le revisioni stesse sono separate. Ad esempio, se elimini un paragrafo, Aspose.Words lo renderà una revisione, contrassegnandolo come eliminazione, invece di eliminarlo.
Inoltre, Aspose.Words consente di verificare se un oggetto è stato inserito, eliminato o modificata la formattazione utilizzando le proprietà IsDeleteRevision, IsFormatRevision, IsInsertRevision, IsMoveFromRevision e IsMoveToRevision.
TrackRevisions. Inoltre, puoi accettare/rifiutare le revisioni indipendentemente dalla funzionalità di rilevamento delle modifiche.
L’esempio di codice seguente mostra come applicare proprietà diverse con revisioni: