L’intégration dans une application web ASP.NET Core permet une édition de documents fluide directement dans votre portail web. GroupDocs.Editor Cloud SDK for .NET fournit une API puissante qui vous permet de charger, modifier et enregistrer des fichiers DOCX sur le serveur. Ce guide vous accompagne à travers la configuration requise, montre le code étape par étape, et fournit un exemple complet que vous pouvez exécuter en quelques minutes. À la fin, vous serez capable d’ajouter l’édition de documents à une application ASP.NET Core en toute confiance.

Prérequis et configuration

Avant de commencer, assurez‑vous d’avoir les éléments suivants :

  • .NET 6.0 SDK ou version ultérieure installé
  • Un IDE tel que Visual Studio 2022 ou VS Code
  • Un compte GroupDocs Cloud pour obtenir Client Id et Client Secret
  • Accès à une machine de développement Windows, Linux ou macOS

L’intégration dans une application web ASP.NET Core nécessite également une connexion réseau fiable aux points de terminaison GroupDocs Cloud, car tout le traitement des documents se fait à distance. Planifiez votre environnement de déploiement en conséquence.

Installez le SDK via NuGet:

dotnet add package GroupDocs.editor-Cloud

Téléchargez le dernier package depuis la page de publication officielle : GroupDocs.Editor Cloud SDK for .NET Download.

Créez un objet de configuration avec vos informations d’identification (extrait de l’exemple complet) :

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Avec le package installé et les informations d’identification prêtes, vous pouvez passer à l’implémentation. Les sections suivantes expliquent chaque morceau de code en détail, afin que vous compreniez comment la bibliothèque s’intègre dans l’architecture globale d’une application web ASP.NET Core.

Guide étape par étape pour l’intégration dans une application Web ASP.NET Core

Cette section décompose le processus d’intégration dans une application web ASP.NET Core en étapes distinctes et gérables. Chaque étape comprend un petit fragment de code tiré directement de l’implémentation de référence.

Étape 1 : Configurer les informations d’identification de l’API

Tout d’abord, créez une instance de l’objet Configuration avec les détails de votre client et créez le client EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

La classe EditorApi est documentée dans la référence API. Initialiser le client une fois par requête suffit pour la plupart des scénarios ; vous pouvez également l’enregistrer en tant que singleton dans le conteneur d’injection de dépendances ASP.NET Core pour de meilleures performances.

Étape 2 : Définir les options de chargement

Spécifiez le fichier source et l’emplacement de sortie souhaité en utilisant LoadOptions. Cet objet indique au service quel document ouvrir et où stocker le HTML rendu.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo et RenderOptions vous permettent de contrôler la façon dont le document est rendu pour l’édition. Par exemple, vous pouvez définir RenderOptions pour inclure des images, préserver les styles d’origine ou limiter le nombre de pages rendues.

Étape 3: Appeler LoadDocument

Appelez l’API pour charger et convertir le document. L’appel est synchrone dans cet exemple, mais vous pouvez également utiliser la version asynchrone si votre action de contrôleur est asynchrone.

var loadResult = editorApi.LoadDocument(loadOptions);

La méthode LoadDocument renvoie un objet résultat contenant des URL vers le HTML rendu et d’autres métadonnées. Vous pouvez stocker le loadResult pour une récupération ultérieure ou transmettre le HTML directement au front‑end.

Étape 4 : Traitement du résultat du chargement

Après le chargement, vous pouvez servir le HTML au front‑end ou le stocker pour une utilisation ultérieure. Cette étape complète le flux de travail intégration de l’éditeur de documents dans une application web ASP.NET Core et prépare le document pour l’interaction de l’utilisateur.

Dans un scénario réel, vous retourneriez généralement le contenu HTML depuis une action de contrôleur :

return Content(loadResult.HtmlContent, "text/html");

Vous pouvez également envisager de mettre en œuvre la mise en cache afin d’éviter de recharger le même document à plusieurs reprises, ce qui peut améliorer les temps de réponse lors de l’intégration dans une application web ASP.NET Core à grande échelle.

Intégration de Document Editor dans une application Web ASP.NET Core - Exemple de code complet

Le code suivant montre l’ensemble du processus, de la configuration au chargement d’un fichier DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

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.

Utilisation de cURL pour l’intégration de l’édition de documents ASP.NET Core

Si vous préférez une approche REST directe, la même opération peut être effectuée avec des commandes cURL. Cette méthode est utile pour un prototypage rapide ou lorsque vous devez intégrer l’éditeur dans un service qui n’est pas écrit en .NET.

1. Authentifier et obtenir le jeton d’accès

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

La réponse contient un access_token utilisé dans les appels suivants.

2. Téléverser le fichier source

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Charger le document pour l’édition

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Télécharger le HTML rendu

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Ces commandes illustrent comment ajouter l’édition de documents à une application ASP.NET Core sans écrire de code C#, ce qui est utile pour des tests rapides ou une intégration avec d’autres services. Pour plus de détails, consultez la documentation officielle de l’API.

En maîtrisant à la fois la bibliothèque .NET et l’API REST brute, vous gagnez en flexibilité lors de l’intégration dans une application web ASP.NET Core, vous permettant de choisir l’approche qui correspond le mieux à votre architecture.

FAQ

Lectures complémentaires