FHIR hizmetinde verileri $convert

Makale
05/17/2024

Not

Mayıs 2024'te FHIR® hizmetinden ayrılmış ve önizleme için kapsayıcı (Docker) görüntüsü olarak paketlenmiş tek başına bir FHIR dönüştürücü API'sini yayımladık. FHIR dönüştürücüsü, kayıt kaynağındaki verileri FHIR R4 paketlerine dönüştürmenize ek olarak aşağıdakiler gibi birçok net yeni özellik sunar:

Kayıt kaynağından FHIR R4 paketlerine ve geri çift yönlü veri dönüştürme. Örneğin, FHIR dönüştürücüsü verileri FHIR R4 biçiminden HL7v2 biçimine geri dönüştürebilir.
Varsayılan Liquid şablonlarının özelleştirilmesi için geliştirilmiş deneyim.
Azure Data Factory (ADF) ile ETL (ayıklama, dönüştürme, yükleme) işlem hattı oluşturmayı gösteren örnekler.

FHIR dönüştürücü kapsayıcı görüntüsünü uygulamak için bkz . FHIR dönüştürücü GitHub projesi.

$convert-data FHIR® hizmetindeki işlem, sistem durumu verilerini çeşitli biçimlerden FHIR R4 verilerine dönüştürmenizi sağlar. İşlem, $convert-data FHIR veri dönüştürmesi için FHIR Dönüştürücü projesinden Liquid şablonlarını kullanır. Bu dönüştürme şablonlarını gerektiği gibi özelleştirebilirsiniz.

İşlem $convert-data dört veri dönüştürme türünü destekler:

HL7v2 - FHIR R4
C-CDA - FHIR R4
JSON - FHIR R4 (özel dönüştürme eşlemeleri için tasarlanmıştır)
FHIR STU3 - FHIR R4

$convert-data uç noktasını kullanma

$convert-data Çeşitli biçimlerdeki (örneğin: HL7v2, CCDA, JSON ve FHIR STU3) sistem durumu verileriniN FHIR biçimine dönüştürülmesi için uç noktayı ETL (ayıklama, dönüştürme ve yükleme) işlem hattı içinde bileşen olarak kullanın. Sistem durumu verilerinizi dönüştürürken eksiksiz bir iş akışı için bir ETL işlem hattı oluşturun. Azure Logic Apps veya Azure Data Factory tabanlı bir ETL altyapısı kullanmanızı öneririz. Örneğin, bir iş akışı veri alımını, işlem gerçekleştirmeyi$convert-data, doğrulamayı, veri ön ve son işlemeyi, veri zenginleştirmeyi, yinelenen verileri kaldırmayı ve FHIR hizmetinde kalıcılık için verileri yüklemeyi içerebilir.

İşlem $convert-data , REST API eylemi olarak FHIR hizmetiyle tümleştirilir. Uç noktayı şu şekilde çağırabilirsiniz $convert-data :

POST {{fhirurl}}/$convert-data

Dönüştürme için sistem durumu verileri, isteğin gövdesindeki $convert-data FHIR hizmetine teslim edilir. İstek başarılı olursa, FHIR hizmeti verilerin FHIR R4'e dönüştürüldüğü bir FHIR paket yanıtı döndürür.

Parametreler

İşlem $convert-data çağrısı, isteğin gövdesindeki JSON biçimli parametrelerin içinde dönüştürme için sistem durumu verilerini paketler. Parametreler aşağıdaki tabloda açıklanmıştır.

