Comparer les fichiers MS Word

Microsoft Word prend en charge l’option « Comparer » qui permet aux utilisateurs de comparer des documents Word et d’identifier les modifications récemment ajoutées. Cette fonctionnalité est utile car vous pouvez effectuer une opération de comparaison de texte dans des documents Word côte à côte. Cependant, une solution programmatique de vérification des différences de texte peut être beaucoup plus rapide et plus efficace et peut facilement effectuer des opérations de comparaison de texte en masse. Dans cet article, nous allons effectuer une opération de comparaison de texte à l’aide de l’API REST afin de pouvoir trouver les différences.

API de comparaison de texte

Aspose.Words Cloud SDK for .NET vous permet de créer, manipuler et transformer les principaux formats MS Word (DOC, DOCX, DOCM etc.) en d’autres formats pris en charge. En même temps, il offre également la possibilité de comparer des documents Word et de mettre en évidence les différences. Pour utiliser le SDK, veuillez l’installer à partir de NuGet library à l’aide de la commande suivante sur la console du gestionnaire de paquets :

Install-Package Aspose.Words-Cloud

Pour plus d’informations, vous pouvez consulter le lien suivant pour plus d’informations sur Comment installer les SDK Aspose.Cloud. Après l’installation, nous devons également créer un compte gratuit en visitant le tableau de bord Aspose.Cloud. Inscrivez-vous simplement avec votre compte GitHub ou Google ou cliquez sur le bouton Créer un nouveau compte. Les informations d’identification du client affichées sur la page seront utilisées dans les sections suivantes.

Comparer du texte en ligne à l’aide de C#

Vous trouverez ci-dessous les étapes et l’extrait de code expliquant les détails sur la façon de comparer deux documents Word à l’aide de l’extrait de code C# .NET.

  • Tout d’abord, nous devons définir les informations ClientID et ClientSecret dans le code.
  • Deuxièmement, créez un objet de la classe Configuration en fournissant les détails ClientID et ClientSecret comme arguments.
  • Troisièmement, créez un objet de classe WordsApi et transmettez l’instance Configuration comme argument.
  • Créez maintenant une instance de la classe CompareData.
  • Afin d’identifier spécifiquement le nom de la personne telle qu’identifiée dans le fichier résultant, utilisez la propriété Author de la classe CompareData.
  • La propriété ComparingWithDocument de la classe CompareData est utilisée pour spécifier le document cible pour comparer le contenu.
  • Créez maintenant une instance de la classe CompareDocumentRequest qui prend le fichier d’entrée/source, l’objet CompareData et le nom du fichier résultant comme arguments.
  • Enfin, appelez la méthode CompareDocument(..) pour lancer l’opération de comparaison.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get Client Id from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get Client Secret from https://dashboard.aspose.cloud/

// créer une instance de la classe Configuration 
// et fournissez votre identifiant client personnalisé et les détails de votre secret client
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// initialiser l'objet WordsAPI à l'aide de l'instance de configuration
var wordsApi = new WordsApi(config);
// premier document d'entrée
string firstDocument = "file-sample.docx";
// deuxième document à comparer avec
string secondFile = "file-sample-updated.docx";
// nom du fichier résultant
string resultantFile = "Out_ComparedTestDocs.docx";

// Créer une instance de la classe CompareData
CompareData compareData = new CompareData();
// nom à utiliser comme auteur identifiant les différences
compareData.Author = "Nayyer";
// spécifier le document à comparer avec
compareData.ComparingWithDocument = secondFile;
compareData.DateTime = DateTime.Now;
// créer une instance de demande en fournissant la source, le document à comparer et le nom du fichier résultant
CompareDocumentRequest request = new CompareDocumentRequest(firstDocument, compareData, null, null, null, null, resultantFile);
// lancer la comparaison des documents
DocumentResponse result = wordsApi.CompareDocument(request);

Les fichiers d’exemple utilisés dans les exemples ci-dessus peuvent être téléchargés à partir des liens suivants

Comparer des documents Word à l’aide des commandes cURL

Dans cette section, nous allons découvrir les étapes à suivre pour comparer des documents Word à l’aide des commandes cURL. Étant donné que nos API ne sont accessibles qu’au personnel autorisé, veuillez exécuter la commande suivante pour créer un jeton d’accès JWT basé sur les détails de l’ID client et du secret client.

 curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

La commande cURL ci-dessous montre comment effectuer une comparaison de fichiers en ligne à l’aide de la commande cURL. Elle accède à la méthode CompareDocument et le résultat de cette opération est écrit dans le document de sortie qui contient le suivi des modifications sous forme de nombre de révisions d’édition et de format. Veuillez noter que si vous ne fournissez pas les détails du document de sortie, les révisions sont enregistrées dans le document d’origine.

curl -X PUT "https://api.aspose.cloud/v4.0/words/file-sample.docx/compareDocument?destFileName=ComparisonResult.docx" \
-H  "accept: application/json" 
-H  "Authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{\"ComparingWithDocument\":\"file-sample-updated.docx\",\"Author\":\"Nayyer\",\"DateTime\":\"2021-04-27T16:50:55.869Z\",\"CompareOptions\":{\"IgnoreCaseChanges\":true,\"IgnoreTables\":true,\"IgnoreFields\":true,\"IgnoreFootnotes\":true,\"IgnoreComments\":true,\"IgnoreTextboxes\":true,\"IgnoreFormatting\":true,\"IgnoreHeadersAndFooters\":true,\"Target\":\"Current\"}}"

Une fois la commande exécutée, les informations supprimées sont spécifiées séparément et le contenu nouvellement ajouté est surligné en jaune.

Aperçu du document original et modifié

Image 1 : Aperçu du document original et du document modifié.

Aperçu de la comparaison de texte

Image 2 : Aperçu de la comparaison de texte.

Conclusion

Dans cet article, nous avons expliqué les étapes à suivre pour comparer des documents Word à l’aide de l’API Cloud Aspose.Words. Veuillez noter que les API sont également accessibles via l’interface Swagger. De plus, nos SDK Cloud sont open source et leur code source complet peut être téléchargé depuis GitHub.

Nous vous recommandons également de consulter la Documentation du produit pour plus de détails sur les autres fonctionnalités intéressantes proposées par l’API. Vos commentaires sont très importants pour nous. N’hésitez donc pas à nous contacter via nos Forums d’assistance.

Voir aussi

Vous pouvez envisager de visiter les liens suivants pour obtenir des informations sur :