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 | AfterText et que selectText n’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 :