Déplacez de manière programmatique des feuilles de calcul au sein des classeurs Excel à l’aide de l’API Aspose.Cells Cloud. Modifiez les positions des feuilles, réorganisez les onglets et optimisez la structure du classeur grâce à des appels RESTful à l’API. Idéal pour automatiser l’organisation des feuilles de calcul et créer des dispositions standardisées des classeurs.
Déplacer une feuille de calcul via l’API
API Web
PUT http://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?sheetName={sheetName}&position={position}&outPath={outPath}&outStorageName={outStorageName}®ion={region}&password={password}
Sécurité et authentification
Les API Aspose.Cells Cloud sont sécurisées et nécessitent une authentification basée sur un jeton JWT.
-H "Authorization: Bearer {access_token}"
Paramètres de la requête :
| Nom du paramètre | Type | Emplacement (chemin / chaîne de requête / corps HTTP) | Description |
|---|---|---|---|
| Spreadsheet | Fichier | FormData | Obligatoire. Fichier du classeur Excel source (.xlsx, .xls, etc.) contenant la feuille de calcul à repositionner. |
| worksheet | Chaîne | Query | Obligatoire. Nom exact de la feuille de calcul à déplacer (par exemple, Résumé, DonnéesBrutes_2024). |
| position | Entier | Query | Obligatoire. Nouvelle position d’index à zéro de la feuille de calcul. Par exemple, 0 la place en première position, 2 la place en troisième position. |
| outPath | Chaîne | Query | Facultatif. Chemin du dossier cible dans le stockage cloud où le classeur réorganisé sera enregistré. Si null ou omis, le dossier source est utilisé. |
| outStorageName | Chaîne | Query | Obligatoire. Nom identifiant votre service de stockage cloud configuré (par exemple, TeamDrive) où le fichier de sortie sera stocké. |
| region | Chaîne | Query | Facultatif. Paramètre de localisation (par exemple, fr-FR) à appliquer, pouvant influencer certaines règles de formatage lors de l’enregistrement. |
| password | Chaîne | Query | Facultatif. Mot de passe de déchiffrement nécessaire pour ouvrir et modifier un classeur protégé par mot de passe. À omettre si le fichier n’est pas chiffré. |
Réponse
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Codes d’état HTTP
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Filtre appliqué avec succès ; la réponse contient les détails de l’opération. |
| 400 | Requête incorrecte | Paramètres manquants ou invalides (par exemple, type de fichier non pris en charge). |
| 401 | Non autorisé | Jeton JWT invalide ou manquant. |
| 413 | Charge utile trop grande | Fichier téléchargé dépassant la taille limite. |
| 500 | Erreur interne du serveur | Erreur serveur inattendue. |
Où utiliser l’API de déplacement de feuille de calcul dans une feuille de calcul ?
- Génération standardisée de rapports : après la génération automatique des rapports mensuels ou trimestriels, la feuille
RésuméouVue d’ensemble exécutiveest déplacée en première position du classeur afin que les conclusions principales soient immédiatement visibles à l’ouverture du fichier. - Pipeline de traitement des données : après le traitement des feuilles brutes issues de différentes sources dans le cadre du processus ETL, la feuille
DonnéesTraitées, une fois nettoyée et transformée, est placée à une position logique dans le classeur (par exemple, au milieu), ce qui crée une structure claire avec les données d’origine et les résultats d’analyse. - Livraison de fichiers personnalisés selon les préférences utilisateur : après qu’un utilisateur a sélectionné une mise en page préférée via une interface de configuration (par exemple, en plaçant la page de graphique en premier), le système réorganise automatiquement l’ordre des feuilles dans le classeur selon la sélection et livre le fichier personnalisé.
Pourquoi utiliser l’API de déplacement de feuille de calcul dans une feuille de calcul ?
- Adaptée aux développeurs : Aspose.Cells Cloud propose des bibliothèques SDK dans plusieurs langages, facilitant un développement rapide, accompagné d’une documentation complète. Comparé à la création de solutions sur mesure, cela réduit considérablement la charge de développement.
- Réduction des coûts de main-d’œuvre : diminue la nécessité de personnel dédié à la consolidation de documents.
- Paiement à l’usage : pas d’investissement initial ; vous ne payez que les appels à l’API effectivement utilisés.
- Coûts de maintenance nuls : pas besoin de maintenir des serveurs, mettre à jour des logiciels ou gérer des problèmes de compatibilité.
Comment utiliser l’API de déplacement de feuille de calcul dans une feuille de calcul avec les SDK ?
Spécification de l’API de déplacement de feuille de calcul dans une feuille de calcul
La spécification de l’API de déplacement de feuille de calcul dans une feuille de calcul fournit une interface de programmation accessible publiquement pour faciliter les interactions REST directes 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.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK est la méthode la plus rapide pour développer, car elle masque les détails de bas niveau, vous permettant de déplacer des feuilles de calcul dans une feuille de calcul à l’aide d’un code concis. Consultez 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 :