تصدير بيانات القياس
يتم دعم تصدير البيانات من كائن صيانة القياس من خلال التصدير "المخصص". لمزيد من المعلومات حول تصدير البيانات المخصص، راجع تصدير البيانات المخصص في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide).
يتم تكوين كائن صيانة "القياس" لدعم تصدير البيانات من خلال الخيارات التالية:
نوع الخيار |
قيمة الخيار |
---|---|
فئة تصدير البيانات |
F1SE (مخصص) |
عنصر التحكم في مجموعة معالجة التصدير |
D1-SMDEC (استخراج مخصص لبيانات القياس الحالية) |
الاستخراج الأولي مقابل الحالي مقابل التاريخي
توجد ثلاثة أنواع من عمليات الاستخراج المُستخدمة مع كائن صيانة "القياس":
- تقوم عمليات الاستخراج الأولية بتجميع استخراج أولي لبيانات القياس الأولية، والتي يتم التحكم بها من خلال إدخال تاريخ/وقت بدء وانتهاء للقياسات التي يجب استخراجها. يجب استخدام هذه العملية لتنفيذ الاستخراج الأولي لبيانات القياس قبل استخدام عمليات الاستخراج التاريخية اليومية والحالية اليومية.
- يعمل استخراج البيانات الحالية اليومية على تجميع بيانات القياس للقياسات التي تمت إضافتها أو تغييرها خلال آخر 30 يومًا. يعتمد هذا الاستخراج على حقلي تاريخ/وقت القياس والطابع الزمني لآخر تحديث في جدول "القياس"، بالإضافة إلى حقل تصدير خلال التاريخ/الوقت في سجل "التحكم في تصدير البيانات" (راجع أدناه) لتضمين التغييرات التي حدثت منذ آخر استخراج فقط.
-
يعمل استخراج البيانات التاريخية اليومية على تجميع بيانات القياس التي تمت إضافتها أو تغييرها قبل آخر 30 يومًا. ولتجنب الحاجة إلى فحص جدول "القياس" بالكامل، يعتمد هذا الاستخراج على "تسجيل بيانات التغيير". وأثناء معالجة بيانات القياس الأولية، إذا كان القياس الأولي يحتوي على قياسات أقدم من 30 يومًا، يتم إنشاء سجل "تسجيل بيانات تغيير" في جدول "المعالجة العامة". يتطلب تمكين تسجيل بيانات التغيير التاريخية تكوين معلمات الخوارزميات التالية:
- تسجيل تغييرات القياسات التاريخية: صواب
- التحكم في مجموعة معالجة استخراج بيانات القياس التاريخية: D1-SMDEH (استخراج مخصص لبيانات القياس التاريخية)
يجب تكوين هذه المعلمات كما هو موضح في الخوارزميات التالية:- تحديث تاريخ/وقت آخر قياس بمكون القياس مع مزامنة الاستهلاك (D1-UPD-DTMC)
- تحديث تاريخ/وقت آخر قياس بمكون قياس الاستهلاك مع مزامنة الاستهلاك (D1-UDTSCMCRE)
- تحديث آخر تاريخ/وقت بمكون القياس من قياس مستقبلي (D1-UPD-DTMCF)
- تحديث آخر تاريخ/وقت في مكون قياس الاستهلاك (D1-UPDDTSCMC)
- إعادة اشتقاق قيم أخرى (D1-REDEROVAL)
سجلات التحكم في تصدير البيانات
يتطلب تصدير البيانات من كائن صيانة "القياس" وجود سجل "تحكم في تصدير البيانات". يحدد هذا السجل ما إذا كان يجب تصدير كائن صيانة "القياس" أم لا، كما يتتبع التاريخ والوقت اللذين تم خلالهما تصدير البيانات حتى الوقت الحالي، ما يسمح لعمليات التصدير اللاحقة بتصدير التغييرات الإضافية فقط.
لمزيد من المعلومات حول إنشاء سجلات التحكم في تصدير البيانات، راجع تحديد التحكم في تصدير البيانات في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide).
عناصر التحكم في مجموعة المعالجة
يتم تنفيذ عملية تصدير البيانات وإنشاء ملفات التصدير بواسطة عناصر التحكم في مجموعة المعالجة التالية:
- الاستخراج الأولي للقياسات المتخصصة (D1-SMDIE): يتم استخدامه للاستخراج الأولي لبيانات القياس. وعلى عكس الاستخراج الحالي، يتم التحكم في مجموعة المعالجة هذه مباشرةً عن طريق إدخال تاريخ/وقت البدء والانتهاء للقياسات التي يجب استخراجها. يجب استخدام هذه العملية لتنفيذ الاستخراج الأولي لعناوين بيانات القياس قبل استخدام الاستخراج الحالي (D1-SMDEC) والاستخراج التاريخي (D1-SMDEH). للحصول على أفضل أداء، يوصى بتقسيم فترة الاستخراج الأولي إلى فترات أصغر متعددة واستخدام تسلسلات عمليات متعددة لكل فترة. تقوم عملية الاستخراج باسترجاع كل القياسات التي لها قياسات تمتد حتى تاريخ/وقت لاحق لتاريخ/وقت البدء المُدخل وسابق لتاريخ/وقت الانتهاء المُدخل أو موافق له.
- استخراج مخصص لبيانات القياس الحالية (D1-SMDEC): يُستخدم لعمليات الاستخراج اليومية لبيانات القياس (الجديدة) الحالية. تعمل هذه العملية على استخراج البيانات التي تم تغييرها منذ تشغيل آخر عملية استخراج (استنادًا إلى حقل تصدير خلال التاريخ/الوقت في سجل "التحكم في تصدير البيانات"). وتقوم العملية بتحديث حقل تصدير خلال التاريخ/الوقت في بداية المعالجة الدفعية لتجنب عدم إعداد قياس أولي كتاريخي بواسطة "تسجيل بيانات التغيير" أثناء فترة المعالجة.
- استخراج مخصص لبيانات القياس التاريخية (D1-SMDEH): يُستخدم لعمليات الاستخراج اليومية لبيانات القياس التاريخية. يتم تشغيل هذه العملية مقابل سجلات "تسجيل بيانات التغيير" في جدول "المعالجة العامة".
يستند تسلسل عمليات المعالجة الدفعية إلى "معرف مكون القياس"، ويتم إنشاء ملف واحد أو أكثر استنادًا إلى عدد تسلسلات العمليات التي تمت معالجتها ومعلمات التحكم في مجموعة المعالجة.
إنشاء الملفات وتسميتها
تستخدم عملية الاستخراج عنصري تحكم لتحديد عدد الملفات المطلوب إنشاؤها:
- يُنشئ كل تسلسل عمليات ملفًا واحدًا على الأقل (كلما ازداد عدد تسلسلات العمليات، كانت الملفات أصغر حجمًا).
- يمكن استخدام معلمة حد حجم الملف لتحديد عدد صفوف القياس المطلوب تضمينها في أي ملف محدد. ويمكن أن ينتج عن ذلك تسلسل عمليات واحد يشمل ملفات متعددة.
لا يتم ترتيب البيانات في كل ملف، حيث يعمل كل تسلسل عمليات على استرجاع بيانات القياس لمجموعة من "معرفات مكونات القياس"، ولا يمكن التحكم في كيفية تحميل البيانات في الملف بصورة أكثر من ذلك.
تسمية الملفات
بما أن كل تسلسل عمليات يمكن أن يُنتج ملفات متعددة ولا يمكن التنبؤ بعدد الملفات لكل تسلسل عمليات، ستتضمن أسماء الملفات أيضًا مؤشرًا للملف الأول في تسلسل العمليات والملف الأخير في تسلسل العمليات.
- MSRMT_EXPORT_<معلمة مجموعة معالجة بادئة الملف>_<رقم مجموعة المعالجة>_<رقم تسلسل عمليات مجموعة المعالجة>_<إجمالي عدد تسلسلات العمليات>_<مؤشر ملف تسلسل العمليات>_<تاريخ ووقت العملية>.csv.gz
حيث:
- <معلمة مجموعة معالجة بادئة الملف> هي بادئة ملف اختيارية يتم تحديدها باستخدام معلمة التحكم في مجموعة المعالجة بادئة اسم الملف
- <رقم مجموعة المعالجة> هو رقم مجموعة المعالجة للعملية
- <رقم تسلسل عمليات مجموعة المعالجة> هو رقم تسلسل العمليات الذي أنشأ الملف
- <إجمالي عدد تسلسلات العمليات> هو إجمالي عدد تسلسلات العمليات
- <مؤشر ملف تسلسل العمليات>: يتم تحديده لأول وآخر ملفين تم إنشاؤهما بواسطة تسسل العمليات، S لأول ملف، وE لآخر ملف.
- <تاريخ/وقت العملية> هو تاريخ ووقت إنشاء الملف، ويكون بالصيغة س س س س ش ش ي ي س س د د ث ث (حيث س س س س = السنة،و ش ش = الشهر، وي ي = اليوم، وس س = الساعة، ود د = الدقيقة، وث ث = الثانية)
أمثلة: بالنسبة إلى رقم مجموعة المعالجة 135، التي تتكون من 10 تسلسلات عمليات:
- أول ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: MSRMT_EXPORT_PREFIX_135_3_10_S_20191104173233.csv.gz
- كل الملفات قبل آخر ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: MSRMT_EXPORT_PREFIX_135_3_10_20191104173233.csv.gz
- آخر ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: MSRMT_EXPORT_PREFIX_135_3_10_E_20191104173233.csv.gz
تنسيق الملف
قابلية التطبيق |
||||||
---|---|---|---|---|---|---|
الحقل |
نوع البيانات |
نموذج على المحتوى |
الوصف |
فترة زمنية |
استهلاك |
الفترة الزمنية الطرحية |
MEASR_COMP_ID |
CHAR(12) |
000004769213 |
المفتاح الأساسي للقناة من العداد (المعروف أيضًا باسم "الجهاز") |
X |
X |
X |
MSRMT_DTTM |
DATE |
2019-01-01T00:00:00Z |
نهاية الفترة الزمنية التي يغطيها القياس. على سبيل المثال، إذا كانت هذه فترة زمنية من ساعة، ستتم تغطية 018-12-31T23:00:00Z to 2019-01-01T00:00:00Z. |
X |
X |
X |
PREV_MSRMT_DTTM |
DATE |
2018-12-31T00:00:00Z |
بالنسبة إلى قياسات الاستهلاك، يحدد هذا بداية الفترة الجاري قياسها. ملاحظة: يجب أن يكون هناك قياس آخر لنفس مكون القياس بهذا التاريخ مثل MSRMT_DTTM. |
X |
||
MSRMT_COND_FLG |
CHAR(6) |
501000 |
يحدد جودة القياس (مثل مُقدر أو عادي أو متميز). القيم الصالحة المعرفة في F1_EXTENDABLE_LOOKUP_VAL للبحث BUS_OBJ_CD D1-MeasurementConditionLookup. |
X |
X |
X |
MSRMT_USE_FLG |
CHAR(4) |
D101 |
للإشارة إلى ما إذا كان القياس قابلاً للاستخدام أم لا. القيم الصالحة محددة في CI_LOOKUP. |
X |
||
USER_EDITED_FLG |
CHAR(4) |
D1UE |
للإشارة إلى ما إذا كان المستخدم قد قام بتحرير القياس أم لا. القيم الصالحة محددة في CI_LOOKUP. |
X |
X |
X |
READING_VAL |
NUMBER(16,6) |
750000000 |
هذه هي قراءة قرص القياس المستخدمة لاحتساب المقدار المستهلك. |
X |
X |
|
READING_COND_FLG |
CHAR(6) |
501000 |
تحدد جودة القراءة اليومية (مثل مُقدر أو عادي أو متميز). القيم الصالحة المعرفة في F1_EXTENDABLE_LOOKUP_VAL للبحث BUS_OBJ_CD D1-MeasurementConditionLookup. |
X |
||
COMBINED_MULTIPLIER |
NUMBER(18,6) |
1 |
تحتوي على منتج "مضاعف مكون القياس" و"ثابت التركيب". ويتم ضرب قيمة MSRMT_VAL في هذا الرقم. |
X |
X |
X |
MSRMT_VAL |
NUMBER(16,6) |
1.23 |
هذا هو الاستهلاك المُبلغ عنه من العداد بعد اجتياز المراجعة وتحرير البيانات والتقدير (يُعرف أيضًا باسم جاهز للفوترة). |
X |
X |
X |
MSRMT_VAL1 |
NUMBER(16,6) |
هذه القيمة وقيم القياسات اللاحقة (MSRMT_VAL 1 إلى 10) هي قيم مشتقة يتم احتسابها من قيمة MSMRT_VAL الأساسية. ومن أمثلة ذلك تحويل وحدة القياس (من مائة قدم مكعب إلى وحدة حرارية) أو تسوية الخسارة. |
X |
X |
X |
|
MSRMT_VAL2 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL3 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL4 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL5 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL6 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL7 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL8 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL9 |
NUMBER(16,6) |
X |
X |
X |
||
MSRMT_VAL10 |
NUMBER(16,6) |
X |
X |
X |
||
CRE_DTTM |
DATE |
2019-10-31T11:09:31Z |
تاريخ/وقت إنشاء السجل. |
X |
X |
X |
LAST_UPDATE_DTTM |
DATE |
2019-11-09T16:35:02Z |
وقت آخر تحديث للسجل. |
X |
X |
X |
نموذج الملف
فيما يلي نموذج على ملف تصدير بيانات فترة زمنية مدتها ست ساعات. لاحظ أن هذا لا يتضمن التسميات أو رؤوس الأعمدة، ولكن تكون البيانات بنفس ترتيب أوصاف الأعمدة الواردة أعلاه في قسم تنسيق الملف.
000004769213,2019-01-01T08:00:00Z,,501000,,,,,1,1.3715,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000004769213,2019-01-01T09:00:00Z,,501000,,,,,1,1.882,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000004769213,2019-01-01T10:00:00Z,,501000,,,,,1,1.838,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000004769213,2019-01-01T11:00:00Z,,501000,,,,,1,1.8585,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000004769213,2019-01-01T12:00:00Z,,501000,,,,,1,1.836,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000004769213,2019-01-01T13:00:00Z,,501000,,,,,1,1.83,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:39:09Z,2019-08-09T20:39:09Z
000671510494,2019-01-01T08:00:00Z,,501000,,,,,1,0.486,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
000671510494,2019-01-01T09:00:00Z,,501000,,,,,1,0.4965,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
000671510494,2019-01-01T10:00:00Z,,501000,,,,,1,0.45,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
000671510494,2019-01-01T11:00:00Z,,501000,,,,,1,0.4725,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
000671510494,2019-01-01T12:00:00Z,,501000,,,,,1,0.4575,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
000671510494,2019-01-01T13:00:00Z,,501000,,,,,1,0.447,0,0,0,0,0,0,0,0,0,0,2019-08-09T20:56:47Z,2019-08-09T20:56:47Z
020643301975,2019-01-01T08:00:00Z,,501000,,,,,1,0.015,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z
020643301975,2019-01-01T09:00:00Z,,501000,,,,,1,0.015,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z
020643301975,2019-01-01T10:00:00Z,,501000,,,,,1,0.015,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z
020643301975,2019-01-01T11:00:00Z,,501000,,,,,1,0.015,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z
020643301975,2019-01-01T12:00:00Z,,501000,,,,,1,0.0165,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z
020643301975,2019-01-01T13:00:00Z,,501000,,,,,1,0.015,0,0,0,0,0,0,0,0,0,0,2019-08-09T21:04:28Z,2019-08-09T21:04:28Z