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

Pythonnet: تصفية الجداول المحورية حسب التسمية أو القيمة

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

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

المقدمة

تُعد الجداول المحورية أدوات تحليلية قوية، لكن الملخصات الخام غالبًا ما تحتوي على معلومات أكثر بكثير مما تحتاج إلى تقديمها. التصفية هي الآلية الأساسية لتضييق نطاق الجدول المحوري وصولًا إلى الصفوف أو الأعمدة أو القيم المهمة لتقرير معين. يعكس Aspose.Cells for Python via .NET إمكانيات التصفية المتوفرة في Microsoft Excel، ويعرضها برمجيًا بحيث يمكن أتمتة إنشاء التقارير بالكامل. تتناول هذه المقالة استراتيجيات التصفية التالية:

مرشح التسميات — يُصفّي عناصر حقل الصف أو العمود استنادًا إلى تسمياتها النصية.
مرشح التاريخ — يُصفّي حقول الصفوف أو الأعمدة التي تحتوي على قيم التاريخ والوقت فقط (أو خلايا فارغة).
مرشح القيم — يُصفّي العناصر استنادًا إلى القيم المجمعة لحقل بيانات.
مرشح أعلى 10 — يعرض فقط أعلى أو أدنى عدد N من العناصر مرتبة حسب حقل قيمة.
إخفاء / إظهار عناصر الجدول المحوري — يتحكم يدويًا في رؤية كل عنصر فردي في حقل ما. يستخدم كل أسلوب طريقة مختلفة في فئة PivotField أو خاصية في فئة PivotItem. بعد تطبيق أي مرشح، يجب استدعاء refresh_data() وcalculate_data() على الجدول المحوري بحيث تعكس البيانات المخزنة مؤقتًا والقيم المحسوبة حالة المرشح الجديدة.

مرشح التسميات

يتيح لك مرشح التسميات تصفية عناصر حقل الصف أو العمود بمقارنة تسمياتها النصية بنمط معين. يكون ذلك مفيدًا عندما تريد عرض المنتجات التي تبدأ أسماؤها بحرف معين فقط، أو تحتوي على كلمة بعينها، أو تطابق معيارًا آخر قائمًا على التسمية. يعرض Aspose.Cells تصفية التسميات من خلال الطريقة PivotField.filter_by_label(PivotFilterType, label_string). يتضمن تعداد PivotFilterType قيمًا مثل CaptionBeginsWith وCaptionContains وCaptionEndsWith وCaptionDoesNotContain وCaptionIsNotBlank وCaptionIsBlank وغيرها. تُزوَّد الوسيطة الثانية بسلسلة التسمية المستخدمة في المقارنة. يقوم المثال التالي بتحميل مصنف يحتوي على جدول محوري موجود، ويطبق مرشح تسميات بحيث تظل العناصر التي تبدأ تسمياتها ببادئة محددة فقط مرئية، ثم يُحدّث الجدول المحوري، ويحفظ النتيجة.

import aspose.cells as ac

fileName = "sample.xlsx"
prefix = "B"

# تحميل ملف العمل الموجود الذي يحتوي على جدول محوري
workbook = ac.Workbook(fileName)

# الوصول إلى ورقة العمل حسب الفهرس (ورقة العمل الأولى)
worksheet = workbook.worksheets[0]

# الوصول إلى الجدول المحوري حسب الفهرس
pivot_table = worksheet.pivot_tables[0]

# استرجاع حقل الصف الأول PivotField
row_field = pivot_table.row_fields[0]

# تطبيق مرشح التسمية — عرض عناصر الصفوف التي تبدأ تسمياتها بالبادئة المقدمة فقط
row_field.filter_by_label(ac.PivotFilterType.CAPTION_BEGINS_WITH, prefix, "")

# تحديث وإعادة حساب بيانات الجدول المحوري حتى يتم تطبيق المرشح
pivot_table.pivot_cache.refresh()

