html vers xps

Conversion HTML en XPS avec C# .NET.

HTML est le format de référence pour présenter du contenu sur le Web, mais il existe des situations où un format de document plus fiable et plus fixe est nécessaire. C’est là que la conversion de HTML en XPS (XML Paper Specification) devient cruciale. XPS est un format standardisé qui garantit une mise en page cohérente, ce qui le rend idéal pour créer des documents, des rapports et des archives prêts à imprimer où une mise en forme précise est essentielle.

API de conversion HTML vers XPS .NET

GroupDocs.Conversion Cloud SDK for .NET fournit un moyen robuste et efficace de convertir des fichiers HTML au format XPS. Avec ce SDK, l’intégration des fonctionnalités de conversion dans vos applications .NET est simple et permet une transformation transparente du contenu HTML en documents XPS de haute qualité. La première étape de cette approche consiste à installer le SDK en recherchant GroupDocs.Conversion-Cloud dans le gestionnaire de packages NuGet et en cliquant sur le bouton Installer. Une autre option consiste à exécuter la commande suivante dans la console du gestionnaire de packages.

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

Une fois l’installation terminée, veuillez obtenir vos identifiants API personnalisés (c’est-à-dire l’ID client et le secret client).Vous pouvez consulter ce court tutoriel expliquant en détail comment obtenir les identifiants API.

Conversion de HTML en XPS en C# .NET

Cette section explique en détail comment nous pouvons générer des rapports à mise en page fixe ou créer des documents prêts à imprimer en convertissant le format HTML au format XPS à l’aide de C# .NET.

  1. Créez une instance de la classe « Configuration » dans laquelle nous transmettons les informations d’identification du client en tant qu’arguments.
var configurations = new Configuration(clientId, clientSecret1);
  1. Initialisez le ConvertApi où nous passons l’objet Configuration comme argument d’entrée.
var apiInstance = new ConvertApi(configurations);
  1. Téléchargez le fichier HTML d’entrée sur le stockage cloud.
fileUpload.UploadFile(new UploadFileRequest("sourceFile.html", stream));
  1. Créez une instance « ConvertSettings » dans laquelle nous spécifions le nom du code HTML d’entrée, le format résultant comme « xps » et le nom du document XPS résultant comme arguments.
var settings = new ConvertSettings{...}
  1. Appelez l’API ConvertDocumentRequest pour effectuer une conversion HTML en XPS et enregistrer le fichier XPS résultant sur le stockage cloud.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// Plus d'exemples sur https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Obtenez vos identifiants API 
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";

// Créez une instance de la classe Configuration et initialisez-la avec l'ID client et le secret client. 
var configurations = new Configuration(clientId, clientSecret1);
// Définissez la valeur de ApiBaseUrl pour définir l'URL de base pour l'API de conversion HTML en XPS.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

// Initialisez une instance de la classe ConvertApi avec un objet de classe Configuration.
var apiInstance = new ConvertApi(configurations);
             
// charger le code HTML d'entrée à partir du lecteur local             
using (var stream = System.IO.File.OpenRead("input.html"))
{
    // créer une instance de FileApi
    var fileUpload = new FileApi(configurations);
    // télécharger le code HTML d'entrée vers le stockage cloud
    fileUpload.UploadFile(new UploadFileRequest("input.html", stream));

    // créer ConvertSettings où nous définissons le nom du HTML source et le nom du fichier XPS résultant
    var settings = new ConvertSettings
    {
        StorageName = "default",
        FilePath = "input.html",
        Format = "xps",
        OutputPath = "resultant.xps"
    };
    
    // Appelez la méthode ConvertDocument pour l’opération de conversion HTML en XPS.
    var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
    if (response != null && response.Equals("OK"))
    {
        // imprimer le message de réussite
        Console.WriteLine("The HTML to XPS conversion completed successfully !");
    }
}
html vers xps

Image : Un aperçu de la conversion HTML en XPS.

Le fichier XPS résultant généré dans l’exemple ci-dessus peut être téléchargé à partir de resultantFile.xps.

Convertir HTML en XPS à l’aide des commandes cURL

La conversion de HTML en XPS à l’aide de GroupDocs.Conversion Cloud et des commandes cURL offre une approche flexible et efficace lorsque vous préférez les outils de ligne de commande et l’automatisation. De plus, cette approche est particulièrement utile dans les scénarios où un traitement automatisé ou par lots est requis, ce qui la rend idéale pour les développeurs intégrant la conversion de documents dans des scripts ou des flux de travail côté serveur.

La première étape de cette approche consiste à générer un jeton d’accès JWT, puis à exécuter la commande cURL suivante pour transformer la page Web en fichier XPS. Le fichier résultant est ensuite stocké dans le stockage 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}\"}"

Veuillez remplacer sourceFile par le nom du fichier HTML d’entrée, resultantFile par le nom du fichier XPS résultant et accessToken par le jeton d’accès JWT personnalisé.

  • Si vous souhaitez enregistrer le fichier XPS résultant sur le lecteur local, essayez d’utiliser la commande cURL suivante.
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}"

Convertisseur HTML vers XPS gratuit

Vous pouvez envisager d’explorer les puissantes fonctionnalités de l’API REST GroupDocs.Conversion Cloud en utilisant notre application gratuite Conversion HTML vers XPS. Il s’agit d’une application légère et ultra-efficace, qui vous permet de découvrir les puissantes fonctionnalités de l’API dans un navigateur Web.

application html vers xps

Liens utiles

Conclusion

La conversion HTML en XPS est essentielle pour créer des documents cohérents et de haute qualité, adaptés à l’impression, à l’archivage et au partage sur plusieurs plates-formes. Que vous choisissiez d’utiliser le SDK Cloud complet GroupDocs.Conversion pour .NET ou l’approche de commande légère cURL, les deux méthodes offrent des solutions fiables et flexibles pour réaliser cette conversion. Nous vous encourageons à explorer notre API et à exploiter ses capacités pour rationaliser vos besoins de conversion de documents et fournir sans effort des sorties professionnelles à mise en page fixe.

Articles recommandés

Nous vous recommandons vivement de visiter les liens suivants pour en savoir plus sur :