Obtenir des plages nommées dans un classeur Excel – Aspose.Cells Cloud API

Cette API REST renvoie des informations sur les plages nommées définies dans les feuilles de calcul.

Contexte – Une plage nommée est un identifiant défini par l’utilisateur qui fait référence à une cellule spécifique ou à un bloc de cellules dans une feuille de calcul. Les plages nommées simplifient la création de formules, améliorent la lisibilité et permettent un accès programmatique aux zones fréquemment utilisées d’un classeur.

Conditions préalables – L’accès à l’API REST Aspose.Cells Cloud nécessite un jeton d’accès JWT valide. Obtenez ce jeton en vous authentifiant à l’aide de votre identifiant client Aspose Cloud et de votre secret client via le point de terminaison de jeton OAuth 2.0. Incluez le jeton dans l’en-tête Authorization: Bearer <jeton JWT> de chaque requête.

API GetNamedRanges

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

Sécurité et authentification

Les API REST Aspose.Cells Cloud sont sécurisées et exigent une authentification par jeton JWT.

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	Chemin	Le nom du fichier Excel.
folder	string	Chaîne de requête	Le dossier contenant le document.
storageName	string	Chaîne de requête	Le nom du stockage où réside le document.

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 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.

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

Vous pouvez utiliser l’outil en ligne de commande cURL pour appeler les services web Aspose.Cells. L’exemple ci-dessous montre comment récupérer les plages nommées à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/ranges" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>"

Réponse

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Modèle de réponse

Champ	Type	Description
`ColumnCount`	entier	Nombre de colonnes dans la plage.
`ColumnWidth`	nombre	Largeur de chaque colonne (en points).
`FirstColumn`	entier	Index de base zéro de la première colonne dans la plage.
`FirstRow`	entier	Index de base zéro de la première ligne dans la plage.
`Name`	chaîne	Nom défini par l’utilisateur de la plage.
`RefersTo`	chaîne	Une formule définissant la référence de cellule (par exemple, `=Sheet1!$B$10:$H$10`).
`RowCount`	entier	Nombre de lignes dans la plage.
`RowHeight`	nombre	Hauteur de chaque ligne (en points).
`Worksheet`	chaîne	Nom de la feuille de calcul contenant la plage.

Famille de SDK dans le cloud

L’utilisation d’un SDK constitue la méthode la plus rapide pour intégrer cette fonctionnalité. Les SDK gèrent les détails de bas niveau afin que vous puissiez vous concentrer sur votre logique métier. Consultez 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 :

Obtenir les données des cellules à partir d’une plage nommée