excel comparison on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/uk/tag/excel-comparison/ Recent content in excel comparison on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io uk Fri, 09 Oct 2026 14:45:06 +0000 Порівняння Excel‑файлів через REST у C# https://blog-qa.groupdocs.cloud/uk/comparison/compare-excel-files-via-rest-in-csharp/ Fri, 09 Oct 2026 14:45:06 +0000 https://blog-qa.groupdocs.cloud/uk/comparison/compare-excel-files-via-rest-in-csharp/ Дізнайтеся, як порівнювати файли Excel за допомогою REST у C# з використанням GroupDocs.Comparison Cloud SDK for .NET. Дотримуйтесь стислого посібника з кодом, cURL та кроками налаштування. Порівняння листів Excel програмно є частою вимогою, коли потрібно виявляти зміни даних, проводити аудит версій або створювати звіти. GroupDocs.Comparison Cloud SDK for .NET надає потужну бібліотеку на базі REST, яка спрощує порівняння файлів Excel через REST у C#. У цьому посібнику ви дізнаєтеся, як завантажувати файли, налаштовувати параметри порівняння, виконувати порівняння та отримувати результат, з прикладами коду на C# та cURL.

Порівняння Excel файлів через REST у C# за 5 кроків

  1. Завантажте вихідний файл XLSX: використайте метод StorageApi.UploadFile, щоб розмістити sample1.xlsx у хмарному сховищі.
using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
{
    var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
    storageApi.UploadFile(uploadRequest1);
}
  1. Завантажте цільовий файл XLSX: повторіть завантаження для sample2.xlsx.
using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
{
    var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
    storageApi.UploadFile(uploadRequest2);
}
  1. Налаштуйте параметри порівняння: створіть об’єкт CompareOptions, вкажіть шляхи до вихідного та цільового файлів, визначте шлях виводу та налаштуйте параметри, такі як GenerateSummaryPage.
var compareOptions = new CompareOptions
{
    SourceFile = new FileInfo { FilePath = remoteFilePath1 },
    TargetFiles = new List<FileInfo>
    {
        new FileInfo { FilePath = remoteFilePath2 }
    },
    OutputPath = remoteResultPath,
    Settings = new Settings
    {
        GenerateSummaryPage = true,
        ShowDeletedContent = true,
        ShowInsertedContent = true
    }
};

Перегляньте повну довідку API для CompareOptions та Settings за посиланням API Reference.
4. Виконайте порівняння: викличте CompareApi.CompareDocument з CompareDocumentRequest.

var compareRequest = new CompareDocumentRequest(compareOptions);
var compareResult = compareApi.CompareDocument(compareRequest);
  1. Завантажте результат і очистіть: отримайте згенерований result.xlsx, збережіть його локально та за потреби видаліть віддалені файли.
var downloadRequest = new DownloadFileRequest(compareResult.Path);
using (var resultStream = storageApi.DownloadFile(downloadRequest))
using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
{
    resultStream.CopyTo(fileStream);
}

// Clean up
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

Повний приклад коду: Порівняння файлів Excel через REST у C# за допомогою GroupDocs.Comparison

Цей приклад демонструє, як завантажити два файли XLSX, порівняти їх і завантажити результат з підсвічуванням.

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;
using GroupDocs.Comparison.Cloud.Sdk.Model.Requests;

namespace CompareExcelFilesExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// APIs
            var compareApi = new CompareApi(config);
            var storageApi = new StorageApi(config);

// Local and remote file names
            string localFilePath1 = "sample1.xlsx";
            string localFilePath2 = "sample2.xlsx";
            string remoteFilePath1 = "sample1.xlsx";
            string remoteFilePath2 = "sample2.xlsx";
            string remoteResultPath = "result.xlsx";
            string localResultPath = "result.xlsx";

// Upload first Excel file
            using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
                storageApi.UploadFile(uploadRequest1);
            }

// Upload second Excel file
            using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
                storageApi.UploadFile(uploadRequest2);
            }

