文書内の変更を追跡する

変更履歴の機能(レビューとも呼ばれます)を使用すると、自分や他のユーザーが行ったコンテンツや書式設定の変更を追跡できます。 Aspose.Wordsのこのトラック変更機能はMicrosoft Wordのトラック変更をサポートします。この機能を使用すると、ドキュメント内の個々のリビジョンにアクセスし、それらに異なるプロパティを適用できます。

変更の追跡機能を有効にすると、文書の挿入、削除、および変更されたすべての要素が、誰が、いつ、何が変更されたかに関する情報で視覚的に強調表示さ何が変更されたかに関する情報を保持するオブジェクトは、“変更の追跡"と呼ばれます。たとえば、文書を確認して重要な変更を加えるとします。また、いくつかの変更について議論するためにコメントを挿入する必要がある場合があります。ここで、文書の変更を追跡することができます。

この記事では、同じ文書で多くの査読者が作成した変更を管理および追跡する方法と、変更を追跡するためのプロパティについて説明します。

Aspose.WordsとMicrosoft Wordのコメント機能は、変更の追跡に関連付けることができることに注意してください。ただし、コメントは変更の追跡とは完全に独立していることに注意してください。

リビジョンとは何ですか

リビジョンに飛び込む前に、リビジョンの意味を説明しましょう。 revisionはドキュメントの1つのノードで発生する変更ですが、RevisionGroupクラスで表されるリビジョングループは、ドキュメントの多くのノードで発生する連続した基本的に、リビジョンは変更を追跡するためのツールです。

リビジョンは、変更の追跡機能およびドキュメントの比較機能内で使用され、比較の結果としてリビジョンが表示されます。そのため、変更の追跡機能内のリビジョンには、誰が何を変更したかが表示されます。

Microsoft Wordでは個々のリビジョンを表示することはできず、連続したリビジョンを単一のエンティティとして表示するだけであることに注意してくださしかし、Aspose.WordsはRevisionGroupクラスでこの制限を解決します。

Aspose.Wordsは、挿入、削除、FormatChange、StyleDefinitionChange、移動など、Microsoft Wordと同様に、さまざまなリビジョンタイプをサポートします。すべてのリビジョンの種類はRevisionType列挙体で表されます。

リビジョンの結果はMicrosoft Wordに似ていますが、Aspose.Wordsは変更の追跡中に書式設定を検出しないことに注意してください。

変更の追跡の開始と停止

通常、文書を編集しても、追跡を開始するまではリビジョンとしてカウントされません。 Aspose.Words簡単な手順で文書内のすべての変更を自動的に追跡できます。 StartTrackRevisionsメソッドを使用すると、変更を追跡するプロセスを簡単に開始できます。今後の編集がリビジョンと見なされないように変更の追跡プロセスを停止する必要がある場合は、StopTrackRevisionsメソッドを使用する必要があります。

StartTrackingRevisionsメソッドはTrackRevisionsプロパティのステータスを変更せず、リビジョン追跡の目的でその値を使用しないことに注意してください。さらに、ノードが追跡されたドキュメント内のある場所から別の場所に移動された場合、移動元と移動先の範囲を含む移動リビジョンが作成されます。

文書の変更の追跡プロセスの最後に、すべてのリビジョンを承認したり、文書を元の形式に戻すために拒否したりすることもできます。これは、AcceptAllRevisionsまたはRejectAllメソッドを使用することで実現できます。また、AcceptまたはRejectメソッドを使用して、各リビジョンを個別に承認または拒否することができます。

すべての変更は、プロセスを開始した瞬間から停止した瞬間まで、1回の反復で追跡されます。追跡プロセスを完了し、いくつかの変更を加えてから、変更の追跡を再度開始します。このシナリオでは、受け入れなかった、または拒否しなかったすべての変更が再び表示されます。

AcceptAllRevisionsメソッドはMicrosoft Wordの"すべての変更を受け入れる"に似ていることに注意してください。

次のコード例は、変更の追跡を操作する方法を示しています:

次のコード例は、追跡されたドキュメント内でノードが移動されたときにリビジョンが生成される方法を示しています:

変更をリビジョンとして管理および保存する

以前の変更の追跡機能を使用すると、ドキュメントで行われた変更と、それらの変更を行ったユーザーを理解できます。 TrackRevisions機能を使用している間は、ドキュメント内の変更を強制的にリビジョンとして保存します。

Aspose.Wordsは、HasRevisionプロパティを使用して、文書にリビジョンがあるかどうかを確認できます。 StartTrackRevisionsおよびStopTrackRevisionsメソッドを使用して文書の変更を自動的に追跡する必要がない場合は、TrackRevisionsプロパティを使用して、Microsoft Word内の文書の編集中に変更が追跡され、リビジョンとして保存されているかどうかを確認できます。

TrackRevisions機能は、実際のDOMの変更の代わりにリビジョンを作成します。しかし、改訂自体は別々です。たとえば、段落を削除した場合、Aspose.Wordsはその段落を削除するのではなく、リビジョンとして作成し、削除としてマークします。

さらに、Aspose.Wordsを使用すると、オブジェクトが挿入、削除、または書式設定の変更されたかどうかを確認できます。IsDeleteRevision, IsFormatRevision, IsInsertRevision, IsMoveFromRevision, とIsMoveToRevisionプロパティ。

リビジョン自体とTrackRevisionsプロパティとの間には関係がないことに注意してください。また、変更の追跡機能に関係なく、リビジョンを承認/拒否することができます。

次のコード例は、リビジョンでさまざまなプロパティを適用する方法を示しています:

C++でのコメントの操作 C++での図形の操作