مایکروسافت ورد از گزینه “مقایسه” پشتیبانی می کند که به کاربران امکان می دهد اسناد word را مقایسه کرده و تغییرات جدید اضافه شده را شناسایی کنند. این ویژگی مفید است زیرا می توانید عملیات مقایسه متن را در اسناد word در کنار هم انجام دهید. با این حال، یک راه‌حل برنامه‌ای بررسی‌کننده تفاوت متن می‌تواند بسیار سریع‌تر و کارآمدتر باشد و به راحتی می‌تواند عملیات تفاوت متن انبوه را انجام دهد. در این مقاله قصد داریم با استفاده از REST-API عملیات Text compare را انجام دهیم تا بتوانیم تفاوت ها را پیدا کنیم.
API مقایسه متن
Aspose.Words Cloud SDK for .NET شما را قادر می سازد تا فرمت های پیشرو MS Word (DOC، DOCX، DOCM و غیره) را ایجاد، دستکاری و تبدیل به فرمت های دیگر پشتیبانی کنید. در عین حال، قابلیت مقایسه اسناد Word و برجسته کردن تفاوت را نیز فراهم می کند. اکنون برای استفاده از SDK، لطفاً آن را از NuGet Library با استفاده از دستور زیر در کنسول مدیریت بسته نصب کنید:
Install-Package Aspose.Words-Cloud
برای اطلاعات بیشتر، می‌توانید برای اطلاعات بیشتر در مورد نحوه نصب Aspose.Cloud SDKs از پیوند زیر دیدن کنید. اکنون پس از نصب، باید با مراجعه به Aspose.Cloud dashboard یک حساب کاربری رایگان نیز ایجاد کنیم. به سادگی با حساب GitHub یا Google خود ثبت نام کنید یا روی دکمه Create a new Account کلیک کنید. اعتبار مشتری نمایش داده شده در صفحه در بخش های بعدی استفاده خواهد شد.
مقایسه متن آنلاین با استفاده از C#
در زیر مراحل و قطعه کد ارائه شده است که جزئیات نحوه مقایسه دو سند کلمه با استفاده از قطعه کد C#.NET را توضیح می دهد.
- ابتدا باید اطلاعات ClientID و ClientSecret را در کد تعریف کنیم.
- در مرحله دوم، یک شی از کلاس Configuration با ارائه جزئیات ClientID و ClientSecret به عنوان آرگومان ایجاد کنید.
- سوم، یک شی از کلاس WordsApi ایجاد کنید و نمونه Configuration را به عنوان آرگومان ارسال کنید.
- اکنون یک نمونه از کلاس 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/
// جعبه نمونه ای از کلاس پیکربندی
// و Client ID شخصی و جزئیات Client Secret را ارائه دهید
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 را بیاموزیم. از آنجایی که API های ما فقط برای پرسنل مجاز قابل دسترسی است، بنابراین لطفاً دستور زیر را برای ایجاد یک نشانه دسترسی JWT بر اساس شناسه مشتری و جزئیات Client Secret اجرا کنید.
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 API را توضیح داده ایم. لطفاً توجه داشته باشید که APIها از طریق اینترفیس swagger نیز قابل دسترسی هستند. همچنین، Cloud SDK های ما منبع باز هستند و کد منبع کامل آنها را می توان از GitHub دانلود کرد.
همچنین توصیه می‌کنیم برای جزئیات بیشتر در مورد سایر ویژگی‌های هیجان‌انگیز ارائه‌شده توسط API، از محصول Documentation دیدن کنید. نظرات شما برای ما بسیار مهم است. بنابراین، لطفاً با استفاده از [تالارهای پشتیبانی 13 با ما تماس بگیرید.
همچنین ببینید
برای اطلاعات بیشتر می توانید از لینک های زیر دیدن کنید: