Excel Çalışma Sayfasında Bir Liste Objesini Güncelleme – Aspose.Cells Cloud API Dokümantasyonu
Bu REST API, bir Excel çalışma sayfasındaki liste nesnesini (tabloyu) günceller.
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulamaya ihtiyaç duyar.
İstek Gövdesi Şeması
listObject DTO’su aşağıdaki alanları içerir. İstek gövdesinde yalnızca değiştirmek istediğiniz alanların belirtilmesi gerekir.
| Alan | Tür | Gerekli | Açıklama |
|---|---|---|---|
| DisplayName | string | isteğe bağlı | Tablonun görünen adı. |
| StartRow / StartColumn | integer | isteğe bağlı | Tablonun ilk satırı/sütunu için sıfır tabanlı indeks. |
| EndRow / EndColumn | integer | isteğe bağlı | Tablonun son satırı/sütunu için sıfır tabanlı indeks. |
| Range | string | isteğe bağlı | Tablo aralığını tanımlayan A‑1 tarzı adres (örneğin, A1:D10). |
| ShowHeaderRow | boolean | isteğe bağlı | Başlık satırını göstermek için true. |
| ShowTotals | boolean | isteğe bağlı | Toplam satırını göstermek için true. |
| TableStyleName | string | isteğe bağlı | Uygulanacak yerleşik tablo stili adı. |
| TableStyleType | string | isteğe bağlı | Stil türü (TableStyleLight, TableStyleMedium, vb.). |
| ListColumns | object dizisi | isteğe bağlı | Sütun tanımlarının koleksiyonu (Name, TotalsCalculation). |
| Sorter, AutoFilter, ShowTableStyle… | object | isteğe bağlı | Gelişmiş stil ve filtreleme seçenekleri (OpenAPI spesifikasyonunda tam DTO’ya bakın). |
Minimal Örnek Yük
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
İstek Parametreleri
| Parametre Adı | Tür | Konum | Açıklama |
|---|---|---|---|
| name | string | path | Belge adı. |
| sheetName | string | path | Çalışma sayfası adı. |
| listObjectIndex | integer | path | Güncellenecek liste nesnesinin indeksi. |
| listObject | object | body | İstek gövdesindeki ListObject DTO’su. |
| folder | string | query | Belgeyi içeren klasör. |
| storageName | string | query | Depo adı. |
OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize izin verir.
İstek
Hata Yanıtları
| HTTP Kodu | Açıklama | Örnek Yük |
|---|---|---|
| 400 | Geçersiz istek – gerekli alanlar eksik veya bozuk JSON. | { "Code": 400, "Message": "Geçersiz istek gövdesi." } |
| 401 | Yetkisiz – JWT belirteci eksik veya geçersiz. | { "Code": 401, "Message": "Kimlik doğrulama başarısız." } |
| 404 | Bulunamadı – belirtilen çalışma kitapçası, çalışma sayfası veya liste nesnesi mevcut değil. | { "Code": 404, "Message": "Kaynak bulunamadı." } |
| 500 | Sunucu iç hatası – sunucu tarafında beklenmedik bir durum oluştu. | { "Code": 500, "Message": "Sunucu hatası." } |
SSS
Aspose.Cells Cloud API’yi kullanarak bir liste nesnesini nasıl güncellerim?
POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex} uç noktasını kullanın. Değiştirmek istediğiniz özellikleri içeren bir JSON gövdesi ekleyin (örneğin, DisplayName, ShowHeaderRow). Authorization başlığında JWT belirtecini kullanarak kimlik doğrulaması yapın.
Başarılı bir güncelleme sonrası ne tür bir yanıt alırım?
Code: 200 ve Status: "OK" içeren bir JSON nesnesi döndürülür. Hata oluşursa, yanıt uygun HTTP durum kodunu ve sorunu açıklayan bir Error nesnesini içerir.
Listenin nesne özelliklerinin yalnızca bir alt kümesini güncelleyebilir miyim?
Evet. İstek gövdesine yalnızca değiştirmek istediğiniz alanları ekleyin; atlanan tüm alanlar değişmeden kalır.
İlgili Dokümantasyon
Bulut SDK Ailesi
SDK kullanmak, geliştirme hızını en fazla artıracak yoldur. Bir SDK, düşük seviye detayları yöneterek size proje görevlerinize odaklanma imkânı sunar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.
Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanarak Aspose.Cells web hizmetlerini çağırma yöntemlerini göstermektedir: