تصدير عناوين بيانات القياس الأولية

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

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

نوع الخيار

قيمة الخيار

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

F1SE (مخصص)

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

D1-SIMDC (تصدير مخصص لعناوين بيانات القياس الأولية الحالية)

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

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

  • تقوم عمليات الاستخراج الأولية بتجميع استخراج أولي لعناوين بيانات القياس الأولية، والتي يتم التحكم بها من خلال إدخال تاريخ/وقت بدء وانتهاء لعناوين بيانات القياس الأولية التي يجب استخراجها. يجب استخدام هذه العملية لتنفيذ الاستخراج الأولي للبيانات قبل استخدام عمليات الاستخراج التاريخية اليومية والحالية.
  • يعمل استخراج البيانات الحالية اليومية على تجميع بيانات القياس للقياسات التي تمت إضافتها أو تغييرها خلال آخر 30 يومًا. ويعتمد هذا الاستخراج على حقل الطابع الزمني لآخر تحديث في جدول "بيانات القياس الأولية"، وحقل تصدير حتى التاريخ/الوقت في سجل "التحكم في تصدير البيانات" (راجع أدناه) لتضمين التغييرات التي حدثت منذ آخر استخراج فقط.
  • يعمل استخراج البيانات التاريخية اليومية على تجميع بيانات القياسات الأولية التي تمت إضافتها أو تغييرها قبل آخر 30 يومًا. ولتجنب الحاجة إلى فحص جدول "بيانات القياس الأولية" بالكامل، يعتمد هذا الاستخراج على "تسجيل بيانات التغيير". وأثناء معالجة بيانات القياس الأولية، إذا كان القياس الأولي يحتوي على قياسات أقدم من 30 يومًا، يتم إنشاء سجل "تسجيل بيانات تغيير" في جدول "المعالجة العامة".
    يتطلب تمكين تسجيل بيانات التغيير التاريخية تكوين معلمات الخوارزميات التالية:
    • تسجيل تغييرات القياسات التاريخية: صواب
    • التحكم في مجموعة معالجة استخراج بيانات القياس الأولية التاريخية: D1-SMDEH (استخراج مخصص لعناوين بيانات القياس الأولية - التاريخية)
    يجب تكوين هذه المعلمات كما هو موضح في الخوارزميات التالية:
    • تحديث تاريخ/وقت آخر قياس بمكون القياس مع مزامنة الاستهلاك (D1-UPD-DTMC)
    • تحديث تاريخ/وقت آخر قياس بمكون قياس الاستهلاك مع مزامنة الاستهلاك (D1-UDTSCMCRE)
    • تحديث آخر تاريخ/وقت بمكون القياس من قياس مستقبلي (D1-UPD-DTMCF)
    • تحديث آخر تاريخ/وقت في مكون قياس الاستهلاك (D1-UPDDTSCMC)
ملاحظة: يعتبر استخدام "تسجيل بيانات التغيير" هذا استثناءً للقاعدة العامة الموضحة في قسم تصدير البيانات المخصص في دليل المستخدم الإداري لإطار عمل التطبيق (Application Framework Administrative User Guide).

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

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

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

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

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

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

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

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

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

  1. يُنشئ كل تسلسل عمليات ملفًا واحدًا على الأقل (كلما ازداد عدد تسلسلات العمليات، كانت الملفات أصغر حجمًا)
  2. يمكن استخدام معلمة حد حجم الملف لتحديد عدد صفوف بيانات القياس الأولية المطلوب تضمينها في أي ملف محدد. ويمكن أن ينتج عن ذلك تسلسل عمليات واحد يشمل ملفات متعددة.

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

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

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

  • IMD_​EXPORT_​<معلمة مجموعة معالجة بادئة الملف>_​<رقم مجموعة المعالجة>_​<رقم تسلسل عمليات مجموعة المعالجة>_​<إجمالي عدد تسلسلات العمليات>_​<رقم الملف>_​<مؤشر آخر ملف>_​<تاريخ المعالجة>.csv.gz

حيث:

  • <معلمة مجموعة معالجة بادئة الملف> هي بادئة ملف اختيارية يتم تحديدها باستخدام معلمة التحكم في مجموعة المعالجة بادئة اسم الملف
  • <رقم مجموعة المعالجة> هو رقم مجموعة المعالجة للعملية
  • <رقم تسلسل عمليات مجموعة المعالجة> هو رقم تسلسل العمليات الذي أنشأ الملف
  • <إجمالي عدد تسلسلات العمليات> هو إجمالي عدد تسلسلات العمليات
  • <رقم الملف> هو رقم الملف
  • <مؤشر آخر ملف>: يحدد آخر ملف مُنشأ بواسطة تسلسل عمليات (E)
  • <تاريخ/وقت العملية> هو تاريخ ووقت إنشاء الملف، ويكون بالصيغة س س س س ش ش ي ي س س د د ث ث (حيث س س س س = السنة،و ش ش = الشهر، وي ي = اليوم، وس س = الساعة، ود د = الدقيقة، وث ث = الثانية)

أمثلة: بالنسبة إلى رقم مجموعة المعالجة 135، التي تتكون من 10 تسلسلات عمليات:

  • أول ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: IMD_​EXPORT_​SOME_​PREFIX_​135_​3_​10_​1_​20191104173233.csv.gz
  • كل الملفات قبل آخر ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: IMD_​EXPORT_​SOME_​PREFIX_​135_​3_​10_​2_​20191104173233.csv.gz
  • آخر ملف من ثالث تسلسل عمليات من أصل 10 تسلسلات عمليات: IMD_​EXPORT_​SOME_​PREFIX_​135_​3_​10_​E_​20191104173233.csv.gz

تنسيق الملف

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

قابلية التطبيق

الحقل

نوع البيانات

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

الوصف

فترة زمنية

استهلاك

الفترة الزمنية الطرحية

INIT_​MSRMT_​DATA_​ID

CHAR(12)

52482245116604

المفتاح الأساسي للقياس الأولي

X

X

X

MEASR_​COMP_​ID

CHAR(12)

000004769213

المفتاح الأساسي لمكون القياس الأولي

X

X

X

IMD_​EXT_​ID

CHAR(12)

external_​file

المعرف الخارجي للقياس الأولي. وعادةً ما يكون اسم الملف الذي تم استلام بيانات القياس الأولية فيه.

X

X

X

BUS_​OBJ_​CD

CHAR(12)

D1-ManualIMDInterval

كائن العمل الذي يتحكم في القياس الأولي

X

X

X

BO_​STATUS_​CD

VARCHAR(30)

COMPLETED

حالة القياس الأولي

X

X

X

BO_​STATUS_​REASON_​CD

VARCHAR(30)

FORCE COMPLETE

رمز سبب الحالة. يتم ملؤه عامةً عند وجود استثناء مراجعة وتحرير بيانات وتقدير (VEE) تم تجاوزه وتم إتمام القياس الأولي بدون تصحيح الخطأ.

X

X

X

D1_​FROM_​DTTM

DATE/TIME

2019-01-01T00:00:00Z

بداية الفترة الزمنية التي يغطيها القياس الأولي.

بالنسبة إلى بيانات الاستهلاك الطرحي، تمثل هذه القيمة القياس السابق الذي سيتم استخدامه كقراءة بدء عند احتساب الاستهلاك.

وبالنسبة إلى بيانات الفترة الزمنية، تمثل هذه القيمة بداية الفترة الزمنية الأولى للقياس الأولي. ملاحظة: لن يتم إنشاء قياسات لهذا التاريخ/الوقت لأن تطبيق إدارة بيانات العدادات (MDM) يمثل الفترات الزمنية باعتبارها نهاية الفترة الزمنية. لذا، ستكون الفترة الزمنية الأولى للقياس الأولي هي هذا التاريخ/الوقت زائد حجم الفترة الزمنية (على سبيل المثال، إذا كان حجم الفترة الزمنية 15 دقيقة، تكون الفترة الزمنية الأولى 15 دقيقة بعد هذا التاريخ/الوقت).

X

X

X

D1_​TO_​DTTM

DATE/TIME

2019-01-02T00:00:00Z

نهاية الفترة الزمنية التي يغطيها القياس الأولي.

بالنسبة إلى بيانات الاستهلاك، سيتطابق هذا التاريخ/الوقت مع القياس.

وبالنسبة إلى بيانات الفترة الزمنية، سيتطابق ذلك مع تاريخ/وقت آخر قياس فترة زمنية.

X

X

X

CRE_​DTTM

DATE/TIME

2019-01-03T00:00:00Z

تاريخ ووقت إنشاء القياس الأولي في البداية

X

X

X

STATUS_​UPD_​DTTM

DATE/TIME

2019-01-03T00:00:00Z

تاريخ ووقت آخر تحديث لحالة القياس الأولي

X

X

X

LAST_​UPDATE_​DTTM

DATE/TIME

2019-01-03T00:00:00Z

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

ملاحظة: يمكن أن تقع التحديثات خارج إطار تغيير الحالة، لذا قد يكون هذا أحدث من STATUS_​UPD_​DTTM.

X

X

X

نموذج الملف

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

55394295586154,553275345711,external file1,D1-ManualIMDScalar,ERROR,,2020-01-02T08:00:00Z,2022-01-01T08:00:00Z,2020-08-17T18:47:41Z,2020-08-17T18:47:41Z,2020-08-17T18:48:54Z
55392270285377,553886220134,external file2,D1-ManualIMDInterval,ERROR,,2022-01-01T08:00:00Z,2022-01-02T08:00:00Z,2020-08-15T04:18:43Z,2020-08-15T04:25:57Z,2020-08-15T04:25:57Z
55383485376359,553886220134,external file3,D1-ManualIMDInterval,ERROR,,2022-01-01T08:00:00Z,2022-01-02T08:00:00Z,2020-08-15T04:47:36Z,2020-08-15T04:55:03Z,2020-08-15T04:55:03Z