خدمات إدارة العدادات

يصف هذا القسم خدمات إدارة العداد للوحدة المركبة لمهمات الاختبار.

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	رقم عشوائي يمثل قراءة الاستهلاك.