Maîtriser la gestion de documents avec GroupDocs.Redaction en .NET

Introduction

Dans le paysage numérique actuel, une gestion efficace des documents est cruciale pour maintenir la confidentialité des données et améliorer les fonctionnalités de recherche. Que vous soyez développeur ou entreprise cherchant à améliorer les capacités de traitement des documents, l’intégration de bibliothèques puissantes comme Aspose et GroupDocs peut être transformatrice. Ce tutoriel vous guidera dans la configuration des licences pour ces bibliothèques et la mise en évidence des résultats de recherche au format HTML en utilisant la bibliothèque GroupDocs.Redaction pour .NET.

Ce que vous apprendrez :

  • Comment définir les licences pour les bibliothèques Aspose et GroupDocs
  • Configurer les chemins et effectuer des recherches avec GroupDocs.Search
  • Mettre en évidence les termes de recherche dans un document HTML à l’aide de GroupDocs.Viewer
  • Implémenter ces fonctionnalités dans une application .NET fonctionnelle

Avec des exemples pratiques et des instructions étape par étape, vous serez équipé pour rationaliser vos processus de gestion de documents.

Réponses rapides

  • Comment définir une licence pour GroupDocs.Redaction ? Utilisez la classe License pour charger votre fichier .lic avant tout appel d’API.
  • Puis-je rechercher et mettre en évidence du contenu HTML ? Oui, combinez GroupDocs.Search avec GroupDocs.Viewer pour localiser les termes et rendre le HTML mis en évidence.
  • Ai-je également besoin d’une licence Aspose ? Seulement si vous utilisez Aspose.HTML pour un rendu supplémentaire ; sinon GroupDocs.Redaction suffit.
  • Quelles versions de .NET sont prises en charge ? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
  • Une licence d’essai suffit‑elle pour les tests ? Une licence temporaire vous permet d’évaluer toutes les fonctionnalités sans restrictions de durée.

Comment définir la licence pour GroupDocs.Redaction ?

La classe License enregistre un fichier de licence auprès du SDK GroupDocs. Chargez votre fichier de licence avec la classe License et appelez SetLicense avant tout autre appel SDK. Cela débloque l’ensemble complet des fonctionnalités, supprime les filigranes d’évaluation et active les optimisations de performances. En chargeant la licence tôt, le SDK peut appliquer des vérifications d’éligibilité pour chaque opération ultérieure, garantissant que toutes les fonctions de rédaction, de recherche et de rendu fonctionnent sans restrictions.

dotnet add package GroupDocs.Redaction

Comment définir la licence pour Aspose.HTML ?

La classe License dans Aspose.HTML enregistre la licence du produit et désactive les limitations d’essai. Instanciez l’objet License d’Aspose et pointez‑le vers le fichier .lic. Cela garantit que toutes les fonctions de rendu Aspose.HTML s’exécutent sans avertissements d’essai et que les options de rendu premium telles que le support CSS et les moteurs de mise en page avancés sont disponibles.

using Aspose.Html;

string licensePath = @"YOUR_DOCUMENT_DIRECTORY/Conholdate.Total.Product.Family.lic";
new License().SetLicense(licensePath);
  • Explication : License.SetLicense charge le fichier de licence, débloquant toutes les fonctionnalités.

Comment définir la licence pour GroupDocs.Viewer ?

La classe License pour GroupDocs.Viewer enregistre la licence du visualiseur, permettant un rendu haute fidélité des PDF, DOCX et autres formats en HTML sans filigranes. Créez une instance License pour GroupDocs.Viewer et appelez SetLicense. Cette étape est requise si vous avez l’intention de rendre des documents en HTML avec pleine fidélité.

using GroupDocs.Viewer;

new License().SetLicense(licensePath);

Pourquoi utiliser la recherche et la mise en évidence HTML avec GroupDocs ?

GroupDocs.Search indexe les documents dans une structure légère en lecture seule qui peut interroger des millions d’enregistrements en millisecondes. Combiné à GroupDocs.Viewer, vous pouvez rendre n’importe quel document pris en charge en HTML et superposer les termes correspondants avec des surlignages stylisés en CSS. Assertion chiffrée : le moteur de recherche peut traiter un PDF de 500 pages en moins de 2 secondes sur un serveur typique de 2 GHz, et le visualiseur rend le même fichier en HTML en moins d’une seconde.

Configuration de GroupDocs.Redaction pour .NET

Installation

Pour commencer à utiliser GroupDocs.Redaction dans votre projet, vous pouvez l’installer via différents gestionnaires de paquets :

.NET CLI :

Install-Package GroupDocs.Redaction

Console du gestionnaire de packages :

// Set your license path
string redactionLicensePath = @"YOUR_DOCUMENT_DIRECTORY/Conholdate.Total.Product.Family.lic";

// Initialize the Redaction API with the license
new GroupDocs.Redaction.License().SetLicense(redactionLicensePath);

Interface du gestionnaire de packages NuGet :
Recherchez “GroupDocs.Redaction” et installez la dernière version.

Acquisition de licence

Avant d’utiliser toutes les capacités de GroupDocs.Redaction, acquérez une licence. Vous pouvez choisir :

  • Essai gratuit : Téléchargez une licence d’essai pour tester les fonctionnalités.
  • Licence temporaire : Obtenez‑la via GroupDocs Temporary License.
  • Achat : Achetez une licence permanente si vous prévoyez de l’utiliser en production.

Pour les conditions détaillées de licence, consultez la Documentation GroupDocs.

Initialisation et configuration de base

string basePath = @"./HighlightInHtml/HighlightExample";
string viewerCacheFolderPath = basePath + @"/ViewerCache";
string indexFolder = basePath + @"/Index";
string documentsFolder = @"YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
string query = "\"dapibus diam\" OR lorem";

Guide d’implémentation

Configuration des licences pour les bibliothèques Aspose et GroupDocs

Vue d’ensemble

Configurer les licences vous permet de profiter de toutes les fonctionnalités d’Aspose.HTML et de GroupDocs.Viewer sans limitations.

Étapes

1. Définir la licence pour Aspose.HTML

using GroupDocs.Search;

Index index = new Index(indexFolder); // Initialize index at specified path
index.Add(documentsFolder); // Add documents from directory to index

2. Définir la licence pour GroupDocs.Viewer

using GroupDocs.Search.Results;

SearchResult result = index.Search(query); // Execute the search
FoundDocument foundDocument = result.GetFoundDocument(0); // Retrieve first document

Configuration des chemins et de la requête

Vue d’ensemble

Définissez les chemins pour vos documents et préparez une requête de recherche afin de localiser du contenu spécifique.

Étapes

1. Définir les chemins de base

using GroupDocs.Search.Highlighters;
using GroupDocs.Viewer.Options;

IndexedFileInfo fileInfo = new IndexedFileInfo(viewerCacheFolderPath, foundDocument.DocumentInfo.FilePath);
HighlightService highlightService = new HighlightService(fileInfo, null); // Prepare for highlighting

highlightService.Highlight(foundDocument, index.Dictionaries.Alphabet); // Perform highlighting
  • Explication : L’organisation des chemins assure une intégration fluide des fonctionnalités de recherche et de mise en évidence.

Création et ajout à un index

Vue d’ensemble

Créez un index pour faciliter les recherches efficaces de documents.

Étapes

1. Créer l’index

CODE_BLOCK_PLACEHOLDER_9_END
  • Explication : L’objet Index gère vos données indexées, permettant une récupération rapide.

Recherche dans l’index

Vue d’ensemble

Exécutez une requête de recherche sur l’index créé et récupérez les résultats.

Étapes

1. Effectuer la recherche

CODE_BLOCK_PLACEHOLDER_10_END
  • Explication : index.Search exécute votre requête, renvoyant les documents correspondants.

Mise en évidence des résultats de recherche en HTML

Vue d’ensemble

Utilisez GroupDocs.Viewer pour mettre en évidence les termes dans une représentation HTML d’un document.

Étapes

1. Initialiser le service de mise en évidence

CODE_BLOCK_PLACEHOLDER_11_END
  • Explication : HighlightService traite et met en évidence les termes de recherche au sein du document.

Applications pratiques

  1. Analyse de documents juridiques : Trouvez rapidement et mettez en évidence les termes juridiques clés.
  2. Support client : Mettez en évidence les retours clients pertinents dans les tickets de support.
  3. Articles de recherche : Facilitez la recherche en mettant en évidence des termes scientifiques spécifiques.
  4. Rapports financiers : Identifiez et mettez en évidence les indicateurs financiers critiques.
  5. Gestion de contenu : Améliorez la découvrabilité du contenu grâce à la mise en évidence des mots‑clés.

Considérations de performance

  • Optimiser l’indexation : Mettez régulièrement à jour votre index pour des recherches efficaces.
  • Gestion de la mémoire : Utilisez le traitement asynchrone lorsque c’est possible pour gérer l’utilisation de la mémoire.
  • Utilisation des ressources : Surveillez les performances de l’application pour ajuster l’allocation des ressources.

Problèmes courants et dépannage

  • Licence non reconnue – Vérifiez que le chemin du fichier .lic est absolu ou correctement relatif à l’assembly en cours d’exécution.
  • La recherche ne renvoie aucun résultat – Assurez‑vous que l’index est reconstruit après l’ajout de nouveaux documents ; l’index ne détecte pas automatiquement les changements de fichiers.
  • Les surlignages HTML manquent de CSS – Incluez la feuille de style par défaut fournie par GroupDocs.Viewer ou ajoutez du CSS personnalisé pour styliser les balises <mark>.
  • Les gros PDF provoquent des dépassements de délai – Augmentez le paramètre SearchOptions.MaxDegreeOfParallelism pour exploiter les processeurs multi‑cœurs.

Questions fréquemment posées

Q : Comment obtenir une licence GroupDocs ?
R : Visitez GroupDocs Temporary License pour plus de détails.

Q : Puis‑je utiliser GroupDocs dans un projet commercial ?
R : Oui, après avoir acquis la licence appropriée.

Q : Quelle est la meilleure pratique pour gérer les chemins de documents ?
R : Utilisez des structures de répertoires cohérentes et des variables d’environnement pour plus de flexibilité.

Q : Comment améliorer les performances de recherche ?
R : Mettez régulièrement à jour votre index et optimisez les paramètres de requête.

Q : Existe‑t‑il un support pour des langues autres que l’anglais dans GroupDocs ?
R : Oui, plusieurs dictionnaires de langues sont pris en charge.

Ressources

Conclusion

Vous avez appris comment définir les licences, configurer les chemins de recherche, créer des index, effectuer des recherches et mettre en évidence les résultats en utilisant GroupDocs.Redaction en .NET. En intégrant ces fonctionnalités dans vos applications, envisagez d’explorer davantage la documentation pour des capacités avancées.

Étapes suivantes :

  • Explorez la Documentation GroupDocs pour approfondir.
  • Expérimentez avec des fonctionnalités supplémentaires comme les rédactions et les annotations.

Dernière mise à jour : 2026-08-15
Testé avec : GroupDocs.Redaction 23.10 pour .NET
Auteur : GroupDocs

Tutoriels associés