تعريفات المؤشرات
يحدّد تعريف المؤشر ما يُقاس، والصفوف التي تُحتسب، وسلوك الرقم مع الزمن. تُعرَّف المؤشرات الجديدة في الطبقة الدلالية، أما المؤشرات المحفوظة مباشرةً على جدول فلها نافذة أبسط.
تعريف مؤشر في الطبقة الدلالية
- في صفحة المؤشرات، انقر إنشاء مؤشر، فتُفتح صفحة الطبقة الدلالية. ولك أن تفتحها كذلك من البيانات بزر النموذج الدلالي.
- في وضع البناء، تأكد أن الكيان الذي تريد قياسه مُدرج تحت كيانات العمل، وإلا فأضفه أولًا. راجع تعديل الحقول.
- تحت المؤشرات، انقر إضافة مؤشر واملأ الحقول التالية.
- انقر فحص لتطابق النموذج بمخطط بياناتك الفعلي.
- انقر حفظ، وراجع قائمة التغييرات، ثم انقر تأكيد وحفظ.
يحسب كيوبت المؤشر الجديد بعد الحفظ، ويظهر في صفحة المؤشرات.
حقول المؤشر
- الاسم: الاسم الذي يظهر في صفحة المؤشرات وفي لوحات البيانات.
- يقيس: الكيان الذي يُحسب عليه المؤشر.
- طريقة حساب الرقم، وتختارها من عمود أو معادلة أو SQL:
- عمود: اختر طريقة الحساب (المجموع أو المتوسط أو العدد أو عدد القيم المختلفة أو أدنى قيمة أو أعلى قيمة) والعمود في من العمود. ومع العدد اترك من العمود فارغًا لعدّ الصفوف، ويتطلب عدّ الصفوف مفتاحًا أساسيًا في الكيان.
- معادلة: اكتب تعبير SQL لرقم لا تكفيه طريقة حساب واحدة، كنسبة أو حصة، ويظل كيوبت يطبّق ما تحدده من تقسيم وتصفية وعلاقات.
- SQL: اكتب الاستعلام كاملًا بنفسك. يُنفَّذ كما كتبته حرفًا بحرف، ويجب أن يكون أمرًا واحدًا لا يفعل غير القراءة، وأن يعيد نتيجة واحدة ثابتة. ولا يسري عليه ما في المؤشر من تقسيم ولا تصفية.
- نوع القياس: تراكمي خلال فترة للمجاميع كالإيرادات وعدد الطلبات، أو آخر قيمة مسجّلة للمستويات الحالية كعدد المشتركين النشطين.
- فترة التقرير: كل الفترات أو أسبوع أو شهر أو ربع سنة أو سنة. تعرض الفترة ما مضى من الفترة الحالية وتقارنه بالمدة نفسها من الفترة السابقة، ولا تتاح مع آخر قيمة مسجّلة.
- الوحدة: مثل SAR أو % أو count.
- الوصف: ما يشمله الرقم وما يستبعده، ويقرؤه المساعد.
- التصنيف: يحدد مكان المؤشر في فئات صفحة المؤشرات.
- الاسم بالعربية والوصف بالعربية: يظهران إذا كانت الواجهة بالعربية.
- التقسيم حسب: الأبعاد التي يُقسَّم بها الرقم. والأسماء التي فيها نقطة تأتي من كيان مرتبط، مثل
store.region. - تُحتسب الصفوف فقط عندما: شروط تصفية، يتكوّن كل منها من العمود وعامل مقارنة في يكون والقيمة. ولا يُحتسب الصف إلا إذا تحققت الشروط كلها.
تعريف مؤشر في وضع الكود
في وضع الكود، المؤشر عنصر تحت metrics في ملف YAML. اختر إدراج ثم مؤشر ليُضاف مؤشر في موضعه الصحيح، أو اكتبه بنفسك. ويشرح تبويب دليل الصياغة الحقول كلها. وفي وضع الكود تستطيع كذلك كتابة التصفية في عدة كتل all، فيُحتسب الصف إذا طابق كتلةً واحدة منها.
المؤشرات المحفوظة على جدول
من المؤشرات ما يُحفظ مباشرةً على جدول لا على كيان:
- المؤشرات التي ينشئها المساعد مباشرةً من محادثة.
- المؤشرات التي ينشئها كيوبت لبطاقات الرقم الواحد حين يُنشئ المساعد لوحة بيانات.
- المؤشرات القديمة التي أُنشئت قبل الطبقة الدلالية.
تعرض الطبقة الدلالية هذه المؤشرات تحت خارج هذا النموذج في تبويب أين تُستخدم، ولا تغيّرها عند حفظ النموذج. والنقر على واحد منها في صفحة المؤشرات يفتح نافذة تعديل المؤشر:
- عدّل الاسم والوصف والاسم (بالعربية) والوصف (بالعربية).
- إذا كان في مساحة العمل أكثر من اتصال، فاختر مصدر البيانات.
- صِف طريقة الحساب بلغة واضحة في التعريف.
- انقر توليد التعريف، أو إعادة التوليد إذا كان للمؤشر تعريف سابق، فيحوّل كيوبت وصفك إلى التعريف المولَّد، وفيه طريقة الحساب وعوامل التصفية إن كانت.
- راجع على مدى الوقت (القيمة الأحدث أو الإجمالي خلال الفترة) والوحدة وفترة التقرير والفئة.
- انقر حفظ. ويبقى زر الحفظ معطّلًا ما دامت في التعريف المولَّد ملاحظات.
إذا حفظت تعريفًا معدّلًا، أعاد كيوبت حساب القيمة وبناء المنحنى في الخلفية.
تعريف المؤشرات بالمساعد
يعرّف المساعد المؤشرات عنك إذا كانت قدرة المؤشرات والنموذج الدلالي مفعّلة وكان دورك المالك أو المسؤول، فيضيف مؤشرات إلى النموذج الدلالي، أو ينشئ مؤشرًا على جدول مباشرةً. وتُفحص تغييراته على النموذج قبل حفظها. راجع إنشاء مؤشر بالمساعد وصلاحيات المساعد.