FHIR のプロファイルと適応

パッケージのインポート

エンドポイントを構成して、実装ガイドやカスタム・パッケージをサポートする前に、管理ポータルを使用して、公開済みパッケージやカスタム・パッケージをインポートしておく必要があります。一部の標準パッケージ (US Core など) は、既定で使用可能なため、エンドポイントに適用する前にインポートする必要はありません。

パッケージをインポートするには、以下の手順に従います。

1. パッケージの JSON ファイルがローカル・マシン上にあることを確認します。公開済みのパッケージをインポートする場合は、そのパッケージを配布サイトからローカル・マシンにダウンロードします。カスタム・パッケージに関する追加要件は、"カスタム・パッケージの作成" を参照してください。

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

3. [パッケージ構成] カードを選択します。

4. 新しいパッケージの依存関係が既にインポートされていることを確認します。[パッケージ構成] ページの左側のナビゲーション・バーを見ると、インポート済みのパッケージを確認できます。

5. [パッケージをインポート] を選択します。

6. パッケージの JSON ファイルを含むディレクトリを選択します。個々のファイルは選択しないでください。

7. [インポート] を選択します。

FHIR パッケージに含まれていたプロファイルとその他のアーティファクトのパッケージがエンドポイントで使用できるようになりました。

パッケージのアンインストール

パッケージが別のパッケージとの間に依存関係がなく、既存のエンドポイントに適用されていない場合は、そのパッケージを FHIR サーバのネームスペースから削除できます。パッケージをアンインストールしても、パッケージのインポートに使用されたローカルの JSON ファイルは削除されません。パッケージをアンインストールするには、以下の手順に従います。

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

2. [パッケージ構成] カードを選択します。

3. 左側のナビゲーション・バーからパッケージを選択します。

4. [パッケージのアンインストール] を選択します。エンドポイントに適用されているパッケージはアンインストールできません。さらに、別のパッケージの依存関係であるパッケージもアンインストールできません。

カスタム・パッケージの作成

カスタム・パッケージを使用して、カスタムのプロファイルや検索パラメータをサポートするよう FHIR エンドポイントを構成できます。例えば、カスタム検索パラメータを追加するには、ローカル・マシンにある JSON ファイルで SearchParameter リソースを定義します。次に、同じディレクトリに package.json というファイルを作成します。少なくとも、このファイルには、パッケージの名前、バージョン、依存関係が含まれている必要があります。例えば、package.json ファイルは次のようになります。

{
  "name":"myorg.implementation.r4",
  "version":"0.0.1",
  "dependencies": {
    "hl7.fhir.r4.core":"4.0.1"
  }
}

Conformance リソースの定義を含む JSON ファイルと package.json ファイルが 1 つのディレクトリに用意できたら、新しいパッケージをインポートする準備は完了です。

エンドポイントへのパッケージの適用

新しい FHIR エンドポイントを作成する場合は、エンドポイントでサポートするパッケージを選択します。エンドポイント作成時には、インポートされたこれらのパッケージのみ使用できます。インターシステムズ製品には、既にインポートされた公開済みパッケージがいくつか付属しています。

新しいパッケージを既存のエンドポイントに適用することもできます。既存のエンドポイントにパッケージを追加するには、以下の手順に従います。

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

2. [サーバ構成] カードを選択します。

3. リストからエンドポイントを選択します。

4. [編集] を選択します。

5. [追加パッケージ] ドロップダウン・リストを使用して、パッケージを選択します。リストにパッケージが表示されない場合は、パッケージがインポートされていることを確認します。

6. [更新] を選択します。

エンドポイントのインデックスの再作成

公開またはカスタムのパッケージを使用して、新しい検索パラメータを既存のエンドポイントに追加する場合、FHIR クライアントは、パッケージの適用後に、新しいパラメータを使用して、リポジトリに追加されたリソースを取得できます。ただし、新しい検索パラメータを追加する前に存在していたリソースは、エンドポイントのインデックスを再作成するまで、返されません。エンドポイントのインデックスを再作成するまで、新しい検索パラメータを使用する FHIR クライアントは、検索結果が不完全である可能性があることを示す OperationOutcome を受信します。

新しい検索パラメータを含むパッケージを適用したら、エンドポイントのインデックスを再作成するオプションが [サーバ構成] ページ ([Health] → [FHIR 構成] → [サーバ構成]) のエンドポイントの URL の横に表示されます。リポジトリに既存のリソースが多数ある場合は、エンドポイントのインデックスの再作成に長時間かかる可能性があります。

パッケージ API

実装で、ユーザ・インタフェースを使用せずに直接パッケージを操作する必要がある場合は、以下の API メソッドを利用できます。

パッケージのインポート

インターシステムズ FHIR サーバは、パッケージを使用して、サポートする FHIR プロファイルやその他のアセットを判断します。インターシステムズ製品には、FHIR の基本バージョンに対応する事前にロードされたパッケージと一般的な実装ガイドが付属していますが、StructureDefinition や ValueSet などの Conformance リソースを定義する JSON ファイルを含むディレクトリを指定することにより、新しいパッケージをインポートすることもできます。FHIR パッケージの詳細は、"FHIR パッケージの操作" を参照してください。

エンドポイントに追加できるよう新しいパッケージをインポートする API は、HS.FHIRMeta.Load.NpmLoader.importPackages()Opens in a new tab です。例えば、以下のコードでカスタム・パッケージがインポートされます。

do ##class(HS.FHIRMeta.Load.NpmLoader).importPackages($lb("C:\fhir-packages\node_modules\myorg.fhir.myPackage\"))

利用可能なパッケージのリスト

ネームスペースにインポートされたパッケージのリストを取得するには、HS.FHIRMeta.Storage.Package.GetAllPackages()Opens in a new tab メソッドを使用します。例えば、以下のコードは、使用可能なパッケージの識別子を表示します。

set packages = ##class(HS.FHIRMeta.Storage.Package).GetAllPackages()
for i=1:1:packages.Count()
  { write packages.GetAt(i).id,! }

パッケージのアンインストール

パッケージが別のパッケージとの間に依存関係がなく、既存のエンドポイントに適用されていない場合は、HS.FHIRMeta.Load.NpmLoader.UninstallPackage()Opens in a new tab を使用して、そのパッケージを FHIR サーバのネームスペースから削除できます。パッケージをアンインストールしても、パッケージのインポートに使用されたローカルの JSON ファイルは削除されません。利用可能なパッケージのリストを表示することにより、アンインストールするパッケージの ID を特定できます。例えば、パッケージをアンインストールする呼び出しは次のようになります。

do ##class(HS.FHIRMeta.Load.NpmLoader).UninstallPackage("myorg.r4@1.0.0")