設備イベント
Itron OpenWayは、メーター供給中止アラームなどのリアルタイム・イベントをOracle Utilities Smart Grid Gatewayに送信できます。このようなイベントは、Itronアーキテクチャで例外として参照され、Oracle Utilities Smart Grid Gatewayから明示的に要求する必要なくItron OpenWayによってBPEL ExceptionSubscriberServiceサービスに送信されます。例外は設備イベント・データとしてロードされ、エッジ・アプリケーションに提供されます。
必要な機能は、2つのOSBプロジェクトとして基本製品に付属しています。
-
SGG-D8-EXCEPTION-BASEには、着信データの実際の処理を実行するコンポーネントが含まれます。これは構成時に変更しないでください。このプロジェクトは、SGG-D8-EXCEPTION-CMプロジェクトに追加されたカスタマイズおよび環境設定に影響を与えずにアップグレードできます。
-
SGG-D8-EXCEPTION-CMではカスタマイズが可能で、今後のアップグレードが簡略化されます。
次の表に、EnvironmentSettings.xqファイルに含まれている要素を示します。
要素 |
摘要 |
有効な値 |
---|---|---|
populateRaw |
設備イベント・データが未処理データとして移入されるかどうかを決定します。 |
true false |
callPreProcessing |
前処理プロキシ・サービスがコールされるかどうかを決定します。 |
true false |
callPostProcessing |
後処理プロキシ・サービスがコールされるかどうかを決定します。 |
true false |
destinationRootElement |
設備イベント・シーダーのインバウンドWebサービスの名前を保持します。 |
|
publishServices/service |
外部システム(Oracle DataRakerなど)のデータを公開するために使用される、OSBプロジェクト内のビジネス・サービスの名前を指定します。 |
|
filterEvents |
イベントをフィルタするかどうかを決定します。 |
true false |
イベントの公開
Oracle DataRakerまたは他の外部システムで使用される設備イベントを公開するように、Itron OpenWayアダプタを構成できます。この機能は、OSBコンポーネントおよびBPELコンポジットの組合せによってサポートされます。
設備イベントの公開の有効化
<publishServices>
<service>[publisherBusinessService]</service>
</publishServices>
SGG-D8-EXCEPTION-CM OSBプロジェクトに付属している次のコンポーネントは、Oracle DataRakerへの設備イベント・データの公開に使用されます。
-
DataRakerBusinessServiceビジネス・サービスは、データの公開元となる事前構成されたJMSキュー(エンドポイントURIとして定義)にデータを送信するために使用されます。EnvironmentSettings.xqファイルでこのビジネス・サービスを指定する必要があります。
-
DataRakerServiceAccountサービス・アカウントは、DataRakerBusinessServiceビジネス・サービスで定義されたJMSキューにアクセスするために必要なユーザー名とパスワードを定義および保持するために使用されます。
設備イベントの出力の公開の構成
SGGDRIntegration BPELコンポジットは、Oracle DataRakerまたは他のシステムへのデータの公開を処理します。設備イベント・データは、ネイティブ設備イベント・データ書式(設備イベント・シーダー・ビジネス・オブジェクトの書式)で公開されます。この書式には、正規化された設備イベント・コードが含まれます。この書式の詳細は、『Oracle Utilities Smart Grid Gateway Adapter Development Kit Administrative User Guide』を参照してください。
次のパラメータを使用して、Oracle DataRakerが使用するファイルの転記先ディレクトリ、ファイル当たりのレコード数、ポーリング頻度など、Oracle DataRakerにデータが提供される方法の詳細を構成できます。これらのパラメータはインストール時に定義されます。これらのパラメータ値の定義の詳細は、『Oracle Utilities Smart Grid Gateway Installation Guide』を参照してください。
パラメータ |
摘要 |
デフォルト値 |
---|---|---|
SGG_DR_INT_QUEUE |
SGGペイロードを公開するキューのJNDI名。 これは、DataRakerBusinessServiceビジネス・サービスで定義されたJMSキューです。これは変更できません。 |
DataRakerQueue |
SOA_DR_PUBLISH_SIZE |
公開されたファイルに累積されるレコード数(SGGペイロード)。 |
100 |
SOA_DR_FILE_SIZE |
累積される(SGGペイロード)ファイルの最大ファイル・サイズ(KB)。 |
524288 |
SOA_DR_ELAPSED_TIME |
超過した場合、新規発信ファイルが作成される期間(秒数)。 |
600 |
SOA_DR_POLLING_FREQ |
新規ファイルのステージング・ディレクトリのポーリング頻度(秒数)。 |
60 |
SOA_DR_STAGING_DIR |
累積されたSGGペイロード・ファイルのステージング・ディレクトリのマウント・ポイント/ディレクトリ。 これは内部で使用され、変更できません。 |
/spl/sploutput/staging |
SOA_DR_INTEGRATION_DIR |
Oracle DataRakerが変換されたXMLファイルを使用するマウント・ポイント/ディレクトリ。 |
/spl/sploutput/int |
イベントのフィルタ
<filterEvents>true</filterEvents>
フィルタが有効な場合は、<externalEventName>が「Itron - 設備イベント・マッピング」拡張可能参照(D8-DeviceEventMappingLookup)で定義されている値のいずれかと一致する設備イベントのみがシステムに渡されて処理されます。
優先される設備イベント処理
SGGアダプタは、スマート・メーター・コマンドまたは完了イベント(あるいはその両方)から作成される設備イベントの「実行方法」フラグを「リアルタイム」(D1RT)に設定することで、これらのタイプの設備イベントの処理を優先します。また、「実行方法」フラグが「リアルタイム」に設定されて受信された設備イベントは、バッチ処理によってではなく、リアルタイムで処理されます。詳細は、『Oracle Utilities Meter Data Management/Smart Grid Gateway Business User Guide』の「設備イベントの優先度付け」を参照してください。
ペイロード処理通知の構成
デフォルトでは、「ペイロード統計」、「ペイロード・エラー通知」および「ペイロード要約」通知活動が、Oracle Service Bus内の通知キューに送信されます。適切なOSBプロジェクトでオプションのJCA転送動的プロパティを定義することで、これらの活動の送信を制限するようにSmart Grid Gatewayアダプタを構成できます。次のオプションのJCA転送動的プロパティを使用して、これらの通知活動が送信されるかどうかを制御できます。
- SGG_SEND_STATISTICS: 「ペイロード統計」活動の送信を制御します(true: 送信する、false: 送信しない)
- SGG_SEND_ERROR: 「ペイロード・エラー通知」活動の送信を制御します(true: 送信する、false: 送信しない)
- SGG_SEND_SUMMARY: 「ペイロード要約」活動の送信を制御します(true: 送信する、false: 送信しない)
これらのプロパティがfalseに設定されている場合、対応するペイロード通知がJMSキューに送信されません。これらのプロパティはデフォルトでは設定されず、省略された場合はデフォルトでtrueに設定されることに注意してください。
これらのプロパティを作成する手順は、次のとおりです。
-
Oracle Service Bus ConsoleでSGG-D8-EXCEPTION-CMプロジェクトに移動します。
-
「プロキシ・サービス」フォルダを展開します。
-
「InboundProxyService」プロキシ・サービスを選択します(「パイプライン」または「WSDL」ではなく)。
-
「作成」をクリックして、新しいセッションを作成します。
-
「トランスポートの詳細」を選択します。
-
「動的エンドポイント・プロパティ」セクションで、プラス記号をクリックします。空の行が表示されます。
-
「プロパティ」列に、定義するプロパティを入力します。
-
「値」列にfalseと入力します。
-
定義する各プロパティについて、ステップ6から8を繰り返します。
-
「アクティブ化」をクリックして、変更内容を保存して有効にします。