OLE-Objekt mit Aspose.Cells Cloud API zu einem Excel-Arbeitsblatt hinzufügen

Die Aspose.Cells Cloud API ermöglicht die programmatische Bearbeitung von Excel-Arbeitsmappen, einschließlich der Möglichkeit, OLE-Objekte (z. B. Word-Dokumente, PDFs oder andere Binärdateien) direkt in ein Arbeitsblatt einzubetten.

Diese REST API fügt ein OLE-Objekt zu einem Excel-Arbeitsblatt hinzu.

Voraussetzungen – Sie benötigen ein gültiges JWT-Authentifizierungstoken, und alle Quelldateien, die von oleFile oder imageFile referenziert werden, müssen vor dem Aufruf des Endpunkts in den angegebenen Speicherort hochgeladen werden.

PutWorksheetOleObject API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername Typ Ort Beschreibung
name string path Der Name der Arbeitsmappe.
sheetName string path Der Name des Arbeitsblatts.
oleObject object body Die Definition des OLE-Objekts.
upperLeftRow integer query Zeilenindex der oberen linken Ecke (Standardwert 0).
upperLeftColumn integer query Spaltenindex der oberen linken Ecke (Standardwert 0).
height integer query Höhe des OLE-Objekts (Standardwert 0).
width integer query Breite des OLE-Objekts (Standardwert 0).
oleFile string query Name der OLE-Quelldatei.
imageFile string query Name der Vorschaubilddatei.
folder string query Der Ordner, der die Arbeitsmappe enthält.
storageName string query Name des zu verwendenden Speichers.

Hinweise – upperLeftRow und upperLeftColumn verwenden eine nullbasierte Indizierung. Die Dateien oleFile (und optional imageFile) müssen bereits im Ziel Speicher vorhanden sein; andernfalls gibt die Anforderung einen Fehler zurück.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser durchzuführen.

Sie können das Kommandozeilentool cURL verwenden, um Aspose.Cells-Webservices aufzurufen. Das folgende Beispiel zeigt, wie Sie mit cURL ein OLE-Objekt hinzufügen. Für alle Produktionsaufrufe ist HTTPS erforderlich.

Screenshot eines in ein Excel-Arbeitsblatt eingebetteten OLE-Objekts

Mögliche HTTP-Statuscodes

Code Beschreibung
200 OLE-Objekt erfolgreich hinzugefügt.
400 Ungültige Anforderung – fehlende oder ungültige Parameter.
401 Nicht autorisiert – ungültiges oder fehlendes JWT-Token.
404 Nicht gefunden – Arbeitsmappe, Arbeitsblatt oder Quelldatei existiert nicht.
500 Interner Serverfehler – unerwarteter Fehler.

Eine typische erfolgreiche Antwort gibt die folgende JSON-Payload zurück:

{
  "Code": 200,
  "Status": "OK",
  "Data": {
    "OleObjectId": "12345",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Width": 400,
    "Height": 400,
    "SourceFullName": "Sample_Book2.xls",
    "ImageSourceFullName": "aspose-logo.png"
  }
}

Cloud SDK-Familie

Die Verwendung eines SDK beschleunigt die Entwicklung. Ein SDK abstrahiert Low-Level-Details, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mit verschiedenen SDKs aufgerufen werden:

OLE-Objekt aus Excel-Arbeitsblatt abrufen – Aspose.Cells Cloud API Ein OLE-Objekt in einer Excel-Arbeitsmappe aktualisieren