Copier une plage dans une feuille de calcul avec des options de collage – API Aspose.Cells Cloud

Cette API REST copie une plage dans une feuille de calcul d’un classeur Excel. Pour les opérations connexes, consultez la documentation Get Range (Obtenir une plage) et Update Range (Mettre à jour une plage).

Prérequis : Pour utiliser ce point de terminaison, vous devez disposer d’un jeton OAuth 2.0 / JWT valide et vous assurer que votre version d’API correspond à l’URL de la requête.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Le nom du classeur.
sheetName	string	path	Le nom de la feuille de calcul.
rangeOperate	string	body	L’opération à effectuer : `copydata`, `copystyle`, `copyto` ou `copyvalue`.
folder	string	query	Le dossier contenant le classeur.
storageName	string	query	Le nom du service de stockage.

Remarques : Le champ rangeOperate détermine ce qui est copié. Utilisez copydata pour copier uniquement les valeurs des cellules, copystyle pour le formatage, copyto pour les données et le style, et copyvalue pour copier les valeurs sans les formules. L’API prend en charge des plages allant jusqu’à 1 million de cellules ; des plages plus grandes peuvent entraîner un délai d’attente dépassé.

La Spécification OpenAPI définit une interface de programmation publiquement accessible 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 effectuer des appels à l’API Cloud à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/ranges" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>" \
  -d '{
        "Operate": "string",
        "Source": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "Target": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "PasteOptions": {
          "OnlyVisibleCells": true,
          "PasteType": "string",
          "SkipBlanks": true,
          "Transpose": true
        }
      }'

Réponse

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

En cas de succès, la réponse renvoie un statut 200 OK. En cas d’erreur, l’API peut renvoyer des charges utiles telles que :

{
  "Code": 400,
  "Message": "Requête incorrecte – paramètres non valides."
}

{
  "Code": 401,
  "Message": "Non autorisé – jeton d’authentification manquant ou non valide."
}

Ces objets d’erreur incluent un code d’état HTTP et un message descriptif pour vous aider à diagnostiquer les problèmes.

Vous pouvez télécharger un classeur d’exemple pour tester l’opération de copie ici.

Famille de SDK Cloud

L’utilisation d’un SDK constitue la meilleure méthode pour accélérer le développement. Un SDK gère les détails de bas niveau afin que vous puissiez 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 montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :