Общие сведения о $convert-data

Статья
08/03/2023

Примечание

Ресурсы быстрого взаимодействия в сфере здравоохранения (FHIR®) — это открытая спецификация для здравоохранения.

С помощью $convert-data операции в службе FHIR можно преобразовать данные о работоспособности из различных форматов в данные FHIR R4 . Операция $convert-data использует шаблоны Liquid из проекта FHIR Converter для преобразования данных FHIR. Вы можете изменить эти шаблоны в соответствии с конкретными потребностями. В настоящее $convert-data время операция поддерживает четыре типа преобразования данных:

HL7v2 — FHIR R4
C-CDA в FHIR R4
JSON в FHIR R4 (предназначен для пользовательских сопоставлений преобразования)
FHIR STU3 — FHIR R4

Примечание

Конечную точку $convert-data можно использовать в качестве компонента в конвейере извлечения, преобразования и загрузки для преобразования данных о работоспособности из различных форматов (например, HL7v2, CCDA, JSON и FHIR STU3) в формат FHIR. Вы можете создать конвейер ETL для полного рабочего процесса при преобразовании данных о работоспособности. Рекомендуется использовать подсистему ETL на основе Azure Logic Apps или Фабрика данных Azure. Например, рабочий процесс может включать прием данных, выполнение $convert-data операций, проверку, предварительную и постобработку данных, обогащение данных, дедупликацию данных и загрузку данных для сохранения в службе FHIR.

Использование конечной точки $convert-data

Операция $convert-data интегрирована в службу FHIR как действие REST API. Конечную точку $convert-data можно вызвать следующим образом:

POST {{fhirurl}}/$convert-data

Данные о работоспособности для преобразования доставляются в службу FHIR в тексте $convert-data запроса. Если запрос выполнен успешно, служба FHIR возвращает ответ пакета FHIR с данными, преобразованными в FHIR R4.

Параметры

Вызов $convert-data операции упаковывал данные о работоспособности для преобразования в параметры в формате JSON в тексте запроса. Параметры описаны в следующей таблице.

Имя параметра	Описание	Допустимые значения
inputData	Полезные данные для преобразования в FHIR.	Для `Hl7v2`: string Для `Ccda`: XML Для `Json`: JSON Для `FHIR STU3`: JSON
inputDataType	Тип входных данных.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Ссылка на коллекцию шаблонов изображений OCI в Реестр контейнеров Azure. Ссылка на изображение, содержащее шаблоны Liquid для преобразования. Он может ссылаться либо на шаблоны по умолчанию, либо на пользовательский образ шаблона, зарегистрированный в службе FHIR. В следующих разделах рассматривается настройка шаблонов, их размещение на Реестр контейнеров Azure и регистрация в службе FHIR.	Для шаблонов по умолчанию или примеров : Шаблоны HL7v2 : `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` Шаблоны C-CDA: `microsofthealth/ccdatemplates:default` Шаблоны JSON: `microsofthealth/jsontemplates:default` Шаблоны FHIR STU3: `microsofthealth/stu3tor4templates:default` Для пользовательских шаблонов: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	Корневой шаблон, используемый при преобразовании данных.	Для HL7v2: 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: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Для JSON: ExamplePatient, Stu3ChargeItem Для FHIR STU3: Имя ресурса FHIR STU3 (например, "Пациент", "Наблюдение", "Организация")

Примечание

Шаблоны FHIR STU3 и FHIR R4 — это шаблоны Liquid, которые предоставляют сопоставления различий полей только между ресурсом FHIR STU3 и его эквивалентным ресурсом в спецификации FHIR R4. Некоторые ресурсы FHIR STU3 переименованы или удалены из FHIR R4. Дополнительные сведения о различиях и ограничениях ресурсов для преобразования FHIR STU3 в FHIR R4 см. в статье Различия и ограничения ресурсов для преобразования FHIR STU3 в FHIR R4.

Примечание

Шаблоны JSON — это примеры шаблонов для использования при создании собственных сопоставлений преобразования. Они не являются шаблонами по умолчанию, которые соответствуют любым предварительно определенным типам сообщений о работоспособности. В отличие от HL7v2 или C-CDA сам json не указывается в качестве формата данных о работоспособности. Поэтому вместо предоставления шаблонов JSON по умолчанию мы предоставляем некоторые примеры шаблонов JSON, которые можно использовать в качестве отправной точки для собственных настраиваемых сопоставлений.

Предупреждение

Шаблоны по умолчанию выпускаются в соответствии с лицензией MIT и не поддерживаются служба поддержки Майкрософт.

Шаблоны по умолчанию предоставляются только для того, чтобы приступить к работе с рабочим процессом преобразования данных. Эти шаблоны по умолчанию не предназначены для рабочей среды и могут измениться, когда корпорация Майкрософт выпускает обновления для службы FHIR. Чтобы обеспечить согласованное преобразование данных в разных версиях службы FHIR, необходимо выполнить следующие действия.

Разместите собственную копию шаблонов в экземпляре Реестр контейнеров Azure.
Зарегистрируйте шаблоны в службе FHIR.
Используйте зарегистрированные шаблоны в вызовах API.
Убедитесь, что поведение преобразования соответствует вашим требованиям.

Дополнительные сведения о размещении собственных шаблонов см. в статье Размещение собственных шаблонов.

Пример запроса

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

Пример ответа

{
    "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 является пакет FHIR в виде пакета.

Пакет FHIR должен соответствовать ожиданиям спецификации FHIR R4 — Пакет — FHIR версии 4.0.1.
Если вы пытаетесь выполнить проверку на соответствие определенному профилю, необходимо выполнить некоторую постобработку, используя операцию FHIR $validate .

Дальнейшие действия

Из этой статьи вы узнали об $convert-data операции и о том, как использовать конечную точку для преобразования данных о работоспособности в FHIR R4 с помощью службы FHIR в службе данных о работоспособности Azure.

Сведения о настройке параметров для $convert-data использования портал Azure см. в статье.

Настройка параметров для $convert-data с помощью портал Azure

Сведения об устранении неполадок $convert-dataсм. в разделе

Устранение неполадок $convert-data

Сведения о часто задаваемых вопросах $convert-dataсм. в разделе

Часто задаваемые вопросы о $convert-data

FHIR® является зарегистрированным товарным знаком Health Level Seven International, зарегистрированным в Управлении товарных знаков США и используется с их разрешения.

Общие сведения о $convert-data

Использование конечной точки $convert-data

Параметры

Пример запроса

Пример ответа

Дальнейшие действия

Дополнительные ресурсы