Introducción a los datos de $convert

Artículo
09/07/2023

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`: cadena Para `Ccda`: XML Para `Json`: JSON Para `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

Configuración de los valores de $convert-data mediante el Azure Portal

Para obtener información sobre cómo solucionar problemas $convert-data, consulte

Solución de problemas de $convert-data

Para obtener información sobre las preguntas más frecuentes (P+F) de $convert-data, consulte .

Preguntas más frecuentes sobre los datos de $convert

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.

Introducción a los datos de $convert

Uso del punto de conexión $convert-data

Parámetros

Solicitud de ejemplo

Respuesta de muestra

Pasos siguientes

Recursos adicionales