ردیابی تغییرات در یک سند

عملکرد تغییرات آهنگ که به عنوان بازبینی نیز شناخته می شود، به شما امکان می دهد تغییرات محتوا و قالب بندی ایجاد شده توسط شما یا سایر کاربران را ردیابی کنید. این ویژگی تغییر آهنگ با 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 به شما این امکان را می دهد که با مراحل ساده تمام تغییرات سند خود را بطور خودکار پیگیری کنید. با استفاده از روش StartTrackRevisions می توانید به راحتی فرآیند ردیابی تغییرات را شروع کنید. اگر باید روند ردیابی تغییرات را متوقف کنید تا هر گونه ویرایش در آینده به عنوان ویرایش تلقی نشود، باید از روش StopTrackRevisions استفاده کنید.

توجه داشته باشید که روش StartTrackingRevisions وضعیت ویژگی TrackRevisions را تغییر نمی دهد و از مقدار آن برای هدف ردیابی تجدید نظر استفاده نمی کند. علاوه بر این، اگر یک گره از یک مکان به مکان دیگر در سند ردیابی شده منتقل شده باشد، بازبینی‌های حرکت ایجاد می‌شود، از جمله انتقال از و حرکت به محدوده.

در پایان فرآیند ردیابی تغییرات در سند خود، شما این توانایی را خواهید داشت که حتی تمام ویرایش ها را بپذیرید یا آنها را رد کنید تا سند به شکل اصلی خود بازگردد. این را می توان با استفاده از روش AcceptAllRevisions یا RejectAll به دست آورد. علاوه بر این، با استفاده از روش Accept یا Reject می توانید هر ویرایش را به طور جداگانه بپذیرید یا رد کنید.

همه تغییرات برای یک بار تکرار از لحظه شروع فرآیند تا لحظه توقف آن پیگیری می شود. ارتباط بین تکرارهای مختلف به صورت سناریوی زیر نشان داده می شود: شما فرآیند ردیابی را کامل می کنید، سپس تغییراتی را ایجاد می کنید و دوباره ردیابی تغییرات را شروع می کنید. با این سناریو تمامی تغییراتی که قبول یا رد نکرده اید دوباره نمایش داده می شود.

توجه داشته باشید که روش AcceptAllRevisions شبیه به “Accept All Changes” در Microsoft Word است.

مثال کد زیر نحوه کار با ردیابی تغییرات را نشان می دهد:

مثال کد زیر نشان می‌دهد که وقتی یک گره در یک سند ردیابی شده جابجا می‌شود، ویرایش‌ها چگونه ایجاد می‌شوند:

مدیریت و ذخیره تغییرات به عنوان ویرایش

با ویژگی تغییرات ردیابی قبلی، می توانید متوجه شوید که کدام تغییرات در سند شما ایجاد شده است و چه کسی این تغییرات را انجام داده است. در حالی که با ویژگی TrackRevisions، هر گونه تغییر در سند خود را مجبور می کنید که به عنوان ویرایش ذخیره شود.

Aspose.Words به شما امکان می دهد با استفاده از ویژگی HasRevision بررسی کنید که آیا یک سند دارای ویرایش است یا خیر. اگر نیازی به ردیابی خودکار تغییرات سند خود از طریق روش‌های StartTrackRevisions و StopTrackRevisions ندارید، می‌توانید از ویژگی TrackRevisions برای بررسی اینکه آیا تغییرات در حین ویرایش یک سند در Microsoft Word ردیابی شده و به عنوان ویرایش ذخیره می‌شوند، استفاده کنید.

ویژگی TrackRevisions به جای تغییرات واقعی DOM تجدید نظر می کند. اما خود تجدید نظرها جدا هستند. به عنوان مثال، اگر هر پاراگراف را حذف کنید، Aspose.Words آن را به‌عنوان یک تجدیدنظر در می‌آورد و به جای حذف آن را به عنوان حذف علامت‌گذاری می‌کند.

علاوه بر این، Aspose.Words به شما امکان می دهد با استفاده از ویژگی های IsDeleteRevision، IsFormatRevision، IsInsertRevision، IsMoveFromRevision و IsMoveToRevision بررسی کنید که آیا یک شی درج شده، حذف شده است یا قالب بندی آن تغییر کرده است.

توجه داشته باشید که هیچ ارتباطی بین خود ویرایش ها و ویژگی TrackRevisions وجود ندارد. علاوه بر این، می توانید بدون توجه به ویژگی تغییرات ردیابی، بازبینی ها را بپذیرید/رد کنید.

مثال کد زیر نحوه اعمال خصوصیات مختلف با بازبینی ها را نشان می دهد: