Ací es mostren les diferències entre la revisió seleccionada i la versió actual de la pàgina.
ca:contenidos:estandares:hl7fhir:instalacionpers [2020/04/27 09:17] funciona creat |
ca:contenidos:estandares:hl7fhir:instalacionpers [2020/04/28 09:23] (actual) funciona |
||
---|---|---|---|
Línia 1: | Línia 1: | ||
====== HAPI FHIR SERVER PERSONALITZAT ====== | ====== HAPI FHIR SERVER PERSONALITZAT ====== | ||
- | En edició | + | |
+ | ===== 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/]] |