여러 버전의 ODT 문서를 동기화 상태로 유지하는 것은 변경 사항을 파악하고 편집을 자동으로 결합해야 하는 개발자에게 큰 골칫거리가 될 수 있습니다. Aspose.Words Cloud SDK for .NET은 .NET에서 ODT 파일을 프로그래밍 방식으로 비교하고 병합하는 작업을 간단하고 신뢰할 수 있게 해줍니다. 이 가이드는 두 개의 ODT 파일을 Aspose Cloud 스토리지에 업로드하고, 차이점 문서를 생성하며, 모든 수정 사항을 수락하여 병합된 파일을 만들고, 결과를 가져오는 과정을 단계별로 안내합니다. 또한 cURL을 사용한 동일한 REST 호출 예시를 확인하고, .NET 프로젝트에서 SDK를 구성하는 방법을 배울 수 있습니다.
.NET에서 ODT 파일을 비교 및 병합하는 전체 작업 예제
이 예제는 두 개의 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);
}
}
}
참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.
cURL 및 REST API로 ODT 파일 DIFF 및 병합 수행
아래는 Aspose.Words Cloud REST API에 대해 동일한 diff 및 merge 워크플로를 수행하는 동등한 cURL 명령입니다.
- 액세스 토큰 얻기
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 문서를 참조하십시오.
.NET에서 ODT 파일을 프로그래밍 방식으로 비교하고 병합하는 방법
코드는 위에서 설명한 REST 워크플로와 동일한 명확한 순서를 따릅니다.
- API 클라이언트 초기화 -
new WordsApi(config)은ClientId와ClientSecret을 보유한Configuration객체를 사용하여 인증된 클라이언트를 생성합니다.
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
-
패키지 복원 및 빌드 - SDK는 .NET 6.0 및 이후 버전과 호환됩니다. 프로젝트가 호환 가능한 프레임워크를 대상으로 하는지 확인하십시오.
-
자격 증명 구성 - 샘플 코드의 자리 표시자 값을 Aspose Cloud 대시보드에서 얻은
ClientId및ClientSecret으로 교체하십시오. -
SDK 다운로드 - 공식 릴리스 페이지에서 최신 바이너리를 다운로드할 수도 있습니다: Aspose.Words Cloud SDK for .NET 다운로드.
-
생산용 라이선스 - 장기 사용을 위해서는 임시 라이선스 페이지에서 임시 또는 영구 라이선스를 획득하십시오.
자주 묻는 질문
-
.NET에서 Aspose.Words Cloud SDK를 사용하여 ODT 파일을 프로그래밍 방식으로 비교하고 병합하려면 어떻게 해야 하나요?
CompareDocument및AcceptAllRevisions작업을 사용하십시오. 이 작업은 Aspose.Words Cloud SDK for .NET에서 제공합니다. 두 ODT 파일을 업로드하고 비교 요청을 실행한 다음, 수정 사항을 수락하여 병합된 결과를 얻습니다. -
REST API 호출에 필요한 인증 방법은 무엇입니까?
OAuth 2.0 액세스 토큰을 얻기 위해 클라이언트 ID와 클라이언트 비밀이 필요합니다. 각 cURL 요청의Authorization헤더에 토큰을 포함하십시오. -
SDK를 구매하기 전에 체험할 수 있는 방법이 있나요?
개발 중에 라이브러리를 평가하려면 임시 라이선스 페이지에서 임시 라이선스를 요청할 수 있습니다. -
더 많은 예제와 자세한 API 참조는 어디서 찾을 수 있나요?
포괄적인 가이드와 코드 샘플을 보려면 공식 문서와 API 참조를 방문하세요.