الأساليب المتقدمة: الإشارة إلى القيم المخزنة في المتغيرات

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

يمكنك الإشارة إلى أنواع مختلفة متعددة من المتغيرات في التحليلات ولوحات المعلومات والإجراءات: جلسة عمل ونموذج دلالي (مخزن) وعرض تقديمي وطلب وعام. وبوسع مؤلفي المحتوى تعريف متغيرات عرض تقديمي أو طلب أو متغيرات عامة بأنفسهم ولكن هناك أنواعًا أخرى (جلسة العمل ونموذج دلالي (المخزن) التي يتم تعريفها لك في النموذج الدلالي.

ملاحظة: لا يتوفر في Oracle Analytics دعمًا للمتغيرين :user و:password في صلاحيات الاتصال بمصدر البيانات.

نوع المتغير معرف في معرف بواسطة مزيد من المعلومات

جلسة عمل

  • نظام

  • غير النظام

النموذج الدلالي

مؤلفو نماذج البيانات

 حول متغيرات جلسة العمل

النموذج الدلالي (المخزن)

  • ديناميكي

  • ثابت

النموذج الدلالي

مؤلفو نماذج البيانات

 حول متغيرات النموذج الدلالي (المخزن)

عرض تقديمي

موجهات التحليلات ولوحات المعلومات

مؤلفو المحتوى

 حول متغيرات العرض

طلب

موجهات التحليلات ولوحات المعلومات

مؤلفو المحتوى

 حول متغيرات الطلب

عمومي

التحليلات

المسئولون

 حول المتغيرات العامة وتكوين متغيرات عامة

حول متغيرات جلسة العمل

تتم تهيئة متغيرات جلسة العمل عند قيام المستخدم بتسجيل الدخول.

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

متغيرات جلسة عمل النظام

هناك العديد من متغيرات جلسة عمل النظام التي يمكنك استخدامها في التقارير ولوحات المعلومات.

تحمل متغيرات جلسة عمل النظام أسماء محجوزة، بحيث لا يمكن استخدامها مع أي نوع آخر من المتغيرات.

متغير جلسة عمل النظام الوصف مثال لقيمة استعلام SQL (مربع حوار المتغير)

PORTALPATH

يحدد لوحة المعلومات الافتراضية التي يراها المستخدم عند تسجيل الدخول (ويمكن تجاوز هذا التفضيل بعد تسجيل الدخول).

لعرض 'mydashboard' عند قيام مستخدم بتسجيل الدخول:

 select ‘/shared/_portal/mydashboard’ from dual;

TIMEZONE

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

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

لتعيين المنطقة الزمنية عند تسجيل دخول مستخدم:

select ‘(GMT-08:00) Pacific Time (US & Canada)’ from dual;

DATA_TZ

تحديد إزاحة من المنطقة الزمنية الأصلية للبيانات.

يتيح لك هذا المتغير إمكانية تحويل منطقة زمنية بحيث يطلع المستخدمون على المنطقة الزمنية الملائمة.

لتحويل بيانات منطقة زمنية إلى التوقيت الرسمي الشرقي (EST):

select ‘GMT-05:00’ from dual;

هذا المثال يعني توقيت جرينتش (GMT) - 5 ساعات

DATA_DISPLAY_TZ

تحديد المنطقة الزمنية لعرض البيانات.

لعرض التوقيت الرسمي الشرقي (EST):

select ‘GMT-05:00’ from dual;

هذا المثال يعني توقيت جرينتش (GMT) - 5 ساعات

متغيرات جلسة العمل لغير النظام

تتم تسمية متغيرات جلسة العمل لغير النظام ويتم تكوينها في النموذج الدلالي الخاص بك.

على سبيل المثال، يمكن أن يقوم منشئ نماذج البيانات بتكوين المتغير SalesRegion تتم تهيئة باسم منطقة مبيعات مستخدم فور تسجيل دخول هذا المستخدم.

حول متغيرات النموذج الدلالي (المخزن)

متغير النموذج الدلالي (المخزن) عبارة عن متغير له قيمة مفردة في أي وقت.

يمكن لمتغيرات النموذج الدلالي (المخزن) أن تكون ثابتة أو ديناميكية. يشتمل متغير النموذج الدلالي (المخزن) الثابت على قيمة تظل موجودة دون تغير حتى يقوم المسؤول بتغييرها. يشتمل متغير النموذج الدلالي (المخزن) الديناميكي على قيم يتم تجديدها بواسطة البيانات المرجعة من الاستعلامات.

حول متغيرات العرض

يمكنك تكوين متغير عرض تقديمي عند تكوين موجه عمود أو موجه متغير.

النوع الوصف

موجه العمود

متغير العرض الذي تم تكوينه كجزء من موجه عمود يقترن بعمود، وتأتي القيم التي يمكنه أن يشتمل عليها من قيم الأعمدة.

للتمكن من تكوين متغير عرض كجزء من موجه عمود، في مربع حوار "موجه جديد" يجب تحديد متغير العرض في حقل تعيين متغير. أدخل اسمًا للمتغير في حقل اسم المتغير.

موجه المتغير

متغير العرض التقديمي الذي يتم تكوينه كجزء من موجه متغير لا يقترن بأي عمود، ويمكنك تعريف القيم التي يمكنه الاشتمال عليها.

للتمكن من تكوين متغير عرض كجزء من موجه متغير، في مربع حوار "موجه جديد" يجب تحديد متغير العرض في حقل موجه لـ. أدخل اسمًا للمتغير في حقل اسم المتغير.

يتم ملء قيمة متغير العرض من خلال موجه العمود أو المتغير الذي تم تكوينه معه. أي أنه في كل مرة يحدد مستخدم قيمة أو أكثر في موجه العمود أو المتغير، يتم تعيين قيمة متغير العرض إلى القيمة أو القيم التي يحددها المستخدم.

حول متغيرات الطلب

يتيح لك متغير الطلب إمكانية تجاوز قيمة متغير جلسة عمل ولكن للمدة المعينة فقط لطلب قاعدة بيانات تم بدؤه من موجه عمود. يمكنك تكوين متغير طلب كجزء من عملية تكوين موجه عمود.

يمكنك تكوين متغير طلب كجزء من عملية تكوين أحد الأنواع التالية من موجهات لوحة المعلومات:

  • يقترن أي متغير طلب تم تكوينه كجزء من موجه عمود مع عمود، وتأتي القيم التي يمكنه الحصول عليها من قيم الأعمدة.

    للتمكن من تكوين متغير طلب كجزء من موجه عمود، في مربع حوار "موجه جديد" يجب تحديد متغير الطلب في حقل تعيين متغير. أدخل اسم متغير جلسة العمل المطلوب تجاوزه في حقل اسم المتغير.

  • متغير الطلب الذي يتم تكوينه كجزء من موجه متغير لا يقترن بأي عمود، ويمكنك تحديد القيم التي يمكنه أن يشتمل عليها.

    للتمكن من تكوين متغير طلب كجزء من موجه متغير، في مربع حوار "موجه جديد" (أو مربع حوار "تحرير موجه") يجب تحديد متغير الطلب في حقل موجه لـ. ثم إدخال اسم لمتغير جلسة العمل المطلوب تجاوزه في حقل اسم المتغير.

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

هناك متغيرات بعينها في جلسة عمل النظام (مثل USERGUID أو ROLES) لا يمكن تجاوزها بواسطة متغيرات الطلب. المتغيرات الأخرى في جلسة عمل النظام، مثل DATA_TZ وDATA_DISPLAY_TZ (المنطقة الزمنية)، يمكن تجاوزها في حالة تكوينها باستخدام Model Administration Tool.

متغيرات الطلبات من نوع السلسلة والنوع الرقمي هي ما يدعم قيمًا متعددة فحسب. تقوم كل أنواع البيانات الأخرى بتمرير القيمة الأولى فقط.

حول المتغيرات العامة

المتغير العام هو عمود تم تكوينه عبر الجمع بين نوع بيانات محدد وقيمة. يمكن أن تكون القيمة: تاريخ، وتاريخ ووقت، ورقم، ونص، ووقت.

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

بوسع المستخدمين الحائزين على دور مسئول BI Service فقط إدارة (إضافة وتحرير وحذف) المتغيرات العامة.

يمكنك تكوين قيمة عامة أثناء عملية تكوين تحليل باستخدام مربع الحوار "تحرير معادلة العمود". بعد ذلك، يتم حفظ المتغير العام في الكتالوج مع إتاحته لكل التحليلات الأخرى ضمن نظام عميل محدد.

تكوين متغيرات عامة

يمكنك حفظ عملية حسابية بوصفها متغيرًا عامًا، ثم إعادة استخدامها في تحليلات مختلفة.

  1. افتح التحليل لتحريره.
  2. في جزء "الأعمدة المحددة"، انقر على خيارات بجوار اسم العمود.
  3. حدد تحرير معادلة لعرض علامة تبويب "معادلة العمود".
  4. انقر على المتغير وحدد عام.
  5. انقر على إضافة متغير عام جديد.
  6. أدخل قيمة في حقل الاسم. على سبيل المثال، gv_region أو date_and_time_global_variable أو rev_eastern_region_calc_gv.
    يجب أن يكون اسم المتغير العام كاملاً عند الإشارة إلى المتغير، ومن ثم يكون مسبوقًا بالبادئة النصية "global.variables". على سبيل المثال، المتغير العام المعين إلى الإيرادات المحسوبة يتم عرضه في مربع حوار "معادلة العمود" كالتالي:

    "Base Facts"."1- Revenue"*@{global.variables.gv_qualified}

  7. أدخل قيمًا في حقلي النوع والقيمة.
    • في حالة تحديد "وقت وتاريخ" كنوع بيانات، فأدخل القيمة، على النحو المبين في المثال التالي: 03/25/2004 12:00:00 AM
    • في حالة إدخال تعبير أو عملية حسابية كقيمة، يجب استخدام نوع البيانات "نص"، على النحو المبين في المثال التالي: "Base Facts"."1- Revenue"*3.1415
  8. انقر على موافق. تتم إضافة المتغير العام الجديد إلى مربع الحوار "إدراج متغير عام".
  9. حدد المتغير العام الجديد الذي قمت بتكوينه للتو، ثم انقر على موافق. يتم عندئذ عرض مربع حوار "تحرير معادلة العمود" مع إدراج متغير عام في جزء "معادلة العمود". يتم تحديد مربع الاختيار عناوين مخصصة تلقائيًا.
  10. أدخل اسمًا جديدًا للعمود الذي عينت له متغيرًا عامًا بما يعكس المتغير بشكل أكثر دقة.
  11. انقر على موافق.

الصيغة الخاصة بالإشارة إلي المتغيرات

يمكنك الإشارة إلى المتغيرات في التحليلات ولوحات المعلومات.

بينما تعتمد طريقة الإشارة إلى متغير على المهمة التي تقوم بتنفيذها. بالنسبة للمهام التي تظهر فيها حقول في مربع حوار، يجب عليك تحديد نوع المتغير واسمه فقط (وليست الصيغة بالكامل)، على سبيل المثال، الإشارة إلى متغير في تعريف المرشح.

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

النوع الصياغة مثال

جلسة عمل

@{biServer.variables['NQ_SESSION.variablename']}

حيث يكون variablename هو اسم متغير جلسة العمل، على سبيل المثال DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

النموذج الدلالي (المخزن)

@{biServer.variables.variablename}

أو

@{biServer.variables['variablename']}

حيث يكون variablename هو اسم المتغير، على سبيل المثال prime_begin

@{biServer.variables.prime_begin}

أو

@{biServer.variables['prime_begin']}

عرض أو طلب

@{variables.variablename}[format]{defaultvalue}

أو

@{scope.variables['variablename']}

حيث:

variablename هو اسم متغير العرض أو الطلب، على سبيل المثال MyFavoriteRegion.

(اختياري) الصيغة هي قناع صيغة يعتمد على نوع بيانات المتغير، على سبيل المثال، #؜##0، MM/DD/YY hh:mm:ss. (لاحظ أنه لا يتم تطبيق الصيغة على القيمة الافتراضية.)

(اختياري) defaultvalue عبارة عن مرجع متغير أو ثابت يشير إلى قيمة سيتم استخدامها إذا لم يتم ملء المتغير المشار إليه بواسطة variablename.

المجال يقوم بتعريف مؤهلات المتغير. يجب عليك تحديد النطاق عند استخدام متغير في مستويات متعددة (التحليلات وصفحات لوحات التحكم ولوحات التحكم) وإذا أردت الوصول إلى قيمة معينة. (إذا لم تقم بتحديد المجال، فعندئذٍ يكون ترتيب المستويات حسب الأسبقية هو التحليلات ثم صفحات لوحات المعلومات ثم لوحات المعلومات.)

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

@{variables.MyFavoriteRegion}{EASTERN REGION}

أو

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

أو

@{dashboard.variables['MyFavoriteRegion']}

أو

(@{myNumVar}[#,##0]{1000})

أو

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

أو

(@{myTextVar}{A, B, C})

عمومي

@{global.variables.variablename}

حيث يكون variablename هو اسم المتغير العام، على سبيل المثال gv_region. عند الإشارة إلى متغير عام، يجب استخدام الاسم الكامل كما هو مبين في المثال.

نمط تسمية المتغيرات العامة يجب أن يكون مطابقًا لمواصفات لغة كتابة الاسكربت ECMA لـ JavaScript. يجب ألا يتجاوز طول الاسم 200 حرف وألا يشتمل على مسافات مضمنة أو كلمات محجوزة أو أحرف خاصة. إذا لم تكن متطلبات لغة JavaScripting مألوفة بالنسبة لك، فاطلع على مرجع خارجي

@{global.variables.gv_date_n_time}

كما يمكنك الإشارة كذلك إلى متغيرات في التعبيرات. الإرشادات الخاصة بالإشارة إلى المتغيرات مبينة في الأقسام التالية:

متغيرات جلسة العمل

يمكن استخدام الإرشادات التالية للإشارة إلى متغيرات جلسة العمل في التعبيرات.

  • يتم تضمين متغير جلسة العمل باعتباره وسيطة للدالة VALUEOF.
  • يتم تضمين اسم المتغير بين علامتي اقتباس مزدوجتين.
  • يسبق متغير جلسة العمل الجزء NQ_SESSION ونقطة.
  • تضمين NQ_SESSION في علامات اقتباس مزدوجة.
  • يتم تضمين كل من الجزء NQ_SESSION واسم متغير جلسة العمل داخل أقواس هلالية.

على سبيل المثال:

"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")

متغيرات العرض

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

عند الإشارة إلى متغيرات عرض، استخدم هذه الصياغة:

@{variablename}{defaultvalue}

حيث يكون variablename هو اسم متغير العرض وdefaultvalue (اختياري) هو مرجع ثابت أو متغير يشير إلى قيمة يتم استخدامها إذا لم يتم ملء المتغير الذي تمت الإشارة إليه بواسطة variablename.

لتحويل نوع متغير إلى سلسلة أو تضمين عدة متغيرات، ضع المتغير بالكامل بين علامتي اقتباس مفردتين، على سبيل المثال :

'@{user.displayName}'

إذا لم تكن العلامة @ متبوعة بالقوس {، فسيتم التعامل معها باعتبارها علامة @. عند استخدام متغير عرض يمكن أن يشتمل على قيم متعددة، تختلف الصياغة تبعًا لنوع العمود.

استخدم الصياغة التالية في SQL بالنسبة لنوع العمود المحدد لإنشاء جمل SQL صالحة:

  • نصي — (@{variablename}['@']{'defaultvalue'})

  • رقمي — (@{variablename}{defaultvalue})

  • تاريخ-وقت — (@{variablename}{timestamp 'defaultvalue'})

  • تاريخ (التاريخ فقط) — (@{variablename}{date 'defaultvalue'})

  • وقت (الوقت فقط) — (@{variablename}{time 'defaultvalue'})

على سبيل المثال:

'@{user.displayName}'

متغيرات النموذج الدلالي (المخزن)

يمكن استخدام الإرشادات التالية للإشارة إلى متغيرات النموذج الدلالي (المخزن) في التعبيرات.

  • يتم تضمين المتغير باعتباره وسيطة للدالة VALUEOF.
  • يتم تضمين اسم المتغير بين علامتي اقتباس مزدوجتين.
  • تتم الإشارة إلى متغير نموذج دلالي (مخزن) ثابت حسب الاسم.
  • تتم الإشارة إلى متغير نموذج دلالي (مخزن) ديناميكي حسب الاسم المؤهل الكامل له.

على سبيل المثال:

CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END