Doğrulama İşlemi : Genel Bakış

FHIR için Azure API'deki mağaza profilleri makalesinde, FHIR profillerinin temellerini gözden geçirip depolamıştınız. Bu makale, kaynakları profillere göre doğrulamak için nasıl kullanacağınız $validate konusunda size yol gösterir. Bir kaynağın bir profille doğrulanıyor olması, kaynağın profille uyumlu olup olmadığının denetlenmesi (uygulama kılavuzunda Resource.meta.profile veya içinde listelenen belirtimler dahil) anlamına gelir.

$validate , Bir FHIR® kaynağının temel kaynak gereksinimlerine veya belirtilen bir profile uygun olduğundan emin olmanıza olanak tanıyan Hızlı Sağlık Hizmetleri Birlikte Çalışabilirlik Kaynakları'nda (FHIR) yapılan bir işlemdir. Bu işlem, FHIR için Azure API'deki verilerin beklenen özniteliklere ve değerlere sahip olmasını sağlar. Doğrulama işlemi hakkında bilgi için HL7 FHIR Belirtimi'ne bakın. Belirtim başına, Modu ile $validatebelirtilebilir, örneğin oluşturma ve güncelleştirme:

• create: FHIR için Azure API, profil içeriğinin mevcut kaynaklardan benzersiz olup olmadığını ve yeni bir kaynak olarak oluşturulmasının kabul edilebilir olduğunu denetler.
• update: Profilin, aday gösterilen mevcut kaynağa göre bir güncelleştirme olup olmadığını denetler (sabit alanlarda değişiklik yapılmaz).

Kaynağı doğrulamanız için farklı yollar sağlanır:

• Doğrulama işlemiyle var olan bir kaynağı doğrulayın.
• Doğrulama işlemiyle yeni bir kaynağı doğrulayın.
• Üst bilgi kullanarak CREATE/UPDATE kaynağında doğrulama.

FHIR için Azure API her zaman $validate işleminin doğrulama sonuçları olarak bir OperationOutcome döndürür. FHIR için Azure API hizmeti, bir kaynak $validate uç noktasına geçirildikten sonra iki adımlı doğrulama yapar. İlk adım, kaynağın ayrıştırılabilmesini sağlamak için temel bir doğrulamadır. Kaynak ayrıştırma sırasında, sonraki adıma geçmeden önce tek tek hataların düzeltilmesi gerekir. Kaynak başarıyla ayrıştırıldıktan sonra, tam doğrulama ikinci adım olarak gerçekleştirilen.

Var olan bir kaynağı doğrulama

Mevcut bir kaynağı doğrulamak için bir istekte GET kullanın$validate:

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

Örneğin:

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

Bu örnekte, mevcut Hasta kaynağını temel Hasta kaynağıyla a6e11662-def8-4dde-9ebc-4429e68d130e doğrulaıyorsunuz. Geçerliyse aşağıdaki kod örneğini alırsınız OperationOutcome :

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

Kaynak geçerli değilse, bir hata kodu ve kaynağın neden geçersiz olduğuna ilişkin ayrıntıları içeren bir hata iletisi alırsınız. Hata iletileriyle bir örnek OperationOutcome döndürülür ve aşağıdaki kod örneği gibi görünebilir:

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

Bu örnekte, kaynak sağlanan Hasta profiline uymadı ve bu da hasta tanımlayıcı değeri ve cinsiyet gerektiriyordu.

Parametre olarak bir profil belirtmek isterseniz, doğrulanması gereken profilin kurallı URL'sini belirtebilirsiniz; örneğin, için HL7 temel profili heartrateiçin aşağıdaki örnek:

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

Yeni kaynağı doğrulama

FHIR için Azure API'sine yüklediğiniz yeni bir kaynağı doğrulamak isterseniz bir POST istekte bulunabilirsiniz: Sonuç olarak sunucu her zaman bir OperationOutcome döndürür.

POST http://<your Azure API for FHIR base URL>/{Resource}/$validate

Örneğin:

POST https://myAzureAPIforFHIR.azurehealthcareapis.com/Patient/$validate

Bu istek kaynağı doğrular. FHIR hizmetinde doğrulama kaynakları oluşturulmazsa, kaynak oluşturmak için $validate olmadan bir POST isteği göndermeniz gerekir.

Üst bilgi kullanarak CREATE/UPDATE kaynağında doğrulama.

Varsayılan olarak, FHIR için Azure API kaynağında Create/Updatedoğrulamayı geri çevirecek şekilde yapılandırılır. Bu özellik, üst bilgiyi kullanarak üzerinde Create/Updatedoğrulamaya x-ms-profile-validation olanak tanır. Doğrulama için 'x-ms-profile-validation' değerini true olarak ayarlayın.

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

Sonraki adımlar

Bu makalede, kullanarak kaynakları profillere karşı doğrulamayı öğrendiniz $validate. FHIR için Azure API'sinin desteklenen diğer özellikleri hakkında bilgi edinmek için bkz.

FHIR®, HL7'nin tescilli ticari markasıdır ve HL7'nin izniyle kullanılır.