يدعم برنامج Microsoft Word خيار “مقارنة” الذي يتيح للمستخدمين مقارنة مستندات Word وتحديد التغييرات المضافة حديثًا. هذه الميزة مفيدة حيث يمكنك إجراء عملية مقارنة نص في مستندات Word جنبًا إلى جنب. ومع ذلك، يمكن أن يكون الحل البرمجي لمدقق الاختلافات النصية أسرع وأكثر كفاءة ويمكنه بسهولة إجراء عمليات مقارنة نصية مجمعة. في هذه المقالة، سنقوم بإجراء عملية مقارنة نص باستخدام REST-API حتى نتمكن من العثور على الاختلافات.
مقارنة النصوص API
Aspose.Words Cloud SDK for .NET تمكنك من إنشاء ومعالجة وتحويل تنسيقات MS Word الرائدة (DOC، DOCX، DOCM وما إلى ذلك) إلى تنسيقات أخرى مدعومة. وفي الوقت نفسه، توفر أيضًا القدرة على مقارنة مستندات Word وإبراز الاختلاف. الآن لاستخدام SDK، يرجى تثبيته من مكتبة NuGet باستخدام الأمر التالي في وحدة تحكم مدير الحزم:
Install-Package Aspose.Words-Cloud
لمزيد من المعلومات، يمكنك التفكير في زيارة الرابط التالي للحصول على مزيد من المعلومات حول كيفية تثبيت حزم SDK الخاصة بـ Aspose.Cloud. الآن بعد التثبيت، نحتاج أيضًا إلى إنشاء حساب مجاني من خلال زيارة لوحة تحكم Aspose.Cloud. ما عليك سوى التسجيل باستخدام حساب GitHub أو Google الخاص بك أو النقر فوق الزر إنشاء حساب جديد. سيتم استخدام بيانات اعتماد العميل المعروضة على الصفحة في الأقسام اللاحقة.
مقارنة النصوص عبر الإنترنت باستخدام C#
فيما يلي الخطوات ومقتطف الكود الذي يشرح التفاصيل حول كيفية مقارنة مستندين Word باستخدام مقتطف الكود C# .NET.
- أولاً، نحتاج إلى تعريف معلومات ClientID وClientSecret في الكود.
- ثانيًا، قم بإنشاء كائن من فئة التكوين من خلال توفير تفاصيل ClientID وClientSecret كوسائط.
- ثالثًا، قم بإنشاء كائن من فئة WordsApi ومرر مثيل التكوين كحجة.
- الآن قم بإنشاء مثيل لفئة CompareData.
- لتحديد اسم الشخص بشكل محدد كما تم تحديده في الملف الناتج، استخدم خاصية Author في فئة CompareData.
- يتم استخدام الخاصية ComparingWithDocument من فئة CompareData لتحديد المستند المستهدف لمقارنة المحتوى.
- الآن قم بإنشاء مثيل لفئة CompareDocumentRequest والتي تأخذ ملف الإدخال/المصدر، وكائن CompareData، واسم الملف الناتج كوسائط.
- وأخيرًا، قم باستدعاء طريقة CompareDocument(..) لبدء عملية المقارنة.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get Client Id from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get Client Secret from https://dashboard.aspose.cloud/
// إنشاء مثيل لفئة التكوين
// وتقديم تفاصيل معرف العميل والسر الخاص بالعميل
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// تهيئة كائن WordsAPI باستخدام مثيل التكوين
var wordsApi = new WordsApi(config);
// وثيقة الإدخال الأولى
string firstDocument = "file-sample.docx";
// الوثيقة الثانية التي سيتم مقارنتها مع
string secondFile = "file-sample-updated.docx";
// اسم الملف الناتج
string resultantFile = "Out_ComparedTestDocs.docx";
// إنشاء مثيل لفئة CompareData
CompareData compareData = new CompareData();
// الاسم الذي سيتم استخدامه كمؤلف لتحديد الاختلافات
compareData.Author = "Nayyer";
// حدد الوثيقة المراد مقارنتها بها
compareData.ComparingWithDocument = secondFile;
compareData.DateTime = DateTime.Now;
// إنشاء مثيل الطلب من خلال توفير المصدر والمستند للمقارنة واسم الملف الناتج
CompareDocumentRequest request = new CompareDocumentRequest(firstDocument, compareData, null, null, null, null, resultantFile);
// بدء مقارنة المستندات
DocumentResponse result = wordsApi.CompareDocument(request);
يمكن تنزيل ملفات العينة المستخدمة في الأمثلة المذكورة أعلاه من الروابط التالية
مقارنة مستندات Word باستخدام أوامر cURL
في هذا القسم، سنتعلم الخطوات الخاصة بكيفية مقارنة مستندات Word باستخدام أوامر cURL. نظرًا لأن واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا من قبل الموظفين المصرح لهم فقط، لذا يرجى تنفيذ الأمر التالي لإنشاء رمز وصول JWT استنادًا إلى تفاصيل معرف العميل والسر الخاص بالعميل.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
يوضح الأمر cURL أدناه كيفية إجراء مقارنة الملفات عبر الإنترنت باستخدام الأمر cURL. فهو يصل إلى طريقة CompareDocument ويتم كتابة نتيجة هذه العملية في المستند الناتج الذي يحتوي على تعقب التغييرات كعدد من المراجعات التحريرية والتنسيقية. يرجى ملاحظة أنه إذا لم تقدم تفاصيل المستند الناتج، فسيتم حفظ المراجعات في المستند الأصلي.
curl -X PUT "https://api.aspose.cloud/v4.0/words/file-sample.docx/compareDocument?destFileName=ComparisonResult.docx" \
-H "accept: application/json"
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"ComparingWithDocument\":\"file-sample-updated.docx\",\"Author\":\"Nayyer\",\"DateTime\":\"2021-04-27T16:50:55.869Z\",\"CompareOptions\":{\"IgnoreCaseChanges\":true,\"IgnoreTables\":true,\"IgnoreFields\":true,\"IgnoreFootnotes\":true,\"IgnoreComments\":true,\"IgnoreTextboxes\":true,\"IgnoreFormatting\":true,\"IgnoreHeadersAndFooters\":true,\"Target\":\"Current\"}}"
بمجرد تنفيذ الأمر، يتم تحديد المعلومات التي تم حذفها بشكل منفصل ويتم تسليط الضوء على المحتوى المضاف حديثًا باللون الأصفر.
الصورة 1:- معاينة المستند الأصلي والمستند المعدل.
الصورة 2:- معاينة النص للمقارنة.
خاتمة
في هذه المقالة، شرحنا الخطوات اللازمة لمقارنة مستندات Word باستخدام واجهة برمجة تطبيقات Aspose.Words Cloud. يرجى ملاحظة أنه يمكن الوصول إلى واجهات برمجة التطبيقات أيضًا من خلال swagger interface. كما أن مجموعات SDK السحابية الخاصة بنا مفتوحة المصدر ويمكن تنزيل الكود المصدر الكامل لها من GitHub.
نوصي أيضًا بزيارة الوثائق المنتج لمزيد من التفاصيل حول الميزات الأخرى المثيرة التي تقدمها API. ملاحظاتك مهمة جدًا بالنسبة لنا. لذا، لا تتردد في الاتصال بنا باستخدام منتديات الدعم.
انظر أيضا
يمكنك زيارة الروابط التالية للحصول على معلومات حول: