Introducción a los datos de $convert
Nota
Fast Healthcare Interoperability Resources (FHIR®) es una especificación de asistencia sanitaria abierta.
Mediante el uso de la $convert-data
operación en el servicio FHIR, puede convertir datos de estado de varios formatos a datos de FHIR R4 . La $convert-data
operación usa plantillas Liquid del proyecto de convertidor de FHIR para la conversión de datos de FHIR. Estas plantillas de conversión se pueden personalizar según sea necesario. Actualmente, la $convert-data
operación admite cuatro tipos de conversión de datos:
- HL7v2 a FHIR R4
- C-CDA a FHIR R4
- JSON a FHIR R4 (diseñado para asignaciones de conversión personalizadas)
- FHIR STU3 a FHIR R4
Nota
Puede usar el $convert-data
punto de conexión como componente dentro de una canalización ETL (extracción, transformación y carga) para la conversión de datos de mantenimiento de varios formatos (por ejemplo: HL7v2, CCDA, JSON y FHIR STU3) en el formato FHIR. Puede crear una canalización de ETL para un flujo de trabajo completo a medida que convierte los datos de mantenimiento. Se recomienda usar un motor ETL basado en Azure Logic Apps o Azure Data Factory. Por ejemplo, un flujo de trabajo podría incluir: ingesta de datos, realización de $convert-data
operaciones, validación, procesamiento previo o posterior de datos, enriquecimiento de datos, desduplicación de datos y carga de los datos para la persistencia en el servicio FHIR.
Uso del punto de conexión $convert-data
La $convert-data
operación se integra en el servicio FHIR como una acción de LA API REST. Puede llamar al punto de conexión de la $convert-data
siguiente manera:
POST {{fhirurl}}/$convert-data
Los datos de mantenimiento para la conversión se entregan al servicio FHIR en el cuerpo de la $convert-data
solicitud. Si la solicitud se realiza correctamente, el servicio FHIR devuelve una respuesta de agrupación de FHIR con los datos convertidos a FHIR R4.
Parámetros
Una $convert-data
llamada de operación empaqueta los datos de mantenimiento para la conversión dentro de parámetros con formato JSON en el cuerpo de la solicitud. Los parámetros se describen en la tabla siguiente:
Nombre de parámetro | Descripción | Valores aceptados |
---|---|---|
inputData | Carga de datos que se va a convertir en FHIR. | Para Hl7v2 : cadenaPara Ccda : XMLPara Json : JSONPara FHIR STU3 : JSON |
inputDataType | Tipo de entrada de datos. | Hl7v2 , Ccda , Json , Fhir |
templateCollectionReference | Referencia a una colección de plantillas de imagen de OCI en Azure Container Registry. La referencia es a una imagen que contiene plantillas liquid que se usarán para la conversión. Puede hacer referencia a plantillas predeterminadas o a una imagen de plantilla personalizada registrada en el servicio FHIR. En las secciones siguientes se explica cómo personalizar las plantillas, hospedarlas en Azure Container Registry y registrarse en el servicio FHIR. | Para las plantillas predeterminadas o de ejemplo : Plantillas de HL7v2 : microsofthealth/fhirconverter:default microsofthealth/hl7v2templates:default Plantillas de C-CDA: microsofthealth/ccdatemplates:default Plantillas JSON: microsofthealth/jsontemplates:default Plantillas de FHIR STU3 : microsofthealth/stu3tor4templates:default Para plantillas personalizadas : <RegistryServer>/<imageName>@<imageDigest> , <RegistryServer>/<imageName>:<imageTag> |
rootTemplate | La plantilla raíz que se usa al transformar los datos. | Para 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 Para C-CDA: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Para JSON: ExamplePatient, Stu3ChargeItem Para FHIR STU3: Nombre del recurso STU3 de FHIR (por ejemplo: Paciente, Observación, Organización) |
Nota
Las plantillas de FHIR STU3 a FHIR R4 son plantillas liquid que proporcionan asignaciones de diferencias de campo solo entre un recurso de FHIR STU3 y su recurso equivalente en la especificación de FHIR R4. Algunos de los recursos de FHIR STU3 se cambian de nombre o se quitan de FHIR R4. Para obtener más información sobre las diferencias y restricciones de recursos para la conversión de FHIR STU3 a FHIR R4, consulte Diferencias de recursos y restricciones para la conversión de FHIR STU3 a FHIR R4.
Nota
Las plantillas JSON son plantillas de ejemplo para su uso en la creación de asignaciones de conversión propias. No son plantillas predeterminadas que se adhieren a los tipos de mensajes de datos de mantenimiento predefinidos. El propio JSON no se especifica como un formato de datos de mantenimiento, a diferencia de HL7v2 o C-CDA. Por lo tanto, en lugar de proporcionar plantillas JSON predeterminadas, proporcionamos algunas plantillas JSON de ejemplo que puede usar como punto de partida para sus propias asignaciones personalizadas.
Advertencia
Las plantillas predeterminadas se publican en la licencia MIT y no son compatibles con Soporte técnico de Microsoft.
Las plantillas predeterminadas solo se proporcionan para ayudarle a empezar a trabajar con el flujo de trabajo de conversión de datos. Estas plantillas predeterminadas no están pensadas para producción y pueden cambiar cuando Microsoft publica actualizaciones para el servicio FHIR. Para tener un comportamiento coherente de conversión de datos en diferentes versiones del servicio FHIR, debe hacer lo siguiente:
- Hospede su propia copia de las plantillas en una instancia de Azure Container Registry.
- Registre las plantillas en el servicio FHIR.
- Use las plantillas registradas en las llamadas API.
- Compruebe que el comportamiento de conversión cumple sus requisitos.
Para obtener más información sobre cómo hospedar sus propias plantillas, consulte Hospedaje de plantillas propias.
Solicitud de ejemplo
{
"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"
}
]
}
Respuesta de muestra
{
"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"
}
}
]
}
El resultado de la conversión de FHIR es un lote de FHIR como lote.
- El lote de FHIR debe alinearse con las expectativas de la especificación de FHIR R4 : paquete - FHIR v4.0.1.
- Si está intentando validar con un perfil específico, debe realizar algún procesamiento posterior mediante la operación FHIR
$validate
.
Pasos siguientes
En este artículo, ha obtenido información sobre la $convert-data
operación y cómo usar el punto de conexión para convertir los datos de mantenimiento en FHIR R4 mediante el servicio FHIR en Azure Health Data Service.
Para obtener información sobre cómo configurar las opciones para $convert-data
usar el Azure Portal, consulte
Para obtener información sobre cómo solucionar problemas $convert-data
, consulte
Para obtener información sobre las preguntas más frecuentes (P+F) de $convert-data
, consulte .
FHIR® es una marca registrada de Health Level Seven International, registrada en la Oficina de Patentes y Marcas Registradas de Estados Unidos, y se usa con su permiso.