قبول المراجعات

مقدمة

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

المتطلبات الأساسية

قبل أن نبدأ، تأكد من توفر المتطلبات الأساسية التالية:

• تم تثبيت Visual Studio على جهازك.
• إطار عمل .NET (يفضل الإصدار الأحدث).
• مكتبة Aspose.Words لـ .NET. يمكنك تنزيلهاهنا.
• فهم أساسي لبرمجة C#.

الآن، دعنا ننتقل إلى التفاصيل ونرى كيف يمكننا إتقان مراجعات المستندات باستخدام Aspose.Words لـ .NET.

استيراد مساحات الأسماء

أولاً وقبل كل شيء، عليك استيراد مساحات الأسماء اللازمة للعمل مع Aspose.Words. أضف التعليمات التالية باستخدام أعلى ملف التعليمات البرمجية الخاص بك:

using Aspose.Words;
using Aspose.Words.Revision;

دعنا نقسم العملية إلى خطوات يمكن إدارتها. سيتم شرح كل خطوة بالتفصيل لضمان فهمك لكل جزء من الكود.

الخطوة 1: تهيئة المستند

للبدء، نحتاج إلى إنشاء مستند جديد وإضافة بعض الفقرات. سيؤدي هذا إلى تمهيد الطريق لتتبع المراجعات.

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
Body body = doc.FirstSection.Body;
Paragraph para = body.FirstParagraph;

// أضف النص إلى الفقرة الأولى، ثم أضف فقرتين أخريين.
para.AppendChild(new Run(doc, "Paragraph 1. "));
body.AppendParagraph("Paragraph 2. ");
body.AppendParagraph("Paragraph 3. ");

في هذه الخطوة، قمنا بإنشاء مستند جديد وأضفنا إليه ثلاث فقرات. ستكون هذه الفقرات بمثابة الأساس لتتبع المراجعة.

الخطوة 2: ابدأ في تتبع المراجعات

بعد ذلك، نحتاج إلى تمكين تتبع المراجعة. وهذا يسمح لنا بالتقاط أي تغييرات تم إجراؤها على المستند.

// ابدأ بتتبع المراجعات.
doc.StartTrackRevisions("John Doe", DateTime.Now);

عن طريق الاتصالStartTrackRevisions، نمكن المستند من تتبع جميع التغييرات اللاحقة. يتم تمرير اسم المؤلف والتاريخ الحالي كمعلمات.

الخطوة 3: إضافة مراجعة

الآن بعد تمكين تتبع المراجعة، فلنقم بإضافة فقرة جديدة. سيتم وضع علامة على هذه الإضافة باعتبارها مراجعة.

// هذه الفقرة عبارة عن مراجعة وسيتم تعيين العلامة "IsInsertRevision" وفقًا لها.
para = body.AppendParagraph("Paragraph 4. ");

هنا، تمت إضافة فقرة جديدة (“الفقرة 4.”) ونظرًا لتمكين تتبع المراجعة، تم وضع علامة على هذه الفقرة باعتبارها مراجعة.

الخطوة 4: إزالة فقرة

بعد ذلك، سنقوم بإزالة فقرة موجودة ومراقبة كيفية تتبع المراجعة.

// احصل على مجموعة فقرات المستند وقم بإزالة فقرة.
ParagraphCollection paragraphs = body.Paragraphs;
para = paragraphs[2];
para.Remove();

في هذه الخطوة، تتم إزالة الفقرة الثالثة. وبسبب تتبع المراجعة، يتم تسجيل هذا الحذف، ويتم وضع علامة على الفقرة للحذف بدلاً من إزالتها فورًا من المستند.

الخطوة 5: قبول كافة المراجعات

أخيرًا، دعونا نقبل جميع المراجعات المتعقبة، مما يعزز التغييرات في المستند.

// قبول كافة المراجعات.
doc.AcceptAllRevisions();

عن طريق الاتصالAcceptAllRevisionsنحن نضمن قبول جميع التغييرات (الإضافات والحذف) وتطبيقها على المستند. لم تعد المراجعات مميزة ويتم دمجها في المستند.

الخطوة 6: التوقف عن تتبع المراجعات

تعطيل تتبع المراجعة

ولتلخيص الأمر، يمكننا تعطيل تتبع المراجعة لإيقاف تسجيل التغييرات الإضافية.

// إيقاف تتبع المراجعات.
doc.StopTrackRevisions();

تؤدي هذه الخطوة إلى منع المستند من تتبع أي تغييرات جديدة، ومعاملة جميع التحريرات اللاحقة كمحتوى عادي.

الخطوة 7: حفظ المستند

وأخيرًا، قم بحفظ المستند المعدّل في الدليل المحدد.

// احفظ المستند.
doc.Save(dataDir + "WorkingWithRevisions.AcceptRevisions.docx");

من خلال حفظ المستند، فإننا نضمن الحفاظ على جميع التغييرات والمراجعة المقبولة.

خاتمة

قد تكون إدارة مراجعات المستندات مهمة شاقة، ولكن مع Aspose.Words for .NET، تصبح هذه المهمة سهلة وفعّالة. باتباع الخطوات الموضحة في هذا الدليل، يمكنك بسهولة تتبع التغييرات وقبولها ورفضها في مستندات Word، مما يضمن أن تكون مستنداتك محدثة ودقيقة دائمًا. إذًا، لماذا الانتظار؟ انغمس في عالم Aspose.Words وقم بتبسيط إدارة المستندات الخاصة بك اليوم!

الأسئلة الشائعة

كيف أبدأ في تتبع المراجعات في Aspose.Words لـ .NET؟

يمكنك البدء في تتبع المراجعات عن طريق الاتصال بـStartTrackRevisions الطريقة على كائن المستند الخاص بك وتمرير اسم المؤلف والتاريخ الحالي.

هل يمكنني إيقاف تتبع المراجعات في أي وقت؟

نعم، يمكنك إيقاف تتبع المراجعات عن طريق الاتصال بـStopTrackRevisions الطريقة على كائن المستند الخاص بك.

كيف أقبل كافة المراجعات في مستند؟

لقبول كافة المراجعات، استخدمAcceptAllRevisions الطريقة على كائن المستند الخاص بك.

هل يمكنني رفض المراجعات المحددة؟

نعم، يمكنك رفض المراجعات المحددة من خلال الانتقال إليها واستخدامReject طريقة.

أين يمكنني تنزيل Aspose.Words لـ .NET؟

يمكنك تنزيل Aspose.Words لـ .NET منرابط التحميل.