Convertir HTML a PDF en C# .NET

La demanda de soluciones eficientes de gestión de documentos continúa creciendo exponencialmente. En este artículo, profundizamos en los beneficios y las aplicaciones prácticas de aprovechar la API de .NET Cloud para la conversión de HTML a PDF. Desde optimizar los flujos de trabajo hasta garantizar la compatibilidad entre varias plataformas, descubra cómo esta función puede mejorar significativamente la productividad y simplificar las tareas de gestión de documentos.

Este artículo cubre los siguientes temas:

API de conversión de HTML a PDF

Exploraremos las sólidas capacidades de GroupDocs.Conversion Cloud SDK para .NET y su papel fundamental para cumplir sin problemas el requisito de conversión de HTML a PDF. A medida que las empresas y los desarrolladores buscan soluciones eficientes para la gestión de documentos, esta API surge como una herramienta poderosa que ofrece una facilidad y versatilidad incomparables. Profundicemos en cómo este SDK de conversión le permite convertir sin esfuerzo archivos HTML a formato PDF, facilitando flujos de trabajo más fluidos y una mayor productividad.

Ahora bien, para poder utilizar el SDK, el primer paso es su instalación. Simplemente busque GroupDocs.Conversion-Cloud en el administrador de paquetes NuGet y haga clic en el botón Instalar. Otra opción es ejecutar el siguiente comando en la consola del administrador de paquetes.

NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0

Una vez que la API REST se haya instalado correctamente, asegúrese de tener las credenciales de la API (es decir, ID de cliente y secreto de cliente).Puede visitar este breve tutorial para ver cómo obtener las credenciales de API.

Convierta HTML a PDF usando C# .NET

En esta sección, exploraremos los detalles sobre cómo convertir HTML a PDF mediante programación usando C# .NET.

  1. Cree una instancia de la clase Configuración donde pasamos las credenciales del cliente como argumentos.
var configurations = new Configuration(clientId, clientSecret1);
  1. Inicialice ConvertApi donde pasamos el objeto de configuración como argumento de entrada.
var apiInstance = new ConvertApi(configurations);
  1. Cargue el archivo HTML de entrada al almacenamiento en la nube, donde proporcionamos el nombre del archivo HTML de entrada.
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
  1. Cree una instancia ConvertSettings donde especificamos el nombre del HTML de entrada, el formato de salida como pdf y el nombre del documento PDF resultante.
var settings = new ConvertSettings{...}
  1. Llame a la API ConvertDocumentRequest para convertir HTML a formato PDF. Después de una conversión exitosa, el PDF resultante se almacena en la nube.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// Más ejemplos en https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtenga sus credenciales API 
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";

// Cree una instancia de la clase Configuración e inicialícela con el ID del cliente y el secreto del cliente. 
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Defina el valor de ApiBaseUrl para establecer la URL base de la API de conversión de html a PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Inicialice una instancia de la clase ConvertApi con el objeto de la clase Configuración.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
             
// cargar el archivo HTML desde la unidad local             
using (var stream = System.IO.File.OpenRead("converted.html"))
{
    // crear una instancia de FileApi
    var fileUpload = new FileApi(configurations);
    // Cargue el archivo HTML de entrada al almacenamiento en la nube.
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // crear ConvertSettings donde definimos el HTML de entrada y el nombre del PDF resultante
    var settings = new ConvertSettings
    {
        StorageName = "internal",
        FilePath = "input.html",
        Format = "pdf",
        OutputPath = "resultant.pdf"
    };
    
    // Invoque el método ConvertDocument para convertir HTML a PDF mediante programación.
    var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // imprimir mensaje de éxito
        Console.WriteLine("HTMl to PDF conversion completed successfully !");
    }
}
Una vista previa de la conversión de HTML a PDF.

Imagen: - Una vista previa de la conversión de HTML a PDF.

El PDF de muestra generado en el ejemplo anterior se puede descargar desde resultant.pdf.

HTML a PDF usando comandos cURL

Otra opción para convertir HTML a PDF es una combinación de los comandos GroupDocs.Conversion Cloud y cURL. La conversión de HTML a PDF utilizando GroupDocs.Conversion Cloud mediante comandos cURL ofrece varios beneficios notables, como por ejemplo, proporciona un método sencillo y fluido para convertir archivos HTML a formato PDF, eliminando la necesidad de procesos manuales complejos. Por lo tanto, al aprovechar la API de GroupDocs.Conversion Cloud, los usuarios pueden automatizar el proceso de conversión, ahorrando tiempo y esfuerzo en tareas repetitivas.

Asegúrese de haber obtenido sus credenciales de API (clave de aplicación y SID de aplicación) en el panel de GroupDocs y genere el token de acceso JWT. Una vez que tengamos el token JWT, ejecute el siguiente comando cURL, donde también proporcionamos propiedades para que se agregue la marca de agua de texto durante este proceso de conversión.

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"GroupDocs.Cloud\",      \"FontName\": \"Arial\",      \"FontSize\": 4,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"olive\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

Reemplace sourceFile con el nombre del archivo HTML de entrada, resultantFile con el nombre del formato PDF de salida que se generará y accessToken con el token JWT generado anteriormente.

Aplicación gratuita de conversión de HTML a PDF

Basado en la API GroupDocs.Conversion Cloud, hemos desarrollado en línea un Convertidor de HTML a PDF. Es gratuito, liviano, súper eficiente y proporciona una sólida conversión de HTML a PDF.

aplicación gratuita de html a pdf

Enlaces útiles

Conclusión

Hemos aprendido que GroupDocs.Conversion Cloud ofrece una solución perfecta, eficiente y confiable para tareas de conversión de documentos, lo que le permite optimizar sus flujos de trabajo y mejorar la productividad. Entonces, al automatizar el proceso de conversión y garantizar la coherencia y precisión de los resultados, GroupDocs.Conversion Cloud API simplifica las tareas complejas y ahorra tiempo y recursos valiosos. Por lo tanto, ya sea que sea un desarrollador que busca integrar capacidades de conversión de documentos en sus aplicaciones o una empresa que busca optimizar sus procesos de gestión de documentos, nuestras API le brindan las herramientas que necesita para tener éxito.

Artículos relacionados

Recomendamos encarecidamente visitar los siguientes enlaces para obtener más información sobre: