HL7解析

7 分読む 最終更新日 2023年08月08日

HL7解析

HL7（Health Level 7）は、ヘルスケア市場全体のコミュニケーションのスタンダードです。 HL7解析 を使用すると、Dispatcher Phoenixのお客様は、HL7メッセージを解析して、Dispatcher Phoenix内で使用するためのドキュメントメタデータに変換し、HL7メッセージ内に埋め込まれたドキュメントを抽出することができます。HL7メッセージの詳細については、HL7の概要 を参照するか、https://hl7-definition.caristix.com/v2/HL7v2.8/Segments/を参照してください。

重要! HL7解析 ノードは、 HL7 v2.8 メッセージを最適に解析するように構成されていますが、 HL7 v2.x メッセージも解析することができます。古いバージョンのHL7 v2.xを解析する場合、解析されたデータが期待どおりに表示されない場合があります。これには、わずかに異なるセグメント名で解析されたデータ、個別、または結合されたサブセグメントで解析されたデータなどが含まれます。HL7 v2.xの古いバージョンの解析の詳細については、Dispatcher Phoenix エンジニアリングサービスにご確認ください。

HL7解析の構成

HL7解析 ノードのプロパティウィンドウを開くには、 HL7解析 処理ノードをワークフローに追加してダブルクリックします。

HL7解析

  • [有効] - 現在のワークフローでこのノードを有効にするには、 有効 チェックボックスがチェックされていることを確認してください。既定では、ノードは作成時に有効になります。ノードを無効にすると、ワークフローはノードを無視し、ノードが存在しないかのようにドキュメントが通過します。無効にされたノードは、ロジックまたはエラーの状態がチェックされないことに注意してください。

  • [ノード名] - ノード名は既定でこのフィールドに入力されます。この名前は、ワークフローのノードアイコンの下に表示されます。このフィールドを使用して、ワークフローでの使用を表すノードの意味のある名前を指定します。

  • [説明] - このノードのオプションの説明を入力します。説明は、ワークフロー内のノードの目的を思い出したり、ノードを互いに区別したりするのに役立ちます。説明が長い場合は、フィールドの上にマウスを置くと、その内容全体を読み取ることができます。

ボタン

  • [ヘルプ] - オンラインヘルプにアクセスするには、このボタンをクリックします。
  • [キャンセル] - 変更を保存せずにウィンドウを終了するには、このボタンをクリックします。
  • [保存] - ノード定義を保持してウィンドウを終了するには、このボタンをクリックします。

HL7メッセージのサンプル

HL7解析 ノードを使用すると、サンプルのHL7メッセージを入力して、組織で通常使用されるHL7メッセージセグメントを判別することができます。サンプルメッセージを解析するには、次の手順を実行します。

  1. コピーしたHL7メッセージをサンプルHL7メッセージフィールドに入力または貼り付けます。

  2. [貼り付け]ボタンを選択します。

  3. HL7解析ノードは、すべてのHL7メッセージセグメントとサブセグメントを分離し、それらを既定のフィールドと比較します。次の図のように、追加のフィールドは 追加フィールド 領域に自動的に入力されます。

    HL7解析

重要! セキュリティとコンプライアンスを維持するために、 サンプルHL7メッセージ セクションは、ノードが閉じられた後、その領域の情報を自動的に削除します。このセクションのこの情報は、 [保存] ボタンを選択しても保存されません。

注:

  • HL7解析 は、メッセージの先頭にMSHセグメントを含まないHL7メッセージは解析しません。

  • サンプルHL7メッセージ 解析を使用して 追加フィールド 領域にセグメントを追加する場合、ノードは常に定義済みのセグメントに追加されます。既存のエントリーは削除されません。

既定のフィールド

HL7解析 は、HL7メッセージの最も一般的に使用されるセグメントのいくつかの既定のフィールドを自動的に解析するように構成されています。これらは左下のボックスにリストされており、次のものが含まれます。

ID 患者情報の説明
PID.3 患者IDリスト
PID.5.1 名字
PID.5.2 名前
PID.5.3 セカンドネームまたはそのイニシャル
PID.5.4 サフィックス
PID.7 生年月日
PID.8 管理性別
PID.10 人種
PID.11.1 番地
PID.11.2 その他の呼称
PID.11.3 市区町村
PID.11.4 都道府県
PID.11.5 郵便番号
PID.11.6 国
PID.13 電話番号 - ホーム
PID.15 母国語
PID.17 宗教
PID.19 SSN - 患者
PID.22 民族グループ

追加のフィールド

HL7メッセージの追加フィールドは、上記の サンプルHL7メッセージ 解析機能を使用するか、 追加のフィールド というラベルの付いた右下のボックスに手動で入力することによってノード構成に追加することができます。追加フィールドは、ワークフローが検証に合格するために、スペースで区切るか、独自の行に入力できることに注意してください。スペースで区切られたセグメントは、ノードが保存された後、独自の行に配置されることに注意してください。

サブセグメントを持つセグメントの場合、ユーザーは、解析するサブセグメントを指定せずに、最上位のセグメントを入力することができます。この場合、生成されるメタデータには、各サブセグメントに含まれる すべて のデータが含まれます。たとえば、ユーザーは[追加のフィールド]領域に「ABS.1」と入力できます。「ABS.1」のメタデータには、「ABS.1.1」から「ABS.1.25」までで検出された値、「ABS.1.23.1」から「ABS.1.23.22」などの追加のサブセグメントが含まれます。

注:

  • HL7解析 は、解析されたデータに対してデータ検証を実行しません。たとえば、「PID.7」は患者の生年月日を参照します。HL7メッセージでは、2087年1月15日の誕生日は「19870115」と表記されています。メタデータを別の形式に変換する必要がある場合は、 メタデータスクリプト ノードなどをワークフローで使用できます。

  • HL7解析 がデータを持たないHL7セグメントからの情報を解析するように構成されている場合、ノードはnull値でメタデータを作成します。

重要! HL7セグメントは、 XXX.#.#. の形式 でなければなりません。XXX-#.# などの他の形式では、エラーが発生します。

HL7メッセージからのドキュメントの抽出

HL7解析 は、HL7メッセージから、埋め込まれたドキュメントを抽出することができます。これらのドキュメントは通常、OBX.5セグメントにあります。ノードは、OBX.5セグメントをメタデータに解析しませんが、代わりに、このセグメントに含まれる情報を取得し、その情報に基づいて、ワークフローの後半で使用することができるドキュメントを作成します。ドキュメントのタイプは、OBX.2およびOBX.5セグメントに含まれるデータによって決定されます。

注: HL7解析 はOBX.5セグメントをドキュメントに変換するため、メタデータには使用できません。OBX.5セグメントが 追加のフィールド 領域に追加された場合、ノードは検証に合格せず、ワークフローはエラーを生成し、実行されません。

HL7の概要

HL7は、異種の医療システム間で医療データを転送するための国際スタンダードです。HL7メッセージは、メッセージの個々の部分を区切る1文字の区切り文字で構成されます。

区切り文字:
0x0D 各セグメントの終わりをマークします
^ サブコンポジット区切り文字
& サブ-サブコンポジット区切り文字
- 繰り返しフィールドを区切ります
\ エスケープ文字

HL7メッセージのサンプル

以下は、HL7メッセージの例です。

MSH|^~&|Dispatcher|Facility1|MIRTH|HL7Reciever|201407271408|ADT^A04|1817459|D|2.8|123456||AL
PID|S1|S2||S4.1^S4.2^^S4.4|S5.1^S5.2^^^^^^^S5.9.1&S5.9.2&S5.9.3^S5.10

このメッセージでは、 HL7解析 は次の情報を抽出します。

  • PID.1は、「S1」のメタデータ値を生成します
  • PID.4は、「S4.1^S4.2^^S4.4」のメタデータ値を生成します
  • PID.4.2は、「S4.2」のメタデータ値を生成します
  • PID.5は、「S5.1^S5.2^^^^^^^S5.9.1&S5.9.2&S5.9.3^S5.10」のメタデータ値を生成します
  • PID.5.9は、「S5.9.1&S5.9.2&S5.9.3」のメタデータ値を生成します
  • PID.5.9.3は、「S5.9.3」のメタデータ値を生成します