Définir une valeur de plage dans une feuille de calcul Excel – API Aspose.Cells Cloud

Utilisez cette API REST pour définir une valeur dans la plage spécifiée. Lorsque cela est approprié, la valeur est convertie vers un autre type de données et le format numérique de la cellule est réinitialisé.

Conditions préalables

  • Un compte Aspose Cloud valide.
  • Un jeton JWT incluant le scope Cells.ReadWrite.
  • Le classeur doit déjà avoir été téléchargé dans l’emplacement de stockage cible.

API PostWorksheetCellsRangeValue

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

Les paramètres de la requête sont les suivants :

Nom du paramètre Type Emplacement Description
name string path Nom du classeur
sheetName string path Nom de la feuille de calcul
value string query Valeur d’entrée
range object body Objet plage dans la feuille de calcul
isConverted boolean query Indique si la valeur d’entrée doit être convertie
setStyle boolean query Indique s’il faut appliquer un style aux cellules cibles
folder string query Dossier du classeur
storageName string query Nom du stockage

Exemple d’objet range pouvant être envoyé dans le corps de la requête :

{
  "range": {
    "FirstRow": 0,
    "FirstColumn": 0,
    "RowCount": 1,
    "ColumnCount": 1
  }
}

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 accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment appeler l’API Cloud avec cURL. Incluez un jeton JWT valide dans l’en-tête Authorization.

Schéma de réponse

Champ Type Description
Code integer Code de statut HTTP de l’opération.
Status string Brève description du résultat (par exemple, « OK »).
Message string Message d’erreur détaillé en cas d’échec de la requête (facultatif).
Result object Données supplémentaires renvoyées pour les appels réussis (facultatif).

Codes de statut HTTP possibles

  • 200 OK – La valeur de la plage a été définie avec succès.
  • 400 Bad Request – Paramètres invalides ou corps de requête mal formé.
  • 401 Unauthorized – Jeton JWT manquant ou invalide.
  • 403 Forbidden – Autorisations insuffisantes pour l’opération demandée.
  • 404 Not Found – Le classeur, la feuille de calcul ou la plage spécifiée n’existe pas.
  • 500 Internal Server Error – Erreur serveur inattendue.

Exemple de réponse d’erreur pour un code 400 Bad Request :

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "L’objet 'range' ne contient pas les champs obligatoires."
}

Famille de SDK Cloud

L’utilisation d’un SDK constitue la méthode optimale pour accélérer le développement. Un SDK gère les détails de bas niveau, vous permettant ainsi de 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 illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Définir le style d'une plage – API Aspose.Cells Cloud Modifier les largeurs de colonnes dans une plage