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जांचें। - एक कस्टम
IRevisionCriteriaके साथRevisionCollection.Accept(criteria)/Reject(criteria)को प्राथमिकता दें, बजाय इसके कि आप मैन्युअल रूप से फ़िल्टर करकेRevision.Accept()को एक-एक करके कॉल करें। RevisionGroupबदलावों का पठनीय सारांश प्रस्तुत करने के लिए उपयोगी है — क्रमागत समान-लेखक, समान-प्रकार संशोधनों को समूहित करने से प्रत्येक सम्मिलित अक्षर को अलग प्रविष्टि के रूप में मानने से बचा जाता है।- हमेशा
StartTrackRevisions()को बाद में किए जाने वालेStopTrackRevisions()कॉल के साथ जोड़ें ताकि असंबंधित संपादन ट्रैक किए गए बदलावों के रूप में रिकॉर्ड न हों।
सामान्य समस्याएँ
| समस्या | कारण | समाधान |
|---|---|---|
Document.Revisions संपादनों के बाद खाली है | StartTrackRevisions() को संपादन से पहले कभी नहीं बुलाया गया | ट्रैक किए जाने वाले संपादन करने से पहले StartTrackRevisions(author) को कॉल करें |
RevisionCollection.Accept(criteria) कुछ भी स्वीकार नहीं करता | IRevisionCriteria.IsMatch() किसी भी संशोधन से मेल नहीं खाता | पहले वास्तविक Revision.Author/RevisionType/ParentNode मानों के खिलाफ मानदंड तर्क की जाँच करें |
दस्तावेज़ में AcceptAllRevisions() के बाद भी ट्रैक्ड-चेंज मार्कअप दिख रहा है | स्थिति देखें, संशोधन डेटा नहीं | यदि आपको समाधानित सामग्री दृश्य चाहिए तो Document.RevisionsView को Final पर सेट करें |
FAQ
मैं कैसे जांचूँ कि किसी दस्तावेज़ में कोई ट्रैक किए गए बदलाव हैं या नहीं?
Document.HasRevisions पढ़ें — यह true है यदि Document.Revisions में कम से कम एक Revision हो।
Revision.Accept() और RevisionCollection.AcceptAll() में क्या अंतर है?
Revision.Accept() एक विशिष्ट संशोधन को हल करता है; RevisionCollection.AcceptAll() (या Document.AcceptAllRevisions()) संग्रह में सभी संशोधनों को एक साथ हल करता है।
मैं केवल किसी विशिष्ट लेखक द्वारा किए गए संशोधनों को कैसे स्वीकार करूँ?
IRevisionCriteria.IsMatch(revision) को लागू करें ताकि revision.Author की जाँच हो सके, फिर उस कार्यान्वयन के साथ RevisionCollection.Accept(criteria) को कॉल करें।
मैं अपने स्वयं के संपादन को ट्रैक्ड चेंजेज़ के रूप में कैसे रिकॉर्ड करूँ?
संपादन करने से पहले Document.StartTrackRevisions(author) को कॉल करें, फिर समाप्त होने पर Document.StopTrackRevisions() को कॉल करें।
कौन से revision types मौजूद हैं?
RevisionType Insertion, Deletion, FormatChange, StyleDefinitionChange और Moving को परिभाषित करता है।
API Reference सारांश
| क्लास / मेथड | विवरण |
|---|---|
Document.Revisions | दस्तावेज़ में सभी ट्रैक्ड बदलावों का RevisionCollection |
Revision | एक ट्रैक्ड परिवर्तन: Author, DateTime, RevisionType, Accept(), Reject() |
RevisionCollection | AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria), Groups |
RevisionGroup / RevisionGroupCollection | लगातार समान-लेखक, समान-प्रकार संशोधन एक साथ समूहित किए गए |
IRevisionCriteria | चयनात्मक स्वीकृति/अस्वीकृति के लिए कस्टम प्रेडिकेट (IsMatch(revision)) |
Document.StartTrackRevisions() / StopTrackRevisions() | नए संपादन को ट्रैक्ड परिवर्तन के रूप में रिकॉर्ड करें |
Document.RevisionsView | Original या Final संशोधित सामग्री का प्रस्तुतीकरण |
