Ajouter une colonne vide à une feuille de calcul Excel à l’aide de l’API Aspose.Cells Cloud

Cette API REST insère une ou plusieurs colonnes dans une feuille de calcul.

Conditions préalables
Avant d’appeler ce point de terminaison, assurez-vous d’avoir effectué les étapes suivantes :

  • Obtenir un jeton d’accès OAuth 2.0 valide et l’inclure dans l’en-tête Authorization.
  • Stocker le classeur cible dans le stockage sélectionné (par défaut = « Default ») ou spécifier les paramètres appropriés folder et storageName.
  • Vérifier que le nom de la feuille de calcul fourni dans sheetName existe dans le classeur.

API PutInsertWorksheetColumns

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

Sécurité et authentification

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

Paramètres de la requête

Nom du paramètre Type Emplacement Description
name string path Nom du fichier de classeur.
sheetName string path Nom de la feuille de calcul.
columnIndex integer path Index de colonne en base zéro à partir duquel commence l’insertion.
totalColumns integer query Nombre de colonnes à insérer.
updateReference boolean query Si true, les références aux cellules sont mises à jour pour refléter l’insertion.
folder string query Chemin du dossier contenant le classeur.
storageName string query Nom du service de stockage.

Notes

  • Le columnIndex doit être compris entre 0 et le nombre actuel de colonnes dans la feuille de calcul. L’insertion au-delà de la plage existante élargit automatiquement la feuille.
  • L’insertion de plusieurs colonnes (totalColumns > 1) décale les colonnes existantes vers la droite.
  • Le drapeau updateReference vaut false par défaut ; définissez-le sur true pour mettre à jour les formules et les plages nommées.

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 les services web Aspose.Cells. L’exemple suivant montre une requête complète, incluant l’authentification et le paramètre de chemin correct.

Codes de réponse

Code Description
200 Colonne(s) insérée(s) avec succès.
400 Requête incorrecte – paramètres manquants ou invalides.
401 Non autorisé – jeton invalide ou manquant.
404 Classeur ou feuille de calcul introuvable.
500 Erreur interne du serveur.

Exemples de réponses d’erreur

// 400 Requête incorrecte – paramètres manquants ou invalides
{
  "Code": 400,
  "Message": "Paramètre invalide : totalColumns doit être un entier positif."
}

// 401 Non autorisé – jeton invalide ou manquant
{
  "Code": 401,
  "Message": "Échec de l’authentification. Le jeton d’accès est manquant ou invalide."
}

// 404 Non trouvé – le classeur ou la feuille de calcul n’existe pas
{
  "Code": 404,
  "Message": "Le classeur « test.xlsx » est introuvable."
}

// 500 Erreur interne du serveur
{
  "Code": 500,
  "Message": "Une erreur inattendue s’est produite sur le serveur."
}

Famille de SDK Cloud

L’utilisation d’un SDK constitue la méthode la plus rapide pour développer. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur la logique de votre projet. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.

Les exemples de code suivants illustrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :

Supprimer une colonne d'une feuille de calcul Excel à l'aide de l'API Aspose.Cells Cloud Copier des colonnes dans une feuille de calcul Excel