إجراءات الجهاز

يتم تحميل بيانات إجراءات الجهاز المصدّرة من نظام التجميع المركزي كملف بتنسيق Landis+Gyr إلى الخدمات والمرافق من أوراكل كإجراء جهاز. ويُعد تخصيص معالجة إجراءات الجهاز أحد مهام التكوين الخاصة بك. يتم تسليم الوظيفة المطلوبة في المنتج الأساسي باعتبارها مشروعين OSB:

  1. SGG-D3-USAGE-BASE - تحتوي على مكونات مسئولة عن المعالجة "الفعلية" للبيانات الواردة. من الممكن ترقيته في المستقبل دون التأثير على إعدادات البيئة والتخصيص التي تم تعيينها في مشروع SGG-D3-EVENT-CM.

  2. SGG-D3-EVENT-CMيسمح بالتخصيص ويتيح إمكانية إتمام الترقيات المستقبلية بسهولة.

يتم تخزين إعدادات تكوين وقت التشغيل لمشروع SGG-D3-EVENT-CM في ملف EnvironmentSettings.xq XQuery. يمكنك استخدام هذا الملف لتعديل معالجة بيانات إجراءات الجهاز. على سبيل المثال، إذا كنت تريد تحميل بيانات أولية، عليك تحديد "صواب" لمحتوى عنصر populateRaw. يوضح الجدول التالي العناصر المضمنة في ملف EnvironmentSettings.xq:

العنصر

الوصف

القيم الصالحة

populateRaw

يحدد ما إذا تم ملء بيانات إجراءات الجهاز كبيانات أولية.

true

false

callPreProcessing

يحدد ما إذا تم استدعاء خدمة وكيل ما قبل المعالجة.

true

false

callPostProcessing

يحدد ما إذا كان يتم استدعاء خدمة وكيل ما بعد المعالجة.

true

false

destinationRootElement

يحمل اسم خدمة الويب الواردة لمنشأ المثيل لإجراء الجهاز.

modifyResultXMLInput

يحدد اسم وثيقة XQuery (دون امتداد "xq") المستخدمة لربط الحقول الإضافية من تنسيق XML "العادي" إلى تنسيق نتيجة XML المرسل كبيانات إجراء الجهاز. راجع ربط حقول إضافية لمزيد من المعلومات.

dateTimeInUTC

يشير إذا كان نظام Landis+Gyr يرسل معلومات تاريخ/وقت في UTC (صواب) أو التوقيت المحلي للجهاز (خطأ). إذا لم يتم توفيره، سيكون السلوك الافتراضي التوقيت المحلي للجهاز.

true

false

publishServices/service

يحدد اسم خدمة الأعمال داخل مشروع OSB المُستخدم لنشر البيانات على الأنظمة الخارجية (مثل نظام DataRaker لأوراكل).

filterEvents

يحدد ما إذا كان يجب ترشيح الإجراءات.

true

false

نشر الإجراءات

من الممكن أن يتم تكوين جيت واي الشبكات الذكي حتى يقوم بنشر إجراءات الجهاز ليتم استخدامها في DataRaker لأوراكل أو الأنظمة الخارجية الأخرى. يتم دعم هذه الوظيفة من خلال توليفة من مكونات OSB ومركبات BPEL.

تمكين نشر إجراء الجهاز

يتم تمكين نشر البيانات بالإشارة إلى خدمة أعمال ناشر في العنصر publishServices/service في الملف EnvironmentSettings.xq كالتالي:
<publishServices>
  <service>[publisherBusinessService]</service>
</publishServices>

يتم استخدام المكونات التالية المتوفرة بمشروع SGG-D3-EVENT-CM OSB في نشر بيانات إجراءات الجهاز على DataRaker لأوراكل:

  • سيتم استخدام خدمة الأعمال DataRakerBusinessService لإرسال البيانات إلى قائمة انتظار خدمات الرسائل من Java (JMS) المكونة مسبقًا (المحددة على أنها URI لنقطة نهاية)، والتي سيتم نشر الرسائل منها. هذه هي خدمة الأعمال التي يجب تحديدها في ملف EnvironmentSettings.xq.

  • يتم استخدام حساب الخدمة DataRakerServiceAccount لتحديد وصيانة اسم المستخدم وكلمة المرور اللازمين للوصول إلى قائمة انتظار JMS المحددة في خدمة الأعمال DataRakerBusinessService.

