Śledź zmiany w dokumencie

Funkcja śledzenia zmian, zwana także przeglądaniem, umożliwia śledzenie zmian w treści i formatowaniu wprowadzonych przez Ciebie lub innych użytkowników. Ta funkcja zmiany ścieżki w formacie Aspose.Words obsługuje zmiany ścieżki w formacie Microsoft Word. Dzięki tej funkcji możesz uzyskać dostęp do poszczególnych wersji dokumentu i zastosować do nich różne właściwości.

Po włączeniu funkcji śledzenia zmian wszystkie wstawione, usunięte i zmodyfikowane elementy dokumentu zostaną wizualnie wyróżnione z informacją o tym, kto, kiedy i co zostały zmienione. Obiekty niosące informację o tym, co zostało zmienione, nazywane są “zmianami śledzącymi”. Załóżmy na przykład, że chcesz przejrzeć dokument i wprowadzić ważne zmiany – może to oznaczać konieczność wprowadzenia poprawek. Może być również konieczne wstawienie komentarzy w celu omówienia niektórych zmian. Tutaj właśnie pojawia się śledzenie zmian w dokumentach.

W tym artykule wyjaśniono, jak zarządzać zmianami wprowadzonymi przez wielu recenzentów w tym samym dokumencie i je śledzić, a także właściwości śledzenia zmian.

Należy pamiętać, że funkcję komentowania w formacie Aspose.Words, a także Microsoft Word można powiązać ze śledzeniem zmian. Pamiętaj jednak, że komentarze są całkowicie niezależne od śledzenia zmian.

Co to jest rewizja

Zanim zagłębimy się w wersje, wyjaśnijmy znaczenie wersji. revision to zmiana zachodząca w jednym węźle dokumentu, natomiast grupa wersji reprezentowana przez klasę RevisionGroup to grupa kolejnych wersji, które występują w wielu węzłach dokumentu. Zasadniczo wersja jest narzędziem do śledzenia zmian.

Wersje są wykorzystywane w funkcji śledzenia zmian oraz w funkcji porównywania dokumentów, gdzie poprawki pojawiają się w wyniku porównania. Zatem poprawki w ramach funkcji śledzenia zmian pokazują, kto i co zostało zmienione.

Należy pamiętać, że Microsoft Word nie pozwala na przeglądanie pojedynczych wersji, pozwala jedynie na przeglądanie kolejnych wersji jako pojedynczej całości. Ale Aspose.Words rozwiązuje to ograniczenie za pomocą klasy RevisionGroup.

Aspose.Words obsługuje różne typy wersji, a także Microsoft Word, takie jak Wstawianie, Usuwanie, FormatChange, StyleDefinitionChange i Przenoszenie. Wszystkie typy wersji są reprezentowane za pomocą wyliczenia RevisionType.

Należy pamiętać, że poprawki dają wynik podobny do Microsoft Word, ale Aspose.Words nie wykrywa formatowania podczas śledzenia zmian.

Rozpocznij i zatrzymaj śledzenie zmian

Edytowanie dokumentu zwykle nie liczy się jako wersja, dopóki nie zaczniesz go śledzić. Aspose.Words umożliwia automatyczne śledzenie wszystkich zmian w dokumencie za pomocą prostych kroków. Proces śledzenia zmian możesz łatwo rozpocząć wykorzystując metodę StartTrackRevisions. Jeśli chcesz zatrzymać proces śledzenia zmian, aby przyszłe zmiany nie były traktowane jako poprawki, będziesz musiał użyć metody StopTrackRevisions.

Należy pamiętać, że metoda StartTrackingRevisions nie zmienia statusu właściwości TrackRevisions i nie wykorzystuje jej wartości w celu śledzenia wersji. Ponadto, jeśli węzeł został przeniesiony z jednej lokalizacji do drugiej w śledzonym dokumencie, zostaną utworzone wersje przeniesienia, obejmujące przesunięcie z i przesunięcie do zakresu.

Pod koniec procesu śledzenia zmian w dokumencie będziesz mieć możliwość zaakceptowania wszystkich poprawek lub odrzucenia ich, aby przywrócić dokument do pierwotnej formy. Można to osiągnąć za pomocą metody AcceptAllRevisions lub RejectAll. Ponadto możesz zaakceptować lub odrzucić każdą wersję z osobna, korzystając z metody Accept lub Reject.

Wszystkie zmiany będą śledzone przez jedną iterację od momentu rozpoczęcia procesu do momentu jego zatrzymania. Połączenie między różnymi iteracjami przedstawiono w następującym scenariuszu: kończysz proces śledzenia, następnie wprowadzasz pewne zmiany i ponownie rozpoczynasz śledzenie zmian. W tym scenariuszu wszystkie zmiany, których nie zaakceptowałeś lub odrzuciłeś, zostaną wyświetlone ponownie.

Należy pamiętać, że metoda AcceptAllRevisions jest podobna do metody “Zaakceptuj wszystkie zmiany” w formacie Microsoft Word.

Poniższy przykład kodu pokazuje, jak pracować ze śledzeniem zmian:

Poniższy przykład kodu pokazuje, w jaki sposób generowane są poprawki, gdy węzeł jest przenoszony w śledzonym dokumencie:

Zarządzaj zmianami i przechowuj je jako wersje

Dzięki poprzedniej funkcji śledzenia zmian możesz dowiedzieć się, jakie zmiany zostały wprowadzone w dokumencie i kto je wprowadził. Korzystając z funkcji TrackRevisions, wymuszasz zapisanie wszelkich zmian w dokumencie jako wersji.

Aspose.Words pozwala sprawdzić, czy dokument ma wersję, czy nie, za pomocą właściwości HasRevision. Jeśli nie musisz automatycznie śledzić zmian w dokumencie za pomocą metod StartTrackRevisions i StopTrackRevisions, możesz użyć właściwości TrackRevisions, aby sprawdzić, czy zmiany są śledzone podczas edycji dokumentu w Microsoft Word i przechowywane jako wersje.

Funkcja TrackRevisions wprowadza poprawki zamiast rzeczywistych zmian DOM. Ale same poprawki są odrębne. Na przykład, jeśli usuniesz dowolny akapit, plik Aspose.Words uczyni go poprawką, zaznaczając go jako usunięty, zamiast go usuwać.

Ponadto Aspose.Words umożliwia sprawdzenie, czy obiekt został wstawiony, usunięty lub zmienione formatowanie przy użyciu właściwości IsDeleteRevision, IsFormatRevision, IsInsertRevision, IsMoveFromRevision i IsMoveToRevision.

Należy pamiętać, że nie ma żadnego połączenia pomiędzy samymi wersjami a właściwością TrackRevisions. Ponadto możesz akceptować/odrzucać poprawki niezależnie od funkcji śledzenia zmian.

Poniższy przykład kodu pokazuje, jak zastosować różne właściwości w wersjach: