====== HAPI FHIR SERVER PERSONALITZAT ====== ===== Descàrrega del projecte ===== El primer que s’hauria de fer és anar a la [[http://hapifhir.io/|web oficial]] de Hapi FHIR. {{ :es:contenidos:estandares:hl7fhir:1.png?600 |}} Una vegada estiguem dins la pàgina, haurem de buscar la versió més recent a Announcements: En el nostre cas, la versió més recent és la 3.8.0 (Hippo). {{ :es:contenidos:estandares:hl7fhir:2.png?600 |}} Buscarem l’apartat on parlar sobre [[http://hapifhir.io/|hapi-fhir-jpaserver-starter]] (marcat de color vermell). Una vegada dins l’anterior enllaç, haurem de buscar l’opció Clone or download: {{ :es:contenidos:estandares:hl7fhir:3.png?600 |}} **__Si es vol prosseguir amb un Entorn de Desenvolupament Integrat (IDE) passar l’apartat Importació a IDE;__** **__En cas contrari passar l’apartat Sense IDE__** ===== Importació a IDE ===== En cas que disposem d’un IDE (integrated development environament) farem clic: {{ :es:contenidos:estandares:hl7fhir:4.png?600 |}} Per tal de copiar l’enllaç del projecte. ==== IntelliJ IDEA: ==== Obrim el nostre entorn de desenvolupament: {{ :es:contenidos:estandares:hl7fhir:5.png?600 |}} Seleccionem l’opció de Versió de control. {{ :es:contenidos:estandares:hl7fhir:6.png?400 |}} Enganxem l’url que hem copiat anteriorment i fem clic a Clone {{ :es:contenidos:estandares:hl7fhir:7.png?600 |}} Una vegada hagi acabat de carregar el projecte, resoldre les dependències i estigui llest per funcionar (aquests procés pot tardar uns minuts en funció de cada ordinador), podrem veure l’estructura del projecte de la següent manera: {{ :es:contenidos:estandares:hl7fhir:8.png?600 |}}   ==== NetBeans IDE ==== Obrim el nostre entorn de desenvolupament: {{ :es:contenidos:estandares:hl7fhir:9.png?600 |}} Anirem a la pestanya Team, Git i després a Clone... {{ :es:contenidos:estandares:hl7fhir:10.png?600 |}}   Introduirem l’adreça del repositori de github, user i password si tenim compte de github i la carpeta destí. {{ :es:contenidos:estandares:hl7fhir:11.png?600 |}} Una vegada posat els anteriors camps farem clic a Next. A continuació deixarem marcada l’opció master* i clicarem a Next.   {{ :es:contenidos:estandares:hl7fhir:12.png?600 |}} Seleccionarem el botó Browse... per tal de seleccionar l’arrel del projecte. Podrem canviar el nom del projecte des de l’opció Clone Name. {{ :es:contenidos:estandares:hl7fhir:13.png?600 |}} A continuació farem clic a Finish. Una vegada finalitzat aquests passos, NetBeans començarà a importar el projecte. Un cop finalitzat aquesta importació (pot tardar una estona) podrem veure l’estructura del projecte com es mostra a continuació. {{ :es:contenidos:estandares:hl7fhir:14.png?600 |}}   ===== Sense IDE ===== En cas que no disposem d’un IDE, podrem fer-ho d’una manera més manual. {{ :es:contenidos:estandares:hl7fhir:15.png?600 |}} Descarregarem el projecte en format .zip {{ :es:contenidos:estandares:hl7fhir:16.png?600 |}} Farem clic dret sobre l’arxiu descarregat i li donarem a l’opció Extraer.   Un cop extret, entrem dins la carpeta i DINS el projecte: {{ :es:contenidos:estandares:hl7fhir:17.png?600 |}}   ===== Compilació fitxer .war ===== Buscarem en l’explorador d’arxius de Windows la ruta on hem guardat el projecte ja compilat. {{ :es:contenidos:estandares:hl7fhir:18.png?600 |}} Una vegada som **__DINS__** la carpeta del projecte, escriurem “cmd” a la barra on apareix la ruta. {{ :es:contenidos:estandares:hl7fhir:19.png?600 |}} Un cop fet això ens apareixerà la següent finestra. {{ :es:contenidos:estandares:hl7fhir:20.png?600 |}}   Al realitzar aquesta comanda el programa començarà a executar una sèrie d’instruccions les quals generaran un fitxer. Aquest procés pot portar una estona. {{ :es:contenidos:estandares:hl7fhir:21.png?600 |}} Una vegada acabat aquesta instrucció haurem de tornar a la ubicació del projecte i buscarem una carpeta anomenada target. {{ :es:contenidos:estandares:hl7fhir:22.png?600 |}}   Un cop dins, copiarem el fitxer amb extenció .war. {{ :es:contenidos:estandares:hl7fhir:23.png?600 |}}   ===== Descàrrega del programari TOMCAT ===== Accedir aquesta [[https://tomcat.apache.org/download-90.cgi|web]]. Descarregar el programari Tomcat: {{ :es:contenidos:estandares:hl7fhir:24.png?600 |}} Executem el fitxer descarregat, i fem clic a Executa. {{ :es:contenidos:estandares:hl7fhir:25.png?600 |}} Seguim el següent pas Next. {{ :es:contenidos:estandares:hl7fhir:26.png?600 |}} Seguirem fent clic “I Agree”. {{ :es:contenidos:estandares:hl7fhir:27.png?600 |}} A continuació “Next”. {{ :es:contenidos:estandares:hl7fhir:28.png?600 |}} Deixarem les configuracions per defecte i farem “Next” {{ :es:contenidos:estandares:hl7fhir:29.png?600 |}} Si tenim instal·lat Java JRE, haurem de seleccionar la ruta en la qual esta instal·lada. En cas que no estigui instal·lada la podrem descarregar des [[https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html|d'aquí]]. {{ :es:contenidos:estandares:hl7fhir:30.png?600 |}} Farem Next, i Install. {{ :es:contenidos:estandares:hl7fhir:31.png?600 |}} Per acabar farem clic a Finish. Una vegada tenim instal·lat el Tomcat haurem d’iniciar el servidor de Tomcat. Anirem a buscar el programa al cercador de Windows. {{ :es:contenidos:estandares:hl7fhir:32.png?600 |}} Una altra opció, és buscar en el menú inferior la icona següent: {{ :es:contenidos:estandares:hl7fhir:33.png?600 |}} S’obrirà un panell on podrem encendre el servidor o apagar-lo. {{ :es:contenidos:estandares:hl7fhir:34.png?600 |}}   ===== Execució FHIR Server ===== Un cop accedit al panell del programa, haurem d’anar a la següent ruta per posar el fitxer .war generat anteriorment dins aquesta carpeta. {{ :es:contenidos:estandares:hl7fhir:35.png?600 |}} Copiarem el fixer .war en aquesta ruta. {{ :es:contenidos:estandares:hl7fhir:36.png?600 |}} Hauríem de tenir la carpeta amb el fitxer i la finestra amb el Tomcat obert. {{ :es:contenidos:estandares:hl7fhir:37.png?600 |}} Una vegada tinguem obert aquestes dues pantalles farem click a Start.   El programa començarà ha executar el servidor. {{ :es:contenidos:estandares:hl7fhir:38.png?600 |}} Per comprovar que el Tomcat està funcionant haurem d’introduir aquesta [[http://localhost:8080/|url]] al cercador: {{ :es:contenidos:estandares:hl7fhir:39.png?600 |}} Una vegada està comprovat el que hem de fer per veure el nostre servidor FHIR funcionant és accedir a la següent [[http://localhost:8080/hapi-fhir-jpaserver|url]]: {{ :es:contenidos:estandares:hl7fhir:40.png?600 |}} ===== Personalització del servidor ===== Per tal de personalitzar diferents paràmetres en el servidor FHIR, haurem d’accedir a un d’aquests fitxers: {{ :es:contenidos:estandares:hl7fhir:41.png?600 |}} Hapi.properties = Fitxer per configurar les propietats més internes del servidor com per exemple: enconding, el número màxim de items per pàgina, l’url del servidor, versió de fhir, configuració de la base de dades, etc. Fitxers html = Consten de fitxers de presentació html. On podrem editar els logos, els textos i tots els paràmetres de presentació del servidor. __**//Consideració important://**__ En cas que es modifiqui els fitxers del servidor per tal de personalitzar-los, SEMPRE s’haurà de tornar a compilar el fitxer .war i tornar a posar dins del Tomcat. ===== Exemple de servidor personalitzat ===== Servidor FHIR oficial de l’oficina d’estàndards i interoperabilitat de la [[https://ticsalutsocial.cat/es/|Fundació TicSalut]] [[http://vps184407.ovh.net:8080/ofsti-fhirserver/]]