وثائق HotXLS

دورة حياة Pivot cache المحلي والتخطيط الأصلي

يضيف الإصدار 2.384.94 عروضًا ذات cache مشترك، وإنشاء Slicer‏ Pivot محلي غير OLAP وحذفه صراحةً، وإعادة بناء الـ cache المجمَّع، ومولِّد بيانات تخطيط أصلية وصفية محدود

العروض المشتركة وإنشاء Slicer

SecondPivot := Sheet.AddPivotTable(FirstPivot.Cache, 20, 1, 'SecondView');
Cache := Workbook.CreatePivotSlicerCache(FirstPivot, 'Category');
if Cache.ConnectPivotTable(SecondPivot) <> 1 then
  raise Exception.Create('The second view could not be connected');
Slicer := Sheet.Slicers.Add(Cache, 1, 6, 8, 8);

ينشئ TXLSXWorksheet.AddPivotTable(ACache: TXLSPivotCache; DestRow, DestCol: Integer; const Name: WideString): TXLSPivotTable عرضًا آخر لـ cache يملكه هذا المصنف؛ ويتحقق من الملكية والهندسة والأسماء قبل إرفاق العرض

ينشئ TXLSXWorkbook.CreatePivotSlicerCache(ATable: TXLSPivotTable; const AFieldName: WideString): TXLSXSlicerCache ذاكرة حقل مصدر مدعومة أو يعيد استخدامها بأمان، بينما يربط TXLSXSlicerCache.ConnectPivotTable(ATable: TXLSPivotTable): Integer عرضًا محليًا قائمًا ذات cache مشترك

ينشئ TXLSXSlicers.Add(ACache: TXLSXSlicerCache; ARow1, ACol1, ARow2, ACol2: Integer): TXLSXSlicer واجهة ورقة العمل مستخدمًا حدود خلايا صريحة شاملة قائمة على الواحد؛ وتُجهَّز أسماء المصدر وأجزاء الـ cache ومراجع الرسم وعضوية العرض قبل التعديل

تُرفض مصادر Slicer المجمَّعة والمحسوبة وOLAP والـ caches الأجنبية والنطاقات المستوردة غير المتسقة وأقنعة الحقل نفسه المستقلة الملتبسة؛ ويحتفظ XML العرض المستورد المدعوم بالامتدادات غير ذات الصلة عند إلحاق واجهة جديدة

الحذف الصريح والأعضاء المستقبليون

if Workbook.RemoveSlicerCache(Cache, xlsxSlicerPreserveCurrentSelection) <> 1 then
  raise Exception.Create('The Slicer cache could not be removed');

يضم TXLSXSlicerRemovalMode‏ xlsxSlicerClearSelection وxlsxSlicerPreserveCurrentSelection؛ ويزيل TXLSXWorkbook.RemoveSlicerCache(ACache: TXLSXSlicerCache; AMode: TXLSXSlicerRemovalMode): Integer الواجهة المربوطة ومراجع الرسم وأجزاء الـ cache الأصلية والاتصالات معًا

يزيل وضع المسح تقييد هذا الـ Slicer مع الاحتفاظ بالفلاتر المستقلة ومسندات المستدعي؛ وينقل وضع الحفظ تقييده الحالي إلى أقنعة أعضاء Pivot العادية قبل إزالة الـ Slicer

تعيد العملية 1 عند النجاح و-1 للاارتباطات غير المدعومة أو غير الآمنة؛ وتُتحقق كل العروض وحالة الـ cache المتأثرة وتُجهَّز قبل الالتزام، ويرفض تضارب ملكية الحقل نفسه دون تخمين

افتراضي TXLSPivotField.IncludeNewItemsInFilter: Boolean هو False؛ والمجموعة الفرعية اليدوية المحفوظة تستثني الأعضاء المُلحقة حديثًا ما لم تُفعَّل هذه السياسة صراحةً، بينما يشملهم الحقل غير المقيد

يظل الاختيار المحفوظ إذن مستقرًا بعد نمو المصدر، بينما يشمل وضع المسح أعضاء المصدر الجدد؛ ويسلسل قوائم الأعضاء المستوردة والمؤلَّفة سياسة إخفاء الأعضاء المستقبليين نفسها

ما زالت عمليات Delete وClear في المجموعات القائمة تحرس عرض Slicer نهائيًا مربوطًا؛ واستخدم العملية الصريحة على مستوى المصنف عندما يجب إزالة الـ cache وقيوداته المرتبطة معًا

إعادة بناء الـ cache المجمَّع الثابت

يجِّئ التحديث هويات المجموعات العددية والتاريخية والمتقطعة الصريحة من روابط الأساس/الأصل المتحقق منها، بما يشمل الحقول المشتقة المستوردة التي تغيب أعمدة سجلاتها؛ وتحتفظ حقول المصدر ذات الروابط فقط بقيمها الأصلية بدلًا من تجميعها هي نفسها

تحتفظ النطاقات المدعومة بمقابض الأعضاء القائمة والتسميات والأرقام الترتيبية للمجموعات؛ ويستخدم التجميع العددي والتاريخي حلًا واحدًا لكل حقل ونطاق عناصر مجموعات أصليًا ثابتًا، ويتطلب التجميع التاريخي فترة واحدة

افتراضا TXLSPivotCacheField.GroupAutoStart وTXLSPivotCacheField.GroupAutoEnd هما True ويحفظان سياسة الحدود المستوردة؛ وتُرفض القيم الجديدة المتطلبة لتوسيع النطاق أو إعادة التجميع قبل التعديل

تتطلب المجموعات المتقطعة تعيينًا قائمًا لكل عضو مصدر؛ وتُرفض الآباء الدوريون والنطاقات محددة النوع غير الصالحة والتسميات النصية غير الفريدة والأسس المحسوبة وحقول خصائص الأعضاء وحلول الأصل غير المدعومة رفضًا معاملاتيًا

يعيد Make العادي بناء قيم السجلات المشتقة المتقادمة أو المفقودة المدعومة، بينما يفعل MakePreview ذلك على نسخة منفصلة فقط؛ ويحذف الحفظ عناصر العناصر المشتركة النائبة الداخلية من النطاقات الأصلية المشتقة ويصدر بالضبط فهارس عناصر المجموعات المعلنة

معاينة بيانات التخطيط الأصلية الوصفية

function TryXLSXGeneratePivotLayout(const Xml: WideString;
  Table: TXLSPivotTable; out ResultXml, Reason: WideString): Boolean;

يجِّئ مساعد lxPivotXml‏ rowItems وcolItems وبيانات المحاور الوصفية والموضع للعروض المحلية المدمجة غير الفارغة المدعومة مستخدمًا هويات الحقول وأعضاء الـ cache التامة؛ وهو يدعم التسلسلات الهرمية العادية والمجاميع الفرعية الافتراضية علوية أو سفلية وأي محور بيانات

تتطلب هذه العملية الوصفية فقط تعيينَ Cache.RefreshOnLoad=True صريحًا؛ وهي تحفظ XML غير المعروف وتعيد XML الأصلي مع سبب بالإنجليزية عندما يتعذر تمثيل الحقول المجمَّعة أو المحسوبة أو المجاميع الفرعية المخصصة أو تخطيط غير مدعوم أو هويات مستوردة غير متسقة

لا يعيد المساعد كتابة خلايا ورقة العمل ولا يغيّر أعلام الجدول الحية؛ وعلى المستدعين المطلوبين مخرجات ورقة عمل مخزنة تزويد كاتب مناسب وعملية تجسيد مدعومة منفصلة

يزود TXLSPivotTable.MakePreview(AWriter: TlxPivotResultWriter; ALayoutWriter: TlxPivotLayoutWriter): Integer نداءات تخطيط متزامنة من معاينة منفصلة مع الاحتفاظ بهوية EvaluationSourceTable الأصلية

يتسلم TlxPivotLayoutWriter الجدول الأصلي ومحور الصفوف والأعمدة ومتجهي فهرس الحقول وفهرس عناصر الـ cache المنسوخين وTlxPivotLayoutItemKind ونوع المجموع الفرعي وطول البادئة؛ ويميز xlplikData وxlplikSubtotal وxlplikGrand هويات التجميع دون تحليل التسميات

تستخدم المتجهات TlxPivotLayoutIndices وتظل صالحة أثناء النداء؛ وتنتشر الاستثناءات، ويبقى سلوك Make القائم وMakePreview ذي الكاتب الواحد متاحًا

يحجز TXLSPivotTables._AddOwned(ATable: TXLSPivotTable) سعة المجموعة قبل نقل الملكية ويدعم إرفاق العرض المعاملاتي الداخلي؛ وعلى التطبيقات عادةً استخدام طرق تأليف ورقة العمل

الحدود الفاصلة

يضيف الإصدار 2.384.95‏ إخراج ورقة عمل أصليًا مخزنًا، وتوافر الترشيح المتقاطع للقراءة فقط، وتطهير الأعضاء التاريخيين صراحةً؛ ويحتفظ عرض بلا بيانات الأصلي المسلسل وتأليف Timeline وتسلسل تخطيط مجمَّع أوسع بحدود قبول منفصلة