تحديد خدمات العداد
يصف هذا القسم خدمات الويب لتحديد العدادات للوحدة المركبة لمهمات الاختبار.
FindMeters
تقوم خدمة الويب هذه بالاستعلام عن مخزن البيانات لعداد واحد أو أكثر. الفرق بين GetMeter وFindMeters، GetMeter يمكن أن يقوم بإرجاع عداد واحد على الأكثر ويجب أن يتطابق مع المعرف المُقدم بالضبط. سينتج عن GetMeter ظهور خطأ في حالة عدم العثور على المعرف. يستطيع FindMeters إرجاع أكثر من عداد واحد (عند استخدام regex) ولن ينتج عنه ظهور خطأ عندما لا يتطابق المعرف مع أي من عدادات المؤشر.
المدخلات — FindMetersInput
الجزء: payload
العنصر: FindMetersRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد الذي يستخدم للبحث |
isRegex |
يمكن أن يكون المعرف المقدم ذو قيمة regex عندما تكون هذه المَعلمة بالقيمة "صواب". تلميح: للبحث عن جميع العدادات في النظام، استخدم ".*" للمعرف. |
المخرجات — FindMetersOutput
الجزء: payload
العنصر: FindMetersResult
يمكن إرجاع صفر أو أكثر من كائنات العداد من البحث
الخطأ — راجع UtilityFault. بخلاف الأساليب الأخرى، لا يقوم FindMeters بطرح استثناء إذا لم يتم العثور على العداد. على هذا النحو، يمكن استخدامه لاختبار وجود عداد قبل الاستعلام عنه.
IsMeterDefined
تقوم خدمة الويب هذه بالاستعلام عما إذا كان هناك عداد معين محدد في مخزن البيانات.
المدخلات — IsMeterDefinedInput
الجزء: payload
العنصر: IsMeterDefinedRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد الذي يستخدم للبحث |
المخرجات — IsMeterDefinedOutput
الجزء: payload
العنصر: IsMeterDefinedResult
ما إذا كان المعرف المقدم جزءًا من المؤشر أم لا.
الخطأ — راجع UtilityFault. يتم عرضه في حالة عدم العثور على معرف العداد.
GetMeter
تقوم خدمة الويب هذه بإرجاع كافة سمات العداد الواحد من مخزن البيانات المضمن في الذاكرة. الفرق بين GetMeter وFindMeters، GetMeter يمكن أن يقوم بإرجاع عداد واحد على الأكثر ويجب أن يتطابق مع المعرف المُقدم بالضبط. سينتج عن GetMeter ظهور خطأ في حالة عدم العثور على المعرف. يستطيع FindMeters إرجاع أكثر من عداد واحد (عند استخدام regex) ولن ينتج عنه ظهور خطأ عندما لا يتطابق المعرف مع أي من عدادات المؤشر.
المدخلات — GetMeterInput
الجزء: payload
العنصر: GetMeterRequest
المعلمة |
الوصف |
---|---|
id |
معرف العداد الذي يستخدم للبحث |
المخرجات — GetMeterOutput
الجزء: payload
العنصر: GetMeterResult
كائن العداد المطلوب بواسطة المعرف.
الخطأ — راجع UtilityFault. يتم عرضه في حالة عدم العثور على معرف العداد.