Maintenir plusieurs versions d’un document ODT synchronisées peut rapidement devenir un casse‑tête pour les développeurs qui doivent repérer les changements et combiner les modifications automatiquement. Aspose.Words Cloud SDK for .NET rend la comparaison et la fusion de fichiers ODT programmatiquement en .NET simples et fiables. Ce guide vous explique comment télécharger deux fichiers ODT vers le stockage Aspose Cloud, générer un document de différences, accepter toutes les révisions pour produire un fichier fusionné et récupérer le résultat. Vous verrez également les appels REST équivalents avec cURL et apprendrez comment configurer le SDK dans votre projet .NET.
Exemple complet et fonctionnel de comparaison et de fusion de fichiers ODT programmatiquement en .NET
Cet exemple montre comment comparer deux fichiers ODT, générer un document de révision, accepter toutes les révisions et télécharger le ODT final fusionné.
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);
}
}
}
Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.
Effectuer la DIFF et la fusion de fichiers ODT avec cURL et l’API REST
Voici les commandes cURL équivalentes qui exécutent le même flux de travail de diff et de fusion contre l’API REST Aspose.Words Cloud.
- Obtenir un jeton d’accès
RemplacezYOUR_CLIENT_IDetYOUR_CLIENT_SECRETpar vos informations d’identification.
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Téléverser le fichier ODT original
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"
- Téléverser le fichier ODT révisé
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"
- Exécuter l’opération de comparaison (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" }
}'
- Accepter toutes les révisions pour créer le ODT fusionné
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Télécharger le document ODT fusionné
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
Pour plus de détails sur les corps de requête et les options supplémentaires, consultez la documentation officielle de l’API.
Comment la comparaison et la fusion de fichiers ODT de manière programmatique en .NET fonctionnent
Le code suit une séquence claire qui reflète le flux de travail REST décrit ci-dessus.
- Initialiser le client API -
new WordsApi(config)crée un client authentifié en utilisant l’objetConfigurationqui contient votreClientIdetClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Télécharger les fichiers source - La méthode d’assistance
UploadFileutiliseUploadFileRequestpour envoyer chaque fichier ODT local vers le dossier de stockage cloud.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Créer un objet
CompareData- Cet objet définit l’auteur, les options de comparaison et une référence au fichier révisé. Il est transmis àCompareDocumentRequest.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
Exécuter l’opération de comparaison -
wordsApi.CompareDocument(compareRequest)envoie la requête au service, qui ajoute des marques de révision au document original.var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder); wordsApi.CompareDocument(compareRequest); -
Accepter toutes les révisions -
AcceptAllRevisionsRequestindique au service de fusionner les modifications, produisant un fichier ODT propre.var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder); wordsApi.AcceptAllRevisions(acceptRequest);
Chaque étape correspond directement aux commandes cURL, vous offrant la flexibilité de choisir entre la bibliothèque .NET et les appels HTTP bruts.
Installation et configuration Aspose.Words Cloud SDK for .NET
- Ajouter le package NuGet
dotnet add package Aspose.Words-Cloud
-
Restaurer les packages et compiler - Le SDK fonctionne avec .NET 6.0 et versions ultérieures. Assurez‑vous que votre projet cible un framework compatible.
-
Configurer les informations d’identification - Remplacez les valeurs de substitution dans le code d’exemple par le
ClientIdet leClientSecretque vous obtenez depuis votre tableau de bord Aspose Cloud. -
Télécharger le SDK - Vous pouvez également télécharger les dernières binaires depuis la page officielle de publication : Aspose.Words Cloud SDK for .NET Download.
-
Licence pour la production - Pour une utilisation à long terme, obtenez une licence temporaire ou permanente depuis la page de licence temporaire.
Questions fréquentes
-
Comment puis‑je comparer et fusionner des fichiers ODT programmatiquement en .NET en utilisant Aspose.Words Cloud SDK ?
Utilisez les opérationsCompareDocumentetAcceptAllRevisionsfournies par Aspose.Words Cloud SDK for .NET. Téléversez les deux fichiers ODT, exécutez la requête de comparaison, puis acceptez les révisions pour obtenir le résultat fusionné. -
Quelle méthode d’authentification est requise pour les appels REST API ?
Vous avez besoin d’un ID client et d’un secret client pour obtenir un jeton d’accès OAuth 2.0. Incluez le jeton dans l’en-têteAuthorizationde chaque requête cURL. -
Existe-t-il un moyen d’essayer le SDK avant l’achat ?
Vous pouvez demander une licence temporaire depuis la page de licence temporaire pour évaluer la bibliothèque pendant le développement. -
Où puis‑je trouver plus d’exemples et une référence API détaillée ?
Consultez la documentation officielle et la référence API pour des guides complets et des exemples de code.