تصف هذه المقالة بناء جملة صيغة الدالة CUBESET وطريقة استخدامها في Microsoft Excel.
الوصف
تعرّف مجموعة محسوبة من قيم أعضاء أو مجموعة عن طريق إرسال تعبير مجموعة إلى المكعب على الخادم، مما يؤدي إلى إنشاء المجموعة، ثم إرجاع تلك المجموعة إلى Microsoft Excel.
بناء الجملة
CUBESET(connection, set_expression, [caption], [sort_order], [sort_by])
يحتوي بناء جملة الدالة CUBESET على الوسيطات التالية:
-
Connection مطلوبة. وهي سلسلة نصية لاسم الاتصال بالمكعب.
-
Set_expression مطلوبة. وهي سلسلة نصية لتعبير مجموعة ينتج عنها مجموعة أعضاء أو مجموعات قيم. يمكن أيضاً أن تكون Set_expression عبارة عن مرجع خلية لنطاق Excel يحتوي على واحد أو أكثر من الأعضاء أو مجموعات القيم أو المجموعات التي تم تضمينها في المجموعة.
-
Caption اختيارية. وهي سلسلة نصية يتم عرضها في الخلية بدلاً من التسمية التوضيحية، وذلك إذا تم تعريف إحداها، من المكعب.
-
Sort_order اختيارية. نوع الفرز الذي تريد تطبيقه، إن وجد، ويمكن أن يكون أياً مما يلي:
|
العدد الصحيح |
الثابت التعدادي |
الوصف |
الوسيطة Sort_by |
|
0 |
SortNone |
ترك المجموعة بالترتيب الموجود. |
يتم تجاهلها |
|
1 |
SortAscending |
فرز المجموعة بترتيب تصاعدي باستخدام sort_by. |
مطلوبة |
|
2 |
SortDescending |
فرز المجموعة بترتيب تنازلي باستخدام sort_by. |
مطلوبة |
|
3 |
SortAlphaAscending |
فرز المجموعة بترتيب ألفا التصاعدي. |
يتم تجاهلها |
|
4 |
Sort_Alpha_Descending |
فرز المجموعة بترتيب ألفا التنازلي. |
يتم تجاهلها |
|
5 |
Sort_Natural_Ascending |
فرز المجموعة بالترتيب التصاعدي الطبيعي. |
يتم تجاهلها |
|
6 |
Sort_Natural_Descending |
فرز المجموعة بالترتيب التنازلي الطبيعي. |
يتم تجاهلها |
-
إن القيمة الافتراضية تساوي 0. يؤدي فرز ألفا الخاص بمجموعة القيم إلى الفرز حسب العنصر الأخير في كل مجموعة قيم. لمزيد من المعلومات حول ترتيبات الفرز المختلفة هذه، انظر نظام تعليمات Microsoft Office SQL Analysis Services.
-
Sort_by اختيارية. سلسلة نصية للقيمة التي سيتم الفرز بواسطتها. على سبيل المثال، للحصول على المدينة ذات المبيعات الأعلى، قد تكون set_expression مجموعة من المدن، وتكون sort_by هي مقياس المبيعات. أو، للحصول على المدينة ذات عدد السكان الأعلى، قد تكون set_expression مجموعة من المدن، وتكون sort_by هي مقياس عدد السكان. إذا sort_order تطلّب sort_by، وتم حذف sort_by، ترجع CUBESET رسالة الخطأ #VALUE!.
ملاحظات
-
عند تقييم الدالة CUBESET، إنها تعرض مؤقتاً الرسالة "#GETTING_DATA…" في الخلية قبل استرداد كافة البيانات.
-
إذا لم يكن اسم الاتصال اتصال مصنف صحيح يتم تخزينه في المصنف، ستقوم CUBESET بإرجاع قيمة الخطأ #NAME؟. إذا كان خادم المعالجة التحليلية عبر الإنترنت (OLAP) ليس قيد التشغيل أو غير متوفر، أو يرجع رسالة خطأ، ستقوم CUBESET بإرجاع قيمة الخطأ #NAME؟.
-
إذا كان بناء جملة set_expression غير صحيح أو إذا كانت المجموعة تحتوي على عضو واحد على الأقل ذي بُعد مختلف عن الأعضاء الآخرين، فتُرجع الدالة CUBESET قيمة الخطأ #N/A.
-
إذا كان set_expression أطول من 255 حرفاً، وهو الحد الأقصى لوسيطة الدالة، فإن الدالة CUBESET ترجع قيمة الخطأ #VALUE! قيمة الخطأ. لاستخدام سلاسل نصية أطول من 255 حرفاً، أدخل السلسلة النصية في خلية (يكون الحد الأقصى 32767 حرفاً)، ثم استخدم مرجع خلية كوسيطة.
-
قد تُرجع الدالة CUBESET قيمة الخطأ #N/A إذا قمت بالإشارة إلى عنصر يستند إلى جلسة عمل، مثل عضو محسوب أو مجموعة مسماة، في PivotTable عند مشاركة اتصال، ويتم حذف PivotTable هذا أو تحويل PivotTable إلى صيغ. (ضمن علامة التبويب خيارات، في المجموعة أدوات، انقر فوق أدوات OLAP، ثم فوق التحويل إلى صيغ).
أمثلة
=CUBESET("Finance","Order([Product].[Product].[Product Category].Members,[Measures].[Unit Sales],ASC)","Products")
=CUBESET("Sales","[Product].[All Products].Children","Products",1,"[Measures].[Sales Amount]")
