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

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

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

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

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

جلسة عمل

@{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