1 Oracle SOA Suite for Healthcare Integrationのスタート・ガイド
この章のトピックは、次のとおりです:
1.1 Oracle SOA Suite for Healthcare Integrationの概要
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 for Healthcare Integrationのインストールおよび構成は他の場所で説明されています。ただし、自分でインストールできるものもあります。
Oracle SOA Suite for Healthcare Integrationのインストールと構成の詳細は、B2BとHealthcareのインストールと構成を参照してください。
1.2.1 HL7 DocTypeのMDSへのインポート
次の手順では、HL7 DocTypeをMDSにインポートする方法を説明します。
ノート:
次のステップで示されているパスのイタリック部分(ORACLE_HOMEなど)を、必ずインストール環境のパスで置き換えてください。
-
Oracle Technology Network (OTN)から、HL7 Healthcareライブラリ(
ofm_healthcare_lib_generic_12.1.3.0_disk1_1of1.zip
)をダウンロードします。ofm_healthcare_lib_generic_12.1.3.0_disk1_1of1.zip
を解凍して、HL7 2.xドキュメントの様々なバージョンを次のディレクトリに抽出します。ORACLE_HOME
/soa/thirdparty/healthcare/hl7_doctypes
-
コマンド・プロンプト・ウィンドウで、
JAVA_HOME
およびおANT_HOME
環境変数を次のように設定します。setenv ANT_HOME
ORACLE_HOME/oracle_common/modules/org.apache.ant_1.9.2
setenv PATH=$ANT_HOME/bin:$PATH
setenv JAVA_HOME
ORACLE_HOME/jrockit_install_directorysetenv PATH=$JAVA_HOME/bin:$PATH
-
jndi.properties
ファイルを作成します。-
コマンド・プロンプトで、次のディレクトリをカレント・ディレクトリにします。
ORACLE_HOME
/
soa
/bin
-
次のコマンドを実行します。
ant -f ant-hcfp-util.xml hcfpcreate-prop
-
jndi.properties
ファイルを編集してWebLogicパスワードを追加し、portNumber
およびその他のパラメータの値が正しいことを確認します。
-
-
healthcareライブラリをステップ1で示した場所に解凍した場合は、
hcfpimport
Antターゲットを実行して任意のHL7 v2.x DocTypeバージョンをインポートし、次の例に示すようにHL7 2.3.1 DocTypesをインポートできます。ant -f ant-hcfp-util.xml hcfpimport -Dlocalfile=true -Dexportfile="
ORACLE_HOME/soa
/soa/thirdparty/healthcare/hl7_doctypes/HL7DocType-2.3.1.zip"
1.3 Oracle SOA Suite for Healthcare Integrationへのログイン
以下の手順は、Oracle SOA Suite for Healthcare integrationを含むOracle SOA 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.3.1 ポート情報の検索
ポート番号は次の方法で確認できます。
-
Oracle Weblogic Server管理コンソールから:
-
コンソールにログオンします。
-
「ドメイン構造」ペインで、図1-1に示すように、「環境」を開いて「サーバー」をクリックします。
-
サーバーの「リスニング・ポート」列を書き留めます。
-
-
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ユーザー・インタフェースの使用
1.4.1 デザイナ
「デザイナ」タブの「構成」サブタブを使用して(図1-2を参照)、ドキュメント・プロトコル、エンドポイント、コールアウト、マップセットを構成し、「管理」サブタブを使用して、ランタイムおよびユーザー・インタフェース設定や内部デリバリ・チャネル設定の変更、メタデータのインポート、エクスポートおよびパージを行います。
1.4.1.1 ドキュメントの構成
「構成」タブの「ドキュメント・プロトコル」フォルダを使用して、ドキュメント・プロトコル、ドキュメント・プロトコル・バージョン、ドキュメント・タイプおよびドキュメント定義を作成、変更、削除できます(図1-3を参照)。これらのドキュメント定義は、後からエンドポイントに関連付けることができます。
ノート:
Oracle Document Editorでドキュメントを作成するか、「管理」タブのインポート/エクスポート機能を使用して、すでに作成されたドキュメント定義を含むシード済のエクスポートzipファイルを使用できます。
ドキュメントおよびドキュメント・プロトコルの詳細は、ドキュメント・タイプおよびドキュメント・プロトコルの操作を参照してください。
1.4.1.2 エンドポイントの構成
エンドポイントとは、メッセージの送受信が行われる場所です。URL、フォルダ、パスなどをエンドポイントにすることができます。「構成」タブの「エンドポイント」フォルダを使用して、エンドポイントの作成、変更、削除およびドキュメント定義にエンドポイントの関連付けを行うことができます。
図1-4は、エンドポイントの例を示しています。
エンドポイントの詳細は、エンドポイントの操作を参照してください。
1.4.1.3 コールアウトの構成
1.4.1.4 マップセットの構成
1.4.1.5 内部デリバリ・チャネルの構成
内部デリバリ・チャネルは、内部の医療システムでのメッセージの使用を可能にするためのOracle SOA Suite for healthcare integrationからJMSトピックまたはキューへのメッセージの配信方法または外部システムからトピックまたはキューに送信されたメッセージのOracle SOA Suite for healthcare integrationへの配信方法を定義します。接続情報やトランスポート・プロトコルなどが定義されます。「管理」タブの「内部デリバリ・チャネル」を使用して、内部デリバリ・チャネルを作成および構成できます。
図1-7は、内部デリバリ・チャネルの例を示しています。
内部デリバリ・チャネルの詳細は、内部デリバリ・チャネルの操作を参照してください。
1.4.1.6 ランタイムおよびユーザー・インタフェースのプロパティの設定
Oracle SOA Suiteヘルスケア統合のランタイムおよびユーザー・インタフェースのプロパティを変更できます:
-
ランタイム設定: 「管理」タブの「設定」の下で「ランタイム」をダブルクリックしてランタイム設定ページを開き、機能確認、大規模なペイロード、コールアウト・ディレクトリ名、ディスパッチャ数に関連するランタイム・パラメータを変更できます。
-
ユーザー・インタフェース設定: 「管理」タブの「設定」の下で「UI」をダブルクリックしてユーザー・インタフェース設定ページを開き、次のユーザー・インタフェース・プロパティを設定できます:
-
時間スライダ期間: ダッシュボード・サマリー・ページの「時間範囲」で選択できるようにするため、最大9つの時間スライダ期間を選択できます。
-
セッション・タイムアウト(秒): 処理が行われずセッションがタイムアウトする場合に設定できます。単位は秒です。デフォルトは300秒です。
-
ファイル・アップロード最大サイズ(KB): アップロードできるファイルのサイズで、キロバイト単位で制限を設定できます。
-
「ダッシュボード・サマリー」設定: ダッシュボードの統計情報を表示する履歴の時間範囲、エンドポイント・ステータス・グリッドに使用する列数、ダッシュボード・サマリー・ビューの自動リフレッシュ間隔(秒単位)を指定できます。
-
「エンドポイント」設定: ドキュメント・タイプ統計情報の表示形式(ゲージまたは表)、ゲージ・グリッドで使用する列数、ダッシュボードのエンドポイント詳細ビューの自動リフレッシュ間隔(秒単位)を指定できます。
-
「レポート」設定: レポートの自動リフレッシュ間隔(秒単位)、レポート結果表に表示される1ページ当たりの行数、メッセージ・ペイロードの表示を指定できます。
-
ランタイムおよびユーザー・インタフェース設定の詳細は、「システム設定の構成」を参照してください。
1.4.1.7 リポジトリ・データの管理
リポジトリ管理ページでは、Oracle SOA Suite for healthcare integrationリポジトリ・データのエクスポートや、その他のエクスポート済ファイル(ドキュメント定義、マップセットまたはその他のhealthcare関連リポジトリ・データなど)のインポートを行うことができます。設計時および実行時のメタデータもパージできます。
Oracle SOA Suite for healthcare integrationリポジトリの管理の詳細は、リポジトリの管理を参照してください。
1.4.1.8 アラートと連絡先の構成
アラートと連絡先ページでは、連絡先のリストを定義し、各連絡先に通知する必要があるイベントを関連付けることができます。実行時や設計時の様々なイベントに対しアラートを送信できます。
アラートおよび連絡先の管理の詳細は、アラートと連絡先の構成 を参照してください。
1.4.2 ダッシュボード
「ダッシュボード」タブをクリックすると、ダッシュボード・ページが表示されます。ダッシュボード・ページを初めて開くと、次のオプションが表示されます(図1-12を参照)。
-
タブが選択されたら表示するデフォルトのダッシュボードを設定: ダッシュボード・ページを開いたときにデフォルトで表示されるダッシュボードの名前を指定します
-
既存のダッシュボードを開くまたは編集: 使用可能なダッシュボードを開くか編集します
-
ダッシュボードの作成: 新しいダッシュボードを作成します
-
既存のダッシュボードの削除: ダッシュボードを削除します
その後ダッシュボード・ページにアクセスすると、前に指定したデフォルトのダッシュボード・ページが表示されます。このページには、特定のダッシュボードに関連付けられたすべてのエンドポイントが表示されます。このページではまた、エンドポイントの状態、エンドポイントが表示される列数、ダッシュボードの自動リフレッシュ間隔に関係なく、すべてのエンドポイントを表示するかどうかを指定できます。ページにあるダッシュボード・エディタ・ボタンを使用して、ダッシュボード名を変更したり、使用可能なエンドポイントのリストからダッシュボードに必要なエンドポイントを選択できます。
各エンドポイントには、エンドポイントのプロパティを表示したり、エンドポイントを構成するためのオプションがあります。特定のエンドポイントの情報ボタンにマウス・カーソルを合せると、エンドポイントのプロパティが表示されます。情報ボタンの横にある「このエンドポイントの構成」ボタンをクリックすると、関連するエンドポイントの編集ページにリダイレクトされます。
エンドポイント・ウィンドウの右上隅のボタンをクリックして、詳細を表示できます。
図1-13は、ダッシュボード・ページの例を示しています。
ダッシュボードの詳細は、ダッシュボードの操作を参照してください。
1.4.3 レポート
「レポート」タブをクリックすると、レポート・ページが表示されます。レポート・ページには、すべてのエンドポイントに関連する、すべての異なるタイプのインバウンド・メッセージとアウトバンド・メッセージ(ワイヤ、ビジネスおよびアプリケーション)が表示されます。また、このページでは次のことを実行できます。
-
使用可能なメッセージ全体を移動する
-
1ページ当たりに表示されるメッセージ数を指定する
-
メッセージ・フィルタ・エディタを開いてビジネス・メッセージ・レポート・フィルタを作成する
-
自動リフレッシュ間隔を指定する
リストのメッセージをクリックすると、下のペインに選択したメッセージのすべての異なるメッセージ・タイプ(ワイヤ・メッセージ、ビジネス・メッセージ、アプリケーション・メッセージ)が表示されます。各メッセージ・タイプをクリックすると、詳細が表示されます。
図1-14は、メッセージ・リスト、メッセージ・タイプの詳細、ビジネス・メッセージ・レポート・エディタが表示されたレポートの例を示しています。
レポートの詳細は、レポートの作業 を参照してください。
1.5 アクセシビリティ・オプション
この項では、Oracle SOA Suite for Healthcare Integrationで利用できるアクセシビリティ・オプションについて説明します。
1.5.1 キーボードを使用したツリー要素の展開および縮小
スペースバーまたは[Enter]キーを押してツリー要素(+または—がついている要素)を展開することはできません。
ツリー要素を展開または縮小するには、次のステップを実行してください。
-
[Tab]キーを使用して、必要な要素にナビゲートします。
-
[Enter]を押してコンポーネントを選択します。
-
[Ctrl]+[Alt]+[M]を押して、コンテキスト・メニューを起動します。
-
[Up]および[Down]の矢印を押して、コンテキスト・メニューのオプションをナビゲートします。
1.5.2 Oracle SOA Suite for Healthcare Integrationでのアクセシビリティ機能の有効化
Oracle SOA Suite for healthcare integrationは、スクリーン・リーダーのオプションを提供しており、これにより、ご使用のスクリーン・リーダーでこのアプリケーションのすべてのコンポーネントにアクセスし、読み取ることができます。
スクリーン・リーダーを有効化するには:
- メイン・ウィンドウの右上隅にある「プリファレンス」リンクをクリックします。
- 「プリファレンス」ポップアップのナビゲーション・ペインで「アクセシビリティ」オプションを選択します。
- 「モード設定」ドロップダウン・リストで、「スクリーン・リーダー・モードの有効化」を選択します。
- 「OK」をクリックします。