HTML a XPS

Conversión de HTML a XPS con C# .NET.

HTML es el formato de referencia para presentar contenido en la web, pero hay situaciones en las que se requiere un formato de documento más fiable y fijo. Aquí es donde la conversión de HTML a XPS (XML Paper Specification) se vuelve crucial. XPS es un formato estandarizado que garantiza un diseño de página uniforme, lo que lo hace ideal para crear documentos, informes y archivos listos para imprimir donde el formato preciso es esencial.

API de conversión de HTML a XPS de .NET

GroupDocs.Conversion Cloud SDK for .NET ofrece una forma sólida y eficiente de convertir archivos HTML al formato XPS. Con este SDK, la integración de las capacidades de conversión en sus aplicaciones .NET es sencilla y permite una transformación perfecta de contenido HTML en documentos XPS de alta calidad. El primer paso de este enfoque es instalar el SDK buscando GroupDocs.Conversion-Cloud en el administrador de paquetes NuGet y hacer 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 completada la instalación, obtenga sus credenciales de API personalizadas (es decir, ID de cliente y secreto de cliente).Puede visitar este breve tutorial que explica los detalles sobre cómo obtener las credenciales de API.

HTML a XPS en C# .NET

Esta sección explica los detalles sobre cómo podemos generar informes de diseño fijo o crear documentos listos para imprimir convirtiendo HTML al formato XPS usando C# .NET.

  1. Crea una instancia de la clase Configuración donde pasamos las credenciales del cliente como argumentos.
var configurations = new Configuration(clientId, clientSecret1);
  1. Inicializamos ConvertApi donde pasamos el objeto de configuración como argumento de entrada.
var apiInstance = new ConvertApi(configurations);
  1. Sube el archivo HTML de entrada al almacenamiento en la nube.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
  1. Crea una instancia ConvertSettings donde especificamos el nombre del HTML de entrada, el formato resultante como xps y el nombre del documento XPS resultante como argumentos.
var settings = new ConvertSettings{...}
  1. Llame a la API ConvertDocumentRequest para realizar la conversión de HTML a XPS y guardar el archivo XPS resultante en el almacenamiento 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 de API 
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";

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

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

    // Crea ConvertSettings donde definimos el nombre del HTML de origen y el nombre del archivo XPS resultante
    var settings = new ConvertSettings
    {
        StorageName = "default",
        FilePath = "input.html",
        Format = "xps",
        OutputPath = "resultant.xps"
    };
    
    // Invoque el método ConvertDocument para la operación de conversión de HTML a XPS.
    var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // mensaje de éxito de impresión
        Console.WriteLine("The HTML to XPS conversion completed successfully !");
    }
}
HTML a XPS

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

El archivo XPS resultante generado en el ejemplo anterior se puede descargar desde resultantFile.xps.

Convertir HTML a XPS usando comandos cURL

La conversión de HTML a XPS mediante GroupDocs.Conversion Cloud y comandos cURL ofrece un enfoque flexible y eficiente cuando se prefieren herramientas de línea de comandos y automatización. Además, este enfoque es particularmente útil en situaciones en las que se requiere procesamiento automatizado o por lotes, lo que lo hace ideal para desarrolladores que integran la conversión de documentos en secuencias de comandos o flujos de trabajo del lado del servidor.

El primer paso de este enfoque es generar un token de acceso JWT y, a continuación, ejecutar el siguiente comando cURL para transformar la página web en un archivo XPS. El archivo resultante se almacena en la nube.

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\": \"default\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"xps\",\"OutputPath\": \"{resultantFile}\"}"

Reemplace sourceFile con el nombre del archivo HTML de entrada, resultantFile con el nombre del archivo XPS resultante y accessToken con el token de acceso JWT personalizado.

  • Si su necesidad es guardar el archivo XPS resultante en la unidad local, intente utilizar el siguiente comando cURL.
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\": \"default\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"xps\"}" \
-o "{resultantFile}"

Convertidor gratuito de HTML a XPS

Puede considerar explorar las potentes capacidades de la API REST GroupDocs.Conversion Cloud mediante nuestra aplicación gratuita HTML to XPS Conversion. Es una aplicación liviana y súper eficiente que le permite experimentar las potentes capacidades de la API dentro de un navegador web.

Aplicación HTML a XPS

Enlaces útiles

Conclusión

La conversión de HTML a XPS es fundamental para crear documentos consistentes y de alta calidad aptos para imprimir, archivar y compartir en distintas plataformas. Tanto si elige utilizar el completo GroupDocs.Conversion Cloud SDK para .NET como el método de comandos cURL, ambos métodos ofrecen soluciones fiables y flexibles para lograr esta conversión. Le recomendamos que explore nuestra API y aproveche sus capacidades para optimizar sus necesidades de conversión de documentos y ofrecer sin esfuerzo resultados profesionales con un diseño fijo.

Artículos recomendados

Le recomendamos visitar los siguientes enlaces para obtener más información sobre: