Revisions

Revisions

이 가이드는 Aspose.Words FOSS for .NET를 사용하여 Word 문서에서 추적된 변경 사항을 검사하고, 수락하고, 거부하며, 기록하는 방법을 보여줍니다. Aspose.Words FOSS for .NET는 Document.Revisions를 통해 Word 문서의 추적된 변경 사항(리비전)을 검사하고, 수락하며, 거부할 수 있으며, Document.StartTrackRevisions()/StopTrackRevisions()를 사용하여 편집 중에 새로운 추적된 변경 사항을 기록할 수 있습니다.


추적된 변경 사항 읽기

Document.Revisions은(는) 문서 내 모든 Revision의 RevisionCollection을 반환합니다; Range.Revisions은(는) 이를 특정 범위로 한정합니다. 각 Revision는 변경을 수행한 사람과 시점(Author, DateTime), 변경 종류(RevisionType: Insertion, Deletion, FormatChange, StyleDefinitionChange, 또는 Moving), 적용 위치(ParentNode, ParentStyle)를 보고합니다. Document.HasRevisions는 로드된 문서에 추적된 변경 사항이 전혀 있는지 여부를 미리 알려줍니다.


수정 사항 수락 및 거부

단일 추적된 변경을 해결하려면 Revision.Accept() 또는 Revision.Reject()을 호출하고, 전체 컬렉션을 한 번에 처리하려면 RevisionCollection.AcceptAll() / RejectAll()을 사용합니다. Document.AcceptAllRevisions()는 문서 수준에서 한 번의 호출로 모든 수정 사항을 수락하는 편의 기능입니다. 선택적으로 일부만 수락하거나 거부하려면 IRevisionCriteria.IsMatch(revision)를 구현하고 이를 RevisionCollection.Accept(criteria) 또는 Reject(criteria)에 전달하십시오.


수정 그룹

동일한 작성자이며 동일한 유형의 연속적인 수정은 RevisionGroup 로 함께 표시됩니다 — 단일 수정에 대해서는 Revision.Group 로 접근할 수 있고, 문서의 각 그룹에 대해서는 RevisionCollection.Groups (즉, RevisionGroupCollection) 로 접근할 수 있습니다. 각 그룹은 결합된 Text, Author, 그리고 RevisionType을 보고합니다.


새 추적 변경 기록

Document.StartTrackRevisions(author) 를 호출하거나 오버로드된 StartTrackRevisions(author, dateTime) 를 호출하여 편집을 시작하기 전에 사용하면, 이후의 변경 사항이 직접 적용되는 대신 수정으로 기록됩니다; 추적을 종료하려면 StopTrackRevisions() 를 호출합니다. Document.TrackRevisions 속성은 현재 추적이 활성화되어 있는지를 나타냅니다.


원본과 최종 콘텐츠 보기

Document.RevisionsView 은(는) 수정이 존재할 때 문서가 Original 상태인지 Final 상태인지 (즉, RevisionsView 값) 제어하며, 기본 수정 데이터는 변경하지 않습니다.


팁 및 모범 사례

  • 추적된 변경 사항이 없는 문서에 대해 불필요한 작업을 건너뛰기 위해 Document.Revisions 을 반복하기 전에 Document.HasRevisions 를 확인하십시오.
  • 수동으로 필터링하고 Revision.Accept() 을 하나씩 호출하는 대신, 사용자 정의 IRevisionCriteria 를 사용한 RevisionCollection.Accept(criteria)/Reject(criteria) 를 선호하십시오.
  • RevisionGroup은(는) 변경 사항의 읽기 쉬운 요약을 제공하는 데 유용합니다 — 연속된 동일 저자, 동일 유형 수정들을 그룹화하면 삽입된 모든 문자를 별개의 항목으로 취급하는 것을 피할 수 있습니다.
  • 항상 StartTrackRevisions()을(를) 이후에 호출되는 StopTrackRevisions()과 함께 사용하여 관련 없는 편집이 추적된 변경 사항으로 기록되지 않도록 하세요.

일반적인 문제

문제원인수정
Document.Revisions는 편집 후 비어 있습니다StartTrackRevisions()는 편집 전에 호출된 적이 없습니다추적하려는 편집을 하기 전에 StartTrackRevisions(author)를 호출하십시오
RevisionCollection.Accept(criteria)는 아무 것도 받지 않습니다IRevisionCriteria.IsMatch()가 어떤 리비전과도 일치하지 않습니다먼저 실제 Revision.Author/RevisionType/ParentNode 값에 대해 기준 논리를 확인하십시오
문서가 AcceptAllRevisions() 이후에도 추적 변경 마크업을 표시합니다리비전 데이터가 아니라 상태 보기해결된 콘텐츠 보기가 필요하면 Document.RevisionsView을(를) Final으로 설정하십시오

FAQ

문서에 추적된 변경 사항이 있는지 어떻게 확인합니까?

Document.HasRevisions을(를) 읽으세요 — Document.Revisions에 최소 하나의 Revision이 포함되어 있으면 true입니다.

Revision.Accept()와 RevisionCollection.AcceptAll()의 차이점은 무엇인가요?

Revision.Accept()은(는) 특정 수정 하나를 해결합니다; RevisionCollection.AcceptAll()(또는 Document.AcceptAllRevisions())은(는) 컬렉션에 있는 모든 수정을 한 번에 해결합니다.

특정 작성자가 만든 수정만을 어떻게 수락합니까?

revision.Author을 확인하기 위해 IRevisionCriteria.IsMatch(revision)을 구현하고, 그 구현을 사용하여 RevisionCollection.Accept(criteria)를 호출하십시오.

내 편집을 추적 변경으로 기록하려면 어떻게 해야 하나요?

편집을 시작하기 전에 Document.StartTrackRevisions(author)을 호출하고, 완료되면 Document.StopTrackRevisions()을 호출하십시오.

존재하는 수정 유형은 무엇인가요?

RevisionType은 Insertion, Deletion, FormatChange, StyleDefinitionChange, 그리고 Moving를 정의합니다.


API Reference 요약

클래스 / 메서드설명
Document.Revisions문서의 모든 추적 변경 RevisionCollection
Revision한 개의 추적된 변경 사항: Author, DateTime, RevisionType, Accept(), Reject()
RevisionCollectionAcceptAll(), RejectAll(), Accept(criteria), Reject(criteria), Groups
RevisionGroup / RevisionGroupCollection연속된 동일 저자, 동일 유형 수정이 함께 그룹화됨
IRevisionCriteria선택적 수락/거부를 위한 사용자 정의 술어 (IsMatch(revision))
Document.StartTrackRevisions() / StopTrackRevisions()새 편집을 추적된 변경 사항으로 기록하십시오
Document.RevisionsView수정된 콘텐츠의 Original 또는 Final 프레젠테이션

참조

 한국어