Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

Health Connect拡張機能

ヒント：このページでは、2026年1月28日からリリースを予定している機能について説明しています。クアルトリクスは、自らの裁量により責任を負うことなく、あらゆる製品機能のロールアウトのタイミングの変更、プレビュー段階または開発段階の製品機能の変更、何らかの理由により、または理由なく製品の機能をリリースしないことを選択する場合があります。

HEALTH Connectについて

HEALTH CONNECTを使用すると、電子カルテ（EMR）システムの患者情報をクアルトリクスXM Directoryと同期させることができます。患者情報と管理情報をディレクトリで常に最新の状態に保つことで、アンケート調査結果、ダッシュボード、総合的なエクスペリエンスプログラムに最も重要な情報を確実に含めることができます。Health Connectは、臨床データおよび管理データの伝送にHL7（Health Level Seven）メッセージング標準を使用しています。

注意 HEALTH CONNECTは、クアルトリクス実装チームまたはサードパーティの実装パートナーによる実装が必要です。まずは、営業担当までお問い合わせください。

ご注意 HEALTH CONNECTにはRhapsodyとの統合が必要です。

ヒント:既存のHealth Connectの実装について質問がある場合は、テクニカルサクセスマネージャーにお問い合わせください。

Health Connectがライセンスに追加されると、Health Connect接続を編集または作成するには、ブランド管理者のユーザータイプが必要になります。

Rhapsodyとの統合に必要な情報

クアルトリクス導入スペシャリストが、HEALTH CONNECTとRhapsodyの統合をお手伝いします。Rhapsodyには以下の情報が必要です：

エンドポイント： テスト用と本番用の両方のディレクトリ用のHEALTH CONNECTエンドポイント（「新しい接続とエンドポイントの作成」を参照）。
OAuthトークン： 接続を作成したクアルトリクスユーザーアカウントのOAuthトークン（APIトークンの生成参照）
接続タイプ：EMRとRhapsodyの接続に使用するセキュアな接続のタイプ。担当のインプリメンテーション・スペシャリストが、可能な接続タイプに関する詳細情報を提供します。
HL7 イベントタイプ：使用予定のすべてのイベントタイプ。Health Connectは2つのHL7イベントフィードをサポートしています：ADTとSIUです。これらのフィードの中には、サポートされているイベントタイプがいくつかあります。

ADT（入退院、転院）イベント

ADTイベントタイプは、患者の人口統計、保険、管理状態、または物理的な場所（ベッド／部屋）のChangeなど、ヘルスケア施設における患者の管理Lifecycleを追跡する。ADTメッセージは、重要な患者情報が病院の記録管理システム全体で一貫していることを保証する上で重要である。

ADTメッセージに表示されるデータ細分化には、患者識別（PID）、来院情報（PV1）、近親者（NK1）、診断（DG1）、保険（IN1）などがある。

以下のADTイベントタイプのみをサポートしています：

ADT^A01：患者の入院/通院
ADT^A02: 患者移送
ADT^A03：患者の退院
ADT^A04: 患者登録 (外来)
ADT^A08: 患者情報の更新

SIU（スケジュール情報未承諾）イベント

SIUイベントは、患者の予約の作成、変更、キャンセル、またはリソース（手術室や機器のような）の予約について詳述する。SIUのメッセージは、すべてのスケジューリングシステムとカレンダーが一致し、最新の情報を持つようにするために重要です。

例SIUイベントは、フォローアップ予約、放射線検査の時間変更、理学療法のキャンセル中に作成される。

SIUメッセージに表示されるデータ細分化には、患者識別（PID）、スケジュールアクティビティ情報（SCH）、予約リソースグループ（RGS、AIG、AIL、AIP）などがあります。

以下のSIUイベントタイプにのみ対応しています：

SIU^S12: 新規予約のお知らせ
SIU^S14：任命変更の通知

XM DIRECTORY セットアップ

HEALTH CONNECTで作成するすべてのEMR接続で、テスト環境と本番環境を区別できます。それぞれ1つのディレクトリを作成することで、より簡単に設定をテストし、最も完全なフィールド設定のみをクアルトリクスプログラムにプッシュすることができます。

ヒント：ディレクトリを作成し、その設定を管理するには、正しいアカウント権限を持っていることを確認してください。

ディレクトリ作成: テストデータ用に1つのディレクトリを作成し、本番用に2つ目のディレクトリを作成する。
役割の創造: 各ディレクトリにAdminアクセスを可能にするロールがあることを確認してください。両方の役割に自分を加える。
IDの解決:2つのディレクトリそれぞれについて、外部データ参照に基づいて新しい重複コンタクトが自動的にマージされるようにします。

XM DIRECTORYがセットアップされると、Health Connectエクステンションのページから新しい接続を作成できます。

HEALTH CONNECTエクステンションのマネージャー

ヒント：組織内のすべてのブランド管理者は、Health Connectエクステンションにアクセスできます。

管理者へ
エクステンションに行く。

ヒント:拡張機能オプションを表示するには、[詳細]をクリックする必要があります。
検索し、Health Connectを選択します。
データマッピングへ。
新しい接続を開始するには、[New connection]をクリックします。
既存の接続の名前を編集したり、エンドポイントを表示したり、削除したりするには、接続の名前をクリックします。
ヒント:3つの点を選択して接続の編集を選択すると、接続の詳細を編集することもできます。
データ・マッピングを編集するには、［テスト］ または［本番］リンクを選択します。
ヒント：3つの点をクリックし、マッピングの編集を選択することでもデータマッピングを編集することができます。

新しいコネクションとエンドポイント

ヒント:通常、クアルトリクス導入スペシャリストが新しい接続を作成します。

接続先に名前をつける。
任意の説明を追加する。
テスト用ディレクトリを設定する。
プロダクション・ディレクトリを設定する。(これはライブ・プログラムで使用する予定のディレクトリです）。
Create connectionをクリックします。
本番用とテスト用の2つのエンドポイントが生成されます。
ページを閉じる準備ができたら、「完了」をクリックします。

ヒント：これらのエンドポイントに再度アクセスする必要がある場合は、接続名をクリックしてください。

接続名（ネストされたテストおよびプロダクションではありません）の横にある3つの点をクリックし、接続の編集を選択することもできます。

HEALTH CONNECTのデータマッピング

注意マッパーの一部の機能は、最初のHL7メッセージがクアルトリクスに送信されるまで使用できません。JSONプレビューにメッセージが表示されると、すべての機能が利用可能になります。

テスト環境と本番環境のエンドポイントは別々にマッピングされる。

テスト 環境または本番環境の横にある3つの点をクリックします。
マッピングの編集をクリックする。
ADTとSIUのフィードが表示されます。マッピングしたいフィードの横で、Edit mappingを選択します。
フィルタを使用して、表示するJSONメッセージのタイプを調整します。詳しくは以下のセクションを参照。
編集したいフィールドマッピングの種類を選択します：
- 必須フィールド］：ADT または SIU フィードが機能するために必要なフィールド。必須フィールドがない場合、メッセージは失敗し、EMRからの情報はクアルトリクスで更新されません。
- オプションフィールド］：必須ではないが、エクステンションにすでにマッピングされているフィールド（例：FIRST_NAME、VISIT_DATE）。
- 派生フィールド］：拡張機能によって自動的に計算されるフィールド (例：AGE、LENGTH_OF_STAY)。
- カスタムフィールド］：必須フィールド、オプションフィールド、派生フィールドではカバーされない特定のデータをマッピングするために作成する新しいフィールド。
それぞれの細分化はヘッダーで表される。細分化された各フィールドが表示されます。
ヒント：細分化については、HL7 のドキュメントを参照してください。
各フィールドには、次のように表示される：
- クアルトリクスフィールド名: XM DIRECTORY および接続されているアンケートやダッシュボードでのフィールド名です。
- JSONパス式またはカスタム値：JSONを使用してフィールドの値を定義するか、カスタム値を入力して定義することができます。
  - JSONパス式：JSONメッセージから情報を取得する場所を定義します。必ず$で始まること。
  - カスタム値：ハードコードされた/静的な値。
- 値：サンプルデータを取り込むと、この列は選択したサンプルイベントに対して取り込まれた値を表示します。
  例FIRST_NAME］フィールドを見ている場合、値は “Maria “かもしれない。
  
  ヒント:派生フィールドの値はクアルトリクスによって自動的に計算されるため、編集することはできません。
カスタムフィールド］タブでは、一番下にある［カスタムフィールドを追加］をクリックして、まったく新しいフィールドを追加することができます。

ヒント:クアルトリクスで表示される新しいフィールド名と、そのフィールドが値を取得するJSONパス、またはハードコードされた値を設定します。そこから変形を加えることもできる。
すべてのマッピングが完了したら、Saveをクリックします。
イベントタイプをプログラム内でライブにし、XM DIRECTORYにデータをアップロードするには、それがActivatedであることも確認してください。

ヒント：入力したJSONパスが正しい値を表示しているかどうかをテストする方法があります。フィールドの横にある3つの点をクリックし、［フィールドの編集］を選択します。

サンプルのJSONデータを使用して、この新しいウィンドウは、入力した式に基づいて引き出された値を表示します。

データ変換

データの変換とは、クアルトリクスに保存する際に、より読みやすく使いやすい形式になるようにデータを再フォーマットまたは再コード化することです。

例例：診断コードと診断テキストを1つのフィールドにまとめる。

例一貫性を保つため、すべての人名と Locations 名をタイトルケースに変更する。

変換の種類と例

変換	説明	例
配列を抽出（位置）	数値位置 (インデックス) を使用して、配列から要素を取り出します。配列データから特定の要素を取り出したい場合に便利。	[“apple”, “banana”, “cherry”] 配列の抽出 (position = 2) は “cherry” となる。
配列を抽出（プロパティ）	選択されたプロパティが指定された値と等しいオブジェクトに現在の配列をフィルタリングする。一致する要素がない場合は “null “となる。	[{“FIRSTNAME”：”Alice”, “LastName：「Smith”}, {“firstName”：”Bob”, “LastName”：”Hopkins”}、{“firstName”: “Carol”、”lastName”: “Smith”}：”Carol”, “LastName”：”Jones”}] &nbsp ;配列（”firstName” = “Carol”）の抽出は[{“firstName”: “Carol”, “lastName”: “Jones”}]となる。
値の連結	複数の文字列値を、区切り文字（スペースやカンマなど）を挟んで端から端まで結合する。フルネーム、住所の作成、データフィールドの結合に使用。	もし値が”John”, “Doe” これらは “John Doe “に連結される。
語の先頭のみ大文字	文字列を、各単語の最初の文字を大文字に、残りを小文字に変換する。名前、タイトル、ラベルの標準化に役立つ。	“the quick BROWN fox “は “The Quick Brown Fox “となる。

トランスフォームの追加

変形させたいフィールドの横で、3つの点をクリックし、次に［フィールドを編集］をクリックする。
Add Transformationをクリックする。
利用可能な変換タイプから選択し、以下のように設定する：
- 配列（位置）を取り出す：0から始まる、取り出したい配列の位置を入力する。必要であれば、特定のプロパティを抽出することもできます。
- 配列（プロパティ）を取り出す：取り出したいプロパティを正確に選択し、ターゲットにしたい特定の値と等しくなるように設定します。必要であれば、特定のプロパティを抽出することもできます。
- 値を連結する：一般的には、プロパティ→静的テキスト→プロパティの順になります。プロパティは、引き出したい配列の中の特定の値であり、”static text “は、これらを区切りたい区切り文字を指す。区切り文字の代わりにスペースを使うには、「静的テキスト」を完全に除外すればよい。
- タイトルの場合：余分な手順は必要ありません。
右のサンプルデータを使用して、ご希望の結果が得られていることをご確認ください。
変更が終わったら、Saveをクリックします。

既存の変換を表示する

フィールドにトランスフォームが適用されている場合、フィールドのすぐ下にトランスフォームのタイプ別に要約されます。

また、［フィールドの編集］ウィンドウで、既存のトランスフォームを表示および編集することもできます。

JSONメッセージサンプルの表示

Rhapsodyを使用してEMRがクアルトリクスに接続されると、EMRシステムからのメッセージがJSON形式で画面の右側に表示されます。

イベントタイプフィルターとアドバンスフィルターは、見たい特定のメッセージを絞り込むために使用することができます。

イベントタイプ：イベントタイプのいずれかを選択すると、右側に生のJSONコンテンツが表示されます。
高度なフィルター：EMRからクアルトリクスに送信された過去のメッセージを、含まれる情報に基づいて検索する高度なフィルターを構築できます。クアルトリクスフィールドまたはJSONパス式でフィルタします。

上部にある［前へ］ボタンと［次へ］ボタンを使って、最近受信したメッセージをナビゲートします。

ヒント：サンプルにカーソルを合わせてアイコンをクリックすると、JSONメッセージの本文をコピーできます。

JSONパス式の例

下の表は、高度なフィルターで使用できるJSONパス式の例です。

フィールド	JSONパス	ユースケース
message_control_id	$.content.MSH.10_messageControlId	これは特定の HL7 メッセージの一意の ID である。
VISIT_ID	$.content.PATIENT[0].PV1[0].19_visitNumber.19_1_id	コンタクト・シリアル・ナンバー（CSN）とも呼ばれる。
ユニットID	$.content.PV1[0].3_assignedPatientLocation.3_1_pointOfCare	これは部門IDとも呼ばれる。