تتبع التغييرات في المستند

تتيح لك وظيفة تتبع التغييرات، والمعروفة أيضا باسم المراجعة، تتبع التغييرات في المحتوى والتنسيق التي أجريتها أنت أو المستخدمون الآخرون. هذه الميزة تتبع التغييرات مع Aspose.Words يدعم تتبع التغييرات في Microsoft Word. باستخدام هذه الوظيفة، يمكنك الوصول إلى المراجعات الفردية في المستند وتطبيق خصائص مختلفة عليها.

عند تمكين ميزة تتبع التغييرات، سيتم تمييز جميع عناصر المستند المدرجة والمحذوفة والمعدلة بصريا بمعلومات حول من ومتى وما تم تغييره. تسمى الكائنات التي تحمل معلومات حول ما تم تغييره “تتبع التغييرات”. على سبيل المثال، افترض أنك تريد مراجعة مستند وإجراء تغييرات مهمة – قد يعني هذا أنك بحاجة إلى إجراء مراجعات. أيضا، قد تحتاج إلى إدراج تعليقات لمناقشة بعض التغييرات. هذا هو المكان الذي يأتي فيه تتبع التغييرات في المستندات.

تشرح هذه المقالة كيفية إدارة وتتبع التغييرات التي أنشأها العديد من المراجعين على نفس المستند، بالإضافة إلى خصائص تتبع التغييرات.

لاحظ أن ميزة التعليق في Aspose.Words، وكذلك في Microsoft Word، يمكن أن ترتبط بتغييرات التتبع. ومع ذلك، تذكر أن التعليقات مستقلة تماما عن تتبع التغييرات.

ما هي المراجعة

قبل الغوص في المراجعات، دعنا نشرح معنى المراجعات. revision هو تغيير يحدث في عقدة واحدة من المستند بينما مجموعة المراجعة، ممثلة في فئة RevisionGroup، هي مجموعة من المراجعات المتسلسلة التي تحدث في العديد من عقد المستند. المراجعة هي أداة لتتبع التغييرات.

تستخدم المراجعات في ميزة تتبع التغييرات وضمن ميزة مقارنة المستندات، حيث تظهر المراجعات كنتيجة للمقارنة. لذلك، تظهر المراجعات داخل ميزة تتبع التغييرات من قبل من وما تم تغييره.

لاحظ أن Microsoft Word لا يسمح لك بعرض المراجعات الفردية، بل يسمح لك فقط بعرض المراجعات المتسلسلة ككيان واحد. ولكن Aspose.Words يحل هذا القيد مع فئة RevisionGroup.

Aspose.Words يدعم أنواع المراجعة المختلفة، وكذلك في Microsoft Word، مثل الإدراج والحذف و FormatChange و StyleDefinitionChange والتحرك. يتم تمثيل جميع أنواع المراجعة مع RevisionType تعداد.

لاحظ أن المراجعات لها نتيجة مشابهة لـ Microsoft Word ولكن Aspose.Words لا يكتشف التنسيق أثناء تتبع التغييرات.

بدء وإيقاف تتبع التغييرات

عادة لا يتم احتساب تحرير المستند كمراجعة حتى تبدأ في تتبعه. Aspose.Words يسمح لك بتتبع جميع التغييرات في المستند تلقائيا بخطوات بسيطة. يمكنك بسهولة بدء عملية تتبع التغييرات باستخدام طريقة StartTrackRevisions. إذا كنت بحاجة إلى إيقاف عملية تتبع التغييرات بحيث لا تعتبر أي تعديلات مستقبلية مراجعات، فستحتاج إلى استخدام طريقة StopTrackRevisions.

لاحظ أن طريقة StartTrackingRevisions لا تغير حالة الخاصية TrackRevisions ولا تستخدم قيمتها بهدف تتبع المراجعة. بالإضافة إلى ذلك، إذا تم نقل عقدة من موقع إلى آخر داخل المستند المتعقب، فسيتم إنشاء تنقيحات النقل، بما في ذلك الانتقال من النطاق والانتقال إليه.

في نهاية عملية تتبع التغييرات في المستند، سيكون لديك القدرة على قبول جميع المراجعات أو رفضها لإعادة المستند إلى شكله الأصلي. يمكن تحقيق ذلك إما باستخدام طريقة AcceptAllRevisions أو RejectAll. بالإضافة إلى ذلك، يمكنك قبول أو رفض كل مراجعة على حدة باستخدام طريقة Accept أو Reject.

سيتم تتبع جميع التغييرات لتكرار واحد من اللحظة التي تبدأ فيها العملية إلى اللحظة التي توقفها فيها. يتم تمثيل الاتصال بين التكرارات المختلفة على النحو التالي: إكمال عملية التتبع، ثم إجراء بعض التغييرات، وبدء تتبع التغييرات مرة أخرى. باستخدام هذا السيناريو، سيتم عرض جميع التغييرات التي لم تقبلها أو ترفضها مرة أخرى.

لاحظ أن طريقة AcceptAllRevisions مشابهة لـ" قبول جميع التغييرات " في Microsoft Word.

يوضح مثال التعليمات البرمجية التالية كيفية العمل مع تتبع التغييرات:

يوضح مثال التعليمات البرمجية التالي كيفية إنشاء المراجعات عند نقل عقدة داخل مستند متعقب:

إدارة وتخزين التغييرات كما التنقيحات

باستخدام ميزة تغييرات التتبع السابقة، يمكنك فهم التغييرات التي تم إجراؤها في المستند ومن أجرى هذه التغييرات. أثناء استخدام ميزة TrackRevisions، فإنك تفرض تخزين أي تغييرات داخل المستند كمراجعات.

Aspose.Words يسمح لك بالتحقق مما إذا كان المستند يحتوي على مراجعة أم لا باستخدام خاصية HasRevision. إذا لم تكن بحاجة إلى تتبع التغييرات في المستند تلقائيا من خلال الطريقتين StartTrackRevisions و StopTrackRevisions، فيمكنك استخدام الخاصية TrackRevisions للتحقق مما إذا كان يتم تتبع التغييرات أثناء تحرير مستند في Microsoft Word وتخزينها كمراجعات.

تقوم ميزة TrackRevisions بإجراء مراجعات بدلا من التغييرات الحقيقية DOM. لكن المراجعات نفسها منفصلة. على سبيل المثال، إذا قمت بحذف أي فقرة، Aspose.Words اجعلها مراجعة، مع وضع علامة عليها كحذف، بدلا من حذفها.

بالإضافة إلى ذلك، Aspose.Words يسمح لك بالتحقق مما إذا تم إدراج كائن أو حذفه أو تغيير التنسيق باستخدام IsDeleteRevision, IsFormatRevision, IsInsertRevision, IsMoveFromRevision, و IsMoveToRevision خصائص.

لاحظ أنه لا يوجد اتصال بين المراجعات نفسها وخاصية TrackRevisions. بالإضافة إلى ذلك، يمكنك قبول/رفض المراجعات بغض النظر عن ميزة تتبع التغييرات.

يوضح مثال الكود التالي كيفية تطبيق خصائص مختلفة مع المراجعات: