HL7

HL7（Health Level Seven）は、電子医療情報の交換、統合、共有、および取得のための国際標準のセットです。 HL7メッセージはこの標準の主要なコンポーネントであり、医療アプリケーション間で情報を交換するための形式として機能します。これらのメッセージは、異なるシステムがデータを一貫して理解し解釈できるように構造化されています。 HL7メッセージは、患者の人口統計情報、検査結果、臨床観察、および管理データの送信など、さまざまな目的に使用できます。

HL7 Workatoコネクターでは、異なるバージョンのHL7メッセージを送受信でき、対応するOPA拡張機能が含まれています。

前提条件

HL7コネクターをインストールする前に、次の前提条件を満たす必要があります:

オンプレミスエージェント（OPA）を設定します。クラウドプロファイルまたはコネクションプロファイルのいずれかを使用できます。どちらのオプションでも、OPAがインストールされているマシン上のconfig.ymlファイルを手動で編集できる必要があります。
OPAバージョンが23.0未満の場合、Java SDKのバージョン17以降をインストールする必要があります。詳細については、オンプレミスエージェントのバージョンノートを参照してください。

インストール

HL7コネクターをインストールするには、次の手順を完了します:

ファイルシステム上でOPAディレクトリを見つけます。一般的な場所は次のとおりです:

オペレーティングシステム	場所
Unix系オペレーティングシステム	`/opt/workato`
Windows	`C:\Program Files\Workato Agent`
macOS	場所はさまざまです

23.0未満のOPAバージョンを使用している場合は、Java SDKのバージョン17以降がインストールされていることを確認します。デフォルトのJDKインストール場所は次のとおりです:

オペレーティングシステム	場所
Unix系オペレーティングシステム	`/usr/lib/java`
Ubuntu	`/usr/share/java/`
Windows	`C:\Program Files\Java\jdk-<release>`
macOS	ディストリビューションにより場所は異なります。例: `/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home`

HL7拡張機能をダウンロードします。

ファイルをダウンロードし、$OPAがOPAインストールディレクトリを指す$OPA/extにパッケージを展開します。詳細はこちら。

$OPA/conf/config.ymlにあるOPA設定ファイルに移動します。 HL7拡張機能を使用するには、次の手順に従って設定ファイルを更新する必要があります。この手順は、OPAがクラウドプロファイルまたはコネクションプロファイルのどちらを使用して設定されている場合にも適用されます。

yml

server:
  classpath: /opt/workato-opa/ext # Set the classpath to the path of the folder where the HL7 extension JAR files are located

extensions:
  # HL7-Profile including a listener to receive messages
  hl7: # Name of the connection profile to be used, when creating a connection
    controllerClass: com.workato.extension.hl7.ExtensionController
    localPort: 1011 # Listening port to receive messages
    webhookURL: https://webhooks.workato.com/users/... # The webhook URL to receive the HL7 message
    remotePort: 1011 # Port to send messages
    remoteHost: localhost # Hostname to send messages
    tls: false
    # Encoding used for sending and receiving messages. Possible values UTF-8, ISO-8859-1, UTF-16, ...
    # encoding: ISO-8859-1

# HL7-Profile WITHOUT a listener, which allows you to send messages only
  hl7_no_listener:
    controllerClass: com.workato.extension.hl7.ExtensionController
    remotePort: 1011
    remoteHost: localhost
    tls: false
    # Encoding used for sending and receiving messages. Possible values UTF-8, ISO-8859-1, UTF-16, ...
    # encoding: ISO-8859-1

コミュニティライブラリからコネクターをインストールしてリリースします。

コネクション設定

WorkatoでHL7コネクションを作成するには、次の手順を完了します:

Workatoの接続先であるHL7インスタンスを識別するコネクション名を指定します。 WorkatoでHL7に接続 HL7コネクション設定

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

HL7拡張機能が設定されているオンプレミスグループを選択するには、コネクションタイプドロップダウンメニューを使用します。

使用する予定のHL7処理IDを選択するには、処理モードドロップダウンメニューを使用します。オプションは次のとおりです: デバッグ、プロダクション、およびトレーニング。

プロファイル名を指定します。 HL7メッセージを受信するには、OPAプロファイルに実行中のHL7リスナーが必ず必要です。

接続をクリックします。

Last updated:

HL7 ​

前提条件 ​

インストール ​

コネクション設定 ​

HL7

前提条件

インストール

コネクション設定