Doğrulama İşlemi : Genel Bakış

Makale
02/06/2024

Önemli

FHIR İçin Azure API'si 30 Eylül 2026 tarihinde kullanımdan kaldırılacaktır. Bu tarihe kadar Azure Health Data Services FHIR hizmetine geçiş yapmak için geçiş stratejilerini izleyin. FHIR İçin Azure API'sinin kullanımdan kaldırılması nedeniyle 1 Nisan 2025 tarihinden itibaren yeni dağıtımlara izin verilmeyecektir. Azure Health Data Services FHIR hizmeti , müşterilerin FHIR, DICOM ve MedTech hizmetlerini diğer Azure hizmetleriyle tümleştirmelerle yönetmesine olanak tanıyan FHIR için Azure API'sinin gelişmiş sürümüdür.

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.

Not

Doğrulama için kullanılacak tüm değer kümeleri FHIR sunucusuna yüklenmelidir. Bu, FHIR belirtiminin parçası olan tüm Valueset'leri ve Uygulama Kılavuzları'nda tanımlanan Tüm ValueSet'leri içerir. Yalnızca tüm kodların tam listesini içeren tam olarak genişletilmiş Değer Kümeleri desteklenir. Dış kaynaklara başvuran valueSet tanımları desteklenmez.

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.

Not

Açık kaynak FHIR hizmetinde, Sunucu yapılandırma ayarını CoreFeatures altında değiştirebilirsiniz.

{
   "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 için Azure API desteklenen özellikler

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

Aracılığıyla paylaş