Documentation –

Developer-Guide: Ajuster automatiquement la largeur d'une colonne dans Excel à l’aide de l’API Aspose.Cells Cloud – Guide rapide

Mon, 01 Jan 0001 00:00:00 +0000

Cette API REST ajuste automatiquement la largeur d’une colonne unique ou d’une plage contiguë de colonnes dans une feuille Excel.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	chemin	Le nom du fichier Excel.
sheetName	string	chemin	Le nom de la feuille de calcul.
firstColumn	integer	requête	Index de base zéro de la première colonne à ajuster automatiquement.
lastColumn	integer	requête	Index de base zéro de la dernière colonne à ajuster automatiquement.
autoFitterOptions	object	corps	Options contrôlant le comportement d’ajustement automatique (voir AutoFitterOptions).
firstRow	integer	requête	Index de base zéro de la première ligne prise en compte lors du calcul de la largeur de colonne.
lastRow	integer	requête	Index de base zéro de la dernière ligne prise en compte lors du calcul de la largeur de colonne.
folder	string	requête	Le dossier dans le stockage où le fichier est situé.
storageName	string	requête	Le nom du service de stockage.

Réponses d’erreur

Statut HTTP	Signification	Corps JSON d’exemple
400	Paramètre(s) invalide(s)	`{"Code":400,"Message":"Paramètre invalide 'firstColumn'."}`
401	Non autorisé – token JWT manquant ou invalide	`{"Code":401,"Message":"Échec de l'authentification."}`
404	Fichier ou feuille non trouvé	`{"Code":404,"Message":"Feuille 'Sheet1' introuvable."}`
500	Erreur interne du serveur	`{"Code":500,"Message":"Une erreur inattendue s'est produite."}`

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 Aspose.Cells Cloud. L’exemple ci-dessous montre comment invoquer le point de terminaison d’ajustement automatique de colonne.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitcolumns?firstColumn=2&lastColumn=2" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>" \
  -d '{"AutoFitMergedCells": true, "IgnoreHidden": true, "OnlyAuto": true}'

Réponse

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

Famille de SDK Cloud

L’utilisation d’un SDK est le moyen le plus rapide d’intégrer l’API dans votre application. Les SDK gèrent les détails de bas niveau afin que vous puissiez vous concentrer sur la logique métier. 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 le point de terminaison d’ajustement automatique de colonne à l’aide de divers SDK :

Developer-Guide: Ajuster automatiquement plusieurs colonnes sur une feuille Excel

Mon, 01 Jan 0001 00:00:00 +0000

Cette API REST permet d’ajuster automatiquement plusieurs colonnes sur une feuille Excel.

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Le nom du fichier.
sheetName	string	path	Le nom de la feuille de calcul.
firstColumn	integer	query	L’index de la colonne de départ.
lastColumn	integer	query	L’index de la colonne de fin.
autoFitterOptions*	object	body	Options d’ajustement automatique (voir Options de l’ajusteur automatique). Inclut `AutoFitMergedCells`, `IgnoreHidden` et `OnlyAuto`.
firstRow	integer	query	L’index de la ligne de départ pour l’ajustement automatique (facultatif).
lastRow	integer	query	L’index de la ligne de fin pour l’ajustement automatique (facultatif).
folder	string	query	Chemin du dossier dans le stockage (facultatif).
storageName	string	query	Nom du stockage (facultatif).

*Le nom du paramètre est affiché sous forme de lien vers la documentation associée.

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 effectuer des appels à l’API Cloud avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitcolumns?lastColumn=5&firstColumn=0" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton JWT>" \
  -d '{"AutoFitMergedCells": true, "IgnoreHidden": true, "OnlyAuto": true}'

Réponse

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

Famille de SDK Cloud

L’utilisation d’un SDK est la meilleure façon d’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 Cloud Aspose.Cells.

Les exemples de code suivants illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :

Developer-Guide: Ajuster automatiquement une ligne dans une feuille Excel

Mon, 01 Jan 0001 00:00:00 +0000

Cet API REST ajuste automatiquement une ligne dans une feuille Excel.

Sécurité et authentification

Les API 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}/autofitrow

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du fichier Excel.
sheetName	string	path	Nom de la feuille de calcul.
rowIndex	integer	query	Index de ligne (à partir de zéro) à ajuster automatiquement.
firstColumn	integer	query	Index de la première colonne incluse dans l’opération.
lastColumn	integer	query	Index de la dernière colonne incluse dans l’opération.
autoFitterOptions	object	body	Objet permettant de contrôler le comportement de l’ajustement automatique (par exemple, prise en compte des cellules fusionnées, texte automatique, etc.). Voir AutoFitterOptions{:rel=“noopener” title=“Contrôle du comportement d’ajustement automatique”}.
folder	string	query	Dossier dans lequel le fichier est stocké.
storageName	string	query	Nom du stockage.

Exemple de corps JSON pour autoFitterOptions

{
  "IsMergedCells": true,
  "IsWrapped": false,
  "AutoFitMergedCells": true,
  "AutoFitWrappedCells": false
}

Définitions des entités

Entité	Description
`rowIndex`	Index de la ligne cible (à partir de zéro).
`firstColumn`	Colonne de départ pour l’opération d’ajustement automatique.
`lastColumn`	Colonne de fin pour l’opération d’ajustement automatique.
`autoFitterOptions`	Paramètres facultatifs influençant la façon dont la ligne est ajustée automatiquement (cellules fusionnées, texte automatique, etc.).

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 ci-dessous montre comment appeler l’API avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitrow?rowIndex=2&firstColumn=1&lastColumn=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>"

Réponse

Champ	Description
Code	`200` – la requête a réussi.
Status	`"OK"` – la ligne a été ajustée automatiquement.

Gestion des erreurs

L’API renvoie des codes d’état HTTP standard. Les réponses d’erreur courantes pour cet endpoint sont :

Code HTTP	Exemple de charge utile	Signification
400	`{ "Code": 400, "Message": "Index de ligne hors limites." }`	L’`rowIndex` fourni n’existe pas dans la feuille de calcul.
401	`{ "Code": 401, "Message": "Jeton invalide ou expiré." }`	Échec de l’authentification – vérifiez le jeton JWT et assurez-vous que la requête utilise HTTPS.
404	`{ "Code": 404, "Message": "Fichier introuvable." }`	Le fichier Excel ou la feuille de calcul spécifié ne peut être trouvé.
500	`{ "Code": 500, "Message": "Erreur interne du serveur." }`	Un problème inattendu est survenu côté serveur.

Famille de SDK Cloud

L’utilisation d’un SDK est la méthode la plus rapide pour développer. Un SDK masque les détails de bas niveau, vous permettant de vous concentrer sur votre logique métier. Consultez le dépôt GitHub{:rel=“noopener noreferrer”} pour une 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 :

Voir aussi : Ajuster automatiquement une colonne, Ajuster automatiquement plusieurs lignes, AutoFitterOptions.

Developer-Guide: Ajuster automatiquement plusieurs lignes dans une feuille de calcul Excel

Mon, 01 Jan 0001 00:00:00 +0000

Cette API REST ajuste automatiquement la hauteur des lignes dans une feuille de calcul Excel.

Sécurité et authentification

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

API REST

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

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description	Obligatoire
name	string	path	Le nom du fichier Excel.	✔
sheetName	string	path	Le nom de la feuille de calcul.	✔
autoFitterOptions	object	body	Options contrôlant la façon dont les lignes sont ajustées automatiquement (par exemple, ignorer les lignes masquées). Voir la description brève des champs ci-dessous.	✖
startRow	integer	query	La première ligne à ajuster automatiquement (index basé sur 1).	✔
endRow	integer	query	La dernière ligne à ajuster automatiquement (inclus).	✔
onlyAuto	boolean	query	Si `true`, l’API ajuste uniquement les lignes dont la hauteur est calculée automatiquement par Excel. Si `false`, un ajustement complet est effectué.	✖
folder	string	query	Le dossier contenant le document.	✖
storageName	string	query	Le nom du service de stockage.	✖

Champs de autoFitterOptions (tous facultatifs) :

AutoFitMergedCells (boolean) – Si true, les cellules fusionnées sont prises en compte lors du calcul de la hauteur des lignes.
IgnoreHidden (boolean) – Si true, les lignes masquées sont ignorées pendant le processus d’ajustement automatique.
OnlyAuto (boolean) – Reprend la valeur du paramètre de requête onlyAuto ; lorsqu’il est défini, il remplace la valeur du paramètre de requête.

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 à l’aide de cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitrows?startRow=1&endRow=7" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jeton jwt>" \
  -d '{"AutoFitMergedCells": true, "IgnoreHidden": true, "OnlyAuto": false}'

Réponse

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

Les réponses d’erreur typiques incluent :

400 Bad Request – Valeurs de paramètres invalides ou corps JSON mal formé.
401 Unauthorized – Jeton JWT manquant ou invalide.
404 Not Found – Le fichier ou la feuille de calcul spécifié n’existe pas.
500 Internal Server Error – Une erreur serveur inattendue s’est produite.

Codes de statut HTTP

Code	Signification	Description
200	OK	Filtre appliqué avec succès ; la réponse contient les détails de l’opération.
400	Bad Request	Paramètres manquants ou invalides (par exemple, type de fichier non pris en charge).
401	Unauthorized	Jeton JWT invalide ou manquant.
413	Payload Too Large	Le fichier téléchargé dépasse la limite de taille.
500	Internal Server Error	Erreur serveur inattendue.

Famille de SDK Cloud

L’utilisation d’un SDK est le moyen le plus rapide de développer. Un SDK gère les détails de bas niveau afin que vous puissiez vous concentrer sur 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 appeler les services web Aspose.Cells à l’aide de divers SDK :