Eine Form auf einem Excel-Arbeitsblatt aktualisieren – Aspose.Cells Cloud API

Diese REST-API aktualisiert eine Form in einem Excel-Arbeitsblatt.

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

REST-API

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

Anforderungsparameter

Parametername Typ Ort Beschreibung
name string path Der Name der Arbeitsmappe.
sheetName string path Der Name des Arbeitsblatts, das die Form enthält.
shapeindex integer path Der nullbasierte Index der Form innerhalb des Arbeitsblatts.
dto object body Das Datenübertragungsobjekt für die Form, das die aktualisierten Eigenschaften enthält (siehe DTO-Schema weiter unten).
folder string query Der Ordner, in dem die Arbeitsmappe gespeichert ist.
storageName string query Der Name des Aspose Cloud-Speichers.

DTO-Schema

Das dto-Objekt enthält die Eigenschaften, die aktualisiert werden können. Alle Felder sind optional, sofern nicht anders angegeben.

Feld Typ Erforderlich Beschreibung
Name string Nein Neuer Name für die Form.
UpperLeftRow integer Nein Zeilenindex der oberen linken Ecke der Form.
UpperLeftColumn integer Nein Spaltenindex der oberen linken Ecke der Form.
Width integer Nein Breite der Form (in Punkten).
Height integer Nein Höhe der Form (in Punkten).
RotationAngle integer Nein Drehwinkel in Grad.
IsHidden boolean Nein true, um die Form auszublenden.
IsLocked boolean Nein true, um die Form zu sperren.
Font object Nein Schriftarteinstellungen (siehe OpenAPI-Spezifikation für Untereigenschaften).
… … Nein Weitere Eigenschaften wie HtmlText, AlternativeText, ZOrderPosition, etc.

Für eine vollständige Liste verweisen Sie bitte auf die offizielle OpenAPI-Spezifikation: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

Anforderungsheader

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (das JWT-Token aus dem Authentifizierungsschritt)

Anforderungstext (Beispiel)

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

Beispiel mit cURL (Befehlszeilentool)

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

Antwort

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

Fehlerbehandlung – Die API kann folgende Statuscodes zurückgeben:

Code Bedeutung Typische Ursache
400 Bad Request Ungültiges JSON oder fehlende erforderliche Felder.
401 Unauthorized Fehlendes oder ungültiges JWT-Token.
404 Not Found Arbeitsmappe, Arbeitsblatt oder Formindex existiert nicht.
500 Internal Server Error Unerwartetes serverseitiges Problem.

Beispiel für Fehlerantworten

400 – Bad Request

{
  "Code": 400,
  "Message": "Ungültige Anforderungsnutzlast. Feld 'Name' überschreitet maximale Länge."
}

401 – Unauthorized

{
  "Code": 401,
  "Message": "Authentifizierung fehlgeschlagen. Ungültiges oder abgelaufenes JWT-Token."
}

404 – Not Found

{
  "Code": 404,
  "Message": "Die angegebene Arbeitsmappe, das Arbeitsblatt oder der Formindex wurde nicht gefunden."
}

500 – Internal Server Error

{
  "Code": 500,
  "Message": "Auf dem Server ist ein unerwarteter Fehler aufgetreten."
}

Cloud SDK-Familie

Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details, sodass Sie sich auf Ihre Projektanforderungen konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden:

Fügen Sie eine Form in ein Excel-Arbeitsblatt ein Alle Formen in einem Excel-Arbeitsblatt löschen