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 テストでは、これらの名前が typeservice-dateinsurer であると想定されています。

C4BB IG に必要な残りの検索パラメーターは、基本仕様によって定義されており、追加の更新なしで Azure API for FHIR で既に使用できます。

プロファイルを保存する

検索パラメーターを定義する以外に、このテストに合格するために必要なその他の更新は、必要なプロファイルを読み込むことです。 C4BB IG 内では 8 つのプロファイルが定義されています。

REST ファイルのサンプル

これらの検索パラメーターとプロファイルの作成を支援するため、このチュートリアルで概要を説明したすべての手順を 1 つのファイルに収めたサンプル http ファイルがあります。 必要なすべてのプロファイルと検索パラメーターをアップロードしたら、Touchstone で機能ステートメント テストを実行できます。

機能テスト スクリプトの実行結果。

Touchstone 読み取りテスト

機能ステートメントをテストした後、C4BB IG に対する Azure API for FHIR の読み取り機能をテストします。 これは、最初のテストで読み込んだ 8 つのプロファイルに対する準拠のテストです。 プロファイルに準拠するリソースを読み込んでいる必要があります。 データベースに既に存在するリソースに対してテストすることをお勧めしますが、リソースの作成とテストに使用できる IG の例から取得されたサンプル リソースを含む http ファイルも用意しています。

Touchstone 読み取りテストの実行結果。

Touchstone EOB クエリ テスト

次に確認するテストは、EOB クエリ テストです。 既に読み取りテストを完了している場合は、必要なすべてのデータが読み込まれています。 このテストでは、さまざまなパラメーターを使って、特定の PatientExplanationOfBenefit リソースを検索できることを検証します。

Touchstone EOB クエリの実行結果。

Touchstone エラー処理テスト

最後のテストでは、エラー処理をテストします。 実行する必要がある手順は、データベースから ExplanationOfBenefit リソースを削除し、削除した ExplanationOfBenefit リソースの ID をテストで使用することだけです。

Touchstone EOB エラー処理の結果。

次のステップ

このチュートリアルでは、Touchstone での Blue Button 向け CARIN IG のテストに合格する方法を見てきました。 次に、Da Vinci 採用集のテストを行う方法を確認できます。

Note

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。