Überprüfungsvorgang: Übersicht
Wichtig
Azure API for FHIR wird am 30. September 2026 eingestellt. Folgen Sie den Migrationsstrategien, um bis zu diesem Datum zum Azure Health Data Services-FHIR-Dienst zu wechseln. Aufgrund der Einstellung von Azure API for FHIR werden neue Bereitstellungen ab dem 1. April 2025 nicht zugelassen. Der Azure Health Data Services-FHIR-Dienst ist die weiterentwickelte Version der Azure-API für FHIR, mit der Kunden FHIR-, DICOM- und MedTech-Dienste mit Integrationen in andere Azure-Dienste verwalten können.
In den Store-Profilen in der Azure-API für FHIR-Artikel haben Sie die Grundlagen von FHIR-Profilen durchlaufen und gespeichert. In diesem Artikel erfahren Sie, wie $validate Sie Ressourcen anhand von Profilen überprüfen können. Das Überprüfen einer Ressource anhand eines Profils bedeutet, dass überprüft wird, ob die Ressource dem Profil entspricht, einschließlich der in Resource.meta.profile oder in einem Implementierungshandbuch aufgeführten Spezifikationen.
$validate ist ein Vorgang in Fast Healthcare Interoperability Resources (FHIR®), mit dem Sie sicherstellen können, dass eine FHIR-Ressource den Basisressourcenanforderungen oder einem angegebenen Profil entspricht. Dieser Vorgang stellt sicher, dass die Daten in der Azure-API für FHIR über die erwarteten Attribute und Werte verfügen. Informationen zum Überprüfen des Vorgangs finden Sie unter HL7 FHIR Specification. Pro Spezifikation kann der Modus mit $validateangegeben werden, z. B. erstellen und aktualisieren:
create: Die Azure-API für FHIR überprüft, ob der Profilinhalt von den vorhandenen Ressourcen eindeutig ist und dass es akzeptabel ist, als neue Ressource erstellt zu werden.update: Überprüft, ob das Profil eine Aktualisierung der nominierten vorhandenen Ressource ist (d. h. es werden keine Änderungen an den unveränderlichen Feldern vorgenommen).
Es gibt verschiedene Möglichkeiten, wie Sie die Ressource überprüfen können:
- Überprüfen Einer vorhandenen Ressource mit Überprüfungsvorgang.
- Überprüfen Einer neuen Ressource mit Überprüfungsvorgang.
- Überprüfen Sie die Ressource CREATE/UPDATE mithilfe des Headers.
Die Azure-API für FHIR gibt immer die OperationOutcome Validierungsergebnisse für $validate Vorgang zurück. Die Azure-API für den FHIR-Dienst führt eine Überprüfung in zwei Schritten durch, sobald eine Ressource an $validate Endpunkt übergeben wird – der erste Schritt ist eine grundlegende Überprüfung, um sicherzustellen, dass die Ressource analysiert werden kann. Während der Ressourcenanalyse müssen einzelne Fehler behoben werden, bevor Sie mit dem nächsten Schritt fortfahren. Sobald die Ressource erfolgreich analysiert wurde, wird die vollständige Überprüfung im zweiten Schritt durchgeführt.
Hinweis
Alle Wertesätze, die für die Überprüfung verwendet werden sollen, müssen auf den FHIR-Server hochgeladen werden. Dazu gehören alle Valuesets, die Teil der FHIR-Spezifikation sind, sowie alle In Implementierungshandbücher definierten ValueSets. Nur vollständig erweiterte Valuesets, die eine vollständige Liste aller Codes enthalten, werden unterstützt. Alle ValueSet-Definitionen, die auf externe Quellen verweisen, werden nicht unterstützt.
Überprüfen einer vorhandenen Ressource
Verwenden Sie $validate zum Überprüfen einer vorhandenen Ressource in einer GET Anforderung:
GET http://<your Azure API for FHIR base URL>/{resource}/{resource ID}/$validate
Beispiel:
GET https://myworkspace-myfhirserver.fhir.azurehealthcareapis.com/Patient/a6e11662-def8-4dde-9ebc-4429e68d130e/$validate
In diesem Beispiel überprüfen Sie die vorhandene Patient-Ressource a6e11662-def8-4dde-9ebc-4429e68d130e für die Basis-Patient-Ressource. Wenn dies gültig ist, erhalten Sie ein OperationOutcome Beispiel wie das folgende Codebeispiel:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "information",
"code": "informational",
"diagnostics": "All OK"
}
]
}
Wenn die Ressource ungültig ist, erhalten Sie einen Fehlercode und eine Fehlermeldung mit Details dazu, warum die Ressource ungültig ist. Ein Beispiel OperationOutcome wird mit Fehlermeldungen zurückgegeben und könnte wie im folgenden Codebeispiel aussehen:
{
"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"
]
}
]
}
In diesem Beispiel stimmte die Ressource nicht mit dem bereitgestellten Patientenprofil überein, das einen Patientenbezeichnerwert und ein Geschlecht erforderte.
Wenn Sie ein Profil als Parameter angeben möchten, können Sie die kanonische URL für das Zu überprüfende Profil angeben, z. B. das folgende Beispiel für das HL7-Basisprofil für heartrate:
GET https://myAzureAPIforFHIR.azurehealthcareapis.com/Observation/12345678/$validate?profile=http://hl7.org/fhir/StructureDefinition/heartrate
Überprüfen einer neuen Ressource
Wenn Sie eine neue Ressource überprüfen möchten, die Sie in die Azure-API für FHIR hochladen, können Sie eine POST Anforderung ausführen: Der Server gibt immer einen OperationOutcome als Ergebnis zurück.
POST http://<your Azure API for FHIR base URL>/{Resource}/$validate
Beispiel:
POST https://myAzureAPIforFHIR.azurehealthcareapis.com/Patient/$validate
Diese Anforderung überprüft die Ressource. Bei Überprüfungsressourcen wird im FHIR-Dienst nicht erstellt, Sie müssen eine POST-Anforderung senden, ohne $validate, um eine Ressource zu erstellen.
Überprüfen Sie die Ressource CREATE/UPDATE mithilfe des Headers.
Standardmäßig ist die Azure-API für FHIR so konfiguriert, dass die Überprüfung für die Ressource Create/Updatedeaktiviert wird. Diese Funktion ermöglicht die Überprüfung Create/Updateauf , mithilfe der x-ms-profile-validation Kopfzeile. Legen Sie für die Überprüfung "x-ms-profile-validation" auf "true" fest.
Hinweis
Im Open-Source-FHIR-Dienst können Sie die Serverkonfigurationseinstellung unter den CoreFeatures ändern.
{
"FhirServer": {
"CoreFeatures": {
"ProfileValidationOnCreate": true,
"ProfileValidationOnUpdate": false
}
}
Nächste Schritte
In diesem Artikel haben Sie erfahren, wie Sie Ressourcen anhand von Profilen mithilfe von $validateProfilen überprüfen. Weitere Informationen zu den anderen unterstützten Features der Azure-API für FHIR finden Sie unter
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.