تصدير بيانات القياس المجمعة

يتم دعم تصدير البيانات من كائن صيانة "القياس المجمع" (D1-AGGMSRMT) من خلال التصدير "المخصص". لمزيد من المعلومات حول تصدير البيانات المخصص، راجع تصدير البيانات المخصص في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide). يتم تكوين كائن صيانة "القياس المجمع" لدعم تصدير البيانات من خلال الخيارات التالية:

نوع الخيار

قيمة الخيار

فئة تصدير البيانات

F1SE (مخصص)

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

D1-SAMDC (استخراج القياس المجمع المخصص)

الاستخراج الأولي مقابل الحالي مقابل التاريخي

توجد ثلاثة أنواع من عمليات الاستخراج المُستخدمة مع كائن صيانة "القياس المجمع":

  • تقوم عمليات الاستخراج الأولية بتجميع استخراج أولي لبيانات القياس المجمعة، والتي يتم التحكم بها من خلال إدخال تاريخ/وقت بدء وانتهاء للقياسات التي يجب استخراجها. يجب استخدام هذه العملية لتنفيذ الاستخراج الأولي لبيانات القياس المجمعة قبل استخدام عمليات الاستخراج التاريخية اليومية والحالية اليومية.

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

  • يعمل استخراج البيانات التاريخية اليومية على تجميع بيانات القياس المجمعة للقياسات الأقدم من آخر 30 يومًا التي تمت إضافتها أو تغييرها. لتجنب الحاجة إلى فحص جدول "القياس المجمع" بالكامل، يعتمد هذا الاستخراج على "تسجيل بيانات التغيير". أثناء معالجة بيانات القياس الأولية إذا كان القياس المجمع يحتوي على قياسات أقدم من 30 يومًا، يتم إنشاء سجل "تسجيل بيانات التغيير" في جدول "المعالجة العامة".

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

  • تسجيل تغييرات التجميع التاريخية: صواب

  • التحكم في مجموعة المعالجة التاريخية للتجميع: D1-SAMDH (استخراج مخصص لبيانات القياس المجمعة التاريخية)

يجب تكوين هذه المعلمات كما هو موضح في الخوارزميات التالية:

  • إنشاء سجل معالجة عامة للتجميع الديناميكي التاريخي (D1CGPHISAGG)

  • إنشاء سجل معالجة عامة للاشتقاق الثابت التاريخي (D1CGPHISA)

ملاحظة: يعتبر استخدام "تسجيل بيانات التغيير" هذا استثناءً للقاعدة العامة الموضحة في قسم تصدير البيانات المخصص في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide).

سجلات التحكم في تصدير البيانات

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

لمزيد من المعلومات حول إنشاء سجلات التحكم في تصدير البيانات، راجع تحديد التحكم في تصدير البيانات في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide).

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

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

  • القياس المجمع المخصص أولي (D1-SAMDI): يتم استخدامه للاستخراج الأولي لبيانات القياس المجمعة. وعلى عكس الاستخراج الحالي، يتم التحكم في مجموعة المعالجة هذه مباشرةً عن طريق إدخال تاريخ/وقت البدء والانتهاء للقياسات التي يجب استخراجها. يجب استخدام هذه العملية لتنفيذ الاستخراج الأولي لبيانات القياس المجمعة قبل استخدام الاستخراج الحالي (D1-SAMDC) والاستخراج التاريخي (D1-SAMDH). للحصول على أفضل أداء، يوصى بتقسيم فترة الاستخراج الأولي إلى فترات أصغر متعددة واستخدام تسلسلات عمليات متعددة لكل فترة. تقوم عملية الاستخراج باسترجاع كل القياسات المجمعة التي لها قياسات تمتد حتى تاريخ/وقت لاحق لتاريخ/وقت البدء المُدخل وسابق لتاريخ/وقت الانتهاء المُدخل أو موافق له.

  • استخراج القياس المجمع المخصص (D1-SAMDC): يُستخدم لعمليات الاستخراج اليومية لبيانات القياس المجمعة (الجديدة) الحالية. تقوم هذه العملية باستخراج البيانات التي تم تغييرها منذ تشغيل آخر عملية استخراج (استنادًا إلى حقل تصدير خلال التاريخ/الوقت في سجل "التحكم في تصدير البيانات". وتقوم العملية بتحديث حقل تصدير خلال التاريخ/الوقت في بداية المعالجة الدفعية لتجنب عدم إعداد قياس أولي كتاريخي بواسطة "تسجيل بيانات التغيير" أثناء فترة المعالجة.

  • تاريخي مخصص لاستخراج بيانات القياس المجمعة (D1-SAMDH): يُستخدم لعمليات الاستخراج اليومية لبيانات القياس المجمعة التاريخية. يتم تشغيل هذه العملية مقابل سجلات "تسجيل بيانات التغيير" في جدول "المعالجة العامة"

يستند تسلسل عمليات المعالجة الدفعية إلى "معرف مكون القياس"، ويتم إنشاء ملف واحد أو أكثر استنادًا إلى عدد تسلسلات العمليات التي تمت معالجتها ومعلمات التحكم في مجموعة المعالجة.

إنشاء الملفات وتسميتها

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

  1. يُنشئ كل تسلسل عمليات ملفًا واحدًا على الأقل (كلما ازداد عدد تسلسلات العمليات، كانت الملفات أصغر حجمًا).

  2. يمكن استخدام معلمة حد حجم الملف لتحديد عدد صفوف القياس المجمع المطلوب تضمينها في أي ملف محدد. ويمكن أن ينتج عن ذلك تسلسل عمليات واحد يشمل ملفات متعددة.

لا يتم ترتيب البيانات في كل ملف، حيث يعمل كل تسلسل عمليات على استرجاع بيانات القياس المجمعة لمجموعة من "معرفات مكونات القياس"، ولا يمكن التحكم في كيفية تحميل البيانات في الملف بصورة أكثر من ذلك.

تسمية الملفات

بما أن كل تسلسل عمليات يمكن أن يُنتج ملفات متعددة ولا يمكن التنبؤ بعدد الملفات لكل تسلسل عمليات، ستتضمن أسماء الملفات أيضًا مؤشرًا للملف الأول في تسلسل العمليات والملف الأخير في تسلسل العمليات.

  • 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

تنسيق الملف

ينتج عن عملية الاستخراج ملفات قيم مفصولة بفواصل (CSV) بالبيانات الموضحة في الجدول التالي. يتم تضمين أسماء الحقول في عمود الحقل في ملف المخرجات كصف عنوان إذا تم تعيين معلمة تضمين العنوان في عناصر التحكم في مجموعة المعالجة إلى "نعم".

ملاحظة: سيتم تحويل كل التواريخ/الأوقات من تنسيق OUAF إلى تنسيق ISO المناسب بالتوقيت العالمي الإحداثي (UTC) مع المنطقة الزمنية المُدخلة (بالحرف "Z").

الحقل

نوع البيانات

نموذج على المحتوى

الوصف

MEASR_​COMP_​ID

CHAR(12)

000004769213

المفتاح الأساسي للقناة من العداد (المعروف أيضًا باسم "الجهاز")

MSRMT_​DTTM

DATE

2019-01-01T00:00:00Z

نهاية الفترة الزمنية التي يغطيها القياس. على سبيل المثال، إذا كانت هذه فترة زمنية من ساعة، ستتم تغطية 018-12-31T23:00:00Z to 2019-01-01T00:00:00Z.

PREV_​MSRMT_​DTTM

DATE

2018-12-31T00:00:00Z

بالنسبة إلى قياسات الاستهلاك، يحدد هذا بداية الفترة الجاري قياسها. ملاحظة: يجب أن يكون هناك قياس آخر لنفس مكون القياس بهذا التاريخ مثل MSRMT_​DTTM.

MSRMT_​COND_​FLG

CHAR(6)

501000

يحدد جودة القياس (مثل مُقدر أو عادي أو متميز). القيم الصالحة المعرفة في F1_​EXTENDABLE_​LOOKUP_​VAL للبحث BUS_​OBJ_​CD D1-MeasurementConditionLookup.

MSRMT_​USE_​FLG

CHAR(4)

D101

للإشارة إلى ما إذا كان القياس قابلاً للاستخدام أم لا. القيم الصالحة محددة في CI_​LOOKUP.

USER_​EDITED_​FLG

CHAR(4)

D1UE

للإشارة إلى ما إذا كان المستخدم قد قام بتحرير القياس أم لا. القيم الصالحة محددة في CI_​LOOKUP.

READING_​VAL

لا يتم تضمين قيم هذا الحقل في تصدير القياس المجمع.

READING_​COND_​FLG

لا يتم تضمين قيم هذا الحقل في تصدير القياس المجمع.

COMBINED_​MULTIPLIER

لا يتم تضمين قيم هذا الحقل في تصدير القياس المجمع.

MSRMT_​VAL

NUMBER(16,6)

1.23

هذا هو الاستهلاك المُبلغ عنه من العداد بعد اجتياز المراجعة وتحرير البيانات والتقدير (يُعرف أيضًا باسم جاهز للفوترة).

MSRMT_​VAL1

NUMBER(16,6)

هذه القيمة وقيم القياسات اللاحقة (MSRMT_​VAL 1 إلى 10) هي قيم مشتقة يتم احتسابها من قيمة MSMRT_​VAL الأساسية. ومن أمثلة ذلك تحويل وحدة القياس (من مائة قدم مكعب إلى وحدة حرارية) أو تسوية الخسارة.

MSRMT_​VAL2

NUMBER(16,6)

MSRMT_​VAL3

NUMBER(16,6)

MSRMT_​VAL4

NUMBER(16,6)

MSRMT_​VAL5

NUMBER(16,6)

MSRMT_​VAL6

NUMBER(16,6)

MSRMT_​VAL7

NUMBER(16,6)

MSRMT_​VAL8

NUMBER(16,6)

MSRMT_​VAL9

NUMBER(16,6)

MSRMT_​VAL10

NUMBER(16,6)

CRE_​DTTM

DATE

2019-10-31T11:09:31Z

تاريخ/وقت إنشاء السجل.

LAST_​UPDATE_​DTTM

DATE

2019-11-09T16:35:02Z

وقت آخر تحديث للسجل.

نموذج الملف

فيما يلي نموذج على ملف تصدير بيانات فترة زمنية مدتها ست ساعات. لاحظ أن هذا لا يتضمن التسميات أو رؤوس الأعمدة، ولكن البيانات بنفس ترتيب أوصاف الأعمدة الواردة أعلاه في قسم تنسيق الملف.

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