Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
عادةً ما يجمع جدول محوري كل حقل بيانات باستخدام وظيفة تجميع مثل SUM أو COUNT. ميزة إظهار القيم كـ في Excel تستبدل كل نتيجة معروضة بحساب ثانوي مشتق من ذلك التجميع — على سبيل المثال، نسبة مئوية من الإجمالي الكلي، إجمالي متراكم، فرق عن عنصر أساسي مختار، أو ترتيب — مما يتيح إجراء تحليلات مقارنة دون الحاجة إلى صيغ مساعدة أو أعمدة محسوبة.
تشمل الاستخدامات الشائعة تحليل حصة الإجمالي الكلي، بما في ذلك نسب الصف أو العمود أو الإجمالي الكلي؛ التقارير التراكمية باستخدام إجمالي متراكم في حقل الفترة؛ تحليل الفروقات مقابل عنصر مرجعي باستخدام الفرق أو الفرق النسبي من عنصر أساسي؛ وترتيب القيم من الأصغر إلى الأكبر أو العكس.
في Aspose.Cells for Node.js عبر Java، يحدد PivotFieldDataDisplayFormat الحساب الثانوي. تعيد الطريقة للقراءة فقط PivotField.getShowValuesSetting() كائنًا من نوع PivotShowValuesSetting. تُكوّن طرق setCalculationType() و setBaseFieldIndex() و setBaseItemPositionType() و setBaseItemIndex() السلوك؛ تُطبق طريقة الراحة PivotField.showValuesAs(...) نفس الإعدادات الأربعة في استدعاء واحد. طبّق هذه الإعدادات على حقل بيانات أو قيمة يتم الحصول عليه من PivotTable.getDataFields().
يحافظ حقل البيانات على وظيفة التجميع الخاصة به، مثل SUM أو COUNT، بينما يحول إظهار القيم كـ طريقة عرض القيمة المجمعة فقط.
إلى جانب كتابة إعدادات PivotShowValuesSetting مباشرة (انظر القسم الأخير)، تُطبق طريقة الراحة ذات الاستدعاء الواحد نفس التكوين:
const AsposeCells = require("aspose.cells");
function showValuesAs(pivotField, displayFormat, baseField, baseItemPositionType, baseItem) {
pivotField.showValuesAs(displayFormat, baseField, baseItemPositionType, baseItem);
}
module.exports = { showValuesAs };
| المعامل | المعنى | متى يكون مطلوبًا |
|---|---|---|
displayFormat |
الحساب الثانوي من نوع PivotFieldDataDisplayFormat الذي سيُطبق. |
دائمًا. |
baseField |
الفهرس الصفري للحقول الأساسية بين الحقول الأساسية لجدول محوري (على سبيل المثال، فهرس حقل الصف الذي ينتمي إليه العنصر الأساسي). | فقط تنسيقات المرجع الستة أدناه (DIFFERENCE_FROM, PERCENTAGE_OF, PERCENTAGE_DIFFERENCE_FROM, RUNNING_TOTAL_IN, PERCENTAGE_OF_RUNNING_TOTAL_IN, PERCENTAGE_OF_PARENT_TOTAL)؛ يتم تجاهلها في جميع التنسيقات الأخرى. |
baseItemPositionType |
الطريقة التي يُختار بها العنصر الأساسي بالنسبة للعنصر الحالي: PivotItemPositionType.PREVIOUS، .NEXT، أو .CUSTOM. |
فقط تنسيقات العنصر الأساسي الثلاثة (DIFFERENCE_FROM, PERCENTAGE_OF, PERCENTAGE_DIFFERENCE_FROM)؛ يتم تجاهلها في جميع التنسيقات الأخرى. |
baseItem |
الفهرس الصفري للعنصر الأساسي. | فقط عندما تكون baseItemPositionType هي CUSTOM (يختار فهرس العنصر القاعدة المحدد)؛ يُتجاهل للخيارات PREVIOUS / NEXT وفي جميع الصيغ غير القائمة على عنصر أساسي — مرّر 0. |
| نوع الحساب | السلوك | معلمات عنصر القاعدة |
|---|---|---|
NORMAL |
لا يوجد حساب ثانوي؛ تُعرض القيمة المجمعة كما هي (الوضع الافتراضي). | — |
DIFFERENCE_FROM |
تعرض القيمة كفرق عن قيمة عنصر أساسي في حقل أساسي. | baseField + PREVIOUS/NEXT/CUSTOM (baseItem فقط مع CUSTOM) |
PERCENTAGE_OF |
تعرض القيمة كنسبة مئوية من قيمة عنصر أساسي في حقل أساسي. | baseField + PREVIOUS/NEXT/CUSTOM (baseItem فقط مع CUSTOM) |
PERCENTAGE_DIFFERENCE_FROM |
تعرض القيمة كنسبة فرق عن قيمة عنصر أساسي في حقل أساسي. | baseField + PREVIOUS/NEXT/CUSTOM (baseItem فقط مع CUSTOM) |
RUNNING_TOTAL_IN |
تعرض القيمة كإجمالي متراكم لعناصر متتالية في حقل أساسي. | baseField (الحقل الذي يحدد ترتيب العنصر لتجميعه) |
PERCENTAGE_OF_ROW |
تعرض القيمة كنسبة مئوية من إجمالي الصف. | — |
PERCENTAGE_OF_COLUMN |
تعرض القيمة كنسبة مئوية من إجمالي العمود. | — |
PERCENTAGE_OF_TOTAL |
تعرض القيمة كنسبة مئوية من الإجمالي الكلي. | — |
INDEX |
تعرض القيمة باستخدام صيغة الفهرس في Excel ((القيمة * الإجمالي الكلي) / (إجمالي الصف * إجمالي العمود)). | — |
PERCENTAGE_OF_PARENT_ROW_TOTAL |
تعرض القيمة كنسبة مئوية من إجمالي الصف الوالد (لحقول الصف المتداخلة). | — |
PERCENTAGE_OF_PARENT_COLUMN_TOTAL |
تعرض القيمة كنسبة مئوية من إجمالي العمود الوالد (لحقول العمود المتداخلة). | — |
PERCENTAGE_OF_PARENT_TOTAL |
تعرض القيمة كنسبة مئوية من إجمالي الوالد. | baseField (الحقل الأصل المرجعي) |
PERCENTAGE_OF_RUNNING_TOTAL_IN |
تعرض القيمة كنسبة مئوية من إجمالي متراكم في حقل أساسي. | baseField (حقل التجميع) |
RANK_SMALLEST_TO_LARGEST |
ترتّب القيمة من الأصغر (1) إلى الأكبر. | — |
RANK_LARGEST_TO_SMALLEST |
ترتّب القيمة من الأكبر (1) إلى الأصغر. | — |
showValuesAs(...) يكتب الإعدادات لكائن PivotShowValuesSetting (setCalculationType(), setBaseFieldIndex(), setBaseItemPositionType(), و setBaseItemIndex()) — الطريقة وكائن الإعداد هما طريقتان لتكوين الحالة نفسها، مما يعكس محددات الحقل الأساسي والعنصر الأساسي في مربع حوار إظهار القيم كـ في Excel.
استدعِ طريقة PivotField.showValuesAs() باستخدام PivotFieldDataDisplayFormat.PERCENTAGE_OF_TOTAL لتحويل كل خلية من حقل البيانات، بما في ذلك الإجمالي الكلي، إلى نصيبها من الإجمالي الكلي. وبالتالي تُعرض الأرقام كنسب من مجموعة النتائج الكاملة. هذا التنسيق يقيس كل قيمة مقابل الإجمالي الكلي فقط، لذا لا يتطلب حقلًا أساسيًا أو عنصرًا أساسيًا — المعاملات اللاحقة (0, PivotItemPositionType.PREVIOUS, 0) هي مجرد نواقل يتجاهلها التنسيق كما هو موضح في جدول المعاملات أعلاه.
const AsposeCells = require("aspose.cells");
// Load or create a workbook with source data
const workbook = new AsposeCells.Workbook();
const dataSheet = workbook.getWorksheets().get(0);
dataSheet.getCells().get("A1").putValue("Fruit");
dataSheet.getCells().get("B1").putValue("Amount");
const fruits = ["Apple", "Banana", "Apple", "Cherry", "Banana", "Apple"];
const amounts = [10, 20, 30, 40, 50, 60];
for (let i = 0; i < fruits.length; i++) {
dataSheet.getCells().get(i + 1, 0).putValue(fruits[i]);
dataSheet.getCells().get(i + 1, 1).putValue(amounts[i]);
}
// Add a pivot table on a new worksheet
const pivotSheetIndex = workbook.getWorksheets().add();
const pivotTable = workbook.getWorksheets().get(pivotSheetIndex).getPivotTables().add("=Sheet1!A1:B7", 2, 2);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
// Show the Amount data field as a percentage of the grand total with the
// one-call method; PercentageOfTotal takes no base item, so the trailing
// base arguments (0, Previous, 0) are placeholders the format ignores
const dataField = pivotTable.getDataFields().get(0);
dataField.showValuesAs(
AsposeCells.PivotFieldDataDisplayFormat.PercentageOfTotal,
0,
AsposeCells.PivotItemPositionType.Previous,
0
);
pivotTable.calculateData();
// Body now reads: Apple 47.62%, Banana 33.33%, Cherry 19.05%, Grand Total 100.00%
workbook.save("ShowValuesAsPercentageOfTotal.xlsx");
اقرأ التكوين الحالي عبر PivotField.getShowValuesSetting()؛ تُعيد الطريقة للقراءة فقط كائن PivotShowValuesSetting الخاص بالحقل، والذي يحتوي على الإعدادات الأربعة التي تصف حساب إظهار القيم كـ النشط. لتغيير التكوين، استدعِ طريقة PivotField.showValuesAs() — فهي تكتب جميع الإعدادات الأربعة في استدعاء واحد، لذلك لن تحتاج إلى تعيينها بشكل منفرد.
يُظهر كائن PivotShowValuesSetting الإعدادات الأربعة التي تُكتبها showValuesAs():
getCalculationType() / setCalculationType() يحددان الحساب الثانوي من نوع PivotFieldDataDisplayFormat.getBaseFieldIndex() / setBaseFieldIndex() يحددان الفهرس الصفري للحقول الأساسية داخل حقول محورية. يُستخدم في تنسيقات المرجع.getBaseItemPositionType() / setBaseItemPositionType() يحددان موضع العنصر الأساسي بالنسبة للعنصر الحالي ويقبلان PivotItemPositionType.NEXT، PivotItemPositionType.PREVIOUS، أو PivotItemPositionType.CUSTOM.getBaseItemIndex() / setBaseItemIndex() يحددان الفهرس الصفري للعنصر الأساسي ويُستخدم عندما تكون getBaseItemPositionType() هي CUSTOM.showValuesAs()، استدعِ PivotTable.calculateData() مرة أخرى حتى يُعاد حساب جسم الجدول المحوري وإعادة عرضه وفق التكوين المحدث.const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook("ShowValuesAsPercentageOfTotal.xlsx");
const pivotTable = workbook.getWorksheets().get(1).getPivotTables().get(0);
const dataField = pivotTable.getDataFields().get(0);
// Read the current show-values settings
const settings = dataField.getShowValuesSetting();
console.log(`CalculationType: ${settings.getCalculationType()}`);
console.log(`BaseFieldIndex: ${settings.getBaseFieldIndex()}`);
console.log(`BaseItemPositionType: ${settings.getBaseItemPositionType()}`);
console.log(`BaseItemIndex: ${settings.getBaseItemIndex()}`);
// Switch to a base-item calculation with the one-call method: difference
// from the value of the previous item in the row field
dataField.showValuesAs(
AsposeCells.PivotFieldDataDisplayFormat.DifferenceFrom,
pivotTable.getRowFields().get(0).getBaseIndex(),
AsposeCells.PivotItemPositionType.Previous,
0
);
pivotTable.calculateData();
// Note: the percentage number format saved by the previous example still
// clings to the data field cells; the underlying values are now differences
// Re-read the applied configuration
console.log(`CalculationType now: ${dataField.getShowValuesSetting().getCalculationType()}`);
workbook.save("ShowValuesAsDifferenceFrom.xlsx");
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.