Aggiorna una forma in un foglio di lavoro Excel - API Aspose.Cells Cloud

Questa API REST aggiorna una forma in un foglio di lavoro Excel.

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione tramite token JWT.

API REST

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

Parametri della richiesta

Nome del parametro Tipo Posizione Descrizione
name stringa percorso Il nome del file del workbook.
sheetName stringa percorso Il nome del foglio di lavoro che contiene la forma.
shapeindex intero percorso L’indice in base zero della forma all’interno del foglio di lavoro.
dto oggetto corpo L’oggetto di trasferimento dati della forma che contiene le proprietà aggiornate (vedi Schema DTO di seguito).
folder stringa query La cartella in cui è memorizzato il workbook.
storageName stringa query Il nome dello storage di Aspose Cloud.

Schema DTO

L’oggetto dto contiene le proprietà che è possibile aggiornare. Tutti i campi sono facoltativi, salvo quanto indicato esplicitamente.

Campo Tipo Obbligatorio Descrizione
Name stringa No Nuovo nome per la forma.
UpperLeftRow intero No Indice di riga dell’angolo superiore sinistro della forma.
UpperLeftColumn intero No Indice di colonna dell’angolo superiore sinistro della forma.
Width intero No Larghezza della forma (in punti).
Height intero No Altezza della forma (in punti).
RotationAngle intero No Angolo di rotazione in gradi.
IsHidden booleano No true per nascondere la forma.
IsLocked booleano No true per bloccare la forma.
Font oggetto No Impostazioni del carattere (vedi specifica OpenAPI per le sottoproprietà).
… … No Altre proprietà, come HtmlText, AlternativeText, ZOrderPosition, ecc.

Per un elenco completo, fare riferimento alla specifica OpenAPI ufficiale: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

Intestazioni della richiesta

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (il token JWT ottenuto nel passo di Autenticazione)

Corpo della richiesta (esempio)

{
  "Name": "MyShape",
  "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 }
  }
}

Esempio con cURL (strumento a riga di comando)

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": "UpdatedShape",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

Risposta

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

Gestione degli errori – L’API può restituire i seguenti codici di stato:

Codice Significato Causa tipica
400 Richiesta non valida JSON non valido o campi obbligatori mancanti.
401 Non autorizzato Token JWT mancante o non valido.
404 Non trovato Il workbook, il foglio di lavoro o l’indice della forma non esistono.
500 Errore interno del server Problema imprevisto lato server.

Esempi di risposte di errore

400 – Richiesta non valida

{
  "Code": 400,
  "Message": "Payload della richiesta non valido. Il campo 'Name' supera la lunghezza massima."
}

401 – Non autorizzato

{
  "Code": 401,
  "Message": "Autenticazione non riuscita. Token JWT non valido o scaduto."
}

404 – Non trovato

{
  "Code": 404,
  "Message": "Il workbook, il foglio di lavoro o l'indice della forma specificati non sono stati trovati."
}

500 – Errore interno del server

{
  "Code": 500,
  "Message": "Si è verificato un errore imprevisto sul server."
}

Famiglia di SDK per il cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells Cloud utilizzando vari SDK:

Aggiungi una forma a un foglio di calcolo Excel Eliminare tutte le forme in un foglio di lavoro Excel