// Prepare comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = new FileInfo { FilePath = remoteFilePath1 },
                TargetFiles = new List<FileInfo>
                {
                    new FileInfo { FilePath = remoteFilePath2 }
                },
                OutputPath = remoteResultPath,
                Settings = new Settings
                {
                    // Example: show changes in a new sheet
                    GenerateSummaryPage = true,
                    ShowDeletedContent = true,
                    ShowInsertedContent = true
                }
            };

// Execute comparison
            var compareRequest = new CompareDocumentRequest(compareOptions);
            var compareResult = compareApi.CompareDocument(compareRequest);

// Download the result file
            var downloadRequest = new DownloadFileRequest(compareResult.Path);
            using (var resultStream = storageApi.DownloadFile(downloadRequest))
            using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
            {
                resultStream.CopyTo(fileStream);
            }

// Optional: clean up remote files
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
            storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

Console.WriteLine("Comparison completed. Result saved to " + localResultPath);
        }
    }
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, чи всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Виклик REST API порівняння за допомогою cURL

Нижче наведено робочий процес cURL, який виконує ту ж операцію без написання коду C#. Замініть заповнювачі реальними обліковими даними та іменами файлів.

  1. Отримати токен доступу
curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. Завантажити вихідний файл XLSX
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample1.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample1.xlsx"
  1. Завантажити цільовий файл XLSX
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample2.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample2.xlsx"
  1. Запустити порівняння
curl -X POST "https://api.groupdocs.cloud/v2.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path": "sample1.xlsx"},
           "target_files": [{"file_path": "sample2.xlsx"}],
           "output_path": "result.xlsx",
           "settings": {
               "generate_summary_page": true,
               "show_deleted_content": true,
               "show_inserted_content": true
           }
         }'
  1. Завантажити результат
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o result.xlsx

Для повного списку кінцевих точок і параметрів перегляньте офіційну документацію API.

Передумови та налаштування

  1. Встановіть пакет .NET через NuGet:
dotnet add package GroupDocs.Comparison-Cloud
  1. Переконайтеся, що у вас є дійсний обліковий запис GroupDocs Cloud і отримайте ваші Client Id та Client Secret з панелі управління.
  2. Потрібен .NET 6.0 або новіший.

Ви можете завантажити останню бібліотеку зі сторінки завантаження.

Тонке налаштування параметрів порівняння

Об’єкт Settings у CompareOptions дозволяє керувати вихідними даними. Загальні налаштування включають:

  • GenerateSummaryPage - додає лист підсумку зі статистикою змін.
  • ShowDeletedContent - підсвічує клітинки, які були видалені.
  • ShowInsertedContent - підсвічує новододані клітинки.

Ці властивості вже використані у наведеному вище прикладі коду. Для додаткових параметрів, таких як захист Password або StyleChangeDetection, зверніться до API довідка.

Висновок

Порівняння Excel‑файлів через REST у C# стає простим завдяки GroupDocs.Comparison Cloud SDK for .NET. Дотримуючись кроків, ви можете завантажити файли XLSX, налаштувати детальні параметри порівняння, виконати порівняння та отримати результуючу книгу, яка чітко позначає відмінності. Пам’ятайте про захист ваших API‑облікових даних, дотримання обмежень розміру файлів і використання тимчасової ліцензії під час розробки. Коли ви будете готові до продакшн‑режиму, придбайте повну ліцензію на сторінці цін, щоб розблокувати необмежене використання.

FAQ

  • Як порівняти файли Excel за допомогою REST у C# з використанням GroupDocs.Comparison?
    Використовуйте SDK для завантаження двох файлів XLSX, встановіть CompareOptions, викличте CompareDocument і завантажте отриманий файл. Повний процес показано у розділах коду та cURL вище.

  • Який метод автентифікації вимагає REST API?
    API використовує OAuth 2.0 з вашим client‑id та client‑secret для отримання токену доступу, який повинен бути переданий у заголовку Authorization: Bearer для кожного запиту.

  • Чи можу я налаштувати, які зміни підсвічуються у результаті порівняння?
    Так. Налаштуйте об’єкт Settings (наприклад, GenerateSummaryPage, ShowDeletedContent, ShowInsertedContent), щоб контролювати вигляд відмінностей.

  • Чи достатня тимчасова ліцензія для тестування?
    Тимчасова ліцензія зі сторінки тимчасової ліцензії підходить для розробки та тестування. Для продакшн‑розгортань необхідно отримати повну ліцензію.

