Introducción
El Patient Track, dentro de CENS Tech Connect 2020, esta orientado a utilizar el recurso Patient de HL7 FHIR, en un nivel básico e intermedio.
Justificación
El Track Patient se ha realizado en todas las connectathones que ha realizado HL7 FHIR[1], esto es debido a lo amigable y transversal que es el track. Junto a esto se suma la facilidad y simplicidad de manipulación y trabajo, ya que lo pueden trabajar desde usuarios que se están iniciando en este estándar, como también usuarios que posean un nivel mas avanzado y/o quienes ya se encuentran trabajando con el recurso Patient en algún desarrollo propio y desean probar sus sistemas contra las plataformas de prueba. Por lo tanto, lo versátil y atractivo de este Track es que lo hace apto para ser ejecutado por participantes desde nivel básico hasta avanzado.
Niveles
Nivel Básico
En este nivel se espera que los participantes logren familiarizarse con FHIR y puedan realizar operaciones CRUD con el recurso "Patient". Todo esto, a través de escenarios simples y operaciones básicas realizadas sobre el recurso "Patient". Adicionalmente, se recomienda a los usuarios que puedan comenzar a familiarizarse y trabajar de manera previa, revisando el recurso Patient y si se animan, probar con servidores FHIR públicos para pruebas
Nivel Medio
En este nivel se espera que los participantes, además de dominar el nivel básico, sean capaces realizar operaciones CRUD, búsquedas avanzada y relacionarlas con otros recursos en caso de ser necesario.
Participantes esperados
Nivel Básico
- Participantes que han oído hablar o conocen de manera muy superficial HL7 FHIR, pero desean ahondar un poco mas en el tema, logrando interactuar un poco mas con FHIR.
- Participantes con alto interés en trabajar con el recurso “Patient”
- Participantes que deseen probar sus sistemas o aplicaciones que utilicen el estándar HL7 FHIR y utilicen específicamente el recurso "Patient"
Nivel Medio
- Participantes que desean profundizar en operaciones CRUD y búsquedas avanzadas y relacionadas con el recurso "Patient".
- Participantes que deseen realizar operaciones avanzadas con el recurso "Patient".
- Participantes que deseen probar sus sistemas o aplicaciones que utilicen el estándar HL7 FHIR y utilicen específicamente el recurso "Patient"
Ejercicios
Nivel básico - Introducción - Participantes con nivel básico o medio en FHIR
Escenario 1
El Hospital "En buenas manos", en un proceso de constante mejora, ha sido seleccionado por el Ministerio de Salud (MINSAL) de Chile para digitalizar todas las fichas clínicas en papel que actualmente poseen de sus pacientes. Este proceso será gradual y consistirá en capacitaciones al personal que realizará el trabajo, además de monitoreo y supervisión permanente del proceso completo de carga y creación de las fichas clínicas electrónicas. El estándar que se utilizará para realizar la creación y mantención de las fichas clínicas es HL7 FHIR R4, el cual soporta operaciones CRUD. Durante el proceso de inducción, se llevara a cabo la ejecución de un caso de uso, el cual incluirá la carga la carga de datos al sistema de un paciente, búsqueda, modificación, eliminación y reactivación del mismo.
Información del paciente (Caso de uso)
El paciente Daniel Eduardo Moya, RUT 7.777.777-7, Casado, fecha de nacimiento 18 de Noviembre 1959, sexo masculino, domiciliado en Lautaro 85, departamento 23D, Ciudad Linares, Séptima Región del Maule, Chile. Los datos de contacto del paciente son: Telefono casa: +56222222222, Telefono Celular: +56999999999, Correo electrónico correomio@tumejormail.cl. En la ficha clínica aparece como contacto de emergencia su vecina, María Olga Carter, Telefono casa: +56333333333, Telefono Celular: +56888888888, Correo electrónico molgacarter@tumejormail.cl, domiciliada Independencia 765, Ciudad Linares, Séptima Región del Maule, Chile
1.- Creación de un paciente
Se ha comenzado con el proceso de carga de datos al sistema de fichas clínicas electrónicas. Ahora se debe realizar el proceso de creación del Paciente en los registros de la Ficha Clínica Electrónica (FHIR Server), resguardando incluir la información necesaria relacionada con el Paciente. Para identificar el recurso adecuado para este escenario, revisar la pagina de la especificación FHIR Resources.
Acción: Debe crear un nuevo paciente en el servidor FHIR.
Pre-condición: El paciente (recurso) no existe en el servidor FHIR.
Tarea esperada: El paciente (recurso) se crea correctamente en el servidor (Respuesta satisfactoria del servidor FHIR).
Información Adicional
- Para la construcción de datos como identificador, contacto y dirección, entre otros, consulte en Convenciones de formato de datos (Convenciones de formato de datos).
- En la construcción del recurso marque el estado de la ficha como activo.
- Dentro de las operaciones CRUD, para la creación del paciente utilice el método POST.
- Tomar nota del ID del paciente generado por el servidor. Para esto debe volver a abrir el el ejercicio numero 1, y ahí podrá ver el ID que se le asignó a su paciente
2.- Corroborar la información ingresada del paciente
Con el fin de corroborar que los datos ingresados son correctos, ahora es necesario realizar la búsqueda de la información del paciente creado mediante su ID.
Acción: Realizar la búsqueda del paciente que usted creó. Esta búsqueda la debe hacer mediante el ID generado en el ejercicio 1.
Pre-condición: El paciente debe existir en el servidor FHIR.
Tarea esperada: Obtener la información del paciente.
3.- Rectificación de la información del Paciente
Debido a que este ingreso de datos y creación de pacientes es un proceso de entrenamiento, no esta libre de errores y es la idea, aprender. Por esta razón es que ahora se deben modificar los datos de un paciente. Específicamente debe modificar el nombre y RUN del paciente creado en el ejercicio 1, por los siguientes datos:
- Nombre: Pedro Solar
- RUT: 36.785.456-1
Acción: Debe actualizar SOLO los datos del paciente antes mencionados.
Pre-condición: El paciente debe existir en el servidor FHIR (El ID del paciente es el creado en el ejercicio 1).
Tarea esperada: El recurso paciente con la información actualizada.
Información Adicional
- Toda la demás información del paciente debe ser la misma que en el ejercicio 1.
- Recordar que es una actualización, no una creación de un paciente nuevo.
4.- Resguardo de la calidad del dato
Dentro del programa de monitoreo de ingreso de la información, el encargado de calidad de datos de la Ficha Clínica Electrónica del MINSAL, luego de enterarse que se realizó una modificación de la información de un paciente, solicita el historial completo de todas las versiones de la ficha del paciente, para poder revisar que cambios fueron los que se realizaron y si estos se encontraban en orden.
Acción: Buscar la historia completa (todas las versiones del recurso) del paciente creado en el Servidor FHIR. (El ID del paciente es el creado en el ejercicio 1).
Pre-condición: Que el paciente exista y posea al menos una actualización de su información.
Tarea esperada: Obtener el historial todas las versiones y cambios realizados al recurso de la ficha clínica del paciente.
Información Adicional
- Mediante la pantalla de consultas también es posible ver las diferentes versiones de un paciente. (https://app-huemul.cens.cl/request.html)
5.- Buscar un paciente por Nombre y Apellido
Luego de registrar un paciente y buscarlo solo por su nombre o su apellido, la búsqueda nos entrega muchos resultados, razón por la cual se debe realizar una búsqueda por mas de un parámetro, a fin de de evitar el alcance por nombre. Por lo tanto ahora se debe realizar una búsqueda por nombre y apellido a la vez.
Acción: Buscar en el servidor FHIR el paciente Pedro Solar utilizando como criterios de búsqueda el Nombre: Pedro y Apellido: Solar, los dos a la vez.
Pre-condición: El paciente ya esta creado en el servidor FHIR.
Tarea esperada: Obtener la información del Paciente.
Información Adicional
- El nombre y el apellido corresponden a los registrados en el ejercicio 3.
- Para obtener información sobre las búsquedas, visitar https://www.hl7.org/fhir/search.html.
- Se debe buscar por los parámetros de búsqueda específicos para el nombre y apellido.
6.- Borrar un paciente
Debido a que el Hospital se encuentra en un proceso de pruebas, se quiere ver qué sucede si se eliminara accidentalmente el registro de un paciente. Para esta prueba se utilizara el paciente creado en el ejercicio 1.
Acción: Debe borrar el paciente creado en el ejercicio 1 (El ID del paciente a borrar es el creado en el ejercicio 1).
Pre-condición: El paciente debe estar creado en el servidor.
Tarea esperada: El paciente es borrado satisfactoriamente del servidor.
Información Adicional
- Puede verificar el borrado exitoso del paciente, revisándolo en la pantalla de consultas (https://app-huemul.cens.cl/request.html) mediante el ID. El servidor debiera indicar la no existencia de este o que fue borrado.
- En general la información de catálogos maestros relacionados con salud no se elimina, debido que compromete la integridad, seguridad y trazabilidad de los registros asociados. Este ejercicio solamente es válido como aprendizaje del estándar.
7.- Reactivar un paciente
Debido a que el paciente en el ejercicio anterior fue borrado accidentalmente, debe reactivarlo, para que este vuelva a aparecer en el sistema.
Acción: Reactivar el paciente mediante su ID.
Pre-condición: El paciente debe estar previamente eliminado del servidor FHIR.
Tarea esperada: Que el recurso paciente se encuentre activo nuevamente.
Información Adicional
- El ID del paciente, es el obtenido en el ejercicio 1.
- Puede verificar la recuperación del recurso haciendo una búsqueda del paciente mediante su ID asignado (https://app-huemul.cens.cl/request.html).
- El paciente debe contener la misma información que al momento previo de la eliminación.
8.- Buscar un paciente por RUN
A modo de realizar una prueba de sistema, se desea realizar la búsqueda de un paciente solo por su RUN.
Acción: Buscar en el servidor FHIR un paciente utilizando el RUN o Identificador (36.785.456-1) como criterio de búsqueda.
Pre-condición: Paciente ya se encuentra creado en el servidor FHIR.
Tarea esperada: Obtener el recurso del paciente asociado al RUN de búsqueda.
Información Adicional
- Para la búsqueda se debe respetar la misma sintaxis con la que se ingresaron los datos.
9.- Obtener una versión específica de la ficha clínica del paciente.
Cada vez que en un registro clínico o un dato especifico es modificado, se genera una nueva versión del recurso. Con el fin de hacer una revisión al azar, se solicita la versión 2 de la ficha clínica del paciente.
Acción: Obtener la versión 2 de la ficha clínica del paciente
Pre-condición: La ficha clínica del paciente debe haber sido modificado al menos 2 veces.
Tarea esperada: Obtener la versión 2 de la ficha clínica del paciente.
Información Adicional
- El ID del paciente corresponde al obtenido en el ejercicio 1
10.- Obtener un resumen de la información del paciente del paciente
El estándar FHIR permite obtener un resumen de la información de un paciente. Este nos entrega solo una parte de la información que contiene el recurso.
Acción: Generar un resumen de la información del paciente
Pre-condición: El paciente debe haber sido creado.
Tarea esperada: Obtener el resumen de la información del paciente.
Información Adicional
Debe mostrar solo los elementos que están marcados como resumen en el recurso.
Para obtener mas información acerca de resumen de la información, visitar:
11.- Crear un encuentro médico
Un paciente fue atendido en la Urgencia del Hospital Presidente Carlos Ibáñez del Campo Linares por presentar "dolor de pecho agudo". El médico que lo atendió fue Osvaldo Echeverria quien documenta el encuentro en la sistema de Ficha Clínica consignando la razón por la que acudió el paciente, mientras espera el resultado de los exámenes para confirmar hipótesis diagnóstica.
Acción: Crear un encuentro médico en el servidor FHIR.
Pre-condición: El encuentro no existe en el servidor y los recursos a los cuales se referencia deben existir previamente en el servidor FHIR.
Tarea esperada: El encuentro médico sea creado exitosamente en el servidor FHIR.
Información Adicional
Para referenciar correctamente los recursos del encuentro médico:
- El nombre de la Organización o Hospital donde se atendió el paciente es Hospital Presidente Carlos Ibáñez del Campo Linares y el ID es ORG-011.
- El Nombre del médico que atendió al paciente es Osvaldo Echeverria y el ID es PRA-011.
- El código SNOMED del hallazgo "dolor de pecho agudo" puede ser encontrado en el Catálogo SNOMED-CT (https://browser.ihtsdotools.org/) y el formato JSON del elemento lo puede construir consultando en Convenciones de formato de datos (https://cens.atlassian.net/wiki/spaces/T2/pages/36962472/Convenciones+de+formato+de+datos).
- El ID del paciente es el del paciente que creó en el ejercicio 1.
- El estado es del encuentro es finalizado.
- La atención es ambulatoria.
- Para crear la referencia de la organización y del médico, utilice referencias relativas. Para mas información sobre referencias visitar https://www.hl7.org/fhir/references.html
Nivel 2 - Operaciones Nivel Medio - Participantes con nivel medio en FHIR
Escenario 2
El equipo de desarrollo e implementación del proyecto de ficha clínica electrónica, mientras realizaban la implementación y capacitación del personal, se percataron de un gran problema, la falta de completitud de los datos de los pacientes. Esto sucedió debido a que solo se basaron el los perfiles del estándar HL7 FHIR, y no se adaptó el estándar a la realidad chilena. Por esta razón ahora se debe cambiar el perfil y agregar los datos que faltan a cada paciente. Para esto es necesario trabajar con extensiones.
Operaciones con extensiones
HL7 FHIR creó y hace uso de las extensiones, con el fin de mantener un estándar mas simple. Una extensión permite introducir datos que no se encuentran por definición estándar en los recursos FHIR. Dentro de un recurso determinado, las extensiones se pueden usar para definir nuevos elementos o se pueden usar para ampliar los datos incluidos en un elemento definido. Las extensiones se deben definir previamente en un servidor FHIR, con el fin de que quien reciba o cree algún recurso que incluya la extensión, esta sea accesible solo referenciando la URL de la extensión. Las extensiones son ampliamente utilizadas en HL7 FHIR, con el fin de reducir la complejidad base del estándar. Para comprender mejor extensiones se puede visitar el siguiente link. Ademas en la pagina de FHIR (http://hl7.org/fhir/extensibility-registry.html) se puede encontrar una lista con las extensiones mas utilizadas.
1.- Crear un nuevo registro del paciente para el nivel intermedio
Aquí puede usar el mismo paciente que creó en el ejercicio 3 del nivel básico o bajar aquí el archivo json para la creación del paciente.
Acción: Debe crear un nuevo paciente en el servidor FHIR.
Pre-condición: El paciente (recurso) no existe en el servidor FHIR.
Tarea esperada: El paciente (recurso) se crea correctamente en el servidor (Respuesta satisfactoria del servidor FHIR).
Información Adicional
- Para la construcción de datos como identificador, contacto y dirección, entre otros, consulte en Convenciones de formato de datos (Convenciones de formato de datos).
- En la construcción del recurso marque el estado de la ficha como activo.
- Dentro de las operaciones CRUD, para la creación del paciente utilice el método POST.
- Tomar nota del ID del paciente generado por el servidor. Para esto debe volver a abrir el el ejercicio numero 1, y ahí podrá ver el ID que se le asignó a su paciente
2.- Completar la información del paciente, agregando lugar de nacimiento
De acuerdo a la información del paciente, el lugar de nacimiento es Linares, Chile, el cual se debe agregar a la información del paciente.
Acción: Buscar dentro los registros de HL7 FHIR una extensión que permita agregar el lugar de nacimiento, Linares, Chile.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este posea en sus registros el lugar de nacimiento.
3.- Agregar nacionalidad del paciente
De acuerdo a la información del paciente, la nacionalidad de la paciente es chilena, la cual se debe agregar a la información del paciente.
Acción: Buscar dentro los registros de HL7 FHIR una extensión que permita agregar la nacionalidad.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este posea en sus registros la nacionalidad.
Información Importante
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente
4.- Agregar el apellido materno del paciente como una extensión
De acuerdo a la información del paciente, su segundo apellido es Ortega.
Acción: Buscar dentro los registros de HL7 FHIR una extensión que permita agregar el apellido materno del paciente.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este ahora posea en sus registros sus dos apellidos.
Información Importante
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente
5.- Agregar el apellido paterno del paciente como una extensión
De acuerdo a la información del paciente, su primer apellido es Solar.
Acción: Buscar dentro los registros de HL7 FHIR una extensión que permita agregar el apellido paterno del paciente.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este posea en sus registros sus dos apellidos como extensiones.
Información Importante
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente
6.- Agregar la religión del paciente
De acuerdo a la información del paciente, pertenece a la iglesia presbiteriana.
Acción: Buscar dentro los registros de HL7 FHIR una extensión que permita agregar la religión del paciente.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este posea en sus registros información sobre su religión.
Información Importante
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente
7.- Agregar apellidos del acompañante del paciente como extensiones
De acuerdo a la información relacionada con el paciente, los apellidos del acompañante Carter Lara.
Acción: Buscar dentro los registros de HL7 FHIR las extensiones que permitan agregar los dos apellidos del acompañante del paciente.
Pre-condición: El paciente se encuentra creado en el servidor FHIR.
Tarea esperada: Que al consultar el paciente, este ahora posea en sus registros los dos apellidos de su acompañante.
Información Importante
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente
Escenario 3
Esta sección esta orientada a la búsqueda de datos en un servidor HAPI FHIR de prueba. Este servidor fue pre cargado con un set de recursos con el fin de que el participante logre realizar las búsquedas solicitadas.
Búsquedas
La búsqueda de recursos es una operación fundamental de FHIR. Estas pueden ir desde búsquedas simples, como buscar por nombre, RUN, etc., hasta búsquedas avanzadas, como por ejemplo hacer búsquedas encadenadas y relacionadas. Todo va a depender del nivel de los datos que queremos obtener y la complejidad que se le quiera dar a la búsqueda. Los parámetros de búsqueda generales los pueden encontrar en el siguiente link: (https://www.hl7.org/fhir/search.html). Adicionalmente cada recurso tiene parámetros de búsqueda propios, y se pueden ver en la página de especificación de cada recurso.
7.- Búsqueda de pacientes atendidos en un Hospital específico
Acción: Buscar todos los pacientes que han tenido un encuentro médico en el Hospital Carlos Ibañez del Campo Linares.
Pre-condición: Existen pacientes con intervenciones dentro del Hospital Carlos Ibañez del Campo Linares.
Tarea esperada: Obtener la lista de pacientes que han tenido algún encuentro médico en el Hospital Carlos Ibañez del Campo Linares.
Información Adicional
Para la búsqueda debe utilizar el id del Hospital, el cual debe ser buscado en el servidor XXX
8.- Búsqueda de pacientes con una observación específica
Acción: Encontrar la información de todos los paciente que tengan observaciones de code = 8867-4.
Pre-condición: Deben existir pacientes con observaciones con code 8867-4.
Tarea esperada: Encontrar una lista con todos los pacientes que tienen esas observaciones.
9. Búsqueda de pacientes atendidos en un Hospital especifico y sus observaciones
Acción: Buscar todos los pacientes que han tenido encuentros médicos en el Hospital Carlos Ibañez del Campo Linares y adicionalmente obtenga las observaciones que se les han realizado.
Pre-condición: Existen pacientes con encuentros médicos dentro del Hospital Carlos Ibañez del Campo Linares, y sus observaciones.
Tarea esperada: Obtener la lista de pacientes y observaciones que cumplen con el criterio de búsqueda.
10.- Búsqueda de ultimas observaciones de un paciente
Acción: Encontrar las últimas 4 observaciones que tuvo el paciente con RUN 11.111.111-1.
Pre-condición: El paciente debe tener al menos 4 observaciones relacionadas.
Tarea esperada: Encontrar solo los 4 últimos registros.
11.- Búsqueda de observaciones con códigos y fechas específicas
Acción: Buscar todas la observaciones, donde el sistema de codificación usado para identificarla esta definido por la url=http://loinc.org y su código es 718-7, que se hayan realizado desde el 1 de octubre del 2016.
Pre-condición: Deben existir observaciones que cumplan las condiciones de búsqueda.
Tarea esperada: Mostrar las observaciones que cumplan las condiciones.
Links útiles
Dejamos unos links que pueden ser de ayuda a los asistentes