da html a xps

Conversione da HTML a XPS con C# .NET.

HTML è il formato di riferimento per presentare contenuti sul web, ma ci sono situazioni in cui è richiesto un formato di documento più affidabile e fisso. Ecco dove la conversione di HTML in XPS (XML Paper Specification) diventa cruciale. XPS è un formato standardizzato che assicura un layout di pagina coerente, rendendolo ideale per creare documenti, report e archivi pronti per la stampa in cui è essenziale una formattazione precisa.

API di conversione da HTML .NET a XPS

GroupDocs.Conversion Cloud SDK per .NET fornisce un modo robusto ed efficiente per convertire i file HTML in formato XPS. Con questo SDK, l’integrazione delle capacità di conversione nelle tue applicazioni .NET è semplice e consente una trasformazione senza soluzione di continuità del contenuto HTML in documenti XPS di alta qualità. Il primo passo in questo approccio è installare l’SDK cercando GroupDocs.Conversion-Cloud nel gestore pacchetti NuGet e facendo clic sul pulsante Installa. Un’altra opzione è eseguire il seguente comando nella console del gestore pacchetti.

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

Dopo aver completato l’installazione, ottieni le tue credenziali API personalizzate (ad esempio ID client e segreto client).Puoi visitare questo breve tutorial che spiega i dettagli su come ottenere le credenziali API.

Da HTML a XPS in C# .NET

Questa sezione spiega nei dettagli come generare report a layout fisso o creare documenti pronti per la stampa convertendo il formato HTML in XPS utilizzando C# .NET.

  1. Creiamo un’istanza della classe Configuration in cui passiamo le credenziali del client come argomenti.
var configurations = new Configuration(clientId, clientSecret1);
  1. Inizializzare ConvertApi dove passiamo l’oggetto Configurazione come argomento di input.
var apiInstance = new ConvertApi(configurations);
  1. Carica il file HTML di input nell’archivio cloud.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
  1. Creiamo un’istanza ConvertSettings in cui specifichiamo il nome per l’HTML di input, il formato risultante come xps e il nome per il documento XPS risultante come argomenti.
var settings = new ConvertSettings{...}
  1. Chiama l’API ConvertDocumentRequest per eseguire la conversione da HTML a XPS e salvare il file XPS risultante nell’archiviazione cloud.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));

// Altri esempi su https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Ottieni le tue credenziali API 
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";

// Creare un'istanza della classe Configuration e inizializzarla con Client ID e Client Secret. 
var configurations = new Configuration(clientId, clientSecret1);
// Definire il valore di ApiBaseUrl per impostare l'URL di base per l'API di conversione da HTML a XPS.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Inizializza un'istanza della classe ConvertApi con un oggetto della classe Configuration.
var apiInstance = new ConvertApi(configurations);
             
// carica l'input HTML dall'unità locale             
using (var stream = System.IO.File.OpenRead("input.html"))
{
    // creare un'istanza di FileApi
    var fileUpload = new FileApi(configurations);
    // caricare l'HTML di input sullo storage cloud
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // creare ConvertSettings dove definiamo il nome dell'HTML di origine e il nome per il file XPS risultante
    var settings = new ConvertSettings
    {
        StorageName = "default",
        FilePath = "input.html",
        Format = "xps",
        OutputPath = "resultant.xps"
    };
    
    // Richiama il metodo ConvertDocument per l'operazione di conversione da HTML a XPS.
    var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // stampa messaggio di successo
        Console.WriteLine("The HTML to XPS conversion completed successfully !");
    }
}
da html a xps

Immagine: un’anteprima della conversione da HTML a XPS.

Il file XPS risultante generato nell’esempio precedente può essere scaricato da resultantFile.xps.

Convertire HTML in XPS usando i comandi cURL

La conversione di HTML in XPS tramite GroupDocs.Conversion Cloud e i comandi cURL offre un approccio flessibile ed efficiente quando si preferiscono strumenti da riga di comando e automazione. Inoltre, questo approccio è particolarmente utile in scenari in cui è richiesta l’elaborazione automatizzata o in batch, rendendolo ideale per gli sviluppatori che integrano la conversione di documenti in script o flussi di lavoro lato server.

Il primo passo in questo approccio è generare un token di accesso JWT e quindi eseguire il seguente comando cURL per trasformare la pagina web in un file XPS. Il file risultante viene quindi archiviato nell’archivio cloud.

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

Sostituisci sourceFile con il nome del file HTML di input, resultantFile con il nome del file XPS risultante e accessToken con il token di accesso JWT personalizzato.

  • Se si desidera salvare il file XPS risultante sul disco locale, provare a utilizzare il seguente 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}"

Convertitore gratuito da HTML a XPS

Potresti prendere in considerazione l’esplorazione delle potenti capacità di GroupDocs.Conversion Cloud REST API utilizzando la nostra app gratuita HTML to XPS Conversion. È un’app leggera e super efficiente, che ti consente di sperimentare le potenti capacità dell’API all’interno di un browser web.

applicazione da html a xps

Conclusione

La conversione da HTML a XPS è fondamentale per creare documenti coerenti e di alta qualità adatti alla stampa, all’archiviazione e alla condivisione su più piattaforme. Sia che tu scelga di utilizzare il completo GroupDocs.Conversion Cloud SDK per .NET o l’approccio leggero del comando cURL, entrambi i metodi offrono soluzioni affidabili e flessibili per ottenere questa conversione. Ti invitiamo a esplorare la nostra API e a sfruttare le sue capacità per semplificare le tue esigenze di conversione dei documenti e fornire senza sforzo output professionali con layout fisso.

Articoli consigliati

Consigliamo vivamente di visitare i seguenti link per saperne di più: