Health Connect のアップグレード
Health Connect 2019.1 以降は InterSystems IRIS を利用しているため、Health Connect を新しいメジャー・リリースまたはメンテナンス・リリースにアップグレードするプロセスは、基盤となる InterSystems IRIS テクノロジのアップグレードと同様です。一部の手順はご使用の Health Connect 実装に適用されない場合がありますが、"InterSystems IRIS のアップグレード" に記載されているアップグレード・プロセスに従うことをお勧めします。
Health Connect 15.03 から Health Connect 2019.1 以降にアップグレードする場合は、"Health Connect 15.03 からのアップグレード" を参照してください。
2021.1 より前の FHIR エンドポイントのアップグレード後の手順
2021.1 よりも前のバージョンからアップグレードする場合は、FHIR サーバをどのようにカスタマイズしているかに応じて以下の手順が必要になることがあります。これらのタスクを以下の順序で実行します。
-
FHIR サーバがカスタム・サブクラスを使用している場合は、アーキテクチャのサブクラスを変更します。
-
FHIR エンドポイントでカスタム検索パラメータを使用している場合は、パラメータを FHIR パッケージに移行してエンドポイントに適用します。
以下の手順を完了すれば、検索テーブルのインデックスを再作成できます。
ステップ 1 : アーキテクチャのサブクラスの変更
Health Connect 2020.1 に導入された FHIR アーキテクチャの一環として、カスタムの InteractionsStrategy を使用してカスタム FHIR サーバを実装できるようになりました。FHIR サーバのエンドポイントでカスタムの InteractionsStrategy を使用する場合 (リソース・リポジトリのサブクラスを使用する場合を含む)、以下の手順を実行します。
-
Health Connect インスタンスのアップグレードを完了します。
-
IDE を使用して、エンドポイントのネームスペースで以下のいずれかを実行します。
-
エンドポイントの InteractionsStrategy がリソース・リポジトリ (HS.FHIRServer.Storage.Json.InteractionsStrategy) を拡張している場合は、HS.FHIRServer.Storage.Json.RepoManager のサブクラスを作成します。
-
エンドポイントの InteractionsStrategy が HS.FHIRServer.API.InteractionsStrategy のサブクラスを直接作成している場合は、HS.FHIRServer.API.RepoManager スーパークラスのサブクラスを作成します。
-
以下のパラメータをレポート・マネージャのサブクラスに追加します。
-
InteractionsStrategy サブクラスにサービスを管理するメソッドのカスタム・コードが含まれていた場合は、作成したレポート・マネージャ・サブクラスにある新しいメソッドにそのロジックを移動する必要があります。具体的には、カスタム・コードを Create、Delete、Decommission、および Update メソッドからレポート・マネージャ・サブクラスの対応するメソッド (CreateService、DeleteService、DecommissionService、および UpdateService) に移動する必要があります。
ステップ 2:FHIR パッケージへのカスタム検索パラメータの移行
以前のバージョンの Health Connect では、カスタムの FHIR 検索パラメータを使用するには、カスタム・メタデータ・セットを定義する必要がありました。このバージョンでは、カスタム検索パラメータを含む FHIR メタデータの定義は、FHIR パッケージに移行しました。以前のバージョンからアップグレードする場合、アップグレードを実行すると、カスタム・メタデータ・セットは削除され、FHIR エンドポイントはベース FHIR パッケージで構成されます (パッケージは、アップグレード前に使用されていたものに応じて STU3 または R4 になります)。
カスタムの FHIR 検索パラメータを使用する場合は、使用前に、パラメータを手動で FHIR パッケージに移行してエンドポイントに適用する必要があります。FHIR パッケージの作成および適用の手順は、"インターシステムズ製品における FHIR のサポート" の “FHIR のプロファイルと適応” の章に記載されています。最初にカスタム・メタデータ・セットを作成するために使用したファイルを使って、以下の手順を推奨されている順番で実行します。
-
カスタム FHIR パッケージを作成します。
-
パッケージをインポートするか、パッケージがインポート済みであることを確認します。
-
カスタム・パッケージをエンドポイントに適用します。
-
この手順を完了するには、エンドポイントのインデックスを再作成する必要があります。以降のアップグレード後のステップで、この作業を実行します。
または、FHIR パッケージ API を使用してこれらの手順を実行することもできます。
検索テーブルのインデックスの再作成
インデックスを必要とするすべての検索テーブルで、以下の手順に従ってインデックスを再作成します。
-
管理ポータルで、[Health] → [myFHIRnamespace] → [FHIR 構成] に移動します。
-
[サーバ構成] カードを選択します。
-
既存のエンドポイントごとに、[今すぐインデックスを再作成] を選択します。
-
プロンプトが表示されたら、[すべて選択] をクリックし、[インデックスの再作成] を選択します。
Note:
このステップの完了には時間を要することがあります。
Health Connect 15.03 からのアップグレード
Health Connect 2019.1 は、InterSystems IRIS を利用する Health Connect の最初のリリースでした。基盤のテクノロジがこのように変更されているため、旧バージョンの Health Connect からアップグレードする場合は特別なアップグレード手順が必要です。Health Connect 15.03 から Health Connect 2019.1 以降にアップグレードする場合は、InterSystems WRC DocumentsOpens in a new tab ページで利用できる "InterSystems IRIS インプレース変換ガイド" を参照してください。