# حفظ ملف العمل على القرص
workbook.save(fileName)

مرشح التاريخ

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

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

يعرض Aspose.Cells تصفية التاريخ من خلال الطريقة PivotField.filter_by_date(PivotFilterType, *date_times). يحتوي تعداد PivotFilterType على قيم تاريخ مخصصة مثل Today وYesterday وLastWeek وThisWeek وNextWeek وLastMonth وThisMonth وNextMonth وLastQuarter وThisQuarter وNextQuarter وLastYear وThisYear وNextYear وBetween. بناءً على نوع المرشح المختار، تمرر قيمة DateTime واحدة أو قيمتين (بالنسبة لـ Between، تمرر تاريخي البداية والنهاية). يقوم المثال التالي بتحميل مصنف يحتوي على جدول محوري توجد في منطقة الصفوف به حقل تاريخ، ويطبق مرشح تاريخ يقصر العناصر المرئية على نطاق تاريخ معين، ثم يُحدّث الجدول المحوري، ويحفظ المصنف.

from datetime import datetime

input_path = "sample.xlsx"
output_path = "output_filtered.xlsx"

if not os.path.exists(input_path):
    raise FileNotFoundError("Source workbook not found.", input_path)

# تحميل المصنف الموجود الذي يحتوي على الجدول المحوري
workbook = ac.Workbook(input_path)

# الوصول إلى ورقة العمل التي تحتوي على الجدول المحوري (بالفهرس)
worksheet = workbook.worksheets[0]

# الوصول إلى الجدول المحوري بواسطة الفهرس
pivot_table = worksheet.pivot_tables[0]

# استرجاع حقل التاريخ PivotField من منطقة الصفوف
# (يعمل مرشح التاريخ فقط عندما تحتوي منطقة الصفوف/الأعمدة على خلايا تاريخ-وقت فقط أو خلايا فارغة)
date_field = pivot_table.row_fields[0]

# تحديد معيار التاريخ لمرشح Between
start_date = datetime(2020, 1, 1)
end_date = datetime(2020, 12, 31)

# تطبيق مرشح التاريخ على الحقل المحوري
date_field.filter_by_date(ac.PivotFilterType.DATE_BETWEEN, start_date, end_date)

# تحديث وإعادة حساب الجدول المحوري ليصبح المرشح ساري المفعول
pivot_table.pivot_cache.refresh()

# حفظ المصنف
workbook.save(output_path)

مرشح القيم

تعمل مرشحات القيم على القيم المجمعة التي يحسبها الجدول المحوري في منطقة البيانات الخاصة به. وبدلًا من مطابقة تسميات النصوص، فإنها تقارن الإجماليات الرقمية بحد معين. تتضمن حالات الاستخدام النموذجية عرض المنتجات التي يتجاوز مجموع مبيعاتها مبلغًا مستهدفًا فقط، أو عرض المناطق التي يقع عدد معاملاتها ضمن نطاق معين فقط. يعرض Aspose.Cells تصفية القيم من خلال الطريقة PivotField.filter_by_value(value_field, PivotFilterType, *thresholds). يستخدم معامل PivotFilterType قيمًا مثل ValueGreaterThan وValueLessThan وValueBetween وValueEqual وValueNotEqual وValueGreaterThanOrEqual وValueLessThanOrEqual. يحدد معامل value_field حقل البيانات الذي يجب تقييمه، في حين تُمرَّر قيمة العتبة (أو قيمها) في الوسيطات الأخيرة. يقوم المثال التالي بتحميل مصنف يحتوي على جدول محوري، ويطبق مرشح قيم يحتفظ فقط بالعناصر التي تتجاوز مبيعاتها المجمعة عتبة عددية، ثم يُحدّث الجدول المحوري، ويحفظ المصنف.

import aspose.cells as ac

workbook = ac.Workbook("sample.xlsx")
worksheet = workbook.worksheets[0]
pivot_table = worksheet.pivot_tables[0]

row_field = pivot_table.row_fields[0]
data_field = pivot_table.data_fields[0]

# العثور على فهرس حقل البيانات يدويًا نظرًا لأن PivotFieldCollection لا يحتوي على IndexOf
data_field_index = -1
for i in range(pivot_table.data_fields.count):
    if pivot_table.data_fields[i] == data_field:
        data_field_index = i
        break

if data_field_index >= 0:
    row_field.filter_by_value(data_field_index, ac.PivotFilterType.VALUE_GREATER_THAN, 5000, float('inf'))

pivot_table.pivot_cache.refresh()

workbook.save("output.xlsx")

مرشح أعلى 10

مرشح أعلى 10 هو شكل متخصص من مرشح القيم يحتفظ فقط بأعلى أو أدنى عدد N من العناصر بناءً على حقل قيمة مختار. يُستخدم بشكل شائع في تقارير الترتيب مثل “أفضل 10 منتجات من حيث الإيرادات” أو “أسوأ 5 مناطق من حيث عدد المبيعات”.

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

يعرض Aspose.Cells تصفية أعلى 10 من خلال الطريقة PivotField.filter_top_10(item_count, is_top, value_field, PivotFilterType). يحدد معامل item_count عدد العناصر التي يجب الاحتفاظ بها، ويشير is_top إلى الاحتفاظ بأعلى العناصر (True) أو أدنى العناصر (False)، ويُحيل value_field إلى حقل البيانات المستخدم للترتيب، بينما يتحكم PivotFilterType في كيفية حساب القيمة (عادةً Sum، وكذلك Count وPercent). يقوم المثال التالي بتحميل مصنف يحتوي على جدول محوري يضم حقل قيمة، ويطبق مرشح أعلى 10 للاحتفاظ فقط بأعلى 10 عناصر من حيث مجموع المبيعات، ثم يُحدّث الجدول المحوري، ويحفظ المصنف.

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

# تحميل المصنف الحالي الذي يحتوي على الجدول المحوري
inputPath = "input.xlsx"
outputPath = "output.xlsx"
workbook = ac.Workbook(inputPath)

# الوصول إلى ورقة العمل التي تحتوي على الجدول المحوري (الفهرس 0)
worksheet = workbook.worksheets[0]

# الوصول إلى الجدول المحوري عن طريق الفهرس
pivotTable = worksheet.pivot_tables[0]

# التحقق من وجود حقل قيمة واحد على الأقل في منطقة البيانات
if pivotTable.data_fields.count == 0:
    raise Exception("Pivot table has no value (data) PivotField.")
valueField = pivotTable.data_fields[0]

# استرجاع حقل الصف المستهدف (الحقل الذي نريد تطبيق Top 10 عليه)
rowField = pivotTable.row_fields[0]

# حقل البيانات الأول (والوحيد) يقع عند الفهرس 0؛ Top 10 تصنف بناءً عليه.
valueFieldIndex = 0

# تطبيق مرشح Top 10 على حقل الصف:
#   - itemCount   = 10
#   - filterType  = PivotFilterType.Sum
#   - isTop       = true (أعلى N؛ false تعني أدنى N)
#   - valueFieldIndex = فهرس حقل البيانات المستخدم لتصنيف العناصر
rowField.filter_top10(10, acp.PivotFilterType.Sum, True, valueFieldIndex)

# تحديث بيانات الجدول المحوري وإعادة حسابها حتى يصبح المرشح ساري المفعول
pivotTable.pivot_cache.refresh()

# حفظ المصنف
workbook.save(outputPath)

التصفية عن طريق إخفاء أو إظهار عناصر الجدول المحوري

بالإضافة إلى واجهات التصفية البرمجية المنظمة، يتيح لك Aspose.Cells التحكم في رؤية كل عنصر محوري فردي بشكل مباشر. من خلال التكرار عبر مجموعة PivotItems الخاصة بـ PivotField وتبديل الخاصية is_hidden، يمكنك إخفاء عناصر محددة بشكل انتقائي دون تطبيق مرشح قائم على الصيغة. يؤدي تعيين is_hidden = True إلى إخفاء العنصر من الجدول المحوري؛ بينما يؤدي تعيين is_hidden = False إلى إظهاره مجددًا وجعله مرئيًا. يكون هذا الأسلوب مفيدًا عندما تكون قاعدة التصفية غير منتظمة أو خاصة بعنصر ما، مثل إخفاء عدد صغير من الفئات المسماة التي يجب ألا تظهر في تقرير معين. يقوم المثال أدناه بتحميل جدول محوري، وإخفاء عنصر معين بالاسم، وعرض كيفية إظهاره، ثم تحديث الجدول المحوري، وحفظ المصنف.

import aspose.cells as ac

# تحميل مصنف موجود يحتوي على جدول محوري
workbook = ac.Workbook("pivot_table_sample.xlsx")

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

# الوصول إلى الجدول المحوري بواسطة الفهرس (الجدول المحوري الأول في الورقة)
pivot_table = sheet.pivot_tables[0]

# استرجاع حقل الجدول المحوري المستهدف (حقل تسمية الصف الأول الذي سنخفي/نظهر العناصر فيه)
pivot_field = pivot_table.row_fields[0]

# التكرار عبر مجموعة عناصر الحقل المحوري المحدد
item_count = pivot_field.pivot_items.count
for i in range(item_count):
    item = pivot_field.pivot_items[i]

    # إخفاء عناصر الجدول المحوري التي تطابق اسمًا/معيارًا محددًا
    if item.name == "Item1" or item.name == "Item2":
        item.is_hidden = True

    # عرض توضيحي لإظهار العنصر: إعادة عرض عنصر محوري مخفي سابقًا
    if item.name == "Item3":
        item.is_hidden = False

# تحديث وإعادة حساب الجدول المحوري حتى تصبح التغييرات سارية المفعول
pivot_table.pivot_cache.refresh()

# حفظ المصنف — تبقى العناصر المخفية في البيانات الأساسية
# ولكن يتم استبعادها من مخرجات الجدول المحوري المعروضة
workbook.save("output_pivot_filtered.xlsx")

الملخص

يوفر Aspose.Cells for Python via .NET مجموعة كاملة من إمكانيات تصفية الجداول المحورية التي تطابق تلك المتوفرة في Microsoft Excel. تغطي مرشحات التسميات والتاريخ والقيم معظم السيناريوهات التحليلية الشائعة، بينما يتعامل مرشح أعلى 10 مع تقارير الترتيب. وعندما تكون قاعدة التصفية غير منتظمة، توفر الخاصية PivotItem.is_hidden حلاً مرنًا على مستوى العناصر. يتيح لك الجمع بين هذه الاستراتيجيات — على سبيل المثال، تطبيق مرشح تسميات ثم إخفاء عناصر محددة — إنشاء تقارير جداول محورية مستهدفة بدقة بالكامل من خلال الكود.

Pythonnet: الحصول على كائن الخلية حسب اسم العرض المتجانس لحقل PivotField من جدول الدوران

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

تقدم Aspose.Cells لـ Python via .NET PivotTable.get_cell_by_display_name(display_name) الذي يمكنك استخدامه للوصول إلى كائن الخلية بواسطة اسم العرض لحقل pivot. يعتبر هذا الأسلوب مفيدًا عندما تريد تحديد أو تنسيق رأس حقل الجدول المحوري الخاص بك. تشرح هذه المقالة كيفية استرداد كائن الخلية بواسطة اسم العرض لحقل البيانات ثم تطبيق التنسيق عليه.

كيفية الحصول على كائن الخلية بواسطة اسم العرض لحقل PivotField في جدول البيانات المحوري

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

جدول مفصلي - قبل

جدول مفصلي - بعد

Pythonnet: تجميع حقول الجدول المحوري في جدول الدوران

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

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

