Theo dõi các thay đổi trong tài liệu
Chức năng theo dõi các thay đổi, còn được gọi là xem lại, cho phép bạn theo dõi các thay đổi về nội dung và định dạng do bạn hoặc những người dùng khác thực hiện. Tính năng thay đổi bản nhạc này với Aspose.Words hỗ trợ thay đổi bản nhạc trong Microsoft Word. Với chức năng này, bạn có thể truy cập các bản sửa đổi riêng lẻ trong tài liệu của mình và áp dụng các thuộc tính khác nhau cho chúng.
Khi bạn bật tính năng thay đổi theo dõi, tất cả các thành phần được chèn, xóa và sửa đổi của tài liệu sẽ được làm nổi bật trực quan với thông tin về ai, khi nào và những gì đã được thay đổi. Các đối tượng mang thông tin về những gì đã được thay đổi được gọi là “theo dõi các thay đổi”. Ví dụ: giả sử bạn muốn xem lại tài liệu và thực hiện các thay đổi quan trọng – điều này có thể có nghĩa là bạn cần thực hiện các sửa đổi. Ngoài ra, bạn có thể cần chèn bình luận để thảo luận về một số thay đổi. Đó là nơi phát huy tác dụng của việc theo dõi những thay đổi trong tài liệu.
Bài viết này giải thích cách quản lý và theo dõi các thay đổi được tạo bởi nhiều người đánh giá trên cùng một tài liệu, cũng như các thuộc tính để theo dõi các thay đổi.
Bản sửa đổi là gì
Trước khi đi sâu vào các bản sửa đổi, hãy giải thích ý nghĩa của các bản sửa đổi. Revision là một thay đổi xảy ra trong một nút của tài liệu trong khi nhóm sửa đổi, được biểu thị bằng lớp RevisionGroup, là một nhóm các bản sửa đổi tuần tự xảy ra trong nhiều nút của tài liệu. Về cơ bản, sửa đổi là một công cụ để theo dõi các thay đổi.
Các bản sửa đổi được sử dụng trong tính năng theo dõi các thay đổi và trong tính năng so sánh tài liệu, trong đó các bản sửa đổi xuất hiện do so sánh. Vì vậy, các sửa đổi trong tính năng theo dõi thay đổi sẽ hiển thị ai và nội dung nào đã được thay đổi.
Aspose.Words hỗ trợ các loại sửa đổi khác nhau, cũng như trong Microsoft Word, chẳng hạn như Chèn, Xóa, Thay đổi định dạng, Thay đổi định nghĩa kiểu và Di chuyển. Tất cả các loại sửa đổi được thể hiện bằng bảng liệt kê RevisionType.
Bắt đầu và dừng theo dõi thay đổi
Việc chỉnh sửa tài liệu thường không được tính là bản sửa đổi cho đến khi bạn bắt đầu theo dõi nó. Aspose.Words cho phép bạn tự động theo dõi tất cả các thay đổi trong tài liệu của mình bằng các bước đơn giản. Bạn có thể dễ dàng bắt đầu quá trình theo dõi các thay đổi bằng cách sử dụng phương pháp start_track_revisions. Nếu bạn cần dừng quá trình theo dõi các thay đổi để mọi chỉnh sửa trong tương lai không được coi là bản sửa đổi, bạn sẽ cần sử dụng phương pháp stop_track_revisions.
Khi kết thúc quá trình theo dõi các thay đổi trong tài liệu của bạn, bạn thậm chí sẽ có khả năng chấp nhận tất cả các bản sửa đổi hoặc từ chối chúng để hoàn nguyên tài liệu về dạng ban đầu. Điều này có thể đạt được bằng cách sử dụng phương pháp accept_all_revisions hoặc reject_all. Ngoài ra, bạn có thể chấp nhận hoặc từ chối từng bản sửa đổi riêng biệt bằng cách sử dụng phương pháp accept hoặc reject.
Tất cả các thay đổi sẽ được theo dõi trong một lần lặp từ thời điểm bạn bắt đầu quá trình cho đến thời điểm bạn dừng nó. Kết nối giữa các lần lặp khác nhau được thể hiện dưới dạng kịch bản sau: bạn hoàn tất quy trình theo dõi, sau đó thực hiện một số thay đổi và bắt đầu theo dõi lại các thay đổi. Với kịch bản này, tất cả những thay đổi mà bạn không chấp nhận hoặc từ chối sẽ được hiển thị lại.
Ví dụ về mã sau đây cho thấy cách làm việc với các thay đổi theo dõi:
Ví dụ mã sau đây cho thấy cách tạo ra các bản sửa đổi khi một nút được di chuyển trong tài liệu được theo dõi:
Quản lý và lưu trữ các thay đổi dưới dạng bản sửa đổi
Với tính năng theo dõi các thay đổi trước đó, bạn có thể hiểu những thay đổi nào đã được thực hiện trong tài liệu của mình và ai đã thực hiện những thay đổi đó. Trong khi với tính năng track_revisions, bạn buộc mọi thay đổi trong tài liệu của mình phải được lưu trữ dưới dạng bản sửa đổi.
Aspose.Words cho phép bạn kiểm tra xem tài liệu có bản sửa đổi hay không bằng cách sử dụng thuộc tính has_revision. Nếu bạn không cần tự động theo dõi các thay đổi trong tài liệu của mình thông qua các phương thức start_track_revisions và stop_track_revisions thì bạn có thể sử dụng thuộc tính track_revisions để kiểm tra xem các thay đổi có được theo dõi trong khi chỉnh sửa tài liệu trong Microsoft Word và được lưu dưới dạng bản sửa đổi hay không.
Tính năng track_revisions thực hiện các sửa đổi thay vì thay đổi DOM thực sự. Nhưng bản thân các sửa đổi là riêng biệt. Ví dụ: Nếu bạn xóa bất kỳ đoạn nào, Aspose.Words sẽ coi đoạn đó là bản sửa đổi, đánh dấu đoạn đó là đoạn đã xóa thay vì xóa đoạn đó.
Ngoài ra, Aspose.Words cho phép bạn kiểm tra xem một đối tượng có được chèn, xóa hoặc thay đổi định dạng hay không bằng cách sử dụng các thuộc tính is_delete_revision, is_format_revision, is_insert_revision, is_move_from_revision và is_move_to_revision.
Ví dụ mã sau đây cho thấy cách áp dụng các thuộc tính khác nhau với các bản sửa đổi: