標準用量識別碼

解決方案隨附下列標準用量識別碼。每個用量識別碼都與一個計量單位相關聯。您必須啟動識別碼以及與您公用事業相關聯的計量單位,或視需要新增其他識別碼。您也可以變更與每個項目相關聯的顏色,以符合您的公用事業品牌顏色。所有標準用量識別碼皆為停用。

代碼 描述 關聯計量單位
KWH-- 千瓦小時 KWH
KWH-ON- 千瓦小時 - 尖峰 KWH
KWH-OFF- 千瓦小時 - 離峰 KWH
KWH-MID- 千瓦小時 - 中 KWH
KW-- 千瓦 KW
TH-- Therm 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

}

}

]

}

Oracle 建議對 'id' 和 'usageIdentifier' 使用相同的值。

此外,「描述」是可轉譯的欄位,因此該值應為在查尋類型 ORA_UER_USAGE_IDENTIFIER 下建立的相關查尋代碼。

將多個標準用量識別碼新增至「項目」列表,即可同時建立多個標準用量識別碼。

如需有關「查尋」的其他資訊,請參閱查尋概要