استخدام متغيرات الاستبدال

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

على سبيل المثال، إذا ما تطلب عدد متنوع من اسكربتات العمليات الحسابية والمعادلات والمرشحات واسكربتات التقارير واسكربتات MDX، إذا ما تطلبوا الإشارة إلى الشهر الحالي، فلن تحتاج للبحث عن الشهر واستبداله كل قرابة 30 يومًا في مكتبة البيانات الاصطناعية للمكعبات. البديل عن هذا هو تعريف متغير استبدال بالاسم CurrMonth وتغيير القيمة المعينة له في كل شهر لتكون القيمة الملائمة. عندئذ تتغير كل بيانات المكعب الاصطناعية التي تشير إلى المتغير لتشير إلى الشهر الملائم.

فيما يلي مثال لمتغير استبدال بسيط يمثل الشهر الحالي:

اسم المتغير: CurrMonth

القيمة: Jan

تنطبق قيم متغيرات الاستبدال على جميع المستخدمين الذين ينفذون اسكربت عملية حسابية يشتمل على متغير. على سبيل المثال، إذا كانت قيمة المتغير CurrMonth هي Jan، فإن جميع الاسكربتات التي تشتمل على &CurrMonth سيتم تنفيذها لشهر يناير Jan. ويكون نطاق متغير الاستبدال كما يلي:

  • عام (لجميع التطبيقات والمكعبات على الخادم)
  • التطبيق (لجميع المكعبات في التطبيق)
  • المكعب (لمكعب واحد)

لتعريف متغير استبدال أو تحديثه لمكعب معين،

  1. في صفحة التطبيقات، افتح التطبيق وافتح قاعدة البيانات (المكعب).
  2. انقر على التخصيص، ثم على المتغيرات.
  3. لتكوين متغير جديد، انقر على تكوين، أدخل اسم المتغير وقيمته، وانقر على حفظصورة أيقونة حفظ (علامة الاختيار) في مربع حوار المتغيرات..
  4. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على القيمة (أو انقر على تحرير)، أدخل على القيمة المحدثة، واضغط على Enter (أو انقر على حفظ).
  1. في واجهة Essbase على الويب، في صفحة التطبيقات، قم بتوسيع التطبيق لعرض المكعب الذي تريد تعديله.
  2. من قائمة إجراءات على الجانب الأيمن من المكعب، قم بتشغيل أداة الفحص.
  3. حدد علامة تبويب المتغيرات.
  4. لتكوين متغير جديد، انقر على إضافةصورة لأيقونة "إضافة".، أدخل اسم المتغير وقيمته، وانقر على حفظ.
  5. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على حقل القيمة، أدخل القيمة المحدثة، واضغط على Enter.
  6. انقر على إغلاق.

لتعريف متغير استبدال أو تحديثه لتطبيق معين،

  1. في صفحة التطبيقات، افتح التطبيق.
  2. انقر على التخصيص، ثم على المتغيرات.
  3. لتكوين متغير جديد، انقر على تكوين، أدخل اسم المتغير وقيمته، وانقر على حفظصورة أيقونة حفظ (علامة الاختيار) في مربع حوار المتغيرات..
  4. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على القيمة (أو انقر على تحرير)، أدخل على القيمة المحدثة، واضغط على Enter (أو انقر على حفظ).
  1. في صفحة التطبيقات ومن خلال القائمة "إجراءات" على الجانب الأيمن من التطبيق، قم بتشغيل أداة الفحص.
  2. حدد علامة تبويب المتغيرات.
  3. لتكوين متغير جديد، انقر على إضافةصورة لأيقونة "إضافة".، أدخل اسم المتغير وقيمته، وانقر على حفظ.
  4. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على حقل القيمة، أدخل القيمة المحدثة، واضغط على Enter.
  5. انقر على إغلاق.

لتعريف متغير استبدال أو تحديثه عالميًا،

  1. في صفحة التطبيقات، انقر على وحدة التحكم.
  2. انقر على إطار المتغيرات.
  3. لتكوين متغير جديد، انقر على تكوين، أدخل اسم المتغير وقيمته، وانقر على حفظصورة أيقونة حفظ (علامة الاختيار) في مربع حوار المتغيرات..
  4. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على القيمة (أو انقر على تحرير)، أدخل على القيمة المحدثة، واضغط على Enter (أو انقر على حفظ).
  1. في واجهة Essbase على الويب، انقر على وحدة التحكم.
  2. انقر على علامة تبويب المتغيرات.
  3. لتكوين متغير جديد، انقر على إضافة، أدخل اسم المتغير وقيمته، وانقر على حفظ.
  4. إذا كنت تقوم بتحرير قيمة متغير موجود، فانقر نقرًا مزدوجًا على حقل القيمة، أدخل القيمة المحدثة، واضغط على Enter.

ما إن يتم تعريف متغير الاستبدال حتى يصبح بوسعك استخدامه في اسكربتات العمليات الحسابية والمعادلات والمرشحات واسكربتات MDX وقواعد التحميل والتقارير. للإشارة إلى متغير ألحق به الرمز & كبادئة.

فيما يلي مثال على اسكربت عملية حسابية يشير إلى متغير استبدال:

FIX(&CurrMonth)
   CALC DIM (Measures, Product);
ENDFIX

فيما يلي مثال على معادلة تشير إلى متغير استبدال:

@ISMBR(&CurrMonth)

تتيح لك متغيرات الاستبدال في وقت التشغيل إمكانية تعريف متغيرات وقيمها في سياق إجراء بوقت التشغيل، مثل اسكربت عملية حسابية أو اسكربت MaxL أو متغير MDX. ويمكن تعيين قيم رقمية لمتغيرات الاستبدال في وقت التشغيل أو أن تشير إلى أسماء أعضاء. ويمكن تعيين قيمة افتراضية في حالة عدم قيام مستخدم بتغيير قيمة مدخلة فيها. كذلك، بالنسبة لاسكربتات العمليات الحسابية، يمكن ملء قيمة المتغير في وقت التشغيل من أعضاء بُعد موجود على شبكة Smart View. بالنسبة لاسكربتات العمليات الحسابية المشتملة على قيم متغيرات يتم ملؤها في وقت التشغيل، لا بد من تشغيل اسكربت العملية الحسابية من خلال Smart View نظرًا لعدم اشتمال المتغير على تعريف خارج سياق الشبكة.

يمكن تعريف متغيرات الاستبدال بوقت التشغيل في اسكربت عملية حسابية باستخدام أزواج من المفتاح-القيمة:

SET RUNTIMESUBVARS
{
   myMarket = "New York";
   salesNum = 100;
   pointD = "Actual"->"Final";
}

أو لتعريف متغيرات استبدال في وقت التشغيل تشتمل على قيم تتغير ديناميكيًا تبعًا لزاوية العرض، عليك بتعيين التعريف إلى زاوية العرض واستخدام صياغة XML لتمكين موجهات Smart View السياقية.

للحصول على المزيد من المعلومات، راجع