Obtenir les données des cellules à partir d’une plage nommée – Aspose.Cells Cloud API

Conditions préalables

  • Un jeton d’accès JWT valide doté de la portée appropriée.
  • Le classeur doit être téléchargé dans le stockage Aspose Cloud (ou dans un dossier spécifié).
  • Assurez-vous que le nom du magasin cible est fourni si vous utilisez un magasin non par défaut.

Cette API REST renvoie une liste de cellules situées dans une plage identifiée soit par une plage nommée, soit par des index ligne‑colonne.

Cette opération permet aux développeurs de récupérer de manière programmatique les valeurs des cellules appartenant à une plage nommée spécifique dans une feuille de calcul Excel. En fournissant soit l’identifiant namedRange, soit des index explicites de ligne et de colonne, l’API renvoie une liste détaillée des cellules, incluant leur adresse, leur ligne, leur colonne, leur valeur, leur type de données et les informations de mise en forme. La réponse peut être utilisée pour alimenter des applications orientées données, générer des rapports ou effectuer d’autres calculs côté serveur. Le service Aspose.Cells Cloud prend en charge de multiples langages de programmation via ses SDK, garantissant une intégration fluide, quelle que soit la plateforme de développement. L’utilisation d’HTTPS garantit la transmission sécurisée des données, et l’API respecte les principes REST, renvoyant des codes d’état HTTP standards pour les cas de succès et d’erreur.

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

Paramètres de la requête

Nom du paramètre Type Emplacement Description
name string path Le nom du fichier du classeur.
sheetName string path Le nom de la feuille de calcul dans le classeur.
namedRange string query La plage nommée à récupérer, par ex. A1:B2 ou nom_plage1.
firstRow integer query Index zéro‑basé de la première ligne de la plage (utilisé lorsque namedRange n’est pas fourni).
firstColumn integer query Index zéro‑basé de la première colonne de la plage (utilisé lorsque namedRange n’est pas fourni).
rowCount integer query Nombre de lignes à inclure dans la plage.
columnCount integer query Nombre de colonnes à inclure dans la plage.
folder string query Le dossier contenant le classeur.
storageName string query Le nom du stockage cloud où réside le classeur.

La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler facilement les services web Aspose.Cells. L’exemple ci‑dessous montre comment demander les valeurs des cellules à partir d’une plage nommée.

Note de sécurité : Utilisez toujours HTTPS lors de l’appel de l’API. Ce service ne prend pas en charge le HTTP en clair ; l’utilisation d’HTTPS garantit que la requête est chiffrée et respecte les bonnes pratiques de sécurité.

Codes d’état HTTP

Code Signification Description
200 OK Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400 Requête incorrecte Paramètres manquants ou non valides (par ex., 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.

Exemple de réponse d’erreur (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Le paramètre 'namedRange' est manquant ou invalide."
}

Conseil : L’API utilise des index zéro‑basés pour firstRow et firstColumn. Par exemple, la première ligne de la feuille de calcul est 0.

Famille de SDK Cloud

L’utilisation d’un SDK constitue le moyen le plus efficace d’accélérer le développement. Un SDK abstrait les détails de bas niveau, vous permettant de vous concentrer sur la logique métier. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code ci‑dessous montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Obtenir des plages nommées dans un classeur Excel