استخدام المعلمات في مصادر البيانات

يلزم تعيين معلمة افتراضية في مصدر بيانات إذا أردت تمكين استخدام المتغيرات في الاستعلامات التي ينشئها Essbase عند التعامل مع البيانات المخزنة خارج المكعب.

للتمكن من تعيين المعلمة الافتراضية،

1. يلزم الحصول على اتصال بمصدر البيانات الخارجي، أو تكوينه (مثل تكوين اتصال بقاعدة بيانات أوراكل).

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

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

   يمكنك تعريف مصدر بيانات تعريفًا عموميًا إذا كان من اللازم إتاحته لكل التطبيقات، أو يمكن قصر تعريفه على مستوى التطبيق فقط.

   1. لتكوين مصدر بيانات عام، يجب أن تكون مسؤول الخدمة. انقر على المصادر، وانقر على علامة تبويب مصادر البيانات ضمن اسم المستخدم الخاص بك، ثم انقر على تكوين مصدر بيانات.

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

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

   3. بالنسبة لبيانات الاسم أدخل اسمًا لمصدر البيانات.

   4. بالنسبة لبيانات الاستعلام أدخل استعلامًا (يتم في هذا المثال استخدام SQL). وحتى يكون الاستعلام محددًا بمعلمات لا بد من تضمين شرط ترشيح (عبارة WHERE) تربط تخطيطيًا بين عمود علائقي في المصدر ومتغير تعويض. تتم الإشارة إلى موضع المتغير باستخدام متغير تعويض ? في صيغة الاستعلام. وينوب متغير التعويض هنا عن معلمة ستقوم بإدخالها في خطوة لاحقة.

      select * from SB_DT where DIMENSION_YEAR=?

      على سبيل المثال، لنفترض أن قاعدة البيانات العلائقية تشتمل على الجدول التالي، واسمه SB_DT. يشتمل الجدول على العمود DIMENSION_YEAR وقيمه أسماء أشهر:
      
      

      للتمكن من استخدام متغير لتحديد قيم أشهر من العمود DIMENSION_YEAR، عليك باستخدام صيغة المرشح التالية في الاستعلام: where DIMENSION_YEAR=?
      
      

   5. انقر على التالي.

   6. في خطوة الأعمدة، عليك باستخدام نوع البيانات الملائم الذي يمكن في Essbase إقرانه بكل عمود من البيانات العلائقية المصدر الخاصة بك.

      على سبيل المثال، عليك بتعيين الأعمدة الرقمية إلى النوع مزدوج مع ترك الأعمدة الأبجدية الرقمية بالنوع سلسلة.

      
      
      
      
      

   7. انقر على التالي.

   8. في خطوة "المعلمات" يتم تكوين Param1 – وهذه المعلمة موجودة بسبب استخدام ? في الاستعلام بالخطوة "عام".

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

      يمكنك كذلك إعادة تسمية Param1 لتحمل اسمًا ذا دلالة في إطار حالة الاستخدام الخاصة بك. على سبيل المثال، يمكنك إعادة تسميتها لتكون param_G_month في إشارة إلى استخدام المعلمة لمتغير عام خاص بالشهر الحالي، كما يمكنك إعادة تسميتها إلى param_<appName>_month للإشارة إلى استخدام المعلمة لمتغير على مستوى التطبيق خاص بالشهر الحالي. ومن المفيد تخصيص أسماء المعلمات عند تصحيح أخطاء المعلمات باستخدام ملفات سجل الخادم في Essbase.

      
      
      
      
      

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

   9. انقر على التالي.

   10. في معاينة لاحظ أن المعلمة الافتراضية قد تم تطبيقها على الاستعلام. ونتيجة لذلك تم ملء المعاينة بسجلات المصدر الخارجي فقط، حيث قيمة العمود DIMENSION_YEAR هي Jan.

       
       
       
       
       

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

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

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

في هذا المثال ستقوم باستخدام متغير استبدال في Essbase لتعريف الشهر الحالي. فبدلاً من تحديث مصادر البيانات شهريًا لسحب بيانات للشهر الحالي، يمكن ترك مصادر البيانات دون تعديل وتحديث متغيرات الاستبدال التي قمت بتعريفها دون غيرها.

1. تكوين متغير استبدال عام أو على مستوى التطبيق.

   
   
   
   
   

2. يلزم الحصول على اتصال بمصدر البيانات الخارجي، أو تكوينه (مثل تكوين اتصال بقاعدة بيانات أوراكل).

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

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

   يمكنك تعريف مصدر بيانات تعريفًا عموميًا إذا كان من اللازم إتاحته لكل التطبيقات، أو يمكن قصر تعريفه على مستوى التطبيق فقط.

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

   2. بالنسبة لبيانات الاسم أدخل اسمًا لمصدر البيانات.

   3. بالنسبة لبيانات الاستعلام أدخل استعلامًا (يتم في هذا المثال استخدام SQL). وحتى يكون الاستعلام محددًا بمعلمات لا بد من تضمين شرط ترشيح (عبارة WHERE) تربط تخطيطيًا بين عمود علائقي في المصدر ومتغير تعويض. تتم الإشارة إلى موضع المتغير باستخدام متغير تعويض ? في صيغة الاستعلام. وينوب متغير التعويض هنا عن معلمة ستقوم بإدخالها في خطوة لاحقة.

      select * from SB_DT where DIMENSION_YEAR=?

      على سبيل المثال، لنفترض أن قاعدة البيانات العلائقية تشتمل على الجدول التالي، واسمه SB_DT. يشتمل الجدول على العمود DIMENSION_YEAR وقيمه أسماء أشهر:
      
      

      للتمكن من استخدام متغير لتحديد قيم أشهر من العمود DIMENSION_YEAR، عليك باستخدام صيغة المرشح التالية في الاستعلام: where DIMENSION_YEAR=?
      
      

   4. انقر على التالي.

   5. في خطوة الأعمدة، عليك باستخدام نوع البيانات الملائم الذي يمكن في Essbase إقرانه بكل عمود من البيانات العلائقية المصدر الخاصة بك.

      على سبيل المثال، عليك بتعيين الأعمدة الرقمية إلى النوع مزدوج مع ترك الأعمدة الأبجدية الرقمية بالنوع سلسلة.

      
      
      
      
      

   6. انقر على التالي.

   7. في خطوة "المعلمات" يتم تكوين Param1 – وهذه المعلمة موجودة بسبب استخدام ? في الاستعلام بالخطوة "عام". للتمكن من تخصيص Param1 بحيث تشير إلى متغير استبدال، انقر على استخدام المتغيرات، مع تحديد متغير استبدال من القائمة المنسدلة القيمة.

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

      يمكنك إعادة تسمية Param1 لتحمل اسمًا ذا دلالة في إطار حالة الاستخدام الخاصة بك. على سبيل المثال، يمكنك إعادة تسميتها لتكون param_G_month في إشارة إلى استخدام المعلمة لمتغير عام خاص بالشهر الحالي، كما يمكنك إعادة تسميتها إلى param_<appName>_month للإشارة إلى استخدام المعلمة لمتغير على مستوى التطبيق خاص بالشهر الحالي. ومن المفيد تخصيص أسماء المعلمات عند تصحيح أخطاء المعلمات باستخدام ملفات سجل الخادم في Essbase.

      
      
      
      
      

   8. انقر على التالي.

   9. في معاينة لاحظ أن متغير الاستبدال قد تم تطبيقه على الاستعلام. ونتيجة لذلك تم ملء المعاينة بسجلات المصدر الخارجي فقط، حيث قيمة العمود DIMENSION_YEAR هي Aug.

      
      
      
      
      

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