Créer des rapports Excel avec des modèles Smart Marker – Guide de l’API Aspose.Cells Cloud
Cette API REST permet de créer un classeur à partir d’un modèle Smart Marker.
API SmartMarker pour les classeurs
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification par jeton JWT.
Qu’est-ce qu’un Smart Marker ?
Un Smart Marker est une syntaxe de placeholder qui fait correspondre des champs de données d’un fichier XML (ou JSON) à des cellules d’un modèle Excel. À l’exécution, Aspose.Cells remplace les marqueurs par les données correspondantes, ce qui permet de générer des rapports entièrement remplis de manière programmatique.
Paramètres de requête
| Nom du paramètre | Type | Description |
|---|---|---|
| outPath | string | Chemin de destination où le classeur généré sera enregistré. |
| folder | string | Dossier contenant le classeur original. |
| storageName | string | Nom du service de stockage à utiliser. |
Paramètre du corps de la requête
| Nom du paramètre | Type | Description |
|---|---|---|
| xmlFile | file | Fichier de données XML Smart Marker envoyé avec la requête. |
Réponse
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Notes / Limites :
- L’API prend en charge les fichiers Excel d’une taille maximale de 50 Mo.
- Les formats acceptés sont uniquement .xlsx, .xlsm et .xlsb.
- Une limite de débit de 20 requêtes par seconde par compte est appliquée.
Codes de statut HTTP
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Filtre appliqué avec succès ; la réponse contient les détails de l’opération. |
| 400 | Mauvaise requête | Paramètres manquants ou non valides (par exemple, type de fichier non pris en charge). |
| 401 | Non autorisé | Jeton JWT invalide ou manquant. |
| 413 | Charge utile trop grande | Le fichier téléchargé dépasse la limite de taille. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Comment utiliser l’API SmartMarker pour les classeurs
Spécification de l’API SmartMarker pour les classeurs
La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.
Utiliser les SDK Aspose.Cells Cloud
Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment effectuer des appels à l’API Cloud avec cURL.
Exemple rapide en une seule ligne
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
Gestion des erreurs
| Code d’état HTTP | Description | Cause typique |
|---|---|---|
| 400 | Mauvaise requête | Modèle manquant, XML mal formé ou paramètres invalides. |
| 401 | Non autorisé | Jeton d’authentification invalide ou manquant. |
| 404 | Non trouvé | Le classeur ou l’emplacement de stockage spécifié n’existe pas. |
| 500 | Erreur interne du serveur | Échec serveur inattendu. |
Exemple de réponse d’erreur (400)
{
"Code": 400,
"Message": "Le fichier de données XML est manquant ou mal formé."
}
Famille de SDK Cloud
Utiliser un SDK est le meilleur moyen d’accélérer le développement. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :