Introducción a HAPI HAPI

Introducción a Servidor HAPI FHIR
HAPI FHIR es una implementación de la especificación HL7 FHIR para Java.
Usa el estándar HL7

1. Tutorial 1 Introducción a HAPI-FHIR.
Dr. Humberto F. Mandirola Brieux
27/08/18
Ministerio de Salud - DNSIS (Dirección Nacional de
Sistemas de Información Sanitaria) 1
Introducción básica a FHIR®

2. Agenda Unidad 1
–A quien va dirigido
–Requisitos Previos
–Objetivos del tutorial
–Introducción a HAPI FHIR
–¿Que es HAPI FHIR?
–Que versiones disponibles hay
–Como bajar HAPI-FHIR
–Requisitos software y
hardware Para Instalar HAPI-
FHIR
–Como instalar HAPI-FHIR
–Como hacerlo funcionar - Start
up
08/27/18 2
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
◦¿Qué es una API y para qué sirve?
◦¿Que es REST?
◦Introducción a Postman
◦¿Que permite hacer Postman?
◦Bajar a instalar Postman

3. A quien va dirigido
•Analistas, integradores, consultores y
programadores con experiencia en al ámbito
sanitario, a profesiones y personas
interesadas en conocer sobre estándares de
información médica.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
3

4. Requisitos Previos
1.Conocer el estar HL7( Es recomendable haber hecho el curso de HL7
Argentina)
2.Conocer FHIR ( Es recomendable haber hecho el curso de HL7
Argentina)
3.Conocer como manejarse con la especificación FHIR. https://www.hl7.org/fhir/
4.Conocimiento básicos de sistema operativo y línea de comandos cmd
5.Conocimientos básicos de Java
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
4

5. Objetivos de este tutorial
•Conocer una revisión general sobre el marco
HAPI FHIR
•Saber como instalar un servidor HAPI
•Tener su propio servidor FHIR, para hacer
pruebas y aprender mejor el estándar.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
5

6. Introducción
•Explicar qué es FHIR estaría más allá del
alcance de este tutorial. El mejor lugar para
saber que es FHIR es la especificación que
está diseñada para ser legible e
implementable, y está llena de información.
•HAPI-FHIR, esta progamado en JAVA y corre
sobre distintos sistemas operativos, en este
tutorial veremos su instalación sobre sistema
operativo Windows.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
6

7. ¿Qué es HAPI FHIR?
•HAPI FHIR es una implementación de la
especificación HL7 FHIR para Java.
•No forma parte del estándar HL7
HAPI FHIR se basa en el mismo principio de
practicidad de FHIR. Se aplica a la
implementación de Java: Se ha basado el
diseño de esta API en las API JAXB y JAX-WS,
que consideramos que están muy bien
pensadas y son API muy útiles.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
7

8. Como bajar HAPI-FHIR
•Lo bajamos de
http://hapifhir.io/download.html Para
este tutorial vamos a usar la versión 2.5
que funciona en forma estable con FHIR
STU3
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
8

9. Como bajar HAPI-FHIR
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
9

10. Instalar HAPI-FHIR
•Crear el directorio c:\FHIR25
•Descomprimir el archivo hapi-fhir-2.5-cli.zip en el
directorio. Asegurarse que no haya otro servidor
corriendo como Mirth si puede generar conflictos y
hacer andar a ambos servidores requeriría una
explicación que excede los alcance de este tutorial
•Luego abrir línea de comandos cmd
•Ir al directorio c:\FHIR25
•COMENTARIO: Asegurarse que no haya otro servidor
corriendo como Mirth si no va andar
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
10

11. •Esta disponible para Sistemas
Operativos Windows, Linux y MAC
–Windows (32 bits, 64 bits, XP, vista, Windows
7,8,10 y Windows Server).
–Linux Kernel 2,4 o superior.
–Mac Os 10.x o superior.
27/08/18 11
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
Requisitos software y hardware
Para Instalar HAPI-FHIR

12. Requisitos software y hardware Para
Instalar HAPI-FHIR
Requiere una máquina virtual de Java de Oracle
http://www.oracle.com/technetwork/java/javase/downloads/index.html
27/08/18 12
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
La versión de máquina virtual de
JAVA que se requiere es la:
JRE: (Java Runtime Environment)

13. Requisitos software y hardware
•HAPI-FHIR incluye una base de datos Apache Derby embebida
para el almacenamiento de su información.
–Pero soporta otras bases de datos como Derby, PostgreSQL, MySQL,
Oracle 11gR2 o MS SQL Server.
•Los requisitos hardware del servidor dependen
estrechamente de la actividad que tenga nuestra
integración.
–En general con la configuración adecuada no necesita demasiados
recursos de memoria y de disco duro.
–1 GB de RAM mínimo es lo recomendado
27/08/18 13
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)

14. ¿Cómo se instala?
•Bajar Mirth Connect del sitio de Mirth www.mirth.com
–Se pueden bajar de:
–https://www.mirth.com/Downloads
•Antes de instalarlo asegurarse que estén
instalada la maquina virtual de JAVA
•Instalar Durante la instalación hay que decidir que puerto
será usado por Mirth Connect.
•por default es el 8080 para comunicaciones inseguras y para
comunicaciones seguras SSL 8443
27/08/18 14
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)

15. Instalar HAPI-FHIR
•De donde Bajarlo http://hapifhir.io/download.html
•Crear el directorio c:\FHIR25
•Descomprimir el archivo hapi-fhir-2.5-cli.zip en el directorio
•Luego abrir línea de comandos cmd
Ir al directorio c:\FHIR25
•Poner la instrucción:
java -jar hapi-fhir-cli.jar run-server -f dstu3
y comienza a levantar el servidor HAPI
•Ver imagen COMENTARIO: Asegurarse que no haya otro
servidor corriendo como Mirth si no va andar
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
15

16. Instalar HAPI-FHIR
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
16

17. Start-up
•Una vez corriendo el servidor HAPI
usamos un browser para ingresar al
mismo
•Poniendo esta dirección:
•http://localhost:8080/
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
17

18. ¿Qué es una API y para qué sirve?
1.Una API (Application Programming Interfaces) es una
especificación formal sobre cómo un módulo de un software
se comunica o interactúa con otro.
2.Las API son un conjunto de comandos, funciones y
protocolos informáticos que permiten a los desarrolladores
crear programas específicos para ciertos sistemas
operativos.
3.Simplifican el trabajo de programación, ya que no tiene que
no hay que «escribir» códigos desde cero.
4.Las APIs permiten usar funciones predefinidas para
interactuar con el sistema operativo o con otro programa.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
18

19. ¿Que es REST?
1.REST (Representational State
Transfer) es una forma de
Arquitectura a la hora de
realizar una comunicación entre
cliente y servidor.
2.REST niveles:
1.0, no hay ningún tipo de
organización.
2.1, declara recursos.
3.2, peticiones: GET, POST, PUT,
DELETE.
4.3, HATEOAS (Hypertext As The
Engine Of Application State).
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
19
comunicación HTTP
comunicación HTTP
(HTTP= HperText Transfer Protocol)

20. Introducción a Postman
–Postman es una extensión del navegador Google Chrome.
–También puede funcionar como aplicación de escritorio.
– Permite el envío de peticiones HTTP REST sin necesidad
de desarrollar un cliente.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
20

21. ¿Que permite hacer Postman?
•Permiten realizar tareas diferentes dentro del mundo
API REST:
1.creación de peticiones a APIs internas o de terceros,
2.elaboración de tests para validar el comportamiento
de APIs,
3.posibilidad de crear entornos de trabajo diferentes
(con variables globales y locales)-
4.Posibilidad de compartir con el equipo de manera
gratuita (exportación de toda esta información
mediante URL en formato JSON).
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
21

22. Bajar a instalar Postman
–Bajar a instalar Postman https://www.getpostman.com/
–Una vez instalado Postman, es necesario abrirlo e instalar
el plugin Jetpack de Postman para poder crear las pruebas
y lanzarlas conjuntamente.
27/08/18
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)
22

23. Más Información
–http://hapifhir.io
/
–https://www.hl7.org/fhir/
–https://www.youtube.com/watch?v=YMJEAFVl63E
–http://notasdesoftware.com/2014/04/postman-cliente-http-para-probar.html
–https://docs.mulesoft.com/healthcare-toolkit/v/2.0/testing-with-hapi-testpanel
–https://medium.com/@thedon/how-test-your-hapi-api-with-lab-b72f6e8ed641
–https://
www.youtube.com/watch?v=juldrxDrSH0&list=PLhW3qG5bs-L-oT0GenwPLcJAPD_SiFK3C
–https://www.arquitecturajava.com/que-es-rest/
–https://www.paradigmadigital.com/dev/postman-gestiona-construye-tus-apis-rapidamente
/
08/27/18 23
Ministerio de Salud - DNSIS
(Dirección Nacional de
Sistemas de Información Sanitaria)

24. Referencias
•http://www.healthintersections.com.au/. Blog de Grahame Grieve, el creador de
FHIR.
•http://code.msdn.microsoft.com/windowsdesktop/Client-for-HL7-FHIR-server-0709be0b
•http://www.hl7.org/implement/standards/fhir/documents.html
•http://www.hl7.org/FHIR/ Página oficial de FHIR. Incluye la especificación
completa del protocolo.
•http://www.hl7latam.org/HL7LATAMNews/N5/N5E.pdf
•http://wiki.hl7.org/index.php?title=FHIR. Wiki oficial de FHIR, con documentación
y recursos para la implementación, desarrollo y gobernanza.
•http://www.slideshare.net/Furore_com/01-b-from-ccda-to-fhir-grahame
•https://fhirblog.com/2014/03/28/pictorial-representation-of-fhir-resouces/
•http://hl7es.blogspot.com.ar/2013/12/fhir-el-nuevo-miembro-de-la-familia-
hl7.html
•http://www.revistas.utp.ac.pa/index.php/memoutp/article/view/1280/html
08/27/18
Ministerio de Salud - DNSIS (Dirección Nacional de
Sistemas de Información Sanitaria) 24

25. por su atención.
Ministerio de Salud
DNSIS
Dirección Nacional de Sistemas de Información Sanitarios
27/08/18
Ministerio de Salud - DNSIS (Dirección Nacional de
Sistemas de Información Sanitaria) 25
Gracias