Documentation – إدراج جدول محوري

Pythonnet: تنسيق جدول الدوران

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

مظهر جدول الدوران

كيفية إنشاء جدول دوران يشرح كيفية إنشاء جدول دوران بسيط. يوضح هذا المقال كيفية تخصيص مظهر جدول الدوران عن طريق تعيين مختلف الخصائص:

خيارات تنسيق جدول الدوران
خيارات تنسيق حقول الجدول الدوران
خيارات تنسيق حقل البيانات

كيفية تعيين خيارات تنسيق جدول البيانات المحورية

تتحكم فئة PivotTable في الجدول الدوري الكلي ويمكن تهيئتها بعدة طرق.

كيفية تعيين نوع التنسيق التلقائي

يقدم Microsoft Excel عددًا من تنسيقات التقارير المُعدة مُسبقًا مختلفة. تدعم Aspose.Cells لـ Python via .NET هذه الخيارات التنسيقية أيضًا. للوصول إليها:

قم بتعيين PivotTable.is_auto_format إلى صحيح.
قم بتعيين خيار التنسيق من تعداد PivotTableAutoFormatType .

كيفية تعيين خيارات التنسيق

تُظهر العينة البرمجية أدناه كيفية تنسيق جدول الدوري لإظهار المجاميع الكلية للصفوف والأعمدة، وكيفية تعيين ترتيب حقل التقرير. كما تُظهر العينة أيضًا كيفية تعيين سلسلة مخصصة لقيم خالية.

تنسيق المظهر يدويًا

لتنسيق كيفية ظهور تقرير الجدول المحوري يدويًا، بدلاً من استخدام تنسيقات التقرير المُعدة مسبقًا، استخدم الأساليب PivotTable.format_all(style) و PivotTable.format(row, column, style). أنشئ كائن نمط للتنسيق المطلوب، على سبيل المثال:

كيفية تعيين خيارات تنسيق حقل الجدول المحوري

تمثل فئة PivotField حقلًا في جدول دور ، ويمكن تهيئته بعدة طرق. تُظهر العينة البرمجية أدناه كيفية:

الوصول إلى حقول الصفوف.
ضبط المجاميع الفرعية.
ضبط الترتيب التلقائي.
ضبط الإظهار التلقائي.

كيفية تعيين تنسيق حقول الصف/العمود/الصفحة

كيفية تعيين تنسيق حقول البيانات

تُظهر العينة البرمجية أدناه كيفية تعيين تنسيقات العرض وتنسيق الأرقام لحقول البيانات.

كيفية مسح حقول الجدول المحوري

تحتوي فئة PivotFieldCollection على طريقة تسمى clear() تتيح لك مسح حقول الجدول الدوري. استخدمها عندما ترغب في مسح جميع حقول الجدول الدوري في المناطق، على سبيل المثال، الصفحة، العمود، الصف أو البيانات. يظهر الكود العيني أدناه كيفية مسح جميع حقول الجدول المفصلي في مجال البيانات.

Pythonnet: إنشاء جداول محورية ورسوم بيانية محورية

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

الجدول المحوري هو ملخص تفاعلي للسجلات. على سبيل المثال، قد تحتوي على مئات الإدخالات الخاصة بالفواتير في قائمة داخل صفحة العمل. يمكن للجدول المحوري إجمالي الفواتير حسب العميل، المنتج أو التاريخ. باستخدام مايكروسوفت إكسل يمكن بسرعة إعادة ترتيب المعلومات في الجدول المحوري عن طريق سحب الأزرار إلى موقع جديد.

الرسم البياني المحوري هو تمثيل رسومي تفاعلي للبيانات في الجدول المحوري. تم إدخال الرسوم البيانية المحورية في إكسل 2000. باستخدام الرسم البياني المحوري يصبح أسهل فهم البيانات نظرًا لأن الجدول المحوري يقوم تلقائيًا بإنشاء المجاميع الفرعية والمجاميع.

تدعم Aspose.Cells for Python via .NET جداول الإحاطة و رسومات الإحاطة.

إضافة جداول الإحاطة والرسوم البيانية باستخدام مكتبة Aspose.Cells لـ Python Excel.

توفر Aspose.Cells for Python via .NET مجموعة خاصة من الفصول المستخدمة لإنشاء جداول الإحاطة. تُستخدم هذه الفصول لإنشاء وتعيين كائنات PivotTable، التي تعمل كبنى أساسية لكائن PivotTable:

PivotField، حقل في تقرير جدول محوري.
PivotFields، مجموعة من جميع كائنات PivotField في جدول محوري.
PivotTable، تقرير PivotTable على صفحة العمل.
PivotTables، مجموعة من جميع كائنات PivotTable على صفحة العمل.

الاستعداد لاستخدام Aspose.Cells for Python via .NET

قم بتثبيت Aspose.Cells for Python via .NET من pypi باستخدام الأمر التالي: $ pip install aspose-cells-python.
يمكنك أيضًا اتباع التعليمات خطوة بخطوة حول كيفية تثبيت “Aspose.Cells for Python via .NET” في بيئة التطوير الخاصة بك.

كيفية إضافة جدول محوري باستخدام مكتبة Aspose.Cells for Python Excel

لإنشاء جدول محوري باستخدام Aspose.Cells for Python via .NET:

أضف بعض البيانات إلى خلايا ورق العمل باستخدام طريقة put_value لكائن الخلية. يمكنك أيضًا استخدام ملف قالب مملوء بالفعل بالبيانات. ستُستخدم البيانات كمصدر بيانات الجدول المحوري.
أضف جدول محوري إلى ورقة العمل عن طريق استدعاء طريقة add في مجموعة PivotTables (مغلّفة في كائن الورقة).
الوصول إلى كائن PivotTable الجديد من مجموعة PivotTables عن طريق تمرير الفهرس الخاص به. ثم استخدم أي من كائنات جدول الجدول المحوري المحتوية في كائن PivotTable لإدارة الجدول.

تم إعطاء أمثلة الكود أدناه.

كيفية إضافة رسم بياني محوري باستخدام مكتبة Aspsoe.Cells for Python Excel

لإنشاء PivotChart باستخدام Aspose.Cells for Python via .NET:

أضف رسم بياني.
قم بتعيين PivotSource للرسم البياني للإشارة إلى جدول محوري موجود في جدول البيانات.
قم بتعيين سمات أخرى.

Pythonnet: جدول محوري وبيانات المصدر

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

بيانات المصدر للجدول المحوري

هناك أوقات عندما ترغب في إنشاء تقارير Microsoft Excel باستخدام جداول محورية تأخذ البيانات من مصادر بيانات مختلفة (مثل قاعدة بيانات) غير معروفة في وقت التصميم. يوفر هذا المقال نهجًا لتغيير بيانات مصدر الجدول المحوري بشكل ديناميكي.

تغيير مصدر بيانات الجدول المحوري

إنشاء قالب مصمم جديد.
1. إنشاء ملف قالب مصمم جديد كما في لقطة الشاشة أدناه.
2. ثم تعريف نطاق مسمى، DataSource، الذي يشير إلى هذا النطاق من الخلايا.
  
  إنشاء قالب مصمم وتعريف نطاق مسمى، DataSource

إنشاء جدول محوري بناءً على هذا النطاق المسمى.
1. في Microsoft Excel ، اختر ** البيانات **، ثم ** جدول البيانات المحوري ** و ** تقرير PivotChart **.
2. إنشاء جدول محوري استنادًا إلى المجموعة المسماة التي تم إنشاؤها في الخطوة الأولى.
  
  ** إنشاء جدول محوري استنادًا إلى المجموعة المسماة ، مصدر البيانات **

اسحب الحقل المقابل إلى صف جدول البيانات المحوري والعمود ، ثم قم بإنشاء جدول البيانات المحوري الناتج كما في اللقطة أدناه.

** إنشاء جدول محوري استنادًا إلى حقل مقابل **

انقر بزر الماوس الأيمن على الجدول المحوري وحدد خيارات الجدول.
1. تحقق من ** التحديث عند الفتح ** في إعدادات ** خيارات البيانات **.
  
  ** ضبط خيارات جدول البيانات المحوري **

الآن ، يمكنك حفظ هذا الملف باسم ملف القالب الخاص بالمصمم.

ملء البيانات الجديدة وتغيير بيانات مصدر جدول البيانات المحوري.
1. بمجرد إنشاء قالب المصمم ، استخدم الكود التالي لتغيير بيانات مصدر جدول البيانات المحوري.

تنفيذ الكود المثالي أدناه يغير بيانات مصدر الجدول المحوري.

Pythonnet: إضافة حقل محسوب في جدول الدوران

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

سيناريوهات الاستخدام المحتملة

عند إنشاء جدول دوران استنادًا إلى بيانات معروفة، تجد أن البيانات فيه ليست كما تريد. البيانات التي تريدها هي مجموعة من هذه البيانات الأصلية. على سبيل المثال، قد تحتاج إلى جمع، أو طرح، أو ضرب، وقسمة البيانات الأصلية قبل أن ترغب في البيانات. في هذا الوقت، تحتاج إلى بناء حقل محسوب وتعيين الصيغة المقابلة للحساب. ثم قم بإجراء بعض الإحصائيات والعمليات الأخرى على الحقل المحسوب.

كيفية إضافة حقل محسوب في جدول النفث في إكسل

لإدراج حقل محسوب في جدول دوران في Excel، اتبع الخطوات التالية:

حدد جدول الدوران الذي تريد إضافة حقل محسوب إليه.
انتقل إلى علامة تبويب تحليل جدول الدوران على شريط القوائم.
انقر على “الحقول والعناصر والمجموعات” ثم حدد “حقل محسوب” من القائمة المنسدلة.
في حقل الاسم، أدخل اسمًا للحقل المحسوب.
في حقل “Formula”، ادخل الصيغة للحساب الذي ترغب في القيام به باستخدام أسماء الحقول المحورية المناسبة والعمليات الرياضية.
انقر “موافق” لإنشاء الحقل المحسوب.
سيظهر الحقل المحسوب الجديد في قائمة حقل PivotTable تحت قسم القيم.
اسحب الحقل المحسوب إلى قسم القيم في PivotTable لعرض القيم المحسوبة.

كيفية إضافة حقل محسوب في الجدول المحوري باستخدام Aspose.Cells لمكتبة Excel بلغة Python

إضافة حقل محسوب إلى ملف Excel باستخدام Aspose.Cells للإصدار via .NET بلغة Python. يرجى الاطلاع على الكود المثال التالي. بعد تنفيذ كود النموذج، يتم إضافة جدول محوري بحقل محسوب إلى ورقة العمل.

حدد البيانات الأصلية وأنشئ جدول محوري.
أنشئ الحقل المحسوب وفقًا لحقل PivotField الحالي في الجدول المحوري.
أضف الحقل المحسوب إلى منطقة البيانات.
أخيرًا، يحفظ الدفتر بتنسيق XLSX الناتج.

الكود المثالي

Pythonnet: تحديث الجداول المحورية في Aspose.Cells for Python via .NET

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

يوفّر Aspose.Cells واجهة برمجة تطبيقات للتحديث بشكل متعدد الطبقات تتيح لك إعادة تحميل بيانات الجدول المحوري ضمن أربعة نطاقات مختلفة — من المصنف بأكمله وصولاً إلى جدول محوري واحد. بدءاً من Aspose.Cells for Python via .NET الإصدار v26.7، تم وضع علامة “مهجور” على الطريقة القديمة PivotTable.refresh_data()، ويُستحسن استبدالها بواجهات البرمجة الأكثر كفاءة واعتماداً على ذاكرة التخزين المؤقت الموضحة في هذه المقالة.

مقدمة

نادراً ما تكون عملية تحديث الجدول المحوري عملية واحدة. فخلف الكواليس، يحتفظ Aspose.Cells بسلسلة بيانات متعددة الطبقات تربط بيانات المصدر الأصلية بالقيم المُقدَّمة التي تراها في ورقة العمل. إن فهم هذه السلسلة هو المفتاح لاختيار واجهة برمجة التطبيقات الصحيحة للتحديث في أي موقف. سلسلة البيانات ذات الطبقات الأربع هي:

مصدر البيانات — نطاقات أوراق العمل الأصلية، أو استعلام قاعدة البيانات، أو نطاق الدمج الذي توجد فيه القيم الخام.
PivotCache — لقطة البيانات في الذاكرة. يُبنى كل جدول محوري فوق PivotCache؛ وهنا يتم تجميع كل البيانات وتجميعها.
PivotTable — كائن العرض الذي يعرّف حقول الصفوف والأعمدة والقيم والتصفية. يقرأ PivotTable فقط من PivotCache الخاص به، ولا يقرأ أبداً مباشرةً من مصدر البيانات.
Cells — مجموعة Cells الخاصة بورقة العمل، حيث يعرض PivotTable قيمه وأنماطه المحسوبة فيها. من المفاهيم المهمة بشكل خاص مفهوم ذاكرة التخزين المؤقت المشتركة. عندما تشير جداول محورية متعددة في المصنف إلى نطاق المصدر نفسه، فإنها تتشارك PivotCache واحداً فقط. يمكن لـ PivotCache واحد أن تشير إليه جداول محورية عديدة، وإن تحديث ذاكرة التخزين المؤقت تلك يُحدث جميع PivotTable المعتمدة عليها دفعةً واحدة.
يشير PivotCache.source_type (وهو من النوع المعدود PivotTableSourceType) إلى مصدر بيانات ذاكرة التخزين المؤقت. اعتباراً من الإصدار v26.7، تدعم PivotCache.refresh() فقط نوعَي المصادر Sheet و Consolidation — أي البيانات الموجودة في نطاقات أوراق العمل. أما المصادر الخارجية (قواعد البيانات، الاتصالات الخارجية، إلخ) فلا يمكن تحديثها بعد من خلال واجهة برمجة التطبيقات المتعلقة بذاكرة التخزين المؤقت.
نظراً لهذه السلسلة، يوجد مسارا تحديث أساسيان في Aspose.Cells:

PivotCache.refresh() — يعيد تحميل البيانات من المصدر إلى ذاكرة التخزين المؤقت ثم يعيد حساب جميع PivotTable المعتمدة عليها في عملية واحدة.
PivotTable.calculate_data() — يعيد حساب عرض PivotTable واحد من البيانات المخزّنة مؤقتاً بالفعل، دون الحاجة إلى الرجوع إلى مصدر البيانات. تستخدم جميع السيناريوهات في هذه المقالة بيانات مصدر موجودة في خلايا أوراق العمل، لذا فإن نوع المصدر هو Sheet وتعمل عمليات التحديث كما هو موضح.

الاستيرادات المطلوبة

تبدأ جميع أمثلة Python في هذه المقالة بعبارات الاستيراد الثلاث التالية لأن أنواع الجداول المحورية تعيش في فضاء الأسماء aspose.cells.pivot:

تحديث جميع الجداول المحورية في المصنف

عندما تحتاج إلى ضمان أن تعكس كل ذاكرة تخزين مؤقت وكل جدول محوري في المصنف أحدث بيانات المصدر، فإن أبسط واجهة برمجة تطبيقات وأكثرها شمولاً هي Workbook.refresh_all(). يتجاوز هذا الاستدعاء الواحد المصنف بأكمله — حيث تحدّث كل PivotCache من مصدره ثم تعيد حساب كل PivotTable المعتمدة عليه. هذه هي الطريقة الموصى بها للتحديثات العامة والشاملة للمستند عندما لا يكون الأداء مقلقاً. يُنشئ المثال التالي مصنفاً بنطاق مصدر Fruit/Year/Amount، ويُنشئ جدولاً محورياً واحداً، ويُعدّل بعض قيم المصدر، ثم يستخدم refresh_all() لجلب كل شيء حتى أحدث إصدار في استدعاء واحد.

import sys
import aspose.cells as ac

# إنشاء مصنف جديد
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# كتابة صف الرأس في الخلايا A1:C1
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# كتابة صفوف البيانات في الخلايا A2:C9 (8 صفوف من بيانات الفواكه عبر عامي 2020 و2021)
worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(50)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(60)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(70)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(80)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(90)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(100)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(110)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(120)

# إضافة جدول محوري: نطاق المصدر "A1:C9"، خلية الوجهة "E3"، الاسم "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# تعيين حقول الجدول المحوري: الفاكهة إلى الصفوف، السنة إلى الأعمدة، المبلغ إلى البيانات
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# تعديل عدة قيم للمبلغ في بيانات المصدر لمحاكاة التغييرات
worksheet.cells["C2"].put_value(55)
worksheet.cells["C5"].put_value(85)
worksheet.cells["C9"].put_value(125)

# تحديث كل جدول محوري / ذاكرة التخزين المؤقت للجدول المحوري في المصنف
workbook.refresh_all()

# حفظ المصنف
workbook.save("output.xlsx")

تحديث جميع الجداول المحورية على ورقة عمل واحدة

في بعض الأحيان، تحتاج فقط إلى تحديث الجداول المحورية الموجودة على ورقة عمل واحدة محددة — على سبيل المثال، عندما تعرف أن الجداول المحورية الموجودة على أوراق العمل الأخرى غير ذات صلة ولا ينبغي لمسها. لهذه الحالة، يوفّر Aspose.Cells واجهة Worksheet.refresh_pivot_tables()، وهي محصورة بنسخة Worksheet واحدة. تكون هذه الواجهة أكثر انتقائية من Workbook.refresh_all(): إذ يتم تحديث الجداول المحورية الموجودة على ورقة العمل المستهدفة فقط، مع ترك أي جداول محورية على أوراق عمل أخرى دون تغيير. يملأ المثال التالي نفس بيانات المصدر Fruit/Year/Amount، ويُضيف جدولاً محورياً على ورقة العمل الأولى، ويُعدّل بعض قيم المصدر، ثم يحدث فقط الجداول المحورية الموجودة على تلك الورقة.

import sys
import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2021)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2021)
worksheet.cells["C5"].put_value(120)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(180)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2020)
worksheet.cells["C7"].put_value(130)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(220)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2020)
worksheet.cells["C9"].put_value(140)

pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

worksheet.cells["C2"].put_value(300)
worksheet.cells["C5"].put_value(250)
worksheet.cells["C9"].put_value(400)

worksheet.refresh_pivot_tables()

workbook.save("output.xlsx")

تحديث جدول محوري واحد

عندما تريد التحكم الدقيق في جدول محوري واحد، تتيح لك واجهة البرمجة المعتمدة على ذاكرة التخزين المؤقت خيارين. يعتمد الاختيار بينهما على ما تغيّر فعلاً: بيانات المصدر الأساسية، أم مجرد إعدادات العرض/التخطيط للجدول المحوري نفسه.

تغيّرت بيانات المصدر — استخدم `PivotCache.refresh()`

إذا تغيّرت بيانات المصدر الأساسية، فإن نقطة الدخول الصحيحة هي pivot_table.pivot_cache.refresh(). تعيد هذه الاستدعاء قراءة بيانات المصدر إلى ذاكرة التخزين المؤقت ثم تعيد حساب كل PivotTable تعتمد على ذاكرة التخزين المؤقت تلك.

نظراً لأن الجداول المحورية تتشارك نسخة واحدة من PivotCache، فإن استدعاء PivotCache.refresh() يعيد حساب جميع الجداول المحورية المبنية على ذاكرة التخزين المؤقت نفسها — وليس فقط الجدول الذي تشير إليه. إذا كان هناك جدولان محوريان يتشاركان في نطاق المصدر نفسه، فإن تحديث ذاكرة تخزين مؤقت واحدة يُحدث كليهما.

يُنشئ المثال التالي جدولين محوريين على نطاق المصدر نفسه لتوضيح سلوك ذاكرة التخزين المؤقت المشتركة، ويُعدّل بعض قيم المصدر، ثم يحدث من خلال مرجع ذاكرة تخزين مؤقت واحد.

import sys
import aspose.cells as ac

# إنشاء مصنف جديد والوصول إلى ورقة العمل الأولى
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# كتابة صف العناوين: الفاكهة / السنة / المبلغ
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# كتابة حوالي 9 صفوف بيانات (عنب / توت أزرق / كيوي / كرز عبر 2020-2021)
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

# إضافة جدول محوري أول "Pivot1" مثبت في الخلية E3، نطاق المصدر A1:C9
pivotIndex1 = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivotTable1 = worksheet.pivot_tables[pivotIndex1]

# تعيين الحقول لـ Pivot1
pivotTable1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# إضافة جدول محوري ثانٍ "Pivot2" مثبت في E15 باستخدام نفس نطاق المصدر A1:C9
# كل من Pivot1 و Pivot2 يتشاركان PivotCache واحد لأن نطاق المصدر متطابق.
pivotIndex2 = worksheet.pivot_tables.add("A1:C9", "E15", "Pivot2")
pivotTable2 = worksheet.pivot_tables[pivotIndex2]

# تعيين نفس الحقول لـ Pivot2
pivotTable2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# تعديل عدة قيم لخلايا المبلغ في بيانات المصدر لمحاكاة تغيير البيانات
worksheet.cells["C2"].put_value(150)
worksheet.cells["C4"].put_value(350)
worksheet.cells["C7"].put_value(650)

# تحديث PivotCache المشترك.
# نظرًا لأن Pivot1 و Pivot2 يتشاركان نفس PivotCache، فإن هذا الاستدعاء الواحد
# يقوم بتحديث كلا الجدولين المحوريين (البيانات + النمط) من المصدر المحدّث.
pivotTable1.pivot_cache.refresh()

# حفظ المصنف
workbook.save("output.xlsx")

تغيّر العرض/التخطيط فقط — استخدم `calculate_data()`

إذا لم تتغيّر بيانات المصدر ولكن تغيّرت إعدادات العرض أو التخطيط للجدول المحوري فقط (على سبيل المثال، تم نقل حقل إلى منطقة مختلفة، أو تم تبديل إعداد التحديث عند الفتح)، فلا توجد حاجة للرجوع إلى مصدر البيانات. تحتوي ذاكرة التخزين المؤقت بالفعل على البيانات الصحيحة؛ يحتاج فقط PivotTable المعروض إلى إعادة حساب. في هذه الحالة، تكون pivot_table.calculate_data() هي الخيار الصحيح. يتجنّب ذلك الجلب غير الضروري من المصدر وهو أسرع بكثير عندما تتشارك جداول محورية عديدة في ذاكرة التخزين المؤقت نفسها. يُعدّل المثال التالي خاصية غير مصدرية للجدول المحوري ثم يستدعي calculate_data() لإعادة عرضه من ذاكرة التخزين المؤقت الموجودة.

import sys
import aspose.cells as ac
import aspose.cells.pivot as acp

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# كتابة صف العناوين: الفاكهة / السنة / المبلغ
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# كتابة 8 صفوف من البيانات (الصفوف 2-9، تتطابق مع نطاق المصدر A1:C9)
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(150)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(250)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(350)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(450)

# إضافة جدول محوري باسم "Pivot1" موضوع في خلية الوجهة E3، مصدره من A1:C9
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# تعيين الحقول: الفاكهة إلى الصف، السنة إلى العمود، المبلغ إلى البيانات
pivot_table.add_field_to_area(acp.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(acp.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(acp.PivotFieldType.DATA, "Amount")

# تعديل خاصية عرض/تخطيط — هذا تغيير للعرض فقط،
# لذلك لا يتطلب إعادة قراءة بيانات المصدر من خلال PivotCache.Refresh().
pivot_table.refresh_data_on_opening_file = False

# CalculateData() يعيد عرض جدولنا المحوري هذا (البيانات + النمط) من
# البيانات الموجودة بالفعل في PivotCache. ولأن بيانات المصدر لم تتغير،
# لا يتم تنفيذ رحلة دائرية إلى المصدر — فقط القيم المخزنة مؤقتًا يتم إعادة حسابها
# في خلايا ورقة العمل.
pivot_table.calculate_data()

# حفظ المصنف على القرص
workbook.save("output.xlsx")

الحصول على جميع الجداول المحورية التي تشترك في نفس PivotCache

غالباً ما يحتوي المصنف على جداول محورية عديدة جميعها مبنية فوق ذاكرة تخزين مؤقت مشتركة واحدة. لتعدادها — على سبيل المثال، قبل إجراء تحديث دفعي، أو لتشخيص تأثير ذاكرة التخزين المؤقت المشتركة — استخدم PivotCache.get_pivot_tables(). تُرجع هذه الطريقة مجموعة كل PivotTable التي تعتمد على ذاكرة التخزين المؤقت المعطاة. هذه هي أيضاً الطريقة الأكثر مباشرة للتأكد من أن جدولين محوريين يتشاركان فعلاً في نفس نسخة PivotCache: يمكنك مقارنة مراجع ذاكرة التخزين المؤقت، أو ببساطة تكرار المجموعة التي تُرجعها get_pivot_tables() ولاحظة أي الجداول المحورية تظهر فيها. يُنشئ المثال التالي جدولين محوريين على نطاق المصدر نفسه، ويتحقق من أنهما يتشاركان نسخة ذاكرة التخزين المؤقت نفسها، ثم يعدّد الجداول المحورية لذاكرة التخزين المؤقت تلك.

الانتقال من `PivotTable.refresh_data()` المهجورة

قبل Aspose.Cells for Python via .NET الإصدار v26.7، كانت الطريقة المعيارية لتحديث جدول محوري هي استدعاء PivotTable.refresh_data() على كل جدول محوري على حدة. اعتباراً من الإصدار v26.7، تم وضع علامة مهجور على هذه الطريقة، ويجب استبدالها بواجهات البرمجة المعتمدة على ذاكرة التخزين المؤقت الموضحة أعلاه. هناك سببان يجعلان نهج refresh_data() لكل جدول على حدة إشكالياً في المصنفات الواقعية:

يعيد جلب البيانات من المصدر في كل مرة يُستدعى فيها، حتى عندما لا يتغيّر المصدر.
كل استدعاء يُحدث ذاكرة التخزين المؤقت المشتركة بأكملها. عندما تتشارك جداول محورية عديدة في ذاكرة تخزين مؤقت واحدة، فإن استدعاء refresh_data() بشكل متكرر لكل جدول محوري يتسبب في إعادة جلب نفس ذاكرة التخزين المؤقت مراراً وتكراراً، وهو بطيء جداً. البدائل الموصى بها هي:
لتحديث جميع الجداول المحورية في المصنف ← استخدم workbook.refresh_all();
لتحديث بعضها ← استخدم pivot_table.pivot_cache.refresh(); لذاكرة تخزين مؤقت واحدة. ولأن ذاكرة التخزين المؤقت مشتركة، فإن هذا الاستدعاء الواحد يُحدث كل جدول محوري مبني فوق ذاكرة التخزين المؤقت تلك. أما الجداول المحورية الأخرى التي تجلس فوق ذاكرة تخزين مؤقت تم تحديثها بالفعل فيمكن تخطيها بأمان.
في حالة تغيّر عرض/تخطيط الجدول المحوري فقط ← استخدم pivot_table.calculate_data(); لإعادة العرض من ذاكرة التخزين المؤقت الموجودة دون أي رحلة إلى المصدر. يوضّح المثال التالي النمط الفعّال الجديد للمصنفات ذات الجداول المحورية المتعددة التي تشترك في ذاكرة تخزين مؤقت واحدة.

import sys
import aspose.cells as ac

# إنشاء مصنف جديد والوصول إلى ورقة العمل الأولى
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# --- بناء بيانات المصدر: الفاكهة / السنة / المبلغ (الترويسة + 9 صفوف) ---
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

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

# --- إضافة الجدول المحوري الأول (Pivot1) في خلية الوجهة E3 ---
idx1 = sheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table1 = sheet.pivot_tables[idx1]
pivot_table1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- إضافة الجدول المحوري الثاني (Pivot2) على نفس نطاق المصدر ---
# يتشارك كل من Pivot1 و Pivot2 ذاكرة تخزين مؤقت محورية واحدة أساسية.
# هذا هو بالضبط السيناريو الذي يصبح فيه نهج RefreshData() القديم لكل جدول
# غير فعال: تحديث جدول واحد يعيد جلب كامل ذاكرة التخزين المؤقت المشتركة،
# لذا فإن تحديث عدد N من الجداول يقوم بنفس الجلب المكلف عدد N من المرات.
idx2 = sheet.pivot_tables.add("A1:C9", "E15", "Pivot2")
pivot_table2 = sheet.pivot_tables[idx2]
pivot_table2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- تعديل عدة قيم في المبلغ في بيانات المصدر ---
sheet.cells["C2"].put_value(5000)   # عنب  2020
sheet.cells["C5"].put_value(7500)   # كرز 2020
sheet.cells["C9"].put_value(9500)   # كرز 2021

# --- النمط القديم (قبل 26.7) — PivotTable.RefreshData() ---
# pivot_table1.refresh_data();  # يعيد الجلب من المصدر، ويحدّث كامل ذاكرة التخزين المؤقت
# pivot_table2.refresh_data();  # يعيد الجلب مرة أخرى — ذاكرة التخزين المؤقت جديدة بالفعل!
# كل استدعاء يعيد بناء ذاكرة التخزين المؤقت المشتركة، لذا N جداول = N من عمليات الجلب المكررة.

# --- النمط الجديد في الإصدار 26.7+: حدّث ذاكرة التخزين المؤقت مرة واحدة، ثم أعد العرض حسب الحاجة ---
# استدعاء واحد لـ PivotCache.Refresh() يسحب القيم المعدلة إلى ذاكرة التخزين المؤقت
# المشتركة ويعيد حساب عرض كل جدول محوري يشير إليها.
# نظراً لأن Pivot1 و Pivot2 يتشاركان ذاكرة تخزين مؤقت محورية واحدة، فإن هذا
# الاستدعاء الواحد يحدّث كلا الجدولين — لا حاجة إلى رحلة ذهاب وإياب ثانية للمصدر.
pivot_table1.pivot_cache.refresh()

# CalculateData() يعيد عرض الجدول المحوري فقط (البيانات + النمط) من البيانات
# الموجودة بالفعل في ذاكرة التخزين المؤقت — ولا يلمس المصدر.
# نستدعيها على Pivot2 هنا فقط لتوضيح الواجهة البرمجية: بعد أن تم تحديث
# ذاكرة التخزين المؤقت مرة واحدة، يمكن إعادة عرض أي جدول تابع دون العودة
# إلى المصدر. استخدم CalculateData() بمفردها عندما يكون قد تغير فقط
# إعدادات عرض/تخطيط الجدول المحوري وذاكرة التخزين المؤقت حالية.
pivot_table2.calculate_data()

workbook.save("output.xlsx")

أي واجهة برمجة تحديث يجب أن أستخدم؟

يلخص الجدول التالي واجهات برمجة التطبيقات المتاحة للتحديث ومتى تختار كل منها.

الهدف	واجهة برمجة التطبيقات الموصى بها	ملاحظات
تحديث كل شيء في المصنف	`Workbook.refresh_all()`	استدعاء واحد؛ يغطي جميع ذاكرات التخزين المؤقت والجداول.
تحديث الجداول المحورية على ورقة واحدة فقط	`Worksheet.refresh_pivot_tables()`	محصور بورقة عمل واحدة.
تغيّرت بيانات المصدر لذاكرة تخزين مؤقت واحدة	`pivot_table.pivot_cache.refresh()`	يحدث جميع الجداول المحورية على ذاكرة التخزين المؤقت المشتركة تلك.
تغيّرت إعدادات العرض/التخطيط فقط	`pivot_table.calculate_data()`	يتجنب الرحلة غير الضرورية إلى المصدر.
سرد جميع الجداول المحورية على ذاكرة تخزين مؤقت مشتركة	`pivot_cache.get_pivot_tables()`	يُستخدم للتعداد قبل التحديث المجمع.
عملياً، يُفضّل استخدام واجهات البرمجة المعتمدة على ذاكرة التخزين المؤقت بدلاً من `refresh_data()` القديمة لكل جدول على حدة. فهي تدرك ذاكرات التخزين المؤقت المشتركة، وتتجنب عمليات الجلب المتكررة من المصدر، وتتيح لك اختيار أصغر نطاق يلبي متطلبات التحديث لديك.

Pythonnet: تطبيق الأنماط على الجداول المحورية في Aspose.Cells لـ .NET

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

يدعم Aspose.Cells تطبيق كل من التنسيقات التلقائية القديمة للجداول المحورية (المخصصة لملفات .xls) وأنماط الجداول المحورية الحديثة المسماة أو المخصصة (المخصصة لملفات .xlsx و .xlsm و .xlsb). تعتمد واجهة برمجة التطبيقات التي يجب استدعاؤها على تنسيق الملف الذي يتم حفظ المصنف به، وليس على التنسيق الذي تم تحميله منه.

مقدمة

يكشف Aspose.Cells عن واجهتي برمجة تطبيقات متوازيتين للأنماط الخاصة بالجداول المحورية. يعتمد الاختيار بينهما على تنسيق الملف الذي تحفظ المصنف به، وليس على التنسيق الذي تقرأه منه. يمكن إعادة حفظ المصنف المحمّل من ملف .xls بصيغة .xlsx، وفي هذه الحالة يتم تطبيق واجهة برمجة التطبيقات للأنماط الحديثة بدلاً من القديمة.

لمخرجات .xls القديمة، استخدم خاصية PivotTable.auto_format_type مع تعداد aspose.cells.pivot.PivotTableAutoFormatType. تتوافق واجهة برمجة التطبيقات هذه مع منتقي التنسيق التلقائي الذي كان يوفره Excel الكلاسيكي للجداول المحورية.

لمخرجات .xlsx و .xlsm و .xlsb الحديثة، يتوفر نوعان من واجهات برمجة التطبيقات للأنماط:

PivotTable.pivot_table_style_type يحدد أحد الأنماط المسماة المضمنة (سمات فاتحة وداكنة، بما في ذلك الأنماط المضافة في Excel 2017). هذه الإعدادات المسبقة للقراءة فقط.
PivotTable.pivot_table_style_name يحدد نمطًا مخصصًا تحدده بنفسك من خلال workbook.worksheets.table_styles.add_pivot_table_style(...). الأنماط المخصصة مطلوبة كلما أردت تعديل الألوان أو الحدود أو الخطوط بخلاف ما تقدمه الإعدادات المسبقة.

بالإضافة إلى ذلك، يعد PivotTable.format_all(Style) اختصارًا يطبق كائن Style واحدًا على كل خلية من خلايا الجدول المحوري، متجاوزًا أي شيء يتم تعيينه من خلال أي من واجهتي برمجة التطبيقات لاسم النمط أعلاه. يكون هذا مفيدًا عندما يكون المظهر الموحد مطلوبًا بغض النظر عن السمة الأساسية.

تطبيق تنسيق تلقائي مسبق للـ XLS القديم

يقبل PivotTable.auto_format_type قيمة من تعداد aspose.cells.pivot.PivotTableAutoFormatType. القيم المتاحة هي REPORT_1 إلى REPORT_10، و CLASSIC، و TABLE_1 إلى TABLE_10.

لا يتم الالتزام بـ auto_format_type إلا عند حفظ المصنف بصيغة .xls. عندما يتم حفظ نفس المصنف بصيغة .xlsx أو .xlsm أو .xlsb، يتجاهل Excel هذه الخاصية ويعود إلى إعدادات pivot_table_style_type و pivot_table_style_name.

يحمل المثال التالي مصنفًا جديدًا، ويملأ بيانات العينة Fruit/Year/Amount، ويضيف جدولًا محوريًا، ويطبق PivotTableAutoFormatType.REPORT_5، ويحفظ النتيجة بصيغة .xls.

لماذا لا توجد حقول أعمدة؟ تم تصميم التنسيقات التلقائية من سلسلة Report (Report1 إلى Report10، Table1 إلى Table10) في Excel الكلاسيكي لـ جداول محورية أحادية البُعد تحتوي على حقول صفوف وقيم فقط — وليس لديها تنسيق مدمج لرؤوس حقول الأعمدة. إذا احتاج الجدول المحوري إلى حقول أعمدة، فاستخدم الإعدادات المسبقة الحديثة PivotTableStyleType من السيناريو 2 أدناه بدلاً من ذلك، وهي مصممة للتخطيط ثنائي الأبعاد الذي يستخدمه Excel الحديث.

import aspose.cells as ac

# السيناريو 1: تطبيق تنسيق تلقائي مسبق الإعداد من XLS القديم
# واجهة برمجة التطبيقات المستخدمة: PivotTable.AutoFormatType
# تنسيق الملف المستهدف: .xls (قديم)
# للحصول على أمثلة كاملة وملفات البيانات، يرجى الذهاب إلى https://github.com/aspose-cells/Aspose.Cells-for-.NET

# إنشاء مصنف جديد
workbook = ac.Workbook()

# الحصول على ورقة العمل الأولى
sheet = workbook.worksheets[0]

# تعبئة البيانات المصدرية بصف الرأس (فاكهة، سنة، مبلغ)
# و 9 صفوف بيانات تغطي العنب، التوت الأزرق، الكيوي، الكرز عبر 2020 و 2021
sheet.cells[0, 0].put_value("Fruit")
sheet.cells[0, 1].put_value("Year")
sheet.cells[0, 2].put_value("Amount")

sheet.cells[1, 0].put_value("grape")
sheet.cells[1, 1].put_value(2020)
sheet.cells[1, 2].put_value(50)

sheet.cells[2, 0].put_value("blueberry")
sheet.cells[2, 1].put_value(2020)
sheet.cells[2, 2].put_value(30)

sheet.cells[3, 0].put_value("kiwi")
sheet.cells[3, 1].put_value(2020)
sheet.cells[3, 2].put_value(25)

sheet.cells[4, 0].put_value("cherry")
sheet.cells[4, 1].put_value(2020)
sheet.cells[4, 2].put_value(40)

sheet.cells[5, 0].put_value("grape")
sheet.cells[5, 1].put_value(2021)
sheet.cells[5, 2].put_value(60)

sheet.cells[6, 0].put_value("blueberry")
sheet.cells[6, 1].put_value(2021)
sheet.cells[6, 2].put_value(35)

sheet.cells[7, 0].put_value("kiwi")
sheet.cells[7, 1].put_value(2021)
sheet.cells[7, 2].put_value(28)

sheet.cells[8, 0].put_value("cherry")
sheet.cells[8, 1].put_value(2021)
sheet.cells[8, 2].put_value(45)

sheet.cells[9, 0].put_value("grape")
sheet.cells[9, 1].put_value(2020)
sheet.cells[9, 2].put_value(45)

# إضافة جدول محوري في خلية الوجهة E3، باسم "Pivot1"، باستخدام نطاق المصدر A1:C10
pivot_index = sheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = sheet.pivot_tables[pivot_index]

# تعيين الحقول: الفاكهة -> الصفوف، السنة -> الأعمدة، المبلغ -> البيانات
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# تطبيق التنسيق التلقائي المسبق الإعداد لـ XLS القديم "Report5"
# ملاحظة: هذه الخاصية ذات معنى فقط عند الحفظ بصيغة .xls.
# عند الحفظ بصيغة .xlsx/.xlsm/.xlsb، يتجاهل Excel AutoFormatType
# ويستخدم ما يحدده PivotTableStyleType / PivotTableStyleName.
pivot_table.auto_format_type = ac.PivotTableAutoFormatType.REPORT5

# حفظ المصنف بتنسيق .xls القديم
workbook.save("output.xls")

تطبيق نمط جدول محوري مسمى مسبق حديث

يقبل PivotTable.pivot_table_style_type قيمة من تعداد aspose.cells.PivotTableStyleType. يغطي التعداد السمات الفاتحة PIVOT_TABLE_STYLE_LIGHT_1 إلى PIVOT_TABLE_STYLE_LIGHT_28 والسمات الداكنة PIVOT_TABLE_STYLE_DARK_1 إلى PIVOT_TABLE_STYLE_DARK_28. يمكن الوصول إلى الأنماط المضافة في Excel 2017 (الموجة الثانية من السمات الفاتحة والداكنة) من خلال نفس التعداد.

هذه هي واجهة برمجة التطبيقات الموصى بها لأي تنسيق ملف حديث. على عكس التنسيق التلقائي القديم، يتم عرض النمط المحدد هنا بشكل دقيق بواسطة Excel ويظل ثابتًا بعد عمليات الحفظ والتحميل عبر أدوات Office الأخرى.

يستخدم المثال التالي نفس بيانات Fruit/Year/Amount، وينشئ جدولًا محوريًا مطابقًا، ويطبق PIVOT_TABLE_STYLE_DARK_1، ويحفظ المصنف بصيغة .xlsx.

import aspose.cells as ac

# السيناريو 2: تطبيق نمط جاهز مسمى حديث من Excel 2007+ باستخدام PivotTableStyleType.
# تنسيق الملف المستهدف: .xlsx. يوجد تعداد PivotTableStyleType في مساحة الاسم Aspose.Cells
# (وليس في Aspose.Cells.Pivot) — لهذا السبب لا نحتاج إلى أي توجيه using إضافي له.
# مرجع GitHub: https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# صف العناوين: الفاكهة / السنة / المبلغ
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# 9 صفوف بيانات من الفاكهة / السنة / المبلغ
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(180)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(120)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(170)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(210)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(190)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(130)

# إضافة جدول محوري في E3 باسم "Pivot1"، مصدره من A1:C10
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# تعيين حقول الجدول المحوري: الفاكهة -> منطقة الصفوف، السنة -> منطقة الأعمدة، المبلغ -> منطقة البيانات
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Column, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")

# تطبيق نمط جدول محوري جاهز مسمى حديث من Excel 2007+.
# PivotTableStyleType هي واجهة برمجة التطبيقات الصحيحة لملفات .xlsx / .xlsm / .xlsb؛ AutoFormatType
# يتم تجاهلها بواسطة Excel لتلك التنسيقات. ينتمي PivotTableStyleDark1 إلى عائلة النمط الداكن
# (PivotTableStyleDark1..PivotTableStyleDark28)، ويكشف نفس التعداد أيضًا عن
# سمات Excel 2017 الأحدث فاتحة/داكنة (PivotTableStyleLight1..Light28 / Dark1..Dark28).
pivot_table.pivot_table_style_type = ac.PivotTableStyleType.PivotTableStyleDark1

# حفظ كملف .xlsx حديث — هذا هو التنسيق الذي يكون PivotTableStyleType ذا معنى له.
workbook.save("output.xlsx")

تعريف وتطبيق نمط جدول محوري مخصص

لا يمكن تعديل الإعدادات المسبقة المضمنة. كلما احتجت إلى تجاوز الألوان أو الحدود أو الخطوط، يجب عليك تعريف نمط جدول محوري مخصص. تتكون سير العمل من ثلاث خطوات:

أضف نمطًا مخصصًا إلى مجموعة table_styles في المصنف عبر workbook.worksheets.table_styles.add_pivot_table_style(name). يُرجع هذا فهرس النمط الذي تم إنشاؤه حديثًا.
قم بتكوين النمط عن طريق إضافة عناصر (مثل WHOLE_TABLE أو GRAND_TOTAL_ROW) من خلال table_style.table_style_elements.add(TableStyleElementType)، ثم تعيين Style لكل عنصر عبر table_style_element.set_element_style(Style).
طبق النمط المخصص على الجدول المحوري عن طريق تعيين PivotTable.pivot_table_style_name على اسم النمط. لا تستخدم pivot_table_style_type هنا، حيث تحدد هذه الخاصية الإعدادات المسبقة المضمنة.

pivot_table_style_name و pivot_table_style_type غير قابلين للتبادل. استخدم pivot_table_style_type للإعدادات المسبقة المضمنة، واستخدم pivot_table_style_name للأنماط المخصصة التي حددتها من خلال add_pivot_table_style. تعيين كليهما غير ضار، ولكن يتم عرض فقط ذلك الذي يطابق المصدر المقصود.

تتضمن قيم TableStyleElementType المتاحة WHOLE_TABLE و FIRST_ROW و LAST_ROW و FIRST_COLUMN و LAST_COLUMN و GRAND_TOTAL_ROW و GRAND_TOTAL_COLUMN و PAGE_FIELD_LABELS و PAGE_FIELD_VALUES.

يحدد المثال التالي نمط جدول محوري مخصص بحد أسود رفيع على WHOLE_TABLE وخط أحمر عريض على GRAND_TOTAL_ROW، ثم يطبقه عبر pivot_table_style_name ويحفظ بصيغة .xlsx.

import aspose.cells as ac
import System.Drawing

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# تعبئة البيانات المصدرية: صف الرأس + 9 صفوف بيانات (A1:C10)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(900)

# إضافة جدول محوري مصدره A1:C10، مثبت عند E3، باسم "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# الخطوة 1: تسجيل نمط جدول محوري مخصص جديد والتقاط فهرسه
style_index = workbook.worksheets.table_styles.add_pivot_table_style("CustomPivotStyle")
table_style = workbook.worksheets.table_styles[style_index]

# الخطوة 2: إضافة عنصر WholeTable وتطبيق حدود سوداء رفيعة على الجوانب الأربعة
whole_table_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.WHOLE_TABLE)
whole_table_element = table_style.table_style_elements[whole_table_element_index]
whole_table_style = workbook.create_style()
whole_table_style.borders[ac.BorderType.TOP_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.TOP_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.LEFT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.LEFT_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].color = System.Drawing.Color.Black
whole_table_element.set_element_style(whole_table_style)

# الخطوة 3: إضافة عنصر GrandTotalRow وتطبيق خط أحمر غامق
grand_total_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.GRAND_TOTAL_ROW)
grand_total_element = table_style.table_style_elements[grand_total_element_index]
grand_total_style = workbook.create_style()
grand_total_style.font.is_bold = True
grand_total_style.font.color = System.Drawing.Color.Red
grand_total_element.set_element_style(grand_total_style)

# الخطوة 4: تطبيق النمط المخصص بالاسم (وليس بواسطة PivotTableStyleType، الذي يُستخدم للإعدادات المسبقة المضمنة)
pivot_table.pivot_table_style_name = "CustomPivotStyle"

workbook.save("output.xlsx")

تطبيق نمط واحد على كل خلية من خلايا الجدول المحوري باستخدام FormatAll

PivotTable.format_all(Style) هو اختصار يطبق كائن Style واحدًا على كل خلية من خلايا الجدول المحوري، بما في ذلك منطقة البيانات ورؤوس الصفوف والأعمدة والإجماليات. يتم تجاوز أي شيء تم تعيينه مسبقًا من خلال pivot_table_style_type أو pivot_table_style_name.

يتجاوز format_all كلًا من pivot_table_style_type و pivot_table_style_name. استخدمه فقط عندما يكون المظهر الموحد المستقل عن السمة مطلوبًا عبر الجدول المحوري بأكمله.

ينشئ المثال التالي Style بتعبئة صلبة صفراء وخط أزرق داكن عريض وحدود سوداء رفيعة على جميع الجوانب، ثم يطبقه باستخدام format_all ويحفظ بصيغة .xlsx.

from System.Drawing import Color
import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
from aspose.cells import BackgroundType, CellBorderType, BorderType

# السيناريو 4: تطبيق نمط واحد على كل خلية من خلايا الجدول المحوري باستخدام FormatAll
# واجهة برمجة التطبيقات المستخدمة: PivotTable.FormatAll(Style)
# تنسيق الهدف: .xlsx
# مرجع GitHub: راجع مستودع Aspose.Cells-for-.NET — أمثلة تنسيق الجدول المحوري

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# تعبئة البيانات المصدرية: صف الرأس (الصف 1) + 9 صفوف بيانات (الصفوف 2-10)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(5000)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(3000)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(4000)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(2000)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(6000)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(3500)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(4500)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(2500)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(5500)

# إضافة جدول محوري: نطاق المصدر A1:C10، خلية الوجهة E3، الاسم "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# تعيين حقول الجدول المحوري: Fruit -> منطقة الصفوف، Year -> منطقة الأعمدة، Amount -> منطقة البيانات
pivot_table.add_field_to_area(PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")

# إنشاء نمط سيتم فرضه على كل خلية من خلايا الجدول المحوري
style = workbook.create_style()
style.foreground_color = Color.Yellow
style.pattern = BackgroundType.SOLID
style.font.is_bold = True
style.font.color = Color.DarkBlue
style.borders[BorderType.TOP_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.TOP_BORDER].color = Color.Black
style.borders[BorderType.BOTTOM_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.BOTTOM_BORDER].color = Color.Black
style.borders[BorderType.LEFT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.LEFT_BORDER].color = Color.Black
style.borders[BorderType.RIGHT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.RIGHT_BORDER].color = Color.Black

# تطبيق FormatAll: يفرض هذا النمط الفردي على كل خلية من خلايا الجدول المحوري،
# متجاوزًا أي PivotTableStyleType / PivotTableStyleName تم تعيينه مسبقًا
pivot_table.format_all(style)

# حفظ المصنف بتنسيق .xlsx الحديث
workbook.save("output.xlsx")

أي واجهة برمجة تطبيقات للأنماط يجب أن أستخدم؟

يعتمد اختيار واجهة برمجة التطبيقات للأنماط على تنسيق الملف الذي تحفظ إليه. استخدم الجدول أدناه كمرجع سريع.

تنسيق الملف الهدف	واجهة برمجة التطبيقات للاستخدام	ملاحظات
`.xls` (قديم)	`PivotTable.auto_format_type`	قيم من `aspose.cells.pivot.PivotTableAutoFormatType` (مثل `REPORT_1`–`REPORT_10`، و `CLASSIC`، و `TABLE_1`–`TABLE_10`). يتم تجاهلها عند الحفظ بتنسيقات حديثة.
`.xlsx` / `.xlsm` / `.xlsb` (حديث، نمط مدمج)	`PivotTable.pivot_table_style_type`	قيم من `aspose.cells.PivotTableStyleType` (سمات فاتحة/داكنة، بما في ذلك إضافات Excel 2017).
`.xlsx` / `.xlsm` / `.xlsb` (حديث، نمط مخصص)	`PivotTable.pivot_table_style_name` + `worksheets.table_styles.add_pivot_table_style(...)`	استخدم عندما لا تكون الإعدادات المسبقة المضمنة كافية. قم بالتكوين عبر `table_style_element.set_element_style(...)`.
أي تنسيق (تجاوز موحد)	`PivotTable.format_all(Style)`	اختصار يتجاوز كل إعداد نمط آخر عبر الجدول المحوري بأكمله.

في حالة الشك، احفظ بصيغة .xlsx واستخدم pivot_table_style_type للسمات المضمنة، أو pivot_table_style_name للسمات المخصصة.

Pythonnet: إضافة حقول الصفوف والأعمدة إلى جدول محوري في Aspose.Cells لـ .NET

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

إضافة حقل إلى منطقة الصفوف أو الأعمدة

تقوم طريقة PivotTable.add_field_to_area(PivotFieldType field_type, string field_name) بنقل حقل أساسي من بيانات المصدر إلى إحدى مناطق الجدول المحوري الأربع. تقبل وسيط field_type إحدى قيم PivotFieldType التالية.

ROW — الحقول الموضوعة عموديًا على اليسار
COLUMN — الحقول الموضوعة أفقيًا عبر الجزء العلوي
DATA — الحقول التي يتم تجميع قيمها
PAGE — الحقول المستخدمة كمرشحات تقرير

بعد إضافة الحقول، يمكنك الوصول إليها من خلال خصائص PivotTable.row_fields وPivotTable.column_fields. تُرجع كل خاصية PivotFieldCollection. الحقل الموجود في الفهرس 0 من row_fields هو حقل الصف الأبعد، وتمثل الفهارس اللاحقة الحقول المتداخلة داخله. ينطبق نفس اصطلاح الفهرسة على column_fields.

يهم ترتيب تداخل الحقول. تؤدي إضافة Category إلى منطقة الصفوف أولاً ثم Item إلى إنشاء جدول محوري تكون فيه المجموعة الخارجية هي Category والمجموعة الداخلية هي Item. يؤدي عكس الترتيب إلى عكس التسلسل الهرمي.

الإجماليات الفرعية لحقول المحور

تتحكم طريقة PivotField.set_subtotals(PivotFieldSubtotalType subtotal_type, bool shown) في صفوف الإجمالي الفرعي التي تظهر لحقل المحور. يقوم كل استدعاء بتبديل نوع إجمالي فرعي واحد بشكل مستقل. يؤدي تمرير shown = True إلى عرض الإجمالي الفرعي، بينما يؤدي تمرير shown = False إلى إخفائه. نظرًا لأن كل استدعاء يؤثر فقط على نوع واحد، فإن استدعاء الطريقة عدة مرات بقيم subtotal_type مختلفة ينشئ مجموعة فرعية مخصصة من الإجماليات الفرعية.

يُعرّف التعداد PivotFieldSubtotalType أنواع الإجمالي الفرعي المتاحة.

AUTOMATIC — يختار Aspose.Cells التحديد الافتراضي (عادةً SUM للحقول الرقمية)
NONE — منع كل صفوف الإجمالي الفرعي
SUM
COUNT
AVERAGE
MAX
MIN
PRODUCT
STDDEV
STDDEVP
VAR
VARP

لا تظهر الإجماليات الفرعية إلا عندما يكون هناك حقلان محوريان أو أكثر في منطقة الصفوف (أو في منطقة الأعمدة). الحقل الواحد ليس لديه شيء ذو معنى للتجميع الفرعي بينه، لذلك لا يكون لاستدعاءات set_subtotals أي تأثير مرئي في هذه الحالة. لذلك تضع هذه المقالة حقلين للصفوف (Category خارجي، Item داخلي) في كل مثال بحيث يكون حدود الإجمالي الفرعي بين كل مجموعة Category مرئية.

السيناريو 1 — الإجماليات الفرعية التلقائية (الافتراضية)

عندما لا تستدعي set_subtotals على الإطلاق، يطبق Aspose.Cells تحديد AUTOMATIC على الحقول الرقمية. يؤكد المثال التالي هذا السلوك صراحةً من خلال استدعاء set_subtotals(PivotFieldSubtotalType.AUTOMATIC, True) على حقل الصف الخارجي Category.

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.AUTOMATIC, True)

pivot_table.calculate_data()

workbook.save("output_automatic.xlsx")

السيناريو 2 — منع جميع الإجماليات الفرعية (None)

يقوم استدعاء set_subtotals(PivotFieldSubtotalType.NONE, True) بإزالة كل صفوف الإجمالي الفرعي من الجدول المحوري، تاركًا فقط صفوف الحقول والإجمالي الكلي في الأسفل. يكون هذا مفيدًا عندما تريد البيانات المجمعة الأولية دون أي صفوف ملخص.

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
for st in [ac.PivotFieldSubtotalType.SUM, ac.PivotFieldSubtotalType.COUNT, ac.PivotFieldSubtotalType.AVERAGE, ac.PivotFieldSubtotalType.MAX, ac.PivotFieldSubtotalType.MIN, ac.PivotFieldSubtotalType.PRODUCT]:
    category_field.set_subtotals(st, True)
pivot_table.calculate_data()

workbook.save("output_none.xlsx")

السيناريو 3 — مجموعة الإجمالي الفرعي المخصصة (Sum + Average)

لست محدودًا بنوع إجمالي فرعي واحد. يعمل كل استدعاء لـ set_subtotals بشكل مستقل على نوع واحد، لذلك ينتج عن استدعاء الطريقة مرتين — مرة بـ SUM ومرة بـ AVERAGE — مجموعة فرعية مخصصة من صفّي إجمالي فرعي لكل مجموعة Category.

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells["A1"].put_value("Category")
worksheet.cells["B1"].put_value("Item")
worksheet.cells["C1"].put_value("Year")
worksheet.cells["D1"].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_tables = worksheet.pivot_tables
pivot_index = pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.SUM, True)
category_field.set_subtotals(ac.PivotFieldSubtotalType.AVERAGE, True)

pivot_table.calculate_data()

workbook.save("output_custom.xlsx")

ملخص

تتشارك السيناريوهات الثلاثة أعلاه في نفس مجموعة البيانات وهيكل الجدول المحوري. الفرق الوحيد بينها هو استدعاء set_subtotals المطبق على حقل الصف الخارجي Category. تذكر قاعدة الحقلين: الحقل الواحد في المنطقة لا يوجد لديه شيء للتجميع الفرعي بينه، لذلك ضع دائمًا حقلين على الأقل في منطقة الصفوف أو الأعمدة عندما تريد أن يكون لـ set_subtotals تأثير مرئي.

Pythonnet: إدارة حقول القيم في الجدول المحوري في Aspose.Cells لـ .NET

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

إضافة حقل إلى منطقة البيانات

تُعدّ إضافة حقل أساسي إلى منطقة البيانات (القيم) الخطوة الأولى في تشكيل كيفية تجميع الجدول المحوري لبيانات المصدر. يوفّر Aspose.Cells overload الخاص بـ PivotTable.add_field_to_area(PivotFieldType, str)، الذي يقبل الثابت PivotFieldType.DATA واسم عمود المصدر. بمجرد إضافة حقل إلى منطقة البيانات، يعرضه الـ API من خلال مجموعة PivotTable.data_fields، بالترتيب الذي تمت إضافة الحقول به. افتراضيًا، يتم تلخيص عمود المصدر الرقمي باستخدام ConsolidationFunction.SUM، بينما يكون العمود غير الرقمي افتراضيًا على Count.

from aspose.cells.pivot import PivotFieldType

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# العناوين في A1:D1
worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

# صفوف البيانات A2:D9 باستخدام حلقات متداخلة متفرعة على j
for i in range(1, 9):
    for j in range(4):
        if j == 0:
            worksheet.cells[i, j].put_value("Fruit" if i <= 4 else "Vegetable")
        elif j == 1:
            if i == 1 or i == 2:
                worksheet.cells[i, j].put_value("Apple")
            elif i == 3 or i == 4:
                worksheet.cells[i, j].put_value("Banana")
            elif i == 5 or i == 6:
                worksheet.cells[i, j].put_value("Carrot")
            else:
                worksheet.cells[i, j].put_value("Daikon")
        elif j == 2:
            worksheet.cells[i, j].put_value(2020 + ((i - 1) % 2))
        elif j == 3:
            if i == 1:
                worksheet.cells[i, j].put_value(100)
            elif i == 2:
                worksheet.cells[i, j].put_value(150)
            elif i == 3:
                worksheet.cells[i, j].put_value(80)
            elif i == 4:
                worksheet.cells[i, j].put_value(90)
            elif i == 5:
                worksheet.cells[i, j].put_value(50)
            elif i == 6:
                worksheet.cells[i, j].put_value(60)
            elif i == 7:
                worksheet.cells[i, j].put_value(40)
            else:
                worksheet.cells[i, j].put_value(45)

# إضافة جدول محوري في F3 باسم PivotTable1
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

# تخطيط الجدول المحوري: الفئة والعنصر في الصف، السنة في العمود، المبلغ كحقل بيانات
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")

pivot_table.calculate_data()
workbook.save("output_drag.xlsx")

تغيير دالة التلخيص

كل حقل موضوع في منطقة البيانات يتم تغليفه داخليًا كنسخة من PivotField، وتُرجع خاصية function الخاصة به قيمة من تعداد ConsolidationFunction. يتيح لك المُعيّن function نفسه التبديل بين التجمّعات المتاحة، بما في ذلك Sum، وCount، وAverage، وMax، وMin، وProduct، وStdDev، وStdDevp، وVar، وVarp.

لا يؤثّر تغيير function إلا على التجمّع، بينما لا يتغيّر عمود المصدر.

يمكنك بالتالي إبقاء حقل بيانات واحد على Sum بينما تضيف حقل بيانات ثانٍ يستهدف عمود المصدر نفسه ولكن يستخدم Count أو Average، كل ذلك في جدول محوري واحد.

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")

pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

count_field = pivot_table.data_fields[1]
count_field.function = ac.ConsolidationFunction.COUNT

pivot_table.calculate_data()

workbook.save("output_function.xlsx")

عرض حقول القيم على محور الصفوف أو الأعمدة

عندما يحتوي الجدول المحوري على حقلَي بيانات أو أكثر، يوفّر Aspose.Cells حقلًا افتراضيًا إضافيًا يُسمى PivotTable.values_field. يمثّل هذا الحقل الافتراضي تجمّع كل حقل بيانات موجود في منطقة البيانات. يمكنك سحبه إلى منطقة الصفوف أو الأعمدة كحقل محوري أساسي، وهو أمر مفيد لتخطيط مقاييس متعددة جنبًا إلى جنب.

لا يعمل PivotTable.values_field إذا لم يكن هناك أي حقل قيمة أو إذا كان هناك حقل قيمة واحد فقط.

تستعرض السيناريوهات أدناه ثلاثة أمثلة شاملة توضّح كل قدرة من القدرات الموصوفة أعلاه على نفس بنية الجدول المحوري.

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ac.ConsolidationFunction.COUNT

# ارسم حقول القيم على محور الأعمدة.
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, pivot_table.values_field)

pivot_table.calculate_data()

workbook.save("output_plot.xlsx")

Pythonnet: إضافة حقول التصفية إلى جدول محوري في Aspose.Cells لـ .NET

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

يدعم Aspose.Cells دورة الحياة الكاملة لحقول الصفحة في الجداول المحورية. يمكنك إضافة حقل صفحة من خلال واجهة برمجة عالية المستوى أو من خلال مجموعة page_fields منخفضة المستوى، ويمكنك تشغيل مرشح الصفحة في وضع التحديد الفردي، أو مسحه لإظهار كل عناصر الصفحة، أو تبديل الحقل إلى التحديد المتعدد بحيث يمكن للمستخدمين اختيار عدة عناصر صفحة في وقت واحد من خلال واجهة مربعات الاختيار في Excel.

مقدمة

حقل التصفية هو حقل محوري يتحكم في أي مجموعة فرعية من البيانات المصدر يعرضها جسم المحور. يراه المستخدمون النهائيون كقائمة منسدلة في أعلى المحور المعروض في Excel، ويؤدي اختيار أحد عناصر الصفحة المتاحة إلى إعادة بناء جسم المحور بحيث يتم تلخيص السجلات التي تنتمي إلى عنصر التصفية هذا فقط. يصبح الحقل المحوري حقل صفحة عند تسجيله كـ PivotFieldType.PAGE بدلاً من PivotFieldType.ROW أو PivotFieldType.COLUMN أو PivotFieldType.DATA.

يمكن أن يعمل حقل التصفية بسلوكين. في سلوك التحديد الفردي الافتراضي، لا يظهر إلا عنصر صفحة واحد في كل مرة، لذلك يلخص جسم المحور مجموعة فرعية واحدة بالضبط. في سلوك التحديد المتعدد، يعرض الحقل قائمة مربعات اختيار، ويلخص جسم المحور اتحاد كل عناصر الصفحة المحددة. يمكن نقل نفس حقل المصدر ذهاباً وإياباً بين هذه السلوكيات عن طريق تبديل خاصية واحدة.

