Excel Çalışma Kitabından Adlandırılmış Aralıkları Alın – Aspose.Cells Cloud API

Bu REST API, çalışma sayfaları içinde tanımlanmış adlandırılmış aralıklarla ilgili bilgileri döndürür.

Arka Plan – Adlandırılmış aralık, bir çalışma sayfasında belirli bir hücreyi veya hücre bloğunu belirten kullanıcı tanımlı bir tanımlayıcıdır. Adlandırılmış aralıklar formül oluşturma işlemini basitleştirir, okunabilirliği artırır ve bir çalışma kitabında sık kullanılan bölgelere programlı erişimi sağlar.

Gereksinimler – Aspose.Cells Cloud API’ye erişmek için geçerli bir JWT erişim jetonuna ihtiyaç vardır. Bu jetonu, Aspose Cloud istemci kimliğinizi ve istemci gizli anahtarınızı kullanarak OAuth 2.0 jeton uç noktasından kimlik doğrulaması yaparak edinin. Her istekte bu jetonu Authorization: Bearer <jwt token> başlığına ekleyin.

GetNamedRanges API

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

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvendir ve JWT jeton tabanlı kimlik doğrulamaya ihtiyaç duyar.

İstek parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	Yol (Path)	Excel belgesinin adı.
folder	string	Sorgu dizesi	Belgenin bulunduğu klasör.
storageName	string	Sorgu dizesi	Belgenin bulunduğu depo adı.

HTTP Durum Kodları

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

OpenAPI Specification, web tarayıcınızdan doğrudan REST etkileşimlerinde bulunmanızı sağlayan herkese açık bir programlama arayüzü tanımlar.

Aspose.Cells web hizmetlerini çağırmak için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL kullanarak adlandırılmış aralıkları nasıl alacağınızı göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/ranges" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Yanıt

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Yanıt Modeli

Alan	Tür	Açıklama
`ColumnCount`	tamsayı	Aralıktaki sütun sayısı.
`ColumnWidth`	sayı	Her sütunun genişliği (nokta cinsinden).
`FirstColumn`	tamsayı	Aralıktaki ilk sütunun sıfır tabanlı indeksi.
`FirstRow`	tamsayı	Aralıktaki ilk satırın sıfır tabanlı indeksi.
`Name`	string	Aralığın kullanıcı tanımlı adı.
`RefersTo`	string	Hücre referansını tanımlayan formül (örneğin, `=Sheet1!$B$10:$H$10`).
`RowCount`	tamsayı	Aralıktaki satır sayısı.
`RowHeight`	sayı	Her satırın yüksekliği (nokta cinsinden).
`Worksheet`	string	Aralığı içeren çalışma sayfasının adı.

Bulut SDK Ailesi

Bu işlevselliği entegre etmenin en hızlı yolu, bir SDK kullanmaktır. SDK’lar düşük seviye detayları ele aldığı için iş mantığınıza odaklanabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposuna bakın.

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

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Adlandırılmış aralık temel alınarak hücre verilerini alın