Elektronik Tablo/Excel'de Renge Göre Topla, Say, Ortalama, En Yüksek ve En Düşük Değerleri Bul

Genel Bakış

API, hücre renklerine göre veri hesaplamaları gerçekleştirebilir. Excel elektronik tablosunda hücrelerin dolgu veya yazı tipi rengine göre toplama, sayma, ortalama ve aynı zamanda en yüksek ile en düşük değerleri bulabilir.

Hesaplama İşlemi Açıklama
Say (Count) Aynı renkteki hücre sayısını belirle.
Topla (Sum) Aynı renkteki hücrelerin toplam değerini hesapla.
En Yüksek Değer (Max) Aynı renkteki hücreler arasında en yüksek değeri bul.
En Düşük Değer (Min) Aynı renkteki hücreler arasında en düşük değeri bul.
Ortalama (Average) Aynı renkteki hücrelerin ortalama değerini hesapla.

Web API

PUT https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color

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
Spreadsheet Dosya FormData İşlenecek Excel çalışma kitabını belirtir.
Worksheet String Sorgu Aralığın bulunduğu çalışma sayfasının adı.
Range String Sorgu A‑1 stili aralık (örneğin A1:B10).
Operation String Sorgu Hesaplama yöntemi – Sum, Count, Average, Min, veya Max.
ColorPosition String Sorgu Değerlendirilecek rengi belirler – Background, Font.
Region String Sorgu Elektronik tablo bölgesi ayarı (örneğin us-east-1).
Password String Sorgu Korumalı bir çalışma kitabını açmak için şifre (isteğe bağlı).

Enumerasyonlar

  • ColorPosition
    Değer Anlam
    Background Hücrenin dolgu rengini kullan.
    Font Hücrenin yazı tipi rengini kullan.

Örnek multipart/form‑data isteği

curl -X PUT "https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color?Worksheet=Sheet1&Range=A1:B10&Operation=Sum&ColorPosition=Background" \
  -H "Authorization: Bearer <access_token>" \
  -F "Spreadsheet=@/path/to/workbook.xlsx"

Yanıt

Aşağıdaki şema, yanıt nesnesini tanımlar. Somut bir örnek şemanın hemen ardından verilmiştir.

{
  "Name": "AggregateResultByColorResponse",
  "Type": "Class",
  "ParentName": "CellsCloudResponse",
  "IsAbstract": false,
  "Properties": [
    {
      "Name": "AggregateResults",
      "DataType": {
        "Identifier": "Array",
        "Reference": "AggregateResultByColor",
        "ElementDataType": {
          "Reference": "AggregateResultByColor"
        }
      }
    },
    {
      "Name": "Code",
      "DataType": { "Identifier": "Integer" }
    },
    {
      "Name": "Status",
      "DataType": { "Identifier": "String" }
    }
  ]
}

Örnek yanıt (gerçek dünya değerleri)

{
  "Code": 200,
  "Status": "OK",
  "AggregateResults": [
    {
      "Color": "#FF0000",
      "Count": 12,
      "Sum": 345.67,
      "Average": 28.8,
      "Min": 5.0,
      "Max": 80.0
    },
    {
      "Color": "#00FF00",
      "Count": 7,
      "Sum": 210.0,
      "Average": 30.0,
      "Min": 10.0,
      "Max": 50.0
    }
  ]
}

HTTP Durum Kodları

Kod Anlam Açıklama
200 OK (Tamam) Filtre başarıyla uygulandı; yanıt işlem detayları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 (İstek Gövdesi Çok Büyük) Yüklenecek dosya boyut sınırını aşıyor.
500 Internal Server Error (İç Sunucu Hatası) Beklenmeyen sunucu hatası.

Renge Göre Toplu İşlem API’si Nerede Kullanılmalı?

Bir elektronik tabloda, farklı kategorilerden gelen veriler genellikle renk kodlanmıştır. Bu API sayesinde her renk grubu için toplama, sayma, ortalama veya en düşük ve en yüksek değerleri bulabilir, renk tabanlı veri analizini basitleştirebilirsiniz.

Renge Göre Toplu İşlem API’si Neden Kullanılmalı?

API, özel ayrıştırma mantığı yazmadan renk tabanlı hesaplamaları hızlı ve güvenilir bir şekilde gerçekleştirmenizi sağlar. Aspose.Cells Cloud SDK’larıyla sorunsuz entegre olur ve geliştiricilerin renk tabanlı toplama işlemlerini birkaç satır kodla yapmasını sağlar.

Renge Göre Toplu İşlem API’si Nasıl SDK’lar ile Kullanılır?

Renge Göre Toplu İşlem API Spesifikasyonu

Renge Göre Toplu İşlem API Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve web tarayıcınızdan doğrudan REST etkileşimlerini gerçekleştirmenizi sağlar.

Aspose.Cells Cloud SDK’larını Kullanın

SDK kullanmak, düşük seviye detayları soyutlayarak yalnızca birkaç satır kodla hücre rengine göre toplama işlemlerini yapmanızı sağlayan en hızlı geliştirme yoludur.
Tüm Aspose.Cells Cloud SDK listesi için lütfen GitHub deposuna göz atın.

Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanılarak Aspose.Cells web hizmetlerine nasıl istek yapıldığını göstermektedir:

Notlar:

  • Korumalı çalışma kitaplarıyla çalışırken, isteğin başarısız olup 401 hatası vermemesi için isteğe bağlı Password sorgu parametresini ekleyin.
  • Spreadsheet dosyası için maksimum istek boyutu 100 MB’tır. Daha büyük dosyaları işlemek gerekiyorsa, önce çalışma kitabını Aspose Cloud deposuna yükleyip Path parametresiyle referans almayı düşünün (burada gösterilmemiştir).