Cómo renombrar hojas en Excel – Cambiar nombres de hojas

Renombre programáticamente hojas de cálculo en libros de Excel utilizando la API de Aspose.Cells Cloud. Cambie nombres de hojas, actualice etiquetas de pestañas dinámicamente y automatice la organización de hojas de cálculo mediante llamadas a la API REST. Útil para la estandarización de documentos y la automatización de flujos de trabajo.

Renombrar nombre de hoja en la API de hoja de cálculo

API web

PUT https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName={sourceName}&targetName={targetName}&outPath={outPath}&outStorageName={outStorageName}&region={region}&password={password}

Ejemplo con cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Hoja1&targetName=Informe_T1" \
     -H "Authorization: Bearer {access_token}" \
     -F "spreadsheet=@miLibro.xlsx"

Seguridad y autenticación

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

Parámetros de solicitud

Nombre del parámetro Tipo Ubicación Descripción
Spreadsheet File FormData Obligatorio. El archivo del libro de Excel (.xlsx, .xls, etc.) que contiene la hoja de cálculo que se va a renombrar.
sourceName String Query Obligatorio. El nombre actual de la hoja de cálculo que desea renombrar.
targetName String Query Obligatorio. El nuevo nombre que se asignará a la hoja de cálculo. Debe cumplir con las reglas de nomenclatura de Excel (no puede contener :, \, ?, *, [, ]) y ser único dentro del libro.
outPath String Query Opcional. La ruta de la carpeta de destino en el almacenamiento en la nube donde se guardará el libro renombrado. Si es null u omite este parámetro, el servicio guardará el archivo en la misma carpeta que el libro original (o en una ruta predeterminada).
outStorageName String Query Opcional. El identificador del nombre del servicio de almacenamiento en la nube configurado (por ejemplo, ArchiveStorage). Si se omite, se utiliza el almacenamiento predeterminado.
region String Query Opcional. La configuración regional (por ejemplo, es-ES) que puede influir en la codificación de caracteres o en las convenciones regionales de nomenclatura.
password String Query Opcional. La contraseña de descifrado necesaria para abrir y modificar un libro protegido con contraseña. Omítalo si el archivo no está cifrado.

Notas: Los nombres de hojas están limitados a 31 caracteres y no pueden contener los caracteres :, \, ?, *, [ ni ].

Respuesta

Una solicitud correcta devuelve un objeto JSON con información de estado y un enlace al archivo renombrado.

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

Códigos de estado HTTP

Código Significado Descripción
200 OK Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400 Solicitud incorrecta Parámetros faltantes o no válidos (por ejemplo, tipo de archivo no admitido).
401 No autorizado Token JWT no válido o faltante.
413 Carga demasiado grande El archivo subido supera el límite de tamaño.
500 Error interno del servidor Error inesperado en el servidor.

¿Dónde debemos utilizar la API de Renombrar hoja en hoja de cálculo?

  • Generación de informes y estandarización de marca – Al generar informes de clientes automáticamente, se renombran las hojas genéricas (por ejemplo, Hoja1) con nombres específicos para el cliente (por ejemplo, AcmeCorp_Informe_T1) para garantizar una entrega profesional.
  • Estandarización de canalización de procesamiento de datos – En flujos de trabajo ETL, las hojas exportadas con nombres irregulares se renombran según nombres estandarizados como Datos_crudos o Datos_limpios, cumpliendo así los requisitos de análisis posteriores.
  • Entrega de contenido multilingüe – Según la preferencia lingüística del usuario, los nombres de las hojas se localizan (por ejemplo, 数据 o Datos) antes de entregar el archivo, ofreciendo una experiencia personalizada.

¿Por qué debería utilizar la API de Renombrar hoja en hoja de cálculo?

  • Amigable para desarrolladores – Proporciona SDK para varios lenguajes con documentación completa, simplificando la integración en comparación con construir una solución personalizada.
  • Reducción del esfuerzo manual – Automatiza el renombrado de hojas, reduciendo el trabajo manual.
  • Modelo de pago por uso – Se cobra únicamente por las llamadas a la API, eliminando los costos iniciales de licencia.
  • Sin mantenimiento de servidor – Al tratarse de un servicio en la nube, elimina la necesidad de alojar y mantener servidores ni aplicar actualizaciones de software.
  • Soporte para automatización – Facilita la estandarización automatizada de documentos dentro de flujos de trabajo.

Cómo utilizar la API de Renombrar hoja en hoja de cálculo con SDK

Especificación OpenAPI

La Especificación OpenAPI detalla una interfaz de programación accesible públicamente, permitiendo interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar llamadas a la API en la nube con cURL.

Utilizar los SDK de Aspose.Cells Cloud

Utilizar un SDK es la forma más rápida de acelerar el desarrollo. El SDK abstracte los detalles HTTP subyacentes, permitiéndole renombrar hojas 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 muestran cómo llamar a los servicios web de Aspose.Cells utilizando diversos SDK:

GetMergedCellsInRemotedWorksheet Aceptar Todas las Revisiones en una Hoja de Cálculo Remota