تكوين مخرجات نشر إجراءات الجهاز

يقوم مركب BPEL "SGGDRIntegration" بمعالجة نشر البيانات على DataRaker لأوراكل أو الأنظمة الأخرى. يتم نشر بيانات إجراءات الجهاز بالتنسيق "الأصلي" لبيانات إجراء الجهاز (تنسيق كائن عمل منشأ المثيل لإجراء الجهاز). يتضمن هذا التنسيق رموز إجراء جهاز قياسية. لمزيد من التفاصيل عن هذا التنسيق، اطلع على دليل المستخدم المسؤول عن مجموعة أدوات تطوير موفق جيت واي الشبكات الذكي للخدمات والمرافق من أوراكل .

ملاحظة: بالإضافة إلى ما سبق، "لا" يمكن تطبيق الترشيح على إجراءات الجهاز المنشورة من خلال هذه الميزة.

يمكن استخدام المعلمات التالية لتكوين تفاصيل كيفية إدخال البيانات على DataRaker لأوراكل، بما في ذلك الدليل الذي يتم ترحيل الملفات إليه ليتم استهلاكها بواسطة DataRaker لأوراكل، وعدد السجلات لكل ملف، ومعدل تكرار عمليات الاختيار، وما إلى ذلك. يتم تحديد هذه المعلمات أثناء التثبيت. لمزيد من التفاصيل حول تحديد القيم لهذه المعلمات، اطلع على دليل تثبيت جيت واي الشبكات الذكي للخدمات والمرافق من أوراكل (Oracle Utilities Smart Grid Gateway Installation Guide ).

المعلمة

الوصف

القيمة الافتراضية

SGG_DR_INT_QUEUE

اسم JNDI لقامة الانتظار لنشر بيانات القياس المنقولة الخاصة بجيت واي الشبكات الذكي (SGG).

هذه هي قائمة انتظار JMS المحددة في خدمة الأعمال DataRakerBusinessService. يجب "ألا" يتم تغيير ذلك.

DataRakerQueue

SOA_DR_PUBLISH_SIZE

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

100

SOA_DR_FILE_SIZE

الحد الأقصى لحجم الملف لملف (بيانات القياس المنقولة الخاصة بجيت واي الشبكات الذكي) المُجمع بالكيلوبايت.

524288

SOA_DR_ELAPSED_TIME

الفترة الزمنية بالثواني التي تؤدي، عند تجاوزها، إلى إنشاء ملف صادر جديد.

600

SOA_DR_POLLING_FREQ

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

60

SOA_DR_STAGING_DIR

نقطة/دليل التوصيل لدليل الترحيل الخاص بملفات بيانات القياس المنقولة المجمعة لجيت واي الشبكات الذكي.

يتم استخدام ذلك داخليًا، ويجب "ألا" يتم تغييره.

/spl/sploutput/staging

SOA_DR_INTEGRATION_DIR

نقطة/دليل التوصيل التي يستهلك منها DataRaker لأوراكل ملفات XML المُحولة.

/spl/sploutput/int

ترشيح الإجراءات

من الممكن أن يتم تكوين موفق جيت واي الشبكات الذكي SGG ليقوم بترشيح بيانات القياس الأولية التي يتم تمريرها إلى جيت واي الشبكات الذكي SGG وتطبيق إدارة بيانات العداد للخدمات والمرافق من أوراكل. يتم تمكين ترشيح البيانات عن طريق إعداد العنصر <filterUsage> في ملف EnvironmentSettings.xq على "صواب" كالتالي:
<filterEvents>true</filterEvents>

عند تمكين الترشيح، يتم تمرير فقط إجراءات الجهاز التي تملك <externalEventName> مطابقًا لإحدى القيم المحددة في البحث القابل للتوسيع (D3-DeviceEventMappingLookup) الذي يخص ربط إجراء الجهاز Landis+Gyr إلى النظام لتتم معالجتها.

الاشتراك في إجراءات جهاز الوقت الفعلي

يقدم مركز الأوامر Landis+Gyr القدرة على "الاشتراك"لإجراءات الجهاز من داخل الواجهة على الشبكة الخاصة بهم. يتم ذلك بإنشاء المشترك في مركز الأوامر مع عنوان URL للاستدعاء المرتبطة وكذلك قائمة أنواع الإجراءات التي يكون المشترك مهتمًا باستلامها. عندما يكون الإجراء مشتركًا للحدوث، يتم إرساله إلى عنوان URL للاستدعاء في الوقت الفعلي.

يتم تكوين الإجراءات داخل L+G بواحد من إعدادات "الإنذار" الثلاثة. تحدد هذه الإعدادات كيفيه إرسال الإجراءات إلى المشتركين:

  1. الإنذار: يتم تسليمه على الفور من العداد

  2. الاستشاري: يتم إرساله على أساس جدول تسليم

  3. التسجيل فقط: يتم إرساله عند الطلب فقط (لا ينطبق على تنفيذ معالجة إجراء الوقت الفعلي الخاص بنا)

سيتصل مركز الأوامر بالإجراءات باستخدام تنسيق نموذج المعلومات الشائعة الذي يوضح الرسالة كتوليفة اسم/فعل. سيتم تضمين تفاصيل الإجراء نفسه داخل عنصر "بيانات القياس المنقولة" للهيكل القياسي. سيتم تنسيق بيانات القياس المنقولة باستخدام هيكل رسالة EndDeviceEvent. تحدد هذه الرسالة إجراءات الجهاز باستخدام رقم نموذج المعلومات الشائعة فئة جزء 4. هذه الأرقام هي أربع أرقام منفصلة بفترة توضح نوع الجهاز والإجراء. على سبيل المثال:3.33.1.257 يخص "محاولة عبث متوقعة".

  • مقطع 1: رمز مجال إجراء الجهاز النهائي (على سبيل المثال 3. عداد/10. محصل/11. الموجه/12. (جهاز HAN

  • مقطع 2: رموز جزء مجال إجراء الجهاز النهائية (على سبيل المثال 1. Access/2. بطارية)

  • مقطع 3: رموز نوع مجال إجراء الجهاز النهائية (على سبيل المثال 1. Alarm/2. إنذار Mgt)

  • مقطع 4: مؤشر إجراء الجهاز النهائي (على سبيل المثال 1. Abort/2. محاولة وصول)

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

يستلم جيت واي الشبكات الذكي هذه الرسائل بواسطة مركب BPEL التي تحفظ الطلب الوارد كملف لاختيارها من خلال OSB.

يعد AMIEventSubscriber مسئولاً عن استلام رسائل الإجراء على أساس الاشتراك المحدد في مركز أوامر L+G. يجب أن يشير عنوان URL للاستدعاء الذي يتم تكوينه للاشتراك في مركز الأوامر إلى مركب BPEL.

تقوم مشاريع OSB التالية بتحليل لغوي لإجراءات الجهاز الفردية من الرسالة وتنفيذ المراجعة وتعيين المعلومات إلى تنسيق منشأ المثيل لإجراء الجهاز.

  1. SGG-D3-USAGE-BASE - تحتوي على مكونات مسئولة عن المعالجة "الفعلية" للبيانات الواردة. من الممكن ترقيته في المستقبل دون التأثير على إعدادات البيئة والتخصيص التي تم تعيينها في مشروع SGG-D3-CIM-EVENT-CM.

  2. SGG-D3-CIM-EVENT-CMيسمح بالتخصيص ويتيح إمكانية إتمام الترقيات المستقبلية بسهولة.

يتم تخزين إعدادات تكوين وقت التشغيل لمشروع SGG-D3-CIM-EVENT-CM في ملف EnvironmentSettings.xq XQuery. يمكنك استخدام هذا الملف لتعديل معالجة بيانات إجراءات الجهاز. على سبيل المثال، إذا كنت تريد تحميل بيانات أولية، عليك تحديد "صواب" لمحتوى عنصر populateRaw.

يوضح الجدول التالي العناصر المضمنة في ملف EnvironmentSettings.xq:

العنصر

الوصف

القيم الصالحة

populateRaw

يحدد ما إذا تم ملء بيانات إجراءات الجهاز كبيانات أولية.

true

false

callPreProcessing

يحدد ما إذا تم استدعاء خدمة وكيل ما قبل المعالجة.

true

false

callPostProcessing

يحدد ما إذا كان يتم استدعاء خدمة وكيل ما بعد المعالجة.

true

false

destinationRootElement

يحمل اسم خدمة الويب الواردة لمنشأ المثيل لإجراء الجهاز.

publishServices/service

يحدد اسم خدمة الأعمال داخل مشروع OSB المُستخدم لنشر البيانات على الأنظمة الخارجية (مثل نظام DataRaker لأوراكل).

filterEvents

يحدد ما إذا كان يجب ترشيح الإجراءات.

true

false

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

معالجة إجراءات الجهاز ذات الأولوية

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

تكوين إخطارات معالجة بيانات القياس المنقولة

بشكل افتراضي، يتم إرسال إحصائيات بيانات القياس المنقولة والإخطار بوجود خطأ في بيانات القياس المنقولة ونشاطات إخطار ملخص بيانات القياس المنقولة إلى قائمة انتظار الإخطارات داخل Oracle Service Bus. من الممكن أن يتم تكوين موفقات جيت واي الشبكات الذكي حتى تقيّد إرسال هذه النشاطات عن طريق تحديد الخصائص الديناميكية الاختيارية الخاصة بنقل بنية التشفير لجافا (JCA) في مشروع OSB الملائم. من الممكن أيضًا أن يتم استخدام الخصائص الديناميكية الاختيارية الخاصة بنقل بنية التشفير لجافا التالية هذه للتحكم في حال تم إرسال نشاطات الإخطارات هذه:

  • SGG_SEND_STATISTICS: تتحكم في إرسال نشاطات إحصائيات بيانات القياس المنقولة (صواب: إرسال، خطأ: عدم الإرسال)
  • SGG_SEND_ERROR: تتحكم في إرسال نشاطات إخطار بوجود خطأ في بيانات القياس المنقولة (صواب: إرسال، خطأ: عدم الإرسال)
  • SGG_SEND_SUMMARY: تتحكم في إرسال نشاطات ملخص لبيانات القياس المنقولة (صواب: إرسال، خطأ: عدم الإرسال)

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

لإنشاء هذه الخصائص:

  1. انتقل إلى مشروع SGG-D3-CIM-EVENT-CM في وحدة تحكم Oracle Service Bus.

  2. قم بتوسيع مجلد خدمات الوكيل.

  3. حدد خدمة الوكيل InboundProxyService (وليس Pipeline أو WSDL).

  4. انقر إنشاء لإنشاء جلسة جديدة.

  5. حدد تفاصيل النقل.

  6. انقر فوق علامة زائد في قسم خصائص نقاط النهاية الديناميكية. سيظهر صف فارغ.

  7. قم بإدخال الخاصية التي ترغب في تحديدها في عمود الخاصية.

  8. قم بإدخال "خطأ" في عمود القيمة.

  9. قم بتكرار الخطوات من 6 إلى 8 لكل خاصية ترغب في تحديدها.

  10. انقر تنشيط لحفظ التغييرات الخاصة بك وتنشيطها.

ملاحظة: لا تُستخدم هذه الخصائص إلا إذا كان SGG_​EXT_​ID_​PATTERN غير موجود أو إذا لم يلتقط التعبير العادي أي شيء. أما في حال التقاط التعبير العادي لبيانات المجموعة، سيتجاوز SGG_EXT_ID_PATTERN هذه الخصائص.