Afficher les données XML dans une page HTML

XML est un langage autodescriptif pris en charge par le W3C, spécialement conçu pour un stockage efficace des données et un échange de données transparent. Pour les développeurs d’applications Python, l’adaptabilité du format XML permet une transformation facile en formats conviviaux et lisibles par l’homme comme HTML. Cet article vous guidera tout au long du processus d’exploitation du SDK GroupDocs.Assembly Cloud pour Python et de modèles simples pour traduire des données XML en rapports HTML complets.

Conditions préalables:

Avant de commencer, assurez-vous d’avoir mis en place les éléments suivants :

  • Python installé sur votre système. - GroupDocs.Assembly Cloud SDK pour Python installé.
  • Un compte GroupDocs.Assembly Cloud actif avec des informations d’identification API valides.
  • Exemples de données et modèles pour les tests (nous utiliserons les exemples de données XML et le modèle de rapport suivants).

Exemples de données XML

Utilisez les données XML suivantes.

<Managers>
	<Manager>
		<Name>John Smith</Name>
		<Contract>
			<Client>
				<Name>A Company</Name>
			</Client>
			<Price>1200000</Price>
		</Contract>
		<Contract>
		...
		</Contract>
		...
	</Manager>
	<Manager>
		<Name>Tony Anderson</Name>
		...
	</Manager>
	...
</Managers>

Exemple de modèle

Générez le modèle spécifié au format TXT, DOCX ou dans le format nécessaire pour parcourir les données des gestionnaires ainsi que leurs clients correspondants et les informations associées. Par la suite, procédez à l’implémentation du code pour générer le rapport.

<<foreach \[in managers\]>>Manager: <<\[Name\]>>
Contracts:
<<foreach \[in Contract\]>>- <<\[Client.Name\]>> ($<<\[Price\]>>)
<</foreach>>
<</foreach>>

Points à aborder :

Configurer le SDK Python HTML Report Generator

Pour lancer le processus, intégrez le SDK GroupDocs.Assembly Cloud pour Python dans votre projet Python en utilisant pip (installateur de package Python). Exécutez la commande suivante dans la console :

pip install groupdocs-assembly-cloud

Lancez le client API

Ensuite, récupérez votre ID client et votre Secret client à partir du tableau de bord et intégrez le code fourni comme illustré ci-dessous :

import groupdocsassemblycloud as assembly
# Get app_sid & app_key from https://dashboard.groupdocs.cloud after free registration.
app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Get File API configurations.
configuration = assembly.Configuration(app_sid, app_key)
configuration.api_base_url = "https://api.groupdocs.cloud"
storage_name = "LocalStorage"

Téléchargez la source de données et les fichiers modèles

Tout d’abord, téléchargez la source de données et les fichiers modèles sur le cloud à l’aide de l’exemple de code ci-dessous :

# Create an instance of the file API
file_api = groupdocsassemblycloud.FileApi.from_config(configuration)
# Call upload file request
request = groupdocsassemblycloud.UploadFileRequest("python-testing\input-sample-file.xml", "H:\\groupdocs-cloud-data\\input-sample-file.xml", "storage_name")
# Upload file to the cloud
response = file_api.upload_file(request)
print(response.uploaded)
view raw upload-file.py hosted with ❤ by GitHub

En conséquence, les fichiers téléchargés seront disponibles dans la section fichiers de votre tableau de bord sur le cloud.

Afficher des données XML sur une page HTML à l’aide de Python

Pour présenter des données XML dans une page HTML, respectez les étapes suivantes :

  1. Créez une instance de AssemblyApi avec client_id et client_secret.
  2. Configurez les informations du modèle avec un chemin de fichier, un nom de stockage, un ID de version et un mot de passe.
  3. Préparez la demande d’assemblage à l’aide de AssembleOptions avec les données du rapport, les informations du modèle, le chemin de sortie et le format d’enregistrement.
  4. Générez le rapport HTML à l’aide de la méthode AssemblyApi.assemble_document(AssembleOptions).

L’exemple de code fourni illustre l’implémentation du SDK Python pour l’API REST du générateur de rapports HTML, permettant la présentation de données XML sur une page HTML.

import groupdocsassemblycloud as assembly
client_id = "XXXX-XXXX-XXXX-XXXX"
client_secret = "XXXXXXXXXXXXXXXX"
assemblyAPI = assembly.AssemblyApi(client_id,client_secret )
# Set up template info
templateInfo = assembly.TemplateFileInfo()
templateInfo.file_path= 'Python_Testing/template.txt'
templateInfo.storage_name= 'LocalStorage'
templateInfo.version_id= ''
templateInfo.password='abc123'
# Prepare assemble request
options=assembly.AssembleOptions()
options.report_data = 'Python_Testing/report-data.xml';
options.template_file_info = templateInfo
options.output_path = 'Python_Testing/report.html';
options.save_format = 'html'
# Generate HTML report
assemblyAPI.assemble_document(options)

Télécharger le fichier HTML

Le code donné à l’étape précédente enregistre le fichier HTML converti sur le cloud. Pour le télécharger, vous pouvez utiliser l’extrait de code suivant.

# Create instance of the API
file_api = groupdocsassemblycloud.FileApi.from_config(configuration)
request = groupdocs_conversion_cloud.DownloadFileRequest('Python_Testing/report.html', my_storage)
response = file_api.download_file(request)
# Move downloaded file to your working directory
shutil.move(response, "C:\\Files\\")

Conclusion

Dans cet article, nous avons décrit les étapes impliquées dans la présentation des données XML sur une page HTML via l’utilisation de l’API REST GroupDocs.Assembly Cloud en conjonction avec son SDK Python. Cette API robuste permet aux développeurs de créer de manière transparente des rapports dynamiques dans divers formats, en exploitant les informations provenant de sources XML ou XML et en fusionnant des modèles couvrant des documents Word, des feuilles de calcul et des fichiers texte.

De plus, pour une compréhension plus complète de l’API GroupDocs.Assembly Cloud, plongez dans la documentation. Profitez également de notre zone Référence API, qui vous permet d’interagir et d’observer directement nos API en action directement depuis votre navigateur. Vous pouvez également accéder librement au code source complet du SDK Python sur Github.

En conclusion, nous produisons régulièrement de nouveaux articles de blog explorant une gamme de formats de fichiers et leur analyse à l’aide de l’API REST. Contactez-nous pour obtenir les informations les plus récentes.

poser une question

Si vous avez des questions ou des confusions concernant le Générateur de rapports HTML, n’hésitez pas à nous contacter via notre forum.

Voir également

Voici quelques articles connexes qui pourraient vous être utiles :