Aquesta és una revisió antiga del document
El primer que s’hauria de fer és anar a la web oficial de Hapi FHIR.
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).
Buscarem l’apartat on parlar sobre hapi-fhir-jpaserver-starter (marcat de color vermell).
Una vegada dins l’anterior enllaç, haurem de buscar l’opció Clone or download:
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
En cas que disposem d’un IDE (integrated development environament) farem clic:
Per tal de copiar l’enllaç del projecte.
Obrim el nostre entorn de desenvolupament:
Seleccionem l’opció de Versió de control.
Enganxem l’url que hem copiat anteriorment i fem clic a Clone
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:
Obrim el nostre entorn de desenvolupament:
Anirem a la pestanya Team, Git i després a Clone…
Introduirem l’adreça del repositori de github, user i password si tenim compte de github i la carpeta destí.
Una vegada posat els anteriors camps farem clic a Next.
A continuació deixarem marcada l’opció master* i clicarem a Next.
Seleccionarem el botó Browse… per tal de seleccionar l’arrel del projecte. Podrem canviar el nom del projecte des de l’opció Clone Name.
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ó.
En cas que no disposem d’un IDE, podrem fer-ho d’una manera més manual.
Descarregarem el projecte en format .zip
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:
Buscarem en l’explorador d’arxius de Windows la ruta on hem guardat el projecte ja compilat.
Una vegada som DINS la carpeta del projecte, escriurem “cmd” a la barra on apareix la ruta.
Un cop fet això ens apareixerà la següent finestra.
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.
Una vegada acabat aquesta instrucció haurem de tornar a la ubicació del projecte i buscarem una carpeta anomenada target.
Un cop dins, copiarem el fitxer amb extenció .war.
Accedir aquesta web.
Descarregar el programari Tomcat:
Executem el fitxer descarregat, i fem clic a Executa.
Seguim el següent pas Next.
Seguirem fent clic “I Agree”.
A continuació “Next”.
Deixarem les configuracions per defecte i farem “Next”
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 d'aquí.
Farem Next, i Install.
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.
Una altra opció, és buscar en el menú inferior la icona següent:
S’obrirà un panell on podrem encendre el servidor o apagar-lo.
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.
Copiarem el fixer .war en aquesta ruta.
Hauríem de tenir la carpeta amb el fitxer i la finestra amb el Tomcat obert.
Una vegada tinguem obert aquestes dues pantalles farem click a Start. El programa començarà ha executar el servidor.
Per comprovar que el Tomcat està funcionant haurem d’introduir aquesta url al cercador:
Una vegada està comprovat el que hem de fer per veure el nostre servidor FHIR funcionant és accedir a la següent url:
Per tal de personalitzar diferents paràmetres en el servidor FHIR, haurem d’accedir a un d’aquests fitxers:
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.
Servidor FHIR oficial de l’oficina d’estàndards i interoperabilitat de la Fundació TicSalut