Track 1: Paciente

Owned by Jorge Mansilla (Unlicensed)
Last updated: Nov 09, 2020
13 min read

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.

Requisitos para participantes

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.

Equipo de trabajo

Coordinador:

Equipo técnico:

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 durante el 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. 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.

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, 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 la idea es 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 de todas las versiones y cambios realizados al recurso de la ficha clínica del paciente.

Información Adicional


5.- Buscar un paciente por Nombre y Apellido

Al querer buscar un paciente 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: Buscar 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 médico 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. Además en la pagina de FHIR (http://hl7.org/fhir/extensibility-registry.html) se puede encontrar una lista con las extensiones mas utilizadas (lo ideal es utilizar extensiones de esta pagina).


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 no existe en el servidor FHIR.

Tarea esperada: El paciente 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.- Agregar el lugar de nacimiento del paciente como una extensión (BirthPlace)

De acuerdo a la información del paciente, el lugar de nacimiento es la ciudad de Linares, Chile, el cual se debe agregar a la información del paciente.

Acción: Agregar el lugar de nacimiento. Considerar la extensión adecuada del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra creado en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia al Lugar de Nacimiento.


3.- Agregar la nacionalidad del paciente como una extensión (Nationality)

De acuerdo a la información del paciente,  la nacionalidad del paciente es chilena y se debe agregar para completar su información.

Acción: Agregar la nacionalidad del paciente. Considerar la extensión adecuada del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra creado en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia a la nacionalidad.

Información Importante

Para codificar la nacionalidad utilice:
El código 152 con la glosa "chilena", considerando el documento oficial publicado por el Ministerio de Salud "Decreto exento 643", el código de país de Chile es 152.
Además de la extensión actual, debe mantener las extensiones agregadas anteriormente

4.- Agregar el apellido materno del paciente como una extensión (Mothers-Family)

De acuerdo a la información del paciente, su segundo apellido es Ortega. Agregue una extensión en la cual pueda almacenar el apellido materno del paciente

Acción: Agregar el apellido materno del paciente. Considerar la extensión adecuada del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra creado previamente en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia a su apellido materno.

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 (Fathers-Family)

De acuerdo a la información del paciente, su primer apellido es Solar. Agregue una extensión en la cual pueda almacenar el apellido paterno del paciente

Acción: Agregar el apellido paterno del paciente. Considerar la extensión adecuada del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra previamente creado en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia a su apellido paterno.

Información Importante

Además de la extensión actual, debe mantener las extensiones agregadas anteriormente

6.- Agregar la religión del paciente como una extensión (patient-religion)

De acuerdo a la información del paciente, pertenece a la religión evangélica.

Acción: Agregar la religión del paciente. Considerar la extensión adecuada del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra previamente creado en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia a su religión.

Información Importante

Además de la extensión actual, debe mantener las extensiones agregadas anteriormente

Para codificar la religión o culto del paciente adecuadamente en el recurso utilice el código 02 referido al término 'EVANGÉLICA O PROTESTANTE', considerando el documento oficial publicado por el Ministerio de Salud "Decreto exento 643".

7.- Agregar apellidos del acompañante del paciente como extensiones (Fathers & Mothers Family)

De acuerdo a la información relacionada con el acompañante del paciente, el apellido paterno es Carter y el materno es Contreras.

Acción: Agregar los apellidos paterno y materno del acompañante del paciente. Considerar las extensiones adecuadas del registro de HL7 FHIR.

Pre-condición: El paciente se encuentra creado en el servidor FHIR.

Tarea esperada: Se actualiza correctamente la ficha del Paciente con la extensión que hace referencia a los apellidos paterno y materno 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.

8.-  Búsqueda de todos los pacientes atendidos en un Hospital específico

Acción: Buscar la ficha de todos los pacientes que han sido atendidos en el Hospital Presidente Carlos Ibáñez del Campo Linares.

Pre-condición: Existen pacientes con atenciones realizadas en el Hospital Presidente Carlos Ibáñez del Campo Linares.

Tarea esperada: Obtener la ficha de todos los pacientes que han tenido algún encuentro médico en el Hospital Presidente Carlos Ibáñez del Campo Linares.

Información Adicional

  • El ID del Hospital Presidente Carlos Ibáñez del Campo Linares es ORG-011


9.- Búsqueda de todos los pacientes con una observación específica

Se debe encontrar y mostrar la información de todos los pacientes que tengan observaciones de Frecuencia Cardíaca por medio de su Identificador LOINC = 8867-4

Acción: Buscar la ficha de todos los paciente que tengan observaciones con code=8867-4.

Pre-condición: Deben existir pacientes con observaciones con el código LOINC para Frecuencia Cardíaca (code 8867-4).

Tarea esperada: Obtener la ficha de todos los pacientes que tienen observaciones con code=8867-4.

10. Búsqueda de pacientes atendidos por un determinado médico

Buscar todos los pacientes que han tenido encuentros médicos realizados por el médico cuyo ID es PRA-011.

Acción: Buscar pacientes atendidos por un médico especifico.

Pre-condición: Existen pacientes con encuentros médicos realizados por el médico con ID=PRA-011

Tarea esperada: Obtener la lista de pacientes atendidos por el médico con ID=PRA-011


11.- Búsqueda de observaciones de un paciente.

Dentro de todas las observaciones que ha tenido el paciente con RUN 15.920.073-1, mostrar solo 3 de estas, cualesquiera.

Acción: Buscar las observaciones que haya tenido el paciente con RUN 15.920.073-1.

Pre-condición: El paciente debe tener al menos 3 observaciones relacionadas.

Tarea esperada: Mostrar solo 3 observaciones que hayan sido registradas al paciente con RUN 15.920.073-1.

12.-  Búsqueda de observaciones con códigos y fechas específicas

Buscar todas la observaciones, donde el sistema de codificación usado fue LOINC (http://loinc.org) y el código de la observación haya sido 8310-5 (Temperatura corporal) y además que se hayan realizado desde el 1 de enero del 2019 inclusive.

Acción: Buscar todas la observaciones según los criterios señalados.

Pre-condición: Deben existir observaciones que cumplan las condiciones de búsqueda.

Tarea esperada: Mostrar todas las observaciones que cumplan las condiciones.

Información Adicional

Links útiles

Dejamos unos links que pueden ser de ayuda a los asistentes