تعديل تخطيط حقل الصفحة في الجدول المحوري

Introduction

يكشف الجدول المحوري في Microsoft Excel عن منطقة حقل صفحة مخصصة تقع فوق جسم الصفوف/الأعمدة/البيانات في الجدول. تُعرض هذه المنطقة كشريط من عناصر التحكم بالفلاتر المنسدلة (واحد لكل حقل صفحة) وهو ما ينقر عليه المستخدمون لتقسيم الجدول المحوري حسب معايير مثل السنة أو المنطقة. يقوم Aspose.Cells بنمذجة هذه المنطقة من خلال مجموعة PivotTable.PageFields ويعرض ثلاث خصائص تتحكم في كيفية عرض الشريط بصريًا:

  • PivotTable.PageFieldOrder (قيمة من نوع Aspose.Cells.PrintOrderType) يحدد ما إذا كانت حقول الصفحة الإضافية توضع بجانب الحقول الموجودة أو أسفل منها.
  • PivotTable.PageFieldWrapCount يحدد عدد حقول الصفحة التي توضع في كل صف أو عمود قبل الالتفاف.
  • PivotTable.PageFields.Move(currIndex, destIndex) يعيد ترتيب حقول الصفحة دون تغيير وضع الترتيب. تستعرض هذه المقالة ثلاثة أمثلة على التعليمات البرمجية توضح كل عملية من هذه العمليات على مجموعة بيانات مشتركة، حتى تتمكن من مقارنة التخطيطات الناتجة جنبًا إلى جنب.

Source Data

الفاكهة السنة المنطقة المبلغ
تفاح 2022 شمال 150
تفاح 2023 شمال 180
موز 2022 جنوب 120
موز 2023 جنوب 140
كرز 2022 شرق 200
كرز 2023 شرق 220
عنب 2022 غرب 90
عنب 2023 غرب 110
يتم ملء جميع الصفوف الثمانية في كل مثال من أمثلة التعليمات البرمجية، بنفس الترتيب، لذا لا تختلف البيانات المصدر بين السيناريوهات — فقط خصائص تخطيط حقل الصفحة هي التي تختلف.

Example 1: Over Then Down

في السيناريو الأول نكوّن حقلي الصفحة (Year وRegion) ليظهروا جنبًا إلى جنب في صف واحد في أعلى الجدول المحوري. نخصص Fruit لمحور الصفوف، ونضع Year أولاً وRegion ثانيًا على محور الصفحة (يحدد ترتيب استدعاءات addFieldToArea الفهرس الابتدائي)، ونضيف Amount (Sum) كحقل بيانات، ثم نضبط PageFieldOrder على PrintOrderType.OVER_THEN_DOWN مع PageFieldWrapCount = 2. مع OVER_THEN_DOWN وعدد التفاف 2، يتم تخطيط حقلي الصفحة أفقيًا جنبًا إلى جنب في صف واحد في أعلى الجدول المحوري، لذا يشغل الشريط صفًا واحدًا بعرض اثنين.

const AsposeCells = require("aspose.cells");
const fs = require("fs");
const path = require("path");
let dataDir = "output";
if (!fs.existsSync(dataDir)) fs.mkdirSync(dataDir, { recursive: true });
let workbook = new AsposeCells.Workbook();
let worksheets = workbook.getWorksheets();
let pivotDataSheet = worksheets.add("PivotData");
let pivotDataCells = pivotDataSheet.getCells();
// Headers (row 0)
pivotDataCells.get(0, 0).putValue("Fruit");
pivotDataCells.get(0, 1).putValue("Year");
pivotDataCells.get(0, 2).putValue("Region");
pivotDataCells.get(0, 3).putValue("Amount");
// Row 1: Apple, 2022, North, 150
pivotDataCells.get(1, 0).putValue("Apple");
pivotDataCells.get(1, 1).putValue(2022);
pivotDataCells.get(1, 2).putValue("North");
pivotDataCells.get(1, 3).putValue(150);
// Row 2: Apple, 2023, North, 180
pivotDataCells.get(2, 0).putValue("Apple");
pivotDataCells.get(2, 1).putValue(2023);
pivotDataCells.get(2, 2).putValue("North");
pivotDataCells.get(2, 3).putValue(180);
// Row 3: Banana, 2022, South, 120
pivotDataCells.get(3, 0).putValue("Banana");
pivotDataCells.get(3, 1).putValue(2022);
pivotDataCells.get(3, 2).putValue("South");
pivotDataCells.get(3, 3).putValue(120);
// Row 4: Banana, 2023, South, 140
pivotDataCells.get(4, 0).putValue("Banana");
pivotDataCells.get(4, 1).putValue(2023);
pivotDataCells.get(4, 2).putValue("South");
pivotDataCells.get(4, 3).putValue(140);
// Row 5: Cherry, 2022, East, 200
pivotDataCells.get(5, 0).putValue("Cherry");
pivotDataCells.get(5, 1).putValue(2022);
pivotDataCells.get(5, 2).putValue("East");
pivotDataCells.get(5, 3).putValue(200);
// Row 6: Cherry, 2023, East, 220
pivotDataCells.get(6, 0).putValue("Cherry");
pivotDataCells.get(6, 1).putValue(2023);
pivotDataCells.get(6, 2).putValue("East");
pivotDataCells.get(6, 3).putValue(220);
// Row 7: Grape, 2022, West, 90
pivotDataCells.get(7, 0).putValue("Grape");
pivotDataCells.get(7, 1).putValue(2022);
pivotDataCells.get(7, 2).putValue("West");
pivotDataCells.get(7, 3).putValue(90);
// Row 8: Grape, 2023, West, 110
pivotDataCells.get(8, 0).putValue("Grape");
pivotDataCells.get(8, 1).putValue(2023);
pivotDataCells.get(8, 2).putValue("West");
pivotDataCells.get(8, 3).putValue(110);
// Add PivotTableReport sheet
let pivotTableSheet = worksheets.add("PivotTableReport");
let pivotTables = pivotTableSheet.getPivotTables();
// Create pivot table sourced from PivotData!A1:D9 placed at A1 on PivotTableReport
let pivotTable = pivotTables.add("PivotData!A1:D9", 0, 0);
// Add fields
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, 0);   // Fruit
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 1);  // Year
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 2);  // Region
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, 3);  // Amount
pivotTable.getDataFields().get(0).setFunction(AsposeCells.ConsolidationFunction.SUM);
// Configure page field area layout: place page fields across first, wrap after every 2
pivotTable.setPageFieldOrder(AsposeCells.PrintOrderType.OVER_THEN_DOWN);
pivotTable.setPageFieldWrapCount(2);
// Refresh and calculate
pivotTable.calculateData();
// Save
workbook.save(path.join(dataDir, "pageFieldLayout_overThenDown.xlsx"));

Example 2: Down Then Over

في هذا المثال نضع Fruit على محور الصفوف، وYear وRegion على محور الصفحة (مع Year أولاً)، وAmount (Sum) كحقل بيانات — تمامًا كما في المثال 1. ثم نضبط PageFieldOrder على PrintOrderType.DOWN_THEN_OVER وPageFieldWrapCount على 2. مع DOWN_THEN_OVER وعدد التفاف 2، يتم تكديس حقلي الصفحة عموديًا — Year في الأعلى، وRegion تحته مباشرة — مما يشكل عمودًا واحدًا في أعلى الجدول المحوري. لذلك يشغل الشريط صفين بعرض واحد، على عكس المثال 1.

const AsposeCells = require("aspose.cells");
var workbook = new AsposeCells.Workbook();
var pivotData = workbook.getWorksheets().get(0);
pivotData.setName("PivotData");
var pivotReport = workbook.getWorksheets().add("PivotTableReport");
var headers = ["Fruit", "Year", "Region", "Amount"];
for (var c = 0; c < headers.length; c++)
{
    pivotData.getCells().get(0, c).putValue(headers[c]);
}
var data = [
    ["Apple", 2022, "North", 150],
    ["Apple", 2023, "North", 180],
    ["Banana", 2022, "South", 120],
    ["Banana", 2023, "South", 140],
    ["Cherry", 2022, "East", 200],
    ["Cherry", 2023, "East", 220],
    ["Grape", 2022, "West", 90],
    ["Grape", 2023, "West", 110]
];
for (var r = 0; r < data.length; r++)
{
    for (var c = 0; c < data[r].length; c++)
    {
        pivotData.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}
var pivotTable = pivotReport.getPivotTables().add("PivotData!A1:D9", 0, 0);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, 0);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 1);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 2);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, 3);
pivotTable.setPageFieldOrder(AsposeCells.PrintOrderType.DOWN_THEN_OVER);
pivotTable.setPageFieldWrapCount(2);
pivotTable.calculateData();
workbook.save("pageFieldLayout_downThenOver.xlsx");

Example 3: Move a Page Field

في السيناريو الثالث نحتفظ بمجموعة البيانات وتخصيص الحقول هذا، ونضبط تخطيطًا محايدًا (OVER_THEN_DOWN مع عدد التفاف 2)، ثم نوضح عملية PageFields.Move. ينقل استدعاء Move(0, 1) حقل الصفحة في الفهرس 0 (Year) إلى الموضع 1، وينتقل حقل الصفحة الذي كان في الموضع 1 (Region) إلى الموضع 0. بعد هذا الاستدعاء، يكون Region هو أول حقل صفحة ويكون Year هو الثاني. يظل وضع الالتفاف والترتيب بدون تغيير، لذا لا يزال الشريط معروضًا أفقيًا جنبًا إلى جنب — فقط تم تبديل ترتيب القائمتين المنسدلتين.

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const dataSheet = workbook.getWorksheets().get(0);
dataSheet.setName("PivotData");
dataSheet.getCells().get("A1").putValue("Fruit");
dataSheet.getCells().get("B1").putValue("Year");
dataSheet.getCells().get("C1").putValue("Region");
dataSheet.getCells().get("D1").putValue("Amount");
dataSheet.getCells().get("A2").putValue("Apple");
dataSheet.getCells().get("B2").putValue(2022);
dataSheet.getCells().get("C2").putValue("North");
dataSheet.getCells().get("D2").putValue(150);
dataSheet.getCells().get("A3").putValue("Apple");
dataSheet.getCells().get("B3").putValue(2023);
dataSheet.getCells().get("C3").putValue("North");
dataSheet.getCells().get("D3").putValue(180);
dataSheet.getCells().get("A4").putValue("Banana");
dataSheet.getCells().get("B4").putValue(2022);
dataSheet.getCells().get("C4").putValue("South");
dataSheet.getCells().get("D4").putValue(120);
dataSheet.getCells().get("A5").putValue("Banana");
dataSheet.getCells().get("B5").putValue(2023);
dataSheet.getCells().get("C5").putValue("South");
dataSheet.getCells().get("D5").putValue(140);
dataSheet.getCells().get("A6").putValue("Cherry");
dataSheet.getCells().get("B6").putValue(2022);
dataSheet.getCells().get("C6").putValue("East");
dataSheet.getCells().get("D6").putValue(200);
dataSheet.getCells().get("A7").putValue("Cherry");
dataSheet.getCells().get("B7").putValue(2023);
dataSheet.getCells().get("C7").putValue("East");
dataSheet.getCells().get("D7").putValue(220);
dataSheet.getCells().get("A8").putValue("Grape");
dataSheet.getCells().get("B8").putValue(2022);
dataSheet.getCells().get("C8").putValue("West");
dataSheet.getCells().get("D8").putValue(90);
dataSheet.getCells().get("A9").putValue("Grape");
dataSheet.getCells().get("B9").putValue(2023);
dataSheet.getCells().get("C9").putValue("West");
dataSheet.getCells().get("D9").putValue(110);
const pivotSheet = workbook.getWorksheets().add("PivotTableReport");
const pivotTable = pivotSheet.getPivotTables().add("PivotData!A1:D9", 2, 0);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, 0);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 1);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.PAGE, 2);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, 3);
pivotTable.setPageFieldOrder(AsposeCells.PrintOrderType.OVER_THEN_DOWN);
pivotTable.setPageFieldWrapCount(2);
pivotTable.getPageFields().move(0, 1);
pivotTable.calculateData();
workbook.save("pageFieldLayout_move.xlsx");