WebOTX Manual V11.1 (第6版) 目次を表示

---

3.2.12. HL7バインディング

図2.9.12-1

3.2.12.1. サービスユニットのファイル構成

図2.9.12.1-1

3.2.12.2. エンドポイントの設定

図2.9.12.2-1

Memo
 エンドポイントを追加する方法については、 2.7.1. エンドポイントの追加 をご覧下さい。

3.2.12.3. オペレーション設定

図2.9.12.3-1

3.2.12.4. セキュリティ認証の設定

3.2.12.5. トランザクションの設定

3.2.12.6. メッセージ送信優先度の設定

3.2.12.7. エラーリトライの設定

Memo
HL7 BCではプロバイダにもエラーリトライの設定が有効です。プロバイダのエラーリトライを有効にすると、外部サーバアプリケーションへのメッセージ送信でIOExceptionが発生した場合にメッセージ再送します。

3.2.12.8. オプション一覧の設定

3.2.12.9. メッセージエクスチェンジハンドラの設定

3.2.12.10. MLLPパラメータ詳細設定

図2.9.12.10-1

図2.9.12.10-2

3.2.12.11. メッセージ交換方式(MEP)

HL7 BC は Outbound、Inbound ともに In-Only、Robust In-Only、In-Out の3つのMEPをサポートします。
メッセージ交換方式(MEP)の説明は [ 製品構成と提供機能 > 3.JBI仕様 > 3.2.Normalized Message Router ] を参照してください。

Outbound
Outboundの各MEPの動作を説明します。

Inbound
Inboundの各MEPの動作を説明します。

3.2.12.12. ノーマライズ規則

ノーマライズ規則

HL7 BCのInboundのリクエスト受信処理、およびOutboundのレスポンス受信処理では、 外部アプリケーションから受け取ったメッセージをLLPハンドラのreceiveメソッドに より処理した結果をメッセージエクスチェンジに変換（ノーマライズ）します。 HL7 BCのノーマライズを示した図です。 オペレーションの設定項目「入力メッセージのタイプ」によりメッセージを 格納する箇所を指定することができます。 「入力メッセージのタイプ」を"XML"に指定した場合はノーマライズメッセージの メッセージコンテントに、"attachment"に指定した場合は添付ファイルに格納します。

図2.9.12.12-1

デノーマライズ規則

HL7 BCのInboundのレスポンス送信処理、およびOutboundのリクエスト送信処理では、 ノーマライズとは逆に、メッセージエクスチェンジから受け取ったメッセージを LLPハンドラのsendメソッドにより外部アプリケーションに送信するメッセージに変換（デノーマライズ）します。 オペレーションの設定項目「出力メッセージのタイプ」によりメッセージを 取りだす箇所を指定することができます。 「出力メッセージのタイプ」を"XML"に指定した場合はノーマライズメッセージの メッセージコンテントから、"attachment"に指定した場合は添付ファイルから取り出します。

図2.9.12.12-2

3.2.12.13. 異常系メッセージ

プロバイダエンドポイントがサーバアプリケーションからエラーメッセージを受信した場合(HL7 BC同士の連携時)

HL7 BCのプロバイダエンドポイントがMSA-1(肯定応答コード)がAR/AE/CR/CEのメッセージを受け取ると、 HL7 BCのInboundにはFaultが通知され、 クライアントアプリケーションにはプロバイダエンドポイントが受け取ったエラーメッセージがそのまま返信されます。

HL7 BCの処理中にHL7仕様上の異常が発生した場合

HL7 BCの処理中に、形式が不正なメッセージやフィールドの値が異常なメッセージなどを受信した場合、 HL7 BCでMSA-1(肯定応答コード)がARのACKメッセージを生成し、クライアントアプリケーションに返信します。 HL7 BCのOutboundで異常が発生した場合は、InboundにFaultが通知されます。 エラー内容の詳細はERR-1に記載されます。

HL7 BCの処理中にHL7仕様外の異常が発生した場合

HL7 BCの処理中に、サーバアプリケーションとの通信に失敗するなどHL7仕様外の異常が発生した場合、 HL7 BCでMSA-1(肯定応答コード)がARのACKメッセージを生成し、クライアントアプリケーションに返信します。 HL7 BCのOutboundで異常が発生した場合は、InboundにErrorが通知されます。 エラー内容の詳細はERR-1に記載されます。

プロバイダエンドポイントがFault/Errorを返却した場合(HL7 BC以外との連携時)

HL7 BC以外のプロバイダエンドポイントから Fault/Error を受け取った場合、 HL7 BCのInboundでMSA-1(肯定応答コード)がARのACKメッセージを生成し、クライアントアプリケーションに返信します。 エラー内容の詳細はERR-1に記載されます。

3.2.12.14. メッセージ変換

変換元のメッセージフォーマットと変換先のメッセージフォーマットを指定することでメッセージ変換を行います。 設定方法に関しては、[2.9.12.2. エンドポイントの設定] を参照して下さい。 変換元フォーマットと変換先フォーマットに同じ値を指定した場合はメッセージ変換しません。

スキーマ定義ファイル名はHL7標準のスキーマ定義ファイル名に準拠します。 変換エンジンで必要となるスキーマ定義はdatatypes.xsd(データタイプ)、fields.xsd(フィールド、セグメント)、 XXX_XXX.xsd(メッセージ)であるため、ユーザ独自のデータタイプとフィールドに関してはそれぞれdatatypes.xsd、 fields.xsd固定となります。HL7標準のファイルとの区別は配置するフォルダで分けます。 スキーマ定義ファイルの配置場所は3箇所あります。

1.HL7標準のスキーマ
<INSTANCE_ROOT>/jbi/bindings/HL7Bindings/install_root/schema/<バージョン名>
2.共有のカスタマイズスキーマ
<INSTANCE_ROOT>/jbi/bindings/HL7Bindings/install_root/workspace/schema/<バージョン名>
3.SU個別のカスタマイズスキーマ
<SU作成ディレクトリ>/META-INF/schema/<バージョン名>

ユーザが作成したスキーマ定義ファイルは上記の2.または3.に格納します。 オリジナルとユーザ独自のメッセージが同じ定義ファイル名となった場合は、3.→2.→1.の順に優先します。
追加・置換したスキーマ定義ファイルを有効化するためには、サービスアセンブリの再起動が必要です。

3.2.12.15. 固定応答

3.2.12.16. シーケンス番号プロトコル

シーケンス番号をESBで管理するために、出力先としてのデータベースを用意する必要があります。

サポートするデータベースは以下の通りです。

• Oracle Database 11g Release 2 (11.2.0)
• Microsoft SQL Server 2008 R2
• Apache Derby 10.5.3.0

ドメインが起動されているときは、一旦終了します。
データベースのドライバライブラリを、<INSTANCE_ROOT>/lib/ext へコピーします。

シーケンス番号をデータベースに出力するために使用するJDBCデータソースをWebOTX統合運用管理ツールを用いて登録します。

統合運用管理ツールの画面上で設定対象のドメイン(例えば[domain1])-[リソース]をクリックします。次に「JDBCデータソース」を右クリックして「JDBCデータソースの登録」を選択します。

• ｢JNDIサーバへの登録名｣項目の既定値は「jdbc/esb_hl7_esn」です。異なる値を設定する場合は後述する追加の設定を行ってください。
• 互換性のため、｢データソースの種別｣項目に[JDBC API]の選択を推奨します。
• ｢JDBC仕様のメジャーバージョン｣項目に「3｣を推奨します。
• 「ユーザ名」項目の既定値は「WEBOTXESB_HL7」です。異なる値を設定する場合は後述する追加の設定を行ってください。

「リソースの操作」画面が開きます。この画面を用いてJDBCデータソースを登録します。このとき、次の1点のチェックを解除してから登録します。

「一般」タグの「JTA連携有無」のチェックを解除します。

otxadminコマンドでJDBCデータソースを登録することもできます、詳細はWebOTXマニュアル[ 4.2.2. otxadminサブコマンド一覧 ] よりcreate-jdbc-datasourceをご参照ください。

シーケンス番号をデータベースに出力する際に使用するデータベースのユーザ登録を行います。

Oracleでは、以下のSQL文を実行します。「ユーザ名」の部分には前述のJDBCデータソースの登録で指定したユーザ名を指定します。
テーブル名の既定値は「ESN」です。異なる値を設定する場合は後述する追加の設定を行ってください。

SQL> CREATE USER ユーザ名 IDENTIFIED BY パスワード;
SQL> GRANT CREATE SESSION, unlimited tablespace TO ユーザ名;
SQL> CREATE TABLE ユーザ名.テーブル名 (ENDPOINTID VARCHAR(1000), ESN INTEGER, ESNSTATE INTEGER, primary key (ENDPOINTID));
SQL> GRANT SELECT, INSERT, UPDATE, DELETE ON ユーザ名.テーブル名 TO ユーザ名;

運用管理ツールまたは運用管理コマンド(otxadmin)で、JNDI名またはテーブル名を既定値から変更してください。
詳細は[ リファレンス集 運用管理・設定・構成編 > コンフィグレーション > バインディングコンポーネントに関する設定 > HL7 BC ]をご参照下さい。

本手順により作成したテーブルはESBをアンインストールしても自動で削除されません。
ESBのアンインストール後は以下のSQL文を実行し、手動で削除してください。

SQL> DROP TABLE ユーザ名.テーブル名;
SQL> DROP USER ユーザ名;

クライアントにACKメッセージを返信します。「-1」の場合はシーケンス番号をリセットします。
メッセージの各フィールドには以下の値が設定されます。表に記載の無いフィールドには値を設定しません。

サーバにシーケンス番号のリセット要求を送信します。 リセット後、シーケンス番号は「1」からスタートします。
メッセージの各フィールドには以下の値が設定されます。表に記載の無いフィールドには値を設定しません。

3.2.12.17. SFTセグメントの設定

<?xml version="1.0" encoding="UTF-8"?>
<MSG>
     <SFT>
          <SFT.1>NEC Corporation</SFT.1>
          <SFT.2>1</SFT.2>
          <SFT.3>WebOTX Enterprise Service Bus</SFT.3>
          <SFT.4>1</SFT.4>
          <SFT.5></SFT.5>
          <SFT.6></SFT.6>
     </SFT>
</MSG>

3.2.12.18. MLLPハンドラ

<SB>[HL7メッセージ]<EB><CR>

<SB>：スタートブロック
<EB>：エンドブロック
<CR>：キャリッジリターン

メッセージ受信処理

クライアントからデータを受信すると、MLLPに従ってHL7メッセージの抽出が行われます。<SB>が見つかるまでメッセージを読み飛ばし、 <SB>の直後からHL7メッセージとして扱います。 設定により<SB>が省略されている場合、受信したデータの先頭からHL7メッセージと見なします。
<EB><CR>が見つかるまで受信データを走査し、<EB><CR>の直前までをHL7メッセージとして切り出します。 <EB><CR>が見つかる前に再度<SB>が存在している場合、それまでに読み取ったデータを破棄し、直後のデータをHL7メッセージの先頭とします。

メッセージ送信処理

メッセージエクスチェンジからHL7メッセージを受け取り、先頭に<SB>、末尾に<EB><CR>を付与し、MLLPベースのHL7メッセージを作成します。 設定により<SB>が省略されている場合は、末尾に<EB><CR>だけを付与します。 その後、メッセージを外部アプリケーションに送信します。

メッセージダンプ機能

MLLPハンドラは、メッセージダンプ機能を持っています。この機能を有効にすることで、HL7 BCが外部アプリケーションに送受信したメッセージがログファイルに出力されます。 メッセージダンプ機能の利用方法については、[ リファレンス集 運用管理・設定・構成編 > コンフィグレーション > ドメインに関する設定 > システム環境変数 ] を参照してください。