Documentation – Pivot Tablo Ekle

Nodejscpp: Pivot Tablosunu Biçimlendirme

Mon, 01 Jan 0001 00:00:00 +0000

Döndürme Tablosu Görünümü

Bir Pivot Tablosu Nasıl Oluşturulur, basit bir pivot tablosu nasıl oluşturulurun açıklanmasının yanı sıra bu makale, çeşitli özellikleri ayarlayarak bir pivot tablosunun görünümünü özelleştirmeyi açıklar:

Pivot tablo format seçenekleri
Pivot alanları format seçenekleri
Veri alanı format seçenekleri

Pivot Tablo Format Seçeneklerini Ayarlama

Toplam Otomatik Biçim Türünü Ayarlama

Otomatik Biçim Türünün Ayarlanması

Microsoft Excel çeşitli önceden ayarlanmış rapor formatları sunar. Aspose.Cells for Node.js via C++ bu biçimlendirme seçeneklerini de destekler. Bu seçeneklere erişmek için:

PivotTable.setIsAutoFormat(value) değerini true olarak ayarlayın.
PivotTableAutoFormatType numaralandırmasından bir biçimlendirme seçeneği atayın.

Biçim Seçeneklerini Ayarlama

Aşağıdaki kod örneği, pivot tablosunu satır ve sütunlar için toplamları göstermek üzere biçimlendirme ve raporun alan sırasını ayarlamayı gösterir. Ayrıca, null değerler için özel bir dize ayarlamak da gösterilir.

Önceden belirlenmiş rapor biçimleri yerine, pivot tablo raporunun nasıl görüneceğini manuel olarak düzenlemek için PivotTable.formatAll(style) ve PivotTable.format(row, column, style) yöntemlerini kullanın. İstenen biçimlendirme için bir stil nesnesi oluşturun.

Pivot Alanı Biçim Seçeneklerini Ayarlama

Satır alanlarına erişim.
Alt toplamları ayarlama.
Otomatik sıralamayı ayarlama.
Otomatik gösterimi ayarlama.

Satır/Sütun/Sayfa Alan Biçimini Nasıl Ayarlanır

Veri alanı biçimini nasıl ayarlanır

Aşağıdaki kod örneği, veri alanları için görüntü biçimlerini ve sayı biçimini ayarlamayı göstermektedir.

Pivot Alanlarını Temizleme Yöntemi

PivotFieldCollection, örneğin sayfa, sütun, satır veya veri gibi tüm pivot alanlarını temizlemenize izin veren clear() adında bir yönteme sahiptir. Örneğin, tüm veri alanlarını temizlemek istediğinizde, bunu kullanın. Aşağıdaki kod örneği, bir veri alanındaki tüm pivot alanlarını temizlemeyi göstermektedir.

Nodejscpp: Özet Tabloları ve Özet Grafikler Oluşturma

Mon, 01 Jan 0001 00:00:00 +0000

Bir özet tablo, kayıtların etkileşimli bir özeti. Örneğin, bir çalışma sayfasındaki bir listede yüzlerce fatura girişiniz olabilir. Bir özet tablo, faturaları müşteri, ürün veya tarihe göre toplayabilir. Microsoft Excel ile özet tablonun düğmeleri sürüklenerek bilgileri hızlı bir şekilde yeniden düzenlemek mümkündür.

Bir özet grafik, bir özet tablonun verilerinin etkileşimli grafiksel bir temsilidir. Özet grafikler Excel 2000’de tanıtılmıştır. Özet grafik kullanmak, özet tablonun alt toplamlarını ve toplamlarını otomatik olarak oluşturduğu için verileri anlamak daha da kolaylaştırır.

Aspose.Cells for Node.js via C++, pivot tablolar ve pivot grafikler destekler.

Aspose.Cells for Node.js via C++ Kullanarak Pivot Tablo ve Grafikler Ekleme

Aspose.Cells for Node.js via C++, pivot tablolar oluşturmak için kullanılan özel sınıf setleri sağlar. Bu sınıflar, PivotTablo nesneleri oluşturmak ve ayarlamak için kullanılır, bunlar ise temel yapıtaşlarıdır:

PivotField, bir özet tablo raporundaki bir alan.
PivotFields, bir özet tablodaki tüm PivotField nesnelerinin koleksiyonu.
PivotTable, bir çalışma sayfasındaki bir PivotTable raporu.
PivotTables, çalışma sayfasındaki tüm PivotTable nesnelerinin koleksiyonu.

Aspose.Cells for Node.js via C++ kullanmak için Hazırlık

NPM’den Aspose.Cells for Node.js via C++ kurun, komut şöyle kullanılır: $ npm install aspose.cells.node.
Ayrıca, “Aspose.Cells for Node.js via C++” kurulumuyla ilgili adım adım talimatları takip edebilirsiniz.

Aspose.Cells for Node.js via C++ Kullanarak Pivot Tablo Ekleme Yöntemi

Aspose.Cells for Node.js via C++ kullanarak pivot tablo oluşturmak için:

Hücre nesnesinin put_value methodunu kullanarak bir çalışma sayfasına veri ekleyin. Ayrıca veri ile doldurulmuş bir şablon dosyası da kullanabilirsiniz. Veri, pivot tablosunun veri kaynağı olarak kullanılacaktır.
PivotTables koleksiyonunun add yöntemini (Worksheet nesnesinde kapsüllenmiş) çağırarak çalışma sayfasına bir pivot tablosu ekleyin.
Yeni PivotTable nesnesine PivotTables koleksiyonundan endeksini geçerek erişin. # PivotTable nesnesinde kapsanan herhangi bir pivot tablo nesnesini kullanarak tabloyu yönetin.

Kod örnekleri aşağıda verilmiştir.

Aspose.Cells for Node.js via C++ Kullanarak Pivot Grafik Ekleme Yöntemi

Aspose.Cells for Node.js via C++ kullanarak PivotChart oluşturmak için:

Bir grafik ekleyin.
Grafik PivotSource’unu elektronik tabloda zaten mevcut bir pivot çizelgesine atıf yapacak şekilde ayarlayın.
Diğer özellikleri ayarlayın.

Nodejscpp: Pivot Tablosu ve Kaynak Veri

Mon, 01 Jan 0001 00:00:00 +0000

Pivot Tablosunun Kaynak Verisi

Farklı veri kaynaklarından (örneğin bir veritabanı) alınan verileri alan ve tasarım zamanında bilinmeyen pivota tabloları olan Microsoft Excel raporları oluşturmak istediğinizde bazı durumlar olabilir. Bu makale, bir pivot tablosunun veri kaynağını dinamik olarak değiştirmenin bir yaklaşımını sunar.

Bir Pivot Tablosunun Veri Kaynağını Değiştirme

Yeni bir tasarımcı şablonu oluşturma.
1. Aşağıdaki ekran görüntüsünde olduğu gibi yeni bir tasarımcı şablonu dosyası oluşturun.
2. Ardından bu hücre aralığına atıfta bulunan DataSource adlı bir adlandırılmış aralık tanımlayın.
  
  Bir tasarımcı şablon oluşturma ve DataSource adlı adlandırılmış aralık tanımlama

Bu adlandırılmış aralığa dayalı bir Özet Tablo Oluşturma.
1. Microsoft Excel’de Veri‘yi seçin, ardından Özet Tablo ve Özet Tablo Grafik Raporu’nu seçin.
2. İlk adımda oluşturulan adlandırılmış aralığa dayalı bir özet tablo oluşturun.
  
  DataSource adlı adlandırılmış aralığa dayalı bir özet tablo oluşturma

İlgili alanı özet tablo satır ve sütununa sürükleyin, ardından aşağıdaki ekran görüntüsünde olduğu gibi sonuç özet tablosunu oluşturun.

İlgili alana dayalı bir özet tablo oluşturmak

Özet tabloyu sağ tıklayın ve Tablo Seçenekleri‘ni seçin.
1. Veri seçenekleri ayarlarında Açılışta yenile‘yi işaretleyin.
  
  Özet tablo seçeneklerini ayarlama

Şimdi bu dosyayı tasarımcı şablon dosyanız olarak kaydedebilirsiniz.

Yeni veri eklenmesi ve özet tablonun kaynak verisinin değiştirilmesi.
1. Tasarımcı şablon oluşturulduktan sonra, özet tablonun kaynak verisini değiştirmek için aşağıdaki kodu kullanın.

Aşağıdaki örnek kodu çalıştırarak pivot tablosunun kaynak verisini değiştirin.

Nodejscpp: Pivot Tablosunda Hesaplanmış Alan Ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Olası Kullanım Senaryoları

Bilgisine sahip olduğunuz verilere dayalı olarak bir pivot tablosu oluşturduğunuzda, içindeki verilerin istediğiniz gibi olmadığını fark edersiniz. İstediğiniz veri, bu orijinal verilerin bir kombinasyonudur. Örneğin, veriden önce verilerin çıkarılması, çarpılması ve bölünmesi gerekebilir. Bu durumda, bir hesaplanmış alan oluşturmanız ve hesaplama için ilgili formülü ayarlamanız gerekir. Daha sonra hesaplanmış alanda bazı istatistikler ve diğer işlemleri gerçekleştirin.

Excel’de Pivot Tablosuna Hesaplanmış Alan Eklemek

Excel’de bir PivotTable’a hesaplanmış bir alan eklemek için şu adımları izleyin:

Bir hesaplanmış alan eklemek istediğiniz PivotTable’ı seçin.
Kuruluş sekmesine gidin ve üzerinde PivotTable Analizi olan sekmeyi seçin.
“Alanlar, Öğeler ve Kümeler” üzerine tıklayın ve ardından açılır menüden “Hesaplanmış Alan"ı seçin.
“Ad” alanına hesaplanmış alan için bir ad girin.
“Formül” alanına, kullanmak istediğiniz PivotTable alan adları ve matematiksel operatörleri kullanarak gerçekleştirmek istediğiniz hesaplama için formülü girin.
Hesaplanmış alan oluşturmak için “tamam"a tıklayın.
Yeni hesaplanmış alan, Değerler bölümü altında PivotTable Alan Listesinde görünecektir.
Hesaplanmış alanı PivotTable’ın Değerler bölümüne sürükleyerek hesaplanmış değerleri görüntüleyin.

Aspose.Cells for Node.js via C++ Kütüphanesi kullanarak Pivot Tablosuna Hesaplanmış Alan Nasıl Eklenir

Aspose.Cells for Node.js via C++ kullanarak Excel dosyasına hesaplanmış alan ekleyin. Aşağıdaki örnek kodu inceleyin. Örnek kod çalıştırıldıktan sonra, hesaplanmış alan içeren bir pivot tablo çalışma sayfasına eklenir.

Orijinal verileri ayarlayın ve bir pivot tablosu oluşturun.
Mevcut PivotField’a göre hesaplanmış alanı oluşturun.
Hesaplanmış alanı veri alanına ekleyin.
Son olarak, çalışma kitabını çıktı XLSX formatında kaydeder.

Örnek Kod

Nodejscpp: Aspose.Cells for Node.js via C++'da Özet Tabloları Yenileme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, tüm çalışma kitabından tek bir özet tablosuna kadar dört farklı kapsamda pivot verilerini yeniden yüklemenize olanak tanıyan katmanlı bir yenileme API’si sunar. Aspose.Cells for Node.js via C++ v26.7 ile başlayarak, eski PivotTable.RefreshData() yöntemi kullanımdan kaldırılmış olarak işaretlenmiş olup bu makalede açıklanan daha verimli, önbellek farkındalığına sahip API’lerle değiştirilmelidir.

Giriş

Bir özet tablosunu yenileme nadiren tek bir işlemdir. Sahne arkasında Aspose.Cells, orijinal kaynak verilerinizi çalışma sayfasında gördüğünüz işlenmiş değerlere bağlayan katmanlı bir veri zinciri tutar. Bu zinciri anlamak, her durum için doğru yenileme API’sini seçmenin anahtarıdır. Dört katmanlı veri zinciri şudur:

Veri Kaynağı — ham değerlerin bulunduğu orijinal çalışma sayfası aralıkları, veritabanı sorgusu veya konsolidasyon aralığı.
PivotCache — kaynak verinin bellek içi anlık görüntüsü. Her özet tablosu bir PivotCache üzerine kuruludur; tüm verilerin toplandığı ve toplulaştırıldığı yer burasıdır.
PivotTable — satır, sütun, değer ve filtre alanlarını tanımlayan görünüm nesnesi. Bir PivotTable, yalnızca kendi PivotCache‘inden okur, doğrudan veri kaynağından asla.
Cells — PivotTable‘ın hesaplanan değerlerini ve stillerini işlediği çalışma sayfası Cells koleksiyonu. Özellikle önemli bir kavram paylaşılan önbellektir. Çalışma kitabındaki birden çok özet tablosu aynı kaynak aralığına başvurduğunda, tek bir PivotCache örneğini paylaşırlar. Tek bir PivotCache‘e birçok özet tablosu başvurabilir ve bu önbelleği yenilemek, ona bağlı olan her PivotTable‘ı aynı anda yeniler.
PivotCache.SourceType (enum PivotTableSourceType), önbellek verilerinin nereden geldiğini belirtir. v26.7 itibarıyla, PivotCache.Refresh() yalnızca Sheet ve Consolidation kaynak türlerini desteklemektedir; yani çalışma sayfası aralıklarında bulunan verileri. Harici kaynaklar (veritabanları, harici bağlantılar vb.) henüz önbellek API’si aracılığıyla yenilenememektedir.
Bu zincir nedeniyle, Aspose.Cells’te iki temel yenileme yolu vardır:

PivotCache.Refresh() — kaynak → önbellek verilerini yeniden yükler VE tüm bağımlı PivotTable‘ları tek bir işlemde yeniden hesaplar.
PivotTable.CalculateData() — zaten önbelleğe alınmış verilerden tek bir PivotTable‘ın görünümünü yeniden hesaplar; veri kaynağına geri dönüş yapmaz. Bu makaledeki tüm senaryolarda çalışma sayfası hücre kaynak verileri kullanılmaktadır, dolayısıyla kaynak türü Sheet‘tir ve yenileme işlemleri açıklandığı şekilde davranır.

Gerekli İçe Aktarmalar

Bu makaledeki tüm JavaScript örnekleri, Aspose.Cells for Node.js via C++ modülünün yüklendiğini ve pivot türlerinin Aspose.Cells.Pivot ad alanında bulunduğunu varsayar. Tipik bir kurulum şudur:

const AsposeCells = require("aspose.cells.node");
const { PivotFieldType } = AsposeCells; (veya AsposeCells.Pivot.PivotFieldType üzerinden erişim)

Çalışma Kitabındaki Tüm Özet Tablolarını Yenileme

Çalışma kitabındaki her pivot önbelleğinin ve her özet tablosunun en son kaynak verileri yansıtmasını sağlamanız gerektiğinde, en basit ve en kapsamlı API Workbook.RefreshAll() yöntemidir. Tek bir çağrı tüm çalışma kitabını dolaşır; her PivotCache‘i kaynağından yeniler ve ardından ona bağlı her PivotTable‘ı yeniden hesaplar. Bu, performansın kritik olmadığı genel, tam belge yenilemeleri için önerilen yaklaşımdır. Aşağıdaki örnek bir Fruit/Year/Amount kaynak aralığına sahip bir çalışma kitabı oluşturur, bir özet tablosu ekler, bazı kaynak değerleri değiştirir ve ardından her şeyi tek bir çağrıyla güncellemek için RefreshAll() yöntemini kullanır.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// A1:C1 hücrelerine başlık satırını yaz
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// A2:C9 hücrelerine veri satırlarını yaz (2020 ve 2021 yılları arasında 8 satır meyve verisi)
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(50);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(60);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(70);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(80);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(90);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(100);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(110);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(120);

// Bir pivot tablo ekle: kaynak aralık "A1:C9", hedef hücre "E3", ad "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Pivot alanlarını ata: Fruit Satırlar'a, Year Sütunlar'a, Amount Veri'ye
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Değişiklikleri simüle etmek için kaynak verideki birkaç Amount değerini değiştir
worksheet.getCells().get("C2").putValue(55);
worksheet.getCells().get("C5").putValue(85);
worksheet.getCells().get("C9").putValue(125);

// Çalışma kitabındaki her pivot tablosunu / pivot önbelleğini yenile
workbook.refreshAll();

// Çalışma kitabını kaydet
workbook.save("output.xlsx");

Tek Bir Çalışma Sayfasındaki Tüm Özet Tablolarını Yenileme

Bazen yalnızca belirli bir çalışma sayfasında bulunan özet tablolarını yenilemeniz gerekebilir; örneğin, diğer çalışma sayfalarındaki özet tablolarının ilgisiz olduğu biliniyorsa ve bunlara dokunulmamalıdır. Bu durum için Aspose.Cells, tek bir Worksheet örneğiyle sınırlı olan Worksheet.RefreshPivotTables() yöntemini sağlar. Bu, Workbook.RefreshAll() yönteminden daha seçicidir: yalnızca hedeflenen çalışma sayfasındaki özet tabloları yenilenir, diğer çalışma sayfalarındaki özet tablolarına dokunulmaz. Aşağıdaki örnek aynı Fruit/Year/Amount kaynak verilerini doldurur, ilk çalışma sayfasına bir özet tablosu ekler, bazı kaynak değerleri değiştirir ve ardından yalnızca o çalışma sayfasındaki özet tablolarını yeniler.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2021);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2021);
worksheet.getCells().get("C5").putValue(120);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(180);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2020);
worksheet.getCells().get("C7").putValue(130);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(220);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2020);
worksheet.getCells().get("C9").putValue(140);

let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

worksheet.getCells().get("C2").putValue(300);
worksheet.getCells().get("C5").putValue(250);
worksheet.getCells().get("C9").putValue(400);

worksheet.refreshPivotTables();

workbook.save("output.xlsx");

Tek Bir Özet Tablosunu Yenileme

Tek bir özet tablosu üzerinde ayrıntılı kontrol istediğinizde, önbellek tabanlı API size iki seçenek sunar. Aralarındaki seçim, gerçekte neyin değiştiğine bağlıdır: temel kaynak veriler mi, yoksa yalnızca özet tablosunun kendi görünüm/düzen ayarları mı.

Kaynak Veri Değişti — `PivotCache.Refresh()` Kullanın

Temel kaynak veriler değiştiyse, doğru giriş noktası pivotTable.PivotCache.Refresh() yöntemidir. Bu çağrı, kaynak verileri önbelleğe yeniden okur ve ardından o önbelleğe bağlı olan her PivotTable‘ı yeniden hesaplar.

Özet tabloları tek bir PivotCache örneğini paylaştığından, PivotCache.Refresh() çağrısı yalnızca başvurduğunuz özet tablosunu değil, o önbelleğin üzerine kurulmuş tüm özet tablolarını yeniden hesaplar. İki özet tablosu aynı kaynak aralığını paylaşıyorsa, bir önbelleği yenilemek her ikisini de yeniler.

Aşağıdaki örnek, bu paylaşılan önbellek davranışını göstermek için aynı kaynak aralığında iki özet tablosu oluşturur, bazı kaynak değerleri değiştirir ve ardından tek bir önbellek başvurusu üzerinden yenileme yapar.

const AsposeCells = require("aspose.cells");

// Yeni bir çalışma kitabı oluştur ve ilk çalışma sayfasına eriş
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);

// Başlık satırını yaz: Meyve / Yıl / Miktar
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// Yaklaşık 9 veri satırı yaz (üzüm / yaban mersini / kivi / kiraz, 2020-2021 arası)
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

// E3 hücresine sabitlenmiş ilk pivot tablosu "Pivot1" ekle, kaynak aralığı A1:C9
const pivotIndex1 = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable1 = worksheet.getPivotTables().get(pivotIndex1);

// Pivot1 için alanları ata
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// E15'e sabitlenmiş ve AYNI kaynak aralığı A1:C9'u kullanan İKİNCİ bir pivot tablosu "Pivot2" ekle
// Hem Pivot1 hem Pivot2, kaynak aralığı aynı olduğu için tek bir PivotCache'i paylaşır.
const pivotIndex2 = worksheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
const pivotTable2 = worksheet.getPivotTables().get(pivotIndex2);

// Pivot2 için aynı alanları ata
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Veri değişikliğini simüle etmek için kaynak verideki birkaç Miktar hücre değerini değiştir
worksheet.getCells().get("C2").putValue(150);
worksheet.getCells().get("C4").putValue(350);
worksheet.getCells().get("C7").putValue(650);

// Paylaşılan PivotCache'i yenile.
// Pivot1 ve Pivot2 aynı PivotCache'i paylaştığı için, bu tek çağrı
// güncellenmiş kaynaktan HER İKİ pivot tablosunu da (veri + stil) yeniler.
pivotTable1.getPivotCache().refresh();

// Çalışma kitabını kaydet
workbook.save("output.xlsx");

Yalnızca Görünüm/Düzen Değişti — `CalculateData()` Kullanın

Kaynak veri değişmediyse ancak yalnızca özet tablosunun görünüm veya düzen ayarları değiştirildiyse (örneğin, bir alan farklı bir bölgeye taşındıysa veya açılışta yenileme ayarı değiştirildiyse), veri kaynağına geri dönmek gerekmez. Önbellek zaten doğru verileri tutuyor; yalnızca işlenmiş PivotTable‘ın yeniden hesaplanması gerekiyor. Bu durumda, pivotTable.CalculateData() doğru seçimdir. Bu, gereksiz kaynak getirme işleminden kaçınır ve birçok özet tablosu aynı önbelleği paylaştığında önemli ölçüde daha hızlıdır. Aşağıdaki örnek, özet tablosunun kaynak olmayan bir özelliğini değiştirir ve ardından mevcut önbellekten yeniden işlemek için CalculateData() yöntemini çağırır.

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);

// Meyve / Yıl / Miktar başlık satırını yaz
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 8 veri satırı yaz (2-9 arası satırlar, A1:C9 kaynak aralığına uygun)
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(150);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(250);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(350);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(450);

// Hedef hücre E3'e yerleştirilen, A1:C9'dan kaynaklanan "Pivot1" adlı bir özet tablo ekleyin
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Alanları ata: Satır için Meyve, Sütun için Yıl, Veri için Miktar
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

// Bir görünüm/düzen özelliğini değiştir — bu yalnızca sunum amaçlı bir değişikliktir,
// bu nedenle PivotCache.Refresh() aracılığıyla kaynak verilerin yeniden okunmasını GEREKTIRMEZ.
pivotTable.setRefreshDataOnOpeningFile(false);

// CalculateData(), BU özet tablosunun görüntüsünü (veri + stil) şuradan yeniden oluşturur:
// PivotCache'te zaten tutulan veri. Kaynak veri değişmediği için,
// kaynağa gidiş-dönüş yapılmaz — yalnızca önbelleğe alınmış değerler yeniden hesaplanır
// çalışma sayfası hücrelerine.
pivotTable.calculateData();

// Çalışma kitabını diske kaydet
workbook.save("output.xlsx");

Aynı PivotCache’i Paylaşan Tüm Özet Tablolarını Alma

Bir çalışma kitabı genellikle tek bir paylaşılan önbelleğin üzerine kurulmuş birçok özet tablosu içerir. Bunları numaralandırmak için — örneğin, toplu yenileme yapmadan önce veya paylaşılan önbellek etkisini teşhis etmek için — PivotCache.GetPivotTables() yöntemini kullanın. Bu yöntem, verilen önbelleğe bağlı olan her PivotTable‘ın koleksiyonunu döndürür. Bu, aynı zamanda iki özet tablosunun gerçekten aynı PivotCache örneğini paylaştığını doğrulamanın en doğrudan yoludur: önbellek başvurularını karşılaştırabilir veya GetPivotTables() tarafından döndürülen koleksiyonu yineleyip hangi özet tablolarının onda göründüğünü gözlemleyebilirsiniz. Aşağıdaki örnek, aynı kaynak aralığında iki özet tablosu oluşturur, aynı önbellek örneğini paylaştıklarını doğrular ve ardından önbelleğin özet tablolarını numaralandırır.

Kullanımdan Kaldırılan `PivotTable.RefreshData()` Yönteminden Geçiş

Aspose.Cells for Node.js via C++ v26.7’den önce, bir özet tablosunu yenilemenin standart yolu her özet tablosunda ayrı ayrı PivotTable.RefreshData() çağırmaktı. v26.7 itibarıyla bu yöntem kullanımdan kaldırılmış olarak işaretlenmiş olup yukarıda açıklanan önbellek farkındalığına sahip API’lerle değiştirilmelidir. Gerçek dünya çalışma kitaplarında tablo başına RefreshData() yaklaşımının sorunlu olmasının iki nedeni vardır:

Kaynaktan verileri her çağrıldığında, kaynak değişmemiş olsa bile yeniden getirir.
Her çağrı tüm paylaşılan önbelleği yeniler. Birçok özet tablosu tek bir önbelleği paylaştığında, özet tablosu başına tekrar tekrar RefreshData() çağırmak aynı önbelleğin sürekli olarak yeniden getirilmesine neden olur ve bu çok yavaştır. Önerilen değiştirmeler şunlardır:
Çalışma kitabındaki TÜM özet tablolarını yenileme → workbook.refreshAll(); kullanın
Bazılarını yenileme → tek bir önbellek için pivotTable.PivotCache.Refresh(); kullanın. Önbellek paylaşıldığından, bu tek çağrı o önbelleğin üzerine kurulmuş her özet tablosunu günceller. Zaten yenilenmiş bir önbelleğin üzerine kurulmuş diğer özet tabloları güvenle atlanabilir.
Yalnızca pivot görünümü/düzeni değişti → kaynaktan herhangi bir dönüş olmadan mevcut önbellekten yeniden işlemek için pivotTable.CalculateData(); kullanın. Aşağıdaki örnek, tek bir önbelleği paylaşan birden çok özet tablosuna sahip çalışma kitapları için yeni verimli kalıbı göstermektedir.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// --- Kaynak veriyi oluştur: Meyve / Yıl / Tutar (başlık + 9 satır) ---
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

sheet.getCells().get("A2").putValue("Grape");      sheet.getCells().get("B2").putValue(2020); sheet.getCells().get("C2").putValue(1000);
sheet.getCells().get("A3").putValue("Blueberry");  sheet.getCells().get("B3").putValue(2020); sheet.getCells().get("C3").putValue(2000);
sheet.getCells().get("A4").putValue("Kiwi");       sheet.getCells().get("B4").putValue(2020); sheet.getCells().get("C4").putValue(1500);
sheet.getCells().get("A5").putValue("Cherry");     sheet.getCells().get("B5").putValue(2020); sheet.getCells().get("C5").putValue(2500);
sheet.getCells().get("A6").putValue("Grape");      sheet.getCells().get("B6").putValue(2021); sheet.getCells().get("C6").putValue(3000);
sheet.getCells().get("A7").putValue("Blueberry");  sheet.getCells().get("B7").putValue(2021); sheet.getCells().get("C7").putValue(1800);
sheet.getCells().get("A8").putValue("Kiwi");       sheet.getCells().get("B8").putValue(2021); sheet.getCells().get("C8").putValue(2200);
sheet.getCells().get("A9").putValue("Cherry");     sheet.getCells().get("B9").putValue(2021); sheet.getCells().get("C9").putValue(2700);

// --- Hedef hücre E3'e ilk pivot tablosunu (Pivot1) ekle ---
let idx1 = sheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable1 = sheet.getPivotTables().get(idx1);
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- AYNI kaynak aralığına İKİNCİ pivot tablosunu (Pivot2) ekle ---
// Pivot1 ve Pivot2, TEK bir temel PivotCache'i paylaşır.
// Bu, eski tablo başına RefreshData() yaklaşımının verimsiz hale geldiği tam olarak senaryodur:
// bir tabloyu yenilemek tüm paylaşılan önbelleği yeniden çeker,
// bu yüzden N tabloyu yenilemek aynı pahalı çekme işlemini N kez yapar.
let idx2 = sheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
let pivotTable2 = sheet.getPivotTables().get(idx2);
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- Kaynak verideki birkaç Tutar değerini değiştir ---
sheet.getCells().get("C2").putValue(5000);   // Üzüm  2020
sheet.getCells().get("C5").putValue(7500);   // Kiraz 2020
sheet.getCells().get("C9").putValue(9500);   // Kiraz 2021

// --- ESKİMİŞ desen (26.7 öncesi) — PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // kaynaktan yeniden çeker, tüm önbelleği yeniler
// pivotTable2.RefreshData();  // TEKRAR yeniden çeker — önbellek zaten taze!
// Her çağrı paylaşılan önbelleği yeniden oluşturur, yani N tablo = N gereksiz çekme işlemi.

// --- YENİ v26.7+ deseni: önbelleği BİR KEZ yenile, sonra gerektiğinde yeniden oluştur ---
// PivotCache.Refresh() için tek bir çağrı, değiştirilmiş değerleri paylaşılan
// önbelleğe çeker VE onu referans alan HER pivot tablosunun görünümünü yeniden hesaplar.
// Pivot1 ve Pivot2 tek bir PivotCache'i paylaştığından, bu tek çağrı
// her iki tabloyu da günceller — ikinci bir kaynak gidiş-dönüşü gerekmez.
pivotTable1.getPivotCache().refresh();

// CalculateData() yalnızca bir pivot tablosunun görünümünü (veri + stil)
// önbellekte zaten tutulan verilerden yeniden oluşturur — kaynağa DOKUNMAZ.
// Burada Pivot2 üzerinde yalnızca API'yi göstermek için çağırıyoruz: önbellek
// bir kez yenilendikten sonra, bağımlı herhangi bir tablo kaynağa
// geri dönmeden yeniden oluşturulabilir. Yalnızca pivot tablosunun görünüm/düzen
// ayarları değiştiğinde ve önbellek güncel olduğunda CalculateData()'yı kendi başına kullanın.
pivotTable2.calculateData();

workbook.save("output.xlsx");

Hangi Yenileme API’sini Kullanmalıyım?

Aşağıdaki tablo, mevcut yenileme API’lerini ve her birinin ne zaman seçilmesi gerektiğini özetlemektedir.

Amaç	Önerilen API	Notlar
Çalışma kitabındaki her şeyi yenileme	`Workbook.RefreshAll()`	Tek çağrı; tüm önbellekleri ve tabloları kapsar.
Yalnızca tek bir sayfadaki özet tablolarını yenileme	`Worksheet.RefreshPivotTables()`	Tek bir çalışma sayfasıyla sınırlıdır.
Tek bir önbellek için kaynak veriler değişti	`pivotTable.PivotCache.Refresh()`	O paylaşılan önbellekteki TÜM özet tablolarını yeniler.
Yalnızca görünüm/düzen ayarları değişti	`pivotTable.CalculateData()`	Gereksiz kaynak dönüşünü atlar.
Paylaşılan önbellekteki tüm özet tablolarını listeleme	`pivotCache.GetPivotTables()`	Toplu yenilemeden önce numaralandırmak için kullanın.
Uygulamada, kullanımdan kaldırılan tablo başına `RefreshData()` yerine önbellek tabanlı API’leri tercih edin. Bunlar paylaşılan önbelleklerin farkındadır, gereksiz kaynak getirmelerinden kaçınır ve yenileme gereksiniminizi karşılayan en küçük kapsamı seçmenize olanak tanır.

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'lara stil uygulama

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, hem eski özet tablo otomatik biçimlerini (.xls dosyaları için tasarlanmış) hem de modern adlandırılmış veya özel özet tablo stillerini (.xlsx, .xlsm ve .xlsb dosyaları için tasarlanmış) uygulamayı destekler. Çağırmanız gereken API, çalışma kitabının kaydedildiği dosya biçimine bağlıdır, yüklendiği biçime değil.

Giriş

Aspose.Cells, özet tablolar için iki paralel stil API’si sunar. Aralarındaki seçim, okuduğunuz biçime değil, çalışma kitabını kaydettiğiniz dosya biçimine göre belirlenir. Bir .xls dosyasından yüklenen çalışma kitabı .xlsx olarak yeniden kaydedilebilir ve bu durumda eski stil API’si yerine modern stil API’si geçerlidir.

Eski .xls çıktısı için, Aspose.Cells.Pivot.PivotTableAutoFormatType numaralandırmasıyla birlikte PivotTable.AutoFormatType özelliğini kullanın. Bu API, klasik Excel’in özet tablolar için sunduğu otomatik biçim seçicisine karşılık gelir.

Modern .xlsx, .xlsm ve .xlsb çıktısı için iki çeşit stil API’si mevcuttur:

PivotTable.PivotTableStyleType, yerleşik adlandırılmış stillerden birini seçer (açık ve koyu temalar; Excel 2017’de eklenen stiller dahil). Bu ön ayarlar salt okunurdur.
PivotTable.PivotTableStyleName, Workbook.Worksheets.TableStyles.AddPivotTableStyle(...) aracılığıyla kendinizin tanımladığı özel bir stili seçer. Önceden tanımlanmış stillerin sunduğundan farklı renkleri, kenarlıkları veya yazı tiplerini değiştirmek istediğinizde özel stiller gereklidir.

Ayrıca, PivotTable.FormatAll(Style) kısayolu, tek bir Style nesnesini pivotun her hücresine uygulayarak yukarıdaki stil adı API’lerinden herhangi biriyle ayarlananı geçersiz kılar. Bu, altta yatan temadan bağımsız olarak tek tip bir görünüm gerektiğinde kullanışlıdır.

Eski Bir XLS Ön Ayar Otomatik Biçimi Uygulama

PivotTable.AutoFormatType, Aspose.Cells.Pivot.PivotTableAutoFormatType numaralandırmasından bir değer kabul eder. Kullanılabilir değerler Report1 ile Report10 arası, Classic ve Table1 ile Table10 arasıdır.

AutoFormatType yalnızca çalışma kitabı .xls olarak kaydedildiğinde dikkate alınır. Aynı çalışma kitabı .xlsx, .xlsm veya .xlsb olarak kaydedildiğinde, Excel bu özelliği yok sayar ve PivotTableStyleType ile PivotTableStyleName ayarlarına geri döner.

Aşağıdaki örnek, yeni bir çalışma kitabı yükler, Fruit/Year/Amount örnek verilerini doldurur, bir özet tablo ekler, PivotTableAutoFormatType.Report5 uygular ve sonucu .xls olarak kaydeder.

Neden sütun alanı yok? Report serisi otomatik biçimleri (Report1–Report10, Table1–Table10), klasik Excel’de yalnızca satır alanları ve değerler içeren tek boyutlu özet tablolar için tasarlanmıştı — sütun alanı başlıkları için yerleşik bir biçimlendirmeleri yoktur. Özet tablonuzun sütun alanlarına ihtiyacı varsa, bunun yerine aşağıdaki Senaryo 2’deki modern PivotTableStyleType ön ayarlarını kullanın; bunlar modern Excel’in kullandığı iki boyutlu düzen için tasarlanmıştır.

const AsposeCells = require("aspose.cells");

// Senaryo 1: Eski bir XLS hazır otomatik biçimi uygulayın
// Kullanılan API: PivotTable.AutoFormatType
// Hedef dosya biçimi: .xls (eski)
// Eksiksiz örnekler ve veri dosyaları için lütfen https://github.com/aspose-cells/Aspose.Cells-for-.NET adresine gidin

// Yeni bir çalışma kitabı oluşturun
const workbook = new AsposeCells.Workbook();

// İlk çalışma sayfasını alın
const sheet = workbook.getWorksheets().get(0);

// Başlık satırı (Fruit, Year, Amount) ile kaynak verileri doldurun
// ve 2020 ile 2021 yılları arasında grape, blueberry, kiwi, cherry değerlerini kapsayan 9 veri satırı
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");

sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);

sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);

sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);

sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);

sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);

sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);

sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);

sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);

sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);

// E3 hedef hücresinde, "Pivot1" adıyla ve A1:C10 kaynak aralığı kullanılarak bir pivot tablo ekleyin
const pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
const pivotTable = sheet.getPivotTables().get(pivotIndex);

// Alanları atayın: Fruit -> Satırlar, Year -> Sütunlar, Amount -> Veri
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Eski XLS hazır otomatik biçimi "Report5" uygulayın
// Not: Bu özellik yalnızca .xls olarak kaydederken anlamlıdır.
// .xlsx/.xlsm/.xlsb olarak kaydedildiğinde, Excel AutoFormatType değerini yok sayar
// ve PivotTableStyleType / PivotTableStyleName'in belirttiği biçimi kullanır.
pivotTable.setAutoFormatType(AsposeCells.PivotTableAutoFormatType.Report5);

// Çalışma kitabını eski .xls biçiminde kaydedin
workbook.save("output.xls");

Modern Adlandırılmış Ön Ayar Özet Tablo Stili Uygulama

PivotTable.PivotTableStyleType, Aspose.Cells.PivotTableStyleType numaralandırmasından bir değer kabul eder. Numaralandırma, PivotTableStyleLight1 ile PivotTableStyleLight28 arası açık temaları ve PivotTableStyleDark1 ile PivotTableStyleDark28 arası koyu temaları kapsar. Excel 2017’de eklenen stiller (açık ve koyu temaların ikinci dalgası) aynı numaralandırma aracılığıyla erişilebilir.

Bu, herhangi bir modern dosya biçimi için önerilen API’dir. Eski otomatik biçimin aksine, burada seçilen stil Excel tarafından aslına uygun şekilde işlenir ve diğer Office araçlarıyla gidiş-dönüşlerde korunur.

Aşağıdaki örnek, aynı Fruit/Year/Amount verilerini kullanır, özdeş bir özet tablo oluşturur, PivotTableStyleDark1 uygular ve çalışma kitabını .xlsx olarak kaydeder.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Başlık satırı: Meyve / Yıl / Miktar
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 9 veri satırı: Meyve / Yıl / Miktar
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(180);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(120);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(170);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(210);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(190);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(130);

// E3 hücresine "Pivot1" adında, A1:C10 kaynaklı bir özet tablo ekle
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Özet tablo alanlarını ata: Meyve -> Satır alanı, Yıl -> Sütun alanı, Miktar -> Veri alanı
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Modern bir Excel 2007+ adlandırılmış önceden ayarlanmış özet tablo stili uygula.
// PivotTableStyleType, .xlsx / .xlsm / .xlsb dosyaları için doğru API'dir; AutoFormatType
// Excel tarafından bu formatlar için yok sayılır. PivotTableStyleDark1, koyu tema ailesine
// aittir (PivotTableStyleDark1..PivotTableStyleDark28) ve aynı enum, daha yeni
// Excel 2017 açık/koyu temalarını da (PivotTableStyleLight1..Light28 / Dark1..Dark28) sunar.
pivotTable.setPivotTableStyleType(AsposeCells.PivotTableStyleType.PivotTableStyleDark1);

// Modern .xlsx olarak kaydet — PivotTableStyleType'ın anlamlı olduğu format budur.
workbook.save("output.xlsx");

Özel Bir Özet Tablo Stili Tanımlama ve Uygulama

Yerleşik ön ayarlar değiştirilemez. Renkleri, kenarlıkları veya yazı tiplerini geçersiz kılmanız gerektiğinde özel bir özet stili tanımlamalısınız. İş akışı üç adımdan oluşur:

Workbook.Worksheets.TableStyles.AddPivotTableStyle(string name) aracılığıyla çalışma kitabının TableStyles koleksiyonuna özel bir stil ekleyin. Bu, yeni oluşturulan stilin dizinini döndürür.
TableStyle.TableStyleElements.Add(TableStyleElementType) aracılığıyla öğeler (WholeTable veya GrandTotalRow gibi) ekleyerek, ardından TableStyleElement.SetElementStyle(Style) aracılığıyla her öğeye bir Style atayarak stili yapılandırın.
PivotTable.PivotTableStyleName özelliğini stilin adına ayarlayarak özel stili pivota uygulayın. Burada PivotTableStyleType kullanmayın, çünkü bu özellik yerleşik ön ayarları seçer.

PivotTableStyleName ve PivotTableStyleType birbirinin yerine kullanılamaz. Yerleşik ön ayarlar için PivotTableStyleType, AddPivotTableStyle aracılığıyla tanımladığınız özel stiller için PivotTableStyleName kullanın. Her ikisini birden ayarlamak zararsızdır, ancak yalnızca amaçlanan kaynakla eşleşen işlenir.

Kullanılabilir TableStyleElementType değerleri WholeTable, FirstRow, LastRow, FirstColumn, LastColumn, GrandTotalRow, GrandTotalColumn, PageFieldLabels ve PageFieldValues değerlerini içerir.

Aşağıdaki örnek, WholeTable üzerinde ince siyah kenarlık ve GrandTotalRow üzerinde kalın kırmızı yazı tipi ile özel bir özet stili tanımlar, ardından PivotTableStyleName aracılığıyla uygular ve .xlsx olarak kaydeder.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Kaynak verileri doldur: başlık satırı + 9 veri satırı (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);

// A1:C10'dan kaynaklanan, E3'e sabitlenmiş, "Pivot1" adlı pivot tablo ekle
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Adım 1: yeni özel pivot tablo stilini kaydet ve dizinini yakala
let styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
let tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);

// Adım 2: bir WholeTable öğesi ekle ve dört kenara da ince siyah kenarlık uygula
let wholeTableElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.WholeTable);
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
let wholeTableStyle = workbook.createStyle();
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);
wholeTableElement.setElementStyle(wholeTableStyle);

// Adım 3: bir GrandTotalRow öğesi ekle ve kalın kırmızı yazı tipi uygula
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GrandTotalRow);
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
let grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setIsBold(true);
grandTotalStyle.getFont().setColor(AsposeCells.Color.Red);
grandTotalElement.setElementStyle(grandTotalStyle);

// Adım 4: özel stili ada göre uygula (PivotTableStyleType DEĞİL, bu yerleşik ön ayarlar içindir)
pivotTable.setPivotTableStyleName("CustomPivotStyle");

workbook.save("output.xlsx");

FormatAll ile Her Pivot Hücresine Tek Bir Stil Uygulama

PivotTable.FormatAll(Style), tek bir Style nesnesini özet tablonun veri alanı, satır ve sütun başlıkları ile toplamlar dahil her hücresine uygulayan bir kısayoldur. PivotTableStyleType veya PivotTableStyleName aracılığıyla daha önce ayarlanmış olan her şey geçersiz kılınır.

FormatAll, hem PivotTableStyleType hem de PivotTableStyleName öğelerini geçersiz kılar. Yalnızca tüm pivot genelinde tek tip ve temadan bağımsız bir görünüm gerektiğinde kullanın.

Aşağıdaki örnek, sarı düz dolgulu, kalın koyu mavi yazı tipine ve her tarafta ince siyah kenarlıklara sahip bir Style oluşturur, ardından FormatAll ile uygular ve .xlsx olarak kaydeder.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Kaynak verileri doldur: başlık satırı (satır 1) + 9 veri satırı (satır 2-10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020); // Üzüm 2020 yılı satış tutarı: 5000 worksheets.getCells().get("C2").putValue(5000);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020); worksheets.getCells().get("C3").putValue(3000);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020); worksheets.getCells().get("C4").putValue(4000);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020); worksheets.getCells().get("C5").putValue(2000);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021); worksheets.getCells().get("C6").putValue(6000);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021); worksheets.getCells().get("C7").putValue(3500);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021); worksheets.getCells().get("C8").putValue(4500);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021); worksheets.getCells().get("C9").putValue(2500);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021); worksheets.getCells().get("C10").putValue(5500);

// Pivot tablosu ekle: kaynak aralığı A1:C10, hedef hücre E3, adı "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Pivot alanlarını ata: Fruit -> Satır alanı, Year -> Sütun alanı, Amount -> Veri alanı
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Pivot tablosunun her hücresine zorla uygulanacak bir Stil oluştur
let style = workbook.createStyle();
style.setForegroundColor(AsposeCells.Color.Yellow);
style.setPattern(AsposeCells.BackgroundType.Solid);
style.getFont().setIsBold(true);
style.getFont().setColor(AsposeCells.Color.DarkBlue);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);

// FormatAll uygula: bu tek stili pivot tablosunun her hücresine zorlar,
// daha önce ayarlanmış olan PivotTableStyleType / PivotTableStyleName değerlerini geçersiz kılar
pivotTable.formatAll(style);

// Çalışma kitabını modern .xlsx biçiminde kaydet
workbook.save("output.xlsx");

Hangi Stil API’sini Kullanmalıyım?

Stil API’si seçimi, kaydettiğiniz dosya biçimine bağlıdır. Hızlı bir başvuru olarak aşağıdaki tabloyu kullanın.

Hedef dosya biçimi	Kullanılacak API	Notlar
`.xls` (eski)	`PivotTable.AutoFormatType`	`Aspose.Cells.Pivot.PivotTableAutoFormatType` değerleri (ör. `Report1`–`Report10`, `Classic`, `Table1`–`Table10`). Modern biçimler olarak kaydederken yok sayılır.
`.xlsx` / `.xlsm` / `.xlsb` (modern, yerleşik stil)	`PivotTable.PivotTableStyleType`	`Aspose.Cells.PivotTableStyleType` değerleri (açık/koyu temalar; Excel 2017 eklemeleri dahil).
`.xlsx` / `.xlsm` / `.xlsb` (modern, özel stil)	`PivotTable.PivotTableStyleName` + `Worksheets.TableStyles.AddPivotTableStyle(...)`	Yerleşik ön ayarlar yeterli olmadığında kullanın. `TableStyleElement.SetElementStyle(...)` aracılığıyla yapılandırın.
Herhangi bir biçim (tek tip geçersiz kılma)	`PivotTable.FormatAll(Style)`	Pivot genelinde diğer tüm stil ayarlarını geçersiz kılan kısayol.

Şüpheye düştüğünüzde, .xlsx olarak kaydedin ve yerleşik temalar için PivotTableStyleType, özel temalar için PivotTableStyleName kullanın.

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'a satır ve sütun alanları ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Satır veya Sütun Bölgesine Alan Ekleme

PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) yöntemi, kaynak verilerden bir temel alanı dört pivot bölgesinden birine taşır. fieldType bağımsız değişkeni aşağıdaki PivotFieldType değerlerinden birini kabul eder.

Row — dikey olarak sol tarafa yerleştirilen alanlar
Column — yatay olarak üst tarafa yerleştirilen alanlar
Data — değerleri toplanan alanlar
Page — rapor filtreleri olarak kullanılan alanlar

Alanlar eklendikten sonra, PivotTable.RowFields ve PivotTable.ColumnFields özellikleri aracılığıyla bunlara erişebilirsiniz. Her özellik bir PivotFieldCollection döndürür. RowFields koleksiyonunun 0 dizinindeki alan en dıştaki satır alanıdır ve sonraki dizinler onun içine yerleştirilmiş alanları temsil eder. Aynı indeksleme kuralı ColumnFields için de geçerlidir.

Alan iç içe geçme sırası önemlidir. Önce Category‘yi satır bölgesine, sonra Item‘ı eklemek, dış gruplaması Category ve iç gruplaması Item olan bir pivot üretir. Sırayı tersine çevirmek hiyerarşiyi de tersine çevirir.

Pivot Alanı Alt Toplamları

PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) yöntemi, bir pivot alanı için hangi alt toplam satırlarının görüneceğini kontrol eder. Her çağrı tek bir alt toplam türünü bağımsız olarak değiştirir. shown = true geçmek alt toplamı görüntüler, shown = false geçmek ise gizler. Her çağrı yalnızca bir türü etkilediğinden, yöntemi farklı subtotalType değerleriyle birden çok kez çağırmak özel bir alt toplam alt kümesi oluşturur.

PivotFieldSubtotalType numaralandırması kullanılabilir alt toplam türlerini tanımlar.

Automatic — Aspose.Cells varsayılan seçimi seçer (genellikle sayısal alanlar için Sum)
None — her alt toplam satırını bastır
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

Alt toplamlar yalnızca satır bölgesinde (veya sütun bölgesinde) iki veya daha fazla pivot alanı olduğunda görüntülenir. Tek bir alanın alt toplam alacak anlamlı bir şeyi yoktur, dolayısıyla bu durumda SetSubtotals çağrılarının görünür bir etkisi olmaz. Bu nedenle bu makale, her örnekte iki satır alanı (Category dış, Item iç) yerleştirir; böylece her Category grubu arasındaki alt toplam sınırı görünür olur.

Senaryo 1 — Otomatik (Varsayılan) Alt Toplamlar

SetSubtotals yöntemini hiç çağırmadığınızda, Aspose.Cells sayısal alanlara Automatic seçimini uygular. Aşağıdaki örnek, dış Category satır alanı üzerinde SetSubtotals(PivotFieldSubtotalType.Automatic, true) çağırarak bu davranışı açıkça doğrular.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Automatic, true);

pivotTable.calculateData();

workbook.save("output_automatic.xlsx");

Senaryo 2 — Tüm Alt Toplamların Bastırılması (None)

SetSubtotals(PivotFieldSubtotalType.None, true) çağrısı, pivottaki tüm alt toplam satırlarını kaldırarak yalnızca alan satırlarını ve alttaki genel toplamı bırakır. Bu, herhangi bir özet satırı olmadan ham gruplandırılmış verileri istediğinizde kullanışlıdır.

const AsposeCells = require("aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}

const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020, 80],
    ["Fruit",     "Banana", 2021, 90],
    ["Vegetable", "Carrot", 2020, 50],
    ["Vegetable", "Carrot", 2021, 60],
    ["Vegetable", "Daikon", 2020, 40],
    ["Vegetable", "Daikon", 2021, 45]
];

for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}

const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

const categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();

workbook.save("output_none.xlsx");

Senaryo 3 — Özel Alt Toplam Alt Kümesi (Sum + Average)

Tek bir alt toplam türüyle sınırlı değilsiniz. Her SetSubtotals çağrısı bir tür üzerinde bağımsız olarak çalışır, dolayısıyla yöntemi iki kez çağırmak — bir kez Sum ve bir kez Average ile — her Category grubu için iki alt toplam satırlık özel bir alt küme üretir.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get("A1").putValue("Category");
worksheet.getCells().get("B1").putValue("Item");
worksheet.getCells().get("C1").putValue("Year");
worksheet.getCells().get("D1").putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotTables = worksheet.getPivotTables();
let pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1");
let pivotTable = pivotTables.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Sum, true);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Average, true);

pivotTable.calculateData();

workbook.save("output_custom.xlsx");

Özet

Yukarıdaki üç senaryo aynı veri kümesini ve pivot tablo yapısını paylaşır. Aralarındaki tek fark, dış Category satır alanına uygulanan SetSubtotals çağrısıdır. İki alan kuralını unutmayın: bir bölgedeki tek alanın alt toplam alacak bir şeyi yoktur, dolayısıyla SetSubtotals‘ın görünür bir etkiye sahip olmasını istediğinizde satır veya sütun bölgesine her zaman en az iki alan yerleştirin.

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable değer alanlarını yönetme

Mon, 01 Jan 0001 00:00:00 +0000

Veri Bölgesine Alan Ekleme

Bir temel alanı veri (değer) bölgesine eklemek, pivot tablonun kaynak verilerinizi nasıl topladığını şekillendirmede ilk adımdır. Aspose.Cells, PivotFieldType.Data sabitini ve kaynak sütun adını kabul eden PivotTable.addFieldToArea(PivotFieldType, string) aşırı yüklemesini sunar. Bir alan veri bölgesine eklendiğinde, API bunu PivotTable.getDataFields() koleksiyonu aracılığıyla, alanların eklendiği sırayla sunar. Varsayılan olarak, sayısal bir kaynak sütun ConsolidationFunction.Sum ile özetlenirken, sayısal olmayan bir sütun Count varsayılan değerini alır.

const AsposeCells = require("aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// A1:D1 aralığındaki başlıklar
worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

// j üzerinde dallanan iç içe döngüler kullanarak A2:D9 veri satırları
for (let i = 1; i <= 8; i++) {
 for (let j = 0; j < 4; j++) {
 switch (j) {
 case 0:
 worksheet.getCells().get(i, j).putValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i === 1 || i === 2) worksheet.getCells().get(i, j).putValue("Apple");
 else if (i === 3 || i === 4) worksheet.getCells().get(i, j).putValue("Banana");
 else if (i === 5 || i === 6) worksheet.getCells().get(i, j).putValue("Carrot");
 else worksheet.getCells().get(i, j).putValue("Daikon");
 break;
 case 2:
 worksheet.getCells().get(i, j).putValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i === 1) worksheet.getCells().get(i, j).putValue(100);
 else if (i === 2) worksheet.getCells().get(i, j).putValue(150);
 else if (i === 3) worksheet.getCells().get(i, j).putValue(80);
 else if (i === 4) worksheet.getCells().get(i, j).putValue(90);
 else if (i === 5) worksheet.getCells().get(i, j).putValue(50);
 else if (i === 6) worksheet.getCells().get(i, j).putValue(60);
 else if (i === 7) worksheet.getCells().get(i, j).putValue(40);
 else worksheet.getCells().get(i, j).putValue(45);
 break;
 }
 }
}

// F3 konumuna PivotTable1 adıyla pivot tablo ekle
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Pivot düzeni: Satırda Kategori ve Öğe, Sütunda Yıl, veri alanı olarak Tutar
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

pivotTable.calculateData();
workbook.save("output_drag.xlsx");

Özetleme İşlevini Değiştirme

Veri bölgesine yerleştirilen her alan dahili olarak bir PivotField örneği olarak sarılır ve getFunction() özelliği ConsolidationFunction enum’undan bir değer döndürür. Aynı setFunction() ayarlayıcısı, Sum, Count, Average, Max, Min, Product, StdDev, StdDevp, Var ve Varp dahil mevcut toplamlar arasında geçiş yapmanıza olanak tanır.

Özetleme işlevini değiştirmek yalnızca toplamı etkiler, kaynak sütun değişmez.

Bu nedenle bir veri alanını Sum olarak bırakırken, aynı kaynak sütunu hedefleyen ancak Count veya Average kullanan ikinci bir veri alanını tek bir pivot içinde ekleyebilirsiniz.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.getCells().get(i, j).putValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
 worksheet.getCells().get(i, j).putValue(items[i - 1]);
 }
 else if (j == 2)
 {
 let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
 worksheet.getCells().get(i, j).putValue(years[i - 1]);
 }
 else
 {
 let amounts = [100, 150, 80, 90, 50, 60, 40, 45];
 worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let countField = pivotTable.getDataFields().get(1);
countField.setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.calculateData();

workbook.save("output_function.xlsx");

Değer Alanlarını Satır veya Sütun Eksenine Yerleştirme

Bir pivot tablo iki veya daha fazla veri alanı içerdiğinde, Aspose.Cells PivotTable.getValuesField adlı ek bir sanal alan sunar. Bu sanal alan, veri bölgesinde bulunan her veri alanının toplamını temsil eder. Birden fazla ölçüyü yan yana düzenlemek için kullanışlı olan bu alanı, temel bir pivot alanı olarak Satır veya Sütun bölgesine sürükleyebilirsiniz.

PivotTable.getValuesField(), hiç değer alanı yoksa veya yalnızca bir değer alanı varsa çalışmaz.

Aşağıdaki senaryolar, yukarıda açıklanan her yeteneği aynı pivot yapısına karşı gösteren üç uçtan uca örnek üzerinden ilerler.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

let categories = ["Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable"];
let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
let amounts = [100, 150, 80, 90, 50, 60, 40, 45];

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.getCells().get(i, j).putValue(categories[i - 1]);
 else if (j == 1) worksheet.getCells().get(i, j).putValue(items[i - 1]);
 else if (j == 2) worksheet.getCells().get(i, j).putValue(years[i - 1]);
 else worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, pivotTable.getValuesField());

pivotTable.calculateData();
workbook.save("output_plot.xlsx");

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'a filtre alanları ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, pivot tablolardaki filtre alanlarının tüm yaşam döngüsünü destekler. Üst düzey kolaylık API’si aracılığıyla veya alt düzey PageFields koleksiyonu aracılığıyla bir filtre alanı ekleyebilir, filtreni tek seçim modunda çalıştırabilir, her sayfa öğesini göstermek için temizleyebilir veya Excel’deki onay kutusu kullanıcı arayüzü aracılığıyla kullanıcıların bir defada birden çok sayfa öğesi seçebilmesi için alanı çoklu seçime geçirebilirsiniz.

Giriş

filtre alanı, pivot gövdesinin kaynak verilerin hangi alt kümesini görüntüleyeceğini kontrol eden bir pivot alanıdır. Son kullanıcılar bunu Excel’de işlenmiş bir pivot’ın üst kısmında bir açılır menü olarak görür ve mevcut sayfa öğelerinden birini seçmek, yalnızca o sayfa öğesine ait kayıtların özetleneceği şekilde pivot gövdesini yeniden oluşturur. Bir pivot alanı, PivotFieldType.Row, PivotFieldType.Column veya PivotFieldType.Data yerine PivotFieldType.Page olarak kaydedildiğinde filtre alanı haline gelir.

Bir filtre alanı iki davranışta çalışabilir. Varsayılan tek seçim davranışında aynı anda yalnızca bir sayfa öğesi görünür, dolayısıyla pivot gövdesi tam olarak bir alt kümeyi özetler. Çoklu seçim davranışında ise alan bir onay kutusu listesi sunar ve pivot gövdesi işaretlenen her sayfa öğesinin birleşimini özetler. Aynı kaynak alan, tek bir özelliğin değiştirilmesiyle bu davranışlar arasında ileri geri taşınabilir.

Aspose.Cells for Node.js via C++, bir filtre alanını kaydetmek için iki eşdeğer yol sunar. Üst düzey API, kaynak-sütun adını alan ve tek bir çağrıda alanı ekleyen PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName") yöntemidir. Alt düzey API, zaten bir PivotField referansına sahip olduğunuzda ve aynı alan örneğini filtre alanına eklemek istediğinizde kullanılan PivotTable.pageFields.add(PivotField) yöntemidir. Her iki API de aynı PageFields koleksiyonunu doldurur ve bu makalenin geri kalanı aralarında nasıl seçim yapılacağını ve her bir filtreleme modunun nasıl çalıştırılacağını gösterir.

filtre alanı Ekleme

Bir pivot alanını filtre alanına kaydetmenin iki yolu vardır. Üst düzey çağrı, kaynak-sütun adını bir dize olarak alır ve en yaygın yoldur. Alt düzey çağrı, mevcut bir PivotField örneğini kabul eder ve aynı alan nesnesinin birden çok pivot alanında yeniden kullanılması gerektiğinde kullanışlıdır. Her iki çağrı da alanı PivotTable.pageFields içine yerleştirir; bundan sonra alan, işlenmiş pivot’ın üst kısmında sayfa açılır menüsü olarak görünür.

addFieldToArea ile filtre alanı Ekleme

Aşağıdaki örnek, küçük bir Meyve / Yıl / Tutar veri kümesi oluşturur, E3 hücresine bir pivot tablo yerleştirir, satır alanına Fruit, veri alanına Amount ve filtre alanına Year koyar, pivot’u yeniler ve çalışma kitabını kaydeder.

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// Başlık satırını ayarla
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 9 satır örnek veriyi doldur: Meyve, Yıl, Miktar
var data = [
    [ "apple", 2020, 100 ],
    [ "banana", 2021, 200 ],
    [ "apple", 2021, 150 ],
    [ "grape", 2020, 120 ],
    [ "orange", 2022, 180 ],
    [ "banana", 2020, 90 ],
    [ "grape", 2021, 130 ],
    [ "apple", 2022, 170 ],
    [ "orange", 2021, 110 ]
];

for (var i = 0; i < data.length; i++)
{
    worksheet.getCells().get(i + 1, 0).putValue(data[i][0]);
    worksheet.getCells().get(i + 1, 1).putValue(data[i][1]);
    worksheet.getCells().get(i + 1, 2).putValue(data[i][2]);
}

// E3 hücresine bağlı bir pivot tablo ekle
var pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Alanları ilgili bölümlere ekle: Satır olarak Meyve, Veri olarak Miktar, Sayfa alanı olarak Yıl
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// Pivot tablo verilerini yenile ve hesapla
pivotTable.calculateData();

// Çalışma kitabını kaydet
workbook.save("pageFieldSample.xlsx");

pageFields.add ile filtre alanı Ekleme

Zaten bir PivotField örneğiyle çalışıyorsanız, onu doğrudan PivotTable.pageFields.add yöntemine geçebilirsiniz. Pivot tablo ve filtre alanı, önceki senaryodakiyle tam olarak aynı şekilde oluşturulur; yalnızca son filtre alanı kaydı alt düzey API çağrısıyla değiştirilir.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// Başlıklar
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

// Örnek veriler (9 satır)
sheet.getCells().get("A2").putValue("apple");     sheet.getCells().get("B2").putValue("2020"); sheet.getCells().get("C2").putValue(100);
sheet.getCells().get("A3").putValue("apple");     sheet.getCells().get("B3").putValue("2021"); sheet.getCells().get("C3").putValue(150);
sheet.getCells().get("A4").putValue("apple");     sheet.getCells().get("B4").putValue("2022"); sheet.getCells().get("C4").putValue(200);
sheet.getCells().get("A5").putValue("grape");     sheet.getCells().get("B5").putValue("2020"); sheet.getCells().get("C5").putValue(300);
sheet.getCells().get("A6").putValue("grape");     sheet.getCells().get("B6").putValue("2021"); sheet.getCells().get("C6").putValue(400);
sheet.getCells().get("A7").putValue("grape");     sheet.getCells().get("B7").putValue("2022"); sheet.getCells().get("C7").putValue(500);
sheet.getCells().get("A8").putValue("blueberry"); sheet.getCells().get("B8").putValue("2020"); sheet.getCells().get("C8").putValue(250);
sheet.getCells().get("A9").putValue("blueberry"); sheet.getCells().get("B9").putValue("2021"); sheet.getCells().get("C9").putValue(350);
sheet.getCells().get("A10").putValue("blueberry");sheet.getCells().get("B10").putValue("2022"); sheet.getCells().get("C10").putValue(450);

// A1:C10 aralığını kapsayacak şekilde E3 konumuna pivot tablosu ekle
let pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);

// Fruit -> Satır, Amount -> Veri (Year aşağıda Sayfa alanına eklenecek)
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Düşük seviyeli yaklaşım: BaseFields içindeki mevcut Year PivotField'ını al
// ve PageFields.Add(PivotField) aracılığıyla Sayfa alanına kaydet
let yearField = pivotTable.getBaseFields().get("Year");
pivotTable.getPageFields().add(yearField);

// Yeni sayfa alanının kaydedilen çalışma kitabında yansıtılması için yenile
pivotTable.calculateData();

workbook.save("output.xlsx");

Tek Seçim Filtreleme (Bir Sayfa Öğesi Gösterme)

Varsayılan tek seçim davranışında, filtre alanı tek bir açılır menü olarak işlenir ve PivotField.currentPageItem tamsayısı, pivot gövdesini hangi sayfa öğesinin çalıştıracağını seçer. Belirli bir dizin atamak o öğeyi seçer; özel gösterge değeri 0x7FFD (ondalık 32765) atamak filtreyi temizler, böylece her sayfa öğesi bir defada özetlenir. Tek seçim varsayılandır; bunu açıkça etkinleştirmeniz gerekmez.

Tüm Öğeleri Gösterme

currentPageItem öğesini sihirli değer olan 0x7FFD değerine ayarlamak, filtreni temizlemeye eşdeğerdir: pivot gövdesi, hiçbir filtre uygulanmamış gibi her sayfa öğesini özetler.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// Meyve/Yıl/Miktar verilerini doldur
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

let data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];

for (let r = 0; r < data.length; r++) {
    for (let c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}

// E3'te özet tablo oluştur
let pivotTables = sheet.getPivotTables();
let index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
let pivotTable = pivotTables.get(index);

// Özet tablo alanlarını yapılandır: Fruit→Satır, Amount→Veri, Year→Sayfa
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

pivotTable.calculateData();

// Sayfa filtresini temizle, böylece sayfa alanındaki her öğe görünür.
// 0x7FFD (ondalık 32765), "tüm öğeler" anlamına gelen özel bekçi değeridir —
// Excel'in sayfa alanı açılır menüsünde "(Tümü)" seçmeye eşdeğerdir.
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD);

workbook.save("output.xlsx");

Belirli Bir Öğeyi Gösterme

currentPageItem öğesini gerçek bir dizine ayarlamak yalnızca o bir sayfa öğesini seçer. Dizin, filtre alanının sıralanmış öğe listesindeki öğenin konumudur, dolayısıyla örneğin 1 değeri sıralamadan sonra ikinci öğeyi seçer.

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
var cells = sheet.getCells();

// Örnek veri ekle (Meyve/Yıl/Miktar)
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");

cells.get("A2").putValue("Apple");
cells.get("B2").putValue("2020");
cells.get("C2").putValue("100");

cells.get("A3").putValue("Apple");
cells.get("B3").putValue("2021");
cells.get("C3").putValue("150");

cells.get("A4").putValue("Banana");
cells.get("B4").putValue("2020");
cells.get("C4").putValue("200");

cells.get("A5").putValue("Banana");
cells.get("B5").putValue("2021");
cells.get("C5").putValue("250");

// E3'e pivot tablo ekle
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);

// Alanları ekle: Fruit→Satır, Amount→Veri, Year→Sayfa
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// Sayfa alanına özel işlemler
pivotTable.getPageFields().get(0).setCurrentPageItem(1); // 1 = sıralanmış listedeki ikinci öğe (ör. "2021")

// Pivot tabloyu yenile ve hesapla
pivotTable.calculateData();

workbook.save("output.xlsx");

Çoklu Seçim Filtreleme

Çoklu seçim filtreleme, sayfa açılır menüsünü bir onay kutusu listesine dönüştürür ve son kullanıcının aynı anda birkaç sayfa öğesi seçmesine olanak tanır. Aspose.Cells birlikte çalışan iki özellik sunar. PivotField.isMultipleItemSelectionAllowed öğesinin, çoklu seçim kullanıcı arayüzünün geçerli olması için true olarak ayarlanması gerekir. Etkinleştirildikten sonra, PivotItem.isHidden öğesi onay kutusu listesinde hangi öğelerin görüneceğini kontrol eder; böylece her öğeyi gösterebilir veya yalnızca belirli öğeleri beyaz listeye alabilirsiniz.

Aşağıdaki kod, Senaryo 1a’da oluşturulan aynı Year filtre alanında çoklu seçimi etkinleştirir ve ardından iki desen gösterir: Bölüm A, her giriş için isHidden öğesini false olarak bırakarak her sayfa öğesini ortaya çıkarırken, Bölüm B yalnızca seçtiğiniz kaynak değerlerini beyaz listeye alır ve switch (pivotItems[i].getStringValue()) bloğu aracılığıyla diğer her şeyi gizler.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cells = sheet.getCells();

// Örnek veri: Meyve | Yıl | Miktar
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");

let data = [
    ["apple", "2019", "100"],
    ["apple", "2020", "150"],
    ["apple", "2021", "200"],
    ["banana", "2019", "110"],
    ["banana", "2020", "160"],
    ["banana", "2021", "210"],
    ["grape", "2019", "120"],
    ["grape", "2020", "170"],
    ["grape", "2021", "220"]
];

for (let i = 0; i < data.length; i++) {
    cells.get(i + 1, 0).putValue(data[i][0]);
    cells.get(i + 1, 1).putValue(parseInt(data[i][1]));
    cells.get(i + 1, 2).putValue(parseInt(data[i][2]));
}

let pivotSheet = workbook.getWorksheets().add("Pivot");
let pivots = pivotSheet.getPivotTables();
let pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
let pivotTable = pivots.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// — Sayfa alanında çoklu seçimi etkinleştir
pivotTable.getPageFields().get(0).setIsMultipleItemSelectionAllowed(true);

// Bölüm A — TÜM öğeleri seç (her öğeyi görünür yap)
let pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setIsHidden(false);
}

// Bölüm B — Yalnızca belirli öğeleri kaynak değere göre seç
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setIsHidden(false);
            break;
        default:
            pivotItems.get(i).setIsHidden(true);
            break;
    }
}

pivotTable.calculateData();

workbook.save("output.xlsx");

Not: PivotItem.isHidden aracılığıyla çoklu seçim filtreleme kullanırken, en az bir PivotItem görünür kalmalıdır (isHidden == false). Her öğe gizlenirse, Excel dosyayı açarken kilitlenir veya boş bir pivot oluşturur. Çoklu seçim beyaz listenizin kaynak verilerinizden en az bir öğe içerdiğini her zaman doğrulayın.

Hangi API’yi ve Hangi Modu Kullanmalıyım?

Aşağıdaki tablo, her senaryoyu ayrıntılı olarak okumadan doğru kombinasyonu seçebilmeniz için her API’nin ve modun ne zaman kullanılacağını özetler.

Senaryo / Kullanım Durumu	Önerilen API	Kullanılan Özellik	Notlar
Kaynak-sütun adına göre filtre alanı ekleme (en yaygın)	`PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")`	yok	Üst düzey, tek satır. Bir `PivotField` referansına ihtiyacınız olmadıkça bunu kullanın.
Zaten bir `PivotField` nesneniz varken filtre alanı ekleme	`PivotTable.pageFields.add(PivotField)`	yok	Alan nesnesi başka bir yerden alındığında veya yeniden kullanılması gerektiğinde kullanın.
Tek bir sayfa öğesine filtreleme (varsayılan mod)	`PivotField.currentPageItem`	belirli bir dizine ayarla	Örneğin, `1` sıralanmış listedeki ikinci öğeyi gösterir.
Tüm öğeleri gösterme / filtreni temizleme	`PivotField.currentPageItem`	`0x7FFD` değerine ayarla	Sihirli değer olan `0x7FFD` (ondalık 32765), “tüm öğeler” için göstergedir.
Excel’de çoklu seçim kullanıcı arayüzünü etkinleştirme	`PivotField.isMultipleItemSelectionAllowed`	`true` olarak ayarla	Herhangi bir `isHidden` çağrısının geçerli olmasından önce gereklidir.
Çoklu seçim listesindeki tek tek öğeleri gizleme / gösterme	`PivotItem.isHidden`	öğeye göre ayarla	En az bir öğe görünür kalmalıdır (`isHidden == false`).

Çoklu seçim filtrelemeyi yapılandırırken görünürlük kısıtlamasını her zaman hatırlayın. Çoklu seçim filtre alanındaki her PivotItem gizlenirse, Excel açılırken kilitlenir veya boş bir pivot oluşturur. Beyaz listenizi kaynak verilerinize göre oluşturun, böylece en az bir öğe görünür kalır ve kaydedilen çalışma kitaplarınız her makinede güvenilir şekilde açılır.

Nodejscpp: Bir Çalışma Sayfasından Pivot Tablosunu Sil

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++, bir Çalışma Sayfasından Pivot Tablo silme veya kaldırma özelliği sağlar. Pivot tablo nesnesini veya pivot tablo konumunu kullanarak pivot tabloyu silebilirsiniz. Pivot tabloyu silmek için, pivot tablo nesnesi kullanılarak Worksheet.getPivotTables().remove(pivotTable) yöntemini ve Pivot tablo koleksiyonundaki konum kullanılarak Worksheet.getPivotTables().removeAt(index, keepData) yöntemini kullanın.

Aspose.Cells for Node.js via C++ kullanarak Çalışma Sayfasından Pivot Tablo nasıl silinir

Aşağıdaki örnek kod, çalışma sayfasından iki pivot tablosunu siler. İlk önce Worksheet.getPivotTables().remove(pivotTable) yöntemini kullanarak pivot tablosunu kaldırır, ardından Worksheet.getPivotTables().removeAt(index, keepData) yöntemini kullanarak pivot tablosunu kaldırır.

Nodejscpp: Özet Tabloyu ODS Dosyasına Kaydetme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++, pivot tabloyu ODS dosyaları olarak kaydetme yeteneği sağlar. Bunun için, mevcut pivot tabloyu içeren veya yeni bir pivot tablo oluşturan bir çalışma kitabını ODS biçiminde kaydedersiniz. Kaydetmeden önce PivotTable.calculateData ‘nın çağrıldığından emin olun, böylece çıktı ODS dosyasına pivot tablo doğru şekilde render edilir. Aşağıdaki kod örneği, pivot tabloyu ODS dosyasına kaydetmeyi gösterir.

Örnek Kod

Yukarıdaki kod tarafından oluşturulan çıkış dosyası referans için ekte bulunmaktadır.

Çıktı ODS Dosyası

Documentation – Pivot Tablo Ekle

Nodejscpp: Pivot Tablosunu Biçimlendirme

Döndürme Tablosu Görünümü

Pivot Tablo Format Seçeneklerini Ayarlama

Otomatik Biçim Türünün Ayarlanması

Biçim Seçeneklerini Ayarlama

Aşağıdaki kod örneği, pivot tablosunu satır ve sütunlar için toplamları göstermek üzere biçimlendirme ve raporun alan sırasını ayarlamayı gösterir. Ayrıca, null değerler için özel bir dize ayarlamak da gösterilir.

Pivot Alanı Biçim Seçeneklerini Ayarlama

Satır/Sütun/Sayfa Alan Biçimini Nasıl Ayarlanır

Veri alanı biçimini nasıl ayarlanır

Pivot Alanlarını Temizleme Yöntemi

Nodejscpp: Özet Tabloları ve Özet Grafikler Oluşturma

Aspose.Cells for Node.js via C++ Kullanarak Pivot Tablo ve Grafikler Ekleme

Aspose.Cells for Node.js via C++ kullanmak için Hazırlık

Aspose.Cells for Node.js via C++ Kullanarak Pivot Tablo Ekleme Yöntemi

Aspose.Cells for Node.js via C++ Kullanarak Pivot Grafik Ekleme Yöntemi

Nodejscpp: Pivot Tablosu ve Kaynak Veri

Pivot Tablosunun Kaynak Verisi

Bir Pivot Tablosunun Veri Kaynağını Değiştirme

Nodejscpp: Pivot Tablosunda Hesaplanmış Alan Ekleme

Olası Kullanım Senaryoları

Excel’de Pivot Tablosuna Hesaplanmış Alan Eklemek

Aspose.Cells for Node.js via C++ Kütüphanesi kullanarak Pivot Tablosuna Hesaplanmış Alan Nasıl Eklenir

Örnek Kod

Nodejscpp: Aspose.Cells for Node.js via C++'da Özet Tabloları Yenileme

Giriş

Gerekli İçe Aktarmalar

Çalışma Kitabındaki Tüm Özet Tablolarını Yenileme

Tek Bir Çalışma Sayfasındaki Tüm Özet Tablolarını Yenileme

Tek Bir Özet Tablosunu Yenileme

Kaynak Veri Değişti — PivotCache.Refresh() Kullanın

Yalnızca Görünüm/Düzen Değişti — CalculateData() Kullanın

Aynı PivotCache’i Paylaşan Tüm Özet Tablolarını Alma

Kullanımdan Kaldırılan PivotTable.RefreshData() Yönteminden Geçiş

Hangi Yenileme API’sini Kullanmalıyım?

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'lara stil uygulama

Giriş

Eski Bir XLS Ön Ayar Otomatik Biçimi Uygulama

Modern Adlandırılmış Ön Ayar Özet Tablo Stili Uygulama

Özel Bir Özet Tablo Stili Tanımlama ve Uygulama

FormatAll ile Her Pivot Hücresine Tek Bir Stil Uygulama

Hangi Stil API’sini Kullanmalıyım?

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'a satır ve sütun alanları ekleme

Satır veya Sütun Bölgesine Alan Ekleme

Pivot Alanı Alt Toplamları

Senaryo 1 — Otomatik (Varsayılan) Alt Toplamlar

Senaryo 2 — Tüm Alt Toplamların Bastırılması (None)

Senaryo 3 — Özel Alt Toplam Alt Kümesi (Sum + Average)

Özet

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable değer alanlarını yönetme

Veri Bölgesine Alan Ekleme

Özetleme İşlevini Değiştirme

Değer Alanlarını Satır veya Sütun Eksenine Yerleştirme

Nodejscpp: Aspose.Cells for Node.js via C++'te PivotTable'a filtre alanları ekleme

Giriş

filtre alanı Ekleme

addFieldToArea ile filtre alanı Ekleme

pageFields.add ile filtre alanı Ekleme

Tek Seçim Filtreleme (Bir Sayfa Öğesi Gösterme)

Tüm Öğeleri Gösterme

Belirli Bir Öğeyi Gösterme

Çoklu Seçim Filtreleme

Hangi API’yi ve Hangi Modu Kullanmalıyım?

Nodejscpp: Bir Çalışma Sayfasından Pivot Tablosunu Sil

Aspose.Cells for Node.js via C++ kullanarak Çalışma Sayfasından Pivot Tablo nasıl silinir

Nodejscpp: Özet Tabloyu ODS Dosyasına Kaydetme

Örnek Kod

Kaynak Veri Değişti — `PivotCache.Refresh()` Kullanın

Yalnızca Görünüm/Düzen Değişti — `CalculateData()` Kullanın

Kullanımdan Kaldırılan `PivotTable.RefreshData()` Yönteminden Geçiş