Порівняйте файли MS Word

Microsoft Word підтримує параметр «Порівняти», що дозволяє користувачам порівнювати документи Word і ідентифікувати щойно додані зміни. Ця функція корисна, оскільки ви можете виконувати операцію порівняння тексту в документах Word поруч. Однак програмне рішення перевірки відмінностей тексту може бути набагато швидшим і ефективнішим і може легко виконувати масові операції різниць тексту. У цій статті ми збираємося виконати операцію порівняння тексту за допомогою REST-API, щоб знайти відмінності.

API порівняння тексту

Aspose.Words Cloud SDK для .NET дозволяє створювати, маніпулювати та перетворювати основні формати MS Word (DOC, DOCX, DOCM тощо) в інші підтримувані формати. Водночас він також надає можливість порівнювати документи Word і виділяти різницю. Тепер, щоб використовувати SDK, установіть його з бібліотеки NuGet за допомогою наступної команди на консолі менеджера пакетів:

Install-Package Aspose.Words-Cloud

Щоб отримати додаткову інформацію, перейдіть за наведеним нижче посиланням, щоб дізнатися більше про Як інсталювати Aspose.Cloud SDKs. Тепер після встановлення нам також потрібно створити безкоштовний обліковий запис, відвідавши інформаційну панель Aspose.Cloud. Просто зареєструйтеся за допомогою облікового запису GitHub або Google або натисніть кнопку Створити новий обліковий запис. Облікові дані клієнта, які відображаються на сторінці, використовуватимуться в наступних розділах.

Порівняти текст онлайн за допомогою C#

Нижче наведено кроки та фрагмент коду, які пояснюють подробиці порівняння двох документів Word за допомогою фрагмента коду 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/

// створити екземпляр класу Configuration 
// і надайте свій персональний ідентифікатор клієнта та секретні дані клієнта
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// ініціалізувати об’єкт WordsAPI за допомогою екземпляра Configuration
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 на основі ідентифікатора клієнта та секретних даних клієнта.

 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: - Попередній перегляд оригінального документа та зміненого документа.

Попередній перегляд Text Compare

Зображення 2: - Попередній перегляд порівняння тексту.

Висновок

У цій статті ми пояснили кроки для порівняння документів Word за допомогою API Aspose.Words Cloud. Зауважте, що до API також можна отримати доступ через інтерфейс swagger. Крім того, наші Cloud SDK є відкритими, і їх повний вихідний код можна завантажити з GitHub.

Ми також рекомендуємо відвідати Product Documentation, щоб дізнатися більше про інші цікаві функції, які пропонує API. Ваш відгук дуже важливий для нас. Тому, будь ласка, не соромтеся зв’язуватися з нами через наші форуми підтримки.

Дивіться також

Ви можете переглянути наступні посилання, щоб отримати інформацію про: