Azure API for FHIR 用 Blue Button® の CARIN 実装ガイド
重要
Azure API for FHIR は、2026 年 9 月 30 日に廃止されます。 移行戦略に従って、その日までに Azure Health Data Services FHIR® サービスに切り替えてください。 Azure API for FHIR が廃止されたため、2025 年 4 月 1 日以降、新しいデプロイは許可されません。 Azure Health Data Services FHIR サービス は、お客様が他の Azure サービスへの統合を使用して、FHIR、DICOM、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。
このチュートリアルでは、Blue Button 向け CARIN 実装ガイド (C4BB IG) に関する Touchstone テストに合格するように Azure API for FHIR® を設定する手順を見ていきます。
Touchstone 機能ステートメント
最初に注目するテストは、C4BB IG 機能ステートメントに対して Azure API for FHIR をテストすることです。 このテストを更新なしで Azure API for FHIR に対して実行すると、検索パラメーターとプロファイルがないため、テストは失敗します。
検索パラメーターを定義する
C4BB IG の一部として、ExplanationOfBenefit
リソース用に 3 つの新しい検索パラメーターを定義する必要があります。 これらのうち 2 つは機能ステートメントでテストされ (type と service-date)、1 つは _include
の検索に必要です (insurer)。
Note
これらの検索パラメーターの生の JSON では、名前は ExplanationOfBenefit_<SearchParameter Name>
に設定されます。 Touchstone テストでは、これらの名前が type、service-date、insurer であると想定されています。
C4BB IG に必要な残りの検索パラメーターは、基本仕様によって定義されており、追加の更新なしで Azure API for FHIR で既に使用できます。
プロファイルを保存する
検索パラメーターを定義する以外に、このテストに合格するために必要なその他の更新は、必要なプロファイルを読み込むことです。 C4BB IG 内では 8 つのプロファイルが定義されています。
- C4BB Coverage
- C4BB ExplanationOfBenefit Inpatient Institutional
- C4BB ExplanationOfBenefit Outpatient Institutional
- C4BB ExplanationOfBenefit Pharmacy
- C4BB ExplanationOfBenefit Professional NonClinician
- C4BB Organization
- C4BB Patient
- C4BB Practitioner
REST ファイルのサンプル
これらの検索パラメーターとプロファイルの作成を支援するため、このチュートリアルで概要を説明したすべての手順を 1 つのファイルに収めたサンプル http ファイルがあります。 必要なすべてのプロファイルと検索パラメーターをアップロードしたら、Touchstone で機能ステートメント テストを実行できます。
Touchstone 読み取りテスト
機能ステートメントをテストした後、C4BB IG に対する Azure API for FHIR の読み取り機能をテストします。 これは、最初のテストで読み込んだ 8 つのプロファイルに対する準拠のテストです。 プロファイルに準拠するリソースを読み込んでいる必要があります。 データベースに既に存在するリソースに対してテストすることをお勧めしますが、リソースの作成とテストに使用できる IG の例から取得されたサンプル リソースを含む http ファイルも用意しています。
Touchstone EOB クエリ テスト
次に確認するテストは、EOB クエリ テストです。 既に読み取りテストを完了している場合は、必要なすべてのデータが読み込まれています。 このテストでは、さまざまなパラメーターを使って、特定の Patient
と ExplanationOfBenefit
リソースを検索できることを検証します。
Touchstone エラー処理テスト
最後のテストでは、エラー処理をテストします。 実行する必要がある手順は、データベースから ExplanationOfBenefit リソースを削除し、削除した ExplanationOfBenefit
リソースの ID をテストで使用することだけです。
次のステップ
このチュートリアルでは、Touchstone での Blue Button 向け CARIN IG のテストに合格する方法を見てきました。 次に、Da Vinci 採用集のテストを行う方法を確認できます。
Note
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。