計量單位

您必須啟用與公用事業相關聯的計量單位,或視需要新增其他計量單位。您也可以更新計量單位的顯示順序。所有計量單位均以停用狀態提供。

解決方案隨附下列計量單位與指定的顯示順序。

服務類型 計量單位 顯示順序
電力 KW:千瓦 5
電力 KWH:千瓦小時 10
電力 MWH:百萬瓦小時 15
燃氣 CCF:百立方英呎 5
燃氣 TH:熱能單位 10
供水 GAL:加侖 5

下表提供有關您需要完成之任務的其他明細。

任務 組態 註釋
提取計量單位

GET /utilitiesAdmin/v1/unitOfMeasure?q=active=false

範例:

GET https://<hostname>/api/utilitiesAdmin/v1/unitOfMeasure?q=active=false

可以使用下列方式提取特定計量單位記錄:

GET /utilitiesAdmin/v1/unitOfMeasure/{id}

範例:

GET https://<hostname>/api/utilitiesAdmin/v1/unitOfMeasure/KW

啟用計量單位

POST /CXIPlatformService/v1/CXIReferenceEntity/unitOfMeasure

範例:

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

{

"items": [

{

"operation": "update",

"data": {

"id": "KW",

"active": true

}

}

]

}

針對與您公用事業相關聯的每個計量單位完成此任務。

將多個計量單位新增至「項目」列表,即可同時啟用多個計量單位。

編輯計量單位

POST /CXIPlatformService/v1/CXIReferenceEntity/unitOfMeasure

範例:

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

{

"items": [

{

"operation": "update",

"data": {

"id": "KW",

"serviceType": "E",

"active": true

}

}

]

}
將多個計量單位新增至「項目」列表,即可同時編輯多個計量單位。
編輯計量單位的顯示順序

POST /CXIPlatformService/v1/CXIReferenceEntity/unitOfMeasure

範例:

POST https://<fabric host>/api/CXIPlatformService/v1/CXIReferenceEntity/unitOfMeasure

{

"items": [

{

"operation": "update",

"data": {

"id": "<unit of measure>",             // unit of measure such as KW, CCF, etc

"serviceType": "<serviceTypeId>",     // the service type associated with the unit of measure

"displayOrder": <number>              // newly introduced config

}

}

]

}
建立新計量單位

POST /CXIPlatformService/v1/CXIReferenceEntity/unitOfMeasure

範例:

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

{

"items": [

{

"operation": "create",

"data": {

"id": "CF",

"code": "CF",

"active": true,

"description": "ORA_UER_UOM_CF", // Lookup Code

"serviceType": "G"

}

}

]

}

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

將多個計量單位新增至「項目」列表,即可同時建立多個計量單位。

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