Ś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ę start_track_revisions. Jeśli chcesz zatrzymać proces śledzenia zmian, aby przyszłe zmiany nie były traktowane jako poprawki, będziesz musiał użyć metody stop_track_revisions.

Należy pamiętać, że metoda start_track_revisions nie zmienia statusu właściwości track_revisions 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 accept_all_revisions lub reject_all. 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 accept_all_revisions 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 track_revisions, wymuszasz zapisanie wszelkich zmian w dokumencie jako wersji.

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

Funkcja track_revisions 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 is_delete_revision, is_format_revision, is_insert_revision, is_move_from_revision i is_move_to_revision.

Należy pamiętać, że nie ma żadnego połączenia pomiędzy samymi wersjami a właściwością track_revisions. 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: