メーター管理サービス

この項では、テスト・ハーネス・コンポジットのメーター管理サービスについて説明します。

AddMeters

このWebサービスは、一連のメーターをインメモリー・データ・ストアに追加します。これにより、永久に制御ファイルに追加されることはありません。

入力 - AddMetersInput

部分: ペイロード

要素: AddMetersRequest


パラメータ	摘要
id	メーターのIDコード。
macID	システム内で一意である必要があるMACアドレス。
utility	情報文字列。
serviceType	有効なServiceType値のいずれか(「スキーマ」を参照)。現時点では、Electricが唯一のオプションです。
isCommissioned	メーターがコミッション済状態であるかどうか。
loadActionCode	接続および切断で使用可能なLoadActionCode値のいずれか(「スキーマ」を参照)。
outageEventType	設備ステータス・チェックで使用可能なOutageEventType値のいずれか(「スキーマ」を参照)。
executionStatus	使用可能なExecutionStatesのいずれか(「スキーマ」を参照)。これらの値により、コマンドへのメーターの応答方法が制御されます。
groupName	複数のメーターをセットにリンクする名前。
jobExecutionStatus	使用可能なジョブ実行ステータス値のいずれか(「スキーマ」を参照)。この属性によって、要求されたジョブの実行方法が決まります。
updateIfExisting	メーターがすでに索引に存在する場合に、指定された値でメーターを更新するかどうか。
Comment	メーターの目的を記述する情報文字列。
Channels	このメーターによってサポートされている単位のリスト。
uomCode	チャネルの単位を記述するコード。
uomName	単位の名前が含まれる短い文字列。
decimals	検針時に生成される小数点以下の桁数。
description	単位の詳細な説明。

出力 - AddMetersOutput

部分: ペイロード

要素: AddMetersResult

各メーターが索引に追加されたかどうか。

障害 — 「UtilityFault」を参照してください

RemoveMeter

このWebサービスは、メーターをインメモリー・データ・ストアから削除します。これにより、永久に制御ファイルから削除されることはありません。

入力 - RemoveMeterInput

部分: ペイロード

要素: RemoveMeterRequest


パラメータ	摘要
id	削除するメーターのID

出力 - RemoveMeterOutput

部分: ペイロード

要素: RemoveMeterResult

メーターが索引から追加されたかどうか。

障害 — 「UtilityFault」を参照してください。メーターIDが見つからない場合にスローされます。

AddMeterChannel

このWebサービスは、新しいチャネルを単一のメーターに追加します。

入力 - AddMeterChannelInput

部分: ペイロード

要素: AddMeterChannelRequest


パラメータ	摘要
id	メーターのIDコード。
uomCode	チャネルの単位を記述するコード。
uomName	単位の名前が含まれる短い文字列。
decimals	検針時に生成される小数点以下の桁数。
description	単位の詳細な説明。

出力 - AddMeterChannelOutput

部分: ペイロード

要素: AddMeterChannelResult

チャネルが索引に追加されたかどうか。

障害 — 「UtilityFault」を参照してください。メーターIDが見つからない場合にスローされます。

RemoveMeterChannel

このWebサービスは、チャネルをメーターから削除します。

入力 - RemoveMeterChannelInput

部分: ペイロード

要素: RemoveMeterChannelRequest


パラメータ	摘要
id	削除するメーターのID。
uomCode	チャネルの単位を記述するコード。
uomName	単位の名前が含まれる短い文字列。

これらの3つのパラメータを組み合せて一意のチャネルを特定します

出力 - RemoveMeterChannelOutput

部分: ペイロード

要素: RemoveMeterChannelResult

チャネルがメーターから削除されたかどうか。

障害 — 「UtilityFault」を参照してください。メーターIDが見つからない場合にスローされます。

ReadScalarMeter

このWebサービスは、指定されたメーターの各チャネルのスカラー検針を生成します。

入力 - ReadScalarMeterInput

部分: ペイロード

要素: ReadScalarMeterRequest


パラメータ	摘要
id	検針するメーターのID

出力 - ReadScalarMeterOutput

部分: ペイロード

要素: ReadScalarMeterResult

指定されてメーターのゼロ個以上のスカラー検針。


パラメータ	摘要
uomCode	チャネルの単位を記述するコード。
uomName	単位の名前が含まれる短い文字列。
decimals	検針時に生成される小数点以下の桁数。
description	単位の詳細な説明。
value	スカラー検針を表すランダム番号。