Adlandırılmış Aralık Temel alınarak Hücre Verilerini Alın – Aspose.Cells Cloud API

Ön Koşullar

  • Uygun kapsama alanına sahip geçerli bir JWT erişim belirteci.
  • Çalışma kitabının Aspose Cloud depolama alanına (veya belirtilen klasöre) yüklenmiş olması.
  • Varsayılan olmayan bir depo kullanıyorsanız hedef depo adının sağlandığından emin olun.

Bu REST API, bir adlandırılmış aralık veya satır-sütun indeksleri ile tanımlanan bir aralık içindeki hücrelerin listesini döndürür.

Bu işlem, geliştiricilerin bir Excel çalışma sayfasındaki belirli bir adlandırılmış aralığa ait hücre değerlerini programlı olarak almasını sağlar. namedRange tanımlayıcısı veya açık satır ve sütun indeksleri sağlanarak, API, hücre adresi, satır, sütun, değer, veri türü ve biçimlendirme bilgisi dahil olmak üzere detaylı bir hücre listesi döndürür. Yanıt, veri odaklı uygulamaları sürdürmek, raporlar oluşturmak veya sunucu tarafında daha fazla hesaplama yapmak için kullanılabilir. Aspose.Cells Cloud hizmeti, SDK’ları aracılığıyla birden fazla programlama dilini destekler, böylece geliştirme platformundan bağımsız olarak sorunsuz entegrasyon sağlar. HTTPS kullanımı, verilerin güvenli bir şekilde iletilmesini garanti eder ve API, REST prensiplerine uyar, başarı ve hata durumları için standart HTTP durum kodlarını döndürür.

REST API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

İstek parametreleri

Parametre Adı Tür Konum Açıklama
name string path Çalışma kitabının dosya adı.
sheetName string path Çalışma kitabındaki çalışma sayfasının adı.
namedRange string query Alınacak adlandırılmış aralık, örneğin A1:B2 veya range_name1.
firstRow integer query Aralığın ilk satırının sıfır tabanlı indeksi (namedRange sağlanmadığında kullanılır).
firstColumn integer query Aralığın ilk sütununun sıfır tabanlı indeksi (namedRange sağlanmadığında kullanılır).
rowCount integer query Aralığa dahil edilecek satır sayısı.
columnCount integer query Aralığa dahil edilecek sütun sayısı.
folder string query Çalışma kitabını içeren klasör.
storageName string query Çalışma kitabının bulunduğu bulut depo adı.

OpenAPI Specification, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından yapmanızı sağlar.

Aspose.Cells web hizmetlerini kolayca çağırmak için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, bir adlandırılmış aralıktan hücre değerlerini nasıl isteyeceğinizi göstermektedir.

Güvenlik Notu: API’yi çağırırken her zaman HTTPS kullanın. Hizmet düz HTTP’yi desteklemez; HTTPS kullanımı, isteğin şifrelendiğinden ve güvenlik en iyi uygulamalarına uygun olduğundan emin olunur.

HTTP Durum Kodları

Kod Anlamı Açıklama
200 OK (Tamam) Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400 Bad Request (Hatalı İstek) Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü).
401 Unauthorized (Yetkisiz) Geçersiz veya eksik JWT belirteci.
413 Payload Too Large (Çok Büyük Yük) Yüklenen dosya boyut sınırını aşıyor.
500 Internal Server Error (İç Sunucu Hatası) Beklenmeyen sunucu hatası.

Örnek hata yanıtı (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "'namedRange' parametresi eksik veya geçersiz."
}

İpucu: API, firstRow ve firstColumn için sıfır tabanlı indeksler kullanır. Örneğin, çalışma sayfasının ilk satırı 0dır.

Bulut SDK Ailesi

SDK kullanmak, geliştirmeyi hızlandırmanın en verimli yoludur. Bir SDK, düşük seviyeli ayrıntıları soyutlar ve iş mantığına odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposuna bakın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanarak Aspose.Cells web hizmetlerini nasıl çağıracağınızı göstermektedir:

Excel Çalışma Kitabından Adlandırılmış Aralıkları Alın