تصدير بيانات القياس

يتم دعم تصدير البيانات من كائن صيانة القياس من خلال التصدير "المخصص". لمزيد من المعلومات حول تصدير البيانات المخصص، راجع تصدير البيانات المخصص في دليل المستخدم الإداري لإطار عمل التطبيق (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).

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

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

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

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

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

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

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

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

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

  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

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

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