Sütunları Grupla – Aspise.Cells Bulut API Dokümantasyonu

Excel Çalışma Sayfasında Sütunları Gruplama

API sürümü: v3.0
İşlem: PostGroupWorksheetColumns – Çalışma sayfasındaki sütunları gruplar.

Genel Bakış

Bu REST API, bir çalışma sayfasındaki sütunların bir aralığını gruplamanızı sağlar. Gruplanan sütunlar gösterilebilir veya gizlenebilir; bu sayede Microsoft Excel’deki gibi daraltılabilir bölümler oluşturabilirsiniz.

Ön Gereksinimler

Aspose Cloud kimlik doğrulama hizmetinden alınmış geçerli bir JWT erişim belirteci.
Çalışma kitabının konumu, Aspose.Cells Cloud’un erişebilmesi gerekmektedir (varsayılan depo veya özel depo adı).
Gerekli SDK sürümü (SDK kullanılıyorsa): v3.0 API sürümünü destekleyen en son sürüm.

Kimlik Doğrulama

Tüm istekler Bearer token kimlik doğrulaması gerektirir.

Authorization: Bearer <access_token>

Belirteç almayle ilgili ayrıntılar için JWT kimlik doğrulama kılavuzuna bakınız.

HTTP İsteği

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group

Parametre	Konum	Gerekli	Açıklama
`name`	Yol	Evet	Çalışma kitabı dosya adı (örneğin, `test.xlsx`).
`sheetName`	Yol	Evet	Gruplandırılacak sütunları içeren çalışma sayfası.
`firstIndex`	Sorgu	Evet	Gruba dahil edilecek ilk sütunun sıfır tabanlı dizini.
`lastIndex`	Sorgu	Evet	Gruba dahil edilecek son sütunun sıfır tabanlı dizini.
`hide`	Sorgu	Hayır	`true` ise gruplanan sütunlar gizlenir; aksi takdirde görünür kalırlar.
`folder`	Sorgu	Hayır	Çalışma kitabının bulunduğu klasörün yolu.
`storageName`	Sorgu	Hayır	Dosyanın bulunduğu depolama hizmetinin adı.

İstek Örneği (cURL)

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Not: İstek, şifreli iletişimi sağlamak için HTTPS kullanır.

Yanıt

Başarılı (200)

Alan	Tür	Açıklama
`Code`	tamsayı	HTTP durum kodu (`200`).
`Status`	dize	İşlemin metinsel durumu (`OK`).

Örnek

{
  "Code": 200,
  "Status": "OK"
}

Hata (örneğin, 400 Bad Request)

Alan	Tür	Açıklama
`Code`	tamsayı	HTTP durum kodu (`400`, `401`, `404`, `500`, …).
`Status`	dize	Metinsel durum (`Error`).
`ErrorMessage`	dize	Sorunun insan tarafından okunabilir açıklaması.
`ErrorCode`	dize	Hataya ait programatik tanımlayıcı.

Örnek – Geçersiz İstek

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Geçersiz sütun dizini.",
  "ErrorCode": "InvalidParameter"
}

SDK Örnekleri

Aşağıdaki kod parçacıkları, desteklenen SDK’lar kullanılarak Çalışma Sayfası Sütunlarını Gruplama işleminin nasıl çağrılacağını göstermektedir.

Notlar

Gruplama davranışı: API, Excel’de genişletilebilir veya daraltılabilir bir sütun grubu oluşturur. hide=true ayarı, grubu hemen daraltır.
Sıfır tabanlı dizinleme: firstIndex ve lastIndex parametreleri 0 değerinden başlar; bir çalışma sayfasındaki ilk sütunun dizini 0’dır.
Depolama dikkatleri: Çalışma kitabı varsayılan depolama dışındaki bir yerde bulunuyorsa, hem folder hem de storageName sorgu parametrelerini belirtmelisiniz.

Ayrıca Bakınız

Ekran Görüntüsü: {: .img-fluid alt=“Excel çalışma sayfasında gruplanmış sütunları gösteren ekran görüntüsü” }

Yukarıdaki yer tutucu görüntü, sütun gruplamanın görsel sonucunu gösteren gerçek bir ekran görüntüsü ile değiştirilmelidir.

Sütun Detaylarını Al – Aspose.Cells Cloud API Referansı (v4.0)