معرف الاستهلاك القياسي

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

الرمز الوصف وحدة القياس المرتبطة
KWH-- كيلو وات/ساعة KWH
KWH-ON- كيلو وات/ساعة - وقت الذروة KWH
KWH-OFF- كيلو وات/ساعة - خارج وقت الذروة KWH
KWH-MID- كيلو وات/ساعة - متوسط KWH
KW-- كيلو وات KW
TH-- وحدة حرارية TH
GAL-- جالونات GAL

يوضح الجدول أدناه تفاصيل إضافية عن المهام التي يتعين عليك إكمالها.

المهمة التكوين التعليقات
إحضار معرف استهلاك قياسي

GET /utilitiesAdmin/v1/standardUsageIdentifier?q=active=true

مثال:

GET https://<hostname>/api/utilitiesAdmin/v1/standardUsageIdentifier?q=active=true

يمكن إحضار معرف محدد باستخدام:

GET /utilitiesAdmin/v1/standardUsageIdentifier/{id}

مثال:

GET https://<hostname>/api/utilitiesAdmin/v1/standardUsageIdentifier/KW--

تنشيط معرف استهلاك قياسي

POST /CXIPlatformService/v1/CXIReferenceEntity/standardUsageIdentifier

مثال:

POST https://<hostname>/api/CXIPlatformService/v1/CXIReferenceEntity/standardUsageIdentifier

{

"items": [

{

"operation": "update",

"data": {

"id": "KWH--",

"active": true

}

}

]

}

أكمل هذه المهمة لكل معرف استهلاك قياسي مرتبط بالمرافق.

يمكن تنشيط معرفات استهلاك قياسي متعددة معًا عن طريق إضافتها إلى قائمة "العناصر".

تحرير معرف استهلاك قياسي

POST /CXIPlatformService/v1/CXIReferenceEntity/standardUsageIdentifier

مثال:

POST https://<hostname>/api/CXIReferenceEntity/v1/CXIReferenceEntity/standardUsageIdentifier

{

"items": [

{

"operation": "update",

"data": {

"id": "KW--",

"color": "#DE7F11",

"unitOfMeasure": "KW",

"active": true

}

}

]

}
يمكن تحرير معرفات استهلاك قياسي متعددة معًا عن طريق إضافتها إلى قائمة "العناصر".
إنشاء معرف استهلاك قياسي جديد

POST /CXIPlatformService/v1/CXIReferenceEntity/standardUsageIdentifier

مثال:

POST https://<hostname>/api/CXIPlatformService/v1/CXIReferenceEntity/standardUsageIdentifier

{

"items": [

{

"operation": "create",

"data": {

"id": "KL--",

"usageIdentifier": "KL--",

"color": "#DE7F11",

"unitOfMeasure": "KL",

"active": true,

"description": "ORA_UER_USAGE_IDENT_KL_ON" // Lookup Code

}

}

]

}

توصي أوراكل باستخدام نفس قيمة 'id' و'usageIdentifier'.

كما أن "description" حقل قابل للترجمة، لذا يجب أن تكون القيمة هي رمز البحث المرتبط الذي تم إنشاؤه ضمن نوع البحث ORA_UER_USAGE_IDENTIFIER.

يمكن إنشاء معرفات استهلاك قياسي متعددة معًا عن طريق إضافتها إلى قائمة "العناصر".

لمزيد من المعلومات حول قيم البحث، راجع نظرة عامة على قيم البحث.