Actualizar una forma en una hoja de cálculo de Excel - API de Aspose.Cells Cloud

Esta API REST actualiza una forma en una hoja de cálculo de Excel.

Seguridad y autenticación

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

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}

Parámetros de la solicitud

Nombre del parámetro Tipo Ubicación Descripción
name string path El nombre del archivo del libro.
sheetName string path El nombre de la hoja de cálculo que contiene la forma.
shapeindex integer path El índice basado en cero de la forma dentro de la hoja de cálculo.
dto object body El objeto de transferencia de datos de la forma que contiene las propiedades actualizadas (véase el esquema DTO más abajo).
folder string query La carpeta donde se almacena el libro.
storageName string query El nombre del almacenamiento de Aspose Cloud.

Esquema DTO

El objeto dto contiene las propiedades que se pueden actualizar. Todos los campos son opcionales, a menos que se indique lo contrario.

Campo Tipo Obligatorio Descripción
Name string No Nuevo nombre de la forma.
UpperLeftRow integer No Índice de fila de la esquina superior izquierda de la forma.
UpperLeftColumn integer No Índice de columna de la esquina superior izquierda de la forma.
Width integer No Anchura de la forma (en puntos).
Height integer No Altura de la forma (en puntos).
RotationAngle integer No Ángulo de rotación en grados.
IsHidden boolean No true para ocultar la forma.
IsLocked boolean No true para bloquear la forma.
Font object No Configuración de fuente (véase la especificación OpenAPI para subpropiedades).
… … No Propiedades adicionales, como HtmlText, AlternativeText, ZOrderPosition, etc.

Para obtener una lista completa, consulte la especificación oficial de OpenAPI: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

Encabezados de la solicitud

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (el token JWT del paso de autenticación)

Cuerpo de la solicitud (ejemplo)

{
  "Name": "MiForma",
  "UpperLeftRow": 2,
  "UpperLeftColumn": 3,
  "Width": 150,
  "Height": 80,
  "RotationAngle": 0,
  "IsHidden": false,
  "IsLocked": false,
  "Font": {
    "Name": "Calibri",
    "Size": 12,
    "IsBold": true,
    "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }
  }
}

Ejemplo con cURL (herramienta de línea de comandos)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes/0?folder=Temp" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
        "Name": "FormaActualizada",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

Respuesta

{
  "Code": 200,
  "Status": "OK"
}

Manejo de errores: la API puede devolver los siguientes códigos de estado:

Código Significado Causa típica
400 Solicitud incorrecta JSON inválido o campos obligatorios ausentes.
401 No autorizado Token JWT ausente o inválido.
404 No encontrado El libro, la hoja de cálculo o el índice de forma no existen.
500 Error interno del servidor Problema inesperado del lado del servidor.

Ejemplos de respuestas de error

400 – Solicitud incorrecta

{
  "Code": 400,
  "Message": "Payload de solicitud inválido. El campo 'Name' excede la longitud máxima."
}

401 – No autorizado

{
  "Code": 401,
  "Message": "Fallo en la autenticación. Token JWT inválido o caducado."
}

404 – No encontrado

{
  "Code": 404,
  "Message": "No se encontró el libro, la hoja de cálculo o el índice de forma especificados."
}

500 – Error interno del servidor

{
  "Code": 500,
  "Message": "Ocurrió un error inesperado en el servidor."
}

Familia de SDK en la nube

Utilizar un SDK es la mejor manera de acelerar el desarrollo. Un SDK maneja los detalles de bajo nivel para que usted se enfoque en las tareas de su proyecto. 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 mediante distintos SDK:

Agregar una forma a una hoja de cálculo de Excel Eliminar todas las formas en una hoja de cálculo de Excel