Skip to main content

This documentation is for an older version of this product. See the latest version of this content.Opens in a new tab

サポートされる FHIR 相互作用とオペレーション

FHIR® サーバで提供されるリソース・リポジトリ・ストレージ・ストラテジを使用する場合、サーバは以下の相互作用とオペレーションをサポートします。カスタムの FHIR サーバがリソース・リポジトリを拡張する場合、これらの相互作用とオペレーションも既定でサポートされます。

相互作用

FHIR 相互作用Opens in a new tabは、FHIR クライアントがリソースで実行できる一連のアクションです。これらの相互作用は、インスタンス、タイプ、またはシステム全体のどれに対して作用するのかに応じて、グループ化されます。インスタンスとは、リソースの特定のインスタンスのことであり、例えば、Patient/1 は、id1 の Patient リソースのインスタンスを意味します。タイプは、Patient や Observation など、特定の FHIR リソースを表します。

以下の表は、リソース・リポジトリ、あるいは、リソース・リポジトリを拡張したカスタム FHIR サーバの FHIR 相互作用のサポート概要を示しています。相互作用をクリックすると、その相互作用が HL7 REST API でどのように定義されているかと、その使用方法を参照できます。

相互作用 サポート・レベル
createOpens in a new tab 条件付き作成を含め、完全にサポートされています。
readOpens in a new tab

条件付き読み取りはサポートされていません。

vreadOpens in a new tab

条件付き読み取りはサポートされていません。

updateOpens in a new tab 条件付き更新を含め、完全にサポートされています。
patchOpens in a new tab JSON パッチ・ドキュメントのみサポートされています。
deleteOpens in a new tab 条件付き削除を含め、完全にサポートされています。
historyOpens in a new tab

インスタンスの相互作用のみサポートされています。タイプやシステムはサポートされていません。例えば、GET [baseURL]/Patient/1/_history はサポートされていますが、GET [baseURL]/Patient/_historyGET [baseURL]/_history はサポートされていません。

_count および _at パラメータはサポートされていません。

ページングはサポートされていません。

batchOpens in a new tab 完全にサポートされています。
transactionOpens in a new tab バンドル内の循環参照はサポートされていません。
search 一部制限付きでサポートされています。詳細は、"search 相互作用" を参照してください。

オペレーション

既定のリソース・リポジトリを使用または拡張する FHIR サーバについては、以下のオペレーションがサポートされています。

オペレーション サポート・レベル
$everything

Patient および Encounter では完全にサポートされています。

Group および MedicinalProduct ではサポート対象外です。

$validate

検証モード (create、update、delete) はサポートされます。

プロファイルによる検証はサポートされません。

FHIR $validate 要求にリソース・ペイロードが含まれる場合、リソースを Parameters リソース内に埋め込むことができます。

$lastn 完全にサポートされています。

オペレーション・クエリ・パラメータ

特定のオペレーションでは、所定のオペレーション・クエリ・パラメータがサポートされています。

オペレーション クエリ・パラメータ
$everything
$lastn max がサポートされています。

$everything での _type オペレーション・クエリ・パラメータの再帰的動作

$everything オペレーションに対して _type クエリ・パラメータでリソース・タイプのリストが指定されている場合、コンパートメント検索は、リストされているタイプのリソースのみを返します。コンパートメントで再帰的にリソース参照を取得する場合、_types パラメータで指定されていないリソース・タイプへの参照はスキップされます。$everything_type クエリ・パラメータが PatientOpens in a new tab コンパートメントに対してどのように動作するかについて、いくつか例を挙げて説明します。

  1. /Patient/123/$everything?_type=DiagnosticReport,Observation — DiagnosticReport リソースと Observation リソースを返しますが、Patient リソースは返しません

  2. /Patient/123/$everything?_type=Observation — 参照する DiagnosticReport リソースが含まれなくても、患者の Observation リソースを返します。Observation は Patient コンパートメント内にもあるためです。

  3. /Patient/123/$everything?_type=Practitioner — 何も返しません。Practitioner は Patient コンパートメント内になく、Practitioner を参照できる他のリソース・タイプが指定されていませんでした。

  4. /Patient/123/$everything?_type=Patient,DiagnosticReport,Practitioner — Patient リソース、すべての DiagnosticReport リソース、および返される DiagnosticReport で直接参照されている Practitioner リソースのみを返します。

従来のリソース・リポジトリからの移行

InterSystems IRIS for Health 2019.4 以前を使用して開発された FHIR サーバでは、新しい FHIR サーバ・アーキテクチャを使用する前に、従来のリソース・リポジトリ内のデータを移行する必要があります。FHIR データを移行するには、以下の手順に従います。

  1. 管理ポータルで、従来の FHIR サーバのネームスペースに切り替え、STU3 エンドポイントを作成します。

  2. InterSystems ターミナルを開いて、従来の FHIR サーバのネームスペースに移動します。

  3. 以下を実行します。

    do ##class(HS.FHIRServer.ConsoleSetup).Migrate()
    
  4. STU3 エンドポイントを選択して、移行を確認します。

FeedbackOpens in a new tab