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

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

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

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

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

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

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

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

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

يدعم Aspose.Words أنواعًا مختلفة من المراجعة، وكذلك في Microsoft Word، مثل Insertion وDeletion وFormatChange وStyleDefinitionChange وMoving. يتم تمثيل جميع أنواع المراجعة بتعداد RevisionType.

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

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

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

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

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

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

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

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

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

إدارة التغييرات وتخزينها كمراجعات

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

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

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

بالإضافة إلى ذلك، يسمح لك Aspose.Words بالتحقق مما إذا كان قد تم إدراج كائن أو حذفه أو تغيير تنسيقه باستخدام خصائص is_delete_revision وis_format_revision وis_insert_revision وis_move_from_revision وis_move_to_revision.

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

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