שמירה על סינכרון של גרסאות מרובות של מסמך ODT יכולה להפוך במהירות לכאב ראש עבור מפתחים שצריכים לזהות שינויים ולשלב עריכות באופן אוטומטי. Aspose.Words Cloud SDK for .NET מאפשר השוואה ומיזוג של קבצי ODT באופן תכנותי ב‑.NET בצורה פשוטה ואמינה. מדריך זה מוביל אותך בתהליך העלאת שני קבצי ODT לאחסון Aspose Cloud, יצירת מסמך diff, קבלת כל התיקונים ליצירת קובץ משולב, והבאת התוצאה. בנוסף תראה את קריאות ה‑REST המקבילות באמצעות cURL, ותלמד כיצד להגדיר את ה‑SDK בפרויקט .NET שלך.

דוגמה מלאה עובדת להשוואה ולמיזוג קבצי ODT באופן תכנותי ב-.NET

דוגמה זו מציגה כיצד להשוות שני קבצי ODT, ליצור מסמך גרסה, לקבל את כל השינויים ולהוריד את קובץ ה‑ODT הממוזג הסופי.

using System;
using System.IO;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

class Program
{
    static void Main()
    {
        // ==== Set up Aspose.Words Cloud SDK ====
        var clientId = "YOUR_CLIENT_ID";
        var clientSecret = "YOUR_CLIENT_SECRET";

var config = new Configuration
        {
            ClientId = clientId,
            ClientSecret = clientSecret
        };

var wordsApi = new WordsApi(config);

// ==== Define file names and storage folder ====
        string storageFolder = "Documents";
        string originalFile = "original.odt";
        string revisedFile = "revised.odt";
        string compareResultFile = "compareResult.odt";
        string mergedFile = "merged.odt";

// ==== Upload local ODT files to Aspose Cloud storage ====
        UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, originalFile),
            $"{storageFolder}/{originalFile}");
        UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, revisedFile),
            $"{storageFolder}/{revisedFile}");

// ==== Perform comparison (diff) ====
        var compareData = new CompareData
        {
            Author = "Comparer",
            CompareOptions = new CompareOptions
            {
                IgnoreCaseChanges = false,
                IgnoreComments = false,
                IgnoreFormatting = false,
                IgnoreHeadersAndFooters = false,
                IgnoreTables = false,
                IgnoreFields = false,
                IgnoreFootnotes = false,
                IgnoreTextboxes = false,
                IgnoreInsertedParagraphs = false,
                IgnoreDeletedParagraphs = false
            },
            FileReference = new FileReference($"{storageFolder}/{revisedFile}")
        };

var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
        wordsApi.CompareDocument(compareRequest);

// ==== Download the document that now contains revisions (diff result) ====
        var downloadDiff = new DownloadFileRequest($"{storageFolder}/{originalFile}");
        using (var diffStream = wordsApi.DownloadFile(downloadDiff))
        using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, compareResultFile)))
        {
            diffStream.CopyTo(fileStream);
        }

// ==== Accept all revisions to produce the merged document ====
        var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
        wordsApi.AcceptAllRevisions(acceptRequest);

// ==== Download the merged ODT document ====
        var downloadMerged = new DownloadFileRequest($"{storageFolder}/{originalFile}");
        using (var mergedStream = wordsApi.DownloadFile(downloadMerged))
        using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, mergedFile)))
        {
            mergedStream.CopyTo(fileStream);
        }

// ==== Simple verification ====
        var info = new FileInfo(mergedFile);
        Console.WriteLine($"Merged document saved as '{mergedFile}' (size: {info.Length} bytes).");
    }

static void UploadFile(WordsApi api, string localPath, string remotePath)
    {
        using (var stream = File.OpenRead(localPath))
        {
            var uploadRequest = new UploadFileRequest(remotePath, stream);
            api.UploadFile(uploadRequest);
        }
    }
}

הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בפרויקט שלך, ודא שאתה מעדכן את כל נתיבי הקבצים וערכי התצורה כדי להתאים לסביבה האמיתית שלך, מאמת שכל התלויות הנדרשות מותקנות כראוי, ובודק באופן יסודי בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא פנה לתיעוד הרשמי או פנה לצוות התמיכה לקבלת עזרה.

בצע ODT File DIFF ומיזוג עם cURL ו-REST API

להלן פקודות cURL המקבילות שמבצעות את זרימת העבודה של diff ו‑merge כנגד ה‑Aspose.Words Cloud REST API.

  1. קבל אסימון גישה
    החלף את YOUR_CLIENT_ID ו-YOUR_CLIENT_SECRET עם האישורים שלך.
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. העלה את קובץ ODT המקורי
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@original.odt"
  1. העלה את קובץ ODT המתוקן
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/revised.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@revised.odt"
  1. הפעל את פעולת ההשוואה (diff)
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "author": "Comparer",
           "compareOptions": {
               "ignoreCaseChanges": false,
               "ignoreComments": false,
               "ignoreFormatting": false,
               "ignoreHeadersAndFooters": false,
               "ignoreTables": false,
               "ignoreFields": false,
               "ignoreFootnotes": false,
               "ignoreTextboxes": false,
               "ignoreInsertedParagraphs": false,
               "ignoreDeletedParagraphs": false
           },
           "fileReference": { "href": "Documents/revised.odt" }
         }'
  1. קבל את כל התיקונים כדי ליצור את קובץ ODT המשולב
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. הורד את מסמך ODT המשולב
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

למידע נוסף על גופי הבקשה ואפשרויות נוספות, ראה את תיעוד ה‑API הרשמי.

איך השוואה ומיזוג קבצי ODT בתכנות ב-.NET פועלים

הקוד פועל לפי סדר ברור המשקף את זרימת העבודה של REST המתוארת למעלה.

  1. אתחול לקוח ה-API - new WordsApi(config) יוצר לקוח מאומת באמצעות אובייקט Configuration שמחזיק את ClientId ו-ClientSecret שלך.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. העלאת קבצי מקור - המתודה העזרית UploadFile משתמשת ב-UploadFileRequest כדי לשלוח כל קובץ ODT מקומי לתיקיית האחסון בענן.
var uploadRequest = new UploadFileRequest(remotePath, stream);
api.UploadFile(uploadRequest);
  1. צור אובייקט CompareData - אובייקט זה מגדיר את המחבר, אפשרויות ההשוואה, והפניה לקובץ המתוקן. הוא מועבר ל-CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  2. הפעל את פעולת ההשוואה - wordsApi.CompareDocument(compareRequest) שולח את הבקשה לשירות, שמוסיף סימוני גרסה למסמך המקורי.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  3. קבל את כל התיקונים - AcceptAllRevisionsRequest מודיע לשירות למזג את השינויים, וליצור קובץ ODT נקי.

var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);

כל שלב מתאים ישירות לפקודות cURL, ומספק לך גמישות לבחור בין ספריית .NET לקריאות HTTP גולמיות.

התקנה וקונפיגורציה Aspose.Words Cloud SDK for .NET

  1. הוסף את חבילת NuGet
dotnet add package Aspose.Words-Cloud
  1. שחזור חבילות ובנייה - ה‑SDK עובד עם .NET 6.0 ומעלה. ודא שהפרויקט שלך ממקד מסגרת תואמת.

  2. הגדר אישורים - החלף את ערכי מציין המקום בקוד הדוגמה עם ClientId ו-ClientSecret שאתה מקבל מלוח המחוונים של Aspose Cloud.

  3. הורד את ה‑SDK - אתה יכול גם להוריד את הקבצים הבינאריים העדכניים מדף ההפצה הרשמי: Aspose.Words Cloud SDK for .NET Download.

  4. רישיון לייצור - לשימוש ארוך‑טווח, רכש רישיון זמני או קבוע מדף דף רישיון זמני.

שאלות נפוצות

  • איך אפשר להשוות ולמזג קבצי ODT באופן תכנותי ב-.NET באמצעות Aspose.Words Cloud SDK?
    השתמש בפעולות CompareDocument ו-AcceptAllRevisions המסופקות על ידי Aspose.Words Cloud SDK for .NET. העלה את שני קבצי ה‑ODT, הפעל את בקשת ההשוואה, ואז קבל את השינויים כדי לקבל את התוצאה הממוזגת.

  • איזה שיטת אימות נדרשת עבור קריאות ה-REST API?
    אתה צריך client ID ו‑client secret כדי לקבל אסימון גישה של OAuth 2.0. כלול את האסימון בכותרת Authorization של כל בקשת cURL.

  • האם יש דרך לנסות את ה‑SDK לפני הרכישה?
    באפשרותך לבקש רישיון זמני מדף ה-דף הרישיון הזמני כדי להעריך את הספרייה במהלך הפיתוח.

  • היכן ניתן למצוא עוד דוגמאות והפניות API מפורטות?
    בקרו בתיעוד הרשמי ובהפניות API לקבלת מדריכים מקיפים ודוגמאות קוד.

מאמרים קשורים