検証操作: 概要
重要
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 です。
Azure API for FHIR のストア プロファイルに関する記事では、FHIR プロファイルの基本と格納について説明しました。 この記事では、プロファイルに対するリソースの検証に使用 $validate
する方法について説明します。 プロファイルに対してリソースを検証することは、実装ガイドに記載されているResource.meta.profile
仕様を含め、リソースがプロファイルに準拠しているかどうかをチェックすることを意味します。
$validate
は、FHIR リソースが基本リソースの要件または指定されたプロファイルに準拠していることを確認できる、Fast Healthcare Interoperability Resources (FHIR®) の操作です。 この操作により、Azure API for FHIR のデータに期待される属性と値が確実に含まれます。 検証操作の詳細については、HL7 FHIR 仕様を参照してください。 仕様に従って、作成や更新などのモードを $validate
指定できます。
create
: Azure API for FHIR チェック、プロファイル コンテンツは既存のリソースから一意であり、新しいリソースとして作成してもかまいません。update
: プロファイルが、指定された既存のリソースに対する更新であることを確認します (変更できないフィールドに対する変更は行われません)。
リソースを検証するには、さまざまな方法が用意されています。
- 検証操作を使用して既存のリソースを検証します。
- 検証操作を使用して新しいリソースを検証します。
- ヘッダーを使用してリソース CREATE/UPDATE を検証します。
Azure API for FHIR は常に、 OperationOutcome
$validate操作の検証結果として返されます。 Azure API for FHIR サービスでは、リソースがエンドポイント$validate渡されると、2 つの手順の検証が実行されます。最初の手順は、リソースを解析できるようにするための基本的な検証です。 リソースの解析中は、次の手順に進む前に、個々のエラーを修正する必要があります。 リソースが正常に解析されると、完全な検証が 2 番目の手順として実行されます。
Note
検証に使用する値セットは、FHIR サーバーにアップロードする必要があります。 これには、FHIR 仕様の一部であるすべての値セットと、実装ガイドで定義されている ValueSet が含まれます。 すべてのコードの完全な一覧を含む完全に展開された値セットのみがサポートされます。 外部ソースを参照する ValueSet 定義はサポートされていません。
既存のリソースの検証
既存のリソースを検証するには、GET
要求で $validate
を使用します。
GET http://<your Azure API for FHIR base URL>/{resource}/{resource ID}/$validate
次に例を示します。
GET https://myworkspace-myfhirserver.fhir.azurehealthcareapis.com/Patient/a6e11662-def8-4dde-9ebc-4429e68d130e/$validate
この例では、ベースの Patient リソースに対して既存の Patient リソース a6e11662-def8-4dde-9ebc-4429e68d130e
を検証しています。 有効な場合は、次のようなコード例が表示 OperationOutcome
されます。
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "information",
"code": "informational",
"diagnostics": "All OK"
}
]
}
リソースが有効でない場合は、エラー コードと、リソースが無効な理由の詳細を示すエラー メッセージが表示されます。 エラー メッセージを含む例 OperationOutcome
が返され、次のコード例のようになります。
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"details": {
"coding": [
{
"system": "http://hl7.org/fhir/dotnet-api-operation-outcome",
"code": "1028"
}
],
"text": "Instance count for 'Patient.identifier.value' is 0, which is not within the specified cardinality of 1..1"
},
"location": [
"Patient.identifier[1]"
]
},
{
"severity": "error",
"code": "invalid",
"details": {
"coding": [
{
"system": "http://hl7.org/fhir/dotnet-api-operation-outcome",
"code": "1028"
}
],
"text": "Instance count for 'Patient.gender' is 0, which is not within the specified cardinality of 1..1"
},
"location": [
"Patient"
]
}
]
}
この例では、リソースは提供された Patient プロファイルに準拠していません。これには、患者識別子の値と性別が必要でした。
プロファイルをパラメーターとして指定する場合は、検証対象のプロファイルの正規 URL を指定できます。HL7 基本プロファイル heartrate
の例を次に示します。
GET https://myAzureAPIforFHIR.azurehealthcareapis.com/Observation/12345678/$validate?profile=http://hl7.org/fhir/StructureDefinition/heartrate
新しいリソースの検証
Azure API for FHIR にアップロードする新しいリソースを検証する場合は、要求を実行 POST
できます。サーバーは常に OperationOutcome を結果として返します。
POST http://<your Azure API for FHIR base URL>/{Resource}/$validate
次に例を示します。
POST https://myAzureAPIforFHIR.azurehealthcareapis.com/Patient/$validate
この要求により、リソースが検証されます。 検証リソースが FHIR サービスで作成されていない場合は、リソースを作成する$validateなしで POST 要求を送信する必要があります。
ヘッダーを使用してリソース CREATE/UPDATE を検証します。
既定では、Azure API for FHIR はリソース Create/Update
の検証をオプトアウトするように構成されています。 この機能を使用すると、ヘッダーを使用して検証 Create/Update
できます x-ms-profile-validation
。 検証の場合は、'x-ms-profile-validation' を true に設定します。
Note
オープン ソースの FHIR サービスでは、CoreFeatures でサーバー構成設定を変更できます。
{
"FhirServer": {
"CoreFeatures": {
"ProfileValidationOnCreate": true,
"ProfileValidationOnUpdate": false
}
}
次のステップ
この記事では、次を使用 $validate
してプロファイルに対してリソースを検証する方法について説明しました。 その他の Azure API for FHIR でサポートされている機能については、以下を参照してください。
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。