Aspose.Cells Cloud API – Fusion de plages de cellules

Cet API REST permet de fusionner une plage de cellules en une seule cellule sur une feuille Excel.

Vue d’ensemble – La fusion d’une plage combine les cellules sélectionnées en une seule cellule, en conservant la valeur de la cellule en haut à gauche et en supprimant les autres. Utilisez cette opération lorsque vous devez créer un en‑tête couvrant plusieurs colonnes ou lignes, ou lorsque vous souhaitez simplifier la mise en page d’une feuille.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du classeur.
sheetName	string	path	Nom de la feuille de calcul.
range	object	body	Objet plage spécifiant les cellules à fusionner.
folder	string	query	Dossier dans lequel le classeur est stocké.
storageName	string	query	Nom du stockage.

Schéma du corps de la requête

L’objet Range doit contenir les champs suivants (les autres sont facultatifs) :

Propriété	Type	Obligatoire	Description
FirstRow	integer	Oui	Index de ligne (à partir de 0) de la première ligne de la plage.
FirstColumn	integer	Oui	Index de colonne (à partir de 0) de la première colonne de la plage.
RowCount	integer	Oui	Nombre de lignes à inclure dans la plage.
ColumnCount	integer	Oui	Nombre de colonnes à inclure dans la plage.
Name	string	Non	Nom facultatif pour la plage.
RefersTo	string	Non	Formule à laquelle la plage fait référence.
Worksheet	string	Non	Nom de la feuille de calcul (si différent du paramètre de chemin).
RowHeight	number	Non	Hauteur des lignes dans la plage (en pixels).
ColumnWidth	number	Non	Largeur des colonnes dans la plage (en pixels).

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple ci‑dessous montre comment effectuer un appel à l’API Cloud via cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

Réponse

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

Détails de la réponse

Statut HTTP	Description	Exemple JSON
200 OK	La plage a été fusionnée avec succès.	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	Paramètres de plage non valides (par ex., indices hors limites).	`{ "Code": 400, "Message": "Plage non valide." }`
401 Unauthorized	Jeton JWT manquant ou invalide.	`{ "Code": 401, "Message": "Échec de l’authentification." }`
404 Not Found	Classeur ou feuille de calcul introuvable.	`{ "Code": 404, "Message": "Ressource introuvable." }`
500 Internal Server Error	Erreur interne inattendue du serveur.	`{ "Code": 500, "Message": "Erreur interne du serveur." }`

Famille de SDK Cloud

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

Les exemples de code ci‑dessous montrent comment appeler les services web Aspose.Cells à l’aide de divers SDK :