การเก็บหลายเวอร์ชันของเอกสาร ODT ให้ตรงกันอาจกลายเป็นปัญหาสำหรับนักพัฒนาที่ต้องตรวจจับการเปลี่ยนแปลงและรวมการแก้ไขโดยอัตโนมัติอย่างรวดเร็ว Aspose.Words Cloud SDK for .NET ทำให้การเปรียบเทียบและการรวมไฟล์ ODT ด้วยโปรแกรมใน .NET ง่ายและเชื่อถือได้ คู่มือนี้จะพาคุณผ่านขั้นตอนการอัปโหลดไฟล์ ODT สองไฟล์ไปยัง Aspose Cloud storage, การสร้างเอกสาร 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 DIFF และรวมไฟล์ด้วย cURL และ REST API
ด้านล่างเป็นคำสั่ง cURL ที่เทียบเท่าซึ่งทำงานเดียวกันของการเปรียบเทียบและรวมข้อมูลกับ Aspose.Words Cloud REST API.
- รับโทเค็นการเข้าถึง
แทนที่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"
- อัปโหลดไฟล์ 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"
- อัปโหลดไฟล์ 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"
- เรียกใช้การดำเนินการเปรียบเทียบ (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" }
}'
- ยอมรับการแก้ไขทั้งหมดเพื่อสร้าง ODT ที่รวม
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- ดาวน์โหลดเอกสาร 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 ที่อธิบายไว้ข้างต้น.
- เริ่มต้นไคลเอนต์ API -
new WordsApi(config)สร้างไคลเอนต์ที่ได้รับการรับรองโดยใช้วัตถุConfigurationที่เก็บClientIdและClientSecretของคุณ.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
- อัปโหลดไฟล์ต้นฉบับ - เมธอดช่วยเหลือ
UploadFileใช้UploadFileRequestเพื่อส่งไฟล์ ODT ในเครื่องแต่ละไฟล์ไปยังโฟลเดอร์จัดเก็บบนคลาวด์.
var uploadRequest = new UploadFileRequest(remotePath, stream);
api.UploadFile(uploadRequest);
-
สร้างอ็อบเจกต์
CompareData- อ็อบเจกต์นี้กำหนดผู้เขียน, ตัวเลือกการเปรียบเทียบ, และอ้างอิงถึงไฟล์ที่แก้ไขแล้ว. มันถูกส่งไปยังCompareDocumentRequest.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
ดำเนินการเปรียบเทียบ -
wordsApi.CompareDocument(compareRequest)ส่งคำขอไปยังบริการ ซึ่งเพิ่มเครื่องหมายการแก้ไขลงในเอกสารต้นฉบับ.
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
- ยอมรับการแก้ไขทั้งหมด -
AcceptAllRevisionsRequestบอกให้บริการทำการรวมการเปลี่ยนแปลง, ผลลัพธ์เป็นไฟล์ ODT ที่สะอาด.
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
แต่ละขั้นตอนสอดคล้องโดยตรงกับคำสั่ง cURL ทำให้คุณมีความยืดหยุ่นในการเลือกใช้ระหว่างไลบรารี .NET และการเรียก HTTP แบบดิบ
การติดตั้งและกำหนดค่า Aspose.Words Cloud SDK for .NET
- เพิ่มแพคเกจ NuGet
dotnet add package Aspose.Words-Cloud
-
Restore packages and build - SDK ทำงานกับ .NET 6.0 และรุ่นต่อไป ตรวจสอบให้แน่ใจว่าโครงการของคุณตั้งค่าเป้าหมายเป็นเฟรมเวิร์กที่เข้ากันได้
-
Configure credentials - แทนค่าตัวแปร placeholder ในโค้ดตัวอย่างด้วย
ClientIdและClientSecretที่คุณได้รับจากแดชบอร์ด Aspose Cloud ของคุณ. -
ดาวน์โหลด SDK - คุณยังสามารถดาวน์โหลดไบนารีล่าสุดจากหน้าปล่อยอย่างเป็นทางการ: Aspose.Words Cloud SDK for .NET Download.
-
ใบอนุญาตสำหรับการผลิต - สำหรับการใช้งานระยะยาว ให้รับใบอนุญาตชั่วคราวหรือถาวรจาก หน้าลิขสิทธิ์ชั่วคราว.
คำถามทั่วไป
-
ฉันจะเปรียบเทียบและรวมไฟล์ ODT อย่างโปรแกรมใน .NET โดยใช้ Aspose.Words Cloud SDK ได้อย่างไร?
ใช้การดำเนินการCompareDocumentและAcceptAllRevisionsที่ให้โดย Aspose.Words Cloud SDK for .NET. อัปโหลดไฟล์ ODT ทั้งสองไฟล์, รันคำขอเปรียบเทียบ, แล้วยอมรับการแก้ไขเพื่อให้ได้ผลลัพธ์ที่รวมแล้ว. -
วิธีการรับรองความถูกต้องที่จำเป็นสำหรับการเรียก REST API คืออะไร?
คุณต้องมี client ID และ client secret เพื่อรับ OAuth 2.0 access token. รวม token นี้ในส่วนหัวAuthorizationของแต่ละคำขอ cURL. -
มีวิธีลอง SDK ก่อนซื้อหรือไม่?
คุณสามารถขอรับลิขสิทธิ์ชั่วคราวจาก หน้าลิขสิทธิ์ชั่วคราว เพื่อประเมินไลบรารีระหว่างการพัฒนา -
ฉันจะหา ตัวอย่างเพิ่มเติมและอ้างอิง API รายละเอียดได้ที่ไหน?
เยี่ยมชม เอกสารอย่างเป็นทางการ และ อ้างอิง API สำหรับคู่มือที่ครอบคลุมและตัวอย่างโค้ด.