Insertion groupée de texte dans Excel – Ajouter des préfixes, suffixes et texte personnalisé aux cellules – Guide étape par étape
Insérez du texte dans plusieurs cellules Excel en une seule opération. Ajoutez des préfixes, suffixes, libellés ou caractères personnalisés en début, en fin, ou avant/après un texte spécifique dans les cellules à l’aide de l’API Aspose.Cells.
Vue d’ensemble
Insertion groupée en une seule requête de préfixes, suffixes ou chaînes ancrées dans chaque cellule d’une plage cible — aucune formule, aucune colonne d’aide.
- Insérez du texte personnalisé à n’importe quelle position dans chaque cellule
| Valeur | Description |
|---|---|
None |
Remplace le contenu original |
AtTheBeginning |
Insère au début (préfixe) |
AtTheEnd |
Insère en fin (suffixe) |
BeforeText |
Insère avant la première occurrence de selectText ; saute si non trouvé |
AfterText |
Insère après la première occurrence de selectText ; saute si non trouvé |
-
Quatre modes d’emplacement : préfixe, suffixe, avant/après une sous-chaîne.
-
Ignore les cellules vides pour éviter tout encombrement.
-
L’API modifie uniquement les valeurs de type chaîne ; les nombres, booléens et formules sont d’abord convertis en texte.
-
Cellules vides
skipEmptyCells = true→ les cellules vides sont ignorées.skipEmptyCells = false→ du texte est ajouté aux cellules vides (la cellule devient de type texte).
-
Ancre introuvable : si
position = BeforeText | AfterTextet queselectTextn’existe pas, la valeur de la cellule reste inchangée.
API Web
PUT https://api.aspose.cloud/v4.0/cells/content/add/text
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 de l’API AddText
| Nom du paramètre | Type | Emplacement (Chemin/Requête/Corps HTTP) | Description | Obligatoire |
|---|---|---|---|---|
| Spreadsheet | Fichier | FormData | Le fichier de feuille de calcul à traiter. Les formats pris en charge incluent XLSX, XLS, ODS, CSV, etc. | Oui |
| text | Chaîne | Requête | Le contenu textuel à ajouter dans les cellules spécifiées de la feuille de calcul. | Oui |
| position | Chaîne | Requête | Indique où insérer le texte par rapport au contenu existant de la cellule. Options : AtTheBeginning, AtTheEnd, BeforeText, AfterText, None. |
Oui |
| selectText | Chaîne | Requête | (Facultatif) Si fourni, le texte sera ajouté uniquement dans les cellules contenant exactement cette sous-chaîne. À utiliser conjointement avec position. |
Non |
| skipEmptyCells | Booléen | Requête | Si true, les cellules vides sont ignorées ; si false, du texte est ajouté aux cellules vides. |
Non |
| worksheet | Chaîne | Requête | (Facultatif) Le nom de la feuille de calcul dans laquelle le texte sera ajouté. Par défaut, l’opération s’applique à la première feuille. | Non |
| range | Chaîne | Requête | (Facultatif) La plage de cellules dans laquelle le texte sera ajouté (ex. "A1:C10"). Par défaut, l’opération s’applique à toutes les cellules utilisées. |
Non |
| outPath | Chaîne | Requête | (Facultatif) Le chemin du dossier dans le stockage cloud où le classeur traité sera enregistré. Par défaut, le fichier est enregistré dans le dossier source. | Non |
| outStorageName | Chaîne | Requête | Le nom du stockage cloud dans lequel le fichier de sortie sera stocké. | Non |
| region | Chaîne | Requête | (Facultatif) Définit la locale pour le formatage des nombres, dates et devises dans le fichier de sortie (ex. "en-US", "zh-CN", "de-DE"). |
Non |
| password | Chaîne | Requête | (Facultatif) Si la feuille de calcul uploadée est protégée par mot de passe, fournissez ce mot de passe pour l’ouvrir et la traiter. | Non |
Exemple cURL
curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/add/text?text=Report&position=AtTheBeginning&skipEmptyCells=true" \
-H "Authorization: Bearer {access_token}" \
-F "Spreadsheet=@/path/to/workbook.xlsx" \
-F "outPath=output/workbook_modified.xlsx"
Réponse
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Codes d’erreur
| Code | Description |
|---|---|
| 400 Bad Request | URI invalide de l’API Aspose.Cells Cloud ou paramètres obligatoires manquants. |
| 401 Unauthorized | Jeton d’accès invalide ou identifiant/secret client incorrect. |
| 404 Not Found | Le fichier de feuille de calcul est inaccessible. |
| 500 Server Error | Une anomalie est survenue lors de la récupération des données de calcul dans la feuille de calcul. |
Où utiliser l’API Add Text pour les feuilles de calcul ?
- Libellés dynamiques pour rapports : Ajouter des titres dynamiques, des libellés de date ou des notes à des états financiers et rapports de ventes générés automatiquement.
- Tamponnage groupé de fichiers : Ajouter des logos d’entreprise, des mentions de confidentialité ou des informations de version à un lot de fichiers Excel.
- Remplissage automatique de modèles : Remplir automatiquement les noms clients, montants et autres textes dans des positions prédéfinies de modèles de contrats ou factures.
- Étiquetage par classification des données : Ajouter automatiquement des tags de classification ou libellés de statut (ex. « En attente de validation », « Approuvé ») aux lignes de données selon les résultats d’analyse.
- Annotation de qualité des données : Ajouter des notes sur les données problématiques lors du nettoyage des données.
- Formatage textuel groupé : Ajouter uniformément des préfixes ou suffixes aux noms de produits ou clients.
Pourquoi utiliser l’API Add Text pour les feuilles de calcul ?
- Ajout groupé de texte : Ajoutez du texte à des centaines de cellules ou fichiers en une seule fois, économisant jusqu’à 95 % du temps par rapport au travail manuel.
- Contrôle précis de la position : Prend en charge l’insertion précise du texte à six positions : début, fin, ou avant/après un texte spécifique dans une cellule.
- Gestion intelligente conditionnelle : Décidez si le texte doit être ajouté selon que la cellule est vide ou contient un texte spécifique.
- Support de stratégies multi-position :
AtTheBeginning: Ajouter le même texte avant le contenu de toutes les cellules sélectionnées.AtTheEnd: Ajouter du texte après le contenu de toutes les cellules sélectionnées.BeforeText/AfterText: Ajouter du texte uniquement avant ou après les cellules contenant un texte spécifique.None: Remplacer le contenu original.
- Contrôle précis de la plage : Permet de spécifier des feuilles ou plages de cellules particulières pour les opérations.
- Option conditionnelle de saut : Prend en charge l’ignorance des cellules vides pour éviter l’ajout inutile de texte.
- Convivial pour les développeurs : Aspose.Cells Cloud propose des bibliothèques SDK dans plusieurs langages, facilitant un développement rapide, avec une documentation complète. Comparé à la création de solutions personnalisées de rendu graphique, cela réduit considérablement la charge de développement.
- ** rentable** : Vous pouvez ajouter du texte dans une cellule sans avoir à uploader préalablement le classeur, ce qui économise de l’espace de stockage et réduit les coûts.
Spécification OpenAPI
La Spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.
Utiliser les SDK Aspose.Cells Cloud
L’utilisation d’un SDK est le moyen le plus efficace d’accélérer le développement. Le SDK gère les détails sous-jacents, vous permettant d’implémenter simplement l’ajout de texte aux cellules avec un minimum de code. Consultez le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants illustrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :