مستخرجات الاستهلاك القابلة للتكوين
مستخرجات الاستهلاك القابلة للتكوين هي مستخرجات بيانات قياس لمجموعة من اشتراكات الاستهلاك المرتبطة اختياريًا بمشارك محدد في السوق.
تتضمن خيارات تكوين عمليات الاستخراج هذه ما يلي:
-
نوع المشارك في السوق، على أساس جدولي "المشارك في السوق لنقطة الخدمة" و"المشارك في السوق لاشتراك الاستهلاك" وعلاقة السوق
-
أنواع اشتراكات الاستهلاك المرتبطة بالمشارك في السوق (عادةً ما يتلقى نظام معلومات العميل محددات الفاتورة)
-
التوليفات الفريدة لوحدة القياس (UOM) ووقت الاستخدام (TOU) ومعرف مقدار الخدمة (SQI) المرتبطة باشتراكات الاستهلاك
-
المعرفات المحددة المستخدمة لتحديد اشتراكات الاستهلاك ونقاط الخدمة والأجهزة المرتبطة ببيانات القياس المستخرجة
-
معلمات تاريخ ووقت الاستخراج ومعدل تكراره
-
خيارات تسمية وضغط ملف الاستخراج
يتم تصدير مستخرجات الاستهلاك إلى ملف في موقع ملف محدد، إما على ملقم تطبيقات (في النسخة المُعدلة بالمواقع) أو على موقع "تخزين كائنات البنية التحتية على الشبكة السحابية لأوراكل".
يتم إنشاء مستخرجات الاستهلاك عن طريق "طلبات استخراج الاستهلاك". راجع طلبات استخراج الاستهلاك في دليل مستخدم الأعمال (Business User Guide).
يوضح هذا القسم التكوين المطلوب لهذه الأنواع من مستخرجات الاستهلاك.
أنواع استخراج الاستهلاك
يتم تحديد تكوين مستخرجات الاستهلاك من خلال "نوع استخراج الاستهلاك". لمزيد من المعلومات حول إنشاء هذه السجلات، راجع نوع استخراج الاستهلاك في دليل المستخدم الإداري (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 من فصل عمليات التكامل.
تسجيل بيانات تغيير التصحيحات اللاحقة للقياس الأولي
تعمل الخوارزميات التالية على صيانة تاريخ/وقت مكون القياس على أساس تاريخ/وقت آخر قياس لمكون القياس. وتتحقق هذه الخوارزميات أيضًا من "نوع استخراج الاستهلاك" الذي ينطبق على مكون القياس المرتبط بالقياس الأولي الحالي، كما تحدد ما إذا كان القياس الأولي تابعًا لتاريخ/وقت تم استخراجه بالفعل.
الخوارزمية |
الوصف |
نوع الاستهلاك |
---|---|---|
D1-UPD-DTMC |
تحديث تاريخ/وقت آخر قياس بمكون القياس مع مزامنة الاستهلاك |
فترة زمنية |
D1-UDTSCMCRE |
تحديث تاريخ/وقت آخر قياس بمكون قياس الاستهلاك مع مزامنة الاستهلاك |
استهلاك |
D1-UPD-DTMCF |
تحديث آخر تاريخ/وقت في مكون القياس من قياس مستقبلي |
فترة زمنية |
D1-UPDDTSCMC |
تحديث آخر تاريخ/وقت في مكون قياس الاستهلاك |
استهلاك |
إذا كان القياس الأولي تابعًا لتاريخ/وقت تم استخراجه بالفعل، تقوم هذه الخوارزميات بإنشاء سجلات "تسجيل بيانات التغيير" في جدول "المعالجة العامة" والتي تُسجل رمز مجموعة المعالجة ورقم تشغيل مجموعة المعالجة ومعرف القياس الأولي. وتغادر عمليات مجموعة معالجة "الاستبدال" هذه السجلات.
- تسجيل تغييرات القياسات التاريخية لنوع استخراج الاستهلاك: صواب
تنسيق الملف - الفترة الزمنية
ينتج عن عملية استخراج الفترة الزمنية ملفات 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 |
المنطقة الزمنية لنقطة الخدمة. هذا هو اسم المنطقة الزمنية من جدول CI_TIME_ZONE وليس رمز المنطقة الزمنية. |
intPerDay |
288 |
عدد الفترات الزمنية لليوم، ويكون أقل بساعة أو أكثر بساعة للفترات الزمنية التي تم تحويلها إلى/من التوقيت الصيفي (DST) |
intSize |
300 |
طول كل فترة زمنية بالثواني |
mktPart |
DIRECT_ENERGY |
معرف المشارك في السوق (إن وجِد) |
stDttm |
2020-01-01T00:00:00-05:00 |
بداية اليوم، مثل القياس الأولي، ويمثل بداية الفترة الزمنية الأولى. |
q1 |
1.325 |
قيمة القياس للفترة الزمنية الأولى، سيكون تاريخ/وقت القياس لهذه الفترة الزمنية هو stDttm بالإضافة إلى intSize |
c1 |
301000 |
شرط القياس للفترة الزمنية الأولى. يكون فارغًا في حالة الشرط "منتظم" (501000) |
q2 |
1.230 |
|
c2 |
301000 |
|
... |
q/c هي 3 حتى 299 هنا |
|
q300 |
.9134 |
|
c300 |
30100 |
مثال:
{"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) ببيانات الاستخراج الموضحة في الجدول التالي.
الاسم |
القيمة المحددة في المثال |
تعليقات |
---|---|---|
c |
301000 |
شرط القياس لقراءة الاستهلاك يكون فارغًا في حالة الشرط "منتظم" (501000) |
dvcId |
SN823287793219 |
معرف الجهاز المحدد بواسطة نوع استخراج الاستهلاك |
enDttm |
2020-01-02T00:00:00-05:00 |
تاريخ/وقت انتهاء القراءة |
mktPart |
DIRECT_ENERGY |
معرف المشارك في السوق (إن وجِد) |
pSpId |
458081 |
|
q |
1.325 |
قيمة القياس لقراءة الاستهلاك |
r |
678645 |
قراءة قرص القياس للعداد |
spId |
458081_001 |
معرف نقطة الخدمة المحدد بواسطة نوع استخراج الاستهلاك |
stDttm |
2020-01-01T00:00:00-05:00 |
تاريخ/وقت البدء للقراءة (تاريخ/وقت الانتهاء للقراءة السابقة) |
tz |
US/Eastern |
المنطقة الزمنية لنقطة الخدمة. هذا هو اسم المنطقة الزمنية من جدول CI_TIME_ZONE وليس رمز المنطقة الزمنية. |
uomTouSqi |
KWH// |
وحدة القياس / وقت الاستخدام / معرف مقدار الخدمة، مفصولين بخطوط مائلة للأمام ("/") |
usId |
995647003500 |
معرف اشتراك الاستهلاك المحدد بواسطة نوع استخراج الاستهلاك |
usType |
E-RES |
نوع اشتراك الاستهلاك |
مثال (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"}
توسيع معالجة الاستخراج
قد ترغب بعض النسخ المعدلة في توسيع و/أو تخصيص عملية الاستخراج استنادًا إلى متطلبات محددة.
توسيع قائمة المعرفات المطلوب استخدامها
تحدد "أنواع استخراج الاستهلاك" الأنواع المعينة من المعرفات المطلوب استخدامها مع اشتراكات الاستهلاك ونقاط الخدمة ونقاط الخدمة الفرعية (إن وجدت) والأجهزة. وإذا كانت النسخة المعدلة ترغب في توسيع أنواع المعرفات المتاحة، يجب إضافة قيم مناسبة لإشارات البحث المستخدمة بواسطة كل نوع معرف. يسرد الجدول أدناه رموز البحث المُستخدمة بواسطة حقول "المعرفات المطلوب استخدامها".
نوع المعرف |
إشارة البحث |
---|---|
معرف اشتراك الاستهلاك |
نوع معرف اشتراك الاستهلاك (US_ID_TYPE_FLG) |
معرف نقطة الخدمة (يُستخدم لنقاط الخدمة الرئيسية والفرعية) |
نوع معرف نقطة الخدمة (SP_ID_TYPE_FLG) |
معرف الجهاز |
نوع معرف الجهاز (DVC_ID_TYPE_FLG) |
معالجة السجلات وإنشاء ملفات المخرجات
تستخدم عملية الاستخراج وظيفة عمليات المعالجة الخلفية المعتمدة على الخوارزمية المساعدة العامة، ولكنها تعمل بطريقة مختلفة قليلاً. فبدلاً من استخدام خوارزمية "تحديد السجلات" لاسترجاع معرفات السجلات الفردية المطلوب معالجتها، ينتج عن هذه الخوارزمية مدى من "معرفات اشتراك الاستهلاك" المطلوب استخراجها وتعمل خوارزمية "معالجة السجلات" على تنفيذ الاستعلام التفصيلي لاستخراج مدى من "معرفات اشتراك الاستهلاك".
ويوفر ذلك ميزتين:
-
لا يوجد حد لطول الاستعلام في خوارزمية "معالجة السجلات".
-
يكون استرجاع البيانات للعديد من اشتراكات الاستهلاك في وقت واحد أكثر كفاءة بكثير.
ويعني ذلك أنه يمكن إجراء أي تخصيص مطلوب من خلال إنشاء عنصر تحكم في مجموعة معالجة مخصص (CM) جديد وتكرار سكريبت Groovy الخاص بمعالجة السجلات. يمكن إجراء تغييرات على SQL الاستخراج داخل سكريبت Groovy المخصص لاسترجاع معلومات إضافية أو إدخال معايير اختيار إضافية. وإذا تطلب الأمر إجراء أي تغييرات على تنسيق الملف، يمكن إجراؤها من خلال منطق معالجة السجل الذي يقوم بملء الملف.