Megosztás:

FHIR-erőforrások ellenőrzése az Azure Health Data Services profiljaival

Az FHIR® szolgáltatáscikk áruházi profiljaiban végigjárta az FHIR-profilok alapjait, és tárolhatja őket. Az Azure Health Data Services FHIR szolgáltatása lehetővé teszi az erőforrások profilok közötti ellenőrzését annak ellenőrzéséhez, hogy az erőforrások megfelelnek-e a profiloknak. Ez a cikk bemutatja, hogyan használhatja $validate az erőforrások profilokhoz való érvényesítéséhez.

$validate A Fast Healthcare Együttműködési erőforrások (FHIR) egy olyan művelete, amely lehetővé teszi, hogy egy FHIR-erőforrás megfeleljen az alaperőforrás-követelményeknek vagy egy megadott profilnak. Ez a művelet biztosítja, hogy az FHIR szolgáltatás adatai a várt attribútumokkal és értékekkel rendelkezjenek. Az érvényesítési művelettel kapcsolatos információkért tekintse meg a HL7 FHIR specifikációját.

Specifikációnként a mód megadható például a létrehozással és a frissítéssel $validate:

  • create: Az FHIR szolgáltatás ellenőrzi, hogy a profil tartalma egyedi-e a meglévő erőforrásoktól, és hogy elfogadható-e új erőforrásként létrehozni.
  • update: Ellenőrzi, hogy a profil frissítés-e a kijelölt meglévő erőforráson (azaz nem történt módosítás a nem módosítható mezőkben).

Az erőforrás ellenőrzésének különböző módjai vannak:

  • 1. lehetőség: Meglévő erőforrás ellenőrzése az érvényesítési művelettel.
  • 2. lehetőség: Új erőforrás érvényesítése az érvényesítési művelettel.
  • 3. lehetőség: Az erőforrás létrehozása vagy frissítése fejléc használatával.

Az érvényesítési művelettel rendelkező meglévő vagy új erőforrás sikeres érvényesítése esetén az erőforrás nem marad meg az FHIR szolgáltatásban. A 3. lehetőséggel sikeresen megőrizheti az ellenőrzött erőforrásokat az FHIR szolgáltatásban.

Az FHIR szolgáltatás mindig egy OperationOutcome $validate művelet érvényesítési eredményeként ad vissza. Miután átad egy erőforrást $validate végpontnak, az FHIR szolgáltatás két lépéses ellenőrzést hajt végre. Az első lépés egy alapszintű ellenőrzés, amely biztosítja, hogy az erőforrás elemezhető legyen. Az erőforrás-elemzés során az egyes hibákat ki kell javítani, mielőtt továbblép a következő lépésre. Az erőforrás sikeres elemzése után a rendszer a második lépésként teljes ellenőrzést végez.

Feljegyzés

Az ellenőrzéshez használni kívánt értékkészleteket fel kell tölteni az FHIR-kiszolgálóra. Ide tartoznak az FHIR-specifikáció részét képező értékhalmazok, valamint a megvalósítási útmutatókban meghatározott értékhalmazok. Csak az összes kód teljes listáját tartalmazó teljesen kibontott értékhalmazok támogatottak. A külső forrásokra hivatkozó ValueSet-definíciók nem támogatottak.

1. lehetőség: Meglévő erőforrás érvényesítése

Meglévő erőforrás érvényesítéséhez használja $validate egy GET kérelemben.

GET http://<your FHIR service base URL>/{resource}/{resource ID}/$validate

Példa:

GET https://myworkspace-myfhirserver.fhir.azurehealthcareapis.com/Patient/a6e11662-def8-4dde-9ebc-4429e68d130e/$validate

Ebben a példában a meglévő Beteg erőforrást a6e11662-def8-4dde-9ebc-4429e68d130e érvényesíti az alap Beteg erőforráshoz. Ha ez érvényes, az alábbi példakódhoz hasonlót kap OperationOutcome .

{
    "resourceType": "OperationOutcome",
    "issue": [
        {
            "severity": "information",
            "code": "informational",
            "diagnostics": "All OK"
        }
    ]
}

Ha az erőforrás érvénytelen, hibaüzenet jelenik meg, amely részletesen ismerteti, hogy miért érvénytelen az erőforrás. A rendszer hibaüzenetekkel ad vissza egy példát OperationOutcome , és az alábbi példakódhoz hasonlóan nézhet ki.

{
    "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"
            ]
        }
    ]
}

Ebben a példában az erőforrás nem felelt meg a megadott betegprofilnak, amelyhez egy betegazonosító értékre és nemre volt szükség.

Ha paraméterként szeretne megadni egy profilt, megadhatja az érvényesítendő profil canonical URL-címét, például a következő példát a HL7 alapprofilhoz heartrate.

GET https://myworkspace-myfhirserver.fhir.azurehealthcareapis.com/Observation/12345678/$validate?profile=http://hl7.org/fhir/StructureDefinition/heartrate

2. lehetőség: Új erőforrás érvényesítése

Ha ellenőrizni szeretné, hogy egy új erőforrást tölt-e fel a kiszolgálóra, kérést POST is intézhet.

POST http://<your FHIR service base URL>/{Resource}/$validate

Példa:

POST https://myworkspace-myfhirserver.fhir.azurehealthcareapis.com/Patient/$validate

Ez a kérés ellenőrzi az erőforrást. A kérésben megadott új erőforrás az ellenőrzés után jön létre. A kiszolgáló mindig eredményként ad vissza egy OperationOutcome értéket.

3. lehetőség: Az erőforrás létrehozása vagy frissítése fejléc használatával

Kiválaszthatja, hogy mikor szeretné ellenőrizni az erőforrást, például az erőforráson CREATE vagy UPDATEa . Alapértelmezés szerint az FHIR szolgáltatás úgy van konfigurálva, hogy letiltsa az érvényesítést az erőforráson Create/Update. Ez a funkció lehetővé teszi az x-ms-profile-validation élőfej használatával végzett Create/Update ellenőrzést. Igaz értékre van állítva x-ms-profile-validation az ellenőrzéshez.

Feljegyzés

A nyílt forráskódú FHIR szolgáltatásban módosíthatja a kiszolgáló konfigurációs beállításait a CoreFeatures alatt.

{
   "FhirServer": {
      "CoreFeatures": {
            "ProfileValidationOnCreate": true,
            "ProfileValidationOnUpdate": false
        }
}

A szigorú ellenőrzés engedélyezéséhez használjon egy "Prefer: handling" fejlécet szigorú értékkel. A fejléc beállításával a rendszer hibaüzenetként jelent egy érvényesítési figyelmeztetést.

Következő lépések

Ebben a cikkben megtanulhatta, hogyan érvényesítheti az erőforrásokat a profilok alapján $validate. A többi FHIR szolgáltatás által támogatott funkcióval kapcsolatos további információkért lásd:

Támogatott FHIR-funkciók

Feljegyzés

Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.

  • Last updated on