Inserción masiva de texto para Excel: Agregar prefijos, sufijos y texto personalizado a celdas – Guía paso a paso

Inserte texto en múltiples celdas de Excel en una sola operación. Agregue prefijos, sufijos, etiquetas o caracteres personalizados al principio, al final o antes/después de un texto específico dentro de las celdas mediante la API de Aspose.Cells.

Descripción general

Inserción masiva en una sola llamada de prefijos, sufijos o cadenas ancladas en cada celda de un rango objetivo: sin fórmulas ni columnas auxiliares.

• Inserte texto personalizado en cualquier posición dentro de cada celda

• Cuatro modos de ubicación: prefijo, sufijo, antes/después de una subcadena.

• Omitir celdas vacías para evitar desorden.

• La API solo modifica valores de tipo texto; los números, valores booleanos y fórmulas se convierten primero a texto.

• Celdas vacías

  • skipEmptyCells = true → se omiten las celdas vacías.
  • skipEmptyCells = false → se llena la celda vacía con el texto a insertar (la celda se convierte en tipo texto).

• Ancla no encontrada: Cuando position = BeforeText | AfterText y selectText no existe, el valor de la celda permanece sin cambios.

API web

PUT https://api.aspose.cloud/v4.0/cells/content/add/text

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

-H "Authorization: Bearer {access_token}"

Parámetros de solicitud de la API AddText

Ejemplo con 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"

Respuesta

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

Códigos de error

¿Dónde debemos usar la API de Add Text para hojas de cálculo?

• Etiquetado dinámico de informes: Agregue títulos dinámicos, etiquetas de fecha u observaciones a estados financieros y reportes de ventas generados automáticamente.
• Marcas de agua por lotes: Agregue logotipos de empresa, marcas de agua de confidencialidad o información de versión a un lote de archivos de Excel.
• Relleno de datos de plantillas: Rellene automáticamente nombres de clientes, montos y otro texto en posiciones designadas de plantillas de contratos o facturas.
• Etiquetado por clasificación de datos: Agregue automáticamente etiquetas de clasificación o etiquetas de estado (por ejemplo, “Pendiente de revisión”, “Aprobado”) a filas de datos según los resultados del análisis.
• Anotación de calidad de datos: Agregue notas para datos problemáticos durante la limpieza de datos.
• Formato de texto por lotes: Agregue uniformemente prefijos o sufijos a nombres de productos o clientes.

¿Por qué debería usar la API de Add Text para hojas de cálculo?

• Adición masiva de texto: Agregue texto a cientos de celdas o archivos a la vez, ahorrando hasta un 95 % del tiempo en comparación con el trabajo manual.
• Control preciso de la posición: Admite la inserción precisa de texto en seis posiciones, incluyendo el inicio, el final o antes/después de un texto específico dentro de una celda.
• Manejo inteligente condicional: Decida si agregar texto según si la celda está vacía o contiene texto específico.
• Soporte para estrategia de múltiples posiciones:
  • AtTheBeginning: Agregue el mismo texto antes del contenido de todas las celdas seleccionadas.
  • AtTheEnd: Agregue texto después del contenido de todas las celdas seleccionadas.
  • BeforeText / AfterText: Agregue texto solo antes o después de las celdas que contienen texto específico.
  • None: Reemplace el contenido original.
• Control preciso del rango: Permite especificar hojas de cálculo o rangos de celdas particulares para las operaciones.
• Opción de omitir condicionalmente: Admite omitir celdas vacías para evitar adiciones innecesarias de texto.
• Amigable para desarrolladores: Aspose.Cells Cloud ofrece bibliotecas SDK en múltiples lenguajes, lo que permite un desarrollo rápido y viene con documentación completa. En comparación con la construcción de soluciones personalizadas de renderizado de gráficos, esto reduce significativamente la carga de desarrollo.
• Rentable: Puede agregar texto en una celda sin cargar primero el libro, lo que ahorra espacio de almacenamiento y reduce costos.

Especificación OpenAPI

La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.

Utilice los SDK de Aspose.Cells Cloud

Usar el SDK es la mejor manera de acelerar el desarrollo. El SDK maneja los detalles subyacentes, lo que le permite simplemente implementar la inserción de texto en celdas con un código mínimo. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código ilustran cómo realizar llamadas a los servicios web de Aspose.Cells mediante varios SDK: