SDA-FHIR 変換

ビジネス・プロセスの追加

最初に、管理ポータルの [プロダクション構成] ウィンドウでプロダクションを開き、HS.FHIR.DTL.Util.HC.SDA3.FHIR.Process ビジネス・プロセスを追加します。追加したら、変換に影響を与えるビジネス・プロセスの設定を変更できます。ビジネス・プロセスの相互運用プロダクションへの追加方法の概要は、"機能紹介 ： 相互運用プロダクションを使用したシステムの接続" を参照してください。

ビジネス・プロセスの設定

SDA から FHIR への変換に影響を与える HS.FHIR.DTL.Util.HC.SDA3.FHIR.Process の設定には、以下があります。

• TargetConfigName — HS.FHIR.DTL.Util.HC.SDA3.FHIR.ProcessOpens in a new tab が出力を送信するビジネス・ホストを指定します。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [基本設定] セクションにあります。

• TransmissionMode — このビジネス・プロセスが追加処理のために FHIR バンドルを送信する方法を指定します。

  • transaction — このビジネス・プロセスは、リソースのバンドルを単一の相互作用で送信し、処理はバンドル全体を対象として成功または失敗します。1 つのリソースの処理に失敗した場合、その他のリソース (およびバンドル全体) の処理が停止します。これが既定値です。

  • individual — このビジネス・プロセスは、バンドルからの各リソースを専用の相互作用として個別に送信します。

  この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• FullTransactionResponse — 選択した場合、このプロセスが送信する FHIR 要求メッセージは、"PREFER" ヘッダの値が "return=representation" に設定されて作成されます。FHIR 仕様に基づき、このヘッダは、FHIR サーバに対して、作成または更新された各リソースを、保存されているまますべて (すなわち、サーバにより適用されたすべての変更を含む) 返す必要があることを示します。サーバが実際にこれを行うかどうかはサーバによります。一般に、この情報を要求すると FHIR サーバからの応答時間が増大する傾向があるため、この設定は、デバッグ中、または FHIR クライアントに作成/更新したリソースを受信するという特定のニーズがある場合を除き、チェックを付けないままにする必要があります。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• FHIRFormat — コンテンツが XML 形式と JSON 形式のどちらであるかを指定します。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• FormatFHIROutput — コンテンツを読みやすい形式にするかどうかを指定します。この設定を選択すると、パフォーマンスが影響を受けます。そのため、開発時およびテスト時にのみ有効にしてください。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• CallbackClass — 非推奨。

• ValidResourceRequired — 非推奨。

• OutputToQuickStream — 選択した場合、このビジネス・プロセスにより送信された FHIR ペイロードは HS.SDA3.QuickStream オブジェクトに配置され、QuickStream オブジェクトの ID は要求メッセージの QuickStreamId プロパティに配置されます。選択しないままにすると、変換からの FHIR 出力は、要求メッセージの Payload プロパティに配置されます。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• TransformClass — 変換を実行するクラスの名前を指定します。HS.FHIR.DTL.Util.API.Transform.SDA3ToFHIR のサブクラスを作成して変換動作をカスタマイズする場合は、そのサブクラスの名前を指定する必要があります。

• FHIRMetadataSet — パッケージに基づいて送信 FHIR のバージョンを指定します。使用可能なすべてのパッケージがドロップダウン・リストに表示されます。

• FHIREndpoint — FHIR サーバのエンドポイントを指定します。この設定は、ビジネス・プロセスが送信 FHIR を HS.FHIRServer.Interop.Operation ビジネス・オペレーションを経由して FHIR サーバのサービスに送信する場合に必要です。

患者 ID の割り当て

HS.FHIR.DTL.Util.HC.SDA3.FHIR.Process に送信される SDA メッセージの AdditionalInfo プロパティを使用して、SDA-FHIR 変換で作成された Patient リソースに ID を割り当てることができます。SDA メッセージに PatientResourceId という AdditionalInfo 項目が含まれる場合、変換で PatientResourceId の値が取得され、生成された Patient リソースの ID フィールドに割り当てられます。

メッセージ

HS.FHIR.DTL.Util.HC.SDA3.FHIR.Process への要求メッセージは、Ens.Container または HS.Message.XMLMessage です。

HS.FHIR.DTL.Util.HC.SDA3.FHIR.Process からの応答メッセージはありません。代わりに、成功または失敗のステータスを返します。

ビジネス・プロセスの追加

最初に、管理ポータルの [プロダクション構成] ウィンドウでプロダクションを開き、HS.FHIR.DTL.Util.HC.FHIR.SDA3.Process ビジネス・プロセスを追加します。追加したら、変換に影響を与えるビジネス・プロセスの設定を変更できます。ビジネス・プロセスの相互運用プロダクションへの追加方法の概要は、"機能紹介 ： 相互運用プロダクションを使用したシステムの接続" を参照してください。

ビジネス・プロセスの設定

FHIR から SDA への変換に影響を与える HS.FHIR.DTL.Util.HC.FHIR.SDA3.Process の設定には、以下があります。

• TargetConfigName — DTL 変換により FHIR から変換された後、SDA3 ストリームを含む XMLMessage が送信されるビジネス・ホストを指定します。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [基本の設定] セクションにあります。

• CallbackClass — 非推奨。

• OutputToQuickStream — 既定で、HS.FHIR.DTL.Util.HC.FHIR.SDA3.Process の出力は、DTL 変換により生成される SDA3 ストリームを含む HS.Message.XMLMessage オブジェクトです。この設定にチェックが付いている場合、SDA3 ストリームは個別の HS.SDA3.QuickStream オブジェクトに配置され、QuickStream オブジェクトの QuickStreamID は XMLMessage の AdditionalInfoItem プロパティに配置されます。この設定が選択されていない場合、SDA3 ストリームは XMLMessage の ContentStream プロパティに配置されます。この設定は、[プロダクション構成] ウィンドウの [設定] タブの [追加設定] セクションにあります。

• TransformClass — 変換を実行するクラスの名前を指定します。HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3 のサブクラスを作成して変換動作をカスタマイズする場合は、そのサブクラスの名前を指定する必要があります。

• FHIRMetadataSet — パッケージに基づいて受信 FHIR のバージョンを指定します。使用可能なすべてのパッケージがドロップダウン・リストに表示されます。

TransformStream メソッドの使用法

HS.FHIR.DTL.Util.API.Transform.SDA3ToFHIR の TransformStream メソッドは、%Stream として SDA を取得し、それを FHIR バンドルに変換します。そのシグニチャは、以下のとおりです。

TransformStream(stream As %Stream.Object, SDAClassname As %String,
    fhirVersion As %String, patientId As %String = "",
    encounterId As %String = "")

パラメータ ：

• stream — SDA オブジェクトまたはコンテナの %Stream 表現。

• SDAClassname — ストリームに含まれるオブジェクトのクラス名 (HS.SDA3.Container など)。

• fhirVersion — 変換によって生成される FHIR のバージョン。STU3 や R4 など。

• patientId — このオプションのパラメータを指定した場合、生成された Patient リソースの Id フィールドに指定された値が入ります。

• encounterId — このオプションのパラメータを指定した場合、生成された Encounter リソースの Id フィールドに指定された値が入ります。stream パラメータが SDA コンテナである場合、このパラメータは無視されます。これは、コンテナには、複数の Encounter を含めることができるので、どの FHIR Encounter に指定のリソース ID を付与するのか判断できないためです。

TransformObject メソッドの使用法

HS.FHIR.DTL.Util.API.Transform.SDA3ToFHIR の TransformObject メソッドは、コンテナやオブジェクト・クラスとして SDA を取得し、それを FHIR バンドルに変換します。そのシグニチャは、以下のとおりです。

TransformObject(source, fhirVersion As %String, patientId As %String = "", encounterId As %String = "")

パラメータ ：

• source — FHIR に変換される SDA コンテナまたは SDA オブジェクト・クラス。

• fhirVersion — 変換によって生成される FHIR のバージョン。STU3 や R4 など。

• patientId — このオプションのパラメータを指定した場合、生成された Patient リソースの Id フィールドに指定された値が入ります。

• encounterId — このオプションのパラメータを指定した場合、生成された Encounter リソースの Id フィールドに指定された値が入ります。stream パラメータが SDA コンテナである場合、このパラメータは無視されます。これは、コンテナには、複数の Encounter を含めることができるので、どの FHIR Encounter に指定の ID を付与するのか判断できないためです。

変換の詳細

以下に SDA から FHIR への変換の既定の動作を説明します。オーバーライドして変換動作をカスタマイズできるメソッドの概要は、"オーバーライド可能な SDA から FHIR への変換メソッド" を参照してください。

• 受信ストリームまたはオブジェクトは個々のストリームレットに分割され、それらが STU3 リソースに変換されます。

• 既定では、UUID が生成され、Bundle リソースの fullUrl フィールドに割り当てられます。この場合、リソース自体には Id はありません。リソース ID を提供する場合は、GetId メソッドをオーバーライドします。この場合、fullUrl の値は baseURL/resourceType/id で、リソース参照は resourceType/id になります。

• これらのメソッドは、既定では受信 URL を一切変更しません。この動作を GetBaseURL メソッドでオーバーライドできます。例えば、特定のリポジトリにポストする場合、そのリポジトリの URL 接頭語を指定できます。

• ID を割り当てるために使用されたメカニズムに関係なく、リソースには他のリソースへの参照が含まれます。

• Patient および Encounter のストリームレットを使用して、利用可能なすべてのリソースに Patient および Encounter の参照が追加されます。Encounter の参照は、SDA ストリームレットの EncounterNumber フィールドが使用されている場合にのみ、正常に作成できます。これらが空の場合、参照は生成されません。

• Organization、Practitioner、Medication などの共有リソースの場合、各リソースの先頭 32 キロバイトのハッシュがハッシュ・テーブルに追加されます。それ以降の各共有リソースは、直接一致するものをハッシュ・テーブルで検索することで、重複がないかどうかが確認されます。一致が見つかった場合、リソースは重複としてマークされます。この動作は、IsDuplicate メソッドをオーバーライドすることにより変更できます。

• 各リソースは、バンドルに追加される前に検証されます。リソースが検証に失敗すると、エラーがスローされ、処理が停止します。つまり、バンドルは返されません。この既定の動作は、HandleInvalidResource メソッドをオーバーライドすることにより変更できます。

• 1 つ以上の SDA プロパティがターゲット・スキーマの FHIR リソース・フィールドにマップされない場合は、変換により、SDA データが FHIR 拡張にマップされます。詳細は、"FHIR 拡張" を参照してください。

• 特定の SDA オブジェクトやプロパティがターゲットの FHIR リソースやフィールドにマップされる方法の詳細は、"SDA-FHIR マッピングの理解" を参照してください。

TransformStream メソッドの使用法

HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3 の TransformStream メソッドは、%Stream として表現される FHIR リソースやバンドルを取得し、それを SDA コンテナに変換します。FHIR バンドルがメソッドに渡される場合にのみ、リソース参照は処理されます。そのシグニチャは、以下のとおりです。

TransformStream(stream As %Stream.Object, fhirVersion As %String, fhirFormat As %String)

パラメータ ：

• stream — FHIR リソースまたはバンドルの %Stream 表現。

• fhirVersion — 変換される FHIR リソースまたはバンドルのバージョン。"STU3" や "R4" など。

• fhirFormat — FHIR リソースまたはバンドルの形式を指定します。許容値は "JSON" と "XML" です。

TransformObject メソッドの使用法

HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3 の TransformObject メソッドは、ダイナミック・オブジェクトとして FHIR リソースやバンドルを取得し、それを SDA コンテナに変換します。バンドルがメソッドに渡される場合にのみ、リソース参照は処理されます。そのシグニチャは、以下のとおりです。

TransformObject(source As %DynamicObject, fhirVersion As %String)

パラメータ ：

• source — ダイナミック・オブジェクトとして表現される FHIR リソースまたはバンドル。

• fhirVersion — 変換される FHIR リソースまたはバンドルのバージョン。"STU3" や "R4" など。

Transform メソッドの使用法

HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3 の Transform メソッドは、ダイナミック・オブジェクトとして FHIR バンドルを取得し、それを SDA コンテナに変換します。バンドルがメソッドに渡される場合にのみ、リソース参照は処理されます。

Transform は、FHIR を SDA に変換するクラス・メソッドによって呼び出されるメソッドです。連続して複数の FHIR リソースを変換する場合に直接呼び出すことができるので、HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3 オブジェクトを毎回インスタンス化する必要はありません。例えば、以下のコードでは、同一の変換オブジェクトを使用して、Patient リソース、Encounter リソース、および Observation リソースを変換します。

set r4schema = ##class(HS.FHIRServer.Schema).LoadSchema("R4")
set transformer = ##class(HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3).%New(r4Schema)
do transformer.Transform(patient)
do transformer.Transform(encounter)
do transformer.Transform(Observation)

Transform メソッドのシグニチャは次のとおりです。

Transform(source As %DynamicObject)

パラメータ ：

• source — ダイナミック・オブジェクトとして表現される FHIR リソースまたはバンドル。

変換の詳細

以下に、FHIR から SDA への変換の既定の動作の概要を示します。オーバーライドして変換動作をカスタマイズできるメソッドの概要は、"オーバーライド可能な FHIR から SDA への変換メソッド" を参照してください。

• 受信 FHIR バンドルは個々のリソースに分割され、それらが SDA3 ストリームレットに変換されます。

• 受信 FHIR バンドル内で別のリソースによって参照されているリソースがバンドルに存在しない場合、バンドルの変換は続行されます。この動作を変更するには、HandleMissingResource メソッドをオーバーライドします。

• 参照をオブジェクトに変換しようとしても、以下の場合には、SDA ストリームレットにオブジェクトは作成されません。

  • サブ変換が存在するが、マッピングがあるどの要素についても、参照されているリソースに値がない。

  • 参照されているリソース・タイプから SDA3 オブジェクトのデータ型へのサブ変換がない。

• Encounter ストリームレットの EncounterNumber フィールドは 1 から入力され、Encounter が処理されるたびに増やされます。Encounter リソースを参照する以降のリソースは、SDA3 への変換時に、リソース ID に基づいてルックアップを実行し、使用すべき Encounter 番号を特定します。Encounter 番号の割り当ては、GetIdentifier メソッドでオーバーライドできます。変換されるリソースのコンテンツにアクセスすると、返すべき EncounterNumber の決定に役立ちます。インスタンス・プロパティ %currentReference には、ダイナミック・オブジェクトとしてリソースを取得するために、インスタンス・メソッド GetResourceFromReference に渡すことができる FHIR 参照オブジェクトが含まれています。

• Encounter 番号と同じように、HealthConcern リソースと Goal リソースの ExternalID の値も、既定では 1 から入力されます。この動作は、GetIdentifier メソッドでオーバーライドできます。

• SDA Container:SendingFacility プロパティの値は次のように設定されます。Patient の managingOrganization フィールドに Organization への参照が含まれており、その Organization が Bundle に存在する場合は、それが使用されます。そうでない場合は、患者識別子で MRN と割り当て機関が検索され、その割り当て機関が使用されます。いずれの項目も見つからない場合は、文字列 FHIR が使用されます。この動作は、GetSendingFacility メソッドでオーバーライドできます。

• SDA3 拡張は使用されません。SDA3 にフィールドが存在しない場合、その内容は削除されます。

• Patient リソースなしでバンドルを受信した場合、エラーがスローされます。それ以外には、コンテナに対して検証は実行されません。単に、受信したままの状態で返されます。

• 包含関係に関する情報を確認するには、Bundle リソースの管理ポータルで FHIR アノテーション ([Health] → [FHIR アノテーション]) を参照します。

• 特定の FHIR リソースまたはフィールドが SDA オブジェクトやプロパティにマップされる方法の詳細は、"SDA-FHIR マッピングの理解" を参照してください。

フィールド間マッピング

ほとんどのマッピングはフィールド間のマッピングです。マッピングによってソース・フィールドでデータ値を見つけ、その値をターゲット・フィールドに割り当てます。例えば、SDA プロパティの値は FHIR フィールドに割り当てられます。

条件付きマッピング

一部のフィールド間マッピングは条件付きです。特定の条件が満たされた場合にのみ、値がターゲット・フィールドに割り当てられます。この情報を提示する場合、FHIR アノテーション・ツールに [このフィールドの設定条件] というラベルが表示されます。DTL の <if> 要素により、これをコード内で制御します。

リテラル値

定義済みマッピングの中には、リテラル値からターゲット・フィールドへのマッピングがあります。これらのマッピングの目的の 1 つは、ターゲットで必要なデータを提供できるフィールドがソース・オブジェクト定義に含まれない場合に、必要なターゲット・フィールドの値を提供することです。

多くの場合、このタイプのマッピングは条件付きで定義され、必要時にのみ使用されます。

除外されるフィールド

臨床的な意義がないメタデータを含む SDA フィールドは、FHIR フィールドにマップされません。例えば、UpdatedOn プロパティは FHIR に変換されません。

また、クラス・リファレンス内で使用されていませんとマークされている SDA フィールドは、FHIR に変換されません。例えば、LabResultItem の ExternalId プロパティは、Observation リソースのフィールドにマップされません。

単一値からリストへのマッピング

ソース・フィールドが単一値であるのにターゲット・フィールドがリストの場合、ソース項目は、変換により、ターゲット・リストの最初のエントリにマップされます。変換後、リストには 1 つのエントリのみが含まれます。 この機能は、変換用コードの生成中に自動的に処理されます。単一値からリストへの場合、マッピング定義に特別な注意は必要ありません。

リストから単一値へのマッピング (値)

ソース・フィールドが値のリストで、ターゲット・フィールドが単一値に制限されている場合、変換により、値のリストは、リストの各値をセミコロンとスペースで区切った 1 つの値に連結されます。

リストから単一値へのマッピング (オブジェクト)

SDA から FHIR の場合 ： 受信 SDA がオブジェクトのリストで、ターゲット FHIR のオブジェクトが 1 つのみである場合、マッピング・テーブルには、ソース・リスト・フィールドに対するマッピング・エントリが 2 つ含まれます。

• 一方のマッピングは、ソース・リスト・フィールドをターゲットの単一値フィールドにマップします。このマッピングから生成される変換は、単に最初のリスト・エントリをターゲット・フィールドに配置します。

• もう一方のマッピングでは、オブジェクトの完全リストを格納するターゲット FHIR 拡張にソース・リスト・フィールドをマップします。FHIR 拡張の URL は完全なソース・フィールド名です。これはリソース名を含みますが、ハイフンで区切ったすべて小文字のテキストを使用します。

FHIR から SDA の場合 ： 受信 FHIR にオブジェクトのリストがあり、SDA のオブジェクトが 1 つである場合、変換では最初のオブジェクトが使用され、他はすべて削除されます。

SDA CodeTableDetail の FHIR コードへのマッピング

変換により、SDA CodeTableDetail (またはそのサブクラスの 1 つ) は、以下のように Coding や CodeableConcept などの FHIR コード化オブジェクトにマップされます。

1. Code 値は code フィールドに割り当てられます。

2. Description は display フィールドに割り当てられます。

3. OriginalText フィールドが存在する場合は、text フィールドにマップされます。

ルックアップ・テーブルを使用したコード値の FHIR へのマッピング

マッピングは、ルックアップ・テーブルを参照して、このマッピングにおいてソース・スキーマ (SDA または FHIR) のコード値をターゲット・スキーマ (FHIR または FHIR DSTU2) のコード値にマップするエントリを見つけます。

マッピングでルックアップ・テーブルが見つからない場合、またはルックアップ・テーブルに一致エントリが見つからず、空以外の既定値が定義されている場合、既定値がコード・フィールドに適用されます。それ以外の場合、ターゲットはこのマッピングから値を受け取りません。

マッピングが SDA から FHIR で、ソース・フィールドに空以外の値が含まれる場合は、規約により、このソース・フィールドに対してマッピング・エントリが 2 つ存在します。両方のエントリは、同じ [このフィールドの設定条件] に従って実行されます。

• 一方のエントリは、ルックアップを実行して、ターゲット・フィールドに割り当てる値を取得します。

• もう一方は、元のソース・フィールドの値を文字列値の FHIR 拡張に格納します。

どちらの場合も、Description または OriginalText が Code 値と共に存在する場合、可能であれば FHIR にマップされます。

FHIR コードの SDA CodeTableDetail へのマッピング

FHIR プリミティブ・コードまたはコード化オブジェクト (Coding、CodeableConcept など) がコード値を FHIR から SDA に変換するためにルックアップを使用しない場合、以下のように SDA CodeTableDetail (またはそのサブクラスの 1 つ) に変換されます。

• CodeableConcept.text は HS.SDA3.CodeTableTranslated.OriginalText に変換されます。

• CodeableConcept.coding.display (または Coding.display) は HS.SDA3.CodeTableDetail.Description に変換されます。

• CodeableConcept.coding.code (または Coding.code、あるいは単に code) は HS.SDA3.CodeTableDetail.Code に変換されます。

• CodeableConcept.coding.system (または Coding.system) の GetCodeforURI は HS.SDA3.CodeTableDetail.SDACodingStandard に変換されます。

• CodeableConcept.coding.version (または Coding.version) は HS.SDA3.CodeTableDetail.CodeSystemVersionId に変換されます。

ルックアップ・テーブルを使用した FHIR コード値の SDA へのマッピング

FHIR から SDA 用のコード・ルックアップ・テーブルをマッピングに使用したい場合、マッピング・テーブルにソース・フィールドのマッピング・エントリが 2 つ含まれています。

• 2 つのエントリの一方は、ルックアップ・テーブルを参照して、FHIR のコード値を SDA の Code にマップするエントリを見つけます。

• このペアのもう一方のマッピング・エントリは、ルックアップ・テーブルのエントリが利用できないか一致を提供しない場合に処理を引き継ぎます。このエントリは、前述のようにソースの FHIR コード値 (変更なし) を SDA の CodeTableDetail オブジェクトにマップします。つまり、FHIR の code が Coding オブジェクトまたは CodeableConcept オブジェクトの内部にある場合は、FHIR の code、display、system、version、および text の値はすべて SDA CodeTableDetail フィールドに適切にマップされます。

SDACodingStandard のマッピング

変換で、SDA オブジェクトの SDACodingStandard プロパティが検出されると、SDACodingStandard 値が OID レジストリに存在するかが確認され、以下のいずれかが実行されます。

• SDACodingStandard 値が URL を含む OID レジストリのエントリである場合は、変換により、FHIR Coding リソースの system フィールドがその URL に設定されます。

• SDACodingStandard 値が URL を定義していない OID レジストリのエントリである場合は、変換により、FHIR Coding リソースの system フィールドがその OID に設定されます。

• SDACodingStandard 値が OID レジストリのエントリでない場合は、変換により、FHIR 拡張に値が保存されます。

文字列値の数値へのマッピング

ターゲットが FHIR で、文字列値が数値にマップされている場合、文字列に単位や命令などの非数値テキストが含まれることがあります。これを処理するため、ソース・リスト・フィールドに以下の 2 つのマッピング・エントリがあります。

• 2 つのエントリの一方は常に、ソース文字列値を、1 つの文字列値フィールドで構成される FHIR 拡張に割り当てます。

• もう一方のマッピング・エントリは、ソース文字列値をテストして数値かどうかを確認します。数値であれば、この数値をターゲットの数値フィールドにマップします。

FHIR コード・オブジェクトのマルチパート・リテラル値

Coding オブジェクトまたは CodeableConcept オブジェクトである一部の FHIR ターゲット・フィールドでは、リテラル値からの一連のマッピングにより、必要に応じてフィールドに割り当てられるマルチパート値が形成されます。このようなオブジェクトが格納できるフィールドの完全なセットは、code、system、display、text、version、および userSelected です。

これに該当する場合、このコードが、マルチパート・リテラル値を受け取る Coding オブジェクトまたは CodeableConcept オブジェクト内に存在することが、code フィールドの DTL アノテーション要素で説明されます。このコードに関連するリテラル値マッピングのセットはすべて、[このフィールドの設定条件] で同じ値を持つことが [FHIR アノテーション] に示されます。

FHIR 拡張へのマッピング

変換ターゲットが FHIR である場合、1 つ以上の SDA プロパティがターゲットの FHIR スキーマ内に対応するフィールドを持っていないことがあります。その場合、変換により、SDA データは FHIR 拡張にマップされます。この拡張の URL 接頭語は http://intersystems.com/fhir/extn/sda3/lib です。完全 URL は完全な SDA プロパティ名です。これはリソース名を含みますが、ハイフンで区切ったすべて小文字のテキストを使用します。

例えば、SDA プロパティ HS.SDA3.Administration:AdministeredAmount の FHIR 拡張は次のようになります。

• 拡張名 ： administration-administered-amount

• FHIR 拡張の完全な URL ： http://www.intersystems.com/fhir/extn/sda3/lib/administration-administered-amount

SDA CustomPairs のマッピング

変換では、タイプ HS.SDA3.SuperClassOpens in a new tab の SDA クラスの古い CustomPairs プロパティがサポートされます。

CustomPairs はタイプ HS.SDA3.NVPairs のオブジェクトのコレクションで、そのそれぞれに 2 つのプロパティ Name と Value があります。変換コードが顧客の SDA データ内でこのプロパティを検出し、ターゲットが FHIR である場合、Parameters リソースを格納する FHIR 拡張にコレクションはマップされます。この Parameters リソースは、ペアになったフィールド name と valueString のコレクションです。

以下の例では、カスタマイズされた SDA Encounter オブジェクトに、3 つのメンバを持つ SDA CustomPairs コレクションがあり、それぞれに PlanOfCareInstructionsText という名前が付いています。

{
   "resourceType": "Encounter",
   "contained":
      [
        {
          "resourceType": "Parameters",
          "id": "63",
          "parameter":
            [
              {
                "name": "PlanOfCareInstructionsText",
                "valueString": "Doctor recommends at least 30 minutes of exercise per day"
              },
              {
                "name": "PlanOfCareInstructionsText",
                "valueString": "Use sports heart rate monitor to aid in monitoring effort level"
              },
              {
                "name": "PlanOfCareInstructionsText",
                "valueString": "Read \"South Beach Diet\""
               }
            ]
        }
      ],
   "extension":
      [
        {
          "url": "http://intersystems.com/fhir/extn/sda3/lib/encounter-custom-pairs",
          "valueReference":
            {
              "reference": "#63"
            }
        }
      ],
   "id": "914"
}

カスタム DTL のパッケージの指定

DTL をカスタマイズする前に、カスタマイズされるすべての DTL クラスのための単一のパッケージを指定する必要があります。クラス・パッケージには HS.Local.FHIR.DTL という名前を付けることをお勧めします。すべてのカスタム DTL に使用されるパッケージを決定したら、InterSystems ターミナルを使用して、このパッケージを指定する必要があります。カスタム DTL パッケージを指定するには、以下の手順に従います。

1. InterSystems ターミナルを開きます。

2. SDA-FHIR 変換を含むネームスペースに移動します。例を以下に示します。

   set $namespace = "Myfhirnamespace"
   

   

3. カスタム DTL パッケージが既に存在しているかどうかを確認するには、以下のように入力します。

   Write ##class(HS.FHIR.DTL.Util.API.ExecDefinition).GetCustomDTLPackage()
   

   

4. カスタム DTL パッケージがまだ存在しない場合は、以下のコマンドを入力します。HS.Local.FHIR.DTL はカスタム DTL パッケージの名前に置き換えます。

   set status = ##class(HS.FHIR.DTL.Util.API.ExecDefinition).SetCustomDTLPackage("HS.Local.FHIR.DTL")
   

   

5. パッケージが正常に定義されたことを確認するには、以下のように入力します。

   write status
   

   

   応答は 1 になります。

カスタム DTL の作成

既存の標準の DTL のコピーを保存してから編集し、カスタム DTL を作成します。変換する際に、標準の DTL ではなく、カスタムの DTL を使用することがわかるように、カスタム DTL のパッケージと名前は名前付け標準に準拠する必要があります。カスタム DTL を作成するには、以下の手順に従います。

1. 管理ポータルを開き、FHIR ネームスペースに移動します。

2. [相互運用性] → [リスト] → [データ変換] の順に選択します。

3. カスタマイズする変換の名前を見つけます。例えば、SDA から FHIR STU3 への変換は、先頭に HS.FHIR.DTL.SDA3.vSTU3 が付きます。一方、FHIR STU3 から SDA への変換は、先頭に HS.FHIR.DTL.vSTU3.SDA3 が付きます。

4. カスタマイズする変換の名前をダブルクリックして、DTL エディタで開きます。

5. InterSystems ターミナルを開きます。

6. カスタマイズされた DTL クラスに必要な名前を取得するには、ターミナルで以下のように入力します。

   Write ##class(HS.FHIR.DTL.Util.API.ExecDefinition).PreviewDTLCustomClass("standard_class_name")
   

   

   standard_class_name は、カスタマイズしている変換のフルネーム (パッケージを含む) です。これは、DTL エディタで開いている変換の名前です。[変換] タブで名前を参照できますが、拡張子 .dtl は含まれていません。

7. ターミナルでの応答を必ずメモしてください。カスタマイズされた DTL クラスにこの名前を付ける必要があります。

8. DTL エディタで、[名前を付けて保存] をクリックします。

9. [パッケージ] フィールドで、ターミナルに表示されたカスタマイズされた DTL クラスの名前にあるパッケージを入力します。例えば、ターミナルに表示されたカスタマイズされたクラス名が HS.Local.FHIR.DTL.SDA3.vSTU3.Address.Address の場合、HS.Local.FHIR.DTL.SDA3.vSTU3.Address と入力します (実際のクラス名を除く)。

10. [名前] フィールドに、カスタマイズされたクラスの名前を入力します。例えば、ターミナルに表示されたカスタマイズされたクラス名が HS.Local.FHIR.DTL.SDA3.vSTU3.Address.Address の場合、Address と入力します。

11. 説明を入力し、[OK] をクリックします。

カスタム・クラスのミラー・メンバへのコピー

ご使用の環境でミラーリングを使用しており、カスタマイズのパッケージがミラーリングされていないデータベースに存在する場合、カスタマイズされた DTL クラスを、各ミラー・メンバのカスタム・パッケージにコピーする必要があります。例えば、カスタマイズされたクラスのパッケージを HS.Local.FHIR.DTL と定義した場合、HS.Local はミラーリングされていない HSCUSTOM ネームスペースに存在するため、このカスタマイズされた DTL クラスを、各ミラー・メンバの HS.Local.FHIR.DTL にコピーする必要があります。カスタム・パッケージがミラーリングされるデータベースに存在する場合、これ以上のアクションは必要ありません。

オーバーライド可能な SDA から FHIR への変換メソッド

HS.FHIR.DTL.Util.API.Transform.SDA3ToFHIROpens in a new tab クラスの以下のメソッドは、カスタムの変換動作を実装するためにオーバーライドできます。

オーバーライド可能な FHIR から SDA への変換メソッド

HS.FHIR.DTL.Util.API.Transform.FHIRToSDA3Opens in a new tab クラスの以下のメソッドは、カスタムの変換動作を実装するためにオーバーライドできます。

ターミナル・ユーティリティを使用したルックアップ・テーブルのカスタマイズ

インターシステムズでは、ルックアップ・テーブルのカスタマイズ・プロセスを導くユーティリティを用意しています。カスタマイズ・ユーティリティを実行するには、以下の手順に従います。

1. InterSystems ターミナルを開きます。

2. FHIR ネームスペースを変更するには、以下のように入力します。

   set $namespace = "Myfhirnamespace"
   

   

   Myfhirnamepace は、作成した FHIR ネームスペースです。

3. ユーティリティを開始するには、以下のように入力します。

   do ##class(HS.FHIR.DTL.Util.API.LookupTable).EditLookupTable()
   

   

4. カスタマイズしているルックアップ・テーブルのマッピング・ソースを入力します。例えば、値を SDA3 から STU3 へマッピングするルックアップ・テーブルをカスタマイズしている場合は、SDA3 と入力します。

5. カスタマイズしているルックアップ・テーブルのマッピング・ターゲットを入力します。例えば、値を SDA3 から STU3 へマップするルックアップ・テーブルをカスタマイズしている場合は、STU3 と入力します。

6. カスタマイズするルックアップ・テーブルのマッピング・ソースの値セットに対応する数を入力します。

7. マッピング・ソースの値セットを含むルックアップ・テーブルが 1 つだけ存在する場合、マッピング・ターゲットの値セットは自動的に選択され、次の手順に進むことができます。それ以外の場合、カスタマイズするマッピング・ターゲットの値セットに対応する数を入力します。

8. 編集するコードからコードへのマッピングを選択します。ルックアップ・テーブルに新しいコードからコードへのマッピングを追加するには、+ を入力します。

9. コードからコードへのマッピングのターゲットの値を編集している場合は、マッピングの新しいターゲット値を入力します。

   コードからコードへのマッピングのソースの値を編集する場合は、- を入力して、コードからコードへのマッピング全体を削除し、ユーティリティを再実行して、正しいソースおよびターゲットの値で新しいマッピングを追加する必要があります。

Lookup.json の編集によるルックアップ・テーブルのカスタマイズ

ターミナル・ユーティリティを使用するのではなく、変換で使用されるルックアップ・テーブルのすべてが含まれる JSON ファイルで、キー/値ペアを追加、削除、または編集することにより、ルックアップ・テーブルをカスタマイズできます。それを開始する前に、提供された Lookup.json ファイルのカスタム・コピーを作成して、カスタム・ディレクトリのネームスペース固有のディレクトリに配置する必要があります。

カスタムの Lookup.json ファイルの編集

ルックアップ・テーブルのカスタマイズを開始するには、以下の 4 つの情報を収集する必要があります。

• マッピング・ソース

• マッピング・ターゲット

• マッピング・ソースの値セット

• マッピング・ターゲットの値セット

これらの値は、管理ポータルの [FHIR アノテーション] にあります。これらの値を確認するには、以下の手順に従います。

1. 管理ポータルを開き、FHIR ネームスペースに移動します。

2. ホーム・ページから、[Health]→[スキーマ・ドキュメント]→[FHIR アノテーション] を選択します。

3. 最初のドロップダウン・リストで、カスタマイズしているルックアップ・テーブルを含む変換のタイプを選択します。例えば、ルックアップ・テーブルでの SDA3 と FHIR STU3 のコードの相互マッピング方法が目的の場合は、[FHIR3–>SDA3] を選択します。

   マッピング・ソースとマッピング・ターゲットをメモします。変換ペアの最初のインタフェース形式がマッピング・ソースです。2 番目のインタフェース形式がマッピング・ターゲットです。例えば、[FHIR3—>SDA3] を選択する場合、vSTU3 がマッピング・ソースで、SDA3 がマッピング・ターゲットです。

4. [<transformation> ルックアップ・テーブルの表示] ボタンをクリックします。ボタンのフルネームは選択した変換ペアによります。

5. [ルックアップ・テーブルの表示] ダイアログで、ドロップダウン・リストを使用してマッピング・ソースの値セットとマッピング・ターゲットの値セットをメモします。マッピング・ソースの値セットは左側のドロップダウン・リスト内の名前です。マッピング・ターゲットの値セットは右側のドロップダウン・リスト内の名前です。

これで、マッピング・ソース、マッピング・ターゲット、マッピング・ソースの値セット、およびマッピング・ターゲットの値セットを取得したので、カスタムの Lookup.json ファイルで適切なキー/値ペアを追加、削除、または編集することにより、ルックアップ・テーブルを編集できます。

Lookup.json の最上位のキー/値ペアは、マッピング・ソースからマッピング・ターゲットへのリレーションシップに対応します。例えば、SDA3 から FHIR STU3 への変換で使用されるルックアップ・テーブルは以下のようになります。

"SDA3" : {
    "vSTU3" : {

次のレベルのキー/値ペアは、マッピング・ソースの値セットからマッピング・ターゲットの値セットへのリレーションシップに対応します。対応するキー/値ペアを探すことで、正しいルックアップ・テーブルを検索します。以下に例を示します。

"HS.SDA3.Alert:Status" :
    {"event-status" : {

ルックアップ・テーブルを見つけたら、コードからコードへのマッピングに対応するキー/値ペアを追加、削除、または編集できます。

"A":"in-progress",
"C":"unknown",
"I":"aborted",
"INT":"completed"