خدمات الويب وعمليات معالجة BPEL
هذه العمليات مسؤولة عن تنفيذ التحويل من تنسيق مرافق أوراكل إلى تنسيق خدمات الطاقة المتصلة بالشبكة واستدعاء وسائل شرح العملية واستدعاء نقطة النهاية عن بعد لتحفيز إجراءات الجهاز.
تستقبل جميع خدمات الويب XML من خدمة واردة، ثم تقوم بتحويل الاتصال إلي تنسيق يتعرف عليه نظام خدمات الطاقة المتصلة بالشبكة.
CreateMeter: يستقبل XML الوارد من خدمة مرسل الرسالة، ثم يقوم بتحويلها إلي نقطة توصيل معلمات واجهة برمجة تطبيقات خدمات الطاقة المتصلة بالشبكة، ويمررها إلى طريقة خدمة ويب واجهة برمجة تطبيقات خدمات الطاقة المتصلة بالشبكة "DeviceManager.Create"، ثم يقوم بجمع XML من CreateMeter ليتم إرجاعها إلى جيت واي الشبكات الذكي والمرافق من أوراكل.
الرسائل
CreateMeter RequestMessage: يحتوي على المعلمات التي نسقتها جيت واي الشبكات الذكي والمرافق من أوراكل من أجل أن تتماشى معXML لeviceManager.Create method. واجهة برمجة تطبيقات خدمات الطاقة المتصلة بالشبكة.
CreateMeter ResponseMessage: يحتوي على معرف الجهاز الذي يُستخدم عندما يراجع طريقةDeviceManager.Create مفتاح الأمان ومعلمات XML بنجاح.
العمليات المرتبطة
توصيل العداد
ConnectLoadRemoteConnectاستلام XML الوارد من D4-CONLOAD مرسل رسالة (تحميل الاتصال) جيت واي الشبكات الذكي والمرافق من أوراكل وتحويلها إلى تنسيق خدمات الطاقة المتصلة بالشبكة.
GrabBatchEventsاسترجاع إجراءات عمليات غير المراجعة من مخزن الإجراء؛ تحويل كل دفعة لاستبدال معرفات دليل المستخدم بتنسيق قابل للقراءة وأخيرًا تحضير ملف جديد لناقل الخدمة لأوراكل قبل حذف مجموعة معالجة الإجراءات. يمكن أن تحتوي المكالمة المجدولة لهذه الخدمة على التواريخ المفضلة للاستعلام عنها أو يمكن أن تقبل الإعداد الافتراضي وهو استهلاك اليوم السابق.
الرسائل
GrabBatchEventsSoapIn
GrabBatchEventsSoapOut
GrabBatchUsageاسترجاع استهلاك عمليات غير المراجعة من مخزن الاستهلاك؛ تحويل كل دفعة لاستبدال معرفات دليل المستخدم بتنسيق قابل للقراءة وأخيرًا تحضير ملف جديد لناقل الخدمة لأوراكل قبل حذف مجموعة معالجة الاستهلاك. يمكن أن تحتوي المكالمة المجدولة لهذه الخدمة على التواريخ المفضلة للاستعلام عنها أو يمكن أن تقبل الإعداد الافتراضي وهو استهلاك اليوم السابق.
الرسائل
GrabBatchUsageSoapIn
GrabBatchUsageSoapOut
العمليات المرتبطة
الاتصال
إدارة الإجراء
عملية معالجة الاستهلاك
MeterDecommissioningاستقبال XML الوارد من خدمة "senderOutbound" الرسالة وتحويلها إلي نقطة توصيل معلمات واجهة برمجة التطبيقات خدمات الطاقة المتصلة بالشبكة لتمريرها إلى طريقة خدمة الويب واجهة برمجة التطبيقات خدمات الطاقة المتصلة بالشبكة "DeviceManager.Move". العملية ثم جمع XML الإرجاع لإرجاعه إلى جيت واي الشبكات الذكي والمرافق من أوراكل.
الرسائل
MeterDecommissioningRequestMessage: هذه الرسالة هي الإدخال لطريقة النقل. تحتوي الطريقة على المعلمات المنسقة بشكل مناسب من جيت واي الشبكات الذكي والمرافق من أوراكل من أجل أن تتماشى معXML الوارد لطريقة نقل DeviceManager. واجهة برمجة تطبيقات خدمات الطاقة المتصلة بالشبكة.
MeterDecommissioningResponseMessage: تحتوي هذه الرسالة على حالة تفيد أن طريقة DeviceManager.Create تحققت من مفتاح الأمان وأنه تم قبول معلمات XML بنجاح. إذا "نجحت" الحالة، وتحتوي على معرف التتبع للمكالمة ومعرف الجهاز ومعرف نوع الحالة.
العمليات المرتبطة
إلغاء توصيل العداد
PerformCommandيحدد هذا القسم التكوين المطلوب لأجل الموفق لخدمات الطاقة المتصلة بالشبكة "جيت واي الشبكات الذكي للخدمات والمرافق من أوراكل" للاتصال برنامج خدمات الطاقة المتصلة بالشبكة. إذا تطلب النسخة المعدلة الخاصة بك الوظيفة التي لم يتم تسليمها كجزء من الحزمة الأساسية التي تلعب دور أساسي في إدارة هذه التفصيلات.
ينفذ PerformCommand الأمر الذي يدير الإجراءات التي تتقدم عن جيت واي الشبكات الذكي والمرافق من أوراكل lifecycle وإرجاع سلسلة المخرجات إلى المتصل. قد يكون المخرج معرف التتبع أو معلومات عن جهاز.
الرسائل
PerformCommandSoapIn: يتم إعداد إدخال sXmlParameters من داخل جيت واي الشبكات الذكي والمرافق من أوراكل لتنفيذ مجموعة من الأوامر الخمسة بشكل أساسي، وهي "حالة تحميل القراءة" و "طلب آخر قراءة" و "تحميل الاتصال" و "تحميل فصل الاتصال" وتعيين تكوين إدارة مخططات الشبكة آليًا.
PerformCommandSoapOut:
يعد الإرجاع من PerformCommand هو xml من DeviceManager.PerformCommand حالة تحميل القراءة وطلب آخر قراءة وتحميل الاتصال وتحميل فصل اتصال و مجموعة تكوين إدارة مخططات الشبكة آليًا.
ReceivePanoramixEventsلم يستدعي التنفيذ هذه الخدمة قط، ولكن استدعتها خدمات الطاقة المتصلة بالشبكة وهي ضرورية عند تكوين ملقن خدمات الطاقة المتصلة بالشبكة.
يحصل ReceivePanoramixEvents على APIKey من خدمة تصديق خدمات الطاقة المتصلة بالشبكة، ثم باستخدام معرف تعريف الإجراء من لائحة المعلمات لهذه الخدمة، والتبديل إلى الفرع الخاص بتعريف الإجراء لبدء أي عمليات معالجة محددة. على سبيل المثال، يعني إجراء إتمام طلب آخر قراءة أن عملية BPEL PM تحتاج إلى استرجاع الاستخدام باستخدام RESULTID الموجود في إجراء xml. يجب تحويل جميع الإجراءات والاستهلاكات المراد تمريرها إلى جيت واي الشبكات الذكي والمرافق من أوراكل لاستبدال "الدليل" بأصناف نموذج قابلة للقراءة. يتضمن ذلك استخدام وظيفة البحث لمخطط قيم مجال BPEL PM .
الرسائل
ReceivePanoramixEventsSoapIn
ReceivePanoramixEventsSoapOut
العمليات المرتبطة
إدارة الإجراء
PrePerformCommandCallout / PostPerformCommandCalloutتعد خدمات الويب هذه عبارة عن تعليمات التغيير البرمجية المصممة للسماح بتخصيص الرسائل قبل إرسالها مباشرة إلى ملقن خدمات الطاقة المتصلة بالشبكة. قد تتطلب النسخة المعدلة الخاصة بك في تعديل البيانات لأغراض خاصة. هذا هو المكان الوحيد الذي يُسمح فيه بتعديل رمز BPEL PM.
ReceivedPanoramixEventsCalloutتعد خدمة الويب هذه عبارة عن تعليمات التغيير البرمجية المصممة للسماح بتخصيص الرسائل قبل إرسالها مباشرة إلى ملقن خدمات الطاقة المتصلة بالشبكة. قد تتطلب النسخة المعدلة الخاصة بك في تعديل البيانات لأغراض خاصة. هذا هو المكان الوحيد الذي يُسمح فيه بتعديل رمز BPEL PM.
ReadBillingDataOnDemandطريقة خدمة الويب هذه، قم بإجراء مكالمة إلى نظام خدمات الطاقة المتصلة بالشبكة مع معلمة تنسيق xml الوارد. أولاً، يحول المعلمات المستلمة من نظام الاتصال إلى نسق يمكن التعرف عليه من نظام خدمات الطاقة المتصلة بالشبكة. ثم تقوم باستدعاء الاتصال إلى خدمة مدير الجهاز التابعة لنظام خدمات الطاقة المتصلة بالشبكة. عندما يتم استدعاء الاتصال ، يتلقى النظام XML العائد من DeviceManager الذي يوضح حالة تنفيذ الأمر، وإذا كان قد نجح، فإن معرف التتبع لهذه المكالمة.
الرسائل
ReadBillingDataOnDemandRequestMessage: تحتوي معاملة المدخل لDeviceManager أمر تنفيذ طلب آخر قراءة لبيانات الفوترة. يقوم بتنسيق المعلمات من نظام الاستدعاء لمطابقة XML الواردة لطريقة خدمات الطاقة المتصلة بالشبكة DeviceManager.PerfomCommand.
ReadBillingDataOnDemandResponseMessage: تحويل استجابة XML من تنسيق نظام خدمات الطاقة المتصلة بالشبكة إلي تنسيق جيت واي الشبكات الذكي والمرافق من أوراكل.
العمليات المرتبطة
طلب آخر قراءة
ReadLoadProfileOnDemandطريقة خدمة الويب هذه، قم بإجراء مكالمة إلى خدمة مدير جهاز التابع لنظام خدمات الطاقة المتصلة بالشبكة باستخدام معلمة تنسيق xml الوارد. أولاً، يحول المعلمات المستلمة من نظام الاتصال إلى نسق يمكن التعرف عليه من نظام خدمات الطاقة المتصلة بالشبكة. ثم تقوم باستدعاء الاتصال إلى خدمة مدير الجهاز عبر نظام خدمات الطاقة المتصلة بالشبكة. بعد استدعاء الاتصال ، يتلقى النظام رسالة الطلب من DeviceManager الذي يوضح حالة تنفيذ الأمر، وإذا كان قد نجح، فإن معرف التتبع لهذه المكالمة.
الرسائل
ReadLoadProfileOnDemandRequestMessage: تعد هذه الرسالة لطلب آخر قراءة إلى نظام خدمات الطاقة المتصلة بالشبكة. يحول XML الوارد من جيت واي الشبكات الذكي والمرافق من أوراكل إلى تنسيق خدمات الطاقة المتصلة بالشبكة يمكن التعرف عليه.
ReadLoadProfileOnDemandResponseMessage: يحول استجابة xml لـ ReadLoadProfileOnDemandRequest من تنسيق نظام خدمات الطاقة المتصلة بالشبكة إلى تنسيق جيت واي الشبكات الذكي والمرافق من أوراكل.
العمليات المرتبطة
طلب آخر قراءة
ReadLoadStatusRemoteConnectاستلام XML الوارد من D4-RDLOADST مرسل رسالة (حالة تحميل القراءة) جيت واي الشبكات الذكي والمرافق من أوراكل وتحويلها إلى تنسيق خدمات الطاقة المتصلة بالشبكة.
RemoteDisconnectاستلام XML الوارد من D4-DISCONLD مرسل رسالة (فصل اتصال التحميل) جيت واي الشبكات الذكي والمرافق من أوراكل وتحويلها إلى تنسيق خدمات الطاقة المتصلة بالشبكة.
RetrieveMeterInfoيبدأ مكالمة إلى "طلب إدارة الخدمة" مع معلمات xml الواردة المنسقة. أولاً، يحول المعلمات المستلمة من نظام الاتصال إلى نسق يمكن التعرف عليه من نظام خدمات الطاقة المتصلة بالشبكة. ثم تستدعي مكالمة إلى نظام خدمات الطاقة المتصلة بالشبكة من خلال خدمة إدارة الطلب وتسترجع الاستجابة باستخدام معلومات العداد.
الرسائل
RetrieveMeterInformationRequestMessage: تحتوي معاملة المدخل لأمر تنفيذ DeviceManager واسترجاع معلومات العداد. يقوم أيضًا بتنسيق المعلمات من نظام الاستدعاء لمطابقة XML الواردة لطريقة خدمات الطاقة المتصلة بالشبكة DeviceManager.PerfomCommand.
RetrieveMeterInformationResponseMessage: تحويل استجابة XML من تنسيق نظام خدمات الطاقة المتصلة بالشبكة إلي تنسيق جيت واي الشبكات الذكي والمرافق من أوراكل.
العمليات المرتبطة
فصل الاتصال عن بُعد
الاتصال عن بُعد
RetrieveMeterIdentifierتلقي اتصالاً من جيت واي الشبكات الذكي والمرافق من أوراكل لعملية RetrieveMeterIdentifier واستدعاء طريقة RetrieveByParameter في خدمة DeviceManager لنظام خدمات الطاقة المتصلة بالشبكة.
تحويل الإدخال الوارد من جيت واي الشبكات الذكي والمرافق من أوراكل إلى sXmlParameters بتنسيق خدمات الطاقة المتصلة بالشبكة ثم استدعاء RetrieveMeterIdentifier.
الرسائل
RetrieveMeterIdentifierRequestMessage: يحول ملف xml المستلم من نظام الاستدعاء بحيث يتطابق مع XML الوارد لواجهة برمجة التطبيقات طريقة خدمات الطاقة المتصلة بالشبكة DeviceManager.RetrieveByParameter. تتطلب هذه الطريقة نوع المعرف والمعرف المقترن كمدخل.
RetrieveMeterIdentifierResponseMessage: عندما يتم إرجاع XML بشكل متزامن من نظام التجميع المركزي لاستدعاء RetrieveByParameter، يتم تضمين نقطة توصيل DEVICEID في APIPAYLOAD فقط في حالة نجاح حالة المكالمة.
العمليات المرتبطة
توصيل العداد
SetATMConfigurationطريقة خدمة الويب هذه مخصصة لتعيين أمر تكوين إدارة مخططات الشبكة آليًا (ATM) الذي يعين العداد إلى مركز تركيز البيانات.
يحول المدخل الوارد من جيت واي الشبكات الذكي والمرافق من أوراكل إلى sXmlParameters بتنسيق خدمات الطاقة المتصلة بالشبكة ثم يستدعي DeviceManager PerformCommand. يجب تثبيت اتصال لبدء معالجة امر خدمات الطاقة المتصلة بالشبكة.
الرسائل
SetATMConfigurationRequestMessage: هذه الرسالة هي مدخل لطريقة SetATMConfiguration. تحتوي الطريقة على المعلمات التي تم تنسيقها بشكل مناسب من جيت واي الشبكات الذكي والمرافق من أوراكل من أجل أن تتماشى معXML الوارد لطريقة نقل DeviceManager. واجهة برمجة تطبيقات خدمات الطاقة المتصلة بشبكة DeviceManager.PerformCommand حيث يكون "الأمر" هو Constants.DeviceCommands.SET_ ATM_ CONFIGURATION
SetATMConfigurationResponseMessage: عندما يتم إرجاع XML بشكل متزامن من نظام التجميع المركزي لاستدعاء PerformCommand ، يتم تضمين نقطة توصيل "أمر" فقط في APIPAYLOAD إذا نجحت حالة المكالمة.
العمليات المرتبطة
توصيل العداد
خدمات ويب خدمات الطاقة المتصلة بالشبكة
يصف الجدول التالي خدمات ويب خدمات الطاقة المتصلة بالشبكة وعملياته المستخدمة لمراسلة أوامر جيت واي الشبكات الذكي للمرافق والخدمات من أوراكل:
أوامر جيت واي الشبكات الذكي |
كائنات عمل موفق بنية القياس التحتية المتقدمة |
خدمات ويب خدمات الطاقة المتصلة بالشبكة |
عمليات خدمات الطاقة المتصلة بالشبكة |
---|---|---|---|
توصيل الجهاز |
D4-AddMeterRequest D4-RetrieveMeterIdentifier D4-SetATMConfiguration |
DeviceManager |
Create RetrieveByParameter PerformCommand: SET_ATM_CONFIGURATION |
إلغاء توصيل الجهاز |
D4-DecommMeterRequest |
DeviceManager |
PerformCommand: MOVE_DEVICE_ADD |
الاتصال عن بُعد |
D4-ConnectLoad D4-ReadLoadStatus D4-RetrieveMeterInfo |
DeviceManager |
Retrieve PerformCommand: CONNECT_LOAD READ_LOAD_STATUS |
فصل الاتصال عن بُعد |
D4-DisconnectLoad |
DeviceManager |
PerformCommand: DISCONNECT_LOAD |
طلب آخر قراءة |
D4-ReadBillingData |
DeviceManager |
PerformCommand Command ID: READ_BILLING_DATA_ON_DEMAND (Scalar) READ_LOAD_PROFILE_ON_DEMAND (Interval) |