次の方法で共有

Azure API for FHIR 用 Da Vinci Plan Net

  • [アーティクル]

重要

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 です。

このチュートリアルでは、Da Vinci PDEX Payer Network (Plan-Net) 実装ガイド (IG) の Touchstone テストに合格するように Azure API for FHIR で FHIR® サービスを設定する手順について説明します。

Touchstone 機能ステートメント

最初に注目するテストは、Da Vinci Plan-Net 機能ステートメントに対して Azure API for FHIR をテストすることです。 このテストを更新なしで実行すると、検索パラメーターとプロファイルがないため、テストは失敗します。

検索パラメーターを定義する

Da Vinci Plan-Net IG の一部として、医療サービス、保険プラン、開業医の役割、組織、および組織の所属リソースに 6 つの新しい検索パラメーターを定義する必要があります。 これらの 6 つはすべて、機能ステートメントでテストされます。

Note

これらの検索パラメーターの生の JSON では、名前は Plannet_sp_<Resource Name>_<SearchParameter Name> に設定されます。 Touchstone テストでは、これらの名前が SearchParameter Name (カバレッジ領域、プランの種類、またはネットワーク) のみであることを想定しています。

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

プロファイルを保存する

検索パラメーターの定義以外では、このテストに合格するために必要なプロファイルと拡張機能を読み込む必要があります。 Da Vinci Plan-Net IG の一部として使用される 9 つのプロファイルがあります。

REST ファイルのサンプル

これらの検索パラメーターとプロファイルの作成を支援するために、前述したすべての手順を 1 つのファイルに含めたサンプル http ファイルがオープンソース サイトに用意されています。 必要なすべてのプロファイルと検索パラメーターをアップロードしたら、Touchstone で機能ステートメント テストを実行できます。

Da Vinci plan net sample rest test execution script passed

Touchstone エラー処理テスト

2 つ目のテストでは、エラー処理をテストします。 実行する必要がある唯一の手順は、データベースから HealthcareService リソースを削除し、削除された HealthcareService リソースの ID をテストで使用することです。 オープンソース サイトのサンプル DaVinci_PlanNet.http ファイルには、この手順の投稿と削除を行う HealthcareService の例が示されています。

Da Vinci plan net touchstone error test execution script passed

Touchstone クエリ テスト

次に説明するテストは、クエリ機能のテストです。 ここでは、最初のテストで読み込んだプロファイルに対する準拠をテストします。 プロファイルに準拠するリソースを読み込んでいる必要があります。 既にデータベース内に存在するリソースに対してテストすることをお勧めします。 IG の例から取得されたサンプル リソースを含む DaVinci_PlanNet_Sample_Resources.http ファイルもあるので、これを使ってリソースを作成してテストすることもできます。

Da Vinci plan net query test failed

Note

提供されているサンプル リソースを使用すると、クエリ テストの成功率は 98% になるはずです。 FHIR サーバーに対して GitHub で未解決の issue があり、これらのテストのいずれかが失敗します。

基本条件と _include 条件の両方を満たしている場合、リソースは複数回返されます。 詳細については、イシュー #2037 を参照してください。

次のステップ

このチュートリアルでは、Da Vinci PDEX Payer Network (Plan-Net) 実装ガイドの Touchstone テストに合格するように Azure API for FHIR を設定する手順について説明しました。 Azure API for FHIR でサポートされている機能の詳細については、以下を参照してください

サポートされている機能。

Note

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