Mettre à jour une forme sur une feuille de calcul Excel – API Aspose.Cells Cloud

Cet API REST permet de mettre à jour une forme sur une feuille de calcul Excel.

Sécurité et authentification

Les API REST Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.

API REST

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

Paramètres de la requête

Nom du paramètre Type Emplacement Description
name string path Le nom du fichier classeur.
sheetName string path Le nom de la feuille de calcul contenant la forme.
shapeindex integer path L’index de la forme (à partir de 0) au sein de la feuille de calcul.
dto object body L’objet de transfert de données (DTO) contenant les propriétés mises à jour (voir Schéma DTO ci-dessous).
folder string query Le dossier dans lequel le classeur est stocké.
storageName string query Le nom du stockage Aspose Cloud.

Schéma DTO

L’objet dto contient les propriétés modifiables. Tous les champs sont facultatifs sauf mention contraire.

Champ Type Obligatoire Description
Name string Non Nouveau nom de la forme.
UpperLeftRow integer Non Indice de ligne du coin supérieur gauche de la forme.
UpperLeftColumn integer Non Indice de colonne du coin supérieur gauche de la forme.
Width integer Non Largeur de la forme (en points).
Height integer Non Hauteur de la forme (en points).
RotationAngle integer Non Angle de rotation en degrés.
IsHidden boolean Non true pour masquer la forme.
IsLocked boolean Non true pour verrouiller la forme.
Font object Non Paramètres de police (voir la spécification OpenAPI pour les sous-propriétés).
… … Non Autres propriétés telles que HtmlText, AlternativeText, ZOrderPosition, etc.

Pour une liste complète, consultez la spécification OpenAPI officielle : https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

En-têtes de la requête

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (le jeton JWT obtenu lors de l’authentification)

Corps de la requête (exemple)

{
  "Name": "MyShape",
  "UpperLeftRow": 2,
  "UpperLeftColumn": 3,
  "Width": 150,
  "Height": 80,
  "RotationAngle": 0,
  "IsHidden": false,
  "IsLocked": false,
  "Font": {
    "Name": "Calibri",
    "Size": 12,
    "IsBold": true,
    "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }
  }
}

Exemple avec cURL (outil en ligne de commande)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes/0?folder=Temp" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
        "Name": "UpdatedShape",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

Réponse

{
  "Code": 200,
  "Status": "OK"
}

Gestion des erreurs – L’API peut renvoyer les codes HTTP suivants :

Code Signification Cause typique
400 Bad Request (Requête incorrecte) Payload JSON invalide ou champs obligatoires manquants.
401 Unauthorized (Non autorisé) Jeton JWT manquant ou invalide.
404 Not Found (Introuvable) Le classeur, la feuille de calcul ou l’index de forme n’existe pas.
500 Internal Server Error (Erreur interne) Problème inattendu côté serveur.

Exemples de réponses d’erreur

400 – Bad Request

{
  "Code": 400,
  "Message": "Invalid request payload. 'Name' field exceeds maximum length."
}

401 – Unauthorized

{
  "Code": 401,
  "Message": "Authentication failed. Invalid or expired JWT token."
}

404 – Not Found

{
  "Code": 404,
  "Message": "The specified workbook, worksheet, or shape index was not found."
}

500 – Internal Server Error

{
  "Code": 500,
  "Message": "An unexpected error occurred on the server."
}

Famille de SDK Cloud

L’utilisation d’un SDK est la méthode recommandée pour accélérer le développement. Un SDK gère les détails de bas niveau, vous permettant de vous concentrer sur vos tâches de projet. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants illustrent l’appel des services web Aspose.Cells à l’aide de divers SDK :

Ajouter une forme à une feuille Excel Supprimer toutes les formes d'une feuille Excel