Configurar asignaciones de atributos
Nota
El administrador de sincronización para FHIR ahora ha sido renombrado como kit de herramientas de integración de datos.
El kit de herramientas de integración de datos incluye asignaciones predeterminadas creadas para cumplir con la especificación HL7 FHIR. Sin embargo, tanto las asignaciones de entidades como de atributos se implementan como registros de Dataverse y son altamente configurables para adaptarse a los diversos requisitos de su solución.
Para obtener más información sobre las asignaciones de atributos, vaya a Descripción general de las asignaciones de atributos.
Propina
Puede usar la opción Exportar a Excel en la barra de comandos para exportar la información de las asignaciones a un archivo de Excel. Para obtener más información sobre la exportación de datos desde su aplicación a un archivo de Excel, vaya a Exportar datos a Excel.
Campos de asignaciones de atributos
Las asignaciones de atributos proporcionan el nodo FHIR para la asignación de nivel de campo de Dataverse. Necesitan tener en cuenta varios tipos de datos diferentes.
| Nombre de campo | Descripción |
|---|---|
| Deshabilitar | Marca que indica si la asignación de atributos está deshabilitada. Si el valor se establece en True, la Dataverse Healthcare API omite la asignación de atributos al procesar un recurso FHIR para la asignación de entidad relacionada. |
| Atributo obligatorio de FHIR | Cuando la reescritura está habilitada, este indicador indica si se requiere el atributo al enviar datos al servidor FHIR. |
| Asignación de entidad del servicio de actualización | Busque en la asignación de la entidad principal para la asignación de atributos. |
| Nombre de entidad | El nombre de esquema de la tabla de Dataverse para la asignación de entidad principal. |
| Nombre del atributo | El nombre de esquema de la columna de Dataverse a la que se asignarían los valores FHIR. Esta lista cambia según la selección de la asignación de entidades. |
| Tipo de acción | El tipo de asignación de valor que se produce para el atributo. En la siguiente sección se enumeran los diferentes valores del tipo de acción: Copiar datos: Copia directa de los datos sin ningún tipo de transformación. Este tipo de acción se usa principalmente cuando el tipo de datos en ambos sistemas coincide. Establecer valor predeterminado: establezca siempre un valor predeterminado en CDS. Este tipo de acción es útil cuando se necesita el atributo pero no existe en el sistema de origen. Valor asignado: transformación y asignación de datos. Este tipo de acción se usa mejor cuando los tipos de datos no coinciden, como con opciones de Dataverse u opciones Sí o No. Búsqueda: asigna referencias FHIR a valores de búsqueda de Dataverse. Codeable Concept: asigna un nodo de codificación FHIR a una búsqueda de codeable concept en Dataverse. Expandir: asigna un nodo FHIR del tipo matriz a una tabla de expansión relacionada. |
| Tipo de elemento de FHIR | Valor que indica el tipo de datos del elemento en el mensaje FHIR JSON. |
| Asignación de elemento de FHIR | Campo que contiene la consulta JSONPath para el nodo FHIR específico. Incluye instrucciones sobre cómo recuperar el valor entrante y cómo estructurar el valor saliente para reescritura. Para obtener más información sobre este campo, vaya a Asignación de elementos FHIR. |
| Asignación de entidad de expansión | Cuando selecciona Expandir como el Tipo de acción, este valor es una búsqueda de la asignación de entidad relacionada del tipo Expansión. Para obtener más información sobre las asignaciones de expansión, vaya a Configurar asignaciones de expansión. |
| Se ha utilizado en la coincidencia de registros | Para asignaciones de atributos relacionadas con asignaciones de entidades de expansión, este campo indica si el campo de Dataverse es una clave o es parte de una clave compuesta que identifica de manera única el registro enviado a Dataverse. Para más información, vaya a Se ha utilizado en la coincidencia de registros. |
Mapa de elemento de FHIR
Las definiciones de asignación de atributos de entidad en Microsoft Dataverse contienen un campo Asignación de elemento de FHIR. Este campo define cómo recuperar y enviar valores entre el servicio FHIR de Azure Health Data Services y los extremos habilitados para FHIR.
Estas definiciones de asignación están contenidas en un objeto JSON serializado con entradas para admitir la selección de JSONPath para recuperar y actualizar los valores de propiedad existentes. También incluye definiciones para insertar nuevos valores de propiedad que aún no existen en la plataforma receptora.
Definición de objeto JSON
{
"s": "",
"c": {
"p": "",
"a": [
""
]
}
donde
- "s" = una expresión de JSONPath válida utilizada para seleccionar una propiedad JSON existente del recurso FHIR para extraer o establecer valores desde y hacia Dataverse.
- "c" = campos de propiedad JSON utilizados para insertar o crear propiedades JSON cuando la ruta seleccionada no existe en el objeto JSON del recurso.
- "p" = El nombre de la propiedad JSON principal que se va a crear.
- "a" = matriz de atributos para establecer en la propiedad JSON seleccionada.
Para obtener más detalles y ejemplos de configuración de asignaciones de atributos, vaya a Ejemplos de asignaciones de atributos.
Se ha utilizado en la coincidencia de registros
Debido a que las matrices secundarias en los mensajes FHIR JSON no contienen identificadores únicos, como los recursos FHIR de nivel raíz, las Dataverse Healthcare APIs, el proceso de reescritura y las tablas de datos de salud virtual requieren otros criterios para garantizar que se creen los valores correctos y actualizados. El campo Se ha utilizado en la coincidencia de registros le permite identificar qué atributo de la asignación de expansión debe usarse para señalar la unicidad. Esto es importante para las asignaciones de expansión y para mantener la integridad de los datos al actualizar los registros de Dataverse.
Para que el valor Se ha utilizado en la coincidencia de registros se establezca en True, debe tener al menos una asignación de atributos para una asignación de entidad de expansión. Si más de una asignación de atributos tiene este campo marcado como True, la lista combinada de asignaciones de atributos proporciona una clave compuesta al crear y actualizar nuevos registros de nivel de expansión.
Nota
La modificación de este valor de campo después de que un sistema esté activo en producción puede causar problemas de corrupción de datos al modificar registros existentes. Asegúrese de que su equipo de interoperabilidad revise esto antes de realizar cualquier cambio.
Administrar registros de asignaciones de atributos
Las siguientes secciones enumeran algunos pasos comunes para configurar y administrar asignaciones de atributos. Para obtener ejemplos detallados, vaya a Ejemplos de asignaciones de atributos.
Agregar un mapa de atributos a un mapa de entidades
Abra el mapa de la entidad.
Sobre la pestaña General, bajo Mapas de atributos relacionados, seleccione +Nuevo mapa de atributos del servicio de actualización.
Deshabilitar una asignación de atributos
Si no necesita un mapa de atributos para una entidad que se incluye con los mapas predeterminados del kit de herramientas de integración de datos, puede deshabilitarlo. Por ejemplo, para la entidad de consulta o examen, es posible que no necesite tener el atributo a nombre de sincronizado y almacenado en el sistema de EMR.
En Configuración de mapa, seleccione Asignaciones de atributo.
Seleccione la entidad msemr_encounter y luego seleccione Editar.
En Mapas de atributos relacionados, seleccione msemr_onbehalfof y luego seleccione Editar.
Establezca el valor de Deshabilitado en Sí.
Seleccione Guardar.
Archivar un mapa de atributos
Puede deshabilitar cualquier asignación de atributos, pero seguirá apareciendo en la vista Asignaciones de atributos del servicio de actualización activa. Para eliminar una asignación de atributos de esta vista, puede archivar la asignación de atributos.
Abra el mapa de la entidad.
En la pestaña General, en Mapas de atributos relacionados, seleccione el mapa de atributos.
En el encabezado de la vista Mapas de atributos del servicio de actualización activa, seleccione Archivo.
Ver mapas de atributos archivados
Abra el mapa de la entidad.
En la pestaña General, bajo Mapas de atributos relacionados, seleccione Mapas de atributos del servicio de actualización activa y luego seleccione Mapas de atributos del servicio de actualización archivados.
Crear una asignación de atributo de servicio
La entidad Contacto en Dataverse se asigna al recurso Paciente en FHIR en Azure. Puede agregar asignaciones de atributos a un mapa de entidades.
En Configuración del mapa, seleccione Mapas de entidades.
En la lista de entidades, seleccione el Contacto que se asigna Paciente en los recursos de FHIR y, a continuación, seleccione Editar.
En Asignaciones de atributos relacionados, seleccione +Nueva asignación de atributos del servicio de actualización.
Establezca el valor de Atributo requerido de FHIR en No.
Esta configuración indica cómo regresan los datos al extremo de FHIR configurado. Cuando se produce un cambio en Dataverse para este paciente y Atributo requerido FHIR se establece en Sí, si el usuario no ha completado el atributo, el cambio de Dataverse se guarda en Dataverse, pero no se publica en el extremo de FHIR. El evento se escribe en los registros.
Para Nombre de atributo, seleccione Nombre de pila (firstname).
Para Tipo de acción, seleccione Copiar datos. Este valor significa que los datos de la cadena de un sistema se copian en el otro.
Para Asignación de elementos de FHIR, agregue la cadena de búsqueda JSON que funciona con la API de FHIR. Por ejemplo, puede agregar una cadena de búsqueda JSON que le permita llegar al elemento FHIR que es nombre de pila.
Seleccione Guardar. La sección Mapas de valor ahora se muestra en la misma ventana con la opción + Nuevo mapa de valor de atributo . La entidad de Contacto no requiere un mapa de valores porque es una cadena.
En la asignación de entidades de Contacto, en Asignaciones de atributos relacionados, ahora puede ver la asignación de atributos con el nombre firstname.
Consulte también
¿Qué es Microsoft Cloud for Healthcare?
Descripción general del kit de herramientas de integración de datos
Administrar datos FHIR con el kit de herramientas de integración de datos
Configurar asignaciones de entidades
Configurar asignaciones de expansión
Asignaciones del kit de herramientas de integración de datos: ejemplos y casos de uso