Suivre les modifications dans un document
La fonctionnalité de suivi des modifications, également appelée révision, vous permet de suivre les modifications apportées au contenu et au formatage effectuées par vous ou d’autres utilisateurs. Cette fonctionnalité de suivi des modifications avec Aspose.Words prend en charge le suivi des modifications dans Microsoft Word. Avec cette fonctionnalité, vous pouvez accéder aux révisions individuelles de votre document et leur appliquer différentes propriétés.
Lorsque vous activez la fonction de suivi des modifications, tous les éléments insérés, supprimés et modifiés du document seront visuellement mis en évidence avec des informations sur par qui, quand et ce qui a été modifié. Les objets qui contiennent des informations sur ce qui a été modifié sont appelés “suivi des modifications”. Par exemple, supposons que vous souhaitiez réviser un document et apporter des modifications importantes – cela peut signifier que vous devez apporter des révisions. Vous devrez peut-être également insérer des commentaires pour discuter de certains changements. C’est là qu’intervient le suivi des modifications apportées aux documents.
Cet article explique comment gérer et suivre les modifications créées par de nombreux réviseurs sur le même document, ainsi que les propriétés de suivi des modifications.
Qu’est-ce qu’une révision
Avant de plonger dans les révisions, expliquons la signification des révisions. Un Revision est une modification qui se produit dans un nœud d’un document tandis qu’un groupe de révisions, représenté par la classe RevisionGroup, est un groupe de révisions séquentielles qui se produisent dans plusieurs nœuds d’un document. Fondamentalement, la révision est un outil de suivi des modifications.
Les révisions sont utilisées dans la fonctionnalité de suivi des modifications et dans la fonctionnalité de comparaison de documents, où les révisions apparaissent à la suite d’une comparaison. Ainsi, les révisions au sein de la fonctionnalité de suivi des modifications montrent par qui et ce qui a été modifié.
Aspose.Words prend en charge différents types de révision, ainsi qu’en Microsoft Word, tels que l’insertion, la suppression, le changement de format, le changement de style et le déplacement. Tous les types de révision sont représentés par l’énumération RevisionType.
Démarrer et arrêter le suivi des modifications
La modification d’un document ne compte généralement pas comme une révision jusqu’à ce que vous commenciez à en suivre le suivi. Aspose.Words vous permet de suivre automatiquement toutes les modifications apportées à votre document en quelques étapes simples. Vous pouvez facilement démarrer le processus de suivi des modifications en utilisant la méthode start_track_revisions. Si vous devez arrêter le processus de suivi des modifications afin que les modifications futures ne soient pas considérées comme des révisions, vous devrez utiliser la méthode stop_track_revisions.
À la fin du processus de suivi des modifications dans votre document, vous aurez même la possibilité d’accepter toutes les révisions ou de les rejeter pour rétablir le document dans sa forme originale. Ceci peut être réalisé en utilisant la méthode accept_all_revisions ou reject_all. De plus, vous pouvez accepter ou rejeter chaque révision séparément en utilisant la méthode accept ou reject.
Toutes les modifications seront suivies pendant une itération à partir du moment où vous démarrez le processus jusqu’au moment où vous l’arrêtez. La connexion entre les différentes itérations est représentée comme le scénario suivant: vous terminez le processus de suivi, puis apportez quelques modifications et recommencez le suivi des modifications. Avec ce scénario, toutes les modifications que vous n’avez pas acceptées ou refusées seront à nouveau affichées.
L’exemple de code suivant montre comment utiliser le suivi des modifications:
L’exemple de code suivant montre comment les révisions sont générées lorsqu’un nœud est déplacé dans un document suivi:
Gérer et stocker les modifications en tant que révisions
Avec la fonctionnalité de suivi des modifications précédente, vous pouvez comprendre quelles modifications ont été apportées à votre document et qui a effectué ces modifications. Avec la fonctionnalité track_revisions, vous forcez le stockage de toutes les modifications apportées à votre document en tant que révisions.
Aspose.Words vous permet de vérifier si un document a une révision ou non en utilisant la propriété has_revision. Si vous n’avez pas besoin de suivre automatiquement les modifications dans votre document via les méthodes start_track_revisions et stop_track_revisions, vous pouvez utiliser la propriété track_revisions pour vérifier si les modifications sont suivies lors de la modification d’un document au format Microsoft Word et stockées en tant que révisions.
La fonctionnalité track_revisions effectue des révisions au lieu de véritables modifications DOM. Mais les révisions elles-mêmes sont distinctes. Par exemple, si vous supprimez un paragraphe, Aspose.Words en fait une révision, le marquant comme suppression, au lieu de le supprimer.
De plus, Aspose.Words vous permet de vérifier si un objet a été inséré, supprimé ou modifié au formatage à l’aide des propriétés is_delete_revision, is_format_revision, is_insert_revision, is_move_from_revision et is_move_to_revision.
L’exemple de code suivant montre comment appliquer différentes propriétés avec des révisions: