FHIR データの操作

各 R4 リソースには、HS.FHIRModel.R4 パッケージ内に対応する ObjectScript クラスがあります。例えば、HS.FHIRModel.R4.AllergyIntoleranceOpens in a new tab クラスは AllergyIntolerance リソースに対応します。これらのクラスは、基本仕様で定義された、リソースおよび構成要素のデータ構造とメソッドの予測可能な共有フレームワークを提供することで、開発を合理化します。

FHIRModel フレームワーク内では以下のようになります。

• リソースに固有の要素は、HS.FHIRModel.R4.[ResourceName]X というサブパッケージ内のクラスによってモデル化されます。例えば、HS.FHIRModel.R4.AllergyIntoleranceX.ReactionOpens in a new tab は AllergyIntolerance リソースの reaction 要素のデータ構造をモデル化します。

• 要素のコレクションは、SeqOf[ElementClassName] というクラスによってモデル化されます。リソースに固有のコレクションの場合、このクラスは [ResourceName]X サブパッケージ内に実装されます。例えば、HS.FHIRModel.R4.AllergyIntoleranceX.SeqOfAllergyIntoleranceXReactionOpens in a new tab は AllergyIntolerance リソースの reaction 要素のコレクションをモデル化します。

  

• リソース・クラスには、その中の複雑な要素または要素のコレクションごとに、Include[ElementName]() メソッドが含まれます。このメソッドは、要素またはコレクションの入れ子になった適切なデータ構造をリソース・オブジェクトに追加します。

• コレクション・クラスには、新しい要素をコレクション・オブジェクトに追加する MakeEntry() メソッドが含まれます。以下の例は、MakeEntry() と Include[ElementName]() の両方を示しています。

  Set claim = ##class(HS.FHIRModel.R4.Claim).%New()
  Do claim.IncludeInsurance()
  Set ins = claim.insurance.MakeEntry()
  Do ins.includeCoverage()
  Set ins.coverage.display = "Supra Health"
  (...)
  

  

• すべてのクラスは、コンテンツを取得、移動、変更するための共通のメソッドのセットを実装します。これらのメソッドは、%Library.AbstractSet クラスから継承されます。 

• fromDao() クラス・メソッドを使用して、FHIR リソースの JSON を表す動的抽象オブジェクトを、対応する FHIRModel クラスのインスタンスに変換できます。逆に、toDao() メソッドを使用して、FHIR リソースを表す FHIRModel クラスのインスタンスを動的抽象オブジェクトに変換できます。その後、ダイナミック・オブジェクトの %ToJSON() メソッドを使用して、有効な JSON ペイロードに変換できます。FHIRModel クラスの toString() メソッドを使用して、文字列形式の JSON ペイロードを直接生成することもできます。

• 必要に応じて、FHIR オブジェクト・クラスを拡張できます。

このリストには、動的抽象オブジェクト (DAO) 構造として表される FHIR リソースと FHIR オブジェクト間で変換する際、および FHIR オブジェクトを操作する際に必要になる可能性が高いメソッドが含まれます。これらのメソッドの詳細、またはその他のメソッドについては、クラス・リファレンスの "%Library.AbstractSet" クラスまたは関連する "HS.FHIRModel.R4" サブクラスを参照してください。

考えられるワークフローは次のようなものです。

1. FHIR リソースを JSON ペイロードとして受け取ります。

2. "FHIR データの操作" の説明に従って、JSON ペイロードを %DynamicObjectOpens in a new tab (%DynamicAbstractObjectOpens in a new tab のサブクラス) に変換します。

3. fromDao() を使用して、%DynamicObjectOpens in a new tab を類似する FHIRModel クラスのオブジェクトに変換します。

4. 必要に応じて、FHIR オブジェクトを操作します。

5. toString() を使用して、FHIR オブジェクトを JSON 形式に戻します。

FHIR オブジェクトの変換メソッド

fromDao(dao As %DynamicAbstractObject) As <HS.FHIRModel.R4 subclass>

DAO から指定された FHIR オブジェクトに変換します。例えば、JSON ペイロード dao から FHIR オブジェクト cls に変換する場合、以下のようになります。

Set rType = dao.resourceType
Set cls = $CLASSMETHOD("I4H.FhirR4."_rType,"fromDao",dao)

toDao() As %DynamicAbstractObject

FHIR オブジェクトから DAO に変換します。例えば、FHIR オブジェクト cls から DAO に変換する場合、以下のようになります。

Set newDao = cls.toDao()

toString()

FHIR オブジェクトから直接、文字列形式の JSON ペイロードに変換します。例えば、FHIR オブジェクト cls を直接 JSON ペイロード (文字列) に変換する場合、以下のようになります。

Set payload = cls.toString()

FHIR オブジェクトの設定およびクリア操作

設定およびクリア・メソッドを呼び出すには、Do [object].[method] 構文を使用します。例えば、add() メソッドの場合、以下のようになります。

Do item.IncludeEncounter()
Set ref = item.encounter.MakeEntry()
Set ref.reference = "urn:uuid:d8c2b161-7e3e-4e7f-9adc-ae464a9608bc"
Do item.encounter.add(ref)

add(value As %Any) as %AbstractSet

シーケンスのみ。新規メンバ value をシーケンスに追加します。

addAll(values As %AbstractSet) as %AbstractSet

シーケンスのみ。シーケンス values のすべてのメンバを現在のシーケンスに追加します。

clear()

現在のセットからすべての要素を削除します。

put(key As %DataType, value As %Any) as %AbstractSet

ラベル付きセットのみ。value をセットに入れて、ラベル key に関連付けます。要素が既にラベル key に関連付けられている場合は、新しい value に置き換えます。

putAll(keys As %AbstractSet, values As %AbstractSet) as %AbstractSet)

ラベル付きセットのみ。すべての {keys[n], values[n]} 要素を、values のすべての n のセットに入れます。

remove(key As %DataType) as %Any

key によって識別されたメンバをセットから削除します。

replace(key As %DataType, value As %Any) as %AbstractSet

ラベル付きセットのみ。key によって識別された要素の値を、指定された新しい value に置き換えます。

FHIR オブジェクトのイントロスペクション操作

apply(expression As %Any) as %AbstractSet

指定された SQL-JSON パス言語 (JPL) の式に一致するメンバの配列を返します。例えば、特定の Doctor リソースに関連付けられた電子メール・アドレスを見つける場合、以下のようになります。

Set key = "system"
Set value = "email"
Set query = "$[*]?(@."_key_"=='"_value_"')"
Set email = doctor.telecom.apply(query)

contains(key As %DataType) as %Boolean

key が現在、セットまたはシーケンスの NULL 以外のメンバである場合は true (1) を返し、そうでない場合は false (0) を返します。セットにラベルが付けられている場合、key は文字列である必要があります。シーケンスを処理する場合、key はゼロ以上の数値である必要があります。

containsAll(array As %DynamicArray) as %Boolean

array にリストされているすべてのキーがセットに含まれる場合、true (1) を返します。

size() as %Integer

このセット内の NULL 以外のメンバの数を返します。

以下のトピックでは、FHIR オブジェクト・モデルを最も効果的に使用するための提案と実例を提供します。

FHIR オブジェクト・モデルでの反復処理

以下のコーディング・パターンは、基盤となるデータが動的オブジェクトと静的オブジェクトのどちらにあるかに関係なく、FHIR オブジェクト・モデル内のどこにでも適用できます。

1. iterator() メソッドを使用して、コンテナ・クラスから反復子を要求します。

2. hasNext() メソッドを使用して、アクセスする新しいデータがある限りループします。ループ内では、以下を実行します。

   1. next() メソッドを使用して、次のキー/値またはインデックス/値のペアを取得します。

   2. 必要に応じて、.key および .value を使用してデータを処理します。

以下の例は list で開始します。これは、Bundle リソースの entry コレクションに見られるような、FHIR リソース・レコードの順序付きのコレクションです。このコレクションを反復処理し、各エントリの resourceType フィールドを調べ、見つかった各タイプのリソースの数を動的オブジェクトの summary に入力します。

Set summary = {}
Set itr = list.iterator()
While (itr.hasNext()) {
     Set rsc = itr.next().value
     Set rscName = rsc.resourceType
     Set count = summary.%Get(rscName,0)+1
     Do summary.%Set(rscName,count)
}

summary オブジェクトが DAO である、とシステムに対して明示的に指定した場合でも、同じパターンに従って結果を出力できます。この場合、単に各ノードを順番に参照するのではなく、キーと値の両方を確認します。

Write !,"BUNDLE SUMMARY:",!
Write $J("RESOURCE TYPE",35)_"   COUNT",!
Set itr = summary.iterator()
While (itr.hasNext()) {
     Set node = itr.next()
     Write $J(node.key,35)_"   "_node.value,!
}

IDE の FHIR オブジェクト・モデルの自動補完の候補の絞り込み

IDE にいくらかのヒントを提供すると、IDE は、自動補完のオプションを提示するときに、クラス、メソッド、プロパティ名に関してより有意義な候補を提供できるようになります。

#dim 指示文

IDE が有用な候補を挙げられるようにする最も簡単な方法は、#dim 指示文を使用することです。以下に例を示します。

#dim info As HS.HC.FHIRModel.R4.ClaimX.SupportingInfo

この例では、変数が Claim リソース内の SupportingInfo データ構造のインスタンスを参照することを IDE に通知して、可能性の高い一連の自動補完のオプションを大幅に絞り込みます。

%New() 指示文

%New() 指示文は、新しい最上位のリソースを割り当て、ORef に関連付けられる基本の型を IDE に通知します。以下に例を示します。

Set claim = ##class(HS.HC.FHIRModel.R4.Claim).%New()

この指示文に基づき、IDE は Claim.cls のクラス定義に基づいて、‘claim.’ が先頭に付いた任意のトークンに対して、メソッド名とプロパティ名の候補を提示できます。

ClassMethod 宣言

FHIR オブジェクト・クラスは単純に ORef の型定義であり、任意のメソッドに対してパラメータを定義するときに使用できます。これは、IDE に有意義な自動補完の候補を提供するための重要なヒントを提供します。以下に例を示します。

ClassMethod ExtractData(bundle As HS.HC.FHIRModel.R4.Bundle)

この例では、受信する ORef を Bundle リソースのインスタンスとして扱うようシステムに指示すると共に、’bundle.’ が参照されるたびに、IDE が Bundle クラスの適切な構造と機能に関して候補を提示できるようにします。

また、以下のように管理ポータルで便利な [バンドルのロード] メニュー・オプションを使用して、カスタムのバンドルをロードすることもできます。

1. 管理ポータルで、[ホーム]→[Health]→[[MyFHIRNamespace]]→[FHIR サーバ管理] に移動します。

2. 関連する FHIR サーバのタイルで、メニューを開き [バンドルのロード] を選択します。

3. 表示されるダイアログで、以下のようにカスタムの FHIR バンドルをロードできます。

   カスタムの FHIR バンドル

   クライアントがサーバにファイルをアップロードできるようにし、その後 HTTP を経由せずに FHIR リソースを FHIR サーバに直接送信します。

   1. [カスタムの FHIR バンドル] のラジオ・ボタンを選択し、[次へ] をクリックします。

   2. [カスタム・バンドルの選択] をクリックし、目的のバンドルを参照します。

   3. [読み込み] をクリックします。

データのロードの詳細や、データ・ロード・ユーティリティを使用してバンドルとリソースをロードする手順については、"データ・ロード・ユーティリティ" を参照してください。