承載處理常式類別與參數

本節針對支援的前端系統與承載類型,提供有效的「承載處理常式類別名稱」和相關聯的動態參數。

Adapter Development Kit

Adapter Development Kit 在交付時,即可針對從 AMI 前端系統匯出、且採用「原生」初始測量與裝置事件資料格式 (初始測量與裝置事件匯集器業務物件的格式) 的用量與事件資料進行承載處理。如需詳細資訊,請參閱 Adapter Development Kit 原生格式

承載類型:ADK CSV

  • 承載處理常式類別:com.splwg.d1.domain.sgg.dg.processing.CSVPayloadHandler

承載類型:ADK XML

  • 承載處理常式類別:com.splwg.d1.domain.sgg.dg.processing.XMLPayloadHandler

承載類型:ADK 匯集器

  • 承載處理常式類別:com.splwg.d1.domain.sgg.dg.processing.SeederPayloadHandler

處理自訂與非標準格式

您可以將 Adapter Development Kit 設定為支援對來自 AMI 前端系統之自訂與非標準格式的資料進行承載處理。處理此類型承載需要特定的承載處理常式類別 (請參閱下方),並建立 Groovy 程式庫指令檔,以剖析資料並將其轉換為「原生」格式。如需詳細資訊,請參閱 Adapter Development Kit 自訂承載處理承載處理使用者出口攔截器指令檔

  • 承載處理常式類別:com.splwg.d1.domain.sgg.dg.processing.PayloadHandlerViaUserExits

Adapter Development Kit 也支援對「通用資訊模型」(CIM) 格式的資料進行承載處理。如需詳細資訊,請參閱 Adapter Development Kit 通用資訊模型 (CIM) 承載處理

Itron OpenWay 轉接器

承載類型:Itron OpenWay XML

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d8.processing.ItronXMLPayloadHandler
  • 動態參數

動態參數名稱

描述與有效值

intervalValueDecPlaces

可選值。指定數量值小數點後的位數。如果遺漏此參數,處理邏輯會將小數點後的位數預設為 6。

filterRegisterSource

可選值。判斷是否應篩選來源記錄器資料。有效值為「真」與「假」(預設)

承載類型:Itron OpenWay 例外

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d8.processing.ExceptionPayloadHandler

Itron 的 MV-90 轉接器

承載類型:MV90

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d5.processing.MV90PayloadHandler
  • 動態參數

動態參數名稱

描述與有效值

usePhysicalChannel

可選值。判斷是否將實體管道 ID 傳遞至初始測量資料匯集器,以建立測量元件識別碼。如果設為「假」,則會使用 MV90 LOGCHAN 欄位。

fieldForDvcIdN

可選值。指定要用來作為裝置 ID 值的欄位。有效值包含:

  • DC_​RECID

  • DC_​CUSTID

  • DC_​METERID (預設)

MV90ScalarChannelSuffix

可選值。保存在為記錄器抄表值建立 scalarIMD 時,要新增至測量元件識別碼的後綴值。預設值為 “_​S”

processMV90ScalarData

可選值。判斷是否處理記錄器抄表值。有效值為「真」與「假」(預設)。

sendStatusAsIs

可選值。判斷狀態代碼是否會在來自前端時傳遞。如果設為「假」或未提供,則為剖析狀態代碼並將狀態類型傳遞至開啟位元之初始測量資料匯集器時的預設現有行為。有效值為「真」與「假」(預設)。

MV90DateFormat

可選值。保存用來剖析提供之日期時間欄位的日期格式。該代碼支援該格式的有限值列表。如果遺漏此參數,或提供的值不符合此列表的值,則使用的格式將會是預設值 MDDYYhhmm。有效值包含:

  • MMDDYYhhmm (預設)

  • MMYYDDhhmm

  • DDMMYYhhmm

  • DDYYMMhhmm

  • YYMMDDhhmm

  • YYDDMMhhmm

MV90IntervalValueDecPlaces

可選值。指定數量值小數點後的位數。如果遺漏此參數,處理邏輯會將小數點後的位數預設為 6。

MV90StrtmtrAndStopmtrToDecimal

可選值。判斷 MV90 STRTMTR (開始抄表計量表) 與 STOPMTR (停止抄表計量表) 是否將轉換為小數。處理邏輯會將這些欄位視為小數,使用該設定來決定需要多少小數點。

usePulseMultiplierAndOffset

可選值。如果設為「真」,則指定脈衝值乘以脈衝乘數。

有效值包含:

  • true

  • false (default)

備註:
此設定僅適用於具有「脈衝」資料類型的 MV90 檔案。

Landis+Gyr 轉接器

承載類型:L+G 用量

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d3.processing.LGUsagePayloadHandler
  • 動態參數:

動態參數名稱

描述與有效值

dateTimeInUTC

指出 Landis+Gyr 系統以 UTC (真) 或裝置的當地時間 (假) 傳送日期/時間資訊。若未提供,預設行為將會是裝置的當地時間。有效值為「真」與「假」(預設)

承載類型:L+G 事件

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d3.processing.LGEventPayloadHandler
  • 動態參數:

動態參數名稱

描述與有效值

dateTimeInUTC

指出 Landis+Gyr 系統以 UTC (真) 或裝置的當地時間 (假) 傳送日期/時間資訊。若未提供,預設行為將會是裝置的當地時間。有效值為「真」與「假」(預設)

承載類型:L+G CIM 事件

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d3.processing.LGCIMEventPayloadHandler
  • 動態參數:N/A

Sensus 轉接器

承載類型:Sensus RNI 用量

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d6.processing.SensusUsagePayloadHandler
  • 動態參數:

動態參數名稱

描述與有效值

dateTimeInUTC

指出 Sensus RNI 系統以 UTC (真) 或裝置的當地時間 (假) 傳送日期/時間資訊。若未提供,預設行為將會是裝置的當地時間。有效值為「真」與「假」(預設)。

useExternalTOU

僅適用於定量用量。

指出處理測量資料時,是否應使用外部參考的使用時間期間。

設為「真」時,Sensus 提供的使用時間期間會作為外部使用時間 "preVEE/externalTOU" 傳遞至初始測量資料匯集器。若未提供或設為「假」,則 Sensus 提供的使用時間期間會作為外部測量元件識別碼 "preVEE/mcIdN" 傳遞至初始測量資料匯集器。有效值為「真」與「假」(預設)。

sendStatusAsIs

判斷狀態代碼是否會在從前端接收時傳遞。設為「真」時,將會傳送從前端接收的狀態代碼。若未提供或設為「假」,來自前端的狀態代碼將會透過位元遮罩處理,產生多個個別的狀態。有效值為「真」與「假」(預設)。

sendIntervalDateTimes

設為真時,區間記錄之初始測量資料匯集器的 "preVEE/msrms/mL/dt" 元素將會植入區間日期/時間,且 "preVEE/enDt" 元素將會植入最後一個區間的區間日期/時間。若未提供或設為「假」,將不會植入區間記錄之初始測量資料匯集器的 "preVEE/msrms/mL/dt" 元素,且"preVEE/enDt" 元素將會植入:開始日期 + 每區間秒數 * 區間數。有效值為「真」與「假」(預設)。

scalarExpanding

可選值。定義要在定量承載中處理的記錄器抄表值數目。定義後,Sensus 承載處理會使用此設定來確保將處理承載中包含的所有定量抄表值。

預設值為 2。

承載類型:Sensus RNI 事件

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d6.processing.SensusEventPayloadHandler
  • 動態參數:

動態參數名稱

描述與有效值

dateTimeInUTC

指出 Sensus RNI 系統以 UTC (真) 或裝置的當地時間 (假) 傳送日期/時間資訊。若未提供,預設行為將會是裝置的當地時間。有效值為「真」與「假」(預設)

Silver Spring Networks 轉接器

承載類型:Silver Spring Networks CSV

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d7.processing.SSNCSVPayloadHandler

承載類型:Silver Spring Networks XML

  • 承載處理常式類別:com.splwg.d1.domain.sgg.d7.processing.SSNXMLPayloadHandler

通用參數

下列參數可供所有支援的前端系統轉接器使用。

動態參數名稱

描述與有效值

suppressPayloadStatistics

選擇性參數。判斷處理承載時,是否不建立 PayloadStatistics 業務物件。如果設為「假」或未提供,則為承載處理開始時建立 PayloadStatistics 業務物件時的預設現有行為。有效值為「真」與「假」(預設)。

suppressPayloadError

選擇性參數。判斷處理承載發生錯誤時,是否不建立 PayloadErrorNotification 業務物件。如果設為「假」或未提供,則為承載處理期間發生的每個錯誤建立 PayloadErrorNotification 業務物件時採取的預設現有行為。如果設為「假」,錯誤描述將會寫入應用程式日誌檔。有效值為「真」與「假」(預設)。

suppressPayloadSummary

選擇性參數。判斷處理承載時,是否不建立 PayloadSummary 業務物件。如果設為「假」或未提供,則在承載處理結束時建立 PayloadSummary 業務物件時採取的預設現有行為。有效值為「真」與「假」(預設)。

createFilePerCommit

選擇性參數。決定將檔案流出至檔案系統或 Object Storage 時,檔案的建立方式。設為 true 時,會在每次確認時寫入所流出檔案。有效值為「真」與「假」(預設)。

commitSizeInKB

選擇性參數。指定在確認裝置事件與初始測量資料匯集器之前,為其配置的記憶體總量 (KB)。匯集器會保留在記憶體中,直到其大小超過為此參數定義的值或達到承載終點為止。

預設值為 100。

備註:設定 chunkSize 參數後,就會忽略此參數 (預設值或指定值)。

chunkSize

選擇性參數。以位元為單位指定在單一批次「執行緒」中處理之承載部分 (區塊) 的大小。

如果設定了該參數,則會忽略 commitSizeInKB 參數。

下列承載格式支援此參數:
  • Landis+Gyr 用量

  • Landis+Gyr 事件

  • MV90 用量

  • Sensus RNI 用量

  • Sensus RNI 事件

  • Silver Spring Networks 用量 (CSV)

  • Adapter Development Kit 用量範例格式 (CSV)

  • 透過使用者出口的 Adapter Development Kit (如果從 getParser 方法傳回的實例實作 com.splwg.d1.domain.sgg.dg.processing.ChunkProcessor 介面)。