تكوين الرسم البياني لمستكشف البيانات

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

تدعم معلمات خيار التمثيل المرئي ثلاثة خيارات:

  • الشبكة - تعرض البيانات في شبكة مستكشف البيانات القياسية
  • الرسم البياني - يعرض البيانات في شكل رسم بياني
  • المخطط - يتيح إمكانية استدعاء مخطط واجهة مستخدم لعرض البيانات

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

ملاحظة: إذا كان خيار العرض الوحيد هو شبكة قياسية، فليس من الضروري تحديد الشبكة كمعلمة تمثيل مرئي.

يتم توفير معلمات خيار التمثيل المرئي في أنواع مناطق "مستكشف البيانات - جملة SQL فردية" (F1–DE-SINGLE) ومستكشف البيانات - جمل SQL متعددة" (F1–DE).

تكوين معلمة خيار التمثيل المرئي

يتم استخدام رموز الاختصار لتحديد سمات نوع الخيار ضمن قيمة المعلمة.

بالنسبة للشبكة، يكون رمز الاختصار هو ‘optiontype=GRID’. لا توجد رموز اختصار أخرى مطلوبة.

بالنسبة للمخطط، رموز الاختصار هي ‘optiontype=MAP map=MAP_​CD schemaPath=xpath’ حيث ‘MAP_​CD’ هو معرف مخطط واجهة المستخدم و‘xpath’ هو مسار مخطط واجهة المستخدم. في معظم حالات الاستخدام، ستتطابق عناصر المخطط مع مجموعة النتائج من مستكشف البيانات، وفي هذه الحالة لا يلزم وجود رمز اختصار schemaPath. في حالة وجود عناصر إضافية لمخطط واجهة المستخدم، ستحدد سمة schemaPath نقطة توصيل المجموعة التي سيتم نسخ معلومات مستكشف البيانات إليها.

بالنسبة للرسم البياني، يكون رمز الاختصار لنوع الخيار هو ‘optiontype=CHART’. يتبع ذلك سمات تكوين الرسم البياني المناسبة، الموضحة في القسم أدناه.

تكوين الرسم البياني

يتم استخدام السمات التالية لتكوين تمثيل رسومي لمجموعة من البيانات.

تحدد سمة ‘oraChart:’ نوع الرسم البياني المطلوب عرضه والتكوين العام الخاص به. فيما يلي مجموعة معلمات التكوين المُتاحة لهذه السمة:

المعلمة

القيم

الوصف

النوع:

قرصي

مكدس

عنقودي

خطي

مساحي

مختلط

تحديد نوع الرسم البياني المطلوب عرضه.

مطلوب

showLegend:

true

خطأ

تحديد ما إذا كان يجب أن يحتوي الرسم البياني على وسيلة إيضاح.

اختياري (القيمة الافتراضية هي صواب)

legendPosition:

يسار

يمين

أسفل

أعلى

تحديد موضع ظهور وسيلة الإيضاح.

اختياري (القيمة الافتراضية هي يمين)

سيؤدي تعيين الموضع على يسار أو يمين إلى ظهور عرض عمودي آليًا.

سيؤدي تعيين الموضع على أعلى أو أسفل إلى ظهور عرض أفقي آليًا.

legendBorder:

true

خطأ

تحديد ما إذا كان يجب عرض وسيلة الإيضاح بحد حولها.

اختياري (القيمة الافتراضية هي خطأ)

depth:

true

خطأ

تشير قيمة صواب إلى عرض رسم بياني بعمق ثلاثي الأبعاد.

اختياري (القيمة الافتراضية هي خطأ، وهي رسم بياني ثنائي الأبعاد)

animate:

true

خطأ

تشير قيمة صواب إلى أنه يجب أن يكون الرسم البياني متحرك عند العرض.

اختياري (القيمة الافتراضية هي صواب) عند استخدام مجموعات بيانات كبيرة، يجب مراعاة تعطيل الرسم المتحرك.

dataCursor:

تشغيل

إيقاف تشغيل

يؤدي التعيين على قيمة تشغيل إلى تمكين التحويم في كل مكان في الرسم البياني.

اختياري (القيمة الافتراضية هي إيقاف) لا ينطبق على مخططات الرسم البياني القرصي.

الاتجاه:

أفقي

تحديد اتجاه الرسم البياني. لا ينطبق هذا إلا على مخططات الرسم البياني المختلط والمساحي والشريطي والخطي.

بمعنى، تحدد المعلمة oraChart="type:cluster; orientation:horizontal" مخطط مجموعة أفقي.

اختياري (القيمة الافتراضية هي عمودي)

تحدد سمة oraChartSeries معلومات المصدر للرسم البياني. تدعم معظم الرسومات البيانية 5 من هذه السمات مع رموز الاختصار التالية:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

تدعم مخططات الرسم البياني المكدس عدد لا نهائي من السلاسل من خلال الاستمرار في إضافة سمات oraChartSeries6 وما فوقها، ولكن يجب مراعاة مؤشرات الأداء وحدود الذاكرة عند استخدام عدد كبير للغاية من السلاسل. كل السمات متطابقة في الصياغة وتقبل نفس المعلمات، كما هو موضح أدناه.

ملاحظة: تحتاج كل مخططات الرسم البياني إلى oraChartSeries1. اختياريًا، يمكن أن تحتوي مخططات الرسم البياني من النوع مكدس أو مجموعة أو خطي على سمات سلاسل إضافية (للعديد من السطور/الشرائط).

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

فيما يلي مجموعات معلمات التكوين المُتاحة للسمة oraChartSeriesN:

المعلمة

القيم

الوصف

القائمة:

قيمة XPath

يحدد المسار X للقائمة في XML التي تحتوي على البيانات للرسم البياني.

مطلوب فقط لتعريفات HTML في مخططات واجهة المستخدم. يتم اشتقاق قيم مستكشف البيانات من أعمدة المنطقة.

المبلغ:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يحتوي على المبلغ المطلوب إنشاء رسم بياني له. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

مطلوب

المحور س:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يحتوي على بيانات المحور س. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يتم تحديد XPath للعنصر.

مطلوب لمخططات الرسم البياني المختلط والمساحي والخطي والمجموعة والمكدس.

xaxisFormat:

التاريخ

التاريخ/الوقت

الوقت

localDate

السلسلة

تحديد تنسيق بيانات المحور س.

إذا كانت القيمة هي تاريخ أو dateTime أو وقت، تظهر القيمة بالتنسيق كما هو محدد في ملف بيانات العرض للمستخدم.

في حالة localDate أو سلسلة، يتم عرض البيانات بدون تنسيق خاص.

اختياري (القيمة الافتراضية هي تاريخ)

التسمية:

قيمة النص

تحديد تسمية القيمة الجاري رسمها بيانيًا.

يجب تحديد هذا الإعداد أو labelPath:.

labelPath:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يوفر التسمية للمبلغ الذي يتم إنشاء رسم بياني له. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

يجب تحديد هذا الإعداد أو label:.

العملة:

رمز عملة صالح

تحديد رمز العملة للقيمة الجاري رسمها بيانيًا.

اختياري.

currencyPath:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يوفر رمز العملة للمبلغ الذي يتم إنشاء رسم بياني له. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

اختياري.

hoverText:

قيمة النص

تحديد نص التحويم لعنصر الرسم البياني.

اختياري (يوجد نص تحويم افتراضي مُتاح دائمًا) يتم تجاهله إذا تم تحديد hoverTextPath:.

متغيرات الاستبدال التالية مُتاحة.

  • $label يتم استبدال هذه القيمة بنص التسمية كما هو محدد بواسطة الإعداد label: أو labelPath:.
  • $amount يتم استبدال هذه القيمة بنص القيمة كما هو محدد بواسطة الإعداد amount:.
  • $axis يتم استبدال هذه القيمة بنص المحور س.
  • $% يتم استبدال هذه القيمة "بشريحة" النسبة المئوية للرسم البياني الشريطي أو القرصي.
  • $newline سيفرض هذا فاصل أسطر.

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

مثال:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يوفر نص التحويم لعنصر الرسم البياني. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

يمكن أن يستخدم نص التحويم في العنصر كل وظائف الاستبدال الموضحة أعلاه في وصف hoverText:.

اختياري.

النوع:

شريطي

خطي

مساحي

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

يحدد المثال التالي رسم بياني مختلط حيث يتم عرض سلسلة واحدة كشرائط وأخرى كمساحة.

oraChart="type:combo;" 
oraChartSeries1="xaxis:C3; 
label:C2; amount:C1;type:bar" 
oraChartSeries2="xaxis:C3; 
label:C2; amount:C1;type:area"

navOpt:

رمز خيار تنقل صالح.

تحديد خيار تنقل ليتم تنشيطه عندما يتم نقر عنصر الرسم البياني.

اختياري.

navOptPath:

Cn

Pn

قيمة XPath

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

اختياري

لاحظ أنه يجب تكوين كل من navOpt: وnavOptPath:. تتم معالجة خيار التنقل navOptPath: أولاً. يتم استخدام قيمة موجودة إن وجدت، وما غير ذلك يتم استخدام القيمة الموجودة في الإعداد navOpt:. يعني هذا أن تعريف الرسم البياني يمكن أن يتضمن خيار تنقل افتراضي وأن خيار التنقل الموجود في البيانات سيتجاوزه.

المفتاح:

Cn

Pn

قيمة XPath

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

يكون مطلوبًا إذا تم تحديد navOpt: أو navOptPath:.

ملاحظة: لا يمكن إلا تكوين حقل مفتاح واحد فقط لخيار تنقل.

السكريبت:

اسم سكريبت مساعد عمليات الأعمال

تحديد سكريبت مساعد عمليات أعمال ليتم تنشيطه عندما يتم نقر عنصر الرسم البياني.

اختياري

عندما يتم تنفيذ سكريبت، ستصبح كل العناصر من بيانات الرسم البياني متوفرة للسكريبت كمتغيرات مؤقتة.

scriptPath:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يوفر سكريبت مساعد عمليات الأعمال المطلوب تنشيطه عند النقر على عنصر الرسم البياني. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

اختياري

لاحظ أنه يجب تكوين كل من script: وscriptPath:. تتم معالجة خيار السكريبت scriptPath: أولاً. يتم استخدام قيمة موجودة إن وجدت، وما غير ذلك يتم استخدام القيمة الموجودة في الإعداد script:. يعني هذا أن تعريف الرسم البياني يمكن أن يتضمن سكريبتًا افتراضيًا وأن السكريبت الموجود في البيانات سيتجاوزه.

اللون:

قيمة RGB/رمز لون HTML

اختياري (يتم تطبيق الألوان الافتراضية)

تحديد لون السلسلة. التنسيق هو رمز لون HTML صالح، على سبيل المثال: أخضر أو أزرق. توجد كل أسماء الألوان الصالحة في هذا الارتباط: http://www.w3schools.com/htmL/html_colornames.asp.

بشكل بديل، يمكن استخدام تنسيق اللون الأحمر والأخضر والأزرق (RGB). (00FF00 هو أخضر 0000FF هو أزرق)

ملاحظة: للحصول على معلومات حول استخدام لون HTML "الأحمر" وتأثيره على إمكانية الوصول، ارجع إلى تباين الألوان.

colorPath:

Cn

Pn

قيمة XPath

تحديد العنصر الذي يحتوي على لون السلسلة. بالنسبة لمستكشفات البيانات، سيكون هذا معرف عمود ما بعد المعالجة أو SQL. بالنسبة لتعريفات HTML، يجب تحديد XPath للعنصر.

يتم تطبيق التنسيقات الصالحة الموضحة في الإعداد اللون:.

اختياري (يتم تطبيق الألوان الافتراضية)

pieColors:

قيم RGB/رمز لون HTML

تحديد الألوان الخاصة بالسلسلة الدائرية. يمكن تحديد أي عدد من رموز ألوان HTML أو قيم ألوان RGB على أن يتم فصلها بمسافات. أمثلة: 

pieColors: green blue
pieColors: 00FF00 0000FF

اختياري (يتم تطبيق الألوان الافتراضية في حالة تجاوز السلسلة للقيم المحددة)

توفر السمة oraChartBroadcast: إمكانية نقل قيمة من الرسم البياني إلى سياق البوابة. يمكن نقل عدد غير محدود من الحقول، وتكوينها كأزواج أسماء/قيم، على سبيل المثال: oraChartBroadcast="FIELD_​NAME1:C1;FIELD_​NAME2:C2;" حيث FIELD_​NAMEn هو اسم حقل سياق البوابة المطلوب نقله وCn (أو Pn) هو العنصر الذي يحتوي على قيمة البيانات المطلوب نقلها. يتم تحفيز النقل عن طريق النقر على قسم مقابل للرسم البياني.

بالنسبة لتعريفاتHTML في مخططات واجهة المستخدم، الصياغة هي oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;" حيث ‘xpathn’ هو العنصر في مخطط القائمة الذي يحتوي على قيمة البيانات المطلوب نقلها.

أمثلة على تكوين المنطقة

منطقة تحتوي على رسم بياني قرصي بسيط

في هذا المثال، يلخص SQL للمنطقة قيود المهمة حسب الدور. تعريفات الأعمدة هي:

  • C1 - وصف الدور

  • C2 - عدد قيود المهمة حسب الدور

  • C3 - معرف الدور

خيار التمثيل المرئي 1

يعرض هذا الخيار قيود المهمة حسب الدور كرسم بياني قرصي. سيتم نقل معرف الدور إلى البوابة عند النقر على القسم المقابل للرسم البياني القرصي.

optiontype=CHART
oraChart="type:pie;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="ROLE_ID:C3"

منطقة تحتوي على نوعين من الرسم البياني

في هذا المثال، يلخص SQL للمنطقة قيود المهمة حسب الأولوية، ويقوم أيضًا باحتساب الأعداد المنفصلة حسب حالة المهمة ضمن الأولوية. تعريفات الأعمدة هي:

  • C1 - وصف الأولوية

  • C2 - عدد قيود المهمة حسب الأولوية

  • C3 - قيمة إشارة الأولوية

  • C4 - عدد المهام المفتوحة حسب الأولوية

  • C5 - عدد المهام قيد التنفيذ حسب الأولوية

  • C6 - تسمية شريط المهام المفتوحة في الرسم البياني العنقودي

  • C7 - تسمية شريط المهام قيد التنفيذ في الرسم البياني العنقودي

خيار التمثيل المرئي 1

يعرض هذا الخيار قيود المهمة حسب الأولوية كرسم بياني قرصي. سيتم نقل قيمة الأولوية إلى البوابة عند النقر على القسم المقابل للرسم البياني القرصي.

optiontype=CHART
oraChart="type:pie; legendBorder:true;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"

خيار التمثيل المرئي 2

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

optiontype=CHART oraChart="type:cluster;  showLegend:true;" 
oraChartSeries1="xaxis:C1; xaxisFormat:string; labelPath:C6; amount:C4;hoverText:$label$newline$amount;"
oraChartSeries2="xaxis:C1; xaxisFormat:string; labelPath:C7; amount:C5;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"