Parametre adı	Açıklama	Kabul edilen değerler
inputData	FHIR'ye dönüştürülecek veri yükü.	için `Hl7v2`: dize için `Ccda`: XML için `Json`: JSON için `FHIR STU3`: JSON
inputDataType	Veri girişi türü.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Azure Container Registry'de bir OCI görüntü şablonu koleksiyonuna başvuru. Başvuru, dönüştürme için kullanılacak Liquid şablonları içeren bir görüntüye yöneliktir. Varsayılan şablonlara veya FHIR hizmetinde kayıtlı özel bir şablon görüntüsüne başvurabilir. Aşağıdaki bölümlerde şablonları özelleştirme, Azure Container Registry'de barındırma ve FHIR hizmetine kaydolma konuları ele alınıyor.	Varsayılan/örnek şablonlar için: HL7v2 şablonları: `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` C-CDA şablonları: `microsofthealth/ccdatemplates:default` JSON şablonları: `microsofthealth/jsontemplates:default` FHIR STU3 şablonları: `microsofthealth/stu3tor4templates:default` Özel şablonlar için: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	Verileri dönüştürürken kullanılacak kök şablon.	HL7v2 için: ADT_A01, ADT_A02, ADT_A03, ADT_A04, ADT_A05, ADT_A08, ADT_A11, ADT_A13, ADT_A14, ADT_A15, ADT_A16, ADT_A25, ADT_A26, ADT_A27, ADT_A28, ADT_A29, ADT_A31, ADT_A47, ADT_A60, OML_O21, ORU_R01, ORM_O01, VXU_V04, SIU_S12, SIU_S13, SIU_S14, SIU_S15, SIU_S16, SIU_S17, SIU_S26, MDM_T01 MDM_T02 C-CDA için: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperatifNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary JSON için: ExamplePatient, Stu3ChargeItem FHIR STU3 için: FHIR STU3 kaynak adı (örneğin: Hasta, Gözlem, Kuruluş)

Dikkat edilmesi gereken noktalar

FHIR STU3 - FHIR R4 şablonları, yalnızca FHIR STU3 kaynağı ile FHIR R4 belirtimindeki eşdeğer kaynağı arasındaki alan farklarının eşlemelerini sağlayan Liquid şablonlarıdır . FHIR STU3 kaynaklarından bazıları yeniden adlandırılır veya FHIR R4'ten kaldırılır. FHIR STU3'den FHIR R4'e dönüştürme için kaynak farklılıkları ve kısıtlamaları hakkında daha fazla bilgi için bkz . FHIR STU3'den FHIR R4'e dönüştürme için kaynak farklılıkları ve kısıtlamaları.
JSON şablonları, kendi dönüştürme eşlemelerinizi oluştururken kullanılan örnek şablonlardır. Bunlar, önceden tanımlanmış sistem durumu veri ileti türlerine bağlı olan varsayılan şablonlar değildir. JSON, HL7v2 veya C-CDA'nın aksine sistem durumu veri biçimi olarak belirtilmez. Sonuç olarak, varsayılan JSON şablonları sağlamak yerine, kendi özelleştirilmiş eşlemeleriniz için başlangıç noktası olarak bazı örnek JSON şablonları sağlarız.

Uyarı

Varsayılan şablonlar MIT Lisansı altında yayınlanmaktadır ve Microsoft tarafından desteklenmez.

Varsayılan şablonlar yalnızca veri dönüştürme iş akışınızı kullanmaya başlamanıza yardımcı olmak için sağlanır. Bu varsayılan şablonlar üretim için tasarlanmamıştır ve Microsoft FHIR hizmeti için güncelleştirmeler yayımladığında değişebilir. FHIR hizmetinin farklı sürümlerinde tutarlı veri dönüştürme davranışına sahip olmak için aşağıdakileri yapmanız gerekir:

Şablonların kendi kopyasını bir Azure Container Registry örneğinde barındırın.
Şablonları FHIR hizmetine kaydedin.
KAYıTLı şablonlarınızı API çağrılarınızda kullanın.
Dönüştürme davranışının gereksinimlerinizi karşıladığını doğrulayın.

Kendi şablonlarınızı barındırma hakkında daha fazla bilgi için bkz . Kendi şablonlarınızı barındırma

Örnek isteği

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

Örnek yanıt

{
    "resourceType": "Bundle",
    "type": "batch",
    "entry": [
        {
            "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
            "resource": {
                "resourceType": "Patient",
                "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
          ...
          ...
            },
            "request": {
                "method": "PUT",
                "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
            }
        }
    ]
}

FHIR dönüştürmesinin sonucu, toplu iş olarak bir FHIR paketidir.

FHIR paketi, FHIR R4 belirtiminin beklentileriyle uyumlu olmalıdır - Paket - FHIR v4.0.1.
Belirli bir profilde doğrulamaya çalışıyorsanız, FHIR $validate işlemini kullanarak işlem sonrası işlem yapmanız gerekir.

Sonraki adımlar

Azure portalını kullanarak $convert veri ayarlarını yapılandırma

$convert-data sorunlarını giderme

$convert-data hakkında SSS

Not

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

Aracılığıyla paylaş