html para xps

Conversão de HTML para XPS com C# .NET.

HTML é o formato ideal para apresentar conteúdo na web, mas há situações em que um formato de documento mais confiável e fixo é necessário. É aqui que converter HTML para XPS (XML Paper Specification) se torna crucial. XPS é um formato padronizado que garante um layout de página consistente, tornando-o ideal para criar documentos, relatórios e arquivos prontos para impressão, onde a formatação precisa é essencial.

API de conversão de HTML para XPS do .NET

GroupDocs.Conversion Cloud SDK para .NET fornece uma maneira robusta e eficiente de converter arquivos HTML para o formato XPS. Com este SDK, a integração de recursos de conversão em seus aplicativos .NET é direta e permite a transformação perfeita de conteúdo HTML em documentos XPS de alta qualidade. O primeiro passo nesta abordagem é instalar o SDK pesquisando GroupDocs.Conversion-Cloud no gerenciador de pacotes NuGet e clicar no botão Instalar. Outra opção é executar o seguinte comando no console do gerenciador de pacotes.

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

Após a conclusão da instalação, obtenha suas credenciais de API personalizadas (ou seja, Client ID e Client Secret).Você pode visitar este breve tutorial que explica os detalhes sobre como obter as credenciais de API.

HTML para XPS em C# .NET

Esta seção explica os detalhes sobre como podemos gerar relatórios de layout fixo ou criar documentos prontos para impressão convertendo HTML para o formato XPS usando C# .NET.

  1. Crie uma instância da classe Configuration onde passamos as credenciais do cliente como argumentos.
var configurations = new Configuration(clientId, clientSecret1);
  1. Inicialize o ConvertApi onde passamos o objeto Configuration como um argumento de entrada.
var apiInstance = new ConvertApi(configurations);
  1. Carregue o arquivo HTML de entrada para o armazenamento em nuvem.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
  1. Crie uma instância ConvertSettings onde especificamos o nome do HTML de entrada, o formato resultante como xps e o nome do documento XPS resultante como argumentos.
var settings = new ConvertSettings{...}
  1. Chame a API ConvertDocumentRequest para realizar a conversão de HTML para XPS e salvar o arquivo XPS resultante no armazenamento em nuvem.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// Mais exemplos em https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtenha suas credenciais de API 
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";

// Crie uma instância da classe Configuration e inicialize-a com o ID do cliente e o segredo do cliente. 
var configurations = new Configuration(clientId, clientSecret1);
// Defina o valor de ApiBaseUrl para definir a URL base para a API de conversão de HTML para XPS.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Inicialize uma instância da classe ConvertApi com um objeto da classe Configuration.
var apiInstance = new ConvertApi(configurations);
             
// carregue o HTML de entrada da unidade local             
using (var stream = System.IO.File.OpenRead("input.html"))
{
    // crie uma instância de FileApi
    var fileUpload = new FileApi(configurations);
    // carregue o HTML de entrada para o armazenamento em nuvem
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // crie ConvertSettings onde definimos o nome do HTML de origem e o nome do arquivo XPS resultante
    var settings = new ConvertSettings
    {
        StorageName = "default",
        FilePath = "input.html",
        Format = "xps",
        OutputPath = "resultant.xps"
    };
    
    // Invoque o método ConvertDocument para a operação de conversão de HTML para XPS.
    var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // imprimir mensagem de sucesso
        Console.WriteLine("The HTML to XPS conversion completed successfully !");
    }
}
html para xps

Imagem: - Uma prévia da conversão de HTML para XPS.

O arquivo XPS resultante gerado no exemplo acima pode ser baixado de resultantFile.xps.

Converter HTML para XPS usando comandos cURL

A conversão de HTML para XPS usando os comandos GroupDocs.Conversion Cloud e cURL oferece uma abordagem flexível e eficiente quando você prefere ferramentas de linha de comando e automação. Além disso, essa abordagem é particularmente útil em cenários onde o processamento automatizado ou em lote é necessário, tornando-a ideal para desenvolvedores que integram a conversão de documentos em scripts ou fluxos de trabalho do lado do servidor.

O primeiro passo nessa abordagem é gerar um token de acesso JWT e, então, executar o seguinte comando cURL para transformar a página da web em arquivo XPS. O arquivo resultante é então armazenado no armazenamento em nuvem.

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}\"}"

Substitua sourceFile pelo nome do arquivo HTML de entrada, resultantFile pelo nome do arquivo XPS resultante e accessToken pelo token de acesso JWT personalizado.

  • Se sua necessidade for salvar o arquivo XPS resultante na unidade local, tente usar o seguinte 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}"

Conversor gratuito de HTML para XPS

Você pode considerar explorar os recursos poderosos do GroupDocs.Conversion Cloud REST API usando nosso aplicativo gratuito HTML to XPS Conversion. É um aplicativo leve e supereficiente, permitindo que você experimente os recursos poderosos da API em um navegador da web.

aplicativo html para xps

Conclusão

Converter HTML para XPS é crucial para criar documentos consistentes e de alta qualidade, adequados para impressão, arquivamento e compartilhamento entre plataformas. Não importa se você escolher usar o abrangente GroupDocs.Conversion Cloud SDK para .NET ou a abordagem de comando leve cURL, ambos os métodos oferecem soluções confiáveis e flexíveis para atingir essa conversão. Nós o encorajamos a explorar nossa API e aproveitar seus recursos para otimizar suas necessidades de conversão de documentos e entregar sem esforço saídas profissionais de layout fixo.

Artigos recomendados

Recomendamos fortemente que você visite os seguintes links para saber mais sobre: