Общие сведения о $convert-data
Примечание
Ресурсы быстрого взаимодействия в сфере здравоохранения (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
см. в разделе
Сведения о часто задаваемых вопросах $convert-data
см. в разделе
FHIR® является зарегистрированным товарным знаком Health Level Seven International, зарегистрированным в Управлении товарных знаков США и используется с их разрешения.