Revisions

Ez az útmutató bemutatja, hogyan lehet ellenőrizni, elfogadni, elutasítani és rögzíteni a nyomon követett módosításokat egy Word-dokumentumban a Aspose.Words FOSS segítségével .NET esetén. A Aspose.Words FOSS .NET esetén képes a nyomon követett módosítások (revíziók) ellenőrzésére, elfogadására és elutasítására egy Word-dokumentumban a Document.Revisions segítségével, és új nyomon követett módosításokat rögzíthet a szerkesztés során a Document.StartTrackRevisions()/StopTrackRevisions() használatával.

Nyomon követett módosítások olvasása

Document.Revisions egy RevisionCollection-t ad vissza minden Revision-ról a dokumentumban; a Range.Revisions ugyanazt korlátozza egy adott tartományra. Minden Revision jelzi, ki hajtotta a módosítást és mikor (Author, DateTime), milyen típusú módosításról van szó (RevisionType: Insertion, Deletion, FormatChange, StyleDefinitionChange, vagy Moving), és hol érvényesül (ParentNode, ParentStyle). A Document.HasRevisions előre tájékoztat arról, hogy a betöltött dokumentumnak van-e egyáltalán nyomon követett módosítása.

Revíziók elfogadása és elutasítása

Hívja a Revision.Accept() vagy a Revision.Reject() függvényt egyetlen nyomon követett módosítás megoldásához, vagy dolgozzon egyszerre a teljes gyűjteményen a RevisionCollection.AcceptAll() / RejectAll() használatával. A Document.AcceptAllRevisions() egy dokumentumszintű kényelem, amely egy hívással elfogadja az összes revíziót. Egy részhalmaz szelektív elfogadásához vagy elutasításához valósítsa meg a IRevisionCriteria.IsMatch(revision) funkciót, és adja át a RevisionCollection.Accept(criteria) vagy a Reject(criteria) számára.

Revíziócsoportok

Az azonos szerzőtől és azonos típusú egymást követő módosítások együtt jelennek meg egy {RevisionGroup)}ként — elérhető Revision.Group segítségével egyetlen módosítás esetén, vagy RevisionCollection.Groups (egy RevisionGroupCollection) minden dokumentumban lévő csoporthoz. Minden csoport jelenti a kombinált Text, Author és RevisionType értékét.

Új nyomon követett változások rögzítése

Hívja meg a Document.StartTrackRevisions(author) függvényt vagy a StartTrackRevisions(author, dateTime) túlterhelést a szerkesztés megkezdése előtt, hogy a későbbi módosítások revízióként kerüljenek rögzítésre, ahelyett, hogy közvetlenül alkalmazódnának; hívja meg a StopTrackRevisions() függvényt a nyomon követés befejezéséhez. A Document.TrackRevisions tulajdonság azt tükrözi, hogy a nyomon követés jelenleg aktív-e.

Az eredeti és a végleges tartalom megtekintése

Document.RevisionsView szabályozza, hogy a dokumentum a Original vagy a Final állapotában (egy RevisionsView érték) jelenjen meg, ha revíziók vannak, anélkül hogy módosítaná a háttérben lévő revízió adatokat.

Tippek és bevált gyakorlatok

Ellenőrizze a Document.HasRevisions értékét, mielőtt Document.Revisions-t iterálná, hogy elkerülje a felesleges munkát a nem nyomon követett változásokkal rendelkező dokumentumoknál.
Részesítse előnyben a RevisionCollection.Accept(criteria)/Reject(criteria) használatát egy egyedi IRevisionCriteria beállítással a manuális szűrés és a Revision.Accept() egyenkénti meghívása helyett.
RevisionGroup hasznos a változások olvasható összefoglalásának megjelenítéséhez — az egymást követő ugyanazon szerző, ugyanazon típusú revíziók csoportosítása elkerüli, hogy minden beillesztett karakter külön bejegyzésként jelenjen meg.
Mindig párosítsd a StartTrackRevisions() hívást egy későbbi StopTrackRevisions() hívással, hogy a nem kapcsolódó szerkesztések ne kerüljenek nyomon követett változásokként rögzítésre.

Gyakori problémák

Probléma	Ok	Javítás
`Document.Revisions` üres a szerkesztések után	`StartTrackRevisions()` soha nem lett meghívva a szerkesztés előtt	Hívd meg a `StartTrackRevisions(author)` a nyomon követni kívánt szerkesztések előtt
`RevisionCollection.Accept(criteria)` nem fogad semmit	`IRevisionCriteria.IsMatch()` nem egyezik egyetlen revízióval sem	Először ellenőrizze a kritériumlogikát a tényleges `Revision.Author`/`RevisionType`/`ParentNode` értékekkel.
A dokumentum továbbra is megjeleníti a változások nyomon követésének jelölését a `AcceptAllRevisions()` után.	Állapot megtekintése, nem a verzióadatok.	Állítsa be a(z) `Document.RevisionsView` értékét `Final`-re, ha a feloldott tartalomnézetre van szüksége.

FAQ

Hogyan ellenőrizhetem, hogy egy dokumentumnak van-e nyomon követett változása?

Olvasd el a Document.HasRevisions — true, ha a Document.Revisions legalább egy Revision elemet tartalmaz.

Mi a különbség a Revision.Accept() és a RevisionCollection.AcceptAll() között?

Revision.Accept() egy konkrét revíziót old meg; a RevisionCollection.AcceptAll() (vagy Document.AcceptAllRevisions()) egyszerre az egész gyűjteményben lévő összes revíziót oldja meg.

Hogyan fogadhatom el csak egy adott szerző által készült módosításokat?

Implementálja a(z) IRevisionCriteria.IsMatch(revision) elemet a(z) revision.Author ellenőrzésére, majd hívja meg a(z) RevisionCollection.Accept(criteria) elemet ezzel a megvalósítással.

Hogyan rögzítsem a saját szerkesztéseimet nyomon követett módosításként?

Hívja meg a(z) Document.StartTrackRevisions(author) elemet a szerkesztések előtt, majd a(z) Document.StopTrackRevisions() elemet, amikor befejeződött.

Milyen módosítási típusok léteznek?

RevisionType meghatározza a(z) Insertion, Deletion, FormatChange, StyleDefinitionChange és Moving elemeket.

API Reference összegzés

Osztály / Metódus	Leírás
`Document.Revisions`	A `RevisionCollection` az összes nyomon követett változásra a dokumentumban.
`Revision`	Egy nyomon követett módosítás: `Author`, `DateTime`, `RevisionType`, `Accept()`, `Reject()`
`RevisionCollection`	`AcceptAll()`, `RejectAll()`, `Accept(criteria)`, `Reject(criteria)`, `Groups`
`RevisionGroup` / `RevisionGroupCollection`	Egymást követő azonos szerzőjű, azonos típusú revíziók együttesen csoportosítva
`IRevisionCriteria`	Egyedi predikátum (`IsMatch(revision)`) szelektív elfogadáshoz/elutasításhoz
`Document.StartTrackRevisions()` / `StopTrackRevisions()`	Az új módosításokat változáskövetésként rögzítse
`Document.RevisionsView`	`Original` vagy `Final` a felülvizsgált tartalom bemutatása

Lásd még:

Aspose.Words for .NET — Enterprise Documentation