Uppdatera en form i ett Excel-ark – Aspose.Cells Cloud API

Denna REST API uppdaterar en form i ett Excel-ark.

Säkerhet och autentisering

Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.

REST API

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

Begäranparametrar

Parametername Typ Plats Beskrivning
name string path Namnet på arbetsboksfilen.
sheetName string path Namnet på arket som innehåller formen.
shapeindex integer path Det nollbaserade indexet för formen i arket.
dto object body Objektet för formens dataöverföring som innehåller de uppdaterade egenskaperna (se DTO-schema nedan).
folder string query Mappen där arbetsboken är lagrad.
storageName string query Namnet på Aspose Cloud-lagringen.

DTO-schema

dto-objektet innehåller de egenskaper som kan uppdateras. Alla fält är valfria om inget annat anges.

Fält Typ Obligatoriskt Beskrivning
Name string Nej Nytt namn för formen.
UpperLeftRow integer Nej Radindex för formens övre vänstra hörn.
UpperLeftColumn integer Nej Kolumnindex för formens övre vänstra hörn.
Width integer Nej Bredd på formen (i punkter).
Height integer Nej Höjd på formen (i punkter).
RotationAngle integer Nej Rotationsvinkel i grader.
IsHidden boolean Nej true för att dölja formen.
IsLocked boolean Nej true för att låsa formen.
Font object Nej Teckensnittsinställningar (se OpenAPI-specifikationen för underordnade egenskaper).
… … Nej Ytterligare egenskaper såsom HtmlText, AlternativeText, ZOrderPosition, etc.

För en fullständig lista, se den officiella OpenAPI-specifikationen: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

Begärandehuvuden

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (JWT-token från Autentisering-steget)

Begärantext (exempel)

{
  "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 }
  }
}

Exempel med cURL (kommandoradsverktyg)

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
      }'

Svar

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

Felhantering – API:et kan returnera följande statuskoder:

Kod Beteende Vanlig orsak
400 Felaktig begäran Ogiltig JSON eller obligatoriska fält saknas.
401 Autentisering krävs Saknas eller ogiltig JWT-token.
404 Hittades inte Arbetsboken, arket eller formindexet finns inte.
500 Internt serverfel Oväntat problem på servern.

Exempel på felaktiga svar

400 – Felaktig begäran

{
  "Code": 400,
  "Message": "Ogiltig begäran. Fältet 'Name' överskrider maxlängden."
}

401 – Autentisering krävs

{
  "Code": 401,
  "Message": "Autentisering misslyckades. Ogiltig eller utgången JWT-token."
}

404 – Hittades inte

{
  "Code": 404,
  "Message": "Den angivna arbetsboken, arket eller formindexet hittades inte."
}

500 – Internt serverfel

{
  "Code": 500,
  "Message": "Ett oväntat fel uppstod på servern."
}

SDK-familj för molnet

Användning av en SDK är det bästa sättet att påskynda utvecklingen. En SDK hanterar detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Besök GitHub-lagret för en fullständig lista över Aspose.Cells Cloud SDK:n.

Följande kodexempel visar hur du anropar Aspose.Cells-webbtjänster med olika SDK:er:

Lägg till en form i ett Excel-arbetsblad Ta bort alla former i ett Excel-ark