Oracle® Fusion Middleware

Oracle SOA Suite ヘルスケア統合ユーザーズ・ガイド

11gリリース1 (11.1.1.7)

E59383-01(原本部品番号:E23486-04)

2013年5月

異なる医療システム間の情報をマップおよび伝送するOracle SOA Suite for healthcare integrationアプリケーションの作成方法と構成方法について説明する開発者向けのドキュメントです。このドキュメントではまた、デプロイされたOracle Healthcareアプリケーションのモニターおよび管理方法についても説明します。

Oracle Fusion Middleware Oracle SOA Suiteヘルスケア統合ユーザーズ・ガイド, 11g リリース1 (11.1.1.7)

E59383-01

Copyright © 2013, Oracle and/or its affiliates.All rights reserved.

原本著者: Oracle Corporation

原本協力著者: Oracle Corporation

原本協力者:  Oracle SOA SuiteおよびOracle Healthcareの開発、製品管理および品質保証チーム

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

リリース11.1.1.7用のこのガイドでの新しい情報

1 Oracle SOA Suite for Healthcare Integrationの開始

- 1.1 Oracle SOA Suite for Healthcare Integrationの概要

- 1.1.1 Oracle SOA Suite for Healthcare Integrationのコンポーネント

- 1.1.2 管理およびモニタリング・ツール

- 1.1.3 Oracle SOA Suiteとヘルスケア統合

- 1.1.4 Oracle SOA Suite for Healthcare Integrationのメタデータ

- 1.1.5 セキュリティ

- 1.2 Oracle SOA Suite for Healthcare Integrationの開始に必要な項目

- 1.3 Oracle SOA Suite for Healthcare Integrationへのログイン

- 1.3.1 ポート情報の検索

- 1.4 Oracle SOA Suite for Healthcare Integrationユーザー・インタフェースの使用

- 1.4.1 デザイナ

- 1.4.1.1 ドキュメントの構成

- 1.4.1.2 エンドポイントの構成

- 1.4.1.3 コールアウトの構成

- 1.4.1.4 マップセットの構成

- 1.4.1.5 内部デリバリ・チャネルの構成

- 1.4.1.6 ランタイムおよびユーザー・インタフェースのプロパティの設定

- 1.4.1.7 リポジトリ・データの管理

- 1.4.1.8 アラートと連絡先の構成

- 1.4.2 ダッシュボード

- 1.4.3 レポート

- 1.5 アクセシビリティ・オプション

- 1.5.1 Oracle B2Bでのアクセシビリティ機能の有効化

2 Oracle Healthcareアダプタでの作業

- 2.1 Oracle Healthcareアダプタの概要

- 2.1.1 Healthcare構成ウィザード

- 2.1.2 SOAコンポジットにHealthcareアダプタを追加するとどうなるか

- 2.2 SOAコンポジット・アプリケーションでのHealthcareアダプタの使用方法

- 2.2.1 SOAアプリケーションおよびプロジェクトの作成

- 2.2.2 ヘルスケア統合バインディング・コンポーネントの追加

- 2.2.2.1 デフォルト(ファブリック)統合バインディング・コンポーネントの追加

- 2.2.2.2 JMS統合バインディング・コンポーネントの追加

- 2.2.2.3 Healthcare構成ウィザードのドキュメント定義の処理

- 2.2.3 サービス・コンポーネントの追加

3 ドキュメント・タイプおよびドキュメント・プロトコルの操作

- 3.1 ドキュメント・プロトコルの概要

- 3.1.1 ドキュメント階層に関する注意事項

- 3.2 カスタム・ドキュメント・プロトコルの使用

- 3.2.1 カスタム・ドキュメント・バージョン・パラメータに関する注意事項

- 3.2.2 カスタム・ドキュメント定義パラメータに関する注意事項

- 3.2.2.1 カスタムXMLドキュメントのXPath式の構成方法

- 3.3 HL7ドキュメント・プロトコルの使用

- 3.3.1HL7ドキュメント・バージョン・パラメータに関する注意事項

- 3.3.2 HL7ドキュメント・タイプ・パラメータに関する注意事項

- 3.3.3 HL7ドキュメント定義パラメータに関する注意事項

- 3.3.4 HL7の使用に関する注意事項

- 3.4 ドキュメント定義の作成

- 3.5 ドキュメント定義の削除

4 エンドポイントの操作

- 4.1 エンドポイントの概要

- 4.2 エンドポイントの作成

- 4.2.1 単一方向プロトコルのエンドポイントでのチャネルの構成

- 4.3 エンドポイントとドキュメントの関連付け

- 4.4 MLLPエンドポイントの順序付けの有効化

- 4.5 エンドポイントの削除

- 4.6 「エンドポイント」ウィンドウの操作

5 コールアウトの操作

- 5.1 コールアウトの概要

- 5.1.1 コールアウト・ライブラリJARファイルの作成

- 5.2 コールアウトのタイプ

- 5.2.1 トランスポート・コールアウト

- 5.2.2 ドキュメント・コールアウト

- 5.3 コールアウトの作成

- 5.4 エンドポイントへのコールアウトのインクルード

6 マップセットの操作

- 6.1 マップセットの概要

- 6.1.1 マップセットについて

- 6.1.2 定義済マップセットとカスタム・マップセット

- 6.2 マップ・ファイルの作成

- 6.3 Oracle B2Bコンソールでのマップセットの使用

- 6.3.1 Oracle B2Bコンソールでのマップセットの作成

- 6.3.2 マップセットと取引パートナ・アグリーメントの関連付け

- 6.3.3 Oracle B2Bコンソールでのマップセットの削除

- 6.4 Oracle SOA Suite for Healthcare Integrationでのマップセットの使用方法

- 6.4.1 Healthcare Integrationユーザー・インタフェースでのマップセットの作成

- 6.4.2 マップセットとエンドポイントの関連付け

- 6.4.3 Healthcare Integrationユーザー・インタフェースでのマップセットの削除

7 内部デリバリ・チャネルの操作

- 7.1 内部デリバリ・チャネルの概要

- 7.2 内部デリバリ・チャネルの作成

- 7.3 内部デリバリ・チャネルの有効化

- 7.4 内部デリバリ・チャネルの削除

- 7.5 JMSキューを使用したメッセージの相互関連付け

8 ダッシュボードの使用

- 8.1 ダッシュボードの概要

- 8.2 システム・ダッシュボードの操作

- 8.2.1 システム・ダッシュボードの様々なセクションを使用したシステム・データの表示

- 8.3 ダッシュボードの作成および構成

- 8.3.1 ダッシュボードの作成

- 8.3.2デフォルト・ダッシュボードの選択

- 8.3.3 既存ダッシュボードの構成

- 8.3.4 ダッシュボードのリフレッシュおよび自動リフレッシュ・レートの設定

- 8.3.5 ダッシュボードの削除

- 8.4 ダッシュボードでの情報の表示

- 8.4.1 ダッシュボードでのエンドポイント・サマリー情報の表示

- 8.4.2 ダッシュボードでの詳細なエンドポイント情報の表示

- 8.4.3 ダッシュボードからのエンドポイントの構成

- 8.5 順序付けされたメッセージの使用

- 8.6 エンドポイント・エラー・メッセージの表示

9 レポートの使用

- 9.1 レポートの概要

- 9.1.1 メッセージ・レポート・フィルタ・カスタマイザについて

- 9.1.2 メッセージの再発行の概要

- 9.1.3 クラスタ環境に関する重要な注意点

- 9.2 レポートの作成および構成

- 9.2.1 ビジネス・メッセージ・レポートの作成

- 9.2.2 ワイヤ・メッセージ・レポートの作成

- 9.2.3 アプリケーション・メッセージ・レポートの作成

- 9.2.4 デフォルト・レポートの指定

- 9.2.5 レポートの構成

- 9.2.6 レポートのリフレッシュおよび自動リフレッシュ率の設定

- 9.2.7 レポートの削除

- 9.3 レポートおよびレポートの詳細の表示

- 9.3.1 ビジネス・メッセージ・インスタンスの表示

- 9.3.2 ワイヤ・メッセージの表示

- 9.3.3 アプリケーション・メッセージの表示

- 9.3.4 Oracle Enterprise Managerのフロー・トレースの表示

- 9.3.5 複数のメッセージの概要情報の表示

- 9.4 関連付けられていないメッセージのレポートの作業

- 9.4.1 関連付けられていないワイヤ・メッセージの作業

- 9.4.1.1 関連付けられていないワイヤ・メッセージ・レポートの作成

- 9.4.1.2 関連付けられていないワイヤ・メッセージの表示

- 9.4.2 関連付けられていないアプリケーション・メッセージの作業

- 9.4.2.1 関連付けられていないアプリケーション・メッセージ・レポートの作成

- 9.4.2.2 関連付けられていないアプリケーション・メッセージの表示

- 9.5 エラー・メッセージの作業

- 9.5.1 エラー・メッセージの表示

- 9.5.2 メッセージの再発行

- 9.6 リポジトリからのメッセージのパージ

10 アラートと連絡先の構成

- 10.1 アラートと連絡先の概要

- 10.2 連絡先とアラートの構成

- 10.2.1 SMS通知のためのSMPPドライバのデプロイ

- 10.2.2 ワークフローの通知プロパティの構成

- 10.2.3 Oracle User Messaging Serviceの構成

- 10.2.4 アラートと連絡先の定義

- 10.3 連絡先に割り当てられたアラートの表示

- 10.4 連絡先の削除

- 10.5 送信されたアラートの履歴の表示

11 Healthcareユーザー監査証跡の表示

- 11.1 監査証跡の概要

- 11.1.1 Oracle SOA Suite for Healthcare Integrationの監査オプション

- 11.1.2 監査でのフィルタ条件の使用

- 11.2 ヘルスケア統合監査証跡の構成

- 11.3 ユーザー監査ログの表示

12 リポジトリの管理

- 12.1 Oracle SOA Suite for Healthcare Integrationリポジトリの概要

- 12.1.1 リポジトリのメンテナンス

- 12.1.2 インポートまたはエクスポート・プロセス中に行われる処理

- 12.1.3 エクスポート済ファイルについて

- 12.1.4 パージ・プロセス中に行われる処理

- 12.1.5 管理番号のパージ

- 12.2 設計時リポジトリのインポートおよびエクスポート

- 12.3 リポジトリ・データのパージ

13 システム設定の構成

- 13.1 ランタイム設定の構成

- 13.2 ユーザー・インタフェース設定の構成

14 ユーザーのプロビジョニング

- 14.1 ユーザーの作成

- 14.2 ユーザーの追加

- 14.3 ユーザー・プロビジョニングの編集、表示および削除

- 14.4 ペイロード表示のためのユーザーのプロビジョニング

- 14.5 ユーザー・プロビジョニングの変更を元に戻す

15 Oracle HealthcareにおけるWebサービス・ベースのメッセージ交換の有効化

- 15.1 Webサービスベースのメッセージ交換の概要

- 15.2 カスタムWSDLを使用したSOAPベースのサービス・メッセージの交換

- 15.2.1 SOAPベースのアウトバウンド・メッセージの交換

- 15.2.2 SOAPベースのインバウンド・メッセージの交換

- 15.3 カスタムSOAPヘッダーの送信

- 15.4 リクエストとリプライのサンプル・シナリオ

- 15.4.1 アウトバウンド同期化: コンポジット

- 15.4.2 インバウンド同期化: コンポジット

- 15.4.3 アウトバウンド同期化: JMSキュー

- 15.4.4 インバウンド同期化: JMSキュー

16 Oracle Healthcareコマンド行ツール

- 16.1 コマンド行ツール実行の前提条件

- 16.2 データのパージ

- 16.3 データのインポート

- 16.4 データのエクスポート

- 16.5 バッチ処理操作

- 16.6 メッセージの再発行

- 16.7 エンドポイントの停止時間のスケジューリング

- 16.8 エンドポイントの更新

- 16.9 エンドポイントの削除

A バックエンド・アプリケーション・インタフェース

- A.1 SCAの正規化されたメッセージ・プロパティのマッピング

- A.2 正規化されたメッセージ・プロパティ

B 各種トランスポート・プロトコルを使用したエンドポイントの作成

- B.1 双方向エンドポイントの作成

- B.1.1 MLLP 1.0エンドポイントの作成

- B.1.2 MLLP 2.0エンドポイントの作成

- B.1.3 汎用TCPエンドポイントの作成

- B.1.4 HLLPエンドポイントの作成

- B.2 単一方向エンドポイントの作成

- B.2.1 Fileエンドポイントの作成

- B.2.2 FTPエンドポイントの作成

- B.2.3 JMSエンドポイントの作成

- B.2.3.1 JMSヘッダーからのドキュメント情報の取得

- B.2.4 SFTPエンドポイントの作成

C メッセージ順序付けの管理

- C.1 順序メッセージ管理の概要

- C.2 順序メッセージを管理するためのJavaメソッド

- C.2.1 エンドポイントおよび状態のリスト

- C.2.2 保留中の順序メッセージのリスト

- C.2.3 メッセージの破棄

- C.2.4 メッセージの再処理

- C.2.5 エンドポイントの休止および再開

- C.3 順序メッセージを管理するためのコマンド行ツール

- C.3.1 コマンド行ツールを実行するための前提条件

- C.3.2 エンドポイントおよび状態のリスト

- C.3.3 保留中の順序メッセージのリスト

- C.3.4 メッセージの破棄

- C.3.5 メッセージの再処理

- C.3.6 エンドポイントの休止および再開

D 高可用性でのMLLPの実装

- D.1 Healthcare Integrationの高可用性の概要

- D.1.1 高可用性処理

- D.1.2 フロントエンドのフェイルオーバー

- D.1.3 アクティブの概念

- D.1.4 順序単位(UOO)

- D.1.5 外部依存性

- D.1.6 その他の参考資料

- D.2 Oracle SOA Suite for Healthcare IntegrationでのMLLP高可用性の有効化

E HL7メッセージのバッチ処理

- E.1 HL7メッセージ・バッチ処理の概要

- E.1.1 ファイル・ヘッダー(FHS)によるバッチ処理

- E.1.2 バッチ・ヘッダー(BHS)によるバッチ処理

- E.1.3 メッセージ・ヘッダー(MSH)によるバッチ処理

- E.1.4 バッチ処理時の機能確認の送信

- E.1.5 バッチ処理の標準モード

- E.1.6 バッチ処理のカスタム・モード

- E.1.7 バッチ処理のためのコマンドライン・ツール

F 機能確認999の構成

- F.1 概要

- F.2 機能確認999: ユースケース

- F.2.1 ユースケース1

- F.2.2 ユースケース2

- F.2.3 ユースケース3

G Oracle SOA Suite for Healthcare Integrationの監査リファレンス

- G.1 カスタム監査レポートと標準監査レポートについて

- G.2 Oracle SOA Suite for Healthcare Integrationの監査イベント

索引

はじめに

このガイドでは、Oracle SOA Suite for healthcare integrationの使用方法について説明します。

対象読者

『Oracle Fusion Middleware Oracle SOA Suite Healthcare Integrationユーザーズ・ガイド』は、医療データの交換や、医療統合アプリケーションの設計、デプロイ、監視および管理を必要としている医療組織を対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

Oracleサポート・サービスでは、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

Oracle SOA Suite製品については、次を参照してください。

- Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド

- Oracle Fusion Middleware Oracle SOA Suite開発者ガイド

- Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド

- Oracle Fusion Middleware Oracle SOA Suite and Oracle Business Process Management Suiteインストレーション・ガイド

- Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド

- Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド

Java APIドキュメント(Javadoc)については、次を参照してください。

- Oracle Fusion Middleware B2BコールアウトJava APIリファレンス

- Oracle Fusion Middleware B2Bのインスタンス・メッセージJava APIリファレンス

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

リリース11.1.1.7用のこのガイドでの新しい情報

このガイドはいくつかの点が更新されています。次の表に、追加または変更された項を示します。

既知の問題のリストについては(リリース・ノート)、Oracle SOA製品およびOracle AIA Foundation Packの既知の問題に関するページ(http://www.oracle.com/technetwork/middleware/docs/soa-aiafp-knownissuesindex-364630.html)を参照してください。

項

変更内容

2013年2月

2013年5月

第1章「Oracle SOA Suite for Healthcare Integrationの開始」

バグ修正

X

第4章「エンドポイントの操作」

バグ修正

X

第8章「ダッシュボードの操作」

8.1項「ダッシュボードの概要」

この項は更新され、ダッシュボードを表示する様々なモードが追加されました。

X

8.2項「システム・ダッシュボードの操作」

システム・ダッシュボードの操作に関する項が追加されました。

X

第9章「レポートの使用」

9.1項「レポートの概要」

この項は、Healthcare固有の様々なレポートを説明するために更新されました。

X

9.4項「関連付けられていないメッセージのレポートの作業」

関連付けられていないメッセージについての様々なレポートを説明する項が追加されました。

X

第14章「ユーザーのプロビジョニング」

ユーザー・プロビジョニングの概念を使用してOracle Healthcareで提供される基本的なセキュリティについて説明する章が追加されました。

X

第15章「Oracle HealthcareにおけるWebサービス・ベースのメッセージ交換の有効化」

Oracle HealthcareにおけるWebサービス・ベースのメッセージ交換について説明する章が追加されました。

X

第16章「Oracle Healthcareコマンドライン・ツール」

Oracle Healthcareで提供される様々なコマンドライン・ツールについて説明する章が追加されました。

X

付録G「Oracle SOA Suite for Healthcare Integrationの監査リファレンス」

Oracle Healthcareの監査リファレンスについて説明する付録が追加されました。

X

1 Oracle SOA Suite for Healthcare Integrationの開始

この章では、Oracle SOA Suite for healthcare integrationについて概説します。Oracle SOA Suite for healthcare integrationは、各種医療システムの間でデータを伝送、変換するアプリケーションを作成するためのWebベースのユーザー・インタフェースを提供します。ユーザー・インタフェースでは、これらのシステム間で共有されたメッセージをモニタリングおよび管理する機能も提供されます。

この章には次のトピックが含まれます:

- 1.1項「Oracle SOA Suite for Healthcare Integrationの概要」

- 1.2項「Oracle SOA Suite for Healthcare Integrationの開始に必要な項目」

- 1.3項「Oracle SOA Suite for Healthcare Integrationへのログイン」

- 1.4項「Oracle SOA Suite for Healthcare Integrationユーザー・インタフェースの使用」

- 1.5項「アクセシビリティのオプション」

1.1 Oracle SOA Suite for Healthcare Integrationの概要

Oracle SOA Suite for healthcare integrationはOracle SOA Suiteのいくつかの機能を利用して、医療データを処理するアプリケーションの設計、作成および管理を支援します。Oracle SOA Suite for healthcare integrationには、ヘルスケア統合アプリケーションを作成および構成し、それらのアプリケーションで処理されたメッセージをモニターおよび管理できるWebベースのユーザー・インタフェースが用意されています。また、Oracle Document Editorを使用して、メッセージ構造を定義するドキュメント定義を作成および構成できます。Oracle SOA Suite for healthcare integrationユーザー・インタフェースには、追加のメッセージング・プロトコルのサポート、エンドポイントの作成と管理、ドキュメントの管理、マップセットの作成、Javaコールアウトの作成機能などの追加機能が用意されています。

1.1.1 Oracle SOA Suite for Healthcare Integrationのコンポーネント

ヘルスケア統合アプリケーションには、メッセージの受信、処理および伝送方法を定義するいくつかのコンポーネントがあります。ヘルスケア統合アプリケーションを構成するコンポーネントには、次のものがあります。ドキュメント定義およびエンドポイントは、ヘルスケア統合アプリケーションに必須のコンポーネントです。

- ドキュメント定義: ドキュメント定義を使用して、医療トランザクションで使用されるメッセージの構造を定義します。Oracle Document Editorをインストールした場合は、HL7メッセージ用の定義済テンプレートが提供されます。ドキュメント定義はプロトコル、バージョンおよびタイプによって分類されます。

- エンドポイント: エンドポイントは、これらすべてのコンポーネントを1つの外部システム向けにまとめます。エンドポイントは、Oracle SOA Suite for healthcare integrationによってメッセージが送受信中であるかどうか、トランスポート・プロトコル、確認処理、メッセージが検証または変換されているかどうかを定義します。エンドポイントはドキュメント定義と関連付けられ、オプションで内部デリバリ・チャネル、コールアウト、マップセット、SOA Suiteコンポジット・アプリケーションと関連付けられます。

- マップセット: マップセットを使用して、あるネイティブ・フォーマットから別のフォーマットへのトランスフォーメーションを定義し、XMLへの変換およびXMLからの変換手順を省略します。たとえば、マップセットではHIPAA 4010ドキュメントのフィールドをHIPAA 5010ドキュメントに直接マップできます。マップセットにはマップ元およびマップ先のドキュメント定義と、マッピングを定義するファイルが含まれています。

- コールアウト: コールアウトを使用して、独自のJavaコードをヘルスケア統合アプリケーションに組み込みます。

- 内部デリバリ・チャネル: 内部デリバリ・チャネルは、ヘルスケア統合アプリケーションがJMSトピックまたはキューとの間でメッセージの送受信を行う場合に使用します。

1.1.2 管理およびモニタリング・ツール

ヘルスケア統合アプリケーションを作成し、デプロイした後は、Oracle SOA Suite for healthcare integrationのWebベースのユーザー・インタフェースを通じて、アプリケーションで処理されたメッセージを監視および管理できます。レポート機能を使用して処理されたメッセージのリストを表示し、メッセージ・コンテンツやプロトコル情報などのより深いレベルの詳細を確認できます。また、メッセージの再発行、自動再試行の構成、パートナ停止時間の構成、メタデータ・リポジトリ内のメッセージの選択的なパージを実行できます。

ダッシュボード機能を使用して、実行中の各エンドポイントに送信されたメッセージのサマリーを表示できます。さらに掘り下げて、特定の期間内に送信されたメッセージ、受信されたメッセージ、エラーが発生したメッセージの量を表示することもできます。この情報はさらに、ドキュメント・タイプによって分類できます。様々な条件に基づいて、カスタムのダッシュボードやレポートを作成できます。いくつかのデフォルトのレポートがすでに用意されています。

1.1.3 Oracle SOA Suiteとヘルスケア統合

Oracle SOA Suite for healthcare integrationには、ビジネス・プロセスを医療システムに拡張するSOA機能およびコンポーネントが用意されています。Oracle SOA Suite for healthcare integrationをSOAコンポジット・アプリケーションで使用すると、エンドツーエンドのビジネス・プロセス統合をモデル化できます。

Oracle SOA Suiteには、コンポジット・アプリケーションを設計、デプロイおよび管理するためのサービス・インフラストラクチャ・コンポーネントの完全なセットが用意されています。コンポジット・アプリケーションに含まれる複数のテクノロジ・コンポーネントでは、単一のデプロイおよび管理モデルとツール、エンドツーエンドのセキュリティおよびユニファイド・メタデータ管理などの共通機能が共有されます。

SOAの実装では、Oracle SOA Suite for healthcare integrationはメッセージの送受信を可能にするネットワーク・プロトコルおよびサービスを使用するバインディング・コンポーネントとして機能します。サービス(インバウンド)として、SOAコンポジット・アプリケーションはOracle SOA Suite for healthcare integrationからメッセージを受信します。参照(アウトバウンド)として、SOAコンポジット・アプリケーションはOracle SOA Suite for healthcare integrationにメッセージを渡し、メッセージはそこから外部システムに送信されます。

Oracle SOA Suiteの詳細は、Oracle Fusion Middleware Oracle SOA Suite開発者ガイドを参照してください。

1.1.4 Oracle SOA Suite for Healthcare Integrationのメタデータ

Oracle SOA Suite for healthcare integrationインスタンス・データは、データベースのSOAINFRAスキーマ内で格納および管理されます。設計時および構成用のメタデータは、Oracle Fusion Middlewareで使用できるMetadata Services (MDS)を介して格納および管理されます。MDSの詳細は、Oracle Fusion Middleware管理者ガイドを参照してください。

メタデータ・リポジトリ内のヘルスケア統合データのストレージのため、表領域がいっぱいになる可能性があります。この場合は、表領域のサイズを増やします。大規模な構成をインポートする場合は、再実行ログ・ファイルのサイズを増やすことも、パフォーマンスの向上に役立ちます。大規模なログ・ファイルには、より大きい領域が必要ですが、アプリケーションによる操作の再試行の必要性は減少します。

1.1.5 セキュリティ

Oracle SOA Suite for healthcare integrationのセキュリティはOracle WebLogic Serverによって処理されます。Oracle SOA Suite for healthcare integrationのコンポーネントを表示および変更する必要があるユーザーのユーザー・アカウントをWebLogic Serverで作成し、Oracle SOA Suite for healthcare integrationコンソールを使用してそれらのアカウントをプロビジョニングできます。healthcare integrationユーザー・インタフェースで編集を行うには、Oracle SOA Suite for healthcare integrationで管理者ロールまたは監視ロールが付与されている必要があります。

1.2 Oracle SOA Suite for Healthcare Integrationの開始に必要な項目

Oracle SOA Suiteをインストールしたら、Oracle SOA Suite for healthcare integrationを使用する前に、次に示すインストール後のタスクを実行する必要があります。

1. コマンド・プロンプトを開き、次の環境変数を設定します。

setenv ANT_HOME <Middleware_HOME>/modules/org.apache.ant_1.7.1/
setenv PATH=$ANT_HOME/bin:$PATH
setenv JAVA_HOME <Middleware_HOME>/<jrockit_install_directory>
setenv PATH=$JAVA_HOME/bin:$PATH

2. Oracle Technology Network (OTN)またはeDeliveryから、次のものを含むHealthcareライブラリ(ofm_healthcare_lib_generic_11.1.1.7.0_disk1_1of1.zip)をダウンロードします。

- StdMultiSetupInstOracle.exe (Windows用)

- StdMultiSetupInstOracle.tar.gz (その他のオペレーティング・システム用)

オペレーティング・システムに応じて、次の場所にライブラリをコピーします

<Middleware_HOME>/<SOA_HOME>/soa/thirdparty/healthcare/stdlibrary/

3. コマンド・プロンプトで、次のコマンドを実行します。

cd <Middleware_HOME>/<SOA_HOME>/bin
ant -f ant-soahc-postinstall.xml

4. antコマンドで要求された場合には、次の詳細を入力して、インストール後のプロセスを完了します。

- Weblogic Serverのユーザー名(デフォルトはweblogic)

- Weblogic Serverのパスワード

- Weblogic Serverのホスト名(デフォルトはlocalhost)

- 管理サーバーのポート(デフォルトは7001)

- 管理対象サーバーのポート(デフォルトは8001)

- 管理サーバー名(デフォルトはAdminServer)

- Weblogic Serverのデプロイ・ターゲット(デフォルトはsoa_server1)

- Weblogic Serverのプラットフォーム(デフォルトはlinux64)

- データベース・タイプ(デフォルトはoracle)

- データベースのURL

- SOAスキーマ・ユーザー名

- SOAスキーマ・パスワード

5. 管理サーバーと管理対象サーバーの両方を再起動します。

インストール後のタスクの実行に加えて、次のものもインストールする必要があります。

- Oracle Document Editor

- Oracle JDeveloper

Oracle Document Editorの規格に基づいたテンプレートを使用して、ガイドライン・ファイルを作成します。次に、Oracle JDeveloperでHealthcareアダプタのバインディング・コンポーネントを使用して、図1-1に示すように、Healthcareコンポジットを作成してデプロイします。

図1-1 Oracle JDeveloper: SOAコンポジット・アプリケーションとHealthcareバインディング・コンポーネント

詳細は、次を参照してください:

- Oracle SOA Suiteの一部としてのOracle SOA Suite for healthcare integrationのインストールについては、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド

- Oracle Document Editorの「ヘルプ」・メニュー

- Oracle JDeveloperの「ヘルプ」メニュー

- 第2章「Oracle Healthcare Adapterでの作業」

1.3 Oracle SOA Suite for Healthcare Integrationへのログイン

以下の手順は、Oracle SOA Suite for healthcare integrationを含むOracle SOA Suiteがインストールされていることを前提としています。詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイドを参照してください。

サポートされている次のWebブラウザを使用できます。

- Mozilla Firefox 2.0、3.0および3.5以降

- Apple Safari 3.2、4.0および5.0

- Google Chrome 1.0以降

- Microsoft Internet Explorer 8および9(互換性ビューはオフ)

Oracle SOA Suite for healthcare integrationにログオンするには:

1. サポートされているWebブラウザを開き、次の場所にアクセスします。

http://host_name:port_number/healthcare

ここで

- host_nameは、Oracle SOA Suiteがインストールされているホストの名前です。(クラスタ環境では、host_nameがフロントエンドのロード・バランサである場合があります)

- port_numberは、管理対象サーバーによる通常のHTTP(非SSL)またはHTTPS(SSL)接続のリスニングに使用されるポート番号です。(クラスタ環境では、port_numberはルーター・ポートになります。)
詳細は、1.3.1項「ポート情報の検索」を参照してください。

- /healthcareはヘルスケア統合ユーザー・インタフェースにアクセスします。

2. ログイン・ページで、次の情報を入力します。

フィールド名

指定する情報

ユーザー名

デフォルトの管理者ユーザー名を入力します。

パスワード

Oracle Fusion Middleware 11gインストールの管理者パスワードを使用します。

3. 「ログイン」をクリックします。

1.3.1 ポート情報の検索

ポート番号は次の方法で確認できます。

- Oracle Weblogic Server管理コンソールから:

1. コンソールにログオンします。

2. 「ドメイン構造」ペインで、図1-2に示すように、「環境」を開いて「サーバー」をクリックします。

図1-2 Oracle WebLogic Server管理コンソールのドメイン構造ノード

3. サーバーの「リスニング・ポート」列を書き留めます。

- MW_HOME/user_projects/domains/your_domain_name/config/config.xmlから

<server>
<name>soa_server1</name>
<ssl>
<name>soa_server1</name>
<listen-port>8002</listen-port>
</ssl>
<machine>LocalMachine</machine>
<listen-port>8001</listen-port>
<listen-address/>
</server>

1.4 Oracle SOA Suite for Healthcare Integrationユーザー・インタフェースの使用

Healthcareアクティビティは次のようにグループ化されています。

- デザイナ

- ダッシュボード

- レポート

1.4.1 デザイナ

「デザイナ」タブの「構成」サブタブを使用して(図1-3を参照)、ドキュメント・プロトコル、エンドポイント、コールアウト、マップセットを構成し、「管理」サブタブを使用して、ランタイムおよびユーザー・インタフェース設定や内部デリバリ・チャネル設定の変更、メタデータのインポート、エクスポートおよびパージを行います。

図1-3 「デザイナ」タブ

1.4.1.1 ドキュメントの構成

「構成」タブの「ドキュメント・プロトコル」フォルダを使用して、ドキュメント・プロトコル、ドキュメント・プロトコル・バージョン、ドキュメント・タイプおよびドキュメント定義を作成、変更、削除できます(図1-4を参照)。これらのドキュメント定義は、後からエンドポイントに関連付けることができます。

図1-4 「ドキュメント・プロトコル」フォルダ

注意:

Oracle Document Editorでドキュメントを作成するか、「管理」タブのインポート/エクスポート機能を使用して、すでに作成されたドキュメント定義を含むシード済のエクスポートzipファイルを使用できます。

ドキュメントおよびドキュメント・プロトコルの詳細は、第3章「ドキュメント・タイプおよびドキュメント・プロトコルの操作」を参照してください。

1.4.1.2 エンドポイントの構成

エンドポイントとは、メッセージの送受信が行われる場所です。URL、フォルダ、パスなどをエンドポイントにすることができます。「構成」タブの「エンドポイント」フォルダを使用して、エンドポイントの作成、変更、削除およびドキュメント定義にエンドポイントの関連付けを行うことができます。

図1-5は、エンドポイントの例を示しています。

図1-5 エンドポイントの例

エンドポイントの詳細は、第4章「エンドポイントの操作」を参照してください。

1.4.1.3 コールアウトの構成

コールアウトは、メッセージ処理をカスタマイズするために使用します。たとえば、コールアウトを使用してメッセージを更新したり、リモート・エンドポイントのメッセージ形式を別の形式に変換できます。「構成」タブの「コールアウト」フォルダを使用して、コールアウトを作成、変更または削除できます。

図1-6は、コールアウトの例を示しています。

図1-6 コールアウトの例

コールアウトの詳細は、第5章「コールアウトの操作」を参照してください。

1.4.1.4 マップセットの構成

マップセットを使用すると、あるネイティブ・データ形式を別のネイティブ形式に直接変換できます。「構成」タブの「マップセット」フォルダを使用して、マップセットを作成、変更または削除できます。

図1-7は、マップセットの例を示しています。

図1-7 マップセットの例

マップセットの詳細は、第6章「マップセットの操作」を参照してください。

1.4.1.5 内部デリバリ・チャネルの構成

内部デリバリ・チャネルは、内部の医療システムでのメッセージの使用を可能にするためのOracle SOA Suite for healthcare integrationからJMSトピックまたはキューへのメッセージの配信方法または外部システムからトピックまたはキューに送信されたメッセージのOracle SOA Suite for healthcare integrationへの配信方法を定義します。接続情報やトランスポート・プロトコルなどが定義されます。「管理」タブの「内部デリバリ・チャネル」を使用して、内部デリバリ・チャネルを作成および構成できます。

図1-8は、内部デリバリ・チャネルの例を示しています。

図1-8 内部デリバリ・チャネルの例

内部デリバリ・チャネルの詳細は、第7章「内部デリバリ・チャネルの操作」を参照してください。

1.4.1.6 ランタイムおよびユーザー・インタフェースのプロパティの設定

Oracle SOA Suite for healthcare integrationでは、ランタイムおよびユーザー・インタフェースのプロパティを変更できます。「管理」タブの「設定」フォルダにある「ランタイム」アイコンと「UI」アイコンを使用して、これらのプロパティを変更できます。

- ランタイム設定: 「ランタイム」アイコンをダブルクリックしてランタイム設定ページを開き、機能確認、大規模なペイロード、コールアウト・ディレクトリ名、ディスパッチャ数に関連するランタイム・パラメータを変更できます。
図1-9は、ランタイム設定ページを示しています。

図1-9 ランタイム設定ページ

- ユーザー・インタフェース設定: 「UI」アイコンをクリックしてユーザー・インタフェース設定ページを開き、次の項目を指定できます。

- 時間スライダ期間: ダッシュボード・サマリー・ページの「時間範囲」で選択できるようにするため、最大9つの時間スライダ期間を選択できます。

- 「ダッシュボード・サマリー」設定: ダッシュボードの統計情報を表示する履歴の時間範囲、エンドポイント・ステータス・グリッドに使用する列数、ダッシュボード・サマリー・ビューの自動リフレッシュ間隔(秒単位)を指定できます。

- 「エンドポイント」設定: ドキュメント・タイプ統計情報の表示形式(ゲージまたは表)、ゲージ・グリッドで使用する列数、ダッシュボードのエンドポイント詳細ビューの自動リフレッシュ間隔(秒単位)を指定できます。

- 「レポート」設定: レポートの自動リフレッシュ間隔(秒単位)、レポート結果表に表示される1ページ当たりの行数、メッセージ・ペイロードの表示を指定できます。

図1-10は、ユーザー・インタフェース設定ページの例を示しています。

図1-10 ユーザー・インタフェース設定ページ

ランタイムおよびユーザー・インタフェース設定の詳細は、第13章「システム設定の構成」を参照してください。

1.4.1.7 リポジトリ・データの管理

リポジトリ管理ページでは、Oracle SOA Suite for healthcare integrationリポジトリ・データのエクスポートや、その他のエクスポート済ファイル(ドキュメント定義、マップセットまたはその他のhealthcare関連リポジトリ・データなど)のインポートを行うことができます。設計時および実行時のメタデータもパージできます。

図1-11 リポジトリ管理ページ

Oracle SOA Suite for healthcare integrationリポジトリの管理の詳細は、第12章「リポジトリの管理」を参照してください。

1.4.1.8 アラートと連絡先の構成

アラートと連絡先ページでは、連絡先のリストを定義し、各連絡先に通知する必要があるイベントを関連付けることができます。実行時や設計時の様々なイベントに対しアラートを送信できます。

図1-12 アラートと連絡先ページ

アラートおよび連絡先の管理の詳細は、第10章「アラートと連絡先の構成」を参照してください。

1.4.2 ダッシュボード

「ダッシュボード」タブをクリックすると、ダッシュボード・ページが表示されます。ダッシュボード・ページを初めて開くと、次のオプションが表示されます(図1-13を参照)。

- タブが選択されたら表示するデフォルトのダッシュボードを設定: ダッシュボード・ページを開いたときにデフォルトで表示されるダッシュボードの名前を指定します

- 既存のダッシュボードを開くまたは編集: 使用可能なダッシュボードを開くか編集します

- ダッシュボードの作成: 新しいダッシュボードを作成します

- 既存のダッシュボードの削除: ダッシュボードを削除します

図1-13 ダッシュボード・ページ

その後ダッシュボード・ページにアクセスすると、前に指定したデフォルトのダッシュボード・ページが表示されます。このページには、特定のダッシュボードに関連付けられたすべてのエンドポイントが表示されます。このページではまた、エンドポイントの状態、エンドポイントが表示される列数、ダッシュボードの自動リフレッシュ間隔に関係なく、すべてのエンドポイントを表示するかどうかを指定できます。ページにあるダッシュボード・エディタ・ボタンを使用して、ダッシュボード名を変更したり、使用可能なエンドポイントのリストからダッシュボードに必要なエンドポイントを選択できます。

各エンドポイントには、エンドポイントのプロパティを表示したり、エンドポイントを構成するためのオプションがあります。特定のエンドポイントの情報アイコンにマウス・カーソルを合せると、エンドポイントのプロパティが表示されます。情報アイコンの横にある「このエンドポイントの構成」アイコンをクリックすると、関連するエンドポイントの編集ページにリダイレクトされます。

エンドポイント・ウィンドウの右上隅のアイコンをクリックして、詳細を表示できます。

図1-14は、ダッシュボード・ページの例を示しています。

図1-14 ダッシュボードの例

ダッシュボードの詳細は、第8章「ダッシュボードの操作」を参照してください。

1.4.3 レポート

「レポート」タブをクリックすると、レポート・ページが表示されます。レポート・ページには、すべてのエンドポイントに関連する、すべての異なるタイプのインバウンド・メッセージとアウトバンド・メッセージ(ワイヤ、ビジネスおよびアプリケーション)が表示されます。また、このページでは次のことを実行できます。

- 使用可能なメッセージ全体を移動する

- 1ページ当たりに表示されるメッセージ数を指定する

- メッセージ・フィルタ・エディタを開いてビジネス・メッセージ・レポート・フィルタを作成する

- 自動リフレッシュ間隔を指定する

リストのメッセージをクリックすると、下のペインに選択したメッセージのすべての異なるメッセージ・タイプ(ワイヤ・メッセージ、ビジネス・メッセージ、アプリケーション・メッセージ)が表示されます。各メッセージ・タイプをクリックすると、詳細が表示されます。

図1-15は、メッセージ・リスト、メッセージ・タイプの詳細、ビジネス・メッセージ・レポート・エディタが表示されたレポートの例を示しています。

図1-15 レポートの例

レポートの詳細は、第9章「レポートの作業」を参照してください。

1.5 アクセシビリティのオプション

この項では、Oracle B2Bで使用可能なアクセシビリティのオプションについて説明します。

1.5.1 Oracle B2Bでのアクセシビリティ機能の有効化

Oracle B2Bには、スクリーン・リーダーでアプリケーションのすべてのコンポーネントにアクセスし、これらを読み取れるようにするスクリーン・リーダー・オプションがあります。

スクリーン・リーダーを有効にするには:

1. 右上隅の「スクリーン・リーダー・モードの有効化」リンクをクリックします。

2. 次に示す確認のメッセージが表示されます: これにより、現行セッションのスクリーン・リーダー・モードが有効化されます。続行しますか。

3. 「はい」をクリックして確定します。

2 Oracle Healthcareアダプタでの作業

この章では、Oracle SOA Suiteコンポジットでヘルスケア統合コンポーネントの使用を可能にするOracle Healthcareアダプタについて説明します。このアダプタは、Oracle JDeveloper環境で使用されます。

この章には次のトピックが含まれます:

- 2.1項「Oracle Healthcareアダプタの概要」

- 2.2項「SOAコンポジット・アプリケーションでのHealthcareアダプタの使用方法」

2.1 Oracle Healthcareアダプタの概要

Oracle Healthcare Adapterではhealthcare integrationバインディング・コンポーネントをSOAコンポジット・アプリケーションに追加して、登録アプリケーションで生成された管理情報のラボラトリ・システムへの送信など、エンドツーエンドのプロセスを作成できます。Healthcare Adapterでは、SOAコンポジット・アプリケーションと外部のHealthcareアプリケーションとの間で送信されるドキュメントのタイプを定めます。お使いのコンポジット・アプリケーションでは、BPELプロセス、Oracle Mediatorコンポーネント、各種のアダプタなど、その他のSOA Suiteも使用できます。

2.1.1 Healthcare構成ウィザード

コンポジットにHealthcare Adapterを追加すると、Oracle JDeveloperでHealthcare構成ウィザードが起動します。このウィザードでは、次のようにSOAコンポジット・アプリケーションでhealthcare integrationバインディング・コンポーネントを作成および構成できます。

- このコンポーネントは、外部システムからのメッセージを受信してSOAコンポジット・アプリケーションに送信するためのサービス(インバウンド)として使用されます。Oracle SOA Suite for healthcare integrationはSOAコンポジット・アプリケーションのエントリ・ポイントです。

- このコンポーネントは、SOAコンポジット・アプリケーションからのメッセージを外部アプリケーションに送信するための参照(アウトバウンド)として使用されます。

Healthcare構成ウィザードの手順に従っていくと、Oracle SOA Suite for healthcare integrationで作成されたドキュメント定義などのコンポーネントを選択するよう求められます。まだ適切なドキュメント定義がない場合は、ウィザードからOracle SOA Suite for healthcare integrationを起動してドキュメント定義を作成することもできます。

注意:

ミドルウェア(ヘルスケア統合Webサービス)でSSLが有効になっている場合、Healthcare構成ウィザードでSSLポートが検出され、SSL接続を使用してドキュメント定義が取得されます。

2.1.2 SOAコンポジットにHealthcareアダプタを追加するとどうなるか

Healthcare構成ウィザードが完了すると、新しいhealthcare integrationサービスまたは参照がコンポジット・アプリケーションに追加され、対応するWSDLファイルが生成されます。WSDLファイルでは、スキーマ、メッセージ、ドキュメント定義、WebLogic Managed Server、アプリケーション・サーバーへの接続が定義されます。サービスまたは参照をOracle BPELプロセスまたはOracle Mediatorコンポーネントに接続すると、Oracle BPELプロセスまたはOracle Mediatorコンポーネントでhealthcare integrationの正規化されたメッセージ・プロパティを使用できるようになるため、エンドポイント、メッセージ・タイプ、メッセージID、ドキュメント・タイプ、プロトコルなどを指定してHealthcareアプリケーションを詳細に構成できます。

注意:

コンポジット・アプリケーションをヘルスケア統合エンドポイントに接続するには、ヘルスケア・アダプタがサービスとして定義されている場合はhc.fromEndpoint正規化されたメッセージ・プロパティの値を指定する必要があり、ヘルスケア・アダプタが参照として定義されている場合は、hc.toEndpoint正規化されたメッセージ・プロパティの値を指定する必要があります。

2.2 SOAコンポジット・アプリケーションでのHealthcareアダプタの使用方法

HealthcareアダプタでSOAコンポジット・アプリケーションを作成するには、指定された順序で次の手順を実行します。

- ヘルスケア統合エンドポイントを作成して有効化します(第4章「エンドポイントの操作」を参照)。

- 2.2.1項「SOAアプリケーションおよびプロジェクトの作成」

- 2.2.3項「サービス・コンポーネントの追加」

- 2.2.2項「ヘルスケア統合バインディング・コンポーネントの追加」

2.2.1 SOAアプリケーションおよびプロジェクトの作成

Healthcare Adapterを使用してhealthcare integrationバインディング・コンポーネントを既存のJDeveloperプロジェクトに追加し、SOA Suiteと外部のHealthcareシステムとの通信を有効にできます。まず、アプリケーションとプロジェクトを作成する必要があります。

SOAコンポジット・アプリケーションの作成の詳細は、Oracle Fusion Middleware Oracle SOA Suite開発者ガイドを参照してください。

始める前に

アプリケーションとプロジェクトを作成する前に、次のガイドラインを確認してください。

- アプリケーション名にスペースを使用しないでください。

- 空白があるディレクトリ・パスにアプリケーションおよびプロジェクトを作成することはできません(例: c:\Program Files)。

- UNIXオペレーティング・システムでは、環境変数LANGおよびLC_AllをUTF-8キャラクタ・セットを備えたロケールに設定して、Unicodeサポートを有効にすることをお薦めします。これにより、Unicodeのすべての文字が処理できるようになります。SOAテクノロジはUnicodeに基づいています。オペレーティング・システムがUTF-8以外のエンコーディングを使用するように構成されている場合は、SOAコンポーネントが想定とは異なって機能する可能性があります。
Oracle JDeveloper設計時環境でUnicodeサポートを有効にするには、「ツール」→「プリファレンス」→「環境」→「エンコーディング」→「UTF-8」を選択します。この設定は、実行時の環境にも適用可能です。

- コンポジット名およびコンポーネント名は、500文字以下にする必要があります。

- 同じインフラストラクチャにデプロイされるプロジェクトは、すべてのSOAコンポジット・アプリケーション全体で一意の名前である必要があります。コンポジットの一意性はプロジェクト名で判断されます。たとえば、Project1というプロジェクトを2つの異なるアプリケーションで作成しないでください。デプロイ時に、2番目にデプロイされたプロジェクト(コンポジット)で最初にデプロイされたプロジェクト(コンポジット)が上書きされます。

SOAアプリケーションおよびプロジェクトを作成するには

1. Oracle JDeveloper Studio Editionを起動します。

注意:

Oracle JDeveloperを初めて起動している場合は、Java JDKの場所を指定します。

2. 表2-1の説明に従って、SOAコンポジット・アプリケーションを作成します。

表2-1 SOAコンポジット・アプリケーションの作成

Oracle JDeveloperの状態

操作

アプリケーションがない

例: Oracle JDeveloperを初めて開いている場合。

左上部のアプリケーション・ナビゲータで、「新規アプリケーション」をクリックします。

既存のアプリケーションがある

「ファイル」メイン・メニューまたは「アプリケーション」メニューを使用します。

1. 「新規」→「アプリケーション」を選択します。
別のアプリケーション・コンポジットの作成を選択できる「新規ギャラリ」が開きます。

2. 「カテゴリ」ツリーの「一般」ノードで「アプリケーション」を選択します。「アイテム」ペインで「SOAアプリケーション」を選択し、「OK」をクリックします。

SOAアプリケーションの作成ウィザードが表示されます。

3. アプリケーション・ページの「名前」では、必要に応じてプロジェクトの名前および場所を変更できます。このアプリケーションが最初のアプリケーションである場合は、「アプリケーション・テンプレート」から「SOAアプリケーション」を選択します。パッケージ接頭辞のデフォルトをそのまま使用して、「次」をクリックします。

4. プロジェクト・ページの「名前」では、必要に応じてSOAプロジェクトの名前および場所を変更できます。デフォルトでは、SOAプロジェクト・テクノロジ、生成されるcomposite.xmlおよび必要なライブラリは、Oracle JDeveloperによりモデル・プロジェクトに追加されます。「次」をクリックします。
SOAアプリケーションの作成ウィザードのプロジェクトSOA設定ページが表示されます。

5. SOA設定の構成ページで、「空のコンポジット」をクリックし、「終了」をクリックします。

6. 「ファイル」メイン・メニューから「すべて保存」を選択します。

2.2.2 ヘルスケア統合バインディング・コンポーネントの追加

ヘルスケア統合バインディング・コンポーネントを公開サービス(インバウンド)または外部参照(アウトバウンド)として追加して、ヘルスケア・システムへの接続を定義できます。

Oracle Healthcareでは、Healthcareアダプタとの次の統合がサポートされています。

- 2.2.2.1項「デフォルト(ファブリック)統合バインディング・コンポーネントの追加」

- 2.2.2.2項「JMS統合バインディング・コンポーネントの追加」

2.2.2.1 デフォルト(ファブリック)統合バインディング・コンポーネントの追加

Healthcare構成ウィザードを使用して、ファブリック統合バインディング・コンポーネントを追加できます。

始める前に:

Oracle SOAプロジェクトにhealthcare integrationバインディング・コンポーネントを追加する前に、healthcare integrationユーザー・インタフェースで必要なコンポーネントが作成されていることを確認します。たとえば、プロジェクトで使用するドキュメント定義やエンドポイントが作成および構成されていることを確認します。

ファブリック・ヘルスケア統合バインディング・コンポーネントを追加するには

1. コンポーネント・パレットで、「SOA」を選択します。

2. 「サービス・アダプタ」にスクロールして「Healthcareアダプタ」を「公開されたサービス」または「外部参照」スイム・レーンにドラッグします。

- インバウンド・メッセージを受信するには、アダプタを「公開されたサービス」にドラッグします。

- アウトバウンド・メッセージを送信するには、アダプタを「外部参照」にドラッグします。

Healthcare構成ウィザードが表示されます。

3. Healthcare構成ウィザードのようこそページで、「次」をクリックします。
サービス名ページが表示されます。

4. 図2-1に示すように、Healthcareサービスの名前を入力して「次」をクリックします。

図2-1 Healthcare構成ウィザード - サービス名ページ

Healthcare統合型ページが表示されます。

5. 図2-2に示すように、「デフォルト」を選択して「次」をクリックします。

図2-2 Healthcare構成ウィザード - Healthcare統合型ページ

アプリケーション・サーバー接続ページが表示されます。

6. 次のいずれかを行います:

- 「アプリケーション・サーバー接続」リストからアプリケーション・サーバー接続を選択し、「次」をクリックします。

- 「新規」をクリックして、アプリケーション・サーバー接続を作成します。アプリケーション・サーバー接続の作成ウィザードに従ってください。

接続が確立されると、図2-3に示すようにユーザー名とホスト名がSOAサーバー名とともに表示されます。

図2-3 Healthcare構成ウィザード - アプリケーション・サーバー接続ページ

7. アプリケーション・サーバーへの接続を確認するには、「Healthcareのテスト」をクリックしてから表示されたダイアログで「OK」をクリックします。

8. 「次」をクリックします。
図2-4に示すように操作ページが表示されます。

図2-4 Healthcare構成ウィザード - 操作ページ

9. アウトバウンド・メッセージの場合は「送信」、インバウンド・メッセージの場合は「受信」を選択します。

10. 「次」をクリックします。
ドキュメント定義の処理ページが表示されます。

11. (Oracle SOA Suite for healthcare integrationからスキーマをインポートするための)デフォルトをそのまま使用するか、表2-3および図2-5に示すように「詳細」タブでいずれかのオプションを選択します。

図2-5 Healthcare構成ウィザード - ドキュメント定義の処理ページ

12. 「次」をクリックします。
ドキュメント定義ページが表示されます。

13. 図2-6に示すように、ツリーを展開してドキュメント定義を選択します。

図2-6 Healthcare構成ウィザード - ドキュメント定義ページ

表2-2でページのその他のオプションについて説明します。

表2-2 ドキュメント定義ページのオプション

オプション

説明

検索

空白のフィールドに定義名を入力し、「検索」アイコンをクリックします。定義名の先頭部分を入力すると、部分的な文字列が照合されます。部分的な文字列にはワイルドカードを使用できません。

リフレッシュ

ヘルスケア統合サーバーからドキュメント定義リストを取得します。検索終了後は、すべてのドキュメント定義が表示されるようにリフレッシュします。

Healthcare構成

アプリケーション・サーバー接続ページで指定された接続を使用し、ブラウザを開いてOracle SOA Suite for healthcare integrationユーザー・インタフェースに接続します。ヘルスケア統合ユーザー・インタフェースでは、ドキュメント定義を作成またはインポートできます。これらの手順を終了したら、このダイアログに戻って「リフレッシュ」をクリックし、新しいドキュメント定義を選択します。

14. 「次」をクリックします。

15. 複数のルート要素があるドキュメント定義を選択した場合は、ルート要素ページが表示されます。使用するルート要素を選択して「OK」をクリックします。

16. 「次」をクリックし、「終了」をクリックします。

2.2.2.2 JMS統合バインディング・コンポーネントの追加

Healthcare構成ウィザードを使用して、ファブリック統合バインディング・コンポーネントを追加できます。

始める前に:

Oracle SOAプロジェクトにhealthcare integrationバインディング・コンポーネントを追加する前に、healthcare integrationユーザー・インタフェースで必要なコンポーネントが作成されていることを確認します。たとえば、プロジェクトで使用するドキュメント定義やエンドポイントが作成および構成されていることを確認します。

JMS ヘルスケア統合バインディング・コンポーネントを追加するには

1. 2.2.2.1項「デフォルト(ファブリック)統合バインディング・コンポーネントの追加」の手順1から3を繰り返します。

2. 「サービス・アダプタ」にスクロールして「Healthcareアダプタ」を「公開されたサービス」または「外部参照」スイム・レーンにドラッグします。

- インバウンド・メッセージを受信するには、アダプタを「公開されたサービス」にドラッグします。

- アウトバウンド・メッセージを送信するには、アダプタを「外部参照」にドラッグします。

Healthcare構成ウィザードが表示されます。

3. Healthcare構成ウィザードのようこそページで、「次」をクリックします。
サービス名ページが表示されます。

4. 図2-7に示すように、Healthcareサービスの名前を入力して(インバウンド・メッセージを受信するにはsay hcfp_Inbound)「次」をクリックします。

図2-7 Healthcare構成ウィザード - サービス名ページ

Healthcare統合型ページが表示されます。

5. 図2-2に示すように、「JMS」を選択して「次」をクリックします。

図2-8 Healthcare構成ウィザード - Healthcare統合型ページ

アプリケーション・サーバー接続ページが表示されます。

6. 2.2.2.1項「デフォルト(ファブリック)統合バインディング・コンポーネントの追加」の手順6から8を繰り返します。

7. 操作ページで、アウトバウンド・メッセージの場合は「送信」、インバウンド・メッセージの場合は「受信」を選択します。この場合、図2-9に示すように「受信」を選択します。

図2-9 Healthcare構成ウィザード - 操作ページ

8. 「次」をクリックします。
ドキュメント定義の処理ページが表示されます。

9. 2.2.2.1項「デフォルト(ファブリック)統合バインディング・コンポーネントの追加」の手順11から16を繰り返します。

10. JMSプロバイダ・ページで図2-10に示すように、Oracle Enterprise Messaging Service (OEMS)リストから「Oracle Weblogic JMS」を選択して「次」をクリックします。

図2-10 Healthcare構成ウィザード - JMSプロバイダ・ページ

サービス接続ページが表示されます。

11. AppServer接続リストからアプリケーション・サーバー接続を選択して、(またはプラス・アイコンをクリックし、アプリケーション・サーバー接続の作成ウィザードを使用して接続を作成して)「次」をクリックします。
消費操作のパラメータ・ページが表示されます。

12. 「参照」ボタンをクリックして「宛先の選択」ダイアログを表示します。

13. リストから必要な宛先名を選択します。この場合、jms/b2b/B2B_IN_QUEUE (インバウンド・メッセージを受信するには)を選択して「OK」をクリックし、消費操作のパラメータ・ページに戻ります。「JNDI名」フィールドにはすでに移入されています。

14. 図2-11に示すように「次」をクリックします。

図2-11 Healthcare構成ウィザード - 消費操作ページ

注意:

操作ページで「受信」を選択した場合、消費操作が事前に選択されて消費操作のパラメータ・ページが表示されます。

同様に、操作ページで「送信」を選択した場合、発行操作が事前に選択されて発行操作のパラメータ・ページが表示されます。送信操作の場合、次の図に示すように、宛先B2B_OUT_QUEUEを選択する必要があります。

15. 「次」をクリックし、「終了」をクリックします。

2.2.2.3 Healthcare構成ウィザードのドキュメント定義の処理

Healthcare構成ウィザードでは、Oracle SOA Suite for healthcare integrationのドキュメント定義を作成中のアダプタに関連付けることができます。ドキュメント定義をコンポジットに関連付ける方法および検証にスキーマ定義(XSD)ファイルが必要かどうかを指定できます。表2-3で、ドキュメント定義を処理するためのオプションについて説明します。

表2-3 ドキュメント定義の処理の高度なオプション

オプション

説明

Healthcareからスキーマをインポート

Oracle SOA Suite for healthcare integrationからスキーマをインポートします。このオプションでは、XSDファイルをプロジェクト・ディレクトリにコピーして、実行時に利用できるようにします。従属ファイルがある場合は、同じディレクトリ構造を保持して、それらを手動でプロジェクトにコピーする必要があります。

HLリポジトリでスキーマを参照

既存のメタデータ・サービス(MDS)接続を使用するか、使用する新しい接続を作成できます。既存のサービスを選択するか、新しいMDS接続を作成します。新しいMDS接続を作成する場合、MDS接続ウィザードが表示され、接続を定義できます。この接続は、Oracle SOA Suite for healthcare integrationリポジトリにアクセスするために必要です。ドキュメント定義を選択すると、MDSにリンクするURLが生成されます。

選択したアプリケーション・サーバー接続は、特定のOracle SOA Suite for healthcare integrationインスタンスを参照します。インスタンスによって使用されるMDS接続は、ドキュメント定義が矛盾しないように、選択したMDS接続と一致している必要があります。

Oracle SOA Suite for healthcare integrationリポジトリ内のスキーマを参照するとき、MDS接続はリモートMDS内のスキーマを参照する場合にのみ必要であり、ローカル共有MDSリポジトリ内でスキーマを参照する場合は必要ありません。

リソース・スキーマの参照

SOAリソース・ブラウザを使用してスキーマを参照します。このオプションを選択して「スキーマの参照」アイコンをクリックすると、「タイプ・チューザ」ダイアログが開きます。ツリーを展開してタイプを選択し、ドキュメント定義の処理ページに戻ります。

不透明

コンテンツがbase-64エンコーディングで渡される場合に、あらゆるタイプのデータ(例: 位置指定フラット・ファイル)を処理します。スキーマを指定する必要はありません。

anyType

あらゆるタイプのXMLデータを処理します。スキーマを指定する必要はありません。

2.2.3 サービス・コンポーネントの追加

SOAアプリケーションとプロジェクトを作成したら、ビジネス・ロジックやアプリケーションの処理ルールを実装するサービス・コンポーネントを追加できます。

プロジェクトにサービス・コンポーネントを追加するには

1. コンポーネント・パレットで、「SOA」を選択します。

2. 「サービス・コンポーネント」リストから、コンポーネントをデザイナにドラッグします。
図2-12に、デザイナに追加したBPELプロセスを示します。

図2-12 コンポジット・アプリケーションでのBPELプロセス

選択したサービス・コンポーネントに固有のダイアログが表示されます。表2-4で使用可能なダイアログについて説明します。

表2-4 サービス・コンポーネント・エディタの開始

ドラッグするサービス・コンポーネント

起動されるダイアログ

BPELプロセス

「BPELプロセスの作成」ダイアログが開きます。このダイアログで、一連のビジネス・アクティビティおよびサービスをエンドツーエンドのプロセス・フローに統合するBPELプロセスを作成します。

ビジネス・ルール

「ビジネス・ルールの作成」ダイアログが開きます。このダイアログで、ルールに基づいてビジネス・デシジョンを作成します。

ヒューマン・タスク

「ヒューマン・タスクの作成」ダイアログが開きます。このダイアログで、ユーザーまたはグループがエンドツーエンドのプロセス・フローの一環として実行するタスクを記述するワークフローを作成します。

メディエータ

「メディエータの作成」ダイアログが開きます。このダイアログで、メッセージやイベントのルーティング、フィルタおよびトランスフォーメーションを実行するサービスを定義します。

3. サービス・コンポーネントの設定を構成します。サービス・コンポーネントのダイアログに関するヘルプは、「ヘルプ」をクリックするか、[F1]を押します。

4. コンポーネントを構成する際、表2-5に表示されているいずれかの正規化されたメッセージ・プロパティを定義します。hc.fromEndpointおよびhc.toEndpointは定義する必要があり、ヘルスケア統合ユーザー・インタフェースで定義されたエンドポイントに対応する必要があります。

表2-5 ヘルスケア統合の正規化されたメッセージ・プロパティ

hc.documentDefinitionName

ドキュメント定義の名前。例: ADT_A03_def。

hc.documentProtocolName

ドキュメント定義に関連付けられたプロトコルの名前。例: HL7。

hc.documentProtocolVersion

ドキュメント定義に関連付けられた上のプロトコルのバージョン。例: HL7ドキュメントの場合は2.3.1。

hc.documentTypeName

ドキュメント定義に関連付けられたドキュメント・タイプ。例: HL7ドキュメントの場合はADT_A03。

hc.fromEndpoint

送信アプリケーションのエンドポイントの名前。この名前は、ヘルスケア統合ユーザー・インタフェースのエンドポイント構成で定義されます。

hc.messageId

一意のメッセージID。

hc.messageType

メッセージ・タイプの値には、次のいずれかのオプションを指定できます。

- 1 (リクエストを示します)

- 2 (レスポンスを示します)

- 9 (機能確認を示します)

hc.replyToMessageId

送信メッセージの応答先のメッセージID。

hc.toEndpoint

受信アプリケーションのエンドポイントの名前。この名前は、ヘルスケア統合ユーザー・インタフェースのエンドポイント構成で定義されます。

5. 設定の構成が完了したら、「OK」をクリックします。

6. 「ファイル」メイン・メニューから「すべて保存」を選択します。
サービス・コンポーネントの追加の詳細は、Oracle Fusion Middleware Oracle SOA Suite開発者ガイドを参照してください。

3 ドキュメント・タイプおよびドキュメント・プロトコルの操作

この章では、Oracle SOA Suite for healthcare integrationでサポートされるドキュメント・プロトコルとメッセージ・タイプに関する情報を示し、ヘルスケア統合ユーザー・インタフェースでドキュメント定義を操作する方法について説明します。

この章には次のトピックが含まれます:

- 3.1項「ドキュメント・プロトコルの概要」

- 3.2項「カスタム・ドキュメント・プロトコルの使用」

- 3.3項「HL7ドキュメント・プロトコルの使用」

- 3.4項「ドキュメント定義の作成」

- 3.5項「ドキュメント定義の削除」

3.1 ドキュメント・プロトコルの概要

Oracle SOA Suite for healthcare integrationでは、次のドキュメント・プロトコルがサポートされます。

- カスタム

- HL7 V2.x

図3-1は、Oracle SOA Suite for healthcare integrationでサポートされているドキュメント・プロトコルを示しています。

図3-1 Oracle SOA Suite for healthcare integrationのドキュメント・プロトコル

ドキュメント定義の一部として、ドキュメント・ガイドライン・ファイルを指定します。このファイルは通常、Oracleドキュメント・エディタで作成されます。(カスタム・ドキュメントの場合、Oracle Document Editorは使用できません。また、ドキュメントの検証も実行できません。)検証が有効な場合、実行時のペイロードは、使用するドキュメント定義ファイルのタイプに準拠している必要があります。

3.1.1 ドキュメント階層に関する注意事項

図3-2に示すように、ドキュメント・プロトコルは階層とみなすことができます。

図3-2 ドキュメント階層

ドキュメント・プロトコルは、複数のドキュメント・プロトコル・バージョンで構成できます。ドキュメント・プロトコル・バージョンは、複数のドキュメント・タイプで構成できます。ドキュメント・タイプは、複数のドキュメント定義で構成できます。通常、1つのドキュメント定義で作業を開始し、そのドキュメント定義を様々なエンドポイント向けにカスタマイズします。

図3-3に、HL7 V2.3.1に適用されるドキュメント・プロトコル階層を示します。

図3-3 HL7 V2.3.1ドキュメント階層

Oracle SOA Suite for healthcare integrationユーザー・インタフェースでは、ドキュメント定義を作成するとき、ドキュメント・プロトコル階層が定義に反映されます。

ドキュメント・プロトコル-バージョン-ドキュメント・タイプ-ドキュメント定義名

例3-1に、HL7ドキュメントに対する定義に反映される階層を示します。

例3-1 HL7ドキュメントに対するドキュメント定義名

ドキュメント・プロトコル: HL7

ドキュメント・プロトコル・バージョン: 2.3.1

ドキュメント・タイプ: ADT_A01

ドキュメント定義: ADT_A01_def

結果のドキュメント定義:

HL7-2.3.1-ADT_A01-ADT_A01_def

3.2 カスタム・ドキュメント・プロトコルの使用

Oracle SOA Suite for healthcare integrationでは、独自のトランザクションに必要なドキュメントを作成するためのカスタム・ドキュメント・プロトコルがサポートされます。XMLメッセージでは、スキーマ適用(XSD)の利点があります。

非XMLメッセージでは、特定のメッセージ・タイプに対するエンドポイントを作成できます。

カスタム・ドキュメントの作成時には、着信ドキュメントを識別するルールを指定します。XMLドキュメントでは、XPath式またはXPath式と値(式の予想される結果)を指定します。

フラット・ファイルなどの非XMLドキュメントでは、「識別開始位置」、「終了位置」および「識別値」を指定できます。

3.2.1 カスタム・ドキュメント・バージョン・パラメータに関する注意事項

カスタム・ドキュメントのドキュメント・バージョンを作成する場合、パラメータの設定は不要です。

3.2.2 カスタム・ドキュメント定義パラメータに関する注意事項

カスタム・ドキュメント定義を作成するときは(ドキュメント定義の作成の詳細は、3.4項「ドキュメント定義の作成」を参照)、識別タイプ(XMLまたはフラット)を選択し、タブ領域でパラメータを設定します。図3-4に、XMLタイプ・カスタム・ドキュメントのドキュメント定義パラメータを示します。

図3-4 XMLタイプ・カスタム・ドキュメントのドキュメント定義パラメータ

図3-5に、フラット・ファイル・カスタム・ドキュメントのドキュメント定義パラメータを示します。

図3-5 フラット・ファイル・カスタム・ドキュメントのドキュメント定義パラメータ

表3-1に、カスタム・ドキュメントのドキュメント定義パラメータを示します。

表3-1 カスタム・ドキュメントのドキュメント定義パラメータ

パラメータ

説明

「XML」タブ

(「識別タイプ」から「XML」を選択した場合に使用可能)

識別式(XPath)

XMLペイロードのノードを特定します。

識別値

識別式で識別されたノードに照合する値を指定します。値が一致した場合、ドキュメントは正常に識別されます。この値を空欄にしておくと、Oracle SOA Suite for healthcare integrationがノードの存在をチェックし、ドキュメントが正常に識別されます。

DTD/XSDネームスペース変換

「なし」、「両方」、「インバウンド」、「アウトバウンド」の中から選択します。

「ルーティング」タブ

-

ドキュメント・ルーティングID

バックエンド・アプリケーションに対してコンシューマ名を設定します。

「XPath」タブ

3.2.2.1項「カスタムXMLドキュメントのXPath式の構成方法」を参照してください。

XPath名1

ペイロードから値を取得するためのXML XPath名。

XPath式1

ペイロードから値を取得するためのXML XPath式。

XPath名2

ペイロードから値を取得するためのXML XPath名。

XPath式2

ペイロードから値を取得するためのXML XPath式。

XPath名3

ペイロードから値を取得するためのXML XPath名。

XPath式3

ペイロードから値を取得するためのXML XPath式。

「相関」 タブ

-

XPath名からの相関

相関を開始するための相関プロパティの名前。

XPath式からの相関

相関を開始するためにペイロードから値を取得するためのXML XPath。

XPath名への相関

相関のための相関プロパティの名前。

XPath式への相関

相関のためにペイロードから値を取得するためのXML XPath。

「フラット」タブ

-

識別開始位置

終了位置と組み合せて使用し、開始位置と終了位置の間のペイロードから値を取得します。

識別終了位置

開始位置と組み合せて使用し、開始位置と終了位置の間のペイロードから値を取得します。

識別値

開始位置と終了位置の間の値。

「アプリケーション」タブ

-

ドキュメント

内部アプリケーション・ドキュメントの名前。

アクション

ドキュメント内のサブ分類。

XSLTファイル

XSLTファイルの名前。

3.2.2.1 カスタムXMLドキュメントのXPath式の構成方法

カスタムXMLドキュメントは、XPath式によって識別されます。XPath式は、ドキュメント・タイプ・パラメータを指定する際に構成します。

XPath式の構成時のオプションは、次のとおりです。

- オプション1: XPathおよび一致する値の指定

- オプション2: ノードの存在のチェック

- オプション3: 属性の値のチェック

3.2.2.1.1 オプション1: XPathおよび一致する値の指定

トランザクションIDが12345だとします。各パラメータを次のように設定します。

フィールド

値

識別値

12345

識別式

//*[local-name() = 'TransactionID']/text()

Oracle SOA Suite for healthcare integrationでは、ペイロードの識別式の値と、「識別値」に指定した値が比較されます。値が一致するとドキュメントが正常に識別され、対応するドキュメント・タイプとドキュメント・プロトコル・バージョンを使用してエンドポイントが識別されます。例3-2に、このオプションのXMLペイロードの一部を示します。

例3-2 XPathおよび一致する値の指定

<?xml version="1.0" encoding="UTF-8" ?>
<Message xmlns:ns1="http://www.example1.org" xmlns:ns2="http://www.example2.org"
xmlns="http://www.example3.org"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns="http://www.example4.org">
<MessageHeader>
<Source>201944019</Source>
<Destination>205704856</Destination>
<TransactionID>123456</TransactionID>
<Version>1-0-0</Version>
</MessageHeader>
<Body>
<ns:Case xsi:schemaLocation="http://www.example4.org" ns1:caseCategoryID="1">
<ns1:OfficialProvisionNumber>String</ns1:OfficialProvisionNumber>
</ns:Case>
</Body>
</Message>

3.2.2.1.2 オプション2: ノードの存在のチェック

registerCommandというノードの存在をチェックする場合を想定します。各パラメータを次のように設定します。

フィールド

値

識別値

空欄

識別式

/*[local-name()='envelope']/body/transaction/command/*[local-name()='registerCommand']

「識別値」フィールドを空欄のままにした場合、Oracle SOA Suite for healthcare integrationでは識別式に指定したノードがチェックされます。ペイロードのノードが一致すると、ドキュメントが正常に識別されます。例3-3に、このオプションのXMLペイロードの一部を示します。

例3-3 ノードの存在のチェック

<uccnet:envelope xmins:eanucc="http://www.ean-ucc.org/schemas/1.3/eanucc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:uccnet="http://www.uccnet.org/schemas/2.2/uccnet"
communicationVersion="2.2"
xsi:schemaLocation="http://www.uccnet.org/schemas/2.2/uccnet
http://www.testregistry.net/xmlschema/uccnet/2.2/Envelope.xsd">
<messageHeader>
<messageIdentifier>
<value>791:1_EB3CDC749A1F2BABE03014906CC4605A</value>
</messageIdentifier>
<userId>oraclesupXSD</userId>
<representingParty>
<gin>0060974050142</gin>
</representingParty>
</messageHeader>
<body>
<transaction>
<entityIdentification>
<uniqueCreatorIdentification>856</uniqueCreatorIdentification>
<globalLocationNumber>
<gin>0060974050142</gin>
</globalLocationNumber>
</entityIdentification>
<command>
<uccnet:registerCommand>
<registerCommandHeader type="ADD" />
</uccnet:registerCommand>
</command>
</transaction>
</body>
</uccnet:envelope>

3.2.2.1.3 オプション3: 属性の値のチェック

国属性の値がUSであるとします。各パラメータを次のように設定します。

フィールド

値

識別値

US

識別式

//*/@country

Oracle SOA Suite for healthcare integrationでは、国属性の値と、「識別値」に設定した値が比較されます。値が一致するとドキュメントが正常に識別されます。例3-4に、このオプションのXMLペイロードの一部を示します。

例3-4 属性の値のチェック

<?xml version="1.0" encoding="windows-1252" ?>
<MyAddress country="US" xmlns="http://www.example.org"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="PO.xsd">
<name>B2B Buyer</name>
<street>100 Oracle Parkway</street>
<city>Redwood City</city>
<state>CA</state>
<zip>94065</zip>
</MyAddress>

3.3 HL7ドキュメント・プロトコルの使用

Oracle SOA Suite for healthcare integrationには、Generic交換またはMLLP交換を使用して医療情報を含むドキュメントを交換するためのHealth Level 7 (HL7)バージョン2.xが実装されています。HL7使用時には、標準のOracle SOA Suite for healthcare integrationの機能(検証、変換、アウトバウンド・エンベロープ・ヘッダーの自動生成および確認など)を使用できます。

HL7標準を作成し、管理している組織の情報は、次を参照してください。

http://www.hl7.org

3.3.1HL7ドキュメント・バージョン・パラメータに関する注意事項

HL7ドキュメント・バージョンを作成する場合は、様々なパラメータを設定できます。図3-6に、HL7ドキュメントのドキュメント・バージョン・パラメータを示します。

図3-6 HL7ドキュメントのドキュメント・バージョン・パラメータ

表3-2に、HL7ドキュメントのドキュメント・バージョン・パラメータを示します。

表3-2 HL7ドキュメントのドキュメント・バージョン・パラメータ

パラメータ

説明

「メッセージ・ヘッダー」タブ

-

セキュリティ

HL7の一部のアプリケーションでは、このフィールドがセキュリティ機能の実装に使用されます。

処理ID

MSH.11。このフィールドは、HL7アプリケーション(レベル7)処理ルールの定義に従ってメッセージを処理するかどうかを決定するために使用されます。最初のコンポーネントでは、メッセージが本番、トレーニングまたはデバッグ・システムのいずれに属しているかを定義します(有効な値については、HL7表0103 - 処理IDを参照してください)。2番目のコンポーネントでは、メッセージがアーカイブ・プロセスまたは初期ロードのいずれに属しているかを定義します(有効な値については、HL7表0207 - 処理モードを参照してください)。この結果、異なる処理モードに異なる優先度を設定できます。

確認タイプの受入

メッセージに対する応答でアプリケーション確認の返信が必要となる条件を設定します。値「AL」(常時)が指定されます。

Oracle SOA Suite for healthcare integrationでは、確認を生成する必要があるかどうかを調べるために、着信メッセージのペイロード(MSH.15)がチェックされます。一部のHL7システムでは、ペイロードでMSH.15は送信されないため、確認の送信が必要です。

アプリケーション確認タイプ

MSH.16。値「AL」(常時)が指定されます。

国コード

メッセージの作成国を設定します。値「US」が指定されます。

キャラクタ・セット

メッセージ全体の文字セットを設定します。値「ASCII」が指定されます。

国際化コード識別子

MSH.19

国際化コード・テキスト

MSH.19

国際化コード体系名

MSH.19

国際化コード代替識別子

MSH.19

国際化コード代替テキスト

MSH.19

国際化コード代替コード体系名

MSH.19

国際バージョン識別子

MSH.12

国際バージョンIDテキスト

MSH.12

国際バージョンIDコード体系名

MSH.12

国際バージョンID代替識別子

MSH.12

国際バージョンID代替テキスト

MSH.12

国際バージョンID代替コード体系名

MSH.12

「バッチ・ヘッダー」タブ

-

バッチ・ヘッダーの作成

バッチ・ヘッダーを作成する場合は、ボックスを選択します。

バッチ・ヘッダーECSファイル

「参照」ボタンを使用して、標準ファイルをオーバーライドするECSファイルを検索します。指定しない場合、用意されているデフォルト・ファイルが使用されます。

バッチ・セキュリティ

BHS.8

バッチ日付

BHS.7。システム日付タイムスタンプが指定されます(#SystemDateTime(CCYYMMDDHHMM)#)。

「ファイル・ヘッダー」タブ

-

ファイル・ヘッダーの作成

ファイル・ヘッダーを作成する場合は、チェック・ボックスを選択します。

ファイル・ヘッダーECSファイル

「参照」ボタンを使用して、標準ファイルをオーバーライドするECSファイルを検索します。指定しない場合、用意されているデフォルト・ファイルが使用されます。

ファイル・セキュリティ

FHS.8

ファイル日付

FHS.7。システム日付タイムスタンプが指定されます(#SystemDateTime(CCYYMMDDHHMM)#)。

「デリミタ」タブ

デリミタ・フィールドの横にある「16進文字の選択」をクリックすると値が指定されます。

要素デリミタ

セグメント識別子の後に続く1文字で、セグメント内の各データ要素(最後の要素を除く)を区切ります。値「0x7c」が指定されます。

エスケープ文字

値「0x5c」が指定されます。

繰返しセパレータ

繰返しデータ要素の隣接する出現を区切るため、またはフィールドの複数の出現を区切るために使用されるサービス文字。値「0x7e」が指定されます。

セグメント・デリミタ

メッセージ内のセグメント(データ・フィールドの論理的なグループ)の終了を示す構文文字。値「0x0d」が指定されます。

サブコンポーネント・デリミタ

値「0x26」が指定されます。

サブ要素デリミタ

値「0x5e」が指定されます。

「その他」タブ

-

エンベロープ・パラメータの無視

このオプションを使用して、参照検証時に無視するエンベロープ要素のリストをカンマ区切りで指定します。HL7アグリーメントの場合、指定可能な値は、MessageSendingApp、MessageReceivingApp、MessageSendingFacilityおよびMessageReceivingFacilityです。

確認モード

このオプションを選択して、インバウンド・バッチHL7メッセージの対して確認を1つ送信するか複数送信するかを指定します。

3.3.2 HL7ドキュメント・タイプ・パラメータに関する注意事項

HL7ドキュメント・タイプを作成する場合は、様々なパラメータを設定できます。図3-7に、HL7ドキュメントのドキュメント・タイプ・パラメータを示します。

図3-7 HL7ドキュメントのドキュメント・タイプ・パラメータ

表3-3に、HL7ドキュメントのドキュメント・タイプ・パラメータを示します。

表3-3 HL7ドキュメントのドキュメント・タイプ・パラメータ

パラメータ

説明

「トランザクション」タブ

-

HL7汎用確認

選択した場合、Oracle SOA Suite for healthcare integrationから汎用確認が送信されます。

確認制御IDのマップ

ビジネス・メッセージのMSH.10から確認のMSH.10へのマッピングを有効にする場合に選択します。

注意: この「確認制御IDのマップ」パラメータは、機能確認用です。

確認の受入

機能確認は、MSH.15に値がない場合に生成されます。アクションを実行しない場合は「なし」を選択します。確認の生成は、ビジネス・メッセージのMSH.15内の値に依存します。どのような条件でも確認を生成する場合は、「AL」(常時)を選択します。メッセージ・エラーまたはメッセージが拒否されたときに確認を生成する場合は、「ER」(エラー/拒否)を選択します。メッセージが正常に処理されたときに確認を生成する場合は、「SU」(正常終了)を選択します。

3.3.3 HL7ドキュメント定義パラメータに関する注意事項

HL7ドキュメント定義を作成するときは(ドキュメント定義の作成の詳細は、3.4項「ドキュメント定義の作成」を参照)、様々なパラメータを設定できます。図3-8に、HL7ドキュメントのドキュメント定義パラメータを示します。

図3-8 HL7ドキュメントのドキュメント定義パラメータ

表3-4に、HL7ドキュメントのドキュメント定義パラメータを示します。

表3-4 HL7ドキュメントのドキュメント定義パラメータ

パラメータ

説明

「トランザクション」タブ

-

*トランザクション・セットECSファイル

「参照」ボタンを使用して、ECSファイルを検索します。

「ルーティング」タブ

-

ドキュメント・ルーティングID

バックエンド・アプリケーションに対してコンシューマ名を設定します。

「XPath」タブ

詳細は、3.2.2.1項「カスタムXMLドキュメントのXPath式の構成方法」を参照してください。

XPath名1

ペイロードから値を取得するためのXML XPath名。

XPath式1

ペイロードから値を取得するためのXML XPath式。

XPath名2

ペイロードから値を取得するためのXML XPath名。

XPath式2

ペイロードから値を取得するためのXML XPath式。

XPath名3

ペイロードから値を取得するためのXML XPath名。

XPath式3

ペイロードから値を取得するためのXML XPath式。

「相関」タブ

-

XPath名からの相関

相関を開始するための相関プロパティの名前。

XPath式からの相関

相関を開始するためにペイロードから値を取得するためのXML XPath。

XPath名への相関

相関のための相関プロパティの名前。

XPath式への相関

相関のためにペイロードから値を取得するためのXML XPath。

「アプリケーション」タブ

-

ドキュメント

内部アプリケーション・ドキュメントの名前。

アクション

ドキュメント内のサブ分類。

XSLTファイル

XSLTファイルの名前。

3.3.4 HL7の使用に関する注意事項

HL7即時確認(トランスポート・レベルの確認)の場合、ビジネス・メッセージは生成されません。

HL7交換のエラーを示す否定応答メッセージは、HL7バージョン2.1から2.5では、80文字長制限のために切り捨てられる場合があります。

3.4 ドキュメント定義の作成

ドキュメント定義では、メッセージの検証に使用されるドキュメント・プロトコル(ドキュメント・プロトコル・バージョンおよびドキュメント・タイプ)が指定されます。ドキュメント定義には、HL7メッセージの場合はECSファイル、XMLメッセージの場合はXSD/DTDを使用できます。

トランザクションにエンドポイントを参加させると、同じドキュメント定義が使用されます。ドキュメント定義は、ドキュメント・プロトコル、プロトコル・バージョンおよびドキュメント・タイプの標準に準拠する必要があります。

注意:

ドキュメント定義が標準に準拠するようにするには、Oracleドキュメント・エディタを使用してドキュメントのガイドライン・ファイルを作成し、ドキュメント定義の作成時にはOracle SOA Suite for healthcare integrationユーザー・インタフェースを使用して、それらのファイルをインポートします。

Oracleドキュメント・エディタを使用してトランザクション・セット・ファイルを作成したら、Oracle SOA Suite for healthcare integrationユーザー・インタフェースを使用して、ドキュメント定義を作成し、トランザクション・セット・ファイルをインポートします。

注意:

ドキュメント・バージョン、ドキュメント・タイプおよびドキュメント定義は、作成後は編集できません。特定のドキュメント要素(バージョン、タイプまたは定義)を削除して、新しく作成する必要があります。作成後にドキュメント要素を更新すると、メタデータの不整合、メタデータ検証の問題、ランタイム・エラーが発生する原因となる場合があります。

ドキュメント定義を作成するには:

1. Oracle SOA Suite for healthcare integrationにログオンします。「構成」タブが選択された状態でOracle SOA Suite for healthcare integrationユーザー・インタフェースが開きます。

2. 左側のナビゲーション・パネルで「ドキュメント・プロトコル」を開きます。サポートされているプロトコル、すなわちカスタムとHL 7 V2.xのリストが表示されます。

3. 図3-9に示すように、いずれかのドキュメント・プロトコル(たとえばHL7)を選択し、「作成」ボタンをクリックします。「ドキュメント・バージョンの作成」ウィンドウが表示されます。

注意:

または、ドキュメント・プロトコル名を右クリックして、ショートカット・メニューから「作成」を選択することもできます。

図3-9 ドキュメント・プロトコルの選択

注意:

ドキュメント・プロトコル・バージョンの作成ダイアログ・ボックスに、プロトコル・バージョン名(例: 2.3.1)を入力します。

4. 「名前」フィールドにドキュメント・プロトコル・バージョン名を入力します。

5. 必要に応じてドキュメント・バージョンのパラメータを指定し、「OK」をクリックします。
このバージョンがドキュメントの識別に使用されます。大/小文字を区別できます。プロトコル標準に準拠した固定構文を使用します。

図3-10に、HL7 V2.3.1ドキュメントのドキュメント・プロトコル・バージョンのページを示します。

図3-10 ドキュメント・プロトコル・バージョン情報の入力

パラメータの詳細は、表3-2「HL7ドキュメントのドキュメント・バージョン・パラメータ」を参照してください。

6. 新たに作成したバージョン名をクリックして、「作成」ボタンをクリックすると、「ドキュメント・タイプの作成」ウィンドウが表示されます。または、バージョン名を右クリックして、ショートカット・メニューから「作成」を選択することもできます。

7. ドキュメント・タイプ名を入力し、ドキュメント・タイプ・パラメータを必要に応じて指定して、「OK」をクリックします。
図3-11に、HL7 V2.3.1ドキュメントのドキュメント・タイプ・パラメータのページを示します。

図3-11 ドキュメント・タイプ・パラメータの情報の入力

ドキュメント・タイプ・パラメータの詳細は、表3-3「HL7ドキュメントのドキュメント・タイプ・パラメータ」を参照してください。

8. 新しいドキュメント・タイプ名を選択した状態で、「作成」をクリックすると、「ドキュメント定義の作成」ウィンドウが表示されます。

9. ドキュメント定義名を入力して、次を行います:

1. 任意のドキュメント・プロトコルに対して、オプションの定義ファイル(XSDファイル)を参照します。

2. 必要なHL7用トランザクション・セットECSファイルまたは位置指定フラット・ファイルを参照します。

3. 必要に応じてドキュメント定義のパラメータを指定し、「OK」をクリックします。

図3-12に、HL7 V2.3.1ドキュメントのドキュメント定義パラメータのページを示します。

図3-12 ドキュメント定義パラメータの情報の入力

定義パラメータの詳細は、次の表を参照してください。

- 表3-1 カスタム・ドキュメントのドキュメント定義パラメータ

- 表3-4 HL7ドキュメントのドキュメント定義パラメータ

注意:

インストール後スクリプトを使用して標準ライブラリをインストールし、hl7 doctypesファイルをインポートしてHealthcareコンソールにドキュメント・ツリーを作成することもできます。

3.5 ドキュメント定義の削除

ドキュメント定義を削除するには、ドキュメント定義名を選択して「削除」をクリックします。または、定義名を選択して右クリックし、ショートカット・メニューから「削除」を選択します。

4 エンドポイントの操作

この章では、Oracle SOA Suite for healthcare integrationにおけるエンドポイントの概念について説明し、ヘルスケア統合アプリケーション用にエンドポイントを作成および構成する手順を示します。

この章の内容は以下のとおりです。

- 4.1項「エンドポイントの概要」

- 4.2項「エンドポイントの作成」

- 4.3項「エンドポイントとドキュメントの関連付け」

- 4.4項「MLLPエンドポイントの順序付けの有効化」

- 4.5項「エンドポイントの削除」

- 4.6項「エンドポイント」ウィンドウの操作

4.1 エンドポイントの概要

Oracle SOA Suite for healthcare integrationでは、エンドポイントは事前定義済のドキュメントが送信または受信される通信チャネルです。エンドポイントは、ドキュメントが外部システムと交換される方法を定義し、場所、トランスポート・プロトコル、交換するドキュメントおよびその他の構成パラメータを指定します。URL、フォルダ、パスなどをエンドポイントにすることができます。メッセージの方向に基づいて、エンドポイントはインバウンド、アウトバウンドまたはその両方の場合があります。たとえば、Oracle SOA Suite for healthcare integrationがディレクトリから読み取る場合、ディレクトリはインバウンド・エンドポイントです。反対に、Oracle SOA Suite for healthcare integrationがディレクトリにメッセージを書き込むか送信する場合、ディレクトリはアウトバウンド・エンドポイントです。また、MLLPエンドポイントは、メッセージの受信と送信の両方に使用できます。

Oracle SOA Suite for healthcare integrationでは、エンドポイントをドキュメント定義に関連付け、エンドポイントがメッセージの送信と受信を開始できるようにする必要があります。

図4-1は、ドキュメント定義にまだ関連付けられていないサンプルのエンドポイントを示しています。

図4-1 Oracle SOA Suite for healthcare integrationのサンプル・エンドポイント

4.2 エンドポイントの作成

Oracle SOA Suite for healthcare integrationユーザー・インタフェースには、エンドポイントを作成および構成できるエンドポイント・ページがあります。この手順では、インタフェースを使用してエンドポイントを作成する方法について説明します。

双方向(MLLP)および単一方向(FILE、JMS)トランスポート・プロトコル用のエンドポイントを作成できます。双方向プロトコルの場合、レスポンス・メッセージまたは機能確認(FA)の送受信を1つのエンドポイントで実行できます。一方、単一方向プロトコルの場合、ドキュメントの送受信を行うように構成しないと、1つのエンドポイントでメッセージまたはFAの送受信を実行できません。

双方向トランスポート・プロトコル(MLLP)を使用してエンドポイントを作成するには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。

2. 「設計」タブの「構成」タブで、「エンドポイント」フォルダをクリックし、図4-2に示す「作成」アイコンをクリックします。

図4-2 「エンドポイントの作成」アイコン

3. 図4-3に示すように、「作成」ウィンドウに次を入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、MLLP10を選択します。

- 接続モード: 「サーバー」または「クライアント」。エンドポイントがサーバーとして構成されている場合、Oracle SOA Suite for healthcare integrationエンジンはポートでリスニングを開始し、クライアントが接続するのを待機します。一般に、サーバー接続モードはインバウンド用です。クライアントとして構成されている場合、エンジンはリモート・コンピュータまたはデバイスのホスト名およびポートに接続します。一般に、これはアウトバウンド用です。

注意:

Oracle Healthcareでは、単一サーバー・チャネルに対する複数のクライアント接続をサポートしています。このため、複数のクライアントが同一サーバーに接続し、データを交換したりFAを受信することができます。

バックエンド・アプリケーションに渡されたメッセージは、次の方法で送信されます。

- Oracle Healthcareが動的IPアドレスを使用してエンドポイント詳細をバックエンド・アプリケーションに渡し、アプリケーションが同じ値をアウトバウンドの動的IPヘッダーに戻します。Oracle Healthcareはこの動的IPヘッダーを使用して、正しい接続を選択します。

- クライアントは確認またはレスポンス・メッセージのプロパティでreplytoMsgIdプロパティを設定して、接続詳細をリクエスト・メッセージからフェッチできます。

- ホスト名: MLLPサーバー・エンドポイントの場合はOracle SOA Suiteをホストしているコンピュータの名前またはIPアドレス、MLLPクライアント・エンドポイントの場合はリモート・ホストの名前またはデバイス名にする必要があります。通常、これはlocalhostである必要があります。ただし、ホスト名はリモート・ホストまたはデバイスの名前にすることもできます。

- ポート: ポート番号は500より大きい値にする必要があります。接続モードが「サーバー」に設定されている場合、ポート番号は有効なTCPポート番号である必要があります。接続モードが「クライアント」に設定されている場合、ポート番号はMLLPサーバーで使用するポートと同じである必要があります。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図4-3 エンドポイント・パラメータの指定

単一方向トランスポート・プロトコル(FILE)を使用してエンドポイントを作成するには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。

2. 「設計」タブの「構成」タブで、「エンドポイント」フォルダをクリックし、「作成」アイコンをクリックします。

3. 図4-4に示すように、「作成」ウィンドウに次を入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、FILEを選択します。

- 方向: 「インバウンド」または「アウトバウンド」。エンドポイントをインバウンドとして構成した場合、他のエンドポイントからレスポンス・メッセージまたはFAを受信できます。反対に、エンドポイントをアウトバウンドとして構成した場合、メッセージまたはFAを送信できます。

- フォルダ名: 絶対ディレクトリ・パスをお薦めします。このフォルダにはインバウンドまたはアウトバウンドのメッセージやFAは格納されません。インバウンド・メッセージはこのフォルダ内にあることが期待され、アウトバウンドのメッセージまたはFAはここに配信される必要があります。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図4-4 エンドポイント・パラメータの指定

注意:

単一方向エンドポイント(インバウンド/アウトバウンド)の作成後、後からこれを「構成」リンクをクリックして編集し、インバウンドまたはアウトバウンドの構成を追加できます。

注意:

様々なトランスポート・プロトコルでのエンドポイントの作成の詳細は、付録B「各種トランスポート・プロトコルを使用したエンドポイントの作成」を参照してください。

4.2.1 単一方向プロトコルのエンドポイントでのチャネルの構成

双方向トランスポート・プロトコル(MLLPなど)を使用してエンドポイントを作成した場合、エンドポイントはリクエストとリプライの双方(インバウンドおよびアウトバウンド)とACKを処理することができます。しかし、単一方向トランスポート・プロトコル(FileやFTPなど)の場合、通常、構成できるのはインバウンド・チャネルまたはアウトバウンド・チャネルの一方であり、両方一緒に構成することはできません。

Oracle SOA Suite for healthcare integrationでは、単一方向プロトコルの場合、管理およびモニタリング用に2つの通信チャネル(送信および受信メッセージ用に1つずつ)を1つのエンティティ(エンドポイント)として構成することができます。この概念により、サポートされるドキュメントの有効化または無効化および表示が可能になり、関連するチャネルの関連モニタリング・データ(メッセージ数や実際のメッセージ)を同時に表示できます。

この機能を使用して単一方向トランスポート・プロトコルを使用するときに、構成する必要があるチャネルは1つのみです。もう一方のチャネル(逆方向)の構成はオプションです。この場合、Oracle SOA Suite for healthcare integrationコンソールには、メッセージの送信または受信用に構成されたチャネルが1つ表示されますが、図4-5に示すとおり、もう一方のチャネルは未構成として表示されます。

図4-5 未定義のセカンダリ・チャネル

図4-6に示すとおり、もう一方のチャネルは、未定義チャネルのセクションで「構成」リンクをクリックし、構成ダイアログ・ボックスで必要なチャネル詳細を指定することで構成できます。

図4-6 セカンダリ・チャネルの定義

トランスポート・プロトコルおよびその他の設定はチャネルごとに定義します。2つのチャネルに異なる単一方向トランスポート・プロトコルを使用できます。たとえば、1つのチャネルではFTPを使用して、もう一方のチャネルではFileを使用することもできます。唯一の要件は、両方とも単一方向プロトコルを使用するという点です。

両方の通信チャネルを定義しドキュメントをチャネルに関連付けると(4.3項「エンドポイントとドキュメントの関連付け」を参照)、エンドポイントが図4-7のように表示されます。

図4-7 両方のチャネルが構成された単一方向エンドポイント

必要に応じて、各チャネルの構成を編集できます。また、対応するチャネルのセクションで「削除」リンクを使用して、各チャネルの構成を削除することもできます。

4.3 エンドポイントとドキュメントの関連付け

エンドポイントを作成した後で、それをドキュメントに関連付けて、エンドポイントがメッセージを送信または受信できるようにする必要があります。メッセージを送信、受信または送受信するようにエンドポイントを構成できます。

双方向エンドポイントをドキュメントに関連付けるには:

1. 必要なエンドポイントを開きます。

2. メッセージを送信または受信するようにエンドポイントを構成します。

1. エンドポイントの「送信」または「受信」セクションで、「+」アイコンをクリックしてドキュメント選択ウィンドウを表示します。

2. 使用可能なドキュメント階層から、必要なドキュメント定義を選択します(たとえばADT_A04_def)。ドキュメント定義がエンドポイントに関連付けられます。機能確認、検証またはエンドポイントの変換が必要かどうかを指定でき、必要な内部デリバリ・チャネル、トランスポートまたはアグリーメント・レベルのコールアウトおよびマップセットも指定できます。

注意:

ドキュメント定義を「送信」または「受信」セクションにドラッグ・アンド・ドロップすることもできます。

図4-8は、ドキュメント定義に関連付けられたエンドポイントを示しています。

図4-8 エンドポイントとドキュメント定義の関連付け

注意:

FAの場合、「機能確認」、「検証」、「変換」、「再試行間隔」および「再試行数」は無効になります。

3. 次のドキュメント構成オプションを選択します。

オプション

説明

機能確認

成功またはエラーの条件に対して機能確認を有効にする場合に選択します

検証

構成済のECSファイルに対してドキュメントの検証を有効にする場合に選択します。

変換

XMLからネイティブ・フォーマットへの変換、またはその逆の変換を有効にする場合に選択します。

4. 「内部チャネル」、「ドキュメント・コールアウト」、「マップセット」または「コンポジット」のいずれかがエンドポイントに対して定義されている場合は、これらを適切なフィールドから選択します。詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの第6章の取引パートナ・アグリーメントの作成とデプロイを参照してください。

注意:

インバウンド・ドキュメントの場合、コンポジット名とJMS内部デリバリ・チャネル名の選択はオプションです。Oracle Healthcareは特定のドキュメント定義について、1つのコンポジットのみサポートできます。複数のコンポジットを使用できる場合、Oracle Healthcareは実行時に最初にOracle Healthcareに登録されたコンポジットにメッセージを送信するため、結果は予測できないものになります。

3. 「有効」チェック・ボックスを選択し、「適用」をクリックして、エンドポイントでのメッセージの送受信を有効にします。「適用」操作の適用には30から60秒ほどかかることがあります。これは、XSD/ECSの作成とメタデータの検証が原因です。

注意:

エンドポイントに変更を加えた後で、左側のパネルでエンドポイント名を右クリックし、「リフレッシュ」をクリックしてエンドポイントを更新できます。

注意:

エンドポイントの有効化と無効化は、「有効」チェック・ボックスの選択または選択解除の後、「適用」ボタンをクリックすることで切り替えることができます。

単一方向エンドポイントとドキュメントの関連付け

Fileなど、単一方向エンドポイントを関連付ける場合の手順は、双方向エンドポイントの場合とほぼ同じです。ただし、異なる点がいくつかあります。

- エンドポイントを作成する際、SOA Suite for healthcare integrationコンソールは選択された方向の構成オプションを表示した状態で開きます。

- 双方向エンドポイントとドキュメントの関連付け手順にリストされているその他の手順を実行すると、図4-9に示すとおり、エンドポイントがドキュメントに関連付けられます。

図4-9 単一方向エンドポイントとドキュメントの関連付け

- エンドポイントの作成時に、エンドポイントの方向をインバウンドとして指定した場合、「構成」リンクをクリックし、同じページでエンドポイントにアウトバウンド構成を定義できます。この機能により、関連する2つの単一方向エンドポイント(送信メッセージ用と受信メッセージ用にそれぞれ1つずつ)を1つのエンティティとして結び付け、管理とモニタリングを効率的に行うことができます。

注意:

エンドポイントからドキュメントの関連付けを解除するには、「ドキュメント」セクションでドキュメント・エンティティを選択し、「削除」(X)ボタンをクリックします。

4.4 MLLPエンドポイントの順序付けの有効化

ドキュメントをエンドポイントに関連付けた後、エンドポイントの構成のために次のオプションを使用できます。

- 確認モード: エンドポイントがメッセージを受信するモードとして同期、非同期または「なし」を選択します。

- 再試行間隔: メッセージの配信が再試行される間隔。

- 再試行数: メッセージ配信を再試行する回数。

- トランスポート・コールアウト: メッセージの受信後または送信前に呼び出すトランスポート・コールアウト。コールアウトは、コールアウトの作成後にのみ選択できます。

- トランスポート・プロトコル: 「トランスポートの詳細」ボタンをクリックして、次の図に示すようにトランスポート・プロトコル・パラメータをカスタマイズします。

MLLP 1.0上で、現在のメッセージの肯定ACKの受信後にのみ次のメッセージが送信されるようにHL7メッセージを送信する必要がある場合は、MLLP 1.0の順序付けモードをOneToOne順序付けに設定できます。

MLLP 1.0エンドポイントをドキュメントに関連付ける場合は、「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスの「詳細」タブで、アウトバウンド・メッセージについて次の順序付けモードから選択できます。

- なし: メッセージはACKを待たずに順番にディスパッチされます。

- OneToOne (デフォルト): メッセージは順番に送信されますが、ACKは管理番号の搬送を期待されません(相関は、ACK内の管理番号をチェックせずに行われます)。否定ACKの場合、メッセージ送信は肯定ACKが受信されるか再試行数が尽きる(この時点でメッセージはエラー状態になります)まで再試行されます。

- OneToOneMapping: メッセージは順番に送信されますが、適切な相関を行うためにACKは管理番号を搬送する必要があります。管理番号は、ACKを送信済メッセージに相関付けるために使用されます。

図4-10は、アウトバウンド・メッセージで使用可能な順序付けモードを示しています。

図4-10 アウトバウンド・メッセージの順序付けモード

注意:

「HL7確認の破棄」チェック・ボックスに選択した値は、ACKペイロードが持続するかどうかを示します。これは、即時確認および確認の破棄の場合にのみ適用されます。チェック・ボックスを選択解除すると、ペイロードの持続によるデータベース層でのI/O負荷が軽減されます。

トランスポート・プロトコルとそれに対応する交換プロトコルの詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの第5章、取引パートナの構成の項の、表5-3のトランスポート・プロトコル・パラメータおよび表5-5の交換プロトコル・パラメータを参照してください。

単一方向エンドポイントの場合:

- 「トランスポートの詳細」ボタンをクリックすると「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスが表示され、双方向エンドポイントの場合とは異なるパラメータのセットの入力を求められます。図4-11は、単一方向エンドポイントの「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスを示しています。

図4-11 「トランスポート・プロトコル・パラメータ」ダイアログ・ボックス

トランスポート・プロトコルの詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの第5章、取引パートナの構成の項の、表5-3のトランスポート・プロトコル・パラメータを参照してください。

4.5 エンドポイントの削除

エンドポイントを削除するには、Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。「設計」タブの「構成」タブで、エンドポイント名を選択し、「削除」アイコンをクリックします。エンドポイント名を右クリックし、ショートカット・メニューから「削除」をクリックすることもできます。

注意:

有効化されているエンドポイントは削除できません。削除する前に、エンド・ポイントを無効にする必要があります。

4.6 「エンドポイント」ウィンドウの操作

「エンドポイント」ウィンドウを使用して、既存のエンドポイントのリストを表示できます。また、「エンドポイント」ウィンドウを使用してエンドポイントを作成、変更または削除することもできます。このウィンドウでは、すべてまたは必要なエンドポイントを選択し、一括変更や削除などの必要な操作を実行することも可能です。

「エンドポイント」ウィンドウにアクセスするには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。

2. 「設計」タブの「構成」タブで、「エンドポイント」フォルダをダブルクリックします。

図4-12はエンドポイント・ウィンドウを示しています。

図4-12 エンドポイント・ウィンドウ

5 コールアウトの操作

この章では、Oracle SOA Suite for healthcare integrationでJavaコールアウトを作成および使用する方法について説明します。Javaコールアウトは、ホストとリモートのエンドポイントの間で交換するメッセージの書式を変換します。通常、コールアウトを使用することで、XSLTスタイル・シートおよびJavaプログラムを起動できます。

この章には次のトピックが含まれます:

- 5.1項「コールアウトの概要」

- 5.2項「コールアウトのタイプ」

- 5.3項「コールアウトの作成」

- 5.4項「エンドポイントへのコールアウトのインクルード」

5.1 コールアウトの概要

コールアウトは、リモート取引パートナとは異なるメッセージ書式をホスト・エンドポイントで使用している環境で使用されます。また、コールアウトは、メッセージのヘッダー情報をカスタマイズするためにも使用されます。

5.1.1 コールアウト・ライブラリJARファイルの作成

Oracle SOA Suite for healthcare integrationに用意されているコールアウトJARファイルがユーザーのニーズを十分に満たさない場合は、Oracle Fusion Middleware B2B Callout Java APIリファレンスに記載されている標準に従って、Oracle SOA Suite for healthcare integrationの外部で独自のコールアウトJARファイルを作成できます。外部JARファイルのディレクトリの場所は、「コールアウト・ディレクトリ」フィールドに指定できます。このフィールドにアクセスするには、図5-1に示すように、Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「管理」タブ→「設定」→「ランタイム」リンクの順に選択します。独自のコールアウト用には、外部JARファイルを作成することをお薦めします。独自のコールアウトはb2b.jarにバンドルしないでください。

図5-1 コールアウト・ディレクトリの指定

注意:

MySampleCalloutは制限されたキーワードであるため使用しないでください。すでにb2b.jarにパッケージされています。

5.2 コールアウトのタイプ

Oracle SOA Suite for healthcare integrationでは次の2タイプのコールアウトが提供されます。

- トランスポート・コールアウト

- ドキュメント・コールアウト

5.2.1 トランスポート・コールアウト

トランスポート・コールアウトはエンドポイントに関連付けられます。インバウンド・メッセージの場合、Oracle SOA Suite for healthcare integrationはリモート・エンドポイントからメッセージを受信するとすぐにトランスポート・コールアウトを呼び出します。アウトバウンド・メッセージの場合、Oracle SOA Suite for healthcare integrationはリモート・エンドポイントにメッセージを送信する直前にトランスポート・コールアウトを呼び出します。トランスポート・コールアウトは、図5-2で示されているようにエンドポイント構成で選択でき、サポートされている任意のプロトコル(一般的なTCPやMLLP 1.0など)で使用できます。

図5-2 トランスポート・コールアウト

トランスポート・コールアウトを使用すると、インバウンド・メッセージのトランスポート・カスタム・ヘッダーを抽出して、アウトバウンド・メッセージのトランスポート・ヘッダーを設定できます。例5-1では、コールアウトでCUSTOM_HEADERプロパティを設定および取得する方法を示します。

例5-1 CUSTOM_HEADERプロパティの設定と取得

import java.util.*;
import oracle.tip.b2b.callout.*;
import oracle.tip.b2b.callout.exception.*;

public class SampleCallout implements Callout {
public void execute(CalloutContext context,List input,List output)
throws CalloutDomainException, CalloutSystemException {
try {
CalloutMessage cmIn = (CalloutMessage)input.get(0);
String s =cmIn.getBodyAsString();

//for getting the CUSTOM_HEADER
Properties params =  (Properties)cmIn.getParameters();
String customHeader = (String)params.get("CUSTOM_HEADER");

//for setting the CUSTOM_HEADER
CalloutMessage cmOut = new CalloutMessage(s);
cmOut.setParameter("CUSTOM_HEADER", "your_value");
output.add(cmOut);

} catch (Exception e) {
throw new CalloutDomainException(e);
}
}
}

詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドのトランスポート・コールアウトを使用したカスタム・ヘッダーの抽出を参照してください。

5.3項「コールアウトの作成」の説明のとおり、トランスポート・コールアウトは「デザイナ」の「構成」タブから作成します。すべてのトランスポート・コールアウトは、エンドポイント・ページの「トランスポート・コールアウト」リストと「ドキュメント・コールアウト」リストの両方に表示され、選択できます。混乱を回避するには、トランスポート・コールアウトの作成時にタイプがわかる名前を付けて、「ドキュメント・コールアウト」リストから選択しないようにしてください。

5.2.2 ドキュメント・コールアウト

ドキュメント・コールアウトは、同じメッセージ書式を使用していないエンドポイント間で通信を行うために使用されます。たとえば、リモート・エンドポイントがHL7 2.3.1 XML書式のメッセージをホスト・エンドポイントに送信するとします。ホスト・エンドポイントはHL7 2.5 XML書式メッセージを使用しています。

2つの異なる書式間での通信を可能にするには、次のように2つのコールアウトを作成します。

- たとえば、1つ目のコールアウトcallout_inboundによって、リモートのメッセージがホスト・エンドポイントで認識される書式に変換されます。これに対して、ホスト・エンドポイントは、HL7 2.5 XML書式の発注受入れメッセージを使用して、リクエスト・メッセージに応答します。

- たとえば、2つ目のコールアウトcallout_outboundでは、HL7 2.5 XML書式がリモート・エンドポイントのためにHL7 2.3.1 XML書式のメッセージに戻されます。

これら2つのコールアウトを、次のように2つのエンドポイントに関連付けます。

- callout_outboundは、アウトバウンド・メッセージのエンドポイント(メッセージ・リクエストを送信するエンドポイント)に関連付けます。

- callout_inboundは、インバウンド・メッセージのエンドポイント(メッセージ受入れを応答するエンドポイント)に関連付けます。

ドキュメント定義はエンドポイントのコンポーネントであるため、コールアウトは特定のドキュメント定義に関連付けられます。

この例は、1つのコールアウトから1つのエンドポイントへの単純なアソシエーションを示しています。しかし、実際には、1つ以上のコールアウト・パラメータの値を変更することによって、同じコールアウトを多数の異なるエンドポイントにインクルードできます。パラメータを追加する場所については、図5-4を参照してください。パラメータ属性のリストは、表5-2を参照してください。

5.3 コールアウトの作成

コールアウトを作成するには、図5-4に示すように、コールアウトの詳細(ライブラリ名と実装クラス名)を指定します。

注意:

外部コールアウト・ライブラリJARファイルからコールアウトを作成するには、5.1.1項「コールアウト・ライブラリJARファイルの作成」を参照してください。

図5-3 コールアウトの作成

コールアウトを作成するには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。

2. 「デザイナ」タブ→「構成」→「コールアウト」をクリックします。

3. 「作成」アイコン(プラス記号)をクリックして、「コールアウトの作成」ダイアログを表示します。

4. コールアウトの名前を入力します。
(トランスポート・コールアウトを作成しているかどうかは、名前で示すことができます。)

5. 表5-1の説明に従って、コールアウトの詳細を入力します。

6. 「OK」をクリックします。

表5-1に、指定するコールアウトの詳細を示します。

表5-1 コールアウトの詳細

フィールド

説明

Jarファイル名

コールアウト実装クラスを含むライブラリ名を選択します。

注意: 独自のコールアウトJARファイルを1つ以上指定する場合は、ディレクトリの場所を指定する必要があります。「管理」リンクの「設定」の下の「ランタイム」リンクを使用します。Oracle Healthcareに付属するデフォルトのb2b.jarファイルのディレクトリの場所を指定する必要はありません。

コールアウト・ライブラリを環境間で移行するには、手動で行う必要があります。Oracle SOA Suite for healthcare integrationのエクスポートおよびインポート機能では、コールアウト・ライブラリJARは移行されません。

実装クラス

実装クラス名を選択します。

注意: Oracle SOA Suite for healthcare integrationには、XML間のトランスフォーメーションに使用できるXSLTCalloutImplという事前定義クラス・ファイルがあります。

注意:

エンドポイントにインクルードされているコールアウトは削除できません。

コールアウトを作成したら、図5-4に示すようにタイムアウト値とオプション・パラメータを指定して構成できます。

図5-4 コールアウトの構成

コールアウト・パラメータは、グローバル変数の概念に似ており、特定のコールアウト使用にのみ適用可能なローカル値を指定できます。また、作成したコールアウト・パラメータは、すべてのコールアウト使用に適用可能なデフォルト値として指定できます。既存のコールアウトのコールアウト・パラメータを変更すると、そのコールアウトを使用するすべてのエンドポイントに影響を与えます。

表5-2に、オプションのコールアウト・パラメータ属性を示します。

表5-2 コールアウト・パラメータの属性

フィールド

説明

名前

パラメータ名を入力します。

タイプ

「整数」、「浮動小数」、「文字列」、「ブール」、「日付」の中から選択します。「日付」タイプの書式はMM/DD/YYYYです。

注意: タイプを変更すると、パラメータのデフォルト値が無効になることがあります。

値

値を入力します。「暗号化」が「True」に設定されている場合、この値は暗号化されます。

必須

「True」または「False」を選択します。

暗号化

「True」または「False」を選択します。

説明

説明を入力します(オプション)。

作成したコールアウトは、エンドポイントへのインクルードが可能になります。詳細は、5.4項「エンドポイントへのコールアウトのインクルード」を参照してください。エンドポイントへのデプロイ後にコールアウトを変更した場合は、サーバーを再起動する必要があります。

5.4 エンドポイントへのコールアウトのインクルード

作成したコールアウトは、エンドポイントへのインクルードが可能になります。

コールアウトをエンドポイントにインクルードするには:

1. 「構成」タブでエンドポイントをダブルクリックして開きます。

2. 図5-5に示すように、メッセージのタイプ(インバウンドまたはアウトバウンド)に応じて、「送信」または「受信」のセクションの「ドキュメント・コールアウト」リストからコールアウト名を選択します。

図5-5 エンドポイントとコールアウトの関連付け

3. 「適用」をクリックします。

6 マップセットの操作

この章では、Oracle SOA Suite for healthcare integrationでマップセットを操作する方法について説明します。ソースおよびターゲット・システムのメッセージが異なるドキュメント定義で定義され、あるメッセージから別のメッセージにデータをマップする必要がある場合は、マップセットを使用してマッピング・ロジックを定義できます。

内容は次のとおりです。

- 6.1項「マップセットの概要」

- 6.2項「マップ・ファイルの作成」

- 6.3項「Oracle B2Bコンソールでのマップセットの使用」

- 6.4項「Oracle SOA Suite for Healthcare Integrationでのマップセットの使用」

6.1 マップセットの概要

マップセットは、ネイティブ形式からXML、XMLからXML、さらにXMLからネイティブ形式にマッピングする標準変換よりも、ネイティブ・データ形式をネイティブ・データ形式にマップする方がよい場合にデータ変換を提供します。異なるドキュメント定義によって定義されているメッセージ間でデータをマップする必要がある場合は、マップセットを使用できます。たとえば、HL7 2.3.1形式でメッセージを送信するシステムがあり、受信側システムではHL7 2.5形式のデータを必要とする場合があります。または、HIPAA 4010メッセージをHIPAA 5010に変換し、さらにHIPAA 4010に再変換することが必要な場合があります。

マップセットには、事前定義済またはユーザー定義のマップ・ファイルと2つのドキュメント定義が含まれます。マップ・ファイルは、データがある形式から別の形式に変換される方法を定義します。現在、Oracle SOA Suite ヘルスケア統合ユーザー・インタフェースでは、異なるバージョンのHL7メッセージ間のマッピングをサポートしています。Oracle B2Bコンソールでは、異なるHIPAA X12メッセージ間のマッピングと、異なるバージョンのHL7間のマッピングをサポートしています。

注意:

現在、マップセットを使用したHL7 2.xメッセージからHL7 v3.0への変換はサポートされていませんが、この操作はOracle JDeveloperのXSLTマッパーを使用して行うことができます。

6.1.1 マップセットについて

マップセットを作成する場合は、マップ・ファイル、ソース・ドキュメント定義およびターゲット・ドキュメント定義を1つのマップセット内で関連付けます。マップセットは、定義とマッピングを、複数のOracle B2Bまたはhealthcare integrationアプリケーションで再利用できる1つの単位にグループ化します。各マップセットは2つの異なるドキュメント定義を使用し、マップセットを作成するにはこれらの定義を設計時リポジトリに作成する必要があります。マップセットには、プロトコルごとに提供されるデフォルトのドキュメント定義、あるいは作成または変更したカスタマイズ済定義を使用するオプションがあります。

Oracle SOA Suite for healthcare integrationでマップセットを作成する場合は、適切なエンドポイントに関連付けて、マッピング・ロジックをhealthcare integrationプロジェクトに組み込みます。Oracle B2Bでマップセットを作成する場合は、取引パートナ・アグリーメントに関連付けます。マップセットをエンドポイントまたはアグリーメントに関連付ける場合は、ドキュメント定義とメッセージ・フローがエンドポイントまたはアグリーメントと一致するマップセットのみ選択できます。

6.1.2 定義済マップセットとカスタム・マップセット

Oracle SOA Suite for healthcare integrationでは、Oracle Document EditorのMapBuilder機能を使用するかEdifecsが提供している事前定義済マップ・ファイルを購入することで、独自のカスタム・マップセットを作成できます。構築済マップには、HIPAA 4010メッセージをHIPAA 5010メッセージに変換するマップなど、Health Insurance Portability and Accountability Act (HIPAA)用のマップが含まれます。

6.2 マップ・ファイルの作成

Oracle SOA Suite for healthcare integrationユーザー・インタフェースまたはOracle B2Bコンソールでマップセットを作成する前に、2つのタイプのドキュメント定義間のマッピングを定義するマップ・ファイルが必要です。Edifecsには使用できる事前定義済マップ・ファイルがいくつか用意されています。またはOracle Document EditorのMapBuilderコンポーネントを使用してファイルを作成できます。

注意:

Oracle Document Editorは、Oracle SOA Suite for healthcare integrationのインストール・パッケージからダウンロードできます。

詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドのファイルの作成のガイドラインを参照してください。

6.3 Oracle B2Bコンソールでのマップセットの使用

HL7以外のデータ標準をマップするためのマップセットを作成する場合、または、healthcare integration機能ではなくOracle B2Bの機能を使用してマップセットを作成する場合は、Oracle B2Bコンソールを使用します。この機能を使用すると、たとえば、HIPAA 4010メッセージ・タイプをHIPAA 5010にマップできます。Oracle B2Bを使用してHL7メッセージをマップすることもできますが、Oracle SOA Suite for healthcare integrationのほうを使用することをお薦めします。

次の手順を実行して、マップセットをOracle B2B取引パートナ・アグリーメントに組み込みます。

- 0 「Oracle B2Bコンソールでのマップセットの作成」

- 0 「マップセットと取引パートナ・アグリーメントの関連付け」

- 0 「Oracle B2Bコンソールでのマップセットの削除」

6.3.1 Oracle B2Bコンソールでのマップセットの作成

この手順を開始する前に、Oracle B2Bコンソールにアクセスするコンピュータでマップ・ファイルが使用可能であることと、マッピングする両方の標準に必要なドキュメント定義がOracle B2Bですでに作成されていることを確認します。この3つのコンポーネントがないと、マップセットを作成できません。

Oracle B2Bでのドキュメント定義の使用の詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドのドキュメント・プロトコルの使用に関する項を参照してください。

マップセットを作成するには

1. Oracle B2Bコンソールで「管理」をクリックし、それから「マップセット」タブをクリックします。

図6-1 Oracle B2Bコンソールのマップセット・ページ

2. マップセット・ページで、「マップセットの追加」(プラスのアイコン)をクリックします。
マップセット・リストに新しい行が表示されます。

3. 新しい行で、新しいマップセットの名前と簡単な説明を入力します。

4. 「マップ・ファイルの場所」フィールドの横にある「参照」をクリックします。

5. マップ・ファイルの場所を参照し、ファイルを選択して「開く」をクリックします。
選択したマップ・ファイルがロードされ、「ソース・ドキュメント定義」および「ターゲット・ドキュメント定義」フィールドに、マッピングのための適切なドキュメント定義が移入されます。

図6-2 Oracle B2Bコンソールで定義されたマップセット

注意:

Oracle B2Bにドキュメント定義が存在していない場合、この手順は失敗します。

6. 表示される確認ダイアログで「保存」、「OK」をクリックします。

6.3.2 マップセットと取引パートナ・アグリーメントの関連付け

マッピングをB2B処理ロジックに組み込むため、マップセットを取引パートナ・アグリーメントに関連付けます。取引パートナ・アグリーメントの使用の詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの取引パートナ・アグリーメントの作成およびデプロイに関する項を参照してください。

開始する前に:

必要なすべてのB2BコンポーネントがOracle Fusion Middleware Oracle B2Bユーザーズ・ガイドに説明されているとおりに作成および構成されていることを確認します。少なくとも、ドキュメント定義、取引パートナおよびマップセットについて確認します。

マップセットを取引パートナ・アグリーメントに関連付けるには:

1. Oracle B2Bコンソールで、右上の「パートナ」を選択します。
パートナ・ページが表示されます。

2. 左側の「パートナ」パネルで、リモート取引パートナの名前を選択し、「アグリーメント」パネルで「新規アグリーメントの作成」アイコンをクリックします。
アグリーメント・ページが表示されます。

3. 「変換」を選択解除します。

注意:

「変換」が選択されている場合は、エンドポイントのマップセットとともに使用するときに無視されます。マップセットがデータ変換を実行するため、変換は不要です。

4. 取引パートナおよびアグリーメントのドキュメント定義を選択します。ドキュメント定義では、取引パートナとの交換で使用するネイティブ形式を選択します。

5. 「マップセット」フィールドをクリックし、このアグリーメント用に作成したマップセットを選択します。

図6-3 Oracle B2Bのマップセット・ページ

注意:

マップセットを使用するときに、選択したドキュメント定義がマップセット内でソースとターゲットのどちらになるかは、アグリーメントでのメッセージ・フローの方向によって決まります。上記の画像はアウトバウンド・メッセージを示しているため、選択したドキュメント定義(HIPAA 5010 837)がマップセットのターゲット・ドキュメント定義となり、HIPAA 4010 837メッセージがHIPAA 5010 837メッセージにマップされます。

6. 選択したマップセットの情報を表示するには、「マップセット詳細」をクリックします。
マップセットのサマリー情報を示すダイアログが表示されます。

図6-4 「マップセット詳細」ダイアログ

7. Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの取引パートナ・アグリーメントの作成およびデプロイに説明されているとおりにアグリーメントを構成します。

8. アグリーメントの構成が終了したら、「保存」をクリックし、表示された確認ダイアログで「OK」をクリックします。

9. アグリーメントを検証するには、「検証」をクリックします。

10. アグリーメントをアプリケーション・サーバーにデプロイする準備が整ったら、「デプロイ」をクリックします。

6.3.3 Oracle B2Bコンソールでのマップセットの削除

現在アグリーメントで使用されていないマップセットのみ削除できます。

Oracle B2Bコンソールでマップセットを削除するには:

1. Oracle B2Bコンソールで「管理」をクリックし、それから「マップセット」タブをクリックします。

2. マップセット・ページで、削除するマップセットを含む行を選択します。

3. 「マップセット」表で「マップセットの削除」(Xアイコン)をクリックし、「削除の確認」ダイアログで「はい」をクリックします。

4. 確認ダイアログで「OK」をクリックします。

6.4 Oracle SOA Suite for Healthcare Integrationでのマップセットの使用方法

ヘルスケア統合プロジェクト内で異なるHL7標準間をマップする場合は、Oracle SOA Suite for healthcare integrationユーザー・インタフェースを使用します。

次の手順を実行して、マップセットをOracle B2B取引パートナ・アグリーメントに組み込みます。

- 0、「ヘルスケア統合ユーザー・インタフェースでのマップセットの作成」

- 0、「マップセットとエンドポイントの関連付け」

- 0、「ヘルスケア統合ユーザー・インタフェースでのマップセットの削除」

6.4.1 Healthcare Integrationユーザー・インタフェースでのマップセットの作成

最初に、ヘルスケア統合ユーザー・インタフェースにアクセスしているコンピュータでマップ・ファイルが使用可能であることと、マッピングする両方の標準に必要なドキュメント定義がOracle SOA Suite for healthcare integrationですでに作成されていることを確認します。この3つのコンポーネントがないと、マップセットを作成できません。

Oracle SOA Suite for healthcare integrationでのドキュメント定義の作成の詳細は、第3章「ドキュメント・タイプおよびドキュメント・プロトコルの操作」を参照してください。

マップセットを作成するには

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「構成」タブをクリックします。

2. 左側のナビゲーション・パネルで、「マップセット」を選択し、「マップセットの作成」(プラス記号のアイコン)をクリックします。
「マップセットの作成」ダイアログが表示されます。

3. マップセットの一意の名前と短い説明を入力し、「OK」をクリックします。

図6-5 「マップセットの作成」ダイアログ

マップセット・ページが表示されます。

4. 「マップセット・ファイルの場所」フィールドの横の「参照」をクリックし、使用するマップ・ファイルを参照して選択します。
ファイルが検証され、対応するドキュメント定義が見つかった場合は、ドキュメント・プロトコル、バージョンおよびタイプに関する情報がページの下部に移入されます。デフォルトのソースおよびターゲット定義ファイルが自動的に移入されます。

図6-6 Healthcare Integrationユーザー・インタフェースのマップセット・ページ

5. ドキュメント定義ファイルのデフォルト・バージョンを使用しない場合は、次の手順に従ってデフォルトのファイル選択をオーバーライドします。

1. オーバーライドする「ドキュメント定義」フィールド(「ソース」または「ターゲット」)の横で、「参照」をクリックします。

2. 「ドキュメント」ダイアログで、使用するドキュメント定義が表示されるまで「ドキュメント・プロトコル」ツリーを展開します。

3. オーバーライドするドキュメント定義を選択し、「OK」をクリックします。

6. マップセット・ページで、「適用」をクリックし、表示される確認ダイアログで「OK」をクリックします。

6.4.2 マップセットとエンドポイントの関連付け

マップセットの作成後、それをエンドポイントに関連付けて、プロセスにマッピング・ロジックを含める必要があります。

マップセットをエンドポイントに関連付けるには

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「構成」タブをクリックします。

2. 左側のナビゲーション・パネルで、「エンドポイント」を展開し、マップセットに関連付けるエンドポイントをダブルクリックします。

3. マップするドキュメント・タイプの行で、「変換」を選択解除します。

注意:

「変換」が選択されている場合は、エンドポイントのマップセットとともに使用するときに無視されます。マップセットがデータ変換を実行するため、変換は不要です。

4. 同じ行で、表の一番右にある「マップセット」フィールドをクリックし、使用するマップセットを選択します。

図6-7 エンドポイントに対して選択されたマップセット

5. 「適用」をクリックし、表示される確認ダイアログで「OK」をクリックします。

6.4.3 Healthcare Integrationユーザー・インタフェースでのマップセットの削除

マップセットを削除するには、「構成」ツリーでマップセットを選択し、ツールバーの「削除」をクリックします。マップセットを右クリックし、「削除」を選択することもできます。

7 内部デリバリ・チャネルの操作

この章では、Oracle SOA Suite for healthcare integrationで内部デリバリ・チャネルを使用する方法について説明します。内部デリバリ・チャネルはバックエンド・アプリケーションとの通信のために使用されます。たとえば、healthcare integrationアプリケーションでのJMSトピックまたはキューとのメッセージの送受信などです。

この章には次のトピックが含まれます:

- 7.1項「内部デリバリ・チャネルの概要」

- 7.2項「内部デリバリ・チャネルの作成」

- 7.3項「内部デリバリ・チャネルの有効化」

- 7.4項「内部デリバリ・チャネルの削除」

- 7.5項「JMSキューを使用したメッセージの相互関連付け」

7.1 内部デリバリ・チャネルの概要

内部デリバリ・チャネルでは、外部システム(エンドポイント)から受信したメッセージの、Oracle SOA Suite for healthcare integrationからバックエンド・アプリケーション(JMSトピックおよびキューなど)への配信方法、あるいは外部システムに配信するためにバックエンド・システムから送信されたメッセージの、Oracle SOA Suite for healthcare integrationによる受信方法が定義されます。接続情報、トランスポート・プロトコル、確認などが定義されます。作成した内部デリバリ・チャネルはすべてのエンドポイントで使用できます。このため、エンドポイントごとに一意の内部デリバリ・チャネルを作成する必要はありません。

7.2 内部デリバリ・チャネルの作成

メッセージを内部デリバリ・チャネルに送信する必要がある場合は、送信用の内部デリバリ・チャネルを作成してエンドポイントに関連付けます。内部デリバリ・チャネルからメッセージを受信する必要がある場合は、受信用の内部デリバリ・チャネルを作成します。

内部デリバリ・チャネルを作成するには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブ→「管理」タブを選択します。

2. 次のいずれかを行います:

- JMSまたはキューにメッセージを送信するための内部デリバリ・チャネルを作成するには、「内部に送信」を右クリックして「作成」をクリックします。

- JMSまたはキューからメッセージを受信するための内部デリバリ・チャネルを作成するには、「内部から受信」を右クリックして「作成」をクリックします。

「作成」ダイアログが表示されます。

図7.1 内部デリバリ・チャネルの「作成」ダイアログ(送信)

3. 「作成」ダイアログの次のフィールドを入力します。

表7-1 新しい内部デリバリ・チャネルのプロパティ(送信)

プロパティ

説明

名前

デリバリ・チャネルの一意の名前。

トランスポート・プロトコル

内部デリバリ・チャネルの接続プロトコル。JMSはサポートされるプロトコルです。

接続先名

Oracle SOA Suite for healthcare integrationがメッセージを送信するトピックまたはキューのJNDI名。

コネクション・ファクトリ

コネクション・ファクトリのJNDIロケーションまたはJavaクラス名を入力します(jms/b2b/B2BQueueConnectionFactoryなど)。

4. 「OK」をクリックします。
新しい内部デリバリ・チャネルが「管理」ツリーの「内部に送信」に追加され、新しいチャネルが内部デリバリ・チャネル・ページに表示されます。

図7.2 内部デリバリ・チャネル・ページ

5. 内部デリバリ・チャネルのメイン・ページでは、表7-1に示すすべてのフィールドを変更できます(「トランスポート・プロトコル」を除く)。

注意:

内部デリバリ・チャネル・ページの上部のフィールド(「確認モード」、「再試行間隔」および「再試行数」)は、内部デリバリ・チャネルでは現在使用されていません。

6. トランスポート・プロトコルの接続設定を変更するには、次を行います。

1. 内部デリバリ・チャネルのメイン・ページで「トランスポート・プロトコル」をクリックします。

2. 「トランスポート・プロトコル・パラメータ」ダイアログの「標準」タブをクリックし、表7-2に示す任意のプロパティを変更します。

表7-2 内部デリバリ・チャネルのトランスポート・プロトコル標準パラメータ

パラメータ

説明

接続先名

Oracle SOA Suite for healthcare integrationがメッセージを送信するトピックまたはキューのJNDI名。

コネクション・ファクトリ

コネクション・ファクトリのJNDIロケーションまたはJavaクラス名を入力します(jms/b2b/B2BQueueConnectionFactoryなど)。

トピック

宛先が、トピックとキューのどちらであるかを示します。宛先がトピックの場合にこのオプションを選択します。

ポーリング間隔

メッセージのポーリングを試行する間隔(分単位)。

3. 「トランスポート・プロトコル・パラメータ」ダイアログの「詳細」タブをクリックし、表7-3に示す任意のプロパティを変更します。

表7-3 内部デリバリ・チャネルのトランスポート・プロトコル詳細パラメータ

パラメータ

説明

メッセージ・タイプ

JMSメッセージ・タイプ・オプション「バイト」、TEXTまたはMAPから1つを選択します。

ペイロードのみマップ

javax.jms.MapMessageタイプのJMSメッセージの一部として、ペイロードのみを送信することを示します。

JMS IDの使用

JMSメッセージIDをヘルスケア統合メッセージIDとして使用するかどうかを示します。その結果、JMSレベルで相関が容易になります。

接続先プロバイダ

ターゲット・サーバーへの接続に必要なJNDIプロパティ。キー/値ペアのセパレータとしてセミコロン(;)を使用します。これは、Oracle SOA Suite for healthcare integrationが、リモート・サーバーのJMSキューまたはトピックに接続できるようにするためです。

ユーザー名

ターゲット・サーバーに接続するためのユーザー名。この値はJMSではオプションです。Oracle SOA Suite for healthcare integrationは、構成されたJNDIデータソースを使用してキューに接続できるためです。

パスワード(およびパスワードの再入力)

ユーザー名に対するパスワード。

サブスクライバID

JMSがトピックと通信する場合にJMSサブスクライバIDが必要かどうかを示します。

順序付け

メッセージを順序どおりに配信する必要があるかどうかを示します。順序どおりのデリバリが必要な場合はこのチェック・ボックスを選択します。このオプションはWebLogic Server JMSのみに適用されます(WebLogic Server JMSのUnit-of-Order機能を使用します)。

7. トランスポート・プロトコルの変更の終了後に、「トランスポート・プロトコル・パラメータ」ダイアログの「OK」をクリックします。

8. 内部デリバリ・チャネルの変更の終了後に、内部デリバリ・チャネル・ページの「適用」をクリックします。

7.3 内部デリバリ・チャネルの有効化

Oracle SOA Suite for healthcare integrationプロジェクトで内部デリバリ・チャネルを使用するには、有効化する必要があります。有効化するには、内部デリバリ・チャネルをダブルクリックして内部デリバリ・チャネル・ページを開き、「有効」オプションを選択します。

7.4 内部デリバリ・チャネルの削除

内部デリバリ・チャネルを削除するには、「管理」ツリーでチャネルを選択し、ツールバーの「削除」をクリックします。または、内部デリバリ・チャネルを右クリックしてから「削除」を選択することもできます。

7.5 JMSキューを使用したメッセージの相互関連付け

JMSヘッダーにA2A=trueを設定すると、インバウンドとアウトバウンドのメッセージをJMSキューを使用して相互に関連付けすることができます。

バックエンド・アプリケーションからメッセージID (MSG_ID)が提供される場合、ヘルスケア統合出力のJMS相関IDにそのMSG_IDが設定されます。提供されない場合は、ヘルスケア統合出力のJMS相関IDにJMSメッセージIDが設定されます。

8 ダッシュボードの操作

この章では、Oracle SOA Suite for healthcare integrationのダッシュボードについて説明します。ダッシュボードには、インスタンス・データに関するエンドポイントレベルのステータスおよび量のメトリックが表示されます。これには、エンドポイントのステータス、メッセージ数、順序付け情報およびエラー・メッセージが含まれます。

この章には次のトピックが含まれます:

- 8.1項「ダッシュボードの概要」

- 8.2項「システム・ダッシュボードの操作」

- 8.3項「ダッシュボードの作成および構成」

- 8.4項「ダッシュボードでの情報の表示」

- 8.5項「順序付けされたメッセージの使用」

- 8.6項「エンドポイント・エラー・メッセージの表示」

8.1 ダッシュボードの概要

Oracle SOA Suite for healthcare integrationのダッシュボードには、healthcare integrationアプリケーション内のエンドポイントの現在の状態に関する情報が表示されます。必要に応じて複数のダッシュボードを作成および構成し、定義したエンドポイントのステータスおよび量のメトリックを監視できます。

ランタイム・インスタンス・データのパージ、処理された新規メッセージ、新規エラー・メッセージなど、ランタイム・リポジトリ内で発生する変更が、「ダッシュボード」タブに反映されます。様々な時間間隔のデータを表示し、手動でリアルタイムにデータをリフレッシュすることや、設定した間隔で自動リフレッシュするようにダッシュボードを設定できます。利用可能な時間間隔は、「管理」タブのUI設定で構成可能です。

「表示モード」オプションの「圧縮」および「標準」に基づいて初めてダッシュボードを開くと、ダッシュボードに含まれるすべてのエンドポイントのサマリーが表示されます。エンドポイントごとに、ステータスおよびメッセージ量のみでなく、エンドポイントの構成に関する詳細な情報も表示できます。図8-1に、ダッシュボード・ページに標準モードで表示されるエンドポイントのサマリーを示します。

図8-1 ダッシュボードのエンドポイント・サマリー

「圧縮」オプションをクリックして、ダッシュボードを圧縮モードで表示できます。圧縮モードでは、各エンドポイントのステータスと名前に対応する色で塗りつぶされた小さいボックスのみが表示されます。必要なだけ収まるように圧縮ボックスの幅を調整することもできます。スペースを節約するために時間範囲をアイコン化すると、時間範囲スライダ・アイコンの上にマウスを置いたときに自動的に再表示されます。「カスタマイザの表示」トグル・ボタンは、カスタマイザが開いているかどうかに関係なく、常にダッシュボードに表示されます。

図8-2に、圧縮モードでのダッシュボード・ページを示します。

図8-2 ダッシュボード・ページ - 圧縮モード

8.2 システム・ダッシュボードの操作

Oracle Healthcareコンソールには、healthcare設定ステータスのグローバル・ビューを示すシステム・ダッシュボードという機能があります。これには、モニタリングのためのエンドポイントと内部デリバリ・チャネルの全体ビューが含まれます。システム・ダッシュボードには、有効または無効なエンドポイントのリスト、およびこれらのエンドポイントがリッスンするポート(該当する場合)を表示できます。また、ダッシュボードにはメッセージ数も表示されます。システム・ダッシュボードでは、トランスポート・プロトコル、アウトバウンドおよびインバウンド、または両方でエンドポイントをグループ化またはソートすることもできます。

システム・ダッシュボードを使用すると、デプロイされたhealthcareコンポジットを表示できます。内部デリバリ・チャネルとコンポジットはシステム概要の内側を表すため、これは重要です。システム・ダッシュボードを使用してエンドポイントとチャネルを有効または無効にすることもできます。メッセージ統計および全体的な最新エラー・リストについてのセクションで、システム・ダッシュボードは完成します。

システム・ダッシュボードを表示するには、まず「ダッシュボード」タブの右上のプラス・アイコンをクリックし、次に「システム・ダッシュボード」をクリックします。

図8-3は、システム・ダッシュボードのサンプルを示しています。

図8-3 システム・ダッシュボードのサンプル

8.2.1 システム・ダッシュボードの様々なセクションを使用したシステム・データの表示

「システム・ダッシュボード」のセクションでは、Oracle Healthcareインスタンスに関連する様々なタイプのシステム・データを表示できます。

表8-1に、システム・ダッシュボードの様々なセクションを一覧表示します。

表8-1 システム・ダッシュボードのセクション

セクション名

説明

スライダ

システム・ダッシュボード・ページの上部にある時間スライダを使用して、ダッシュボードのグラフと表のためにデータを収集する時間間隔を選択できます。

開始ポイントからスライドして、必要な時間間隔を選択します。

リフレッシュ

ダッシュボードの右上にある「リフレッシュ」コンポーネントにより、ページを手動でリフレッシュしたり、自動リフレッシュ間隔を設定できます。

自動リフレッシュを有効にするには、「リフレッシュ」アイコンの隣にある下矢印をクリックし、「自動リフレッシュ」チェック・ボックスを選択して、自動リフレッシュ間隔を秒単位で指定します。

最もアクティブなドキュメント

このグラフには、最もアクティブなドキュメント定義(一度に最大3つのドキュメント定義)および各ドキュメント定義に関連付けられているメッセージ数が表示されます。

最もアクティブなエンドポイント

このグラフには、最もアクティブなドエンドポイント(一度に最大3つのエンドポイント)および各エンドポイントに関連付けられているメッセージ数が表示されます。

最新のエラー・トレンド

このグラフには、エラー発生時刻に対してマップされた、特定のOracle Healthcareセットアップのエラー数が表示されます。

「エンドポイント」表

「エンドポイント」表には、Oracle Healthcareシステム内のすべてのエンドポイントのリストと、各エンドポイントに関連付けられているステータス、トランスポート・プロトコル、メッセージ数、キュー数が表示されます。

この表では、次のアクションを実行できます。

- 「表示」ボタンをクリックして表に表示する列数(名前、ステータス、トランスポート・プロトコルなど)を構成するか(「表示」>「列」および必要なオプションをクリックして)、「エンドポイント」表をシステム・ダッシュボードから新しいウィンドウに連結解除します(「表示」>「連結解除」をクリックして)。

- 複数のエンドポイントを選択し、「有効化」または「無効化」ボタンをクリックして有効化または無効化します。

- 「連結解除」ボタンをクリックして、「エンドポイント」表をシステム・ダッシュボードから新規ウィンドウに連結解除します。

- 「検索」フィールドでエンドポイント名の文字をいくつか含む文字列を指定して、既存のエンドポイントをフィルタ処理します。

- エンドポイント名をクリックすると、エンドポイントの詳細が表示されたダッシュボード・タブが開きます。

- インバウンドまたはアウトバウンド・メッセージのメッセージ数をクリックすると、関連するすべてのメッセージが表示された「レポート」タブが開きます。

- 任意の列見出しに基づいてエンドポイントをソートします。

「内部デリバリ・チャネル」表

「内部デリバリ・チャネル」表には、Oracle Healthcareシステム内のすべて内部デリバリ・チャネルのリストと、各チャネルに関連付けられているステータス、トランスポート・プロトコルおよびデリバリが表示されます。ここでは、チャネルは「配信」列に値trueまたはfalseとともにリストされ、内部デリバリ・チャネル(「配信」列にtrueと表示されます)か内部リスニング・チャネル(「配信」列にfalseと表示されます)かが区別されます。

この表では、「エンドポイント」表で実行できるアクションと同様のアクションを実行できます。

「コンポジット」表

「コンポジット」表には、Oracle Weblogic ServerにデプロイされているOracle Healthcare関連コンポジットのリストが、コンポジットのステータスとともに表示されます。

「表示」ボタンをクリックして表に表示する列数を構成するか、コンポジット・ウィンドウを連結解除します。

8.3 ダッシュボードの作成および構成

ダッシュボードのツールを使用すると、定義したエンドポイントの任意の組合せのダッシュボードを作成できます。ダッシュボード・ページのレイアウトの構成、リフレッシュ・レートの指定および既存のダッシュボードのエンドポイントの変更を行うことができます。

8.3.1 ダッシュボードの作成

Oracle SOA Suite for healthcare integrationでは、単一のエンドポイントまたは複数のエンドポイントの組合せに対して、複数のダッシュボードを作成できます。

注意:

エンドポイントが定義されている場合、定義されたすべてのエンドポイントを含む「すべてのエンドポイント」と呼ばれる標準ダッシュボードを利用できます。この標準ダッシュボードを変更して変更内容を保存することはできません。

ダッシュボードを作成するには

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「ダッシュボード」タブをクリックします。
ダッシュボード・メイン・ページが表示されます。

図8-4 ダッシュボード・メイン・ページ

2. 右上隅のプラス・アイコンをクリックして、「ダッシュボードの作成」を選択します。
「ダッシュボードの作成」ダイアログが表示されます。

図8-5 「ダッシュボードの作成」ダイアログ

3. ダッシュボードの一意の名前および説明を入力します。

4. 「使用可能なエンドポイント」で、ダッシュボードに含めるエンドポイントを選択してから、右矢印アイコンをクリックします。
選択したエンドポイントが「ダッシュボード・エンドポイント」リストに表示されます。

図8-6 エンドポイントが選択されている「ダッシュボードの作成」ダイアログ

5. 必要なエンドポイント表示モードを選択します。

6. 「作成」をクリックします。
新規ダッシュボードが開き、エンドポイントごとに、過去24時間以内に処理されたメッセージに関するサマリー情報が表示されます。

8.3.2デフォルト・ダッシュボードの選択

ダッシュボードを作成した後、「ダッシュボード」タブをクリックしたときに自動的に表示されるダッシュボードを選択できます。これがデフォルト・ダッシュボードです。デフォルト・ダッシュボードを指定していない場合は、ダッシュボード・ページを開くときに既存ダッシュボードのリストから選択できます。デフォルト・ダッシュボードを選択した場合は、ダッシュボード・ページを開くたびにこのダッシュボードが表示されます。

デフォルト・ダッシュボードを選択するには

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「ダッシュボード」タブをクリックします。

2. 「選択済みダッシュボード」フィールドの横の下矢印をクリックして、デフォルトに設定するダッシュボードを選択します。

図8-7 ダッシュボード・メイン・ページで選択されるデフォルト・ダッシュボード

3. 「適用」をクリックします。
選択したダッシュボードが表示されます。次回ログインして「ダッシュボード」タブを選択すると、このダッシュボードが自動的に表示されます。

8.3.3 既存ダッシュボードの構成

ダッシュボードを作成した後、情報を表示するエンドポイント、ダッシュボードでの情報の表示方法、および表示される情報のタイプを変更できます。

既存ダッシュボードを構成するには

1. 変更するダッシュボードがまだ表示されていない場合は、ダッシュボード・メイン・ページの右上隅にあるプラス・アイコンをクリックして、構成するダッシュボードを選択します。

2. ダッシュボードが表示されたら、「カスタマイザの表示」をクリックします。
ダッシュボードの右側にカスタマイザが表示されます。

図8-8 エンドポイント・ダッシュボード・カスタマイザ

3. 次のいずれかの操作を実行します。

- ダッシュボードの名前または説明を変更します。

- 「使用可能なエンドポイント」セクションでエンドポイントを選択し、右矢印をクリックして、そのエンドポイントを追加します。

- 「ダッシュボード・エンドポイント」セクションでエンドポイントを選択し、左矢印をクリックして、そのエンドポイントを削除します。

- 移動するエンドポイントを選択し、カスタマイザの右側にある上矢印および下矢印をクリックして、エンドポイントを並び替えます。

4. 変更し終わったら、「適用」→「非表示」の順にクリックして、カスタマイザを閉じます。

ヒント:

カスタマイザを閉じてもダッシュボードに変更が反映されない場合は、「リフレッシュ」アイコンをクリックしてください。

5. 変更を元に戻すには、「元に戻す」をクリックします。

6. ダッシュボードに表示されるメッセージのタイプを制限するには、「表示」フィールドの横の下矢印をクリックして、次のいずれかのオプションを選択します。

- すべて: すべてのタイプのメッセージを表示します。

- 実行中: 実行中のすべてのエンドポイントを表示します。アイドル状態、無効およびエラーが発生しているエンドポイントは表示されません。

- エラー: エラー・メッセージのみ表示します。

- 無効: 無効なエンドポイントのみ表示します。

図8-9 ダッシュボード・ページの「表示」フィールド

7. ダッシュボードに表示されるエンドポイントのレイアウトを変更するには、「列」フィールドに表示されている列の数を変更します。

注意:

ダッシュボードに表示される列の数を変更した場合、ログアウトしてから再びログインしたときに新しい値は保持されません。

8.3.4 ダッシュボードのリフレッシュおよび自動リフレッシュ・レートの設定

ダッシュボードはいつでも手動でリフレッシュできますが、設定した間隔で自動的にダッシュボードが更新されるように指定することもできます。

ダッシュボードのリフレッシュおよび自動リフレッシュ・レートの設定を行うには

1. 変更するダッシュボードがまだ表示されていない場合は、ダッシュボード・メイン・ページの右上隅にあるプラス・アイコンをクリックして、構成するダッシュボードを選択します。

2. ダッシュボードをリフレッシュするには、右上隅にある「リフレッシュ」アイコンをクリックします。

3. 自動リフレッシュ・オプションを有効にするには、次のようにします。

1. 「リフレッシュ」アイコンの右側にある下矢印をクリックします。

2. ダッシュボードを自動的にリフレッシュする時間間隔を秒単位で指定してから、「自動リフレッシュ」を選択します。

3. 自動リフレッシュを無効にするには、「自動リフレッシュ」チェック・ボックスの選択を解除します。

8.3.5 ダッシュボードの削除

作成した任意のダッシュボードを削除できます。ダッシュボードを削除する場合は、注意が必要です。この操作は元に戻すことができません。

ダッシュボードを削除するには

1. ダッシュボード・メイン・ページから、右上隅にあるプラス・アイコンをクリックして、「ダッシュボードの削除」を選択します。
「ダッシュボードの削除」ダイアログが表示されます。

図8-10 「ダッシュボードの削除」ダイアログ

2. ダッシュボード・リストから、削除するダッシュボードの横のチェック・ボックスを選択します。

3. 「選択したダッシュボードの削除」をクリックします。
選択したダッシュボードがただちに削除されます。

8.4 ダッシュボードでの情報の表示

ダッシュボードには様々な情報が表示されます。まず、ダッシュボードにすべてのエンドポイントのサマリーを表示することから始めます。ここでは、各エンドポイントのステータス、処理されているメッセージの数およびエラーの有無をすばやく把握できます。最後のメッセージが送信または受信された時間と、最後のエラーが発生した時間も表示されます。この情報から、さらに詳細な監視が必要なエンドポイントに関するヒントを得ることができます。

また、メッセージの処理率、平均メッセージ・サイズ、送信メッセージ数または受信メッセージ数、エラー数、エラー・メッセージなど、各エンドポイントの詳細な情報を表示することもできます。さらに、ダッシュボードから直接エンドポイント・ページにアクセスして、必要に応じてエンドポイントの構成を変更することもできます。

8.4.1 ダッシュボードでのエンドポイント・サマリー情報の表示

ダッシュボードには複数のビューがあり、各ビューからドリルダウンして、特定のエンドポイント、エラーまたはメッセージに関するより詳細な情報を表示できます。

エンドポイントのサマリー情報を表示するには

1. ダッシュボード・メイン・ページで、プラス・アイコンをクリックしてから表示するダッシュボードを選択します。エンドポイントごとに、次の情報を表示できます。

図8-11 ダッシュボードのエンドポイント・サマリー

- ステータス: 「実行中」、「アイドル」、「無効」、「エラー」など、エンドポイントの現在のステータス

- 送信メッセージ: 指定した時間間隔内にエンドポイントによって送信されたメッセージの数

- 受信メッセージ: 指定した時間間隔内にエンドポイントによって受信されたメッセージの数

- エラー: 指定した時間間隔内のエンドポイントのエラー・メッセージの数

- 最後の送信: エンドポイントからの最後のメッセージが送信された日時

- 最後の受信: エンドポイントからの最後のメッセージが受信された日時

- 最後のエラー: エンドポイントの最後のエラーの日時

2. ダッシュボードに情報が表示される時間間隔を変更するには、ページの左側にあるタイム・スケールのポインタを上下にスライドさせます。

図8-12 ダッシュボード情報のタイム・スケールのスライド

3. 特定のエンドポイントのプロパティを表示するには、そのエンドポイントの情報アイコンをクリックするか、情報アイコンの上にマウス・カーソルを置きます。(クリックした場合は、情報を含むポップアップ・ウィンドウが開き、マウス・カーソルを置いた場合は、情報アイコンの上にカーソルがある間のみ情報が表示されます。)
「エンドポイント・プロパティ」ダイアログが表示され、エンドポイントのプロトコル、接続、ポーリング、タイムアウトおよび順序付けのプロパティを確認できます。

図8-13 ダッシュボードからアクセスした「エンドポイント・プロパティ」ダイアログ

エンドポイントで着信と発信の両方の処理を定義してある場合、プロパティ・ダイアログには2つのタブが表示され、片方に着信のプロパティ、もう片方に発信のプロパティが表示されます。着信と発信のステータスが異なる場合、ステータスに関する追加情報がプロパティ・ダイアログに表示されます。

図8-14 双方向エンドポイントの「エンドポイント・プロパティ」ダイアログ

エンドポイント・プロパティの詳細は、第4章「エンドポイントの操作」を参照してください。

8.4.2 ダッシュボードでの詳細なエンドポイント情報の表示

エンドポイントのサマリー表示から、メッセージ処理率、メッセージ・タイプ(送信済、受信済またはエラー)別のメッセージ量、平均メッセージ・サイズなど、特定のエンドポイントの詳細情報にドリルダウンできます。エラーの追加情報も表示できます。

詳細なエンドポイント情報を表示するには

1. 目的のダッシュボードをダッシュボード・ページに表示します。

2. 特定のエンドポイントのより多くのエンドポイント詳細の表示(エンドポイント・ボックスの右端にあるアイコン)をクリックします。
エンドポイントの詳細ページが表示されます。

図8-15 ダッシュボードのエンドポイントの詳細ページ

3. 表示されているデータの時間間隔を変更するには、ページ上部にあるタイム・スケールのスライダを左右に動かします。

4. エンドポイントの量のメトリックを、(前述のような)ゲージとして、または表形式で表示できます。「ゲージ」または「表」(「表示」の横)のいずれかを選択します。
ゲージと表の両方に次の情報が表示されます。

- ドキュメント・タイプ。

- 受信済メッセージ数/秒。

- 指定した時間間隔内に処理されたメッセージの総数。

- 各メッセージの平均サイズ。

5. 下にスクロールすると、送信済メッセージ、受信済メッセージおよびエラー・メッセージの量を示すグラフが表示されます。

図8-16 メッセージ量のグラフィカル表示

6. グラフの下までスクロールすると、順序付けされたメッセージの処理に関する情報が表示されます。

図8-17 ダッシュボードの「順序メッセージ」セクション

ヒント:

順序付けターゲットを構成していない場合は、順序付けに関する情報をダッシュボードに表示できません。順序付けの構成の詳細は、4.4項「MLLPエンドポイントの順序付けの有効化」を参照してください。

7. ページの一番下までスクロールすると、表示されているエンドポイントのエラー・メッセージが表示されます。

8. 処理されたメッセージのレポートを表示するには、ゲージまたは表のいずれかの眼鏡のアイコンをクリックします。「過去24時間のメッセージ処理の概要」ボックスにある眼鏡のアイコンをクリックする方法でも、レポートを表示できます。どちらの操作でも、新しいタブが開いてレポートが表示されます。

図8-18 ダッシュボードからアクセスしたエンドポイント・レポート

レポートおよび表示される情報の詳細は、第9章「レポートの作業」を参照してください。

8.4.3 ダッシュボードからのエンドポイントの構成

ダッシュボードから直接エンドポイントの構成ページにアクセスして、エンドポイント・プロパティを表示および編集できます。

ダッシュボードからエンドポイントを構成するには

1. 目的のダッシュボードをダッシュボード・ページに表示します。

2. 構成するエンドポイントのボックスで、「このエンドポイントの構成」(レンチのアイコン)をクリックします。
エンドポイント・ページが表示されます。

3. エンドポイントの操作の説明に従って、任意のエンドポイント値を変更します。

注意:

この操作により、ダッシュボード・ページの外に移動します。表示していたダッシュボードに戻るには、「ダッシュボード」タブをクリックします。

8.5 順序付けされたメッセージの使用

エンドポイント・ダッシュボードの「順序メッセージ」セクションに、順序付けされたメッセージ・キューの状態に関する情報が表示されます。このセクションでは、順序付けされたメッセージ・キューで保留になっているメッセージの情報を表示できます。このセクションに情報がない場合、順序付けされたメッセージは正常に処理されています。メッセージがバックアップされている場合、必要な情報を表示して、キューのブロックを解除するための手順を実行できます。

表示できるキューの情報には、キュー内のメッセージの数、メッセージが順序付けされた時間、メッセージの順序付けが開始されてからの経過時間、順序付けの状態、メッセージ処理の状態およびドキュメント・タイプがあります。また、全体的なキューの配信ステータスを示すインジケータも表示されます。表示されるステータスは、次のとおりです。

- 一時停止: 赤の信号で示され、キューの先頭にあるメッセージでトランスポート・エラーが発生したときに、順序付けが手動で一時停止またはブロックされたことを意味します。

- 遅い: 黄色い信号で示され、キューの先頭にあるメッセージの経過時間が、UI設定の「順序付けの遅さのしきい値(秒)」プロパティを超えていることを意味します。

- 実行中: 緑色の信号で示され、順序付けされたメッセージが正常に処理されていることを意味します。

順序付けエラー、メッセージ・エラーまたはメッセージ処理の遅延が原因で、キュー内のメッセージがバックアップされる可能性があります。「順序メッセージ」セクションには、これらの問題の修正に必要な情報が表示されます。キュー内のメッセージに関する情報を確認して、停止の原因を特定できます。原因を特定した後、エラーが発生したメッセージを再処理したり、メッセージをキューから破棄したりできます。

順序付けされたメッセージを使用するには

1. 目的のダッシュボードをダッシュボード・ページに表示します。

2. 特定のエンドポイントの「クリックして「最大化されたエンドポイント詳細」を表示します」(エンドポイント・ボックスの右端にあるアイコン)をクリックします。
最大化されたエンドポイント詳細ページが表示されます。

3. 「順序メッセージ」セクションまで、下にスクロールします。
順序付けキューで待機しているメッセージがある場合は、ここで表示できます。

図8-19 エンドポイント・ダッシュボードの「順序メッセージ」セクション

4. 待機メッセージがノート・ボックスのカルーセルとして表示されます。ボックスを次々とクリックしていくか、またはメッセージの下にあるスライダを使用して、各メッセージの情報を表示します。

5. メッセージのレポートを表示するには、そのメッセージ・ボックスの右上隅にある眼鏡のアイコンをクリックします。
選択したメッセージのレポート・ページが表示されます。

図8-20 「順序メッセージ」セクションからアクセスしたメッセージ・レポート

6. 順序付けがメッセージによってブロックされている場合は、次のいずれかの操作を実行できます。

- 前述のとおりにメッセージ・レポートを表示し、レポート・ページの「パージ」機能または「再発行」機能を使用してメッセージを処理します。

- 「順序メッセージ」セクションで、メッセージ・ボックスの右上隅にある「エラー・メッセージを再処理します。」アイコンをクリックして、エラーが発生したメッセージを再処理します。

- 「順序メッセージ」セクションで、メッセージ・ボックスの右上隅にある「メッセージの破棄」アイコンをクリックして、ブロックされているメッセージを破棄します。メッセージを破棄しても、メッセージは順序付けされたメッセージのキューから削除されるのみで、レポートに表示されるインスタンス・データからは削除されません。

7. 順序付けされたメッセージの処理を一時停止するには、「順序メッセージ」セクションの右上隅にある「一時停止」ボタンをクリックします。

8. 順序付けされたメッセージの処理を再開するには、「順序メッセージ」セクションの右上隅にある「再開」ボタンをクリックします。

8.6 エンドポイント・エラー・メッセージの表示

特定のエンドポイントのメッセージでエラーが生成された場合、ダッシュボード・ページからエラーの情報にアクセスできます。

注意:

エンドポイントでトランスポート・エラーが発生すると、エンドポイントのステータス・バーが赤色に変化し、ステータスが「エラー」に変わります。ここでは次の手順で説明されているビジネス・メッセージ処理のエラーは示されませんが、メッセージ処理エラーにはトランスポート・エラーも含まれる可能性があります。メッセージ処理エラーは、エンドポイント・サマリーの「エラー」フィールドの数で示されます。

図8-21 エラーが表示されているエンドポイント・サマリー

エンドポイント・エラー・メッセージを表示するには

1. エンドポイント・サマリー・ダッシュボード・ページで、エラーを含むメッセージがあるエンドポイントのより多くのエンドポイント詳細の表示をクリックします。

2. エンドポイント詳細ページで、ページの一番下までスクロールすると、エラー・メッセージのリストが表示されます。

図8-22 エンドポイント・エラー・メッセージ・リスト

3. エラーのレポートを表示するには、メッセージIDの右の眼鏡のアイコンをクリックします。
次のように、レポート・ページが表示されます。

図8-23 エンドポイント・エラー・メッセージ・レポート

4. エラーの詳細を表示するには、メッセージ・リストの下にある上矢印をクリックしてウィンドウの上部分を閉じるか、または「現在のメッセージ詳細を新規タブに固定」をクリックして、新規タブで詳細を開きます。
ビジネス・メッセージの詳細が表示されます。

図8-24 ビジネス・メッセージの詳細

レポートおよび表示される情報の詳細は、第9章「レポートの作業」を参照してください。

5. フロー・ダイアグラムで、エラーの発生場所を示す赤いXアイコンをクリックします。「エラーの詳細」がダイアグラムの下に表示されます。

図8-25 エンドポイントのトランスポート・エラーの詳細

9 レポートの作業

この章では、Oracle SOA Suite for healthcare integrationのレポート機能について説明します。構成可能なレポートには、ヘルスケア統合アプリケーションによるメッセージ処理のリアルタイムのステータスが、指定した条件に基づいて表示されます。

この章には次のトピックが含まれます:

- 9.1項「レポートの概要」

- 9.2項「レポートの作成および構成」

- 9.3項「レポートおよびレポート情報の表示」

- 9.4項「関連付けられていないメッセージのレポートの作業」

- 9.5項「エラー・メッセージの作業」

- 9.6項「リポジトリからのメッセージのパージ」

9.1 レポートの概要

Oracle SOA Suite for healthcare integrationのユーザー・インタフェースのレポート・ページには、Oracle Healthcareのコンポーネントで処理されるメッセージのステータスがリアルタイムで表示されます。すべてのメッセージを表示したり、様々な条件(エンドポイント、日付範囲、ドキュメント情報、およびペイロード・フィールドを含む)によって表示するメッセージを絞り込むことができます。

Oracle Healthcareのユーザー・インタフェースには、いくつかのレポートが事前に定義されています。ワイヤ・メッセージ・レポート、関連付けられていないワイヤ・メッセージ・レポート、ビジネス・メッセージ・レポート、アプリケーション・メッセージ・レポートおよび関連付けられていないアプリケーション・メッセージ・レポートがそれに当たります。さらに詳細な条件に基づいたレポートを追加で作成し、表示されるメッセージのタイプを絞り込めます。

各レポートは4つのセクションに分かれています。

- レポート構成バー

- メッセージ・リスト

- メッセージ・フローの図による表示

- 選択したメッセージのメッセージ詳細

レポートで複数のメッセージを選択すると、選択したメッセージの情報の概要がフロー・ダイアグラムのかわりに表示されます。

Oracle Healthcareには、次のレポート・タイプに基づいて事前定義済レポートのセットが用意されており、レポート・ホームページの右上端にあるプラス記号のアイコンをクリックするとアクセスできます。

- 一般ビジネス・メッセージ・レポート: 最初から、または指定された時間範囲に交換されたビジネス・メッセージがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。

- 一般アプリケーション・メッセージ・レポート: 交換されたすべてのアプリケーション・メッセージがリストされます。このレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。

- 一般ワイヤ・メッセージ・レポート: 交換されたすべてのワイヤ・メッセージがリストされます。このレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。

- 関連付けられていないアプリケーション・メッセージ・レポート: 関連付けられたビジネス・メッセージを除くアプリケーション・メッセージを表示するアプリケーション・メッセージ・レポートがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。

- 関連付けられていないワイヤ・メッセージ・レポート: 関連付けられたビジネス・メッセージを除くワイヤ・メッセージを表示するワイヤ・メッセージ・レポートがすべてリストされます。これらのレポートは、メッセージ・レポート・フィルタ・カスタマイザを使用してカスタマイズできます。

関連付けられていないメッセージ・レポートの詳細は、9.4項「関連付けられていないメッセージのレポートの作業」を参照してください。

図9-1に示すように、カスタマイズされたレポートは、Oracle Healthcareコンソールで、それぞれのレポート・タイプの下に表示されます。

図9-1 レポートのタイプ

図9-2に、「レポート」タブに表示されている一般ビジネス・メッセージ・レポートの例を示します。

図9-2 事前定義済のビジネス・メッセージ・レポートが表示されたレポート・ページ

図9-3に、「レポート」タブに表示されている一般ワイヤ・メッセージ・レポートの例を示します。

図9-3 事前定義済のワイヤ・メッセージ・レポートが表示されたレポート・ページ

図9-4に、「レポート」タブに表示されている一般アプリケーション・メッセージ・レポートの例を示します。

図9-4 事前定義済のアプリケーション・メッセージ・レポートが表示されたレポート・ページ

メッセージ・リストでは、各メッセージに、メッセージの処理情報を表すアイコンが表示されます。封筒のアイコンは通常処理を、緑色の矢印が表示された封筒のアイコンはメッセージが再発行されたことを、Xの付いた赤い四角形が表示された封筒のアイコンはエラーを示します。

9.1.1 メッセージ・レポート・フィルタ・カスタマイザについて

レポートの作成や既存レポートの編集には、3つのメッセージ・レポート・フィルタ・エディタ(ワイヤ、ビジネスおよびアプリケーション)を使用します。レポート・エディタでは、時間範囲、エンドポイント、プロトコル、状態、メッセージ・ステータス、およびドキュメント定義情報など、レポートに表示するメッセージに関して様々な条件を定義できます。また、相関フィールド、SOAコンポジット・フィールド、メッセージIDなどを含む詳細オプションも使用できます。

図9-5に、ビジネス・メッセージ・レポート・カスタマイザの例を示します。

図9-5 ビジネス・メッセージ・レポート・フィルタ・カスタマイザ

大部分のフィルタでは、フィルタに指定した値の評価方法を指定する演算子を選択する必要があります。また、検索時に大/小文字の区別をするかどうかも指定できます。ほとんどのフィルタは、指定した値に対し、「任意」、「次と等しい」、「相似」、「次と等しくない」、または「相似でない」の演算子をサポートしています。「相似」および「相似でない」演算子に関しては、値にSQLのワイルドカード文字を使用できます。SQLのワイルドカード文字には次のものが含まれます。

- % (パーセント): ゼロ字以上の任意の文字を表します。

- _ (アンダースコア): 1つの文字を表します。

- [charlist]: 文字のリストで、任意の値はリスト内のいずれかの文字です。

- [^charlist]または[!charlist]: 文字のリストで、任意の値はリスト内の文字ではありません。

ほとんどの文字列ベースの条件では、フィールドの隣の「大/小文字を区別しない」を選択または選択解除することにより、検索で大/小文字を区別するかどうかを指定できます。フィルタ条件リスト内のセクション間を移動するには、「フィルタ条件」の横にあるリンクを使用します。

9.1.2 メッセージの再発行について

メッセージのエラーがOracle SOA Suite for healthcare integrationの内部的なものである場合、問題を修正してメッセージを再送信できます。たとえば、適切に構成されていないエンドポイントにメッセージを送信した場合は、エラーを修正し、アプリケーション・メッセージまたはワイヤ・メッセージの再発行機能を使用します。

アウトバウンド・メッセージのアプリケーション・メッセージを再発行すると、メッセージがクローニングされた後、新しいメッセージのステータスがRESUBMITTEDになり、クローンの配信が試行されます。また、元のアプリケーション・メッセージのRESUBMIT_COUNTが1つ増えます。クローニングされたメッセージのRESUBMIT_REF_TOも、元のアプリケーション・メッセージのIDに設定されます。再発行されたアプリケーション・メッセージがバッチ・メッセージの一部である場合、関連付けられたワイヤ・メッセージの状態もRESUBMITTEDに設定されます。このタイプのメッセージの再発行は、ドキュメントの構成が最重要ではなく、メッセージの設定を更新して再構成する必要がある場合に役立ちます。

インバウンド・メッセージのアプリケーション・メッセージを再発行すると、メッセージのステータスがRESUBMITTEDに設定され、バックエンド・アプリケーションへのメッセージ配信が再度試行されます。このタイプのメッセージの再発行は、バックエンド・アプリケーションが停止したため配信を再試行する必要がある場合に役立ちます。

アウトバウンド・メッセージのワイヤ・メッセージを再発行すると、メッセージのステータスがRESUBMITTEDに設定され、以前に処理されたメッセージのみ再配信が試行されます。再パッケージングまたは他のメッセージ変換は実行されません。これは、問題がデリバリ・エンドポイントにある場合(受信者のサーバーが停止したためメッセージを受信できない場合など)に役立ちます。

インバウンド・メッセージのワイヤ・メッセージを再発行すると、ワイヤ・メッセージがクローニングされた後、新しいメッセージのステータスがRESUBMITTEDになり、メッセージの配信が試行されます。また、元のワイヤ・メッセージのRESUBMIT_COUNTが1つ増えます。クローニングされたメッセージのRESUBMIT_REF_TOも、元のワイヤ・メッセージのIDに設定されます。ビジネス・メッセージおよびアプリケーション・メッセージのメッセージ・ステータスもRESUBMITTEDに設定されます。エンドポイントでは機能確認を予期していますが、リモート・エンドポイントに機能確認は返されません。これは、ドキュメント設定が適切でないために、メッセージを再度変換して検証する必要がある場合に役立ちます。

9.1.3 クラスタ環境に関する重要な注意点

クラスタ環境で、システム・タイムスタンプがクラスタ内のすべてのノードに対して同期化されていない場合は、誤りと思われるメッセージ・タイムスタンプが表示される可能性がありますが、実際は誤りではありません。たとえば、非同期のマルチノードのクラスタがあるとします。あるノードでアウトバウンド・メッセージを受信し、別のノードからリプライを送信すると、レポートにはメッセージの受信が午前4時と表示され、確認の送信は午前3時55分と表示される可能性があります。

9.2 レポートの作成および構成

Oracle SOA Suite for healthcare integrationでは、すぐに使用できるように、いくつかの事前定義済レポートが用意されています。これらのレポートはフィルタ処理できますが、基準となるのは、「デザイナ」→「管理」→「設定」→「UI」→「レポート」→「時間範囲」で構成できる時間範囲のみです。詳細は、13.2項「ユーザー・インタフェース設定の構成」を参照してください。追加のレポートを作成し、エンドポイント、メッセージID、ドキュメント・プロパティ、コンポジット・プロパティ、トランスポート・プロトコル・プロパティ、主要なペイロード・フィールドなどの基準で、さらにメッセージを絞り込むことが可能です。また、事前定義済レポートに基づいて、それらを変更したり、新規レポートとして保存することもできます。

9.2.1 ビジネス・メッセージ・レポートの作成

事前定義済のビジネス・メッセージ・レポートがありますが、ユーザー独自の要件に合せてレポートを追加作成できます。

ビジネス・メッセージ・レポートを作成するには

1. Oracle SOA Suite for healthcare integrationのユーザー・インタフェースで「レポート」タブをクリックします。
レポートが開いていない場合には、レポートのようこそページが表示されます。

図9-6 レポートのようこそページ

2. 右上にあるプラス記号のアイコンをクリックして、「レポートの作成」を選択します。

3. 図9-7に示すように、「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般ビジネス・メッセージ・レポート」を選択して、「作成」をクリックします。

図9-7 メッセージ・レポートの作成

レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。

4. メッセージ・レポート・フィルタ・カスタマイザで、表9-1で説明されているいずれかのフィルタ条件を入力します。

注意:

最初にワイヤ/ビジネス/アプリケーション・メッセージ・レポートを作成(または新規ファイルとして保存してクローニング)すると、そのレポートを初めて開いたときに検索が自動的に実行されません。明示的に「検索」ボタンをクリックする必要があります。

フィルタ条件リスト内のセクション間を素早く移動するには、「フィルタ条件」の横にあるリンクを使用します。

注意:

ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。

表9-1 ビジネス・メッセージ・レポート・カスタマイザのオプション

フィルタ

説明

名前

レポートの名前。

説明

レポートの簡単な説明。

一致

検索条件がANDまたはOR演算子のいずれによって連結されているかを示すインジケータ。ANDを使用するには「次の条件のすべてと一致」を選択し、ORを使用するには「次の条件のいずれかと一致」を選択します。

メッセージID (ビジネス)

表示するメッセージのビジネス・メッセージID。演算子を選択し、メッセージIDに適切な値を入力します。

任意

日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。

最後

最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。「UI設定」で、有効化された時間スライダ期間を変更できます。

範囲

指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。

特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。

開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。

方向

表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。

エンドポイント

メッセージの受信元またはメッセージの配信先のエンドポイント。演算子を選択し、定義済エンドポイントの名前を入力します。

状態

表示するメッセージの状態。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから1つ以上のメッセージの状態を選択します。

ドキュメント

次の3つのフィールドでドキュメントのプロパティを指定できます。これらの3つのフィールドは、レポート表の「ドキュメント・タイプ」列に表示される内容を制御します。いずれのフィールドでも、検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。

- プロトコル

表示するメッセージのドキュメント・プロトコル。演算子を選択し、ドキュメント・プロトコルを入力します。HL7メッセージの場合は「HL7」と入力します。

- バージョン

表示するメッセージのドキュメント・プロトコルのバージョン。演算子を選択し、バージョンを入力します。たとえば、HL7 2.6メッセージの場合は「2.6」と入力します。

- タイプ

表示するメッセージのドキュメント・プロトコルのタイプ。演算子を選択し、バージョンを入力します。たとえば、HL7 ADT_A04メッセージの場合は「ADT_A04」と入力します。

ペイロード・キー・フィールド

メッセージのフィールドのコンテンツによって検索を絞り込む名前と値のペア。入力した各フィールド名について、対応するフィールドの値を入力します。それぞれの名前または値について、演算子を選択します。

これらのフィールドは、ドキュメント定義のXPathページで定義されている場合のみ使用できます。「名前」フィールドには、XPathページで指定されている、メッセージ内のフィールドを表す名前を入力します。「値」フィールドには、対応するフィールドで検索の対象とする値を入力します。

ドキュメント定義を作成する際、メッセージ内で最大3つのフィールドをペイロード・キー・フィールドとして指定できます。これらのフィールドは、一意の名前と、メッセージ内のフィールドの位置を示すXPath式によって定義されます。たとえば、HL7 A03メッセージのPIDセグメント内の姓フィールドをLastNameと名付け、XPath式を指定します。ドキュメント定義の相関フィールドも同様に定義できます。

ドキュメント定義で相関フィールドまたはペイロード・キー・フィールドのいずれかを指定している場合、これらのフィールドをビジネス・メッセージ・レポートのフィルタとして使用できます。フィルタ・エディタでは、これらのフィルタは名前と値のペアとして定義されます。ドキュメント定義の作成時にフィールドに名付けた一意の名前を指定し、次にレポートに含めるメッセージでのそのフィールドの値を指定します。

ドキュメント

- ドキュメント定義

表示するメッセージで使用されているドキュメント定義。演算子を選択し、定義済ドキュメント定義の名前を入力します。

- 交換管理番号

交換の一意の識別子。この番号は、メッセージの追跡、伝送の重複または欠落の検出、または順序が正しくないメッセージの検出に使用されます。

- グループ管理番号

グループの一意の識別子。この番号は、監査、グループの重複または欠落の検出、または順序が正しくないメッセージの検出に使用されます。この番号は機能確認によって参照されます。

- トランザクション・セット管理番号

トランザクション・セットの一意の識別子。トランザクション・セット確認のために、機能確認によってこの番号が参照されます。

コンポジット

- トランスポート・プロトコル名

Oracle SOAコンポジット・アプリケーションによって使用されるトランスポート・プロトコルの名前。

- トランスポート・プロトコル・バージョン

Oracle SOAコンポジット・アプリケーションによって使用されるトランスポート・プロトコルのバージョン。

- ECID

実行コンテキストのID。ECIDを使用してエンドツーエンドのメッセージ追跡を実行できます。

- コンポジット・インスタンスID

Oracle SOAコンポジット・インスタンスのID。

- コンポジット名

Oracle JDeveloperのOracle SOAコンポジット・アプリケーションの名前。

- サービス名

Oracle SOAコンポジット・アプリケーションのヘルスケア統合サービス・バインディング・コンポーネントの名前。

- 参照名

Oracle SOAコンポジット・アプリケーションのヘルスケア統合参照バインディング・コンポーネントの名前。

- ドメイン名

Oracle SOAコンポジット・アプリケーションがデプロイされているWebLogicドメインの名前。

- コンポジット・バージョン

Oracle JDeveloperのOracle SOAコンポジット・アプリケーションのバージョン。

相関

- XPath名からの相関

相関を開始する相関フィールドの名前。このフィールドおよび他の相関フィールドは、ドキュメント定義の相関ページで定義されている場合のみ使用できます。使用方法の詳細は、表9-1の「ペイロード・キー・フィールド」を参照してください。

- XPath値からの相関

上記のフィールドの値。

- XPath名への相関

相関の2番目のフィールドの名前。

- XPath値への相関

上記のフィールドの値。

エラー

- エラー・コード

レポートに表示するエラー・メッセージのエラー・コード。

- エラー・テキスト

レポートに表示するエラー・メッセージのテキスト。

メッセージ

- アプリケーション・メッセージID

レポートに表示するアプリケーション・メッセージの一意の識別子。

- プロトコル・メッセージID

レポートに表示するメッセージの一意のプロトコル・メッセージ識別子。

- ネイティブ・メッセージ・サイズ

変換する前の元のメッセージのサイズ。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、数値を入力します。

- 変換済メッセージ・サイズ

変換後のメッセージのサイズ。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、数値を入力します。

5. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

6. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。

注意:

標準レポート(一般ビジネス・メッセージ・レポートなど)に行った変更は保存できません。「新規ファイルとして保存」ボタンをクリックすることは可能です(このボタンは、レポート名が標準の形式から変更された場合にのみ有効化されます)。

図9-8に、過去24時間にIn_Patient_Admissionエンドポイントで交換されたすべてのビジネス・メッセージがリストされているカスタムのビジネス・メッセージ・レポートを示します。

図9-8 カスタムのビジネス・メッセージ・レポート

列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。

9.2.2 ワイヤ・メッセージ・レポートの作成

事前定義済のワイヤ・メッセージ・レポートとは別に、外部エンドポイントと交換するワイヤ・メッセージを対象としたカスタムのワイヤ・メッセージ・レポートを作成できます。ほとんどのワイヤ・メッセージにはビジネス・メッセージが関連付けられており、レポートの「メッセージ・フロー」ダイアグラムに反映されます。

ワイヤ・メッセージ・レポートを作成するには

1. 9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。

2. 「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般ワイヤ・メッセージ・レポート」を選択して、「作成」をクリックします。
図9-9に示すように、レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。

図9-9 ワイヤ・メッセージ・レポート・フィルタ・カスタマイザ

3. メッセージ・レポート・フィルタ・カスタマイザで、表9-2で説明されているいずれかのフィルタ条件を入力します。

注意:

ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。

表9-2 ワイヤ・メッセージ・レポート・フィルタ・カスタマイザのオプション

フィルタ

説明

名前

レポートの名前。

説明

レポートの簡単な説明。

ID

表示するメッセージのワイヤ・メッセージID。演算子を選択し、メッセージIDの全体または一部を入力します。

任意

日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。

最後

最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。

範囲

指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。

特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。

開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。

方向

表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。

トランスポート・プロトコル

表示するメッセージのトランスポート・プロトコル。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたトランスポート・プロトコルの名前を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。

トランスポート・プロトコル・バージョン

表示するメッセージのトランスポート・プロトコルのバージョン。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたトランスポート・プロトコル・バージョンの名前を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。

URL

表示するメッセージのTCPエンドポイントURL。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、定義されたURL値を入力します。検索で大/小文字の区別をしない場合は、「大/小文字を区別しない」を選択します。

状態

表示するメッセージの状態。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、右のフィールドをクリックして、リストから1つ以上のメッセージの状態を選択します。

メッセージ・サイズ(バイト)

表示するメッセージのサイズ(バイト単位)。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義されたメッセージ・サイズを入力します。

再発行数

(表示される)メッセージが再発行された回数。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義された回数を入力します。

最終再発行日

(表示される)メッセージが最後に再発行された日付。「任意」、「最後」または「範囲」の各オプションから選択します。

4. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

5. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「新規ファイルとして保存」をクリックします。

図9-10に、過去24時間のインバウンド・ワイヤ・メッセージがすべてリストされているカスタムのワイヤ・メッセージ・レポートを表示します。

図9-10 カスタムのワイヤ・メッセージ・レポート

列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。

9.2.3 アプリケーション・メッセージ・レポートの作成

事前定義済のアプリケーション・メッセージ・レポートとは別に、ファブリック/コンポジット・レイヤーと交換するアプリケーション・メッセージを対象としたカスタムのアプリケーション・メッセージ・レポートを作成できます。Oracle Healthcareランタイムに送信されてくるアプリケーション・メッセージのほとんどが、対応するビジネス・メッセージとなり、レポートの「メッセージ・フロー」ダイアグラムに反映されます。

ワイヤ・メッセージ・レポートを作成するには

1. 9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。

2. 「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「一般アプリケーション・メッセージ・レポート」を選択して、「作成」をクリックします。
図9-11に示すように、レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。

図9-11 アプリケーション・メッセージ・レポート・フィルタ・カスタマイザ

3. メッセージ・レポート・フィルタ・カスタマイザで、表9-3で説明されているいずれかのフィルタ条件を入力します。

注意:

ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。

表9-3 アプリケーション・メッセージ・レポート・フィルタ・カスタマイザのオプション

フィルタ

説明

名前

レポートの名前。

説明

レポートの簡単な説明。

ID

表示するメッセージのワイヤ・メッセージID。演算子を選択し、メッセージIDの全体または一部を入力します。

任意

日付範囲によってレポートを絞り込まずに、すべての日付および時間のメッセージが表示されます。

最後

最近の日付または時間の範囲でレポートを絞り込みます。たとえば、過去12時間、過去5日、または過去2週間を選択できます。スライド・スケールのポインタを動かして時間範囲を選択します。

範囲

指定した日付の範囲でレポートを絞り込みます。「開始」または「終了」フィールド、もしくは両方のフィールドで、日時を示されている書式(MM/DD/YYYY HH:MM:SS AM/PM)で指定するか、「日付および時間を選択」アイコンをクリックします。

特定の日付よりも後のすべてのメッセージを検索するには、「開始」フィールドの日付のみ入力します。特定の日付よりも前のすべてのメッセージを検索するには、「終了」フィールドの日付のみ入力します。日付の範囲内のすべてのメッセージを検索するには、「開始」および「終了」フィールドの両方に日付を入力します。特定の時間の範囲を除外するには、除外する範囲の最初の日付を「終了」フィールドに入力し、除外する範囲の最後の日付を「開始」フィールドに入力します。この除外範囲を使用するには、「次の条件のいずれかと一致」インジケータを選択する必要があります。検索すると、受信したすべてのメッセージが返されます。

開始および終了日の両方について、指定した日付を検索に含める場合は「包含」を選択するか、それらの日付を検索から除外するには除外の選択を解除します。

方向

表示するメッセージの方向。「任意」、「次と等しい」、または「次と等しくない」から1つを選択し、右側のフィールドをクリックしてリストから方向(インバウンドまたはアウトバウンド)を選択します。

状態

表示するメッセージの状態。「任意」、「次と等しい」、「次と同じ」、「次と等しくない」または「相似でない」から1つを選択し、右のフィールドをクリックして、リストから1つ以上のメッセージの状態を選択します。

メッセージ・サイズ(バイト)

表示するメッセージのサイズ(バイト単位)。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義されたメッセージ・サイズを入力します。

ドキュメント

- プロトコル

表示するメッセージのドキュメント・プロトコル。演算子を選択し、ドキュメント・プロトコルを入力します。HL7メッセージの場合は「HL7」と入力します。

- バージョン

表示するメッセージのドキュメント・プロトコルのバージョン。演算子を選択し、バージョンを入力します。たとえば、HL7 2.6メッセージの場合は「2.6」と入力します。

- タイプ

表示するメッセージのドキュメント・プロトコルのタイプ。演算子を選択し、バージョンを入力します。たとえば、HL7 ADT_A04メッセージの場合は「ADT_A04」と入力します。

- ドキュメント定義

表示するメッセージで使用されているドキュメント定義。演算子を選択し、定義済ドキュメント定義の名前を入力します。

コンポジット

- ECID

実行コンテキストのID。ECIDを使用してエンドツーエンドのメッセージ追跡を実行できます。

- ドメイン名

Oracle SOAコンポジット・アプリケーションがデプロイされているWebLogicドメインの名前。

- コンポジット名

Oracle JDeveloperのOracle SOAコンポジット・アプリケーションの名前。

- コンポジット・バージョン

Oracle JDeveloperのOracle SOAコンポジット・アプリケーションのバージョン。

- コンポジット・インスタンスID

Oracle SOAコンポジット・インスタンスのID。

- サービス名

Oracle SOAコンポジット・アプリケーションのヘルスケア統合サービス・バインディング・コンポーネントの名前。

- 参照名

Oracle SOAコンポジット・アプリケーションのOracle Healthcare参照バインディング・コンポーネントの名前。

再発行数

(表示される)メッセージが再発行された回数。「任意」、「次と等しい」、「次と等しくない」、「次より小さい」、「次以下」、「次より大きい」、または「次以上」の中から選択し、定義された回数を入力します。

最終再発行日

(表示される)メッセージが最後に再発行された日付。「任意」、「最後」または「範囲」の各オプションから選択します。

4. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

5. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「新規ファイルとして保存」をクリックします。

図9-12に、過去24時間に交換されたアプリケーション・メッセージで、ステータスが完了のものがすべてリストされているカスタムのアプリケーション・メッセージ・レポートを示します。

図9-12 カスタムのアプリケーション・メッセージ・レポート

列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。

9.2.4 デフォルト・レポートの指定

「レポート」タブをクリックしたときに自動的に表示されるレポートを1つ選択できます。これがデフォルト・レポートです。

デフォルト・レポートを指定するには:

1. Oracle SOA Suite for healthcare integrationのユーザー・インタフェースで「レポート」タブをクリックします。レポートが開いていない場合には、レポートのようこそページが表示されます。

2. 「選択済みレポート」フィールドの隣の下向きの矢印をクリックし、デフォルトに設定するレポートを選択します。

3. 「適用」をクリックします。
選択したレポートが表示されます。次回「レポート」タブを選択すると、このレポートが自動的に表示されます。

9.2.5 レポートの構成

レポートを作成した後は、メッセージ・レポート・フィルタ・カスタマイザを使用して、レポートのフィルタ条件を変更できます。また、既存のレポートをテンプレートとして使用してレポートを作成できます。

レポートを構成するには:

1. 構成するレポートを「レポート」タブに表示した状態で、「「フィルタ」を表示」をクリックします。
メッセージ・レポート・フィルタ・カスタマイザが表示されます。

図9-13 メッセージ・レポート・フィルタ・カスタマイザ

2. レポート・タイプに基づき、表9-1、表9-2または表9-3で説明されている任意のフィルタを変更します。

3. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

4. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「新規ファイルとして保存」をクリックします。

9.2.6 レポートのリフレッシュおよび自動リフレッシュ率の設定

表示されているレポートはいつでも手動でリフレッシュできますが、レポートを一定の間隔で自動的に更新されるように指定できます。自動リフレッシュ率は、現在のセッションについてのみアクティブ化され、構成されます。レポートを閉じた後に再度開くと、自動リフレッシュ・オプションは無効になります。

レポートをリフレッシュし、自動リフレッシュ率を設定する手順は次のとおりです。

1. 監視するレポートが表示されていない場合は、メインのレポート・ページの右上にあるプラス・アイコンをクリックし、構成するレポートを選択します。

2. レポートをリフレッシュするには、右上のリフレッシュ・アイコンをクリックします。

3. 自動リフレッシュ・オプションを有効にするには、次のようにします。

1. レポート・ツールバーのリフレッシュ・アイコンの右側にある下向きの矢印をクリックします。

2. レポートを自動的にリフレッシュする時間間隔を秒単位で指定し、「自動リフレッシュ」チェック・ボックスを選択します。

3. 自動リフレッシュを無効にするには、「自動リフレッシュ」チェック・ボックスの選択を解除します。

9.2.7 レポートの削除

管理者ロールの場合には、ユーザーが作成したレポートを削除できます。事前定義済のレポートも削除できますが、削除アクションは元に戻せないため、注意が必要です。

レポートを削除するには:

1. メインのレポート・ページで右上のプラス・アイコンをクリックし、「レポートの削除」を選択します。
「ビジネス・メッセージ・レポートの削除」ダイアログが表示されます。

図9-14 「ビジネス・メッセージ・レポートの削除」ダイアログ

2. デフォルトで、ユーザーが作成したレポートのみがリストに表示されます。事前定義済レポートを含めるには、「標準グループを含める」を選択します。これは、「すべて」、「過去24時間」、「過去2週間」など、前のバージョンのOracle Healthcareコンソールからインポートされた標準レポートにのみ関係があります。

3. レポートのリストで、削除するレポートの隣のチェック・ボックスを選択します。

4. 「選択したレポートの削除」をクリックするか、または「取消」をクリックして、レポートを削除せずにダイアログ・ボックスを閉じます。

9.3 レポートおよびレポートの詳細の表示

レポートを開くと、最初に、「レポート」タブにレポート条件に一致するメッセージのリストが表示されます。このリストには、各メッセージの概要情報が表示されます。次のものが含まれます。

- メッセージID

- 作成日時

- Direction

- エンドポイント

- 状態

- ドキュメント・タイプ

次に示すように、リスト内のメッセージを選択して詳細な情報を表示することや、複数のメッセージのサマリーを表示することが可能です。

- 「ビジネス・メッセージ・インスタンスの表示」

- 「ワイヤ・メッセージの表示」

- 「アプリケーション・メッセージの表示」

- 「Oracle Enterprise Managerのフロー・トレースの表示」

- 「複数のメッセージの概要情報の表示」

メッセージのドキュメント・タイプを表示する権限がない場合、一部の詳細情報は非表示になります。必要な権限がない限り、情報をダウンロードするオプションは使用不可になっています。

9.3.1 ビジネス・メッセージ・インスタンスの表示

ビジネス・メッセージには、エンドポイント名、メッセージの方向、メッセージID、状態、トランスポート・プロトコルを含めたドキュメント・プロトコルのインスタンス情報と、ドキュメント・プロトコル、およびメッセージの詳細が含まれています。

ビジネス・メッセージ・インスタンスを表示するには:

1. レポート・ページにレポートを表示します。

2. メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-15に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

図9-15 ビジネス・メッセージ・フロー

3. メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ビジネス・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-16に示すようなメッセージの詳細が表示されます。

図9-16 ビジネス・メッセージの詳細

4. ビジネス・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。

5. 情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。

注意:

このオプションは、すべてのセクションで有効なわけではありません。

6. メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。

9.3.2 ワイヤ・メッセージの表示

ワイヤ・メッセージは、エンドポイントと送受信されるデータのネイティブ・フォーマットです。ワイヤ・メッセージの詳細には、メッセージID、通信およびプロトコル情報(トランスポート・バインディングおよびヘッダー詳細など)、ペイロード・メッセージ・コンテンツ、パック・メッセージ・コンテンツ、およびセキュリティ情報が含まれます。

ワイヤ・メッセージを表示するには:

1. レポート・ページにレポートを表示します。

2. メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-17に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

図9-17 ワイヤ・メッセージ・フロー

3. メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ワイヤ・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-18に示すようなメッセージの詳細が表示されます。

図9-18 ワイヤ・メッセージの詳細

4. ワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。

5. 情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。

注意:

このオプションは、すべてのセクションで有効なわけではありません。

6. メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。

9.3.3 アプリケーション・メッセージの表示

アプリケーション・メッセージは、バックエンド・コンポジット・アプリケーションがメッセージを送受信した場合に、SOAコンポジットに関連する情報(コンポジット名、バージョン、インスタンスIDなど)を提供します。

アプリケーション・メッセージを表示するには:

1. レポート・ページにレポートを表示します。

2. メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-19に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

図9-19 アプリケーション・メッセージ・フロー

3. メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「アプリケーション・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。
図9-20に示すようなメッセージの詳細が表示されます。

図9-20 アプリケーション・メッセージの詳細

4. アプリケーション・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。

5. 情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。

注意:

このオプションは、すべてのセクションで有効なわけではありません。

6. メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。

9.3.4 Oracle Enterprise Managerのフロー・トレースの表示

Oracle Healthcareレポートでは、各メッセージが、Oracle Enterprise Managerのコンポジットのフロー・トレースにリンクされています。リンクをクリックすると、自動的にOracle Enterprise Managerの該当するフローのトレース・ページが開かれます。

Oracle Enterprise Managerのフロー・トレースを表示するには:

1. レポート・ページにレポートを表示します。

2. メッセージのリストで、フロー・トレースを表示するメッセージを選択します。
メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

図9-21 Oracle Healthcareメッセージ・フロー

3. メッセージ・フロー・ダイアグラムの「コンポジット」をクリックします。
Oracle Enterprise Managerのログイン・ページが別のブラウザ・タブまたはウィンドウに表示されます。

4. Oracle Enterprise Managerのログイン情報を入力し、「ログイン」をクリックします。
図9-22に示すように、選択したメッセージのフロー・トレースが表示されます。

図9-22 Oracle Enterprise Managerのメッセージ・フロー・トレース

9.3.5 複数のメッセージの概要情報の表示

レポートのメッセージ・リストで、複数のメッセージを選択して情報の概要を表示できます。これにより、処理されたメッセージ数、使用されたエンドポイント数およびドキュメント・タイプ、エラー数、処理済メッセージ数など、選択したすべてのメッセージの概要をつかめます。

複数のメッセージの概要を表示するには:

1. レポート・ページにレポートを表示します。

2. メッセージのリストで、サマリー・データを表示する複数のメッセージを選択するには、削除する最初のメッセージをクリックして[Shift]を押し、該当する範囲の最後のメッセージをクリックします。
図9-23に示すように、選択したメッセージの概要がリストの下に表示されます。

図9-23 レポートで選択された複数のメッセージ

3. ここで、選択したメッセージをパージまたは再発行できます。
詳細は、「複数のメッセージを再発行するには:」または「リポジトリからメッセージをパージするには:」を参照してください。

9.4 関連付けられていないメッセージのレポートの作業

ワイヤ・メッセージおよびアプリケーション・メッセージに、ビジネス・メッセージが関連付けられていない場合があります。これらのメッセージは関連付けられていないメッセージとして分類され、関連付けられていないワイヤ・メッセージ・レポートや関連付けられていないアプリケーション・メッセージ・レポートで表示できます。

9.4.1 関連付けられていないワイヤ・メッセージの作業

外部エンドポイントからメッセージが大量に着信すると、Oracle Healthcareランタイムの処理能力に過剰な負荷がかかります。そうしたメッセージは、一時的にバックログとして扱われ、「処理中」とマークされます。そのため、それらのワイヤ・メッセージには、ビジネス・メッセージが関連付けられません。インバウンドのHL7 MLLPエンドポイントにより即時確認が生成された場合も、ワイヤ・メッセージにはビジネス・メッセージが関連付けられません。

9.4.1.1 関連付けられていないワイヤ・メッセージ・レポートの作成

関連付けられていないワイヤ・メッセージ・レポートは、一般ワイヤ・メッセージ・レポートと同じような方法で作成できます。

関連付けられていないワイヤ・メッセージ・レポートを作成するには

1. 9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。

2. 「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「関連付けられていないワイヤ・メッセージ・レポート」を選択して、「作成」をクリックします。
レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。

3. メッセージ・レポート・フィルタ・カスタマイザで、表9-2で説明されているいずれかのフィルタ条件を入力します。

注意:

ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。

4. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

5. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。

図9-24に、過去24時間のアウトバウンドの関連付けられていないワイヤ・メッセージがすべてリストされている、関連付けられていないワイヤ・メッセージ・レポートを表示します。

図9-24 関連付けられていないワイヤ・メッセージ・レポート

列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。

9.4.1.2 関連付けられていないワイヤ・メッセージの表示

関連付けられていないワイヤ・メッセージは、関連付けられていないワイヤ・メッセージ・レポートから表示できます。

ワイヤ・メッセージを表示するには:

1. レポート・ページで、関連付けられていないワイヤ・メッセージ・レポートを表示します。

2. メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
図9-25に示すように、メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

図9-25 関連付けられていないワイヤ・メッセージ・フロー

注意:

メッセージ・フローで無効化されているため、使用できない「ビジネス・メッセージ」アイコンや「アプリケーション・メッセージ」アイコンがレンダリングされます。

3. メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「ワイヤ・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。

4. 関連付けられていないワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。

5. 情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。ただし、メッセージにはビジネス・メッセージが関連付けられていないため、ペイロードにはデータがありません。

注意:

このオプションは、すべてのセクションで有効なわけではありません。

6. メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。

9.4.2 関連付けられていないアプリケーション・メッセージの作業

ファブリック/コンポジット・レイヤーからアプリケーション・メッセージが大量に発生すると、Oracle Healthcareランタイムの処理能力に過剰な負荷がかかります。そうしたメッセージは、一時的にバックログとして扱われ、「処理中」とマークされます。そのため、それらのアプリケーション・メッセージには、関連するビジネス・メッセージがありません。ファブリック/コンポジット・レイヤーからのアウトバウンド・メッセージにより、重大なエラーが発生した場合にも、アプリケーション・メッセージにはビジネス・メッセージが関連付けられません。

9.4.2.1 関連付けられていないアプリケーション・メッセージ・レポートの作成

関連付けられていないアプリケーション・メッセージ・レポートは、一般アプリケーション・メッセージ・レポートと同じような方法で作成できます。

関連付けられていないアプリケーション・メッセージ・レポートを作成するには

1. 9.2.1項「ビジネス・メッセージ・レポートの作成」の手順1と2を実行します。

2. 「メッセージ・レポートの作成」ダイアログで、レポートの名前を入力し、「レポート・タイプ」リストから「関連付けられていないアプリケーション・メッセージ・レポート」を選択して、「作成」をクリックします。
レポートにメッセージ・レポート・フィルタ・カスタマイザが表示されます。

3. メッセージ・レポート・フィルタ・カスタマイザで、表9-3で説明されているいずれかのフィルタ条件を入力します。

注意:

ほとんどの文字列条件で、複数の条件演算子がサポートされています。「任意」、「次と等しい」、「相似」、「次と等しくない」または「相似でない」の使用方法の詳細は、9.1.1項「メッセージ・レポート・フィルタ・カスタマイザについて」を参照してください。

4. レポート・フィルタに加えた未保存の変更を元に戻すには、「元に戻す」をクリックします。

5. レポート・フィルタの指定後、次のいずれかを実行します。

- フィルタ条件をテストするには、「検索」、「「フィルタ」を表示/フィルタの非表示」トグル・ボタンをクリックします。

- レポートのフィルタ条件に加えた変更を保存するには、「保存」をクリックします。

列ヘッダーをクリックすると、任意のレポート列に基づいてメッセージをソートできます。

9.4.2.2 関連付けられていないアプリケーション・メッセージの表示

関連付けられていないアプリケーション・メッセージは、関連付けられていないアプリケーション・メッセージ・レポートから表示できます。

アプリケーション・メッセージを表示するには:

1. レポート・ページで、関連付けられていないアプリケーション・メッセージ・レポートを表示します。

2. メッセージのリストで、インスタンス・データを表示するメッセージを選択します。
メッセージ・リストの下にメッセージ・フロー・ダイアグラムが表示されます。

注意:

メッセージ・フローで無効化されているため、使用できない「ビジネス・メッセージ」アイコンがレンダリングされます。

3. メッセージの詳細を広い領域に表示するには、メッセージ・フロー・ダイアグラムの「アプリケーション・メッセージ」をクリックし、次にメッセージ・リストの下にあるペインを閉じるアイコンをクリックします。または、「現在のメッセージ詳細を新規タブに固定」をクリックすると、新しいページに詳細な情報が表示されます。

4. 関連付けられていないワイヤ・メッセージのセクションを開いたり閉じたりするには、そのセクションの隣の矢印アイコンをクリックします。

5. 情報をダウンロードするには、ダウンロードするセクションの「XML形式でダウンロード」または「テキスト形式でダウンロード」をクリックします。ただし、メッセージにはビジネス・メッセージが関連付けられていないため、ペイロードにはデータがありません。

注意:

このオプションは、すべてのセクションで有効なわけではありません。

6. メッセージ・リスト・ペインを閉じた場合、メッセージ・フロー・ダイアグラムの上のペインのリストアをクリックしてメッセージのリストに戻ります。

9.5 エラー・メッセージの作業

メッセージの処理時にエラーが発生すると、メッセージ・リストのメッセージのアイコンに赤い四角が表示されます。エラー・メッセージを選択すると、エラーに関する詳細な情報が表示されます。

9.5.1 エラー・メッセージの表示

このレポートには、エラー・メッセージ、コード、重大度、レベル、および説明を含めた、メッセージ処理時のエラーに関する情報が含まれます。

エラー・メッセージを表示するには:

1. メッセージのリストで、エラーの発生したメッセージを探します(図9-26に表示されているように、エラー・アイコンまたはMSG_ERRORの状態で示されます)。

図9-26 メッセージ・リストのエラー・メッセージ

2. 表示するエラー・メッセージを見つけたら、メッセージを選択します。
図9-27に示すように、メッセージ・フロー・ダイアグラムが変更され、エラーが発生した位置が表示されます。

図9-27 エラーを示すメッセージ・フロー・ダイアグラム

3. メッセージ・フロー・ダイアグラムのエラー・アイコンをクリックします。
図9-28に示すように、エラー・メッセージの詳細がダイアグラムの下に表示されます。

図9-28 エラー・メッセージの詳細

9.5.2 メッセージの再発行

「レポート」タブからワイヤ・メッセージおよびアプリケーション・メッセージを再発行できます。メッセージ・トランザクションでエラーが発生した場合、レポート機能を使用して、エラーの内容を確認して修正します。問題を修正した後、メッセージを再発行します。メッセージは1つずつ再発行したり、グループ化して再発行できます。

メッセージを再発行するには:

1. 表示したレポートのメッセージのリストで、再発行するメッセージを選択します。

2. 次のいずれかを行います:

- 「再発行」を選択した後、「関連アプリケーション・メッセージ」または「関連ワイヤ・メッセージ」を選択します。

- 選択したメッセージを右クリックして、コンテキスト・メニュー・アイテムを使用します。

- メッセージ・フロー・ダイアグラムで「ワイヤ・メッセージ」または「アプリケーション・メッセージ」を右クリックし、「ワイヤ・メッセージの再発行」または「アプリケーション・メッセージの再発行」を選択します。

3. 表示される確認ダイアログで「OK」をクリックします。
メッセージ・リストのメッセージのエラー・アイコンが、メッセージの再発行を示す緑色の矢印に変更されます。

複数のメッセージを再発行するには:

1. 表示したレポートのメッセージのリストで、再発行する複数のメッセージを選択します。
図9-29に示すように、選択したメッセージの概要がメッセージ・リストの下に表示されます。

図9-29 レポート・ページで選択された複数のメッセージ

2. 「選択項目の概要」の上の黄色いバーで、「再発行」をクリックした後、「関連アプリケーション・メッセージ」または「関連ワイヤ・メッセージ」を選択します。ツールバーの「再発行」メニューを使用することも、選択したメッセージを右クリックして、コンテキスト・メニュー・アイテムを使用することもできます。

3. 表示される確認ダイアログで「OK」をクリックします。

9.6 リポジトリからのメッセージのパージ

Healthcare integrationリポジトリに格納する必要のなくなったメッセージをパージできます。パージするメッセージがバッチ・プロセスの一部である場合、バッチ内のすべてのメッセージが削除されます。

メッセージは1つずつパージしたり、グループ化してパージできます。

リポジトリからメッセージをパージするには:

1. 表示したレポートのメッセージのリストで、削除する1つまたは複数のメッセージを選択します。

2. 「パージ」をクリックします。

3. 表示される確認ダイアログで「はい」をクリックします。

注意:

ビジネス・メッセージを削除すると、順序付けマネージャの表の対応するエントリも削除されます。

10 アラートと連絡先の構成

この章では、Oracle SOA Suite for healthcare integrationでアラート通知と連絡先を定義する方法について説明します。特定の医療関連のランタイム・イベントまたは設計時イベントの発生時に特定のユーザーが電子メールやテキスト・メッセージ(SMS)でアラートを受け取ることを指定できます。

この章には次のトピックが含まれます:

- 10.1項「アラートと連絡先の概要」

- 10.2項「連絡先とアラートの構成」

- 10.3項「連絡先に割り当てられたアラートの表示」

- 10.4項「連絡先の削除」

10.1 アラートと連絡先の概要

healthcare integrationでは、管理者とサポート担当者は、医療構成に対する変更や処理に影響するエラーなどの特定のイベントの発生を知る必要があります。Oracle SOA Suite for healthcare integrationは、連絡先情報を定義して各連絡先をアラートの生成対象の特定のイベントに関連付けられるようにすることで、これに対処します。たとえば、メッセージの処理または配信中にエラーが発生した場合は、問題を即時に処理できるように、適切なユーザーに電子メールまたはテキスト・アラートを送信できます。

ヘルスケア統合のアラート通知機能は、Oracle User Messaging Service (UMS)およびOracle SOA Suiteヒューマン・ワークフロー・サービスの組込み通知フレームワークと連動します。

10.2 連絡先とアラートの構成

連絡先およびアラートはOracle WebLogic管理コンソール、Oracle Enterprise Managerおよびヘルスケア統合ユーザー・インタフェースを使用して構成します。電子メール・サーバーと送信者アドレス情報の構成およびすべての通知の有効化は、Oracle Enterprise Managerから行います。ヘルスケア統合ユーザー・インタフェースを使用して、個々の連絡先を定義し、アラートをサブスクライブします。

連絡先とアラートの構成には次の手順が関係します。

- 10.2.1項「SMS通知のためのSMPPドライバのデプロイ」

- 10.2.2項「ワークフロー通知プロパティの構成」

- 10.2.3項「Oracle User Messaging Serviceの構成」

- 10.2.4項「アラートと連絡先の定義」

User Messaging Serviceの構成の詳細は、Oracle Fusion Middleware Oracle SOA Suite管理者ガイドのOracle User Messaging Serviceの構成を参照してください。

10.2.1 SMS通知のためのSMPPドライバのデプロイ

SMS (テキスト・メッセージ)通知を使用する場合は、User Messaging Service用にSMPPドライバのターゲット・サーバーを指定する必要があります。Oracle WebLogic管理コンソールで次のタスクを実行します。

SMPPドライバをデプロイするには:

1. Webブラウザで、Oracle WebLogic管理コンソールを起動し、ログインします。URLは次のとおりです。

http://hostname:port_number/console

ホスト名は、WebLogic Serverが存在するコンピュータの名前で、ポート番号は、WebLogic Serverがリスニングするポート(デフォルトでは7001)です。

2. 「ドメイン構造」ナビゲータで「デプロイメント」をクリックします。

3. 表示されたデプロイメント・リストで「usermessagingdriver-smpp」を選択します。
usermessagingdriver-smppの設定ページが表示されます。

4. 「ターゲット」タブをクリックします。
ターゲットの割当リストが表示されます。

図10-1 usermessagingdriver-smppの設定の「ターゲット」タブ

5. 「ターゲットの割当」表で、「コンポーネント」の横のチェック・ボックスを選択し、すべてのドライバ・コンポーネントを選択して、「ターゲットの変更」をクリックします。
「ターゲット・アシスタントの変更」が表示されます。

図10-2 usermessagingdriver-smppの「デプロイメントのターゲット指定」

6. ヘルスケア統合に使用するSOA Manager Serverを選択し、「はい」をクリックします。
ページの上部に確認メッセージが表示され、ターゲットが正常に変更されたかどうかが表示されます。

10.2.2 ワークフローの通知プロパティの構成

ワークフロー通知プロパティでは、すべての通知タイプの通知機能を有効化し、通知用の送信電子メール・アカウントの電子メール・アドレスを定義できます。

ワークフロー通知プロパティを構成するには:

1. Webブラウザで、Oracle Enterprise Managerを起動してログインします。URLは次のとおりです。

http://hostname:port_number/em

ホスト名は、WebLogic Serverが存在するコンピュータの名前で、ポート番号は、WebLogic Serverがリスニングするポート(デフォルトでは7001)です。

2. 左側のナビゲーション・パネルで、「SOA」を展開し、「soa-infra」を選択します。

3. soa-infraページで、「SOAインフラストラクチャ」メニューの「SOA管理」をポイントし、「ワークフロー構成」を選択します。

4. ワークフロー通知プロパティ・ページで、「通知モード」を「すべて」に設定します。

5. 「通知サービス」セクションで、次の電子メール・アドレスを構成します。

- 電子メール: 送信者アドレス -- 電子メール通知の送信元になる電子メール・アドレス。

- 電子メール : アクション可能なアドレス -- アクション可能な受信メッセージの電子メール・アドレス。これは必須ではありません。

- 電子メール: 返信先アドレス -- 送信電子メール通知ヘッダーの「返信先」フィールドに含める電子メール・アドレス。

図10-3 SOAインフラストラクチャ・ワークフロー通知プロパティ

6. 「適用」をクリックし、確認ダイアログで「はい」をクリックします。

注意:

エンドポイントにドキュメント定義を追加すると、Oracle SOA Suite for healthcare integrationのバックエンド・プロセスによってドキュメントがデプロイされます。そのため、ドキュメント・デプロイメントに対して電子メールが送信されますが、ドキュメント追加に対しては通知が送信されません。

10.2.3 Oracle User Messaging Serviceの構成

Oracle UMSは通知の基礎となるインフラストラクチャです。電子メール通知を使用するにはUMSの電子メール・ドライバ情報を構成し、SMS(テキスト・メッセージ)通知を使用するにはSMPPドライバ情報を構成する必要があります。

Oracle User Messaging Serviceを構成するには:

注意:

このタスクおよび構成できるプロパティの詳細は、Oracle Fusion Middleware Oracle SOA Suite管理者ガイドのOracle User Messaging Serviceの構成を参照してください。

1. Oracle Enterprise Managerの左側のナビゲーション・パネルで、「ユーザー・メッセージング・サービス」を展開します。

2. 「usermessagingdriver-email」を右クリックし、「電子メール・ドライバ・プロパティ」を選択します。

図10-4 UMS用の電子メール・ドライバ・プロパティ・ページ

3. 電子メール・サーバーの電子メール・ドライバ・プロパティを構成します。

4. 電子メール・プロパティの構成後、左側のナビゲーション・ペインの「ユーザー・メッセージング・サービス」で「usermessagingdriver-smpp」を右クリックします。

5. 「SMPPドライバ・プロパティ」を選択します。

6. SMPPドライバ・プロパティを構成します。

7. すべてのワークフローおよび電子メール・ドライバ・プロパティを構成したら、サーバーを再起動してすべての変更をロードします。

10.2.4 アラートと連絡先の定義

ヘルスケア統合ユーザー・インタフェースで、連絡先を定義し、各連絡先で異なるタイプのイベントに対する複数のアラートをサブスクライブできます。アラートを生成できるイベントは、表10-1に記載されています。

アラートと連絡先を定義するには

1. Webブラウザで、Oracle SOA Suite for healthcare integrationユーザー・インタフェースを起動します。URLは次のとおりです。

http://host_name:port_number/healthcare

ホスト名は、WebLogic管理対象サーバーが存在するコンピュータの名前です。ポート番号は、管理対象サーバーがリスニングするポート番号です。

2. 「デザイナ」タブで、「管理」タブをクリックし、「アラートと連絡先」をダブルクリックします。

図10-5 アラートと連絡先ページ

3. 「連絡先」セクションで、「連絡先の追加」(右上のプラス記号のアイコン)をクリックします。

4. 次の情報を入力します。

- タイプ: 送信するアラートのタイプを選択します。「電子メール」または「テキスト・メッセージ(SMS)」を選択します。

- 値: アラートの送信先となる電子メール・アドレスまたはテキスト・メッセージ送信先番号です。ここに入力した値のタイプが、選択したタイプに対応していることを確認してください。

5. 追加する必要のある連絡先ごとに、前の2つの手順を繰り返します。

図10-6 テキスト・メッセージおよび電子メールの連絡先

6. 「適用」をクリックして連絡先情報を保存します。

7. 右側の「イベント」セクションで、アラートを送信するすべてのイベントの「有効」チェック・ボックスを選択します。

8. 連絡先でイベントをサブスクライブするには、次のいずれかを行います。

- 作成する連絡先ごとに、連絡先リストから、右側にリストされている1つ以上の有効なイベントに連絡先をドラッグ・アンド・ドロップします。表10-1に、アラートを構成する各イベントをリストし、説明します。

- イベント名の横の「このイベントにアラートを追加します」をクリックし、イベント・セクションに表示されるドロップ・ダウン・リストから連絡先を選択します。

図10-7 連絡先が割り当てられたアラート・イベント

イベントが発生するたびに、指定したメッセージ・タイプ(電子メールまたはテキスト・メッセージ)が、そのイベントに対してリストされている連絡先に送信されます。

ヒント:

一部のランタイム・エラー・メッセージは長いため、テキスト(SMS)連絡先ではランタイム・イベントのサブスクライブを避けることが必要な場合があります。

表10-1 ヘルスケア統合アラート・イベント

イベント

説明

ランタイム・エラー

インバウンドまたはアウトバウンド・メッセージの処理中、エンドポイントへの配信中または内部デリバリ・チャネルへの配信中にエラーが発生した場合にアラートをトリガーします。

エンドポイント・エラー

エンドポイントのトランスポート・レイヤーでエラーが発生した場合(たとえば、TCP/IPサーバー・ポートがすでに使用中の場合)にアラートをトリガーします。

エンドポイントの構成

エンドポイントの有効化や無効化など、エンドポイントの構成に対して変更が行われた場合にアラートをトリガーします。

エンドポイント・ドキュメントの使用方法の変更

エンドポイントに関連付けられているドキュメント定義に対して変更が行われた場合にアラートをトリガーします。

リポジトリのインポートおよびエクスポート

ヘルスケア統合リポジトリでデータがインポートまたはエクスポートされた場合にアラートをトリガーします。

ランタイム設定変更

ランタイム設定ページにリストされているランタイム・プロパティのいずれかに変更が行われた場合にアラートをトリガーします。

パージ・イベント

次の場合にアラートをトリガーします。

- 「管理」タブの「リポジトリ管理」で選択または選択解除された「管理番号のパージ」を使用して、ランタイム・データがパージされる場合。

- purgecontrolnumberオプションがtrueに設定されているために、コマンドラインからランタイム・データがパージされる場合。

10.3 連絡先に割り当てられたアラートの表示

アラートと連絡先ページの「連絡先」リストから、特定の連絡先に割り当てられたすべてのアラートを表示できます。

連絡先のアラートを表示するには

1. ヘルスケア統合ユーザー・インタフェースの「デザイナ」タブで、「管理」タブをクリックし、「アラートと連絡先」をダブルクリックします。

2. 「連絡先」リストで、アラート情報を表示する連絡先の左にある矢印アイコンをクリックします。
アラート・サブスクリプションのリストが表示されます。

図10-8 連絡先のアラート・サブスクリプション

3. アラートの表示が終了したら、連絡先の矢印をもう一度クリックして、アラート・サブスクリプション・リストを閉じます。

10.4 連絡先の削除

連絡先の作成後、不要になった場合は連絡先リストから削除できます。連絡先でイベントのアラートを受信する必要がなくなった場合は、連絡先をそのイベントからサブスクライブ解除できます。

連絡先を削除するには

1. ヘルスケア統合ユーザー・インタフェースの「デザイナ」タブで、「管理」タブをクリックし、「アラートと連絡先」をダブルクリックします。

2. 「連絡先」リストで、削除する連絡先を選択し、「現在選択されている連絡先を削除します」(「連絡先」リストの右上にある赤いX)をクリックします。

3. 連絡先がいずれかのアラートをサブスクライブしている場合は、確認ダイアログが表示されます。「OK」をクリックして連絡先を削除します。
連絡先が「連絡先」リストから削除され、サブスクライブしていたイベントからも削除されます。

連絡先をアラートからサブスクライブ解除するには

1. ヘルスケア統合ユーザー・インタフェースの「デザイナ」タブで、「管理」タブをクリックし、「アラートと連絡先」をダブルクリックします。

2. 連絡先を削除するイベント・リストで、連絡先を選択します。

3. 「現在選択されているアラートを削除します」(イベント・リストの右上にある赤いX)をクリックします。
連絡先がリストから削除されます。

10.5 送信されたアラートの履歴の表示

各連絡先に送信されたアラートの履歴をOracle Enterprise Manager Human Workflow Engineページから表示できます。

送信されたアラートの履歴を表示するには

1. Webブラウザで、Oracle Enterprise Managerを起動してログインします。URLは次のとおりです。

http://hostname:port_number/em

ホスト名は、WebLogic Serverが存在するコンピュータの名前で、ポート番号は、WebLogic Serverがリスニングするポート(デフォルトでは7001)です。

2. 左側のナビゲーション・パネルで、「SOA」を展開し、「soa-infra」を選択します。

3. soa-infraページで、「SOAインフラストラクチャ」メニューの「サービス・エンジン」をポイントし、「ヒューマン・ワークフロー」を選択します。

4. ヒューマン・ワークフロー・エンジン・ページで、「通知管理」タブをクリックします。

11 Healthcareユーザー監査証跡の表示

この章では、ヘルスケア統合コンポーネントおよびアプリケーションのユーザー・アクティビティの監査証跡を有効化および構成する方法を説明します。Oracle SOA Suite for healthcare integrationは、Oracleの共通監査フレームワークを使用して、ヘルスケア統合コンポーネントに対するユーザー・アクティビティをログします。

この章には次のトピックが含まれます:

- 11.1項「監査証跡の概要」

- 11.2項「ヘルスケア統合監査証跡の構成」

- 11.3項「ユーザー監査ログの表示」

11.1 監査証跡の概要

Oracle監査フレームワークは、構成されたコンポーネントに影響を与えるイベントに関する情報を収集して格納し、これらのコンポーネントのアクティビティに関する監査ログを提供して、コンプライアンス要件のサポートを支援します。それぞれのSOA Suiteコンポーネントの監査は、監査ポリシーによって定義されます。監査ポリシーは、監査ログに取得するコンポーネントとアクティビティを定義します。必要な情報のみを取得して他の情報は無視するように監査ポリシーを構成できます。これはOracle Enterprise Managerの「監査ポリシー」ページで行います。詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの監査ポリシーの管理に関する項を参照してください。

それぞれのアプリケーションとコンポーネントの監査可能なイベントのセットは、監査ポリシーによって定義され、各アプリケーションによって異なります。コンポーネントのイベント・リストを開くと、そのコンポーネントで監査可能なイベントのみがリストに表示されます。さらに、各イベントについて、成功した試行のみをログするか、失敗した試行のみをログするかを指定できます(現在Oracle SOA Suite for healthcare integrationは、成功した試行のみをログします)。

監査を構成する際は、次の監査レベルから選択できます。

- 低: このオプションでは、監査ポリシー・リストの監査可能なすべてのコンポーネントから、Oracle SOA Suite for healthcare integrationイベントのサブセットを含むイベントのサブセットが選択されます。このオプションでは、カスタム・フィルタは作成できません。

- 中: このオプションでは、監査ポリシー・リストの監査可能なすべてのコンポーネントから、すべてのOracle SOA Suite for healthcare integrationイベントを含むイベントのより大きなサブセットが選択されます。このオプションでは、カスタム・フィルタは作成できません。

- カスタム:このオプションを使用すると、監査するコンポーネント、イベントおよび条件のみを選択できます。これはOracle SOA Suite for healthcare integrationで推奨されるレベルです。Oracle Healthcareの監査を有効にするには、Oracle Enterprise Managerコンソールでこのレベルを選択する必要があります。

実行したアクションや使用したコンポーネントに関係なくアクティビティを監査するユーザーのリストも指定できます。これらのユーザーに対しては、定義した監査レベルまたはフィルタに関係なく監査が行われます。

監査ポリシーの詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの監査の構成と管理に関する項を参照してください。

11.1.1 Oracle SOA Suite for Healthcare Integrationの監査オプション

監査可能なコンポーネントとイベントは、Oracle Enterprise Managerの「監査ポリシー」ページにリストされます(Weblogicドメイン→「セキュリティ」→「監査ポリシー」)。これらのオプションを表示または構成するには、「監査コンポーネント名」リストから「Oracle SOA Suite for healthcare integration」を選択し、「監査レベル」リストから「カスタム」を選択して、イベントの隣のチェック・ボックスをクリックします。

図11-1 監査ポリシー・ページでのヘルスケア統合コンポーネント

注意:

現在はSUCCESSイベントのみが監査されます。FAILUREイベントは選択しないでください。

Oracle SOA Suite for healthcare integrationでは現在、次のコンポーネントとイベントの監査がサポートされています(リストには他のイベントも表示されますが、それらのログは現在のところ行われません)。

- ユーザー・セッション

- ユーザー・ログイン

- ユーザー・ログアウト

- エンドポイント管理

- エンドポイントの有効化

- エンドポイントの無効化

- ドキュメント管理

- メッセージの再発行

- メッセージのパージ

- ペイロードの読取り

11.1.2 監査でのフィルタ条件の使用

それぞれのイベントについて、成功条件のフィルタを定義できます。フィルタでは、イベントの属性に基づいたルールベースの式を使用します。Oracle SOA Suite for healthcare integrationのほとんどのユーザー・アクセス監査では、次の属性をフィルタ式に使用できます。

- ホストID

- ホスト・ネットワーク・アドレス

- イニシエータ

- クライアントIPアドレス

- リソース

- ドメイン名

式にはANDおよびOR演算子に加え、次と等しい、次で始まる、次を含む、次と等しくない。といった様々な比較関数を含めることができます。

11.2 ヘルスケア統合監査証跡の構成

監査ポリシーは、Oracle Enterprise Managerで監査ログに含めるイベントやコンポーネント選択することで構成します。現在、Oracle B2Bコンポーネントおよびイベントは、監査証跡に含まれません。

デフォルトの構成は低および中の監査レベルの2つで、コンポーネントまたはイベントの定義済のサブセットが選択されます。これらはOracle SOA Suite for healthcare integrationではお薦めできません。なぜなら、これらは、Oracle SOA Suite for healthcare integrationのコンポーネントのみでなく、監査可能なすべてのコンポーネントに影響するからです。これらのオプションのいずれかを選択すると、無関係な監査エントリと不必要に大きな監査ログが生成される可能性があります。さらに、これら2つのオプションでは、フィルタをまったく定義できません。

次の手順は、カスタムレベルの監査ポリシー構成に適用されます。

ヘルスケア統合の監査を構成する手順は次のとおりです。

1. Oracle Enterprise Managerにログインします。

2. 左側のナビゲーション・パネルで、「WebLogicドメイン」を開き、ユーザー監査を有効にするドメインの名前を右クリックします。

3. 表示されたコンテキスト・メニューで、「セキュリティ」をポイントして、「監査ポリシー」を選択します。

図11-2 WebLogicドメインのセキュリティ・コンテキスト・メニュー

4. 「監査レベル」フィールドで、「カスタム」を選択します。
「監査用に選択」列にチェック・ボックスが表示され、監査対象のヘルスケア統合コンポーネントおよびイベントを選択できます。

5. 「ユーザー・セッション」といったイベント・カテゴリをクリックし、そのカテゴリに関するイベントのリストを下部に表示します。

6. 次のいずれかを実行します。

- Oracle SOA Suite for healthcare integrationのすべてのコンポーネントとイベントの監査を有効にするには、「すべてのイベントを監査」ボタンをクリックします。

- 特定コンポーネントのすべてのイベントの監査を有効にするには、コンポーネント名の隣の「監査用に選択」列のチェック・ボックスをクリックします。
たとえば、エンドポイントに対して行われるすべてのアクションを監査するには、「 エンドポイント管理」のチェック・ボックスを選択します。

図11-3 すべてのイベントが選択されたエンドポイント管理コンポーネント

- コンポーネントの特定イベントの監査を有効にするには、そのコンポーネントを開き、コンポーネント下のイベント名の隣の「監査の有効化」列のチェック・ボックスを選択します。

7. 成功条件のフィルタを定義するには、成功条件について「監査の有効化」を選択し、その「フィルタの編集」アイコンをクリックします。表示されたダイアログでフィルタを定義して、「OK」をクリックします。
フィルタの詳細は、11.1.2項「監査でのフィルタ条件の使用」および「フィルタの編集」ダイアログから使用できるオンライン・ヘルプを参照してください。フィルタは、現時点の成功条件についてのみ定義できます。

8. コンポーネントの構成に関係なく常にそのアクティビティを監査するユーザーのリストを指定するには、「常に監査するユーザー」セクションにユーザー・アカウントのリストを入力します。アカウント名はカンマで区切ります。

9. 監査の構成が完了したら、「適用」をクリックします。

10. 変更を有効にするためにサーバーを再起動します。

11.3 ユーザー監査ログの表示

イベントが監査ログの入力をトリガーすると、イベント情報が監査ログ・ファイルに書き込まれます。監査ログには次の情報が取得されます。入力をトリガーしたイベント・タイプに応じて、これらのフィールドの一部は空になる場合もあります。

- 日付と時刻

- イベントのイニシエータ

- イベント・タイプ

- イベント・ステータス

- メッセージ・テキスト(何が発生したかを示します)

- ECID

- RID

- コンテキスト・フィールド

- セッションID

- ターゲット・コンポーネント・タイプ

- アプリケーション名

- イベント・カテゴリ

- スレッドID

- 失敗コード

- リモートIPアドレス

- ターゲット

- リソース

- ロール

- 認証方式

- 理由

監査ログ・ファイルは直接表示できます。これは次の場所に書き込まれます。

fmw_home/user_projects/domains/domain_name/servers/managed_server_name/logs/auditlogs/SOA-HCFP/audit.log

12 リポジトリの管理

この章では、ヘルスケア統合メタデータ・リポジトリについて説明し、格納データの管理手順を示します。Oracle SOA Suite for healthcare integrationの設計時データとインスタンス・データはメタデータ・リポジトリに格納され、データのインポート、データのエクスポートおよびメタデータやインスタンス・データのパージを実行できます。

この章には次のトピックが含まれます:

- 12.1項「Oracle SOA Suite for Healthcare Integrationリポジトリの概要」

- 12.2項「設計時リポジトリのインポートおよびエクスポート」

- 12.3項「リポジトリ・データのパージ」

12.1 Oracle SOA Suite for Healthcare Integrationリポジトリの概要

Oracle SOA Suite for healthcare integrationインスタンス・データは、データベースのSOAINFRAスキーマ内で格納および管理されます。設計時および構成用のメタデータは、Oracle Fusion Middlewareで使用できるMetadata Services (MDS)を介して格納および管理されます。MDSの詳細は、Oracle Fusion Middleware管理者ガイドを参照してください。

12.1.1 リポジトリのメンテナンス

healthcare integrationユーザー・インタフェースは、リポジトリ・データのインポート、リポジトリ全体のエクスポート、設計時メタデータのパージ、インスタンス・データのパージなど、リポジトリ・データの管理に役立つ機能を提供します。ドキュメント定義、マップ・ファイル、エンドポイント、エクスポートされたリポジトリなどのオブジェクトをインポートできます。

設計時メタデータには、エンドポイント、ドキュメント定義、内部デリバリ・チャネルおよびマップセットが含まれます。インスタンス・メタデータは、実行時にメッセージが処理される際に作成される情報です。リポジトリ管理ページでこの2つのタイプのデータをパージできることに加えて、レポート・ページでメッセージをパージすることもできます。

インポートおよびパージ機能を使用する場合は注意してください。インポート中に、既存のデータを上書きし、データをパージするとデータが永久に削除されることがあります。

12.1.2 インポートまたはエクスポート・プロセス中に行われる処理

ファイルをエクスポートすると、healthcare integrationメタデータ・リポジトリ全体がエクスポートされ、エクスポートしたデータを含むZIPファイルが作成されます。ファイルをインポートすると、ドキュメント、エンドポイント、コールアウト、マップセットなど、エクスポート・ファイル内のすべてのオブジェクトがコピーされます。インポート手順中に既存のメタデータの置換を選択した場合、エクスポート・ファイル内のメタデータと同じ名前の既存のメタデータは、インポートされる情報で上書きされます。

Javaコールアウトで使用されるライブラリJARファイルは、インポートまたはエクスポート手順中にコピーされません。

設計時リポジトリをエクスポートし、続いてそのリポジトリの内容をヘルスケア統合ユーザー・インタフェースで変更した場合およびエクスポートしたファイル(内容は古い)を後でインポートした場合は、次のように更新されます。

- インポート時に「既存のメタデータの置換」が選択されていない場合、ファイルのエクスポート後にhealthcare integrationユーザー・インタフェースで作成または変更された新規データは変更されません。

- インポート時に「既存のメタデータの置換」が選択されている場合は、既存のメタデータがZIPファイルのメタデータに置き換えられます。

インポートに失敗すると、変更内容がロール・バックされ、設計時リポジトリは変更前の状態に戻ります。インポートに失敗したことを示すメッセージが表示されます。

12.1.3 エクスポート済ファイルについて

ファイルにエクスポートされた設計時リポジトリの内容は、現行データのコピーを表します。このファイルは、Oracle SOA Suite for healthcare integrationにインポートし直して戻さないかぎり、healthcare integrationユーザー・インタフェースからアクセスして変更することはできません。エクスポートしたファイルを手動で編集しないでください。

12.1.4 パージ・プロセス中に行われる処理

設計時メタデータとインスタンス・データの両方をパージできます。設計時メタデータには、ドキュメント定義、エンドポイント、マップセットおよび内部デリバリ・チャネルが含まれます。このデータをパージした場合、インストールの一部である事前定義済のデータはパージされません。設計時メタデータのパージが正常に終了すると、healthcare integrationユーザー・インタフェースからログアウトされるため、再度ログインする必要があります。アクティブ・エンドポイントが存在する場合は設計時メタデータはパージできません。

インスタンス・データは、実行時にメッセージが処理される際に生成されます。インスタンス(実行時)データには、ビジネス・メッセージとメッセージ関連データが含まれています。特定のインスタンス・データは、レポート・ページからパージできます。詳細は、「レポートの作業」を参照してください。

パージは、次の目的のために役立ちます。

- ディスク領域の管理およびパフォーマンスの向上

- テスト・システム上のリポジトリの削除

12.1.5 管理番号のパージ

インスタンス・データをパージする場合、必要に応じて管理番号情報をパージできます。管理番号は、HL7メッセージ標準で使用されます。Oracle SOA Suite for healthcare integrationは、インバウンドおよびアウトバウンド・メッセージの管理番号を追跡します。アウトバウンド・メッセージの場合、管理番号は内部管理番号表から順番に生成されます。インスタンス・データと管理番号をパージすると、順序がリセット(管理番号表がリセット)されるため、パージ後のアウトバウンド・メッセージにはパージ前のメッセージと同じ管理番号が設定される場合があります。これが望ましくない場合は、管理番号をパージしないでください。

12.2 設計時リポジトリのインポートおよびエクスポート

Oracle SOA Suite for healthcare integrationの設計時データは、ZIPファイルにエクスポートおよび保存できます。データをヘルスケア統合ユーザー・インタフェースで使用できるように、ZIPファイルをOracle SOA Suite for healthcare integrationに再度インポートできます。これは、テスト環境から本番環境にデータを移行する際に役立ちます。

注意:

エクスポートしたファイルは手動で編集しないでください。これにより、再度インポートした後のデータが不安定になることがあります。

図12-1に、設計時データのインポートとエクスポートを行う「リポジトリ管理」タブを示します。

図12-1 リポジトリ管理ページ

メタデータのインポート時に、「既存のメタデータの置換」オプションを選択しないと、既存のリポジトリに対する更新内容が累積されます。メタデータをインポートする前に既存のデータをすべて削除するには、「設計メタデータのパージ」ボタンを使用します。

注意:

エクスポート操作は、中断やアイドル時間なしで完了してください。エクスポート操作中にブラウザを数分以上アイドル状態にすると、ファイルが破損する場合があります。

リポジトリ・メタデータをインポートするには

1. インポートするメタデータ・リポジトリZIPファイルがローカル・システムから使用可能であることを確認します。

2. ヘルスケア統合ユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

3. 「リポジトリ管理」をクリックします。

4. 「インポート」セクションで、「参照」をクリックしてメタデータ・リポジトリZIPファイルを探します。
複数のZIPファイルが含まれているZIPファイルをインポートする場合は、そのZIPファイルを解凍し、中に含まれている各ZIPファイルを個別にインポートする必要があります。

5. メタデータ・サービス(MDS)リポジトリ内の現在のメタデータを上書きするには、「既存のメタデータの置換」を選択します。
このオプションを選択しないと、新規データのみがMDSリポジトリにコピーされます。

6. 「インポート」をクリックします。
インポート処理は、設計時リポジトリの内容のサイズに応じて時間がかかる場合があります。

リポジトリ・メタデータをエクスポートするには

注意:

エクスポートしたファイルは手動で編集しないでください。

1. ヘルスケア統合ユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「リポジトリ管理」をクリックします。

3. 「エクスポート」をクリックします。
エクスポート・ファイルの生成のステータスを示すダイアログが表示されます。

4. 「続行」をクリックします。

5. 表示されるダイアログで、「ファイルの保存」をクリックし、「OK」をクリックします。
デフォルトのファイル名はMDS_EXPORT_DD_MM_YYYY.zipです。

6. エクスポート・ファイルの名前を指定するかデフォルトの名前を受け入れ、ファイルのフォルダを参照して選択してから、「保存」をクリックします。

注意:

コマンドライン・ツールを使用して、設計時インポートおよびエクスポートを実行することも可能です。

12.3 リポジトリ・データのパージ

パージ機能を使用して、ディスク領域を管理してパフォーマンスを向上させ、リポジトリからテスト・データを削除します。

リポジトリ・データをパージするには

1. ヘルスケア統合ユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「リポジトリ管理」をクリックします。

3. 次のいずれかを行います:

- エンドポイント、内部デリバリ・チャネル、マップセット、コールアウト、ドキュメント定義などの設計時メタデータをパージするには、「設計メタデータのパージ」をクリックします。

注意:

このボタンは、healthcare integrationリポジトリにアクティブなエンドポイントがある場合は無効になります。この場合は、アクティブなエンドポイントを無効にし、このページに戻って設計時データをパージする必要があります。

- すべての実行時インスタンス・データ(すべてのメッセージ)をパージするには、「インスタンス・データのパージ」をクリックします。このデータの管理番号を削除する場合は、「インスタンス・データのパージ」をクリックする前に「管理番号のパージ」を選択します。

4. 確認ダイアログで「OK」をクリックします。

注意:

コマンドライン・ツールを使用して、リポジトリ・データのパージを実行することも可能です。

13 システム設定の構成

この章では、ヘルスケア統合ユーザー・インタフェースの外観の構成方法とヘルスケア統合アプリケーションの実行時処理の構成方法について説明します。

この章には次のトピックが含まれます:

- 13.1項「ランタイム設定の構成」

- 13.2項「ユーザー・インタフェース設定の構成」

13.1 ランタイム設定の構成

ランタイム設定は、Oracle SOA Suite for healthcare integrationが順序付け、機能確認、バッチ処理、Oracle BAMの有効化、デフォルトのキューなどの特定の機能を処理する方法を制御します。

ランタイム設定は、Oracle SOA Suite for healthcare integrationとOracle B2Bの間で共有されます。一方の設定を変更すると、もう一方の設定も変更されます。Oracle Enterprise ManagerのOracle B2Bの設定は、Oracle SOA Suite for healthcare integrationにも適用されます。Oracle Enterprise ManagerのOracle B2Bの設定の詳細は、Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイドのOracle B2Bの構成を参照してください。

図13-1 ランタイム設定

ランタイム設定を構成するには

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「設定」を展開し、「ランタイム」を選択します。

3. 表13-1にリストされているプロパティの値を変更します。

4. 次のいずれかを行います:

- 変更を保存するには、「適用」をクリックします。

- 設定を前の値に戻すには、「元に戻す」をクリックします。

表13-1 ランタイム構成設定

フィールド

説明

確認

自動処理されるFA

Oracle SOA Suite for healthcare integrationがインバウンドHL7メッセージの機能確認(FA)を自動的に生成するかどうかを示します。FAを自動的に生成するには、このオプションを選択します。このオプションが選択されている場合は、インバウンドFAメッセージが消費されます。

FAドキュメントを自動的に生成しない場合は、このプロパティを選択解除します。バックエンド・アプリケーション(ミドルウェア)は、FAを生成し、Oracle SOA Suite for healthcare integrationにアウトバウンド・メッセージとして提供する必要があります。このプロパティが選択解除されている場合、インバウンドFAドキュメントはバックエンド・アプリケーションに戻されます。

(エンドポイント・レベルの設定が示すとおり)ドキュメントにFAが必要ない場合、このプロパティは無視されます。このプロパティはデフォルトで選択されます。

エンドポイントでFAが必要とマーク付けされている場合、メッセージはMSG_WAIT_FAの状態になり、バックエンド・アプリケーションはFAを生成し、パートナに返すアウトバウンド・メッセージとしてFAをOracle SOA Suite for healthcare integrationに送信する必要があります。

「自動処理されるFA」が選択されていない場合、インバウンドFAをバックエンド・アプリケーションに送信するには「インバウンド機能確認の通知」も選択解除する必要があります。「インバウンド機能確認の通知」が選択され、「自動処理されるFA」が選択解除されている場合、着信機能確認は通知のみ生成し、FAドキュメント自体はバックエンド・アプリケーションに返信されません。

バックエンド・アプリケーションからのFAの生成時に、次の制限が適用されます:

- FAは、エンキュー・プロパティに設定したReferToMsgID値に基づいて、元のメッセージと相関付けられます。管理番号に基づいて相関付けられる場合もあります。

- FAに、受信したメッセージにエラーがあったことが示されている場合でも、相関メッセージの状態は、エラーを示すように更新されません。相関メッセージはMSG_COMPLETEに更新されます。

これらの制限は、FAがOracle SOA Suite for healthcare integrationで生成される場合(つまり、このプロパティが選択されている場合)には存在しません。

機能確認の内部プロパティ

元のメッセージの内部プロパティを使用して機能確認の内部プロパティ構造を生成するかどうかを示します。

デフォルトでは、このプロパティは選択解除され、機能確認では元のメッセージ内部プロパティが使用されます。

インバウンド機能確認の通知

機能確認の受信時にOracle SOA Suite for healthcare integrationが確認通知をアプリケーションに送信するかどうかを示します。確認通知を送信するには、このプロパティを選択します。

「自動処理されるFA」が選択されていない場合、インバウンドFAをバックエンド・アプリケーションに送信するには「インバウンド機能確認の通知」も選択解除する必要があります。「インバウンド機能確認の通知」が選択され、「自動処理されるFA」が選択されていない場合、着信機能確認は通知のみ生成し、FAドキュメント自体はバックエンド・アプリケーションに返信されません。

その他

自動スタック・ハンドラ

MLLPのスタック・ハンドラによって、スタックされたメッセージが自動モードで処理されるかどうかを示します。自動モードで処理するには、このプロパティを選択します。このプロパティはデフォルトで選択されます。

ペイロードをログに記録

ペイロードを診断ログに記録するかどうかを示します。このプロパティが選択されている場合、ペイロードはログに記録されますが、ログ・レベル設定にも依存します。デフォルトでは、エラー・メッセージが記録されます。ペイロード・ロギングは診断目的では有用ですが、セキュリティの理由から望ましくない場合があります。デフォルトでは、このプロパティは選択されていません。

注意: ペイロードをログに記録するには、Enterprise Managementコンソールでログレベル設定をTRACEに設定する必要があります。使用可能なログレベル設定は、TRACE、NOTIFICATION、INCIDENT_ERROR、ERRORおよびWARNINGです。

例外キュー

ホストが例外キューとして使用するJMS内部デリバリ・チャネル。例外通知は、ここで指定した名前のキューに送信されます。このパラメータがnull値の場合、例外がAQキュー(IP_IN_QUEUE)に送信されます。

一般メッセージ・タイプ

Oracle SOA Suite for healthcare integrationでHL7トリガー・イベントを無視する必要があるかどうかを示します。デフォルトでは、このプロパティは選択されていません。

アウトバウンド・ディスパッチャ数

アウトバウンド・メッセージの処理で使用するディスパッチャ数。これはメッセージ順序付けで使用します。

インバウンド・ディスパッチャ数

インバウンド・メッセージの処理で使用するディスパッチャ数。これはメッセージ順序付けで使用します。

自動スタック・ハンドラ間隔

スタック・ハンドラがスタックされたメッセージを処理する時間間隔(秒単位)。間隔にはカンマ区切りの値を入力します。

部分バッチ・コミット・サイズ

メッセージ交換用のビジネス・メッセージが多数ある場合にコミットするレコード数。

BAMの有効化

ランタイム情報をOracle BAMに送信するかどうかを示します。詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドのOracle BAMでのインスタンス・メッセージ・データのモニタリングに関する項を参照してください。

BAMポーリング間隔

Oracle BAMのポーリング間隔(分単位)。Oracle BAMが有効になっていない場合は無視されます。

相関の無視

確認が受信され、相関が失敗した場合に、相関エラーを無視するかどうかを示します。確認は、送信元の実際のビジネス・メッセージと相関付けられます。相関付けに失敗すると、例外が生成されて確認処理が停止します。この場合に相関を無視して確認の処理を続行するには、このプロパティを選択します。デフォルトでは、このプロパティは選択されていません。

パージ不可

注意: パージ不可のパラメータの値は、メタデータ・リポジトリがパージされた後も保持されます。

コールアウト・ディレクトリ

コールアウトJARファイルの場所のディレクトリ(デフォルトのコールアウトを使用しない場合)。コールアウト・ディレクトリ・パスは、スラッシュまたはバック・スラッシュ(/または\)で終了できません。

デフォルトのファイルの場所/MyCalloutDirは、メタデータ・リポジトリのパージ後も維持されます。

パフォーマンス

大きなペイロード・サイズ

大きなペイロード・サイズ(バイト単位)。デフォルト値は2,000,000 (2MG)です。

大きなペイロード・ディレクトリ

大きなペイロードを格納するディレクトリ。デフォルトのディレクトリは/tmpです。Windowsベースのシステムでは、ディレクトリを適切なディレクトリ(C:\tempなど)に変更します。

13.2 ユーザー・インタフェース設定の構成

ユーザー・インタフェース設定は、ヘルスケア統合ユーザー・インタフェースでのレポートとダッシュボードの外観を制御します。

図13-2 ユーザー・インタフェース設定

レポートとダッシュボードの時間スライダの期間を構成するには

この手順では、レポートおよびダッシュボード・ページで使用される時間スライダにリストされた値を変更します。スライダに対して最大9種類の期間を選択できます。

図13-3 レポート・フィルタ・パネルの時間スライダ

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「設定」を展開し、「UI」を選択します。

3. 「時間スライダ期間の有効化」セクションで、スライダに表示する期間を選択します。
最大9個の期間を選択できるため、表示する期間用の領域を空けるには不要な期間を選択解除してください。選択を変更すると、ダッシュボード・サマリー・スライダに対する変更が右側に表示されます。

4. 期間の選択をデフォルトにリストアするには、「デフォルトにリストア」をクリックします。

5. 変更の終了後、「適用」をクリックして変更を保存します。

レポートを構成するには

表示するレコード数、自動リフレッシュの方法、ペイロードの表示など、レポート・ページの特定の表示属性を構成できます。

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「設定」を展開し、「UI」を選択します。

3. 表13-2で説明しているプロパティの値を変更します。

表13-2 レポートの構成プロパティ

プロパティ

説明

自動リフレッシュ間隔(秒)

レポート内の情報の自動的なリフレッシュ間にブラウザが待機する必要のある時間の長さ(秒単位)。

ページ・サイズ

レポートの各ページに表示するメッセージ数。

ペイロードの表示

ユーザー権限に関係なく、メッセージ・ペイロードを表示するかどうかを示します。ペイロードを表示するには「はい」を選択します。それ以外の場合は「いいえ」を選択します。

ペイロード表示サイズ(バイト)

表示する各メッセージ・ペイロードの最大バイト数。ペイロードが指定したバイト数より大きい場合、ペイロードは表示されません。

4. 変更の終了後、「適用」をクリックして変更を保存します。

ダッシュボード・サマリーのデフォルト期間を構成するには

この手順では、ダッシュボード・サマリー・ページに情報が表示されるデフォルトの期間を変更します。たとえば、「5日」を選択した場合は、ダッシュボードを開くと、選択したエンドポイントの過去5日間のサマリーが表示されます。「週」を選択した場合は、前週のサマリーが表示されます。

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「設定」を展開し、「UI」を選択します。

3. 「ダッシュボード・サマリー」セクションで、スライダのポインタをダッシュボード・サマリー・ページのデフォルトとして使用する期間に移動します。

4. 変更の終了後、「適用」をクリックして変更を保存します。

ダッシュボードでエンドポイント詳細を構成するには

ダッシュボードのエンドポイントの詳細ページの外観を構成できます。これは、ダッシュボード・サマリー・ページのエンドポイントの「エンドポイントの詳細」アイコンをクリックすると表示されるページです。

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースで、「デザイナ」タブをクリックし、「管理」タブをクリックします。

2. 「設定」を展開し、「UI」を選択します。

3. 表13-3で説明しているプロパティの値を変更します。

表13-3 「エンドポイントの詳細」の構成プロパティ

プロパティ

説明

ゲージ列の数

処理されたドキュメント・タイプ・セクションの各行に表示するメッセージ・タイプ・ゲージの数。

自動リフレッシュ間隔(秒)

ダッシュボード内のエンドポイント詳細の自動的なリフレッシュ間にブラウザが待機する必要のある時間の長さ(秒単位)。

ドキュメント・タイプ表示

ドキュメント・タイプ情報をゲージ形式と表形式のどちらで表示するかを示します。図13-4および図13-5に、各形式の例を示します。

順序付けの遅さのしきい値(秒)

処理が低速であるとみなされる前に順序メッセージがキュー内で待機できる秒数。処理が低速であるとみなされると、ダッシュボードのエンドポイントの詳細ページでステータスが黄色で表示されます。

図13-4 ゲージ形式のドキュメント・タイプ情報

図13-5 表形式のドキュメント・タイプ情報

4. 変更の終了後、「適用」をクリックして変更を保存します。

14 ユーザーのプロビジョニング

この章では、Oracle Healthcareコンソールでユーザーにロールを指定することで、ユーザーをプロビジョニングする方法について説明します。

この章の内容は次のとおりです。

- 14.1項「ユーザーの作成」

- 14.2項「ユーザーの追加

- 14.3項「ユーザー・プロビジョニングの編集、表示および削除

14.1 ユーザーの作成

Oracle Healthcare管理者(デフォルトのログイン・ユーザー名とパスワードの組合せ)は、Oracle Healthcareコンソールを使用してユーザー(Weblogicデフォルト・ストアの登録ユーザー)を追加できます。これらのユーザーはOracle Healthcareにログインし、エンドポイントの表示のみ行うことができます。

次のロールを使用できます。

- 管理者ロール: Oracle Healthcareのすべての機能にアクセスできます。

- 監視ロール: レポートおよびメトリック機能への読取りアクセスを提供します(「レポート」リンクを使用)。

管理ロールを持つユーザーは、すべてのOracle Healthcare機能にアクセスできます。モニター・ロールを持つユーザーは、レポートへの読取りアクセスしかありません。

アイデンティティ・ストア(Oracle Weblogic Serverコンソール内)を使用してユーザーを作成し、コンソールでそれらのユーザーに特定のロールをプロビジョニングできます。

ユーザーの作成の詳細は、Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイドの取引パートナ・ユーザーの追加のタスク1 アイデンティティ・ストアでの新規ユーザーの作成に関する項を参照してください。

14.2 ユーザーの追加

Oracle Weblogic Serverコンソールで登録済ユーザーを作成した後、「デザイナ」タブの「管理」の下にある「ユーザー・プロビジョニング」リンクを使用して、Oracle Healthcareにユーザーを追加できます。

注意:

セキュリティ上の問題により、WebLogic管理者グループに属する登録済ユーザーのみがOracle Healthcareコンソールのユーザー・プロビジョニング機能にアクセスできます。他のユーザーは「ユーザー・プロビジョニング」リンクを使用できません。

ユーザーを追加してプロビジョニングするには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 「デザイナ」タブで「管理」をクリックしてから、左側のパネルで「ユーザー・プロビジョニング」をダブルクリックします。

3. 右側の「ユーザー・プロビジョニング」ペインで、「ユーザー」表の下にある「Healthcare UIの新規ユーザー・プロビジョニングの追加」(+アイコン)をクリックします。これにより、表に空白行が追加されます。

4. 新しい行をクリックして選択します。

5. 「名前」フィールドの既存のプロンプトをクリアし、登録済のユーザーを選択またはプロビジョニングするために、次のいずれかを実行します。

- 登録済ユーザー名の最初の数文字(デフォルトでは大/小文字の区別なし)を入力して、「参照」ボタン(虫眼鏡アイコン)をクリックするか[Tab]キーを押します。
一致する結果が1つのみの場合は、それが自動的に選択され、ユーザー名が「名前」フィールドに移入されます。一致する結果がゼロまたは複数の場合は、「Healthcare UIへのアクセスをプロビジョニングするための登録済ユーザーの選択」ダイアログ・ボックスが表示され、検索を絞り込んだり、結果を1つ選択したり(またはその両方)できます。図14-1に「Healthcare UIへのアクセスをプロビジョニングするための登録済ユーザーの選択」ダイアログ・ボックスを示します。

図14-1 一致する全ユーザー・リストからのユーザーの選択

- 選択するユーザー名が確かでない場合は、図14-2に示すように、「参照」をクリックするか[Tab]を押すと、プロビジョニングに使用可能なすべてのユーザーをリストする「Healthcare UIへのアクセスをプロビジョニングするための登録済ユーザーの選択」ダイアログ・ボックスが表示されます。

図14-2 すべての登録済ユーザーのリストを表示

必要なユーザー名がダイアログ・ボックスに表示されていない場合は、ダイアログ・ボックスの「名前」フィールドに登録済ユーザー名の最初の数文字を入力すると、結果の表に値が自動的に移入されます。大/小文字を区別しない検索を実行する必要がある場合は、「大/小文字を区別しない」チェック・ボックスを選択します。入力フィールドをクリアして[Tab]を押し、プロビジョニングに使用可能なすべてのユーザーを参照することもできます。

注意:

登録済ユーザーを選択すると、「説明」フィールドにWebLogic管理コンソールでユーザーに指定した説明が自動的に入力されます。Oracle Healthcareコンソールで説明を変更することはできません。

注意:

「Healthcare UIへのアクセスをプロビジョニングするための登録済ユーザーの選択」ダイアログ・ボックスでOracle WebLogic管理グループに含まれるユーザーを検索しようとすると、次の図に示すように、WebLogic管理グループに属するユーザーはプロビジョニングする必要がないことを示すエラー・メッセージが表示されます。

6. 「ロール」リストから、ユーザーに付与するロールを選択します。図14-3に示すように、使用可能な値は「管理者」と「モニター」です。

図14-3 ユーザーのロールの選択

デフォルトでは、追加されたすべての新規ユーザーは、最初にOracle Healthcareコンソールで監視ロールに対してプロビジョニングされます。ユーザーがWebLogic管理者グループに属する場合は例外です。この場合、ユーザーはプロビジョニングに使用できません(すでに管理者グループに追加されています)。

図14-4に示すように、ユーザーに選択したロールに基づいて、ユーザー・アイコンは変化します。

図14-4 ユーザー・アイコンの変更

7. 「適用」をクリックして変更内容を保存し、ユーザー・プロビジョニングを完了します。

注意:

Oracle Healthcareコンソールのすべての登録済ユーザーをプロビジョニングした後、「Healthcare UIの新規ユーザー・プロビジョニングの追加」(+アイコン)をクリックすると、プロビジョニングに使用できるユーザーはこれ以上いないことを示す次のウィンドウが表示されます。

14.3 ユーザー・プロビジョニングの編集、表示および削除

Oracle Healthcareコンソールを使用して、ユーザー・プロビジョニングを編集、削除および表示できます。

既存のユーザー・プロビジョニングを編集するには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 「デザイナ」タブで「管理」をクリックしてから、左側のパネルで「ユーザー・プロビジョニング」をクリックします。

3. 「ユーザー」表で必要なユーザー行をクリックします。これにより、「ロール」リストの編集が可能になります。

4. 「ロール」リストから必要なロールを選択します。

ユーザー詳細を表示するには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 「デザイナ」タブで「管理」をクリックしてから、左側のパネルで「ユーザー・プロビジョニング」をクリックします。

3. 図14-5に示すように、「ユーザー」表の必須ユーザーの左にある展開(下向き矢印)アイコンをクリックします。

図14-5 ユーザー詳細の表示

注意:

ユーザー詳細は、ユーザーの作成時に使用したOracle WebLogicセキュリティ・レルムからフェッチされます。

既存のユーザー・プロビジョニングを削除するには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 「デザイナ」タブで「管理」をクリックしてから、左側のパネルで「ユーザー・プロビジョニング」をクリックします。

3. 「ユーザー」表で必要なユーザー名の行をクリックしてから「選択したユーザー・プロビジョニングの削除」(X)アイコンをクリックします。削除は簡単に元に戻せるため、確認は不要です。

注意:

ユーザー・プロビジョニングを削除すると、登録ユーザーのOracle Healthcareコンソールへのアクセスのプロビジョニングみが削除されます。ユーザーはデフォルトのOracle WebLogicセキュリティ・レルムから削除されません。

14.4 ペイロード表示のためのユーザーのプロビジョニング

ペイロード表示のためのOracle Healthcareユーザー・プロビジョニングは、次の原則に従っています。

- WLS管理者グループに属するユーザーは常にすべてのドキュメント・タイプ・ペイロードを表示でき、Oracle Healthcareコンソールでプロビジョニングする必要はありません。

- 特定のドキュメント・タイプ・プロビジョニングなしでOracle Healthcare管理者またはモニター・ロールに対してプロビジョニングされているユーザーは、すべてのドキュメント・タイプ・ペイロードを表示できます。

- 脚注 1 特定のドキュメント・タイプ・プロビジョニングありでOracle Healthcare管理者または監視ロールを持つユーザーは、それらの特定のドキュメント・タイプ・ペイロードのみ表示できます。

14.5 ユーザー・プロビジョニングの変更を元に戻す

「ユーザー・プロビジョニング」ペインの右上の 「元に戻す」ボタンをクリックすることで、Oracle Healthcareコンソールでユーザー・プロビジョニングに行った変更を元に戻すことができます。

脚注の説明

脚注 1: 詳細は、http://www.oracle.com/technetwork/middleware/docs/aiasoarelnotesps6-1866030.html#hcfpにあるOracle Healthcareの既知の問題を参照してください。

15 Oracle HealthcareにおけるWebサービス・ベースのメッセージ交換の有効化

この章では、Oracle SOA Suite for healthcare integrationにおいて、エンドポイント間でWebサービス・ベースのメッセージ交換(通常はSOAPベース)を有効化する方法について説明します。

この章の内容は次のとおりです。

- 15.1項「Webサービス・ベースのメッセージ交換の概要」

- 15.2項「カスタムWSDLを使用したSOAPベースのサービス・メッセージの交換」

- 15.3項「カスタムSOAPヘッダーの送信」

- 15.4項「リクエスト/リプライ・シナリオの例」

15.1 Webサービス・ベースのメッセージ交換の概要

Oracle Healthcareでは、Webサービス(SOAP)ベースのメッセージをエンドポイント間で交換できます。インバウンドおよびアウトバウンド方向の両方でメッセージを交換できます。ただし、現在これがサポートされているのは、HTTP経由のSOAP 1.1メッセージのみです。

Webサービス機能により、エンドポイントでのメッセージの送受信が可能になるだけでなく、プロトコル実装として階層化され、レポートや追跡、監査など、その他の一般的な機能も使用できるようになります。

多くの企業が、Healthcare固有のプロトコルに加え、Webサービスを使用したエンドポイント・ファイルの転送やメッセージ交換の統合に、要件を設けるようになってきています。

15.2 カスタムWSDLを使用したSOAPベースのサービス・メッセージの交換

SOAPベース・メッセージは、インバウンドおよびアウトバウンド方向の両方でサポートされます。要件に応じたカスタマイズが可能なWeb Service Definition Language (WSDL)ファイルを作成または更新する必要があります。

15.2.1 アウトバウンドのSOAPベース・メッセージの交換

アウトバウンドのSOAPベース・メッセージの交換を可能にするには、次のタスクを実行する必要があります。

- タスク1 WSDLのアップロード

- タスク2 ドキュメントの作成

- タスク3 エンドポイントの作成

タスク1   WSDLのアップロード

1つ目のタスクでは、Webサービスを登録してメッセージを交換するために必要な、WSDLファイルをアップロードする必要があります。次のいずれかの方法でWSDLをアップロードできます。

- インラインWSDL - XSD情報がWSDL自体に定義されている通常のWSDLファイル

- WSDLファイルとXSDファイルが含まれているZIPファイル

- 複数のWSDLファイルとXSDファイルが含まれているZIPファイル

WSDLをアップロードするには:

1. Oracle SOA Suite for healthcare integrationコンソール(http://<hostname>:<port>/healthcare)にログインします(ここで、hostnameは、Oracle SOA Suiteがホストされているコンピュータの名前で、portは、SSL以外の接続の場合には、通常、8001です)。

2. 「デザイナ」タブ、「構成」タブの順にクリックします。

3. 「WSDL」フォルダをクリックして選択します。

4. +アイコン(作成)をクリックします。「WSDLの作成」ダイアログが表示されます。

5. TransmitWSDLなど、WSDLの名前を指定します。名前に空白または特殊文字が使用されていないことを確認します。

6. 「定義ファイル」フィールドで、「参照」ボタンをクリックして、アップロードするWSDLを選択します。この例では、選択されているWSDLはTransmitDoc2way.wsdlです。「OK」をクリックして、プロセスを完了します。
図15-1に、新しく作成されたWSDLを示します。

図15-1 アップロードされたWSDL

7. 確認ダイアログで「保存」、「OK」の順にクリックします。

タスク2   ドキュメントの作成

次のタスクでは、アウトバウンド・フロー用のドキュメントを作成します。現在、サポートされているドキュメント・タイプはカスタムのみであることに注意してください。

カスタム・ドキュメントを作成するには:

1. 3.4項「ドキュメント定義の作成」に指定されているようにドキュメント定義を作成します。次のように指定します。

- ドキュメント・バージョン - 1.0

- ドキュメント・タイプ - TransmitDocumentRequest

- ドキュメント定義 - TransmitDocumentDef

2. 「WSDLの使用」を選択します。

3. 関連するWSDLアーティファクトを選択します(この場合はTransmitWSDL)。

4. 必要なWSDLメッセージを選択します(図15-2に示すように、この場合は、TransmitDocumentsRequestMessageです)。

図15-2 ドキュメントの作成

5. 「適用」をクリックします。

タスク3   エンドポイントの作成

カスタム・ドキュメントを作成したら、エンドポイントを作成し、そのエンドポイントをカスタム・ドキュメントに関連付ける必要があります。

エンドポイントを作成するには:

1. Oracle Healthcareコンソールで、「デザイナ」タブの「構成」の下にある「エンドポイント」フォルダをクリックします。

2. +アイコン(作成)をクリックします。「エンドポイントの作成」ダイアログ・ボックスが表示されます。

3. 「トランスポート・プロトコル」リストから、WS-HTTPを選択します。

4. エンドポイントの名前を指定します。

5. 同じ接続を使用してドキュメントの送受信を可能にする場合は、「同期」チェック・ボックスを選択します。この場合、チェック・ボックスはそのままにします。

6. 「方向」リストから「アウトバウンド」を選択します。

7. 「WSDL」リストから必要なWSDLを選択します。この場合は、タスク1でアップロードしたTransmitWSDLを選択します。

注意:

カスタムWSDLをアップロードして使用しない場合は、「汎用SOAPの使用」チェック・ボックスを選択できます。これにより、任意のXMLドキュメントをSOAP経由で送信できるようになります。Oracle SOA Suite for healthcare integrationには、「汎用SOAPの使用」を選択する場合に使用する、事前シード済の汎用WSDLが用意されています。

8. 使用可能なサービス(この場合はTransmitsDocumentService)を選択します

9. 使用可能なポート(TransmitDocuments2WayPort)を選択します

10. SOAPアクションを選択します(「WSDL」から選択可能)

注意:

前述のパラメータに、手動で文字列値を指定することも可能です。サービス名を手動で指定する場合は、次の形式でないと、検証エラーが発生します。

{namespace}ServiceName

11. 「URL」フィールドに、サーバーがリスニングするURLを入力します。
エンドポイント構成は、図15-3のようになります。

図15-3 エンドポイントの作成

12. 「OK」をクリックします。

注意:

アップロードしたWSDLがエンドポイントによって使用されると、そのWSDLファイルは更新できなくなります。

13. TransmitOutboundページの「送信するドキュメント」セクションで、+ (追加)アイコンをクリックして、「ドキュメント」ウィンドウを表示します。

14. 必要なカスタム・ドキュメント定義(TransmitDocumentDef)に移動してそれを選択し、「OK」をクリックして、そのドキュメントをエンドポイントに関連付けます。

15. 「トランスポートの詳細」ボタンをクリックして、「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスを表示します。ここでは、次のことが可能です。

- 必要な場合は、追加のHTTPヘッダーを入力します。

- 交換するメッセージの中にWS Addressingヘッダーを含めない場合は、「WS Addressingヘッダーの省略」を選択します。

- Oracle Healthcare Webサービスのアウトバウンド・チャネルで、To、Doctype、DocRevisionなどのデフォルトのSOAPヘッダーを送信しないようにする場合は、「OracleのデフォルトSOAPヘッダーの省略」を選択します(図15-4を参照)。

- 必要な場合は、「詳細」タブで、追加のSOAPヘッダーを入力します。

図15-4 トランスポート・プロトコル・パラメータ

- 「OK」をクリックして、エンドポイント・ページに戻ります。

16. 図15-5に示すように、「有効」チェック・ボックスを選択し、「適用」をクリックして、エンドポイントをアクティブ化します。

図15-5 アウトバウンド・メッセージ交換用のエンドポイントの構成

15.2.2 インバウンドのSOAPベース・メッセージの交換

インバウンドのSOAPベース・メッセージを交換するには、次のタスクを実行する必要があります。

- タスク1 WSDLのアップロード

- タスク2 インバウンド・フロー用のドキュメントの作成

- タスク3 インバウンド・メッセージ交換用のエンドポイントの作成

タスク1   WSDLのアップロード

このタスクは、アウトバウンドの「タスク1 WSDLのアップロード」と同じです。

タスク2   インバウンド・フロー用のドキュメントの作成

このタスクは、アウトバウンドの「タスク2 ドキュメントの作成」と同じです。

タスク3   インバウンド・メッセージ交換用のエンドポイントの作成

カスタム・ドキュメントを作成したら、エンドポイントを作成し、そのエンドポイントをカスタム・ドキュメントに関連付ける必要があります。

このタスクは、アウトバウンドの「タスク3 エンドポイントの作成」に似ていますが、次の点が異なります。

- 「エンドポイントの作成」ダイアログ・ボックスで、エンドポイント名に「TransmitInbound」を指定し、方向に「インバウンド」を選択します。

- TransmitInboundページで、「受信するドキュメント」セクションにカスタム・ドキュメントを追加します。

注意:

リスニング・メッセージにWebサービスが登録されていることを確認するには、次のURLにアクセスし、ユーザー名とパスワードを指定してログインし、登録済のWebサービスのリストに該当のWebサービスがあることを確認します。

http:<host>:<port>/b2b/services

Oracle Weblogic Serverコンソールにユーザーを作成する必要があります(パスワードも指定してください)。Oracle Weblogic Serverコンソールでのユーザー作成の詳細は、次のリンクにアクセスしてください。

http://docs.oracle.com/cd/E23943_01/apirefs.1111/e13952/taskhelp/security/ManageUsersAndGroups.html

Webサービスは、次の書式でリストされています。

ws/WebService

次の図に示されている、それぞれの「WSDL」リンクをクリックすると、特定のサービスからWSDLをダウンロードできます。

15.3 カスタムSOAPヘッダーの送信

Oracle Healthcareでは、アウトバウンドのWebサービス・ベース・メッセージの一部として、カスタムSOAPヘッダーを送信できます。

アウトバウンドJMSチャネルの場合、次の例に示すように、送信者取引パートナは、複数レベルのカスタムSOAPヘッダーを送信できます。

<CustomSOAPHeader xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<hello xmlns="http://xmlns.oracle1.com/soa1/generic/soap">
<name xmlns="http://MY_NAME_SPACE">
<firstname>John</firstname>
<lastname>Doe</lastname>
</name>
</hello>
</CustomSOAPHeader>

アウトバウンド・ファブリックの場合、次の例に示すように、送信者は複数レベルのカスタム・ヘッダーを送信できます。

<bpelx:inputProperty name="hc.customSOAPHeaders" expression="'<CustomSOAPHeader xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<hello xmlns="http://xmlns.oracle1.com/soa1/generic/soap">
<name xmlns="http://MY_NAME_SPACE">
<firstname>John</firstname>
<lastname>Doe</lastname>
</name>
</hello>
</CustomSOAPHeader>

15.4 リクエスト/リプライ・シナリオの例

この項では、Webサービスまたは汎用SOAPを使用する場合の、同期されたリクエスト/リプライ・シナリオについて説明します。

この項の内容は次のとおりです。

- 15.4.1項「アウトバウンド同期: コンポジット」

- 15.4.2項「インバウンド同期: コンポジット」

- 15.4.3項「アウトバウンド同期: JMSキュー」

- 15.4.4項「インバウンド同期: JMSキュー」

15.4.1 アウトバウンド同期: コンポジット

コンポジットとのアウトバウンド同期の場合:

- Webサービス: 同期を一方向にするか、リクエスト/リプライ・パターンを使用するかの決定は、コンポジットに依存します。soapActionが指定されている場合は、HTTP soapActionヘッダーを上書きする場合にのみ使用されます。

15.4.2 インバウンド同期: コンポジット

コンポジットとのインバウンド同期の場合:

- Webサービス: 一方向か、WSDLに指定されたリクエスト/リプライ操作かの決定に、HTTPヘッダーのsoapActionが使用されます。ペイロードが応答しない場合は、リクエスト/リプライでエラーがレポートされます。

15.4.3 アウトバウンド同期: JMSキュー

JMSキューとのアウトバウンド同期の場合:

- Webサービス: カスタムWSDLの場合は、一方向か、WSDLに指定されたリクエスト/リプライ操作かの決定に、(バックエンドから指定されたか、エンドポイントに構成されている)soapActionが使用されます。リプライは、内部デリバリ・チャネル構成を使用してバックエンドに送信されます。汎用SOAP WSDLの場合は、エンドポイントのトランスポート・パラメータによって、一方向かリクエスト/リプライ操作かが決定されます。

15.4.4 インバウンド同期: JMSキュー

- Webサービス: 一方向か、WSDLに指定されたリクエスト/リプライ操作かの決定に、HTTPヘッダーのsoapActionが使用されます。「同期」の場合は、バックエンドに送信されるOracle SOA Suite for healthcare integrationのコールアウトに、リプライを生成する必要があります。汎用SOAP WSDLの場合は、エンドポイントに指定されているトランスポート・パラメータに基づいて決定されます。

16 Oracle Healthcareコマンド行ツール

この章では、データのパージ、データのインポートおよびエクスポート、バッチ操作、エンドポイントの更新および削除など多数のタスクに使用できるOracle Healthcareコマンドライン・ツールについて説明します。

この章には次のトピックが含まれます:

- 16.1項「コマンド行ツール実行の前提条件」

- 16.2項「データのパージ」

- 16.3項「データのインポート」

- 16.4項「データのエクスポート」

- 16.5項「バッチ処理操作」

- 16.6項「メッセージの再発行」

- 16.7項「エンドポイントの停止時間のスケジューリング」

- 16.8項「エンドポイントの更新」

- 16.9項「エンドポイントの削除」

16.1 コマンドライン・ツール実行の前提条件

コマンド行ツールを使用するには、事前に次の手順を実行してください。

1. ORACLE_HOME、ANT_HOMEおよびJAVA_HOMEの各環境変数を設定します。
ORACLE_HOMEは、Oracle Fusion Middlewareインストール・ディレクトリのOracle SOA Suiteインストールに設定されます。たとえば、デフォルト・シェルがCSHの場合、次のようになります。

setenv ORACLE_HOME <Oracle SOA install directory>
setenv ANT_HOME $ORACLE_HOME/../modules/org.apache.ant_1.7.1
set JAVA_HOME $ORACLE_HOME/<jdk install directory>

2. jndi.propertiesを作成します。

cd $ORACLE_HOME/bin
ant -f ant-hcfp-util.xml hcfpcreate-prop

3. jndi.propertiesファイルを編集して、weblogicパスワードを組み込みます。

注意:

1. コマンド行ツールは管理者専用です。ログイン・ユーザーによるデータのパージ、インポートまたはエクスポートを防止するためのセキュリティ・チェックまたは権限チェックは実行されません。

2. コマンドライン・ツールを実行した後、Oracle Healthcareコンソールへのログオンを取得する必要があります。Oracle Healthcareコンソールでは一部のメタデータがキャッシュに入れられ、コマンドライン・アクションによってメタデータが更新されると、キャッシュ内のデータが無効になる場合があります。したがって、コマンドライン操作を使用した後は必ずOracle Healthcareコンソールに再ログインすることをお薦めします。

3. JNDI資格証明がなくても、すべてのコマンド行ツールを実行できます。匿名ユーザーによるコマンド行ツールの使用を制限するには、jndi.propertiesファイルに次の情報を指定します。

java.naming.security.principal=weblogic
java.naming.security.credentials=weblogic_password

注意:

Oracle Healthcareコマンドライン・ユーティリティではデフォルトで、クライアント側またはサーバー側エラーの場合でも、ANTの実行でBUILD SUCCESSFULが示され、システム・コード0 (ゼロ)が戻されます。クライアント側またはサーバー側の各エラーでANTの実行がFAILになるようにするには、exitonerrorパラメータをtrueに設定する必要があります。

これは、次の2つのうちいずれかの方法で行うことができます。

- ANTコマンド行で-Dexitonerror=trueを指定

ant -f ant-hcfp-util.xml b2bpurge -Dagreement=<AGR_NAME> -Dmode=DT -Dexitonerror=true

- exitonerrorパラメータをグローバル設定として設定
ant_general.propertiesというプロパティ・ファイルを値exitonerror=trueでant-hcfp-util.xmlが存在するディレクトリ($ORACLE_HOME/bin)に作成します。

この構成では、すべてのクライアントまたはサーバー・エラーで、すべてのANTコマンドがBUILD FAILEDというメッセージで失敗し、システム終了コードが-1に設定されます。

16.2 データのパージ

このユーティリティを使用して、Oracle Healthcareリポジトリから設計および実行時データをパージします。このユーティリティでは、デフォルトでアーカイブ機能も用意されています。アーカイブがYESに設定されている場合、初期設定が必要です。

初期設定を行うには

1. データベースが稼働するマシン上で、アーカイブ・ファイルをダンプするディレクトリを作成します。例:

mkdir /tmp/archive

2. データベース・プロセスでデータを書き込めるように、このディレクトリへの権限を付与します。

chmod 777 /tmp/archive

3. sysdbaでデータベースにログインします。

sqlplus / as sysdba

4. HCFP_EXPORT_DIRを設定します。

SQL> create or replace DIRECTORY HCFP_EXPORT_DIR as '/tmp/archive'

5. SOAスキーマ・ユーザーがhcfp_soainfraの場合は、そのユーザーにエクスポート権限を付与する必要があります。

SQL> grant read, write on directory HCFP_EXPORT_DIR to hcfp_soainfra;
SQL> grant exp_full_database  to hcfp_soainfra;

次のユーティリティでは、設計時データとランタイム・データの両方をパージし、環境をインストール時の状態にリセットします。

ant -f ant-hcfp-util.xml hcfppurge

表16-1に、このユーティリティのオプションを示します。

表16-1 hcfppurgeユーティリティのオプション

オプション

説明

ドメイン

必須

mode

設計時データのパージまたはランタイム・データのパージを指定します(下の注意を参照)。

実行時オプション: msgstate/start/end/purgecontrolnumber

設計時のオプション: host

DT
RT

はい

msgState

指定したメッセージの状態のメッセージを削除します。ランタイム・データに使用されます。

MSG_COMPLETE
MSG_ERROR
MSG_WAIT_TRANSMIT
MSG_WAIT_FA
MSG_WAIT_BATCH

いいえ。msgstateが存在する場合は、startおよびendを使用する必要があります。

purgecontrolnumber

管理番号を削除します。ランタイム・データに使用されます。

true

false (デフォルト)

いいえ

fromdate

この日付以降に作成されたすべてのメッセージを削除します。

日付書式

dd/mm/yyyy hh:mm AM/PM

いいえ

todate

この日付以前に作成されたすべてのメッセージを削除します。

日付書式

dd/mm/yyyy hh:mm AM/PM

いいえ

direction

メッセージの方向

いいえ

msgtype

メッセージのタイプ

いいえ

archive

アーカイブが必須

デフォルト値はtrue

archivename

アーカイブ・ファイルのファイル名

いいえ

注意:

-Dmode=RT -Dtp=endpoint_nameオプションのみを使用すると、エンドポイント名が送信者名または受信者名と一致するすべてのレコードが削除されます。

例16-1 設計時データの削除

ant -f ant-hcfp-util.xml hcfppurge -Dmode=DT

例16-2 ランタイム・データのパージ

ant -f ant-hcfp-util.xml hcfppurge -Dmode=RT -Darchive=false

例16-3 管理番号を含むランタイム・データのパージ

ant -f ant-hcfp-util.xml hcfppurge -Dmode=RT -Dpurgecontrolnumber=true

例16-4 指定した日付範囲内の指定した状態のメッセージのパージ

ant -f ant-hcfp-util.xml hcfppurge -Dmode=RT -Dfromdate="01/02/2009 12:00 AM" -Dtodate="10/02/2009 12:00 AM" -Dmsgstate=MSG_COMPLETE -Darchive-false

注意:

archivenameを使用する場合、値は一意のファイル名である必要があります。archivenameに既存のファイル名を使用すると、例外がスローされます。

16.3 データのインポート

注意:

ログイン・ユーザーによるデータのインポートを防止するためのセキュリティ・チェックまたは権限チェックは実行されません。

hcfpimportユーティリティでは、Oracle HealthcareメタデータZIPファイルをリポジトリにインポートします。基本的な検証は実行されますが、デプロイメント検証のような完全な検証ではありません。overwriteオプションを使用しないかぎり、データは上書きされません。

次の使用例では、tmp/export.zipのデータが同じサーバー上の場所にインポートされ、上書きは行われません。

ant -f ant-hcfp-util.xml hcfpimport -Dlocalfile=true -Dexportfile="/tmp/export.zip"

表16-2に、このユーティリティのオプションを示します。

表16-2 hcfpimportユーティリティのオプション

オプション

説明

ドメイン

必須

exportfile

エクスポート(ZIP)ファイルの場所

-

はい

overwrite

既存のビジネス要素を上書きします。たとえば、インポート・ファイルのエンドポイントと同じエンドポイント名を持つ既存のエンドポイントは、このオプションがtrueに設定されている場合、置換されます。

true

false (デフォルト)

いいえ

localfile

エクスポート・ファイルの場所がサーバー上である場合は、このオプションをtrueに設定すると、パフォーマンスが向上します。エクスポート・ファイルは、Oracle Healthcareが稼働しているサーバーに存在する必要があります。

true

false (デフォルト)

いいえ

active

インポート後にすべてのエンドポイントを有効にします

true

false (デフォルト)

いいえ

16.4 データのエクスポート

hcfpexportユーティリティでは、メタデータをOracle Healthcareリポジトリからエクスポートします。オプションを指定しないと、リポジトリ全体がエクスポートされます。

注意:

ログイン・ユーザーによるデータのエクスポートを防止するためのセキュリティ・チェックまたは権限チェックは実行されません。

次の使用例では、他のオプションを指定しない場合、リポジトリ全体(ポリシー詳細を除く)が/tmp/export.zipにエクスポートされます。

ant -f ant-hcfp-util.xml hcfpexport

表16-3に、このユーティリティのオプションを示します。

表16-3 hcfpexportユーティリティのオプション

オプション

説明

ドメイン

必須

exportfile

エクスポートしたデータを格納するZIPファイルの場所

/tmp/export.zip (デフォルト)

いいえ

endpoint

エンドポイントの名前

いいえ

policies

trueに設定すると、ユーザーとロールの詳細(ポリシー・ストアに必要)を含むリポジトリ全体がエクスポートされます。ポリシー・ストアもエクスポートするように警告が表示されます。

true

false (デフォルト)

いいえ

localfile

エクスポート・ファイルがOracle Healthcareと同じコンピュータ上にある場合は、trueに設定するとパフォーマンスが向上します。

true

false (デフォルト)

いいえ

例16-5 ポリシーの詳細を含むリポジトリ全体を/tmp/export.zipにエクスポートする場合

ant -f ant-hcfp-util.xml hcfpexport -Dexportfile="/tmp/export.zip" -Dpolicies=true

例16-6 詳細を含まないリポジトリ全体を同じサーバー上の/tmp/exportinserver.zipにエクスポートする場合

ant -f ant-hcfp-util.xml hcfpexport -Dexportfile="/tmp/exportinserver.zip" -Dlocalfile=true

例16-7 /tmp/export.zipへのエンドポイント許可のエクスポート

ant -f ant-hcfp-util.xml hcfpexport -Dexportfile="/tmp/export.zip" -Dendpoint=Admission

16.5 バッチ処理操作

コマンド行のhcfpbatchユーティリティを使用すると、様々な条件に基づいてバッチを作成および削除できます。これはANTベースのコマンドであり、バッチを作成する条件を選択できる柔軟性をもたらします。

使用方法を次に示します。

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=<EndpointName> -Dbatchtime=<batchTriggerTime> -Dbatchname=<batchName> -Ddocument=<documentProtocolName> -Ddocrevision=<docRevision> -Ddoctype=<docType> -Disrepetitive=<true|false>

表16-4に、このユーティリティのオプションを示します。

表16-4 hcfpbatchユーティリティのオプション

オプション

説明

ドメイン

必須

endpoint

エンドポイント名。

エンドポイント名を指定します。

はい脚注1

batchname

バッチ名。

バッチの名前を指定します。

はい

batchtime

バッチのトリガー時刻。

トリガー時刻には、cron文字列または
dd/MM/yyyy HH:mm AM/PM形式の日付を使用できます。

はい

document

ドキュメント・プロトコル名。

有効な値:
EDI_EDIFACT、EDI_X12

はい

docrevision

ドキュメント・リビジョン。

-

はい

doctype

ドキュメント・タイプ。

-

はい

isrepetitive

cron文字列を使用してバッチを作成するときに、反復的なバッチ処理を有効にします。

有効な値: trueまたはfalse

いいえ

mode

モード

バッチを削除するには、deletebatchに設定します。

いいえ

脚注1 バッチを作成するには、endpoint、batchtime、batchname、document、docrevision、doctypeの各オプションが必要です。バッチを削除するには、modeとbatchnameオプションのみが必要です。

注意:

コマンドライン操作用のcronジョブを作成する際は、cron構文に従う必要があります。

例16-8 バッチ処理操作の作成

このコマンドでは、FileEndpointを使用してX12/4010/850ドキュメントに対するバッチ処理操作を作成します。このバッチ処理操作は、指定したcron文字列に対して反復モードで実行されます。

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime="0 4850 11 7 5 ? 2010" -Dbatchname=batch1234 -Ddocument=EDI_X12 -Ddocrevision=4010 -Ddoctype=850 -Disrepetitive=true

例16-9 複数のドキュメント・タイプに対するバッチの作成

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime="0 58 11 7 5 ? 2010" -Dbatchname=batch1234 -Ddocument=EDI_X12 -Ddocrevision=4010 -Ddoctype=850,997

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime="07/05/2010 11:45 AM" -Dbatchname=batch1234 -Ddocument=X12 -Ddocrevision=4010 -Ddoctype=850,997

例16-10 バッチ処理操作の削除

ant -f ant-hcfp-util.xml hcfpbatch -Dmode=deletebatch -Dbatchname=batch1234

例16-11 batchtimeオプションでの特殊文字の使用

batchtimeの値に*や#などの特殊文字が含まれる場合は、二重引用符を使用して文字をエスケープする必要があります。

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime='0 5,10,15,20,25,30,35,40,45,50,55,59 "*" "*" "*" ? 2010' -Dbatchname=batch1234 -Ddocument=EDI_X12 -Ddocrevision=4010 -Ddoctype="850,855" -Disrepetitive=true

16.6 メッセージの再発行

次のユーティリティでは、選択したビジネス・メッセージに対するアプリケーション・メッセージまたはワイヤ・メッセージを再発行します。

ant -f ant-hcfp-util.xml hcfpresubmit

注意:

ペイロードの修正に対する再発行機能は、AppMessageのみのアウトバウンド・メッセージに対してのみ機能します。インバウンドの場合は無効です。

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Dmsgid=12345 -Dpayloadpath=/scratch/<username>/fmwhome/AS11gR1SOA/bin/3a4_req.xml

表16-5に、このユーティリティのオプションを示します。

表16-5 hcfpresubmitユーティリティのオプション

オプション

説明

ドメイン

必須

direction

メッセージの方向

INBOUND

OUTBOUND

いいえ

msgsource

メッセージ・ソース

APPMSG (デフォルト)

WIREMSG

はい

msgid

メッセージID

複数のメッセージIDをカンマで区切って指定可能

doctype

ドキュメント・タイプ

msgstate

メッセージの状態

fromdate

メッセージのsendTimestamp

二重引用符で囲んで指定する日付書式

dd-mm-yyyy hh:mm AM/PM

注意: 将来に日付にすることはできません。

todate

メッセージのsendTimestamp

二重引用符で囲んで指定する日付書式

dd-mm-yyyy hh:mm AM/PM

注意: todateはfromdateより後にする必要があります。両方の日付を指定できます。

payloadpath

このオプションは、修正したファイル・パスを指定して、アウトバウンド・アプリケーション・メッセージを再発行する場合に適用可能です。

例16-12 メッセージIDが12345のアウトバウンド・メッセージの再発行

ant -f ant-hcfp-util.xml hcfpresubmit -Ddirection=OUTBOUND -Dmsgsource=APPMSG -Dmsgid=12345\

その他の例

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Ddoctype=850

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Dfromdate="29/11/2009 5:40 AM" -Dtodate="30/11/2009 7:39 AM"

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=WIREMSG -Dmsgstate=MSG_ERROR

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Dfromdate="29/11/2009 5:40 AM" -Dtodate="30/11/2009 7:39 AM" -Ddirection=OUTBOUND

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Dfromdate="29/11/2009 5:40 AM" -Dtodate="30/11/2009 7:39 AM" -Ddirection=INBOUND

ant -f ant-hcfp-util.xml hcfpresubmit -Dmsgsource=APPMSG -Dmsgid=12345 -Dpayloadpath="/tmp/850.xml"

16.7 エンドポイントの停止時間のスケジューリング

様々なエンドポイント・パーティがそれぞれの理由で停止時間の計画を立て、その停止時間を取引相手のパートナに連絡しています。停止時間中、パーティがメッセージを送信しても宛先に到達しないことがあります。エンドポイントの停止時間をスケジューリングすると、メッセージはその期間配信されないようになります。ただし、メッセージはOracle Healthcareによって、停止時間後にエンドポイント・パーティが起動したときにメッセージが配信されるように処理されます。

次のユーティリティでは、エンドポイントの停止時間をスケジュール設定します。

ant -f ant-hcfp-util.xml hcfpschedule

表16-6に、このユーティリティのオプションを示します。

表16-6 hcfpscheduleユーティリティのオプション

オプション

説明

ドメイン

必須

mode

スクリプトで停止時間のスケジュールを設定するのか、解除するのかを示します。

schedule (default)

unschedule

はい

schedulename

スケジュールを設定する停止時間の摘要名

-

はい

endpoint

エンドポイント名

-

はい

(unscheduleモードの場合以外)

fromdate

停止時間を開始する日時。

二重引用符で囲んで指定する日付書式

dd/mm/yyyy hh:mm AM/PM

いいえ

todate

停止時間を終了する日時。

二重引用符で囲んで指定する日付書式

dd/mm/yyyy hh:mm AM/PM

いいえ

extend

すでに作成されているスケジュールを延長します。

true

いいえ

次に、hcfpscheduleユーティリティを使用してエンドポイントの停止時間をスケジューリングする例を示します。コマンドを1行で入力する必要はありません。

例16-13 GlobalChipsの全チャネルのエンドポイント停止時間を"14/05/2010 00:14 AM"から"14/05/2010 00:17 AM"にスケジュールする

ant -f ant-hcfp-util.xml hcfpschedule
-Dendpoint="GlobalChips"
-Dfromdate="14/05/2010 00:14 AM"
-Dtodate="14/05/2010 00:17 AM"
-Dschedulename= "Maintenance"

例16-14 スケジュールが設定されているイベントのスケジュール解除

ant -f ant-hcfp-util.xml hcfpschedule
-Dmode=unschedule
-Dschedulename="Maintenance"

16.8 エンドポイントの更新

次のユーティリティでは、エンドポイントをアクティブな状態から非アクティブな状態(またはその逆)に変更できます。

ant -f ant-hcfp-util.xml hcfpupdateendpoint

表16-7に、このユーティリティのオプションを示します。

表16-7 hcfpupdateendpointユーティリティのオプション

オプション

説明

ドメイン

必須

endpoint

エンドポイントの名前

エンドポイント名を指定します

はい

active

エンドポイントをアクティブにします

true

false

はい

例16-15 エンドポイントを非アクティブな状態からアクティブな状態に更新

ant -f ant-hcfp-util.xml hcfpupdateendpoint -Dendpoint=FileEndpoint -Dactive=true

16.9 エンドポイントの削除

次のユーティリティでは、エンドポイントを削除します。

ant -f ant-hcfp-util.xml hcfpdeleteendpoint

表16-8 hcfpdeleteendpointユーティリティのオプション

オプション

説明

ドメイン

必須

endpoint

エンドポイントの名前

エンドポイント名を指定します

はい

例16-16 非アクティブな状態からアクティブな状態のエンドポイントの削除

ant -f ant-hcfp-util.xml hcfpdeleteendpoint -Dendpoint=FileEndpoint

A バックエンド・アプリケーション・インタフェース

この付録では、Oracle SOA Suite for healthcare integrationでサポートされているメッセージ・プロパティをリストします。

この付録の内容は次のとおりです。

- A.1項「SCAの正規化されたメッセージ・プロパティのマッピング」

- A.2項「正規化されたメッセージ・プロパティ」

A.1 SCAの正規化されたメッセージ・プロパティのマッピング

表A-1では、SCAの正規化されたメッセージ・プロパティをJMSアダプタ・プロパティにマップしています。

表A-1 AS11 SCAの正規化されたメッセージ・プロパティへのHealthcare IP_MESSAGE_TYPEのマッピング

SCA

JMS

hc.messageId

MSG_ID

hc.replyToMessageId

INREPLYTO_MSG_ID

hc.fromEndpoint

FROM_ENDPOINT

hc.toEndpoint

TO_ENDPOINT

hc.action

ACTION_NAME

hc.documentTypeName

DOCTYPE_NAME

hc.documentProtocolVersion

DOCTYPE_REVISION

hc.documentProtocolName

-

hc.documentDefinitionName

-

hc.messageType

MSG_TYPE

hc.conversationId

-

A.2 正規化されたメッセージ・プロパティ

ヘッダーの操作および伝播は、重要なビジネス統合メッセージング要件です。Oracle SOA Suite for healthcare integrationは、Oracle BPEL Process Manager、Oracle Mediator、Oracle JCAなどの他のSOAコンポーネントと同様、ヘッダー・サポートに基づいて統合ニーズに対応しています。たとえば、メッセージ・ヘッダーを介して伝播することによって、ソース・ディレクトリからターゲット・ディレクトリへファイル名を保持できます。

正規化されたメッセージには、プロパティとペイロードという2つの部分があります。通常、プロパティはスカラー型の名前-値のペアです。既存の複雑なヘッダーをプロパティに合せるために、プロパティはスカラー型にフラット化されています。

表A-2に、Oracle SOA Suite for healthcare integrationの正規化されたメッセージのあらかじめ決められたプロパティを示します。

表A-2 Oracle SOA Suite for healthcare integrationのプロパティ

プロパティ名

伝播可能(はい/いいえ)

方向(インバウンド/アウトバウンド)

データ型

有効な値の範囲

説明

hc.conversationId

いいえ

両方

文字列

-

メッセージをメッセージ・レスポンスに関連付けるために使用されるID

hc.documentDefinitionName

いいえ

両方

文字列

-

ドキュメント定義

hc.documentProtocolName

いいえ

両方

文字列

-

ドキュメント・プロトコル

hc.documentProtocolVersion

いいえ

両方

文字列

-

ドキュメント・バージョン

hc.documentTypeName

いいえ

両方

文字列

-

ドキュメント・タイプ(EDI X12ドキュメントの850など)

hc.fromEndpoint

いいえ

両方

文字列

-

送信者の取引パートナ識別子(Acmeのような名前やDUNS番号など)

hc.messageId

いいえ

両方

文字列

-

一意のメッセージID。ECIDと直接は関係しません。(ECID情報はB2B AppMessage表に格納されます。)

hc.messageType

いいえ

両方

文字列

-

メッセージ・タイプの値は次のとおりです。

- リクエスト = 1

- レスポンス = 2

- 機能確認 = 9

hc.replyToMessageId

いいえ

両方

文字列

-

送信メッセージの返信先メッセージID

hc.toEndpoint

いいえ

両方

文字列

-

受信者の取引パートナ識別子(Acmeのような名前やDUNS番号など)。

B 各種トランスポート・プロトコルを使用したエンドポイントの作成

この付録では、双方向および単一方向の各種トランスポート・プロトコルを使用してエンドポイントを作成する方法について説明します。

Oracle SOA Suite for healthcare integrationでは、双方向および単一方向の各種トランスポート・プロトコルを使用してエンドポイントを作成できます。

B.1 双方向エンドポイントの作成

サポートされている双方向プロトコルは、MLLP 1.0、MLLP 2.0、汎用TCPおよびHLLPです。

B.1.1 MLLP 1.0エンドポイントの作成

この項では、MLLP 1.0トランスポート・プロトコルを使用して双方向エンドポイントを作成する方法について説明します。

MLLP 1.0トランスポート・プロトコルを使用してエンドポイントを作成するには:

1. Oracle SOA Suite for healthcare integrationユーザー・インタフェースにログオンします。

2. 「設計」タブの「構成」タブで、「エンドポイント」フォルダをクリックし、図B-1に示す「作成」アイコンをクリックします。

図B-1 エンドポイントの作成アイコン

3. 図B-2に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、MLLP10を選択します。

- 接続モード: 「サーバー」または「クライアント」。エンドポイントがサーバーとして構成されている場合、Oracle SOA Suite for healthcare integrationエンジンはポートでリスニングを開始し、クライアントが接続するのを待機します。一般に、サーバー接続モードはインバウンド用です。クライアントとして構成されている場合、エンジンはリモート・コンピュータまたはデバイスのホスト名およびポートに接続します。一般に、これはアウトバウンド用です。

- ホスト名: MLLP 1.0サーバー・エンドポイントの場合はOracle SOA Suiteをホストしているコンピュータの名前またはIPアドレス、MLLPクライアント・エンドポイントの場合はリモート・ホスト名またはデバイス名にする必要があります。通常、これはlocalhostである必要があります。ただし、ホスト名はリモート・ホストまたはデバイスの名前にすることもできます。

- ポート: ポート番号は500より大きい値にする必要があります。接続モードが「サーバー」に設定されている場合、ポート番号は有効なTCPポート番号である必要があります。接続モードが「クライアント」に設定されている場合、ポート番号はMLLPサーバーで使用するポートと同じである必要があります。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-2 MLLP 1.0エンドポイント・パラメータの指定

B.1.2 MLLP 2.0エンドポイントの作成

この項では、MLLP 2.0トランスポート・プロトコルを使用して双方向エンドポイントを作成する方法について説明します。

MLLP 2.0トランスポート・プロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-3に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「MLLP20」を選択します。

- 接続モード: 「サーバー」または「クライアント」。エンドポイントがサーバーとして構成されている場合、Oracle SOA Suite for healthcare integrationエンジンはポートでリスニングを開始し、クライアントが接続するのを待機します。一般に、サーバー接続モードはインバウンド用です。クライアントとして構成されている場合、エンジンはリモート・コンピュータまたはデバイスのホスト名およびポートに接続します。一般に、これはアウトバウンド用です。

- ホスト名: MLLP 2.0サーバー・エンドポイントの場合はOracle SOA Suiteをホストしているコンピュータの名前またはIPアドレス、MLLP 2.0クライアント・エンドポイントの場合はリモート・ホスト名またはデバイス名にする必要があります。通常、これはlocalhostである必要があります。ただし、ホスト名はリモート・ホストまたはデバイスの名前にすることもできます。

- ポート: 1から999999までの有効なTCPポート番号。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-3 MLLP 2.0エンドポイント・パラメータの指定

注意:

エンドポイント・ページで、次のことを確認します。

- 「確認モード」が「同期」に設定されていること

- (「トランスポートの詳細」ボタンをクリックすると表示される)「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスの「接続」タブで、「永続接続」チェック・ボックスが選択されていること

これは、MLLP 2.0が一時接続および非同期確認に対してサポートされていないためです。

B.1.3 汎用TCPエンドポイントの作成

この項では、汎用TCPトランスポート・プロトコルを使用して双方向エンドポイントを作成する方法について説明します。

汎用TCPトランスポート・プロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-4に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「汎用TCP」を選択します。

- 接続モード: 「サーバー」または「クライアント」。エンドポイントがサーバーとして構成されている場合、Oracle SOA Suite for healthcare integrationエンジンはポートでリスニングを開始し、クライアントが接続するのを待機します。一般に、サーバー接続モードはインバウンド用です。クライアントとして構成されている場合、エンジンはリモート・コンピュータまたはデバイスのホスト名およびポートに接続します。一般に、これはアウトバウンド用です。

- ホスト名: 汎用TCPサーバー・エンドポイントの場合はOracle SOA Suiteをホストしているコンピュータの名前またはIPアドレス、汎用TCPクライアント・エンドポイントの場合はリモート・ホスト名またはデバイス名にする必要があります。通常、これはlocalhostである必要があります。ただし、ホスト名はリモート・ホストまたはデバイスの名前にすることもできます。

- ポート: 1から999999までの有効なTCPポート番号。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-4 汎用TCPエンドポイント・パラメータの指定

B.1.4 HLLPエンドポイントの作成

HLLP交換プロトコルは、下位レイヤー・プロトコルのバリエーションです。これは、MLLP交換プラグインの拡張形式です。これを使用すると、エラーの検出とHL7メッセージの検証が可能になります。このプロトコルは、TCPトランスポート・プロトコルに基づいています。この項では、HLLPトランスポート・プロトコルを使用して双方向エンドポイントを作成する方法について説明します。

HLLPプロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-5に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「HLLP」を選択します。

- 接続モード: 「サーバー」または「クライアント」。エンドポイントがサーバーとして構成されている場合、Oracle SOA Suite for healthcare integrationエンジンはポートでリスニングを開始し、クライアントが接続するのを待機します。一般に、サーバー接続モードはインバウンド用です。クライアントとして構成されている場合、エンジンはリモート・コンピュータまたはデバイスのホスト名およびポートに接続します。一般に、これはアウトバウンド用です。

- ホスト名: HLLPサーバー・エンドポイントの場合はOracle SOA Suiteをホストしているコンピュータの名前またはIPアドレス、HLLPクライアント・エンドポイントの場合はリモート・ホスト名またはデバイス名にする必要があります。通常、これはlocalhostである必要があります。ただし、ホスト名はリモート・ホストまたはデバイスの名前にすることもできます。

- ポート: 1024から65535までの有効なHLLPポート番号。

注意:

HLLPエンドポイントの場合は、順序付けを有効にする必要があります。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-5 HLLPエンドポイント・パラメータの指定

B.2 単一方向エンドポイントの作成

サポートされている単一方向プロトコルは、File、FTP、JMSおよびSFTPです。

B.2.1 Fileエンドポイントの作成

この項では、Fileトランスポート・プロトコルを使用して単一方向エンドポイントを作成する方法について説明します。

ファイル・トランスポートを使用すると、共有ファイル・ディレクトリからファイルを取得できます。

FILEプロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-6に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、FILEを選択します。

- 方向: 「インバウンド」または「アウトバウンド」。エンドポイントをインバウンドとして構成した場合、他のエンドポイントからレスポンス・メッセージまたはFAを受信できます。反対に、エンドポイントをアウトバウンドとして構成した場合、メッセージまたはFAを送信できます。

- フォルダ名: 絶対ディレクトリ・パスが推奨されます。インバウンド・メッセージはこのフォルダ内にある必要があり、アウトバウンド・メッセージまたはFAはここに配信される必要があります。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-6 Fileエンドポイント・パラメータの指定

注意:

単一方向トランスポート・エンドポイント(インバウンド/アウトバウンド)の作成後、「構成」リンクをクリックしてこれを編集することにより、インバウンド構成またはアウトバウンド構成を追加できます。

B.2.2 FTPエンドポイントの作成

この項では、FTPトランスポート・プロトコルを使用して単一方向エンドポイントを作成する方法について説明します。

FTPでは、FTPを使用してアプリケーション間でのファイルの受渡しを可能にします。FTPはデフォルト・ポート21で稼働します。

FTPプロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-7に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「FTP」を選択します。

- 方向: 「インバウンド」または「アウトバウンド」。エンドポイントをインバウンドとして構成した場合、他のエンドポイントからレスポンス・メッセージまたはFAを受信できます。反対に、エンドポイントをアウトバウンドとして構成した場合、メッセージまたはFAを送信できます。

- ホスト名: ホスト・コンピュータの名前。

- フォルダ名: 絶対ディレクトリ・パスが推奨されます。インバウンド・メッセージはこのフォルダ内にある必要があり、アウトバウンド・メッセージまたはFAはここに配信される必要があります。

- ユーザー名: ターゲット・サーバーに接続するためのユーザー名(ログイン名)。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-7 FTPエンドポイント・パラメータの指定

B.2.3 JMSエンドポイントの作成

この項では、JMSトランスポート・プロトコルを使用して単一方向エンドポイントを作成する方法について説明します。

JMSを使用すると、アプリケーションは、Java Message Service (JMS)プロバイダ(Oracle WebLogic JMSおよびMQSeries JMS (IBM)などOracle以外のプロバイダを含む)によって管理されているキューおよびトピック間でメッセージを送受信できます。ユーザー名とパスワードを指定しない場合は、接続先が分散されていると、クラスタ環境も含めてローカルJNDIが使用されます。

JMSプロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-8に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「JMS」を選択します。

- 方向: 「インバウンド」または「アウトバウンド」。エンドポイントをインバウンドとして構成した場合、他のエンドポイントからレスポンス・メッセージまたはFAを受信できます。反対に、エンドポイントをアウトバウンドとして構成した場合、メッセージまたはFAを送信できます。

- 接続先名: JMSキューまたはトピックのJNDI名。

- 接続ファクトリ: 接続ファクトリのJNDI名(jms/b2b/B2BQueueConnectionFactoryなど)。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-8 JMSエンドポイント・パラメータの指定

B.2.3.1 JMSヘッダーからのドキュメント情報の取得

Oracle Healthcareでは、次の順序でJMSヘッダーからDOC_TYPEやDOC_REVISIONなどのドキュメント情報の取得をサポートしています。

- これらの値がJMSヘッダー内に見つかった場合、Oracle Healthcareはこれらの値を使用してドキュメントを識別します。

- これらの値がJMSヘッダー内に見つからない場合、Oracle Healthcareはペイロードを使用してこれらの値を識別します。

注意:

JMSエンドポイントの場合、デフォルトのMSG_TYPEはリクエストとみなされます。また、DOC_TYPEから997または確認メッセージを識別できます。したがって、タイプが997、確認、リクエストのいずれでもないメッセージを渡す場合は、JMSヘッダーの一部として明示的にMSG_TYPEを渡す必要があります。

B.2.4 SFTPエンドポイントの作成

この項では、SFTPトランスポート・プロトコルを使用して単一方向エンドポイントを作成する方法について説明します。

SFTPでは、SSH FTPを使用してファイルの受渡しを可能にします。SFTPはデフォルト・ポート22で稼働しますが、別のポートに変更することもできます。

SFTPプロトコルを使用してエンドポイントを作成するには:

1. B.1.1項「MLLP 1.0エンドポイントの作成」の手順1および2を繰り返します。

2. 図B-9に示すように、「作成」ウィンドウで次のように入力して、「OK」をクリックします。

- 名前: エンドポイントの名前。

- トランスポート・プロトコル: メッセージを送信または受信するトランスポート・プロトコル。この場合、「SFTP」を選択します。

- 方向: 「インバウンド」または「アウトバウンド」。エンドポイントをインバウンドとして構成した場合、他のエンドポイントからレスポンス・メッセージまたはFAを受信できます。反対に、エンドポイントをアウトバウンドとして構成した場合、メッセージまたはFAを送信できます。

- ホスト名: ホスト・コンピュータの名前。

- ポート番号: 1から999999までの有効なSFTPポート番号。デフォルト値は、22です。

- パス: メッセージを送受信する絶対ディレクトリ・パス。

- ユーザー名: ターゲット・サーバーに接続するためのユーザー名(ログイン名)。

これにより、エンドポイントが作成され、エンドポイントがOracle SOA Suite for healthcare integrationユーザー・インタフェースの右のパネルに表示されます。

図B-9 SFTPエンドポイント・パラメータの指定

C メッセージ順序付けの管理

この付録では、Oracle SOA Suite for healthcare integrationで提供される、メッセージ順序付けをモニターおよび管理するためのコマンド行ツールとJavaベース・ツールについて説明します。これらの機能は、カスタム・クライアントで使用できます。

この付録の内容は次のとおりです。

- C.1項「順序メッセージ管理の概要」

- C.2項「順序メッセージを管理するためのJavaメソッド」

- C.3項「順序メッセージを管理するためのコマンド行ツール」

C.1 順序メッセージ管理の概要

Oracle SOA Suite for healthcare integrationを介して処理されたメッセージは、B2B順序マネージャを介して順序付けされます。メッセージ順序付けの情報は、メッセージの正しい順序を保持するためにB2B_SEQUENCE_MANAGERデータベース表に格納されます。場合によっては、メッセージの順序付けのプロセスを管理する必要があります。たとえば、エンドポイントの1つのメッセージが停滞して処理できない場合、そのエンドポイントの他のすべてのメッセージの処理がブロックされることがあります。この場合、メッセージを削除または再発行して順序付けを再開するために、手動の操作を行う必要があります。

Oracle SOA Suite for healthcare integrationに付属の、メッセージ順序付けをモニターおよび管理するためのツールを使用すると、次の操作を実行できます。

- すべてのエンドポイントおよびその現在の状態の表示

- 状態またはエンドポイント(あるいはその組合せ)によるメッセージの表示

- 状態、エンドポイント、メッセージID、または状態とエンドポイントによるメッセージの破棄

- エラーのあるメッセージの再発行

- エンドポイントのメッセージ順序付けの休止および再開

注意:

順序付けされたメッセージは、Oracle SOA Suite for healthcare integrationコンソールで表示できます。詳細は、8.5項「順序付けされたメッセージの使用」を参照してください。

C.2 順序メッセージを管理するためのJavaメソッド

順序メッセージ管理用に提供されているJavaメソッドを使用して、B2B_SEQUENCE_MANAGER表内のメッセージをモニターおよび管理するための独自のクライアントを作成できます。

これらのJavaメソッドを使用するには、jndi.propertiesファイルをパラメータとして使用して、SequenceManagerUtilityのインスタンスを作成します。例:

private static Properties getProperties(String s) throws IOException {
Properties properties;
FileInputStream fileinputstream = new FileInputStream(s);
properties = new Properties();
properties.load(fileinputstream);
return properties;             }

SequenceManagerUtility seqUtil = new SequenceManagerUtility(getProperties("/tmp/jndi.properties"));

seqUtil.listSequenceTargets();

jndi.propertiesファイルの作成の詳細は、C.3.1項「コマンド行ツールを実行するための前提条件」を参照してください。

C.2.1 エンドポイントおよび状態のリスト

特定のエンドポイントに対して順序表で保留中になっているメッセージが特定の状態とともにリストされたレポートを生成できます。生成されたレポートには、メッセージIDおよびそれぞれに対応する状態が含まれます。

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> listSequenceTargets()
throws java.lang.Exception

C.2.2 保留中の順序メッセージのリスト

保留中の順序メッセージのレポートを、状態とエンドポイント、状態のみ、またはエンドポイントのみに基づいて生成できます。このコマンドでは、順序表で保留中になっているメッセージが、指定したオプションに基づいてリストされます。生成されたレポートには、メッセージIDおよびそれぞれに対応する状態が含まれます。使用する基準に応じて、順序メッセージをリストするために使用できるメソッドは4つあります。

状態とエンドポイントに基づいた保留中の順序メッセージのリスト

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> getSequenceMessagesByTargetAndState(java.lang.String target, java.lang.String state)
throws java.lang.Exception

パラメータ

説明

target

メッセージをリストするエンドポイントの名前(またはIPアドレスとポート番号)。例:

seqUtil.getSequenceMessagesByTargetAndState("TCP://111.34.121.22:2025","STACKED")

state

レポートに含めるメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

状態に基づいた保留中の順序メッセージのリスト

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> getSequenceMessagesByTarget(java.lang.String state)
throws java.lang.Exception

パラメータ

説明

state

レポートに含めるメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

エンドポイントに基づいた保留中の順序メッセージのリスト

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> getSequenceMessagesByTarget(java.lang.String target)
throws java.lang.Exception

パラメータ

説明

target

メッセージをリストするエンドポイントの名前(またはIPアドレスとポート番号)。

C.2.3 メッセージの破棄

次の基準の組合せに基づいて、順序メッセージをB2B_SEQUENCE_MANAGER表から削除できます。

- メッセージの状態とエンドポイント

- メッセージの状態

- メッセージのエンドポイント

- エンドポイントの方向(インバウンドとアウトバウンドが両方あるエンドポイント・ペアの場合)

- メッセージID

- エンドポイントの最初のメッセージのみ

破棄メソッドを使用すると、B2B_SEQUENCE_MANAGER表内のメッセージを管理できます。これは、メッセージが停滞して他のメッセージの処理をブロックしている場合や、特定のメッセージに問題があるためにそのメッセージを順番どおりに処理できない場合などに有用です。

注意:

順序マネージャ表からメッセージを破棄しても、ビジネス・メッセージはいずれも削除されません。

状態とエンドポイントに基づいた順序メッセージの破棄

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> discardSequencedMessageByStateAnDendpoint(java.lang.String target, java.lang.String state) throws java.lang.Exception

または

public java.util.List<java.lang.String> discardSequencedMessageByStateAnDendpoint(java.lang.String target, java.lang.String state, java.lang.String direction) throws java.lang.Exception

パラメータ

説明

target

削除するメッセージと関連付けられているエンドポイントの名前(またはIPアドレスとポート番号)。

state

削除するメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

direction

メッセージを破棄するエンドポイント・ペアのメッセージの方向。INBOUNDまたはOUTBOUNDを指定します。このオプションは、エンドポイント・ペアの一方向のメッセージを削除する場合にのみ使用してください。

状態に基づいた順序メッセージの破棄

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> discardSequencedMessageByState(java.lang.String state)
throws java.lang.Exception

パラメータ

説明

state

破棄するメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

エンドポイントに基づいた順序メッセージの破棄

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> discardSequencedMessageByTarget(java.lang.String target)
throws java.lang.Exception

または

public java.util.List<java.lang.String> discardSequencedMessageByTarget(java.lang.String target, java.lang.String direction)
throws java.lang.Exception

パラメータ

説明

target

メッセージを破棄するエンドポイントの名前(またはIPアドレスとポート番号)。

direction

メッセージを破棄するエンドポイント・ペアのメッセージの方向。INBOUNDまたはOUTBOUNDを指定します。このオプションは、エンドポイント・ペアの一方向のメッセージを削除する場合にのみ使用してください。

メッセージIDに基づいた順序メッセージの破棄

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> discardSequencedMessageByMessageId(java.lang.String msgId)
throws java.lang.Exception

パラメータ

説明

msgId

破棄するメッセージのメッセージID。

エンドポイントの最初のメッセージの破棄

このメソッドの構文は次のとおりです。

public java.util.List<java.lang.String> discardFirstSequemceMessageByTarget(java.lang.String target)
throws java.lang.Exception

パラメータ

説明

target

最初のメッセージを破棄するエンドポイントの名前(またはIPアドレスとポート番号)。

C.2.4 メッセージの再処理

メッセージの再処理は、エンドポイントに関する問題が発生した後(たとえば、エンドポイントが停止してから処理が再開された場合など)にメッセージを確実に順番どおりに処理するために有用なオプションです。

このメソッドの構文は次のとおりです。

public boolean processSequenceMessageByMessageId(java.lang.String messageId)
throws java.lang.Exception

パラメータ

説明

messageId

再処理するメッセージのメッセージID。

C.2.5 エンドポイントの休止および再開

外部システムに障害が発生した場合など、特定のエンドポイントに対してメッセージの順序付け処理を休止する必要があることがあります。この場合、システムがリストアされるまでエンドポイントを休止できます。システムがリストアされた後は、エンドポイントの処理を再開できます。エンドポイント・ペアの場合、インバウンド・エンドポイントとアウトバウンド・エンドポイントの両方、インバウンド・エンドポイントのみ、またはアウトバウンド・エンドポイントのみを休止または再開できます。

エンドポイントの休止

このメソッドの構文は次のとおりです。

public boolean pauseSequenceTarget(java.lang.String target)
throws java.lang.Exception

または

public boolean pauseSequenceTarget(java.lang.String target, java.lang.String direction)
throws java.lang.Exception

パラメータ

説明

target

休止するエンドポイントの名前(またはIPアドレスとポート番号)。

direction

休止するエンドポイント・ペアのメッセージの方向。INBOUNDまたはOUTBOUNDを指定します。このオプションは、エンドポイント・ペアの一方向を休止する場合にのみ使用してください。

エンドポイントの再開

このメソッドの構文は次のとおりです。

public boolean resumeSequenceTarget(java.lang.String target)
throws java.lang.Exception

または

public boolean resumeSequenceTarget(java.lang.String target, java.lang.String direction)
throws java.lang.Exception

パラメータ

説明

target

再開するエンドポイントの名前(またはIPアドレスとポート番号)。

direction

再開するエンドポイント・ペアのメッセージの方向。INBOUNDまたはOUTBOUNDを指定します。このオプションは、エンドポイント・ペアの一方向を再開する場合にのみ使用してください。

C.3 順序メッセージを管理するためのコマンド行ツール

コマンド行ツールは、Apache antを使用して実行します。これらのツールは管理者専用です。ログイン・ユーザーによるデータの表示や破棄を防止するためのセキュリティ・チェックまたは権限チェックは実行されません。

C.3.1 コマンド行ツールを実行するための前提条件

コマンドライン・ツールを実行するには、事前に環境が正しく構成されていることを確認する必要があります。コマンドを実行する前に、次の操作を実行してください。

1. ORACLE_HOME、ANT_HOMEおよびJAVA_HOMEの各環境変数を設定します。
ORACLE_HOMEは、Oracle Fusion Middlewareのインストール・ディレクトリです。例:

set ORACLE_HOME=C:\oracle\Middleware
set ANT_HOME=%ORACLE_HOME%\modules\org.apache.ant_1.7.1
set JAVA_HOME=%ORACLE_HOME%\jdk160_18

2. jndi.propertiesファイルを作成します。

cd $ORACLE_HOME\Oracle_SOA\bin
ant -f ant-hcfp-util.xml b2bcreate-prop

3. jndi.propertiesファイルを編集して、weblogicパスワードを組み込みます。

注意:

- コマンド行ツールを実行した後は、ヘルスケア統合ユーザー・インタフェースまたはB2Bコンソールを再起動してください。これは、インタフェースによって一部のメタデータがキャッシュに入れられ、コマンド行アクションによってメタデータが更新されると、キャッシュ内のデータが無効になる場合があるためです。

- すべてのコマンド行ツールは、JNDI資格証明がなくても実行できます。匿名ユーザーによるコマンド行ツールの使用を制限するには、jndi.propertiesファイルに次の情報を入力します。

java.naming.security.principal=weblogic
java.naming.security.credentials=weblogic_password

C.3.2 エンドポイントおよび状態のリスト

各エンドポイントの状態を判別するために、すべてのエンドポイントとそれぞれの状態がリストされたレポートを生成できます。

このコマンドの構文は次のとおりです。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=listTargets

オプション

説明

-Dmode

コマンドを実行するモード。この目的で、このオプションをlistTargetsに設定します。

C.3.3 保留中の順序メッセージのリスト

保留中の順序メッセージのレポートを、状態とエンドポイント、状態のみ、またはエンドポイントのみに基づいて生成できます。このコマンドでは、順序表で保留中になっているメッセージが、指定したオプションに基づいてリストされます。生成されたレポートには、メッセージIDおよびそれぞれに対応する状態が含まれます。

このコマンドの構文は次のとおりです。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=command_mode -Dstate=message_state -Dendpoint=endpoint_name

オプション

説明

-Dmode

コマンドを実行するモード。この目的で、このオプションをreportに設定します。

-Dstate

レポートに含めるメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

すべての状態が含まれるレポートを生成するには、コマンドの実行時にこのオプションを使用しないでください。

-Dendpoint

メッセージをリストするエンドポイントの名前(またはIPアドレスとポート番号)。すべてのターゲットに対するレポートを生成するには、コマンドの実行時にこのオプションを使用しないでください。

例C-1 状態とエンドポイントに基づいた順序メッセージのリスト

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=report -Dstate=STACKED -Dendpoint=Pharmacy01

例C-2 状態のみに基づいた順序メッセージのリスト

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=report -Dstate=PROCESSED

例C-3 エンドポイントのみに基づいた順序メッセージのリスト

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=report -Dendpoint=Pharmacy01

C.3.4 メッセージの破棄

次の基準の組合せに基づいて、順序メッセージをSEQUENCE_MANAGERデータベース表から削除できます。

- メッセージの状態とエンドポイント

- メッセージの状態

- メッセージのエンドポイント

- メッセージID

- エンドポイントの最初のメッセージのみ

破棄モードを使用すると、B2B_SEQUENCE_MANAGER表内のメッセージを管理できます。これは、メッセージが停滞して他のメッセージの処理をブロックしている場合や、特定のメッセージに問題があるためにそのメッセージを順番どおりに処理できない場合などに有用です。

注意:

順序マネージャ表からメッセージを破棄しても、ビジネス・メッセージはいずれも削除されません。

このコマンドの構文は次のとおりです。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=command_mode -Dstate=message_state -Dendpoint=endpoint_name -Dmsgid=message_id

オプション

説明

-Dmode

コマンドを実行するモード。メッセージを破棄する場合は、このオプションをdiscardに設定します。エンドポイント内の最初のメッセージのみを破棄する場合は、このオプションをdiscardFirstに設定し、エンドポイントを指定します。

-Dstate

破棄するメッセージの状態。次のいずれかの状態を指定します。

- PROCESSED: メッセージの処理は完了し、配信のために保留されています。

- STACKED: メッセージの処理を妨げるエラーが発生しました。

- PAUSED: エンドポイントは休止されています。

すべての状態のメッセージを破棄するには、コマンドの実行時にこのオプションを使用しないでください。

-Dendpoint

メッセージをリストするエンドポイントの名前(またはIPアドレスとポート番号)。すべてのターゲットに対するメッセージを破棄するには、コマンドの実行時にこのオプションを使用しないでください。

-Dmsgid

削除する特定のメッセージのメッセージID。このオプションを使用する場合、指定する必要があるのはモードのみであり、ターゲットや状態を指定する必要はありません。

例C-4 状態とエンドポイントに基づいた順序メッセージの破棄

この例では、Pharmacy01エンドポイントで状態がPROCESSEDであるすべてのメッセージを順序マネージャから削除します。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=discard -Dendpoint=Pharmacy01 -Dstate=PROCESSED

例C-5 状態に基づいた順序メッセージの破棄

この例では、状態がPROCESSEDであるすべてのメッセージを順序マネージャから削除します。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=discard -Dstate=PROCESSED

例C-6 エンドポイントに基づいた順序メッセージの破棄

この例では、Pharmacy01エンドポイントのすべてのメッセージを順序マネージャから削除します。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=discard -Dendpoint=Pharmacy01

例C-7 エンドポイントの最初の順序メッセージの破棄

この例では、Pharmacy 01エンドポイントの最初のメッセージを順序マネージャから削除します。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=discardFirst -Dendpoint=Pharmacy01

例C-8 メッセージIDに基づいた順序メッセージの破棄

この例では、メッセージIDで指定された単一のメッセージを順序マネージャから削除します。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=discard -Dmsgid=OAE851ED131B3D6103A00000152F97E9

C.3.5 メッセージの再処理

hcfpsequencemanagerユーティリティを使用して、順序メッセージを再処理できます。

このコマンドの構文は次のとおりです。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=command_mode -Dmsgid=message_id

オプション

説明

-Dmode

コマンドを実行するモード。この目的で、このオプションをreprocessに設定します。

-Dmsgid

再処理する特定のメッセージのメッセージID。このオプションを使用する場合、指定する必要があるのはモードのみであり、ターゲットや状態を指定する必要はありません。

例C-9 メッセージの再処理

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=reprocess -Dmsgid=32797717

C.3.6 エンドポイントの休止および再開

外部システムに障害が発生した場合など、特定のエンドポイントに対してメッセージの順序付け処理を休止する必要があることがあります。この場合、システムがリストアされるまでエンドポイントを休止できます。システムがリストアされた後は、エンドポイントの処理を再開できます。

このコマンドの構文は次のとおりです。

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=command_mode -Dendpoint=endpoint_name

オプション

説明

-Dmode

コマンドを実行するモード。この目的で、このオプションをpauseまたはresumeに設定します。

-Dendpoint

休止するエンドポイントの名前(またはIPアドレスとポート番号)。

例C-10 エンドポイントの休止

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=pause -Dendpoint=Pharmacy01

例C-11 エンドポイントの再開

ant -f ant-hcfp-util.xml hcfpsequencemanager -Dmode=resume -Dendpoint=Pharmacy01

D 高可用性でのMLLPの実装

この付録では、高可用性環境で最小の下位レイヤー・プロトコル(MLLP)を使用する場合にOracle SOA Suite for healthcare integrationアプリケーションを実装する方法について説明します。

この付録の内容は次のトピックを含みます:

- D.1項「Healthcare Integrationの高可用性の概要」

- D.2項「Oracle SOA Suite for Healthcare IntegrationでのMLLP高可用性の有効化」

D.1 Healthcare Integrationの高可用性の概要

Oracle SOA Suite for healthcare integrationの高可用性は、WebLogic Server、Oracle DatabaseおよびOracle SOA Suiteの高可用性機能を介して処理されます。Oracle SOA Suite for healthcare integrationの高可用性を構成するには、Oracle Enterprise ManagerでOracle B2Bプロパティを追加します。これらのプロパティを使用すると、healthcare integrationプロジェクトの高可用性を有効にし、クラスタ内のサーバーのタイムアウトおよびハートビート間隔を指定できます。

Oracle SOA Suite for healthcare integrationでMLLPに対して現在サポートされている機能(メッセージ順序付けを含む)はすべて、高可用性環境でもサポートされています。

D.1.1 高可用性処理

クラスタ環境においては、最初に起動して初期化したヘルスケア統合インスタンスが、MLLPトラフィックを処理するインスタンスとなります。MLLPトラフィックを処理するインスタンスに障害が発生した場合、クラスタ内の非アクティブなインスタンスがアクティブになり、構成済のタイムアウト期間内にMLLPトラフィックを処理する役割を引き継ぎます。ヘルスケア統合のメッセージ処理はトランザクションであるため、障害の発生したインスタンスからの送信中メッセージはすべてリカバリされます。このため、フェイルオーバー中にメッセージが失われることはありません。

障害の発生したインスタンスが完全に使用不可能になった場合、現在アクティブになっている2番目のインスタンスが、引き続き、高可用性処理専用に作成されたアウトバウンド配信キューとの間でのメッセージ送受信を行います。最初のインスタンスが再び使用可能になった場合、2番目のインスタンスが引き続きMLLPトラフィックを処理します。

D.1.2 フロントエンドのフェイルオーバー

クラスタ内のアクティブなノードに障害が発生した場合、ロード・バランサがフェイルオーバー・デバイスとして使用されます。これは、Oracle SOA Suite for healthcare integrationがクラスタ環境に実装されている場合、インバウンドMLLPトラフィックに対して必要になります。エンドポイントおよび外部システムは、ロード・バランサのIPアドレスを宛先接続として使用します。つまり、すべての接続は1つのアクティブ・ノードで確立され、メッセージ処理はクラスタ内のすべてのノードで実行されます。healthcare integrationインスタンス間で均等にメッセージが配信されるようにロード・バランサを構成できますが、接続を確立するのは、指定されたアクティブ・インスタンスのみです。ロード・バランサでCookieベースまたはアクティブな永続接続を使用すると、MLLPサーバーで予期しない動作が発生する可能性があります。デフォルトを非永続接続に設定し、接続の損失を回避するための永続性設定についてロード・バランサのドキュメントで確認することをお薦めします。

D.1.3 アクティブの概念

アクティブなサーバーとは、MLLPを使用してエンドポイントとの間でメッセージを送受信できる、クラスタ内の唯一のサーバーです。ただし、メッセージ処理はクラスタ内のすべてのサーバーによって行われます。たとえば、アウトバウンドの場合、メッセージはクラスタ内のすべてのサーバーにより送信されるように準備されますが、実際の送信はアクティブ・サーバーによってのみ行われます。これは、インバウンドの場合も同じです。

D.1.4 順序単位(UOO)

これは、Oracle Weblogic ServerのJMSキューに対する機能です。デフォルトの構成では、同じUOOに属するすべてのメッセージは特定のサーバーに関連付けられています。UOOは、Oracle Weblogic ServerでJMS内のメッセージを順序付けするために使用されます。このため、UOOを使用する場合、そのUOOと関連付けられているJMSキューがアクティブになってメッセージを受信する必要があります。これを実現するには、サーバー全体の移行を使用します。

注意:

HA環境でUOOを使用する場合は、サーバー移行を有効にする必要があります。

D.1.5 外部依存性

Oracle SOA Suite for healthcare integrationは、次のコンポーネントに依存しています。

- Oracle SOAデータベース(メッセージおよびメッセージ状態の永続性に関連)

- メタデータ・サービス(MDS)リポジトリ(インスタンス・メタデータに関連)

D.1.6 その他の参考資料

Oracle SOA Suiteの可用性の構成の詳細は、次の資料を参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』の「エンタープライズ・デプロイメントの概要」

- Oracle Fusion Middleware高可用性ガイド

D.2 Oracle SOA Suite for Healthcare IntegrationでのMLLP高可用性の有効化

Oracle SOA Suite for healthcare integrationを有効にするには、Oracle Enterprise Managerで特定のB2Bプロパティを定義する必要があります。これらのプロパティを使用すると、healthcare integrationの高可用性を有効にし、サーバーのタイムアウトおよびPing間隔を定義できます。

ヘルスケア統合のMLLP高可用性を有効にするには

1. Oracle Enterprise Managerにログオンします。
URLは、http://hostname:port/emです。

ここで、hostnameはWebLogic Serverが実行されているコンピュータの名前で、portはWebLogic Serverがリスニングしているポート番号です。

2. 左側のナビゲーション・パネルで、「SOA」ノードを開き、「soa-infra」を選択します。

3. 「SOAインフラストラクチャ」メニューをクリックして、「SOA管理」→「B2Bサーバー・プロパティ」を選択します。

図D-1 Enterprise Managerの「SOAインフラストラクチャ」メニュー

4. B2Bサーバー・プロパティ・ページで、「詳細B2B構成プロパティ」をクリックします。
システムMBeanブラウザ・ページが表示されます。

5. 「操作」タブをクリックし、「addProperty」をクリックします。

図D-2 「システムMBeanブラウザ」の操作ページ

6. 「パラメータ」表の「値」列で、key列にb2b.HAInstanceを入力し、value列にtrueを入力します。

図D-3 b2b.HAInstanceプロパティの追加

7. 「呼出し」をクリックします。
新しいプロパティが保存されます。

8. 前述の手順を使用して、b2b.MLLP_HA_Modeという名前の新しいプロパティを作成し、値をtrueに設定します。

9. 次のオプション・プロパティを定義できます。これらが定義されていない場合は、デフォルト値が使用されます。

プロパティ

説明

b2b.HAMaxElapsedTimeout

元のインスタンスに障害が発生した後、次のアクティブ・インスタンスがMLLPトラフィックを処理する役割を引き継ぐまでの時間(分単位)。デフォルト値は2分であり、2は使用できる最小値でもあります。

b2b.HAHeartBeatPing

サーバーが動作しているかどうかを判別するためのPingを実行する時間間隔(分単位)。デフォルト値は1分であり、1は使用できる最小値でもあります。

b2b.transportDispatcherThreadCount

高可用性モードで使用するMLLPディスパッチャ・スレッドの数。これは順序付けされていないメッセージに対してのみ使用され、JMSリソースと組み合せて使用されます。

b2b.transportDispatcherThreadSleepTime

MLLPディスパッチャ・スレッドがメッセージ処理後にスリープする時間(ミリ秒単位)。

b2b.MaxTimeinAcquiredState

フェイルオーバー中、メッセージが処理を再開するまでにACQUIRED状態を保持する時間(分単位)。

b2b.AcquiredStatePollingInterval

ACQUIRED状態にあるメッセージが再びポーリングされるまでの時間(分単位)。

b2b.SingleTransactionAtInbound

インバウンドMLLP HAの場合、ワイヤ・メッセージがデータベースにコミットされてからイベントがイベント・キューにエンキューされるまでにサーバーがクラッシュした場合、サーバーは順序マネージャ表内に永続的に停滞し、処理されません。これによって、順序付けにおけるインバウンド・メッセージ・フローがブロックされます。

MLLP HAの場合のみ、b2b.SingleTransactionAtInboundをtrueに設定して、JMSとデータベースのコミットが単一のトランザクションで行われるようにします。これは、一度に1つのみのインバウンド・メッセージが受信されるMLLPの場合にのみ適しています。

10. プロパティの追加が完了したら、「戻る」をクリックします。

11. 高可用性プロパティを定義した後は、「属性」タブでそれらを表示できます。プロパティを表示するには、「属性」タブをクリックし、「プロパティ」をクリックします。「値」表の「要素」ノードを開くと、プロパティの名前と値が表示されます。

図D-4 Enterprise Managerの高可用性プロパティ

E HL7メッセージのバッチ処理

この付録では、Oracle SOA Suite for healthcare integrationでのHL7バッチ処理の実装について説明します。バッチ処理を行うと、ファイル・ヘッダーとバッチ・ヘッダーからなるエンベロープを使用して、メッセージのバッチ番号を1つのファイルで送信できます。たとえば、詳細財務トランザクション(DFT)のバッチを付随システム(実験室、放射線科、薬局など)から財務システムに送信する場合などです。

Healthcareコンソールを使用すると、「管理」タブの「設定」→「ランタイム」→「その他」にある「部分バッチ・コミット・サイズ」を使用して、1つのメッセージ交換に対して多数のビジネス・メッセージが存在する場合にコミットするレコード数を指定することもできます。

この付録の内容は次のトピックを含みます:

- E.1項「HL7メッセージ・バッチ処理の概要」

E.1 HL7メッセージ・バッチ処理の概要

HL7メッセージは、次の基準でバッチ処理できます。

- ファイル・ヘッダー(FHS)によるバッチ処理

- バッチ・ヘッダー(BHS)によるバッチ処理

- FHSとBHSの両方によるバッチ処理

- メッセージ・ヘッダー(MSH)のみによるバッチ処理

HL7メッセージは、次の2つの方法でバッチ処理できます。

- 標準モード: HL7バッチ処理プロトコルを使用

- カスタム・モード

E.1.1 ファイル・ヘッダー(FHS)によるバッチ処理

Oracle SOA Suite for healthcare integrationコンソールを使用して、デフォルトのFHSを構成できます。

デフォルトのFHSを構成するには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 「デザイナ」タブで「構成」タブをクリックし、「ドキュメント・プロトコル」→「HL7」→「ドキュメント・バージョン」の順に開きます。

3. 「ドキュメント・バージョン」をダブルクリックして、右側のペインに「ドキュメント・バージョン」ウィンドウを表示します。

4. 「ファイル・ヘッダー」タブをクリックし、「ファイル・ヘッダーの作成」チェック・ボックスを選択します。

5. 使用可能なフィールドに、必要なパラメータ値を入力します。
「ファイル・ヘッダー」のパラメータの詳細は、3.3.1項「HL7ドキュメント・バージョン・パラメータに関する注意事項」の表3-2を参照してください。

6. 「適用」をクリックします。

注意:

Oracle Document Editorを使用して、カスタムのファイル・ヘッダーecsファイルを作成およびカスタマイズしたり、デフォルトのFHSを上書きできます。

E.1.2 バッチ・ヘッダー(BHS)によるバッチ処理

Oracle SOA Suite for healthcare integrationコンソールを使用して、デフォルトのBHSを構成できます。

デフォルトのBHSを構成するには:

1. E.1.1項「ファイル・ヘッダー(FHS)によるバッチ処理」の手順1から3までを繰り返します。

2. 「バッチ・ヘッダー」タブをクリックし、「バッチ・ヘッダーの作成」チェック・ボックスを選択します。

3. 使用可能なフィールドに、必要なパラメータ値を入力します。
「バッチ・ヘッダー」のパラメータの詳細は、3.3.1項「HL7ドキュメント・バージョン・パラメータに関する注意事項」の表3-2を参照してください。

4. 「適用」をクリックします。

注意:

Oracle Document Editorを使用して、カスタムのバッチ・ヘッダーecsファイルを作成およびカスタマイズしたり、デフォルトのFHSを上書きできます。

E.1.3 メッセージ・ヘッダー(MSH)によるバッチ処理

MSHをバッチ処理する場合、カスタム・デリミタで区切られたすべてのMSHをバッチ処理できます。このデリミタは、アウトバウンド・メッセージの場合はアウトバウンド・エンドポイントで構成し、インバウンド・メッセージの場合はリスニング・チャネルで構成します。

「メッセージ・ヘッダー」のパラメータの詳細は、3.3.1項「HL7ドキュメント・バージョン・パラメータに関する注意事項」の表3-2を参照してください。

E.1.4 バッチ処理時の機能確認の送信

Oracle SOA Suite for healthcare integrationコンソールを使用してメッセージをバッチ処理する際は、次の方法で機能確認をエンドポイント・パートナに送信できます。

- 単一メッセージ(単一)

- インバウンド・ビジネス・メッセージにつき1つの機能確認メッセージ(複数)

機能確認のオプションは、図E-1に示すように、「ドキュメント・バージョン」ウィンドウの「その他」タブにある「確認モード」リストを使用して指定できます。

図E-1 機能確認オプションの指定

また、MSH 15要素に基づいて確認を送信することもできます。MSH 15には次のような値を指定できます。

- AL - 常に

- ER - エラーまたは拒否された条件のみ

- NE - なし

- SU - 正常完了のみ

注意:

バッチ処理されたメッセージはすべて、レスポンス・バッチで確認されます。確認バッチには、エラーのあるメッセージに対する確認メッセージのみが含まれることがあります。

注意:

- 現在、HL7バッチ処理は、汎用ファイル・プロトコルおよび汎用FTPプロトコルを使用する単一ドキュメントに対してのみサポートされています。

- メッセージ順序付けとバッチ処理を同時に実行することはできません。

E.1.5 バッチ処理の標準モード

HL7バッチ処理プロトコルは、バッチ処理の標準モードで使用します。

このモードでは、HL7標準バッチ・プロトコル(FHSおよびBHS)を使用して、複数のメッセージが単一のファイルに書き込まれます。一般的なHL7バッチ・ファイル構造を次に示します。

[FHS](file header segment)
{--- BATCH begin
[BHS](batch header segment)
{ [--- MESSAGE  begin
MSH   (zero or more HL7 messages)
....
....--- messages may be of same type or different type
....
] }--- MESSAGE end
[BTS](batch trailer segment)
}--- Batch end
[FTS](file trailer segment)

E.1.6 バッチ処理のカスタム・モード

このモードでは、前述のHL7標準バッチ・プロトコル(FHSおよびBHS)を使用せず、次に示すような他のカスタム形式を使用して、複数のメッセージが単一のファイルに書き込まれます。

MSH
....
....
## --- message separator
MSH
....
....
## --- message separator
MSH
....
....
....

カスタム・モードでは、メッセージ・セパレータに基づいてインバウンド・メッセージのバッチ処理が解除されます。インバウンド・カスタム・メッセージのメッセージ・セパレータは、着信メッセージそのものから導出されます。このため、追加の構成は必要ありません。

Oracle SOA Suite for healthcare integrationコンソールを使用して、バッチ処理の解除に使用するカスタム・デリミタを指定できます。

カスタム・デリミタを指定するには:

1. Oracle SOA Suite for healthcare integrationコンソールにログオンします。

2. 目的のエンドポイント(「File」または「FTP」)を開きます。

3. 「トランスポートの詳細」ボタンをクリックして、「トランスポート・プロトコル・パラメータ」ダイアログ・ボックスを表示します。

4. 図E-2に示すように、「形式」タブをクリックして、「メッセージ・スプリッタ」フィールドでカスタム・デリミタを指定した後、「OK」をクリックしてダイアログ・ボックスを閉じます。

図E-2 カスタム・デリミタの指定

5. 「適用」をクリックして、エンドポイントに対する変更を保存します。

注意:

メッセージ・ペイロードにメッセージ・セパレータ文字列が存在すると、予期しないエラーが発生することがあるため、存在していないことを確認する必要があります。

E.1.7 バッチ処理のためのコマンドライン・ツール

この項では、バッチ処理に使用できるコマンドライン・ツールについて説明します。

表E-1に、バッチ処理コマンドラインのパラメータを示します。

表E-1 バッチ処理コマンドラインのパラメータ

パラメータ名

説明

ドメイン

必須

endpoint

エンドポイントの名前

-

はい

batchname

バッチの名前

-

はい

batchtime

バッチのトリガー時刻

cron文字、またはdd/MM/yyyy HH:mm AM/PM形式の日付

はい

document

ドキュメント・プロトコル名

有効な値:EDI_EDIFACT、EDI_X12

はい

docrevision

ドキュメント・リビジョン番号

-

はい

doctype

ドキュメント・タイプ名

-

はい

isrepetitive

cron文字列を使用してバッチを作成する際の反復的なバッチ処理を有効にします。

true|false (デフォルト)

いいえ

mode

バッチ・モード

バッチを削除する場合は、deletebatchに設定します。

いいえ

例:

特定のcron文字列について反復モードで実行するADT_A01ドキュメントに対して、FileEndpointを使用してバッチ操作を作成するには、次のように指定します。

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime="0 4850 11 7 5 ? 2010"-Dbatchname=batch1234 -Ddocument=HL7 -Ddocrevision=2.3.1 -Ddoctype=ADT_A01 -Disrepetitive=true

複数のドキュメント・タイプに対するバッチを作成するには:

ant -f ant-hcfp-util.xml hcfbatch -Dendpoint=FileEndpoint -Dbatchtime="0 58 11 7 5 ? 2010"-Dbatchname=batch1234 -Ddocument=HL7 -Ddocrevision=2.3.1 -Ddoctype=ADT_A01

または

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime="07/05/2010 11:45 AM"-Dbatchname=batch1234 -Ddocument=HL7 -Ddocrevision=2.3.1 -Ddoctype=ADYT_A01

バッチ操作を削除するには:

ant -f ant-hcfp-util.xml hcfpbatch -Dmode=deletebatch -Dbatchname=batch1234

batchtimeの値に*や#などの特殊文字が含まれる場合は、二重引用符を使用して文字をエスケープする必要があります。

ant -f ant-hcfp-util.xml hcfpbatch -Dendpoint=FileEndpoint -Dbatchtime='0 5,10,15,20,25,30,35,40,45,50,55,59"" "" "*" ? 2010' -Dbatchname=batch1234 -Ddocument=HL7 -Ddocrevision=2.3.1 -Ddoctype="ADT_A01" -Disrepetitive=true

F 機能確認999の構成

この付録では、ドキュメント・タイプ999機能確認(FA)を使用するためのOracle SOA Suite for healthcare integrationアプリケーションの構成について説明します。

この付録の内容は次のとおりです。

- F.1項「概要」

- F.2項「機能確認999: 使用例」

F.1 概要

Oracle Fusion Middleware B2Bでは、主にHIPAAの専門家によって使用されるドキュメント・タイプ999機能確認(FA)をサポートしています。デフォルトのFAのドキュメント・タイプ構成は997です。ただし、FAとしてドキュメント・タイプ999を指定すると、デフォルトをオーバーライドできます。また、ドキュメント・プロトコル・バージョンが着信メッセージのバージョンに関連付けられていないため、着信メッセージ837 v5010x223A1に対して999 v5010x231を送信できます。

F.2 機能確認999: 使用例

ドキュメント・プロトコルとしてX12を使用する場合、デフォルトの機能確認ドキュメント・タイプは997です。997の場合、997確認のバージョンは着信メッセージのバージョンと同じです。Oracle B2Bコンソールの設計時に、ドキュメント・タイプ・パラメータ・ページで次のパラメータを使用して、デフォルトの997 FAまたはバージョン(あるいはその両方)をオーバーライドできます。

- 機能確認トランザクション

- 機能確認トランザクション・バージョン

これ以外の構成(ドキュメント定義、デリバリ・チャネル、取引パートナ・アグリーメントなど)は、997と同じです。

次の使用例では、FA 999および997の構成について説明します。

- ユースケース1

- ユースケース2

- ユースケース3

F.2.1 ユースケース1

FAとして999を使用する必要があるが、バージョンを着信メッセージのバージョンと同じに保つ場合は、「機能確認トランザクション」のみを999に設定し、「機能確認トランザクション・バージョン」は空白にしておく必要があります。

F.2.2 ユースケース2

FAとして999を使用する必要があり、バージョンも着信メッセージのバージョンと異なるバージョンに保つ場合は、「機能確認トランザクション」パラメータと「機能確認トランザクション・バージョン」パラメータの両方を設定する必要があります。たとえば、「機能確認トランザクション」を999に設定し、「機能確認トランザクション・バージョン」を5010X231に設定する必要があります。

F.2.3 ユースケース3

FAとして997を使用する必要があるが、バージョンを着信メッセージのバージョンと異なるバージョンに保つ場合は、「機能確認トランザクション」を997に設定し、「機能確認トランザクション・バージョン」を5010に設定する必要があります(着信メッセージのバージョンが4010の場合)。ただし、この使用例はあまり一般的ではありません。

図F-1に、「機能確認トランザクション」と「機能確認トランザクション・バージョン」の構成を示します。

図F-1「機能確認トランザクション」の構成

G Oracle SOA Suite for Healthcare Integrationの監査リファレンス

この付録では、Oracle SOA Suite for Healthcare Integrationで監査を行う際の参照情報を記載します。

この付録の内容は次のとおりです。

- G.1項「カスタム監査レポートと標準監査レポートについて」

- G.2項「Oracle SOA Suite for Healthcare Integrationの監査イベント」

G.1 カスタム監査レポートと標準監査レポートについて

Oracle Fusion Middlewareの共通監査フレームワークには、監査レコードに基づいた一連の標準レポートが用意されています。また、標準レポートを変更し、独自のカスタム監査レポートを作成することもできます。I

この付録では、Oracle SOA Suite for Healthcare Integrationで監査可能なイベントについて説明します。カスタム・レポートを開発する場合は、この情報を使用して、各イベント・レコードの構造を理解してください。

次のドキュメントに、カスタム・レポートを記述する際に役立つ詳細情報が記載されています。

- Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドのOracle Business Intelligence Publisherの監査レポートの属性に関する項

- Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの監査レポートのカスタマイズに関する項

次のドキュメントに、監査を構成して標準レポートを表示する方法に関する追加情報が記載されています。

- Oracle SOA Suite for Healthcare Integrationでの監査の構成 - 参照

- Oracle SOA Suite for Healthcare Integrationでの監査対象イベントのリスト - 参照

G.2 Oracle SOA Suite for Healthcare Integrationの監査イベント

表G-1に、監査イベントとその属性を示します。

表G-1 Oracle SOA Suite for Healthcare Integrationの監査イベント

イベント・カテゴリ

イベント

イベントにより使用される属性

UserSession

UserLogin

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

UserLogout

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

EndpointManagement

EnableEndpoint

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

DisableEndpoint

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

DocumentManagement

ResubmitMessage

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

PurgeMessage

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

ReadPayload

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

Configuration

Import

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

Export

Date、Time、Initiator、EventType、EventStatus、MessageText、ECID、RID、ContextFields、SessionId、TargetComponentType、EventCategory、ThreadId、FailureCode、RemoteIP、Resource、AuthenticationMethod、Reason

索引
A  B  C  D  E  F  G  H  I  J  L  M  N  O  P  Q  R  S  T  U  W  X

A

「確認の受入」パラメータ, 3.3.2

「確認タイプの受入」パラメータ, 3.3.1

「確認モード」パラメータ, 3.3.1

「確認モード」パラメータ, 4.4, 7.2

「アクション」パラメータ, 3.2.2, 3.3.3

「管理」タブ, 1.4.1.5, 1.4.1.6, 1.4.1.7, 1.4.1.8

管理者ロール, 14.1

anyTypeオプション, 2.2.2.3

Apple Safari, 1.3

「アプリケーション確認タイプ」パラメータ, 3.3.1

アプリケーション・メッセージ・インスタンス, 9.3.3

「アプリケーション・メッセージ」レポート・フィルタ, 9.2.1

アプリケーション・サーバー接続ページ, 2.2.2.1

監査レベル, 11.1

監査ログ, 11.3

監査

概要, 11.1

構成, 11.2

フィルタ条件, 11.1.2

healthcare UIアクティビティ, 11.1.1

ユーザー・アクセスの監査

概要, 11.1

自動リフレッシュ, 8.3.4, 9.2.6 「自動リフレッシュ間隔(秒)」パラメータ, 13.2, 13.2

B

B2B IP_MESSAGE_TYPE, A.1

「バッチ日付」パラメータ, 3.3.1

「バッチ・ヘッダーECSファイル」パラメータ, 3.3.1

「バッチ・セキュリティ」パラメータ, 3.3.1

バインディング・コンポーネント, 1.1.3

バインディング・コンポーネント, 2.1.1

作成, 2.2.2

BPELプロセス, 2.2.3 「リソース・スキーマの参照」オプション, 2.2.2.3 ブラウザ、サポート対象, 1.3 ビジネス・メッセージの詳細, 8.6 ビジネス・メッセージ・インスタンス, 9.3.1 ビジネス・メッセージ・レポート・フィルタ・エディタ, 9.2.5 ビジネス・レポート・フィルタ・エディタ, 9.1.1 ビジネス・ルール, 2.2.3

C

「コールアウト・ディレクトリ」パラメータ, 5.3

コールアウト

概要, 1.1.1

作成, 5.3

ライブラリJARファイルの作成, 5.1.1

コールアウトのJARファイル・ライブラリの場所の定義, 5.3

定義、5.1

実装クラス, 5.3

エンドポイント内, 5.4

ライブラリ名, 5.3

概要, 1.4.1.3

パラメータ属性, 5.3

事前定義済のXSLTCalloutImplクラス・ファイル, 5.3

トランスポート, 5.2.1

チャネル, 1.4.1.5

概要, 1.1.1

作成,7.2

削除, 7.4

有効化, 7.3

「キャラクタ・セット」パラメータ, 3.3.1 コマンド行ツール

hcfpexport, 16.4

hcfpimport, 16.3

hcfppurge, 16.2

概要, 16

実行の前提条件, 16.1

「コンポジット・インスタンスID」レポート・フィルタ, 9.2.1, 9.2.3 「コンポジット名」レポート・フィルタ, 9.2.1, 9.2.3 「コンポジット・バージョン」レポート・フィルタ, 9.2.1, 9.2.3 コンポジット, 2.1 「構成」タブ, 1.4.1.1, 1.4.1.2, 1.4.1.3, 1.4.1.4 「コネクション・ファクトリ」パラメータ, 7.2, 7.2 「コネクション・ファクトリ」パラメータ, B.2.3 「接続モード」パラメータ, 4.2, B.1.1, B.1.2, B.1.3, B.1.4 管理番号

パージ, 12.1.5

相関, 7.5 相関フィールド, 9.2.1 「XPath式からの相関」パラメータ, 3.2.2, 3.3.3 「XPath名からの相関」パラメータ, 3.2.2, 3.3.3 「XPath名からの相関」レポート・フィルタ, 9.2.1 「XPath値からの相関」レポート・フィルタ, 9.2.1 「XPath式への相関」パラメータ, 3.2.2, 3.3.3 「XPath名への相関」パラメータ, 3.2.2, 3.3.3 「XPath名への相関」レポート・フィルタ, 9.2.1 「XPath値への相関」レポート・フィルタ, 9.2.1 「国コード」パラメータ, 3.3.1 「バッチ・ヘッダーの作成」パラメータ, 3.3.1 「ファイル・ヘッダーの作成」パラメータ, 3.3.1 作成

ダッシュボード, 8.3.1

内部デリバリ・チャネル, 7.2

レポート, 9.2.1

カスタム・ドキュメント・プロトコル, 3.2

XPath式の構成, 3.2.2.1

D

ダッシュボード

時間スライダの構成, 13.2

ダッシュボード・エディタ, 1.4.2 「ダッシュボード」タブ, 1.4.2 ダッシュボード

概要, 8.1

自動リフレッシュ, 8.3.4

構成, 8.3.3

エンドポイント詳細の構成, 13.2

作成, 8.3.1

デフォルト, [8.3.2]

デフォルトの期間, 13.2

削除, 8.3.5

エンドポイントの詳細, 8.4.2

エンドポイント・サマリー, 8.4.1

概要, 1.4.2

リフレッシュ, 8.3.4

サマリーの設定, 1.4.1.6

時間スライダ, 1.4.1.6

表示, 8.4

データ変換, 6.1 データベース, トランザクション・ログ, 1.1.4 削除

ダッシュボード, 8.3.5

ドキュメント定義, 3.5

エンドポイント, 4.5

内部デリバリ・チャネル, 7.4

マップセット, 6.3.3, 6.4.3

レポート, 9.2.7

デリバリ・チャネル, 1.4.1.5

作成,7.2

削除, 7.4

有効化, 7.3

デリバリ・チャネル, 内部

概要, 1.1.1

「説明」レポート・フィルタ, 9.2.1, 9.2.2, 9.2.3 「デザイナ」タブ, 1.4.1 設計時データ, 1.4.1.7, 1.4.1.8 設計時メタデータ, 12.1.1 設計時リポジトリ

エクスポート・ファイル, 12.1.3

エクスポート, 12.2

「接続先名」パラメータ, 7.2, 7.2 「接続先プロバイダ」パラメータ, 7.2 「方向」パラメータ, 4.2, B.2.1 「方向」レポート・フィルタ, 9.2.1, 9.2.2, 9.2.3 ドキュメント定義の処理ページ, 2.2.2.1, 2.2.2.3 ドキュメント定義の処理ページ, オプション, 2.2.2.1 ドキュメント定義ページ, 2.2.2.1 「ドキュメント定義」レポート・フィルタ, 9.2.1, 9.2.3 ドキュメント定義, 3.1.1, 3.4

概要, 1.1.1

エンドポイントへの追加, 4.3

作成, 3.4

定義、3.4

削除, 3.5

ドキュメント階層, 3.1.1 「ドキュメント」パラメータ, 3.2.2, 3.3.3 「ドキュメント・プロトコル」フォルダ, 1.4.1.1 「ドキュメント・プロトコル」レポート・フィルタ, 9.2.1, 9.2.3 ドキュメント・プロトコル・バージョン, 3.1.1, 3.4 ドキュメント・プロトコル, 3.1, 3.4

カスタム, 3.2

HL7, 3.1.1, 3.3

固有のトランザクション, 3.2

「ドキュメント・ルーティングID」パラメータ, 3.3.3 「ドキュメント・タイプ表示」パラメータ, 13.2 「ドキュメント・タイプ」レポート・フィルタ, 9.2.1, 9.2.3 ドキュメント・タイプ, 3.1.1, 3.4 「ドキュメント・バージョン」レポート・フィルタ, 9.2.1, 9.2.3 「ドメイン名」レポート・フィルタ, 9.2.1, 9.2.3 「DTD/XSDネームスペース変換」パラメータ, 3.2.2

E

「ECID」レポート・フィルタ, 9.2.1, 9.2.3

「要素デリミタ」パラメータ, 3.3.1

エンドポイントの詳細

ダッシュボード上, 8.4.2

「エンドポイント」レポート・フィルタ, 9.2.1, 9.2.2 エンドポイント・サマリー

ダッシュボード上, 8.4.1

endpoints

概要, 1.1.1, 4.1

コールアウトの追加, 5.4

およびマップセット, 6.4.2

ドキュメント定義との関連付け, 4.3

作成, 4.2, 4.2

エラー・メッセージ, 8.6

概要, 1.4.1.2

設定, 1.4.1.6

Enterprise Manager, 9.3.4 「エラー・コード」レポート・フィルタ, 9.2.1 エラー・メッセージ

エンドポイント用, 8.6

表示, 9.5.1

レポートのエラー・メッセージ, 9.5 「エラー・テキスト」レポート・フィルタ, 9.2.1 「エスケープ文字」パラメータ, 3.3.1 エクスポート・ファイル, 12.1.3, 12.2 エクスポート, 1.4.1.7, 1.4.1.8, 12.1.2

データ, 16.4

エクスポート・ファイル, 12.1.3, 12.1.3, 12.2

メタデータ, 12.2, 12.2

制限, 12.2

F

「ファイル日付」パラメータ, 3.3.1

「ファイル・ヘッダーECSファイル」パラメータ, 3.3.1

「ファイル・セキュリティ」パラメータ, 3.3.1

フィルタ条件, 11.1.2

フィルタ・エディタ, 9.1.1

「フォルダ名」パラメータ, 4.2, B.2.1, B.2.2, B.2.4

「B2Bによって処理される機能確認」パラメータ, 13.1

「機能確認の内部プロパティ」パラメータ, 13.1

機能確認, 13.1

G

開始, 1.2

Google Chrome, 1.3

「グループ管理番号」レポート・フィルタ, 9.2.1

H

hcfpexportコマンドライン・ツール, 16.4

hcfpimportコマンドライン・ツール, 16.3

hcfppurgeコマンドライン・ツール, 16.2

Health Level 7 (HL7), 3.1, 3.3, 6.4

定義, 3.3

即時確認, 3.3.4

否定確認メッセージ, 3.3.4

Healthcareアダプタ, 2.1.2

概要, 2.1

Healthcareアダプタ, コンポーネント・パレット, 2.2.2.1, 2.2.2.2 healthcareバインディング・コンポーネント

作成, 2.2.2

Healthcare構成ウィザード

概要, 2.1.1

アプリケーション・サーバー接続ページ, 2.2.2.1

ドキュメント定義の処理ページ, 2.2.2.1, 2.2.2.3

ドキュメント定義の処理ページ, オプション, 2.2.2.1

ドキュメント定義ページ, 2.2.2.1

「操作」ページ, 2.2.2.1, 2.2.2.2

「サービス名」ページ, 2.2.2.1, 2.2.2.2

Healthcareのテスト, 2.2.2.1

Healthcare構成, 「ドキュメント定義」ページ, 2.2.2.1 healthcare integrationリポジトリ, 12.1 HIPAA, 6.1, 6.3 HL7, 3.1, 3.3 「HL7汎用確認」パラメータ, 3.3.2 HL7 V2.3.1

ドキュメント階層, 3.1.1

「ホスト名」パラメータ, 4.2, B.1.1, B.1.2, B.1.3, B.1.4 ヒューマン・タスク, 2.2.3

I

「識別終了位置」パラメータ, 3.2.2

「識別式(XPath)」パラメータ, 3.2.2

識別式パラメータ, 3.2.2.1.1, 3.2.2.1.2, 3.2.2.1.3

「識別開始位置」パラメータ, 3.2.2

「識別値」パラメータ, 3.2.2, 3.2.2, 3.2.2.1.1, 3.2.2.1.2, 3.2.2.1.3

「エンベロープ・パラメータの無視」パラメータ, 3.3.1

即時確認, 3.3.4

「Healthcareからスキーマをインポート」オプション, 2.2.2.3

インポート, 1.4.1.7, 1.4.1.8, 12.1.1, 12.1.2

データ, 16.3

メタデータ, 12.2

インストール, 1.2 インスタンス・データ, 12.1.1 「交換管理番号」レポート・フィルタ, 9.2.1 内部デリバリ・チャネル, 1.4.1.5

概要, 1.1.1, 7.1

作成,7.2

削除, 7.4

有効化, 7.3

「国際バージョンID代替コード体系名」パラメータ, 3.3.1 「国際バージョンID代替識別子」パラメータ, 3.3.1 「国際バージョンID代替テキスト」パラメータ, 3.3.1 「国際バージョンIDコード体系名」パラメータ, 3.3.1 「国際バージョンIDテキスト」パラメータ, 3.3.1 「国際バージョン識別子」パラメータ, 3.3.1 「国際化コード代替コード体系名」パラメータ, 3.3.1 「国際化コード代替識別子」パラメータ, 3.3.1 「国際化コード代替テキスト」パラメータ, 3.3.1 「国際化コード識別子」パラメータ, 3.3.1 「国際化コード・テキスト」パラメータ, 3.3.1 「国際化コード体系名」パラメータ, 3.3.1 Internet Explorer, 1.3 「ペイロードのみマップ」パラメータ, 7.2 「トピック」パラメータ, 7.2

J

JARファイル, コールアウト用, 5.1.1

Javaコード

追加、1.1.1

JMSキュー, 1.1.1, 1.4.1.5, 7.1 JMSトピック, 1.1.1, 1.4.1.5, 7.1

L

ログ

データベース, 1.1.4

ログイン, 1.3

M

管理

ツール, 1.1.2

「確認制御IDのマップ」パラメータ, 3.3.2 マップセット

概要, 1.1.1, 6.1

削除, 6.3.3, 6.4.3

HIPAA, 6.3

HL7, 6.4

Oracle B2B, 6.3

マップ・ファイル, 6.2

healthcare integration UI, 6.4

概要, 1.4.1.4

「一致」レポート・フィルタ, 9.2.1 MDS, 1.1.4, 2.2.2.3, 12.1 メディエータ, 2.2.3 「メッセージID」(ビジネス)レポート・フィルタ, 9.2.1, 9.2.2, 9.2.3 「メッセージ・タイプ」パラメータ, 7.2 メッセージ

パージ, 9.6

再発行, 9.5.2

メッセージ, 再発行, 9.1.2 メタデータ, 1.4.1.7, 1.4.1.8

概要, 1.1.4

エクスポート, 12.1.2, 12.2

インポート, 12.1.2, 12.2

SOA Suite内, 1.1.3

パージ, 12.3

メタデータ・サービス, 1.1.4, 2.2.2.3 メタデータ・サービス, 12.1 Microsoft Internet Explorer, 1.3 監視ロール, 14.1 モニタリング

ツール, 1.1.2

Mozilla Firefox, 1.3 MSH.11, 3.3.1 MSH.15, 3.3.1 MSH.16, 3.3.1

N

「名前」パラメータ, 7.2

「名前」レポート・フィルタ, 9.2.1, 9.2.2, 9.2.3

「ネイティブ・メッセージ・サイズ」レポート・フィルタ, 9.2.1

正規化されたメッセージのプロパティ, A.2

IP_MESSAGE_TYPEのマッピング, A.1

「ゲージ列の数」パラメータ, 13.2

O

「不透明」オプション, 2.2.2.3

「操作」ページ, 2.2.2.1, 2.2.2.2

Oracle Document Editor, 1.1, 1.2, 1.4.1.1, 3.1

ドキュメント定義, 3.4

Oracle Healthcare

コマンドライン・ツール, 16

Oracle JDeveloper, 1.2 Oracle SOA Suite, 1.1.3 Oracle SOA Suite for healthcare integration

概要, 1.1

P

「ページ・サイズ」パラメータ, 13.2

「パスワード」パラメータ, 7.2

「ペイロード表示サイズ」(バイト数)パラメータ, 13.2

ペイロード・キー・フィールド, 9.2.1

ペイロード・キー・フィールド, 9.2.1

「ポーリング間隔」パラメータ, 7.2

ポート情報, 1.3.1

ポート番号, 1.3

「ポート」パラメータ, 4.2, B.1.1, B.1.2, B.1.3, B.1.4

「処理ID」パラメータ, 3.3.1

固有のトランザクション, 3.2

「プロトコル・メッセージID」レポート・フィルタ, 9.2.1

プロトコル

カスタム, 3.2

HL7, 3.1.1, 3.3

管理番号のパージ, 12.3 設計メタデータのパージ, 12.3 インスタンス・データのパージ, 12.3 パージ, 1.4.1.7, 1.4.1.8, 12.1.1, 12.3

概要, 12.1.4

管理番号, 12.1.5

データ, 16.2

メッセージのパージ, 9.6

Q

キュー, 1.1.1, 1.4.1.5, 7.1

R

「再試行数」パラメータ, 4.4, 7.2

内部から受信, 7.2

「HLリポジトリでスキーマを参照」オプション, 2.2.2.3

参照, 1.1.3

「参照名」レポート・フィルタ, 9.2.1, 9.2.3

リフレッシュ, ドキュメント定義ページ, 2.2.2.1

「繰返しセパレータ」パラメータ, 3.3.1

「既存のメタデータの置換」オプション, 12.1.2, 12.2

レポート

概要, 9.1

アプリケーション・メッセージ・インスタンス, 9.3.3

自動リフレッシュ, 9.2.6

ビジネス・メッセージ・インスタンス, 9.3.1

構成, 9.2.5

表示属性の構成, 13.2

時間スライダの構成, 13.2

作成, 9.2.1

デフォルト, [9.2.4]

削除, 9.2.7

概要, 1.4.3

リフレッシュ, 9.2.6

設定, 1.4.1.6

ワイヤ・メッセージ・インスタンス, 9.3.2

「レポート」タブ, 1.4.3 リポジトリ, healthcare integration用, 12.1 要件, 1.2 メッセージの再発行, 9.1.2, 9.5.2 「再試行間隔」パラメータ, 4.4, 7.2 パスワードの再入力パラメータ, 7.2 ロール

管理者ロール, 14.1

監視ロール, 14.1

ランタイム・データ, 1.4.1.7, 1.4.1.8 ランタイム・プロパティ, 1.4.1.6 実行時の設定

概要, 13.1

構成, 13.1

S

SCAの正規化されたメッセージ・プロパティ, A.1

検索, ドキュメント定義ページ, 2.2.2.1

「セキュリティ」パラメータ, 3.3.1

「セグメント・デリミタ」パラメータ, 3.3.1

内部に送信, 7.2

「順序付け」パラメータ, 7.2

サービス, 1.1.3

サービス・コンポーネント

概要, 2.2.3

「サービス名」ページ, 2.2.2.1, 2.2.2.2 「サービス名」レポート・フィルタ, 9.2.1, 9.2.3 サービス, 2.1.1 ダッシュボード・エディタの表示, 8.3.3 データベースのフィールドを表示, 8.3.3 より多くのエンドポイント詳細を表示, 8.4.2, 8.5 「ペイロードの表示」パラメータ, 13.2 SOAアプリケーション

作成, 2.2.1

制限, 2.2.1

SOAコンポジット, 2.1 SOAINFRAデータベース・スキーマ, 1.1.4 「状態」レポート・フィルタ, 9.2.1, 9.2.2, 9.2.3 「サブコンポーネント・デリミタ」パラメータ, 3.3.1 「サブ要素デリミタ」パラメータ, 3.3.1 「サブスクライバID」パラメータ, 7.2

T

Healthcareのテスト, 2.2.2.1

時間スライダ, 1.4.1.6

構成, 13.2

トピック, 1.1.1, 1.4.1.5, 7.1 取引パートナ・アグリーメント, 6.3.2 トランザクション・ログ

データベース, 1.1.4

「トランザクション・セット管理番号」レポート・フィルタ, 9.2.1 「トランザクション・セットECSファイル」パラメータ, 3.3.3 トランスフォーメーション・マッピング, 1.1.1 データの変換, 6.1 「変換済メッセージ・サイズ」レポート・フィルタ, 9.2.1 「トランスポート・コールアウト」パラメータ, 4.4 トランスポート・コールアウト, 5.2.1 「トランスポート・プロトコル名」レポート・フィルタ, 9.2.1 「トランスポート・プロトコル」パラメータ, 4.2, 4.2, 4.4, 7.2, B.1.1, B.1.2, B.1.3, B.1.4, B.2.1, B.2.2, B.2.3, B.2.4 「トランスポート・プロトコル」パラメータ, 7.2 「トランスポート・プロトコル・バージョン」レポート・フィルタ, 9.2.1

U

Unicodeサポート, 2.2.1, 2.2.1

URL, 1.3

「JMS IDの使用」パラメータ, 7.2

ユーザー・アクセスの監査, 11.1.2

監査ログ, 11.3

構成、11.2

healthcare UIアクティビティ, 11.1.1

ユーザー・インタフェース

概要, 1.4

ログイン, 1.3

メイン・ページ, 1.3

設定, 1.4.1.6

URL, 1.3

ユーザー・インタフェースの設定, 1.4.1.6

構成, 13.2

「ユーザー名」パラメータ, 7.2

W

Webブラウザ, サポート, 1.3

Webサービス, 2.1.1

ワイヤ・メッセージ・インスタンス, 9.3.2

X

「XPath式1」パラメータ, 3.2.2, 3.3.3

「XPath式2」パラメータ, 3.2.2, 3.3.3

「XPath式3」パラメータ, 3.2.2, 3.3.3

XPath式, カスタム・ドキュメント, 3.2.2.1

「XPath名1」パラメータ, 3.2.2, 3.3.3

「XPath名2」パラメータ, 3.2.2, 3.3.3

「XPath名3」パラメータ, 3.2.2, 3.3.3

XSLTCalloutImplクラス・ファイル, 5.3

XSLTFileパラメータ, 3.2.2, 3.3.3

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。