يسمح Microsoft Excel لك بتجميع حقول الجدول المحوري. عند وجود كمية كبيرة من البيانات المتعلقة بحقل جدول محوري، فمن المفيد في كثير من الأحيان تجميعها في أقسام. توفر Aspose.Cells for Python via .NET أيضًا هذه الميزة باستخدام الطريقة PivotTable.set_manual_group_field().

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

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

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

Pythonnet: إخفاء البيانات وفرزها في جدول البيانات المحوري

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

إخفاء جدول الدوران وفرز البيانات باستخدام Aspose.Cells لمكتبة Python Excel

Aspose.Cells لـ Python via .NET تدعم إخفاء البيانات وترتيبها في جدول الدوران. يظهر الكود التالي كيف يمكن فرز عمود الدرجات تنازليًا ثم إخفاء الصفوف التي تحتوي على درجة أقل من 60.

الملفات الإكسل المصدرية والناتجة المستخدمة في مقتطف الكود مرفقة للرجوع إليها.

ملف المصدر

ملف الناتج

Pythonnet: إضافة فلتر في الجدول المحوري

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

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

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

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

يرجى رؤية الرمز البريدي العيني التالي. يقوم بتعيين البيانات وإنشاء جدول بيانات محوري بناءً عليها. ثم إضافة فلتر على حقل الصف لجدول البيانات المحوري. أخيرًا، يحفظ الدفتر بتنسيق XLSX الناتج. بعد تنفيذ رمز المثال، يتم إضافة جدول بيانات محوري بفلتر top10 إلى ورقة العمل.

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

Pythonnet: ترتيب مخصص في جدول محوري

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

كيفية تعيين فرز مخصص في جدول محوري باستخدام مكتبة Aspose.Cells for Python Excel

من خلال استخدام واجهة برمجة التطبيقات لـ Aspose.Cells لـ Python via .NET، يمكنك فرز جداول البيانات على قيم الحقل. يقوم قطع الكود التالي بتحميل ملف Excel عيني وإضافة ثلاث جداول محورية. الجدول المحوري الأول بدون فرز مخصص، الجدول المحوري الثاني مفروز على قيم سطر “المأكولات البحرية” والجدول المحوري الثالث مفروز على “28/07/2000”.

يمكن تنزيل ملف المصدر وملفات الإخراج التجريبية من هنا لاختبار الشيفرة التجريبية:

ملف إكسيل المصدر

ملف إكسيل الناتج

ملف PDF الناتج

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

Pythonnet: مسح الفلتر في الجدول الدوري Pivot

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

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

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

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

مسح الفلتر في الجدول الدوري Pivot في Excel، اتبع هذه الخطوات:

حدد الجدول الدوري Pivot الذي تريد مسح الفلتر منه.
انقر على السهم المنسدل للفلتر الذي تريد مسحه في الجدول الدوري Pivot.
حدد “مسح الفلتر” من القائمة المنسدلة.
إذا كنت ترغب في مسح جميع الفلاتر من الجدول الدوري Pivot، يمكنك أيضًا النقر فوق زر “مسح الفلاتر” في علامة PivotTable Analyze في شريط الشريط في Excel.

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

مسح الفلتر في جدول الدوران باستخدام Aspose.Cells للبايثون via .NET. يرجى الاطلاع على الكود عينة التالي.

ضع البيانات وأنشئ جدول محوري استنادًا إليها.
أضف تصفيةً إلى حقل الصف في الجدول المحوري.
احفظ الدفتر في تنسيق XLSX الناتج. بعد تنفيذ الشيفرة المثالية، سيتم إضافة جدول محوري مع تصفية أعلى 10 إلى ورقة العمل.
أمسح التصفية على حقل محدد في الجدول المحوري. بعد تنفيذ الشيفرة لمسح التصفية، سيتم مسح التصفية على الحقل المحدد. يرجى التحقق من XLSX الناتج.