Aspose.Cells Cloud API ile Excel Çalışma Sayfasına OLE Nesnesi Ekleme
Aspose.Cells Cloud API, Excel çalışma kitaplıklarının programlı olarak manipulate edilmesini sağlar; bu, OLE nesnelerini (örneğin Word belgeleri, PDF’ler veya diğer ikili dosyalar) doğrudan bir çalışma sayfasına gömme yeteneğini de içerir.
Bu REST API, bir Excel çalışma sayfasına bir OLE nesnesi ekler.
Önkoşullar – Geçerli bir JWT kimlik doğrulama belirteciniz olmalıdır ve oleFile veya imageFile tarafından başvurulan kaynak dosyalar, uç noktayı çağırmadan önce belirtilen depolama konumuna yüklenmiş olmalıdır.
PutWorksheetOleObject API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.
İstek parametreleri
| Parametre Adı | Tür | Konum | Açıklama |
|---|---|---|---|
| name | string | path | Çalışma kitabı dosya adı. |
| sheetName | string | path | Çalışma sayfası adı. |
| oleObject | object | body | OLE nesnesi tanımı. |
| upperLeftRow | integer | query | Üst sol köşenin satır indeksi (varsayılan 0). |
| upperLeftColumn | integer | query | Üst sol köşenin sütun indeksi (varsayılan 0). |
| height | integer | query | OLE nesnesinin yüksekliği (varsayılan 0). |
| width | integer | query | OLE nesnesinin genişliği (varsayılan 0). |
| oleFile | string | query | OLE kaynak dosyasının adı. |
| imageFile | string | query | Önizleme resim dosyasının adı. |
| folder | string | query | Çalışma kitabını içeren klasör. |
| storageName | string | query | Kullanılacak depolama adı. |
Notlar – upperLeftRow ve upperLeftColumn sıfır tabanlı indeksleme kullanır. oleFile (ve isteğe bağlı olarak imageFile) hedef depolamada zaten mevcut olmalıdır; aksi takdirde istek bir hata döndürür.
OpenAPI Specification, herkese açık bir programlama arayüzü tanımlar ve web tarayıcınızdan doğrudan REST etkileşimlerinde bulunmanıza olanak tanır.
Aspose.Cells web servislerini çağırmak için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile bir OLE nesnesi eklemeyi nasıl yapacağınızı göstermektedir. Tüm üretim çağrılarında HTTPS gereklidir.
Olası HTTP durum kodları
| Kod | Açıklama |
|---|---|
| 200 | OLE nesnesi başarıyla eklendi. |
| 400 | Geçersiz istek – eksik veya geçersiz parametreler. |
| 401 | Yetkisiz – geçersiz veya eksik JWT belirteci. |
| 404 | Bulunamadı – çalışma kitabı, çalışma sayfası veya kaynak dosya mevcut değil. |
| 500 | Sunucu iç hatası – beklenmedik bir hata oluştu. |
Tipik bir başarılı yanıt aşağıdaki JSON yükünü döndürür:
{
"Code": 200,
"Status": "OK",
"Data": {
"OleObjectId": "12345",
"UpperLeftRow": 15,
"UpperLeftColumn": 5,
"Width": 400,
"Height": 400,
"SourceFullName": "Sample_Book2.xls",
"ImageSourceFullName": "aspose-logo.png"
}
}
Bulut SDK Ailesi
SDK kullanmak geliştirme sürecini hızlandırır. Bir SDK, düşük seviye detayları soyutlayarak iş mantığınıza odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposuna bakın.
Aşağıdaki kod örnekleri, Aspose.Cells web servislerini çeşitli SDK’lar kullanarak nasıl çağıracaklarınızı göstermektedir: