خدمات إدارة العدادات
يصف هذا القسم خدمات إدارة العداد للوحدة المركبة لمهمات الاختبار.
AddMeters
تقوم خدمة الويب هذه بإضافة مجموعة عدادات إلى مخزن البيانات المضمن بالذاكرة. ولن يؤدي هذا إلى إضافته نهائيًا إلى ملف التحكم.
مدخلات — AddMetersInput
الجزء: payload
العنصر: AddMetersRequest
المعلمة |
الوصف |
---|---|
id |
رمز التعريف للعداد. |
macID |
عنوان MAC الذي يجب أن يكون فريدًا داخل النظام. |
utility |
سلسلة معلوماتية. |
serviceType |
إحدى قيم ServiceType الصالحة (راجع المخطط). "الكهرباء" هو الخيار الوحيد في الوقت الحالي. |
isCommissioned |
سواء كان العداد بالحالة "موصَّل" أم لا. |
loadActionCode |
إحدى قيم LoadActionCode المحتملة المستخدمة في الاتصال وفصل الاتصال (راجع المخطط). |
outageEventType |
إحدى قيم OutageEventType المحتملة المستخدمة في التحقق من حالة الجهاز (راجع المخطط). |
executionStatus |
إحدى قيم ExecutionStates المحتملة (راجع المخطط). وتتحكم هذه القيم في كيفية استجابة العداد للأوامر. |
groupName |
الاسم الذي يربط عدة عدادات معًا في مجموعة. |
jobExecutionStatus |
إحدى قيم حالة تنفيذ المهمة الممكنة (راجع المخطط). تحدد هذه السمة كيفية أداء المهمات المطلوبة. |
updateIfExisting |
ما إذا كان سيتم تحديث العداد بالقيم المدخلة أم لا إذا كانت موجودة بالفعل في الفهرس. |
Comment |
سلسلة معلوماتية تصف الغرض من العداد. |
Channels |
قائمة وحدات القياس التي يدعمها هذا العداد. |
uomCode |
رمز يصف وحدة القياس للقناة. |
uomName |
سلسلة قصيرة تحتوي على اسم وحدة القياس. |
decimals |
عدد الأرقام على يمين الخانة العشرية التي يجب إنشاؤها عند قراءة العداد. |
description |
وصف أطول لوحدة القياس. |
مخرجات — AddMetersOutput
الجزء: payload
العنصر: AddMetersResult
سواء تمت إضافة كل عداد إلى الفهرس أم لا.
الخطأ — راجع UtilityFault
RemoveMeter
تقوم خدمة الويب هذه بإزالة العداد من مخزن البيانات المضمن بالذاكرة. ولن يؤدي هذا إلى حذفه نهائيًا من ملف التحكم.
مدخلات — RemoveMeterInput
الجزء: payload
العنصر: RemoveMeterRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد المطلوب إزالته |
مخرجات — RemoveMeterOutput
الجزء: payload
العنصر: RemoveMeterResult
سواء تمت إزالة العداد من الفهرس أم لا.
الخطأ — راجع UtilityFault. يتم عرضه في حالة عدم العثور على معرف العداد.
AddMeterChannel
تقوم خدمة الويب هذه بإضافة قناة جديدة إلى عداد واحد.
مدخلات — AddMeterChannelInput
الجزء: payload
العنصر: AddMeterChannelRequest
المعلمة |
الوصف |
---|---|
id |
رمز التعريف للعداد. |
uomCode |
رمز يصف وحدة القياس للقناة. |
uomName |
سلسلة قصيرة تحتوي على اسم وحدة القياس. |
decimals |
عدد الأرقام على يمين الخانة العشرية التي يجب إنشاؤها عند قراءة العداد. |
description |
وصف أطول لوحدة القياس. |
مخرجات — AddMeterChannelOutput
الجزء: payload
العنصر: AddMeterChannelResult
سواء تمت إضافة القناة إلى الفهرس أم لا.
الخطأ — راجع UtilityFault. يتم عرضه في حالة عدم العثور على معرف العداد.
RemoveMeterChannel
تقوم خدمة الويب هذه بإزالة القناة من العداد.
مدخلات — RemoveMeterChannelInput
الجزء: payload
العنصر: RemoveMeterChannelRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد المطلوب إزالته. |
uomCode |
رمز يصف وحدة القياس للقناة. |
uomName |
سلسلة قصيرة تحتوي على اسم وحدة القياس. |
يتم الجمع بين هذه المعلمات الثلاثة لتحديد موقع قناة فريدة
مخرجات — RemoveMeterChannelOutput
الجزء: payload
العنصر: RemoveMeterChannelResult
سواء تمت إزالة القناة من العداد أم لا.
الخطأ — راجع UtilityFault. يتم عرضه في حالة عدم العثور على معرف العداد.
ReadScalarMeter
تقوم خدمة الويب هذه بإنشاء قراءة استهلاك لكل قناة لعداد محدد.
مدخلات — ReadScalarMeterInput
الجزء: payload
العنصر: ReadScalarMeterRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد المطلوب قراءته. |
مخرجات — ReadScalarMeterOutput
الجزء: payload
العنصر: ReadScalarMeterResult
قراءات استهلاك صفرية أو أكثر للعداد المحدد.
المعلمة |
الوصف |
---|---|
uomCode |
رمز يصف وحدة القياس للقناة. |
uomName |
سلسلة قصيرة تحتوي على اسم وحدة القياس. |
decimals |
عدد الأرقام على يمين الخانة العشرية التي يجب إنشاؤها عند قراءة العداد. |
description |
وصف أطول لوحدة القياس. |
value |
رقم عشوائي يمثل قراءة الاستهلاك. |