يعرض Aspose.Cells for Python via .NET طريقتين متكافئتين لتسجيل حقل صفحة. واجهة المستوى العالي هي PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name")، التي تأخذ اسم عمود المصدر وتضيف الحقل في استدعاء واحد. واجهة المستوى المنخفض هي PivotTable.page_fields.add(PivotField)، التي تُستخدم عندما يكون لديك بالفعل مرجع PivotField وتريد إضافة نفس مثيل الحقل إلى منطقة التصفية. تنتهي كلتا الواجهتين إلى ملء نفس مجموعة page_fields، وتوضح بقية هذه المقالة كيفية الاختيار بينهما وكيفية تشغيل كل وضع تصفية.

إضافة حقل صفحة

توجد طريقتان لتسجيل حقل محوري في منطقة التصفية. يأخذ استدعاء المستوى العالي اسم عمود المصدر كسلسلة نصية وهو المسار الأكثر شيوعاً. يقبل استدعاء المستوى المنخفض مثيل PivotField موجوداً وهو مناسب عندما يجب إعادة استخدام نفس كائن الحقل عبر مناطق محورية متعددة. يضع كلا الاستدعاءين الحقل في PivotTable.page_fields، وبعد ذلك يظهر كقائمة منسدلة للصفحة في أعلى المحور المعروض.

إضافة حقل صفحة باستخدام add_field_to_area

يبني المثال التالي مجموعة بيانات صغيرة مكونة من Fruit / Year / Amount، ويضع جدولاً محورياً عند الخلية E3 مع Fruit في منطقة الصفوف، وAmount في منطقة البيانات، وYear في منطقة التصفية، ويحدّث الجدول المحوري، ويحفظ المصنف.

import aspose.cells as ac

# إنشاء مصنف جديد
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# إعداد صف الرأس
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# تعبئة 9 صفوف من البيانات النموذجية: الفاكهة، السنة، المبلغ
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 i in range(len(data)):
    worksheet.cells[i + 1, 0].put_value(data[i][0])
    worksheet.cells[i + 1, 1].put_value(data[i][1])
    worksheet.cells[i + 1, 2].put_value(data[i][2])

# إضافة جدول محوري مثبت عند الخلية E3
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

# إضافة الحقول إلى مناطقها: الفاكهة كصف، المبلغ كبيانات، السنة كحقل صفحة
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

# تحديث وحساب بيانات الجدول المحوري
pivot_table.calculate_data()

# حفظ المصنف
workbook.save("pageFieldSample.xlsx")

إضافة حقل صفحة باستخدام page_fields.add

عندما تعمل بالفعل مع مثيل PivotField، يمكنك تمريره مباشرة إلى PivotTable.page_fields.add. يتم إنشاء الجدول المحوري وحقل التصفية تماماً كما في السيناريو السابق؛ فقط تسجيل منطقة التصفية النهائية يتم استبداله باستدعاء واجهة المستوى المنخفض.

import aspose.cells as ac

# — يتم إنشاء الجدول المحوري وحقل الصفحة تمامًا كما في
#   السيناريو 1a (بيانات الفاكهة/السنة/المبلغ، الجدول المحوري في E3، الفاكهة→الصف،
#   المبلغ→البيانات). أدناه نحصل على حقل السنة المحوري من
#   مجموعة BaseFields ونمرره إلى PageFields.Add — البديل
#   منخفض المستوى لـ AddFieldToArea. النتيجة هي
#   مطابقة وظيفيًا للسيناريو 1a.

workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# العناوين
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

# بيانات العينة (9 صفوف)
sheet.cells["A2"].put_value("apple");    sheet.cells["B2"].put_value("2020"); sheet.cells["C2"].put_value(100)
sheet.cells["A3"].put_value("apple");    sheet.cells["B3"].put_value("2021"); sheet.cells["C3"].put_value(150)
sheet.cells["A4"].put_value("apple");    sheet.cells["B4"].put_value("2022"); sheet.cells["C4"].put_value(200)
sheet.cells["A5"].put_value("grape");    sheet.cells["B5"].put_value("2020"); sheet.cells["C5"].put_value(300)
sheet.cells["A6"].put_value("grape");    sheet.cells["B6"].put_value("2021"); sheet.cells["C6"].put_value(400)
sheet.cells["A7"].put_value("grape");    sheet.cells["B7"].put_value("2022"); sheet.cells["C7"].put_value(500)
sheet.cells["A8"].put_value("blueberry"); sheet.cells["B8"].put_value("2020"); sheet.cells["C8"].put_value(250)
sheet.cells["A9"].put_value("blueberry"); sheet.cells["B9"].put_value("2021"); sheet.cells["C9"].put_value(350)
sheet.cells["A10"].put_value("blueberry");sheet.cells["B10"].put_value("2022"); sheet.cells["C10"].put_value(450)

# إضافة جدول محوري في E3 يغطي A1:C10
pivot_index = sheet.pivot_tables.add("E3", "A1:C10", "PivotTable1")
pivot_table = sheet.pivot_tables[pivot_index]

# الفاكهة -> الصف، المبلغ -> البيانات (ستذهب السنة إلى الصفحة أدناه)
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# نهج منخفض المستوى: احصل على حقل السنة المحوري الموجود من BaseFields
# وقم بتسجيله في منطقة الصفحة عبر PageFields.Add(PivotField).
year_field = pivot_table.base_fields["Year"]
pivot_table.page_fields.add(year_field)

# قم بالتحديث حتى ينعكس حقل الصفحة الجديد في المصنف المحفوظ
pivot_table.calculate_data()

workbook.save("output.xlsx")

التصفية أحادية التحديد (عرض عنصر صفحة واحد)

في سلوك التحديد الفردي الافتراضي، يُعرض حقل التصفية كقائمة منسدلة واحدة ويحدد العدد الصحيح PivotField.current_page_item عنصر التصفية الذي يقود جسم المحور. يؤدي تعيين فهرس محدد إلى اختيار هذا العنصر فقط؛ ويؤدي تعيين القيمة الحارسية الخاصة 0x7FFD (عشري 32765) إلى مسح المرشح بحيث يتم تلخيص كل عناصر الصفحة في وقت واحد. التحديد الفردي هو الوضع الافتراضي؛ لست بحاجة إلى تفعيله صراحةً.

عرض جميع العناصر

يكون تعيين current_page_item إلى القيمة السحرية 0x7FFD مكافئاً لمسح مرشح الصفحة: يلخص جسم المحور كل عنصر صفحة كما لو لم يتم تطبيق أي مرشح.

import aspose.cells as ac

# إنشاء مصنف جديد
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# تعبئة بيانات الفاكهة/السنة/المبلغ
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

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

for r in range(len(data)):
    for c in range(len(data[r])):
        sheet.cells[r + 1, c].put_value(data[r][c])

# إنشاء جدول محوري في E3
pivot_tables = sheet.pivot_tables
index = pivot_tables.add("=A1:C7", "E3", "PivotTable1")
pivot_table = pivot_tables[index]

# تكوين حقول الجدول المحوري: الفاكهة→صف، المبلغ→بيانات، السنة→صفحة
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

pivot_table.calculate_data()

# مسح مرشح الصفحة بحيث يكون كل عنصر في حقل الصفحة مرئياً.
# 0x7FFD (عشري 32765) هي القيمة الحارسية الخاصة التي تعني "جميع العناصر" —
# مكافئة لتحديد "(الكل)" في القائمة المنسدلة لحقل الصفحة في Excel.
pivot_table.page_fields[0].current_page_item = 0x7FFD

workbook.save("output.xlsx")

عرض عنصر محدد واحد

يؤدي تعيين current_page_item إلى فهرس حقيقي إلى اختيار عنصر التصفية هذا فقط. الفهرس هو موضع العنصر في قائمة العناصر المرتبة لحقل التصفية، فعلى سبيل المثال يحدد 1 العنصر الثاني بعد الفرز.

import aspose.cells as ac

# إنشاء مصنف
workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# إضافة بيانات تجريبية (الفاكهة/السنة/المبلغ)
cells["A1"].put_value("Fruit")
cells["B1"].put_value("Year")
cells["C1"].put_value("Amount")

cells["A2"].put_value("Apple")
cells["B2"].put_value("2020")
cells["C2"].put_value("100")

cells["A3"].put_value("Apple")
cells["B3"].put_value("2021")
cells["C3"].put_value("150")

cells["A4"].put_value("Banana")
cells["B4"].put_value("2020")
cells["C4"].put_value("200")

cells["A5"].put_value("Banana")
cells["B5"].put_value("2021")
cells["C5"].put_value("250")

# إضافة جدول محوري في E3
pivot_tables = sheet.pivot_tables
pivot_index = pivot_tables.add("A1:C5", "E3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

# إضافة الحقول: الفاكهة→صف، المبلغ→بيانات، السنة→صفحة
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# عمليات خاصة بحقل الصفحة
pivot_table.page_fields[0].current_page_item = 1  # 1 = العنصر الثاني بالترتيب (مثلاً "2021")

# تحديث وحساب الجدول المحوري
pivot_table.calculate_data()

workbook.save("output.xlsx")

التصفية متعددة التحديد

تحوّل التصفية متعددة التحديد قائمة الصفحة المنسدلة إلى قائمة مربعات اختيار وتسمح للمستخدم النهائي باختيار عدة عناصر صفحة في وقت واحد. يعرض Aspose.Cells خاصيتين تعملان معاً. يجب تعيين PivotField.is_multiple_item_selection_allowed إلى True قبل أن تصبح واجهة التحديد المتعددة فعالة على الإطلاق. بعد تفعيلها، تتحكم PivotItem.is_hidden في العناصر التي تظهر في قائمة مربعات الاختيار، بحيث يمكنك إما إظهار كل العناصر أو السماح فقط بعناصر محددة.

يمكّن الكود أدناه التحديد المتعدد على نفس حقل صفحة Year المُنشأ في السيناريو 1a، ثم يعرض نمطين: الجزء A يكشف كل عنصر صفحة عن طريق ترك is_hidden معيناً على False لكل إدخال، بينما يسمح الجزء B فقط بقيم المصدر التي تختارها ويخفي كل شيء آخر من خلال كتلة if / elif التي تختبر pivot_items[i].get_string_value().

import aspose.cells as ac

# — يتم إنشاء الجدول المحوري وحقل الصفحة تمامًا كما في
#   السيناريو 1أ (بيانات الفاكهة/السنة/المبلغ، الجدول المحوري عند E3، الفاكهة→الصف،
#   المبلغ→البيانات، السنة→الصفحة عبر AddFieldToArea).
#   أدناه نقوم بتطبيق التصفية متعددة التحديد على حقل الصفحة.

workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# بيانات تجريبية: الفاكهة | السنة | المبلغ
cells[0, 0].put_value("Fruit")
cells[0, 1].put_value("Year")
cells[0, 2].put_value("Amount")

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 i in range(len(data)):
    cells[i + 1, 0].put_value(data[i][0])
    cells[i + 1, 1].put_value(int(data[i][1]))
    cells[i + 1, 2].put_value(int(data[i][2]))

pivot_sheet = workbook.worksheets.add("Pivot")
pivots = pivot_sheet.pivot_tables
pivot_index = pivots.add("E3", "A1:C10", "PivotTable1")
pivot_table = pivots[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# — تمكين التحديد المتعدد على حقل الصفحة
pivot_table.page_fields[0].is_multiple_item_selection_allowed = True

# الجزء أ — تحديد جميع العناصر (جعل كل عنصر مرئيًا)
pivot_items = pivot_table.page_fields[0].pivot_items
for i in range(pivot_items.count):
    pivot_items[i].is_hidden = False

# الجزء ب — تحديد عناصر محددة فقط حسب القيمة المصدرية
for i in range(pivot_items.count):
    value = pivot_items[i].get_string_value()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivot_items[i].is_hidden = False
    else:
        pivot_items[i].is_hidden = True

pivot_table.calculate_data()

workbook.save("output.xlsx")

ملاحظة: عند استخدام التصفية متعددة التحديد من خلال PivotItem.is_hidden، يجب أن يظل عنصر PivotItem واحد على الأقل مرئياً (is_hidden == False). إذا تم إخفاء كل العناصر، فإن Excel إما يتعطل عند فتح الملف أو يعرض محوراً فارغاً. تحقق دائماً من أن قائمة السماح متعددة التحديد تتضمن عنصراً واحداً على الأقل من بيانات المصدر.

أي واجهة برمجة وأي وضع يجب أن أستخدم؟

يلخص الجدول أدناه متى تستخدم كل واجهة برمجة ووضع بحيث يمكنك اختيار المجموعة الصحيحة دون قراءة كل سيناريو بالتفصيل.

السيناريو / حالة الاستخدام	واجهة البرمجة الموصى بها	الخاصية المستخدمة	ملاحظات
إضافة حقل صفحة باسم عمود المصدر (الأكثر شيوعاً)	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name")`	غير متاح	مستوى عالٍ، سطر واحد. استخدم هذا ما لم تكن بحاجة إلى مرجع `PivotField`.
إضافة حقل صفحة عندما يكون لديك بالفعل كائن `PivotField`	`PivotTable.page_fields.add(PivotField)`	غير متاح	استخدم عندما تم الحصول على كائن الحقل من مكان آخر أو يحتاج إلى إعادة الاستخدام.
التصفية إلى عنصر صفحة واحد (الوضع الافتراضي)	`PivotField.current_page_item`	تعيين إلى فهرس محدد	على سبيل المثال، يعرض `1` العنصر الثاني في القائمة المرتبة.
عرض جميع العناصر / مسح مرشح الصفحة	`PivotField.current_page_item`	تعيين إلى `0x7FFD`	القيمة السحرية `0x7FFD` (عشري 32765) هي القيمة الحارسة لـ “كل العناصر”.
تفعيل واجهة التحديد المتعدد في Excel	`PivotField.is_multiple_item_selection_allowed`	تعيين إلى `True`	مطلوب قبل أن يصبح أي استدعاء لـ `is_hidden` فعالاً.
إخفاء / إظهار العناصر الفردية في قائمة التحديد المتعدد	`PivotItem.is_hidden`	تعيين لكل عنصر	يجب أن يظل عنصر واحد على الأقل مرئياً (`is_hidden == False`).

تذكر دائماً قيد الرؤية عند تكوين التصفية متعددة التحديد. إذا تم إخفاء كل PivotItem في حقل صفحة متعدد التحديد، فإن Excel يتعطل عند الفتح أو يعرض محوراً فارغاً. ابنِ قائمة السماح الخاصة بك مقابل بيانات المصدر بحيث يظل عنصر واحد على الأقل مرئياً، وستفتح المصنفات المحفوظة بشكل موثوق على كل جهاز.

Pythonnet: حذف جدول الدوران من ورقة العمل

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

المكتبة Aspose.Cells لبيثون via .NET توفر ميزة لحذف أو إزالة الجدول المحوري من ورقة عمل. يمكنك حذف الجدول المحوري باستخدام كائن الجدول المحوري أو موقع الجدول المحوري. يرجى استخدام الطريقة Worksheet.pivot_tables.remove(pivot_table) لحذف الجدول المحوري باستخدام كائن الجدول المحوري والطريقة Worksheet.pivot_tables.remove_at(index, keep_data) لحذف كائن الجدول المحوري باستخدام موقعه داخل مجموعة الجدول المحوري.

كيفية حذف الجدول المحوري من ورقة العمل باستخدام مكتبة Aspose.Cells لبيثون إكسل

تحتوي رمز العينة التالي على حذف جدولين للدوران من ورقة العمل. أولاً يقوم بإزالة جدول الدوران باستخدام الطريقة Worksheet.pivot_tables.remove(pivot_table) ثم يزيل جدول الدوران باستخدام الطريقة Worksheet.pivot_tables.remove_at(index, keep_data)

Pythonnet: حفظ الجدول الدوري في ملف ODS

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

كيفية حفظ جدول الدوران في ملف ODS

توفر Aspose.Cells لـ Python via .NET القدرة على حفظ جدول الدوران في ملفات ODS. للقيام بذلك، يجب عليك فقط تحويل مصنف يحتوي على جدول دوران موجود أو إنشاء جدول دوران جديد وحفظ الملف بتنسيق ODS. تأكد من استدعاء PivotTable.calculate_data قبل الحفظ لضمان أن جدول الدوران يتم عرضه في ملف ODS الناتج. يظهر الكود التالي كيفية حفظ جدول الدوران في ملف ODS.

كود عينة

تم إرفاق الملف الناتج المولوظ بالكود أعلاه للرجوع إليه.

ملف ODS الناتج

Documentation – إدراج جدول محوري

Pythonnet: تنسيق جدول الدوران

مظهر جدول الدوران

كيفية تعيين خيارات تنسيق جدول البيانات المحورية

كيفية تعيين نوع التنسيق التلقائي

كيفية تعيين خيارات التنسيق

تنسيق المظهر يدويًا

كيفية تعيين خيارات تنسيق حقل الجدول المحوري

كيفية تعيين تنسيق حقول الصف/العمود/الصفحة

كيفية تعيين تنسيق حقول البيانات

كيفية مسح حقول الجدول المحوري

Pythonnet: إنشاء جداول محورية ورسوم بيانية محورية

إضافة جداول الإحاطة والرسوم البيانية باستخدام مكتبة Aspose.Cells لـ Python Excel.

الاستعداد لاستخدام Aspose.Cells for Python via .NET

كيفية إضافة جدول محوري باستخدام مكتبة Aspose.Cells for Python Excel

كيفية إضافة رسم بياني محوري باستخدام مكتبة Aspsoe.Cells for Python Excel

Pythonnet: جدول محوري وبيانات المصدر

بيانات المصدر للجدول المحوري

تغيير مصدر بيانات الجدول المحوري

Pythonnet: إضافة حقل محسوب في جدول الدوران

سيناريوهات الاستخدام المحتملة

كيفية إضافة حقل محسوب في جدول النفث في إكسل

كيفية إضافة حقل محسوب في الجدول المحوري باستخدام Aspose.Cells لمكتبة Excel بلغة Python

الكود المثالي

Pythonnet: تحديث الجداول المحورية في Aspose.Cells for Python via .NET

مقدمة

الاستيرادات المطلوبة

تحديث جميع الجداول المحورية في المصنف

تحديث جميع الجداول المحورية على ورقة عمل واحدة

تحديث جدول محوري واحد

تغيّرت بيانات المصدر — استخدم PivotCache.refresh()

تغيّر العرض/التخطيط فقط — استخدم calculate_data()

الحصول على جميع الجداول المحورية التي تشترك في نفس PivotCache

الانتقال من PivotTable.refresh_data() المهجورة

أي واجهة برمجة تحديث يجب أن أستخدم؟

Pythonnet: تطبيق الأنماط على الجداول المحورية في Aspose.Cells لـ .NET

مقدمة

تطبيق تنسيق تلقائي مسبق للـ XLS القديم

تطبيق نمط جدول محوري مسمى مسبق حديث

تعريف وتطبيق نمط جدول محوري مخصص

تطبيق نمط واحد على كل خلية من خلايا الجدول المحوري باستخدام FormatAll

أي واجهة برمجة تطبيقات للأنماط يجب أن أستخدم؟

Pythonnet: إضافة حقول الصفوف والأعمدة إلى جدول محوري في Aspose.Cells لـ .NET

إضافة حقل إلى منطقة الصفوف أو الأعمدة

الإجماليات الفرعية لحقول المحور

السيناريو 1 — الإجماليات الفرعية التلقائية (الافتراضية)

السيناريو 2 — منع جميع الإجماليات الفرعية (None)

السيناريو 3 — مجموعة الإجمالي الفرعي المخصصة (Sum + Average)

ملخص

Pythonnet: إدارة حقول القيم في الجدول المحوري في Aspose.Cells لـ .NET

إضافة حقل إلى منطقة البيانات

تغيير دالة التلخيص

عرض حقول القيم على محور الصفوف أو الأعمدة

Pythonnet: إضافة حقول التصفية إلى جدول محوري في Aspose.Cells لـ .NET

مقدمة

إضافة حقل صفحة

إضافة حقل صفحة باستخدام add_field_to_area

إضافة حقل صفحة باستخدام page_fields.add

التصفية أحادية التحديد (عرض عنصر صفحة واحد)

عرض جميع العناصر

عرض عنصر محدد واحد

التصفية متعددة التحديد

أي واجهة برمجة وأي وضع يجب أن أستخدم؟

Pythonnet: حذف جدول الدوران من ورقة العمل

كيفية حذف الجدول المحوري من ورقة العمل باستخدام مكتبة Aspose.Cells لبيثون إكسل

Pythonnet: حفظ الجدول الدوري في ملف ODS

كيفية حفظ جدول الدوران في ملف ODS

كود عينة

تغيّرت بيانات المصدر — استخدم `PivotCache.refresh()`

تغيّر العرض/التخطيط فقط — استخدم `calculate_data()`

الانتقال من `PivotTable.refresh_data()` المهجورة