Taula de continguts
HAPI FHIR SERVER PERSONALIZADO
Descarga del proyecto
Lo primero que se debe de hacer es ir a la web oficial de Hapi FHIR.
Una vez estemos dentro la pagina, tendremos que buscar la versión mas reciente a Announcements:
En este caso, la versión mas reciente es la 3.8.0 (Hippo).
Buscaremos el apartado donde habla sobre hapi-fhir-jpaserver-starter (marcado de color rojo).
Una vez dentro el enlace anterior, deberemos de buscar la opción Clone or download:
Si se quiere proseguir con un Entorno de Desenvolupamiento Integrado (IDE) pasar a el apartado Importación a IDE;
En caso contrario pasar a el apartado Sin IDE
Importación a IDE
En caso que dispongamos de un IDE (integrated development environament) haremos clic:
Para copiar el enlace del proyecto.
IntelliJ IDEA:
Abrimos nuestro entorno de desenvolupamiento:
Seleccionamos la opción de Versión de control.
Enganxamos la url que hemos copiado anteriormente y hacemos clic a Clone
Una vez haya acabado de cargar el proyecto, resolver las dependencias y esté listo para funcionar (este proceso puede tardar unos minutos en función de cada ordenador), podremos ver la estructura del proyecto de la siguiente forma:
NetBeans IDE
Abrimos nuestro entorno de desenvolupamiento:
Iremos a la pestaña Team, Git y después a Clone…
Introduciremos la dirección del repositorio de github, user y password si tenemos cuenta de github y la carpeta destino.
Una vez puestos los anteriores campos haremos clic a Next.
A continuación dejaremos marcada la opción master* y clicaremos a Next.
Seleccionaremos el botón Browse… para seleccionar la raiz del proyecto. Podremos cambiar el nombre del proyecto desde la opción Clone Name.
A continuación haremos clic a Finish.
Una vez finalizado estos pasos, NetBeans comenzara a importar el proyecto. Una vez finalizado esta importación (puede tardar un rato) podremos ver la estructura del proyecto como se muestra a continuación.
Sin IDE
En caso que no dispongamos de un IDE, podremos hacerlo de una manera mas manual.
Descargaremos el proyecto en formato .zip
Haremos clic derecho sobre el archivo descargado y le daremos a la opción Extraer. Una vez extraído, entramos dentro la carpeta y dentro del proyecto:
Compilación fichero .war
Buscaremos en el explorador de archivos de Windows la ruta donde hemos guardado el proyecto ya compilado.
Una vez somos DENTRO la carpeta del proyecto, escriviremos “cmd” en la barra donde aparece la ruta.
Una vez hecho esto nos aparecerà la siguiente ventana.
Al realizar este comando el programa comenzara a ejecutar una série de instrucciones las cuales generaran un fichero. Este proceso puede llevar un rato.
Una vez acabado esta instrucción deberemos volver a la ubicación del proyecto y buscaremos una carpeta llamada target.
Una vez dentro, copiaremos el fitxero con extención .war.
Descarga de el programario TOMCAT
Acceder a esta web.
Descargar el programario Tomcat:
Ejecutamos el fichero descargado, y hacemos clic a Ejecuta.
Seguimos el sigueinte paso Next.
Seguiremos haciendo clic “I Agree”.
A continuación “Next”.
Dejaremos las configuraciones por defecto haremos “Next”
Si tenemos instalado Java JRE, tendremos que seleccionar la ruta en la cual esta instalada.
En caso que no esté instalada la podremos descargar desde aquí.
Haremos Next, y Install.
Para acabar haremos clic a Finish.
Una vez tenemos instalado el Tomcat tendremos que iniciar el servidor de Tomcat.
Iremos a buscar el programa al buscador de Windows.
Otra opción, es buscar en el menú inferior la icona siguiente:
Se abrirá un panel donde podremos encender el servidor o apagarlo.
Ejecución FHIR Server
Una vez accedido al panel del programa, deberemos ir a la siguiente ruta para poner el fichero .war generado anteriormente dentro esta carpeta.
Copiaremos el fichero .war en esta ruta.
Deberiamos de tener la carpeta con el fichero y la ventana con el Tomcat abierto.
Una vez tengamos abierto estas dos pantallas haremos clic a Start. El programa comenzara ha ejecutar el servidor.
Para comprovar que el Tomcat esta funcionando tendremos que introducir esta url al buscador:
Una vez esta comprovado lo que tenemos que hacer para ver nuestro servidor FHIR funcionando es acceder a la siguiente url:
Personalitzación del servidor
Para personalizar diferentes parametros en el servidor FHIR, tendremos que acceder a uno de estos ficheros:
Hapi.properties = Fichero para configurar las propiedades mas internas del servidor como por ejemplo: encoding, el número maximo de items por pagina, la url del servidor, versión de fhir, configuración de la base de datos, etc.
Ficheros html = Constan de ficheros de presentación html. Donde podremos editar los logos, los textos y todos los parametros de presentación del servidor.
Consideración importante: En caso que se modifique los ficheros del servidor para personalizarlos, SIEMPRE se tendra que volver a compilar el fichero .war y volver a poner dentro del Tomcat.
Ejemplo de servidor personalizado
Servidor FHIR oficial de la oficina de estandares y interoperabilidad de la Fundación TicSalut