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
- HTML a XPS en C# .NET
- Convertir HTML a XPS mediante comandos cURL
- Convertidor gratuito de HTML a XPS
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.
- Crea una instancia de la clase
Configuración
donde pasamos las credenciales del cliente como argumentos.
var configurations = new Configuration(clientId, clientSecret1);
- Inicializamos
ConvertApi
donde pasamos el objeto de configuración como argumento de entrada.
var apiInstance = new ConvertApi(configurations);
- Sube el archivo HTML de entrada al almacenamiento en la nube.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
- Crea una instancia
ConvertSettings
donde especificamos el nombre del HTML de entrada, el formato resultante comoxps
y el nombre del documento XPS resultante como argumentos.
var settings = new ConvertSettings{...}
- 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 !");
}
}
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.
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: