مستخرجات الاستهلاك القابلة للتكوين

أنواع استخراج الاستهلاك

يتم تحديد تكوين مستخرجات الاستهلاك من خلال "نوع استخراج الاستهلاك". لمزيد من المعلومات حول إنشاء هذه السجلات، راجع نوع استخراج الاستهلاك في دليل المستخدم الإداري (Administrative User Guide).

يجب إنشاء أنواع استخراج الاستهلاك القابلة للتكوين باستخدام كائن عمل "استخراج بيانات استهلاك الاشتراك إلى ملف" (D1-ExtractUSConsumptionToFile). ارجع إلى التعليمات المضمنة في كائن العمل هذا للحصول على مزيد من التفاصيل عن المعلمات المحددة لأنواع استخراج الاستهلاك. 

تحدد أنواع استخراج الاستهلاك في كائن عمل "استخراج بيانات استهلاك الاشتراك إلى ملف" المعلمات التالية:

• المشاركون في السوق الذين سيتم استخراج بيانات القياس لهم. يتم تحديد المشاركين في السوق على أساس نوعهم (مشارك في السوق لنقطة خدمة أو مشارك في السوق لاشتراك استهلاك) ونوع علاقة السوق (بائع تجزئة وموزع ومورد وما إلى ذلك)، ومشارك في السوق محدد. ملاحظة: في حالة إعداد "خاص بالمشارك في السوق" على القيمة "لا"، يعتمد المشارك في السوق المُستخدم على "مستلم الاستهلاك" في اشتراك الاستهلاك أو "نوع اشتراك الاستهلاك".
• نوع الاستهلاك (فترة زمنية أو استهلاك)
• نوع اشتراك استهلاك واحد أو أكثر وتوليفة وحدة قياس/وقت استخدام/معرف مقدار خدمة فريدة مرتبطة
• أنواع المعرفات المحددة المطلوب تضمينها في ملف الاستخراج لاشتراك الاستهلاك ونقطة الخدمة ونقطة الخدمة الفرعية (إن أمكن) والجهاز
• معلمات التنفيذ، وتشمل:
  • تاريخ ووقت استخراج البيانات لنوع استخراج الاستهلاك هذا
  • نوع الطلب. يجب إنشاء أنواع الطلبات المستخدمة مع طلبات الاستهلاك باستخدام كائن عمل "نوع طلب استخراج الاستهلاك" (D2-IntervalDataExtRepoType)، ويجب أن تشير إلى كائن عمل "استخراج الاستهلاك" (D2-IntervalDataExtRepository) في حقل كائن عمل الطلب. (راجع نظرة عامة على الطلبات في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide))
  • معدل تكرار عمليات الاستخراج لهذا النوع (مخصص أو يومي)
  • عناصر التحكم في مجموعة المعالجة المُستخدمة لعملية الاستخراج (راجع عناصر التحكم في مجموعة المعالجة أدناه)
• معلمات الملف، وتشمل:
  • موقع الملف الذي سيتم حفظ ملفات الاستخراج فيه (راجع تخزين الملفات الخارجية  في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide)) 
  • مجلد فرعي اختياري في موقع الملف
  • خيارات تسمية الملف (بما في ذلك البادئة الاختيارية وطابع التاريخ/الوقت)
  • ما إذا كان سيتم ضغط ملف الاستخراج أم لا (يتم ضغط الملف باستخدام gzip)

عناصر التحكم في مجموعة المعالجة

يتم تنفيذ عملية استخراج البيانات وإنشاء ملفات التصدير بواسطة عناصر التحكم في مجموعة المعالجة التالية: 

• استخراج الفترات الزمنية لاشتراك الاستهلاك الحالي في ملف (D1-ECUSI): يتم استخدامه للاستخراج اليومي لاستهلاك الفترة الزمنية. تتطلب هذه العملية إنشاء بيانات تخطيط لقطة الفترة الزمنية لأي من أحجام الفترات الزمنية التي يتم استخراجها. يساعد ذلك في كفاءة تحويل بيانات الفترة الزمنية إلى أعمدة فترة زمنية يومية. (لمزيد من المعلومات، راجع تعيين لقطة الفترة الزمنية).
• استخراج فترات اشتراكات استهلاك القراءات البديلة إلى ملف (D1-ERUSI): يتم استخدامه لاستخراج استهلاك الفترات الزمنية التاريخية للقراءات البديلة. يتم تشغيل هذه العملية مقابل سجلات "تسجيل بيانات التغيير" في جدول المعالجة العامة (راجع تسجيل بيانات تغيير التصحيحات اللاحقة للقياس الأولي أدناه).
• استخراج قراءات الاستهلاك لاشتراك الاستهلاك الحالي في ملف (D1-ECUSS): يتم استخدامه للاستخراج اليومي لبيانات الاستهلاك.
• استخراج قراءات الاستهلاك البديلة لاشتراكات الاستهلاك إلى ملف (D1-ERUSI): يتم استخدامه لاستخراج استهلاك الفترات الزمنية للقراءات البديلة. يتم تشغيل هذه العملية مقابل سجلات "تسجيل بيانات التغيير" في جدول المعالجة العامة (راجع تسجيل بيانات تغيير التصحيحات اللاحقة للقياس الأولي أدناه).

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

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

تسجيل بيانات تغيير التصحيحات اللاحقة للقياس الأولي

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

إذا كان القياس الأولي تابعًا لتاريخ/وقت تم استخراجه بالفعل، تقوم هذه الخوارزميات بإنشاء سجلات "تسجيل بيانات التغيير" في جدول "المعالجة العامة" والتي تُسجل رمز مجموعة المعالجة ورقم تشغيل مجموعة المعالجة ومعرف القياس الأولي. وتغادر عمليات مجموعة معالجة "الاستبدال" هذه السجلات.

تنسيق الملف - الفترة الزمنية 

ينتج عن عملية استخراج الفترة الزمنية ملفات JavaScript Object Notation (JSON) ببيانات الاستخراج الموضحة في الجدول التالي. 

لاحظ أنه يمكن لملفات استخراج الفترة الزمنية تخزين ما يصل إلى 300 فترة زمنية. وهذا يعني أن ملفات التصدير يمكنها تخزين ما يقرب من:

• 12.5 يومًا من البيانات بالساعة
• 3 أيام من فترات لمدة 15 دقيقة
• يوم واحد من فترات لمدة 5 دقائق

مثال:

{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
 "tz":"US/Eastern", "intPerDay":"288", "intSize":"300", "mktPart":"DIRECT_ENERGY",
 "stDttm":"2020-01-01T00:00:00-05:00", "q1":"1.325", "c1":"301000", "q2":"1.325",
 "c2":"301000" "q3":"1.325", "c3":"301000",
<intervening intervals>, "q300":"1.325", "c300":"301000"}

تنسيق الملف - الاستهلاك

ينتج عن عملية استخراج الاستهلاك ملفات JavaScript Object Notation (JSON) ببيانات الاستخراج الموضحة في الجدول التالي.

مثال (3 سجلات):

{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
 "tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
 "enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
 "tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
 "enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
 "tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
 "enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}
{"usId":"995647003500", "usType":"E-RES", "pSpId":"458081", "spId":"458081_001", "dvcId":"SN823287793219", "uomTouSqi":"KWH//",
 "tz":"US/Eastern", "mktPart":"DIRECT_ENERGY", "stDttm":"2020-01-01T00:00:00-05:00",
 "enDttm":"2020-01-02T00:00:00-05:00", "q":"1.325", "c":"301000", "r":"678645"}

توسيع معالجة الاستخراج

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

توسيع قائمة المعرفات المطلوب استخدامها

تحدد "أنواع استخراج الاستهلاك" الأنواع المعينة من المعرفات المطلوب استخدامها مع اشتراكات الاستهلاك ونقاط الخدمة ونقاط الخدمة الفرعية (إن وجدت) والأجهزة. وإذا كانت النسخة المعدلة ترغب في توسيع أنواع المعرفات المتاحة، يجب إضافة قيم مناسبة لإشارات البحث المستخدمة بواسطة كل نوع معرف. يسرد الجدول أدناه رموز البحث المُستخدمة بواسطة حقول "المعرفات المطلوب استخدامها".

معالجة السجلات وإنشاء ملفات المخرجات

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

ويوفر ذلك ميزتين:

1. لا يوجد حد لطول الاستعلام في خوارزمية "معالجة السجلات".

2. يكون استرجاع البيانات للعديد من اشتراكات الاستهلاك في وقت واحد أكثر كفاءة بكثير.

ويعني ذلك أنه يمكن إجراء أي تخصيص مطلوب من خلال إنشاء عنصر تحكم في مجموعة معالجة مخصص (CM) جديد وتكرار سكريبت Groovy الخاص بمعالجة السجلات. يمكن إجراء تغييرات على SQL الاستخراج داخل سكريبت Groovy المخصص لاسترجاع معلومات إضافية أو إدخال معايير اختيار إضافية. وإذا تطلب الأمر إجراء أي تغييرات على تنسيق الملف، يمكن إجراؤها من خلال منطق معالجة السجل الذي يقوم بملء الملف.