EMPI に対する PIX クエリと PDQ クエリの実行

PIX クエリのメッセージ・トレース

以下の図に、アノテーション付きの PIX クエリのメッセージ・トレースを示します。

図に示されているテスト・サービスは、単純なメッセージ・ルータです。トレース操作は、中間処理の各段階を可視化するユーティリティです。図中の番号は、以下の手順の各段階に一致します。

PIX クエリの手順

1. MRN と割り当て機関が含まれる Patient Search RequestOpens in a new tab メッセージを InterSystems PIX Consumer 操作に提供します。

2. InterSystems PIX Consumer 操作は、TransformPatientSearchToPIX 設定で指定された変換を使用して、メッセージを IHE “PIXv3_QueryRequest” に変換します。

3. 続いて、InterSystems PIX Consumer 操作は、ServiceName 設定で指定されたサービスに PIX 要求を転送します。この設定は通常は PIXv3.Manager で、別のシステム内にある PIX Manager アクターのエンドポイントの場所を指すサービス・レジストリ・エントリを参照します。

4. 他のシステム上にある PIX Manager は、一致がある場合、単一の患者の名前と MPI ID が含まれる PIX 応答メッセージを返します。

5. InterSystems PIX Consumer 操作は、TransformPIXToPatientSearch で指定された変換を使用して、応答を Patient Search ResponseOpens in a new tab メッセージに変換します。

6. InterSystems PIX Consumer は、患者が見つかった場合、その患者の名前と MPI ID が含まれる Patient Search ResponseOpens in a new tab メッセージを返します。患者が見つからない場合、応答メッセージはゼロの <ResultsCount> を示します。エラーが発生した場合、PIX Consumer は null を返します。

PIX クエリのコンポーネントと設定

PIX クエリの例

以下のメソッドは PIX クエリを生成します。

 ClassMethod PIXQuery()
  {
     /// Create Patient Search Request message 
     Set obj=##class(HS.Message.PatientSearchRequest).%New()

     //Provide the Patient MRN
     Set obj.AssigningAuthority="EXTERNAL" //refers to an Assigning Authority entry in the OID Registry
     Set obj.MRN="1111222"

     // Send to the routing service (or directly to HS.IHE.PIXv3.Consumer.Operations)
     Do ##class(HS.Test.Service).SendSync(obj,.pr)

     quit
  }

PDQ クエリのメッセージ・トレース

以下の図に、アノテーション付きの PDQ クエリのメッセージ・トレースを示します。

図に示されているテスト・サービスは、単純なメッセージ・ルータです。トレース操作は、トレース内の中間処理の各段階を可視化するユーティリティです。図中の番号は、以下の手順の各段階に一致します。

PDQ クエリの手順

1. 部分的な基本情報が含まれる Patient Search RequestOpens in a new tab メッセージを InterSystems PDQ Consumer に提供します。

2. InterSystems PDQ Consumer は、TransformPatientSearchToPDQ 設定で指定された変換を使用して、メッセージを IHE “PDQv3_QueryRequest” に変換します。

3. その後、InterSystems PDQ Consumer は、ServiceName 設定で指定された別のシステム上にある PDQ Supplier エンドポイントに PDQ 要求を転送します。

4. 他のシステム上にある PDQ Supplier は、提供された部分的な基本情報に一致するすべての患者の完全な基本情報が含まれる PDQ 応答メッセージを返します。

5. InterSystems PDQ Consumer は、TransformPDQToPatientSearch で指定された変換を使用して、応答を Patient Search ResponseOpens in a new tab メッセージに変換します。

6. InterSystems PDQ Consumer は、一致する患者の完全な基本情報と MPI ID が含まれる Patient Search ResponseOpens in a new tab メッセージを返します。患者が見つからない場合、応答メッセージはゼロの <ResultsCount> を示します。エラーが発生した場合、PDQ Consumer は null を返します。

PDQ クエリのコンポーネントと設定

PDQ クエリの例

以下のメソッドは PDQ クエリを生成します。

 ClassMethod PDQQuery()
  {
     // Create Patient Search Request message 
     Set obj=##class(HS.Message.PatientSearchRequest).%New()
 
     // Provide patient demographics
     Set obj.FirstName="James"
     Set obj.LastName="Smith"
 
     // Required only for HS.Test.Service to distinguish between PIX/PDQ
     Do obj.AdditionalInfo.SetAt(1,"PDQ")
 
     // Send to the routing service (or directly to HS.IHE.PDQv3.Consumer.Operations)
     Do ##class(HS.Test.Service).SendSync(obj,.sr)
 
     quit
  }