Integrar en una aplicación web ASP.NET Core permite una edición de documentos sin problemas directamente dentro de su portal web. GroupDocs.Editor Cloud SDK for .NET proporciona una API potente que le permite cargar, editar y guardar archivos DOCX en el servidor. Esta guía lo lleva a través de la configuración requerida, muestra código paso a paso y proporciona un ejemplo completo que puede ejecutar en minutos. Al final podrá agregar la edición de documentos a una aplicación ASP.NET Core con confianza.

Requisitos y Configuración

Antes de comenzar, asegúrese de tener lo siguiente:

  • .NET 6.0 SDK o posterior instalado
  • Un IDE como Visual Studio 2022 o VS Code
  • Una cuenta de GroupDocs Cloud para obtener Client Id y Client Secret
  • Acceso a una máquina de desarrollo con Windows, Linux o macOS

Integrar en una aplicación web ASP.NET Core también requiere una conexión de red confiable a los puntos finales de GroupDocs Cloud, porque todo el procesamiento de documentos se realiza de forma remota. Planifique su entorno de implementación en consecuencia.

Instale el SDK mediante NuGet:

dotnet add package GroupDocs.editor-Cloud

Descargue el paquete más reciente desde la página oficial de lanzamientos: GroupDocs.Editor Cloud SDK for .NET Download.

Cree un objeto de configuración con sus credenciales (extracto del ejemplo completo):

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

Con el paquete instalado y las credenciales listas, puedes pasar a la implementación. Las siguientes secciones explican cada fragmento de código en detalle, para que comprendas cómo la biblioteca encaja en la arquitectura general de una aplicación web ASP.NET Core.

Guía paso a paso para integrar en una aplicación web ASP.NET Core

Esta sección desglosa el proceso de integración en una aplicación web ASP.NET Core en pasos discretos y manejables. Cada paso incluye un fragmento de código corto tomado directamente de la implementación de referencia.

Paso 1: Configurar credenciales de API

Primero, instancie el objeto Configuration con los detalles de su cliente y cree el cliente EditorApi.

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

var editorApi = new EditorApi(configuration);

La clase EditorApi está documentada en la referencia de API. Inicializar el cliente una vez por solicitud es suficiente para la mayoría de los escenarios; también puedes registrarlo como un singleton en el contenedor de inyección de dependencias de ASP.NET Core para obtener un mejor rendimiento.

Paso 2: Definir opciones de carga

Especifique el archivo de origen y la ubicación de salida deseada usando LoadOptions. Este objeto indica al servicio qué documento abrir y dónde almacenar el HTML renderizado.

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

LoadOptions, FileInfo y RenderOptions le permiten controlar cómo se renderiza el documento para su edición. Por ejemplo, puede configurar RenderOptions para incluir imágenes, preservar los estilos originales o limitar la cantidad de páginas renderizadas.

Paso 3: Llamar a LoadDocument

Invoca la API para cargar y convertir el documento. La llamada es sincrónica en este ejemplo, pero también puedes usar la versión asíncrona si la acción de tu controlador es async.

var loadResult = editorApi.LoadDocument(loadOptions);

El método LoadDocument devuelve un objeto de resultado que contiene URLs al HTML renderizado y otros metadatos. Puedes almacenar el loadResult para recuperarlo más tarde o pasar el HTML directamente al front‑end.

Paso 4: Procesar resultado de carga

Después de cargar, puedes servir el HTML al front‑end o almacenarlo para uso posterior. Este paso completa el flujo de trabajo de integrar el editor de documentos en una aplicación web ASP.NET Core y prepara el documento para la interacción del usuario.

En un escenario real, normalmente devolverías el contenido HTML desde una acción del controlador:

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

También puede querer implementar caché para evitar volver a cargar el mismo documento repetidamente, lo que puede mejorar los tiempos de respuesta al integrar en una aplicación web ASP.NET Core a gran escala.

Integración del Editor de Documentos en una Aplicación Web ASP.NET Core - Ejemplo de Código Completo

El siguiente código muestra todo el proceso, desde la configuración hasta la carga de un archivo 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);

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Uso de cURL para la integración de edición de documentos en ASP.NET Core

Si prefieres un enfoque REST directo, la misma operación se puede realizar con comandos cURL. Este método es útil para la creación rápida de prototipos o cuando necesitas integrar el editor en un servicio que no está escrito en .NET.

1. Autenticar y obtener el token de acceso

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 respuesta contiene un access_token que se utiliza en llamadas posteriores.

2. Cargar el archivo de origen

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. Cargar el documento para editar

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. Descargar el HTML renderizado

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

Estos comandos ilustran cómo añadir edición de documentos a una aplicación ASP.NET Core sin escribir código C#, lo que resulta útil para pruebas rápidas o la integración con otros servicios. Para obtener más detalles, consulte la documentación oficial de la API.

Al dominar tanto la biblioteca .NET como la API REST sin procesar, obtienes flexibilidad al integrar en una aplicación web ASP.NET Core, lo que te permite elegir el enfoque que mejor se adapte a tu arquitectura.

Preguntas frecuentes

Lecturas adicionales