Читати далі

]]> Порівняння Excel‑файлів через REST у C# https://blog-qa.groupdocs.cloud/uk/comparison/compare-excel-files-via-rest-in-csharp/ Mon, 21 Sep 2026 11:32:39 +0000 https://blog-qa.groupdocs.cloud/uk/comparison/compare-excel-files-via-rest-in-csharp/ Дізнайтеся, як порівнювати файли Excel у .NET за допомогою GroupDocs.Comparison Cloud SDK. У цьому посібнику показано інтеграцію REST, код C#, команди cURL та поради. Аналіз змін між версіями електронних таблиць є рутинним завданням для фінансів, звітності та процесів перевірки даних. GroupDocs.Comparison Cloud SDK for .NET надає потужний API, який спрощує порівняння файлів Excel у .NET без ручної перевірки. У цьому посібнику ви дізнаєтеся, як налаштувати бібліотеку, завантажити робочі книги, викликати REST‑endpoint з C#, отримати детальну інформацію про зміни та точно налаштувати параметри порівняння для отримання точних результатів.

Перш ніж почати: вимоги та встановлення

Перш ніж розпочати, переконайтеся, що у вас є наступне:

  • .NET 6.0 або новіша версія встановлена.
  • IDE, наприклад Visual Studio 2022.
  • Обліковий запис GroupDocs Cloud з ClientId та ClientSecret.
  • Доступ до сховища GroupDocs Cloud, куди будуть завантажені файли Excel.

Встановіть SDK через NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Завантажте останній пакет зі сторінки випуску. Після встановлення додайте ваші облікові дані у коді, як показано далі. Тепер ви готові розпочати процес порівняння.

Покроковий посібник з порівняння Excel‑файлів у .NET

Наступні кроки ілюструють, як порівняти файли Excel у .NET за допомогою SDK.

Крок 1: Завантажте вихідний та цільовий документи

Створіть об’єкт конфігурації з вашими обліковими даними та створіть екземпляр CompareApi.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

var compareApi = new CompareApi(config);

Крок 2: Підготуйте Excel книги

Визначте об’єкти FileInfo, які вказують на вихідні та цільові файли XLSX у сховищі GroupDocs Cloud.

var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

Крок 3: Встановити параметри та налаштування порівняння

Налаштуйте об’єкт CompareOptions, включаючи детальні налаштування змін.

var compareOptions = new CompareOptions
{
    SourceFile = sourceFile,
    TargetFiles = new List<FileInfo> { targetFile },
    OutputPath = "output/diff_result.xlsx",
    Settings = new Settings
    {
        ShowDeletedContent = true,
        ShowInsertedContent = true,
        ShowStyleChanges = true,
        GenerateSummaryPage = true
    }
};

Для повного списку налаштувань зверніться до довідка API.

Крок 4: Виконати порівняння та обробити результати

Викличте метод Compare і прочитайте базову інформацію про результат.

var compareResult = compareApi.Compare(compareOptions);
Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

Крок 5: Отримати докладну інформацію про зміни

Якщо вам потрібен детальний звіт, використовуйте запит GetChanges.

var changesRequest = new GetChangesRequest
{
    SourceFile = sourceFile,
    TargetFile = targetFile,
    OutputPath = "output/detailed_changes.json"
};
var detailedChanges = compareApi.GetChanges(changesRequest);
Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");

За допомогою цих кроків ви повністю автоматизували процес порівняння Excel‑файлів у .NET.

Порівняння Excel файлів програмно - Повний приклад коду

Наступний код демонструє повний процес роботи від налаштування до обробки результату.

using System;
using System.Collections.Generic;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;

namespace CompareExcelDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Set up API credentials (replace with your actual credentials)
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// Initialize Compare API
            var compareApi = new CompareApi(config);

// Prepare source and target Excel files (must be uploaded to GroupDocs Cloud storage beforehand)
            var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
            var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

// Define comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = sourceFile,
                TargetFiles = new List<FileInfo> { targetFile },
                OutputPath = "output/diff_result.xlsx",
                // Optional: specify that we want detailed changes for worksheets
                Settings = new Settings
                {
                    ShowDeletedContent = true,
                    ShowInsertedContent = true,
                    ShowStyleChanges = true,
                    GenerateSummaryPage = true
                }
            };

try
            {
                // Call the Compare API
                var compareResult = compareApi.Compare(compareOptions);

// Output basic result information
                Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
                Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

// Iterate through change details
                if (compareResult.Changes != null)
                {
                    foreach (var change in compareResult.Changes)
                    {
                        Console.WriteLine("--------------------------------------------------");
                        Console.WriteLine($"Change Type   : {change.ChangeType}");
                        Console.WriteLine($"Worksheet     : {change.Worksheet}");
                        Console.WriteLine($"Cell Address  : {change.CellAddress}");
                        Console.WriteLine($"Old Value     : {change.OldValue}");
                        Console.WriteLine($"New Value     : {change.NewValue}");
                        Console.WriteLine($"Is New Row    : {change.IsNewRow}");
                        Console.WriteLine($"Is New Column : {change.IsNewColumn}");
                    }
                }

// Retrieve detailed changes via GetChanges (optional)
                var changesRequest = new GetChangesRequest
                {
                    SourceFile = sourceFile,
                    TargetFile = targetFile,
                    OutputPath = "output/detailed_changes.json"
                };
                var detailedChanges = compareApi.GetChanges(changesRequest);
                Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Виконайте порівняння Excel за допомогою REST з cURL

Ви можете досягти того ж результату, не пишучи код C#, викликавши REST API безпосередньо.

1. Аутентифікація та отримання токену доступу

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Завантажте вихідну книгу

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/source.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./source.xlsx"

3. Завантажте цільову книгу

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/target.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./target.xlsx"

4. Виконати порівняння

curl -X POST "https://api.groupdocs.cloud/v1.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path":"input/source.xlsx"},
           "target_files": [{"file_path":"input/target.xlsx"}],
           "output_path":"output/diff_result.xlsx",
           "settings": {
               "show_deleted_content": true,
               "show_inserted_content": true,
               "show_style_changes": true,
               "generate_summary_page": true
           }
         }'

5. Завантажте отриману робочу книгу diff

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file?path=output/diff_result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o diff_result.xlsx

Для повного списку параметрів перегляньте офіційну документацію API.

Висновок

Використовуючи GroupDocs.Comparison Cloud SDK for .NET, ви можете легко порівнювати Excel‑файли у .NET та отримувати детальну diff‑книгу, яка підсвічує кожну зміну. REST‑орієнтована архітектура SDK дозволяє інтегрувати порівняння електронних таблиць у будь‑який C# сервіс, веб‑API або фонове завдання з мінімальними зусиллями. Не забудьте отримати належну ліцензію для використання у продакшн‑режимі; тимчасова ліцензія доступна на сторінці ліцензування, а повна інформація про ліцензування розміщена на сайті продукту. Почніть автоматизувати ваші процеси порівняння Excel вже сьогодні та усуньте помилки ручної перевірки.

Питання та відповіді

  • Як я можу порівняти Excel файли в .NET без написання великої кількості коду?
    SDK абстрагує складну роботу. Вам потрібно лише налаштувати облікові дані, вказати два файли XLSX і викликати compareApi.Compare. Бібліотека повертає файл diff і список об’єктів змін.

  • Який формат використовується для результату diff?
    За замовчуванням результат зберігається у вигляді книги XLSX, зберігаючи оригінальне розташування та додаючи візуальні маркери для видалень, вставок і змін стилю.

  • Чи можливо порівнювати захищені робочі книги Excel?
    Так. Вкажіть пароль у властивості Password об’єкта FileInfo. API розблокує робочу книгу перед виконанням порівняння.

  • Чи потрібна мені ліцензія для розробки та тестування?
    Тимчасову ліцензію можна отримати на license page. Для виробничих розгортань вам потрібно придбати повну ліцензію, як описано на сторінці продукту.

Читати далі

]]>