====== HAPI FHIR SERVER PERSONALIZADO ====== ===== Descarga del proyecto ===== Lo primero que se debe de hacer es ir a la [[http://hapifhir.io/|web oficial]] de Hapi FHIR. {{ :es:contenidos:estandares:hl7fhir:1.png?600 |}} 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). {{ :es:contenidos:estandares:hl7fhir:2.png?600 |}} Buscaremos el apartado donde habla sobre [[http://hapifhir.io/|hapi-fhir-jpaserver-starter]] (marcado de color rojo). Una vez dentro el enlace anterior, deberemos de buscar la opción Clone or download: {{ :es:contenidos:estandares:hl7fhir:3.png?600 |}} **__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: {{ :es:contenidos:estandares:hl7fhir:4.png?600 |}} Para copiar el enlace del proyecto. ==== IntelliJ IDEA: ==== Abrimos nuestro entorno de desenvolupamiento: {{ :es:contenidos:estandares:hl7fhir:5.png?600 |}} Seleccionamos la opción de Versión de control. {{ :es:contenidos:estandares:hl7fhir:6.png?400 |}} Enganxamos la url que hemos copiado anteriormente y hacemos clic a Clone {{ :es:contenidos:estandares:hl7fhir:7.png?600 |}} 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: {{ :es:contenidos:estandares:hl7fhir:8.png?600 |}}   ==== NetBeans IDE ==== Abrimos nuestro entorno de desenvolupamiento: {{ :es:contenidos:estandares:hl7fhir:9.png?600 |}} Iremos a la pestaña Team, Git y después a Clone... {{ :es:contenidos:estandares:hl7fhir:10.png?600 |}}   Introduciremos la dirección del repositorio de github, user y password si tenemos cuenta de github y la carpeta destino. {{ :es:contenidos:estandares:hl7fhir:11.png?600 |}} Una vez puestos los anteriores campos haremos clic a Next. A continuación dejaremos marcada la opción master* y clicaremos a Next.   {{ :es:contenidos:estandares:hl7fhir:12.png?600 |}} Seleccionaremos el botón Browse... para seleccionar la raiz del proyecto. Podremos cambiar el nombre del proyecto desde la opción Clone Name. {{ :es:contenidos:estandares:hl7fhir:13.png?600 |}} 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. {{ :es:contenidos:estandares:hl7fhir:14.png?600 |}}   ===== Sin IDE ===== En caso que no dispongamos de un IDE, podremos hacerlo de una manera mas manual. {{ :es:contenidos:estandares:hl7fhir:15.png?600 |}} Descargaremos el proyecto en formato .zip {{ :es:contenidos:estandares:hl7fhir:16.png?600 |}} 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: {{ :es:contenidos:estandares:hl7fhir:17.png?600 |}}   ===== Compilación fichero .war ===== Buscaremos en el explorador de archivos de Windows la ruta donde hemos guardado el proyecto ya compilado. {{ :es:contenidos:estandares:hl7fhir:18.png?600 |}} Una vez somos **__DENTRO__** la carpeta del proyecto, escriviremos “cmd” en la barra donde aparece la ruta. {{ :es:contenidos:estandares:hl7fhir:19.png?600 |}} Una vez hecho esto nos aparecerà la siguiente ventana. {{ :es:contenidos:estandares:hl7fhir:20.png?600 |}}   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. {{ :es:contenidos:estandares:hl7fhir:21.png?600 |}} Una vez acabado esta instrucción deberemos volver a la ubicación del proyecto y buscaremos una carpeta llamada target. {{ :es:contenidos:estandares:hl7fhir:22.png?600 |}}   Una vez dentro, copiaremos el fitxero con extención .war. {{ :es:contenidos:estandares:hl7fhir:23.png?600 |}}   ===== Descarga de el programario TOMCAT ===== Acceder a esta [[https://tomcat.apache.org/download-90.cgi|web]]. Descargar el programario Tomcat: {{ :es:contenidos:estandares:hl7fhir:24.png?600 |}} Ejecutamos el fichero descargado, y hacemos clic a Ejecuta. {{ :es:contenidos:estandares:hl7fhir:25.png?600 |}} Seguimos el sigueinte paso Next. {{ :es:contenidos:estandares:hl7fhir:26.png?600 |}} Seguiremos haciendo clic “I Agree”. {{ :es:contenidos:estandares:hl7fhir:27.png?600 |}} A continuación “Next”. {{ :es:contenidos:estandares:hl7fhir:28.png?600 |}} Dejaremos las configuraciones por defecto haremos “Next” {{ :es:contenidos:estandares:hl7fhir:29.png?600 |}} 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 [[https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html|aquí]]. {{ :es:contenidos:estandares:hl7fhir:30.png?600 |}} Haremos Next, y Install. {{ :es:contenidos:estandares:hl7fhir:31.png?600 |}} 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. {{ :es:contenidos:estandares:hl7fhir:32.png?600 |}} Otra opción, es buscar en el menú inferior la icona siguiente: {{ :es:contenidos:estandares:hl7fhir:33.png?600 |}} Se abrirá un panel donde podremos encender el servidor o apagarlo. {{ :es:contenidos:estandares:hl7fhir:34.png?600 |}}   ===== 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. {{ :es:contenidos:estandares:hl7fhir:35.png?600 |}} Copiaremos el fichero .war en esta ruta. {{ :es:contenidos:estandares:hl7fhir:36.png?600 |}} Deberiamos de tener la carpeta con el fichero y la ventana con el Tomcat abierto. {{ :es:contenidos:estandares:hl7fhir:37.png?600 |}} Una vez tengamos abierto estas dos pantallas haremos clic a Start.   El programa comenzara ha ejecutar el servidor. {{ :es:contenidos:estandares:hl7fhir:38.png?600 |}} Para comprovar que el Tomcat esta funcionando tendremos que introducir esta [[http://localhost:8080/|url]] al buscador: {{ :es:contenidos:estandares:hl7fhir:39.png?600 |}} Una vez esta comprovado lo que tenemos que hacer para ver nuestro servidor FHIR funcionando es acceder a la siguiente [[http://localhost:8080/hapi-fhir-jpaserver|url]]: {{ :es:contenidos:estandares:hl7fhir:40.png?600 |}} ===== Personalitzación del servidor ===== Para personalizar diferentes parametros en el servidor FHIR, tendremos que acceder a uno de estos ficheros: {{ :es:contenidos:estandares:hl7fhir:41.png?600 |}} 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 [[https://ticsalutsocial.cat/es/|Fundación TicSalut]] [[http://vps184407.ovh.net:8080/ofsti-fhirserver/]]