FHIR R4
FHIR R4 è lo standard con cui il laboratorio scambia dati clinici strutturati con ospedali, altri sistemi e progetti di ricerca. Il collegamento usa il server FHIR e il token del laboratorio. Serve quando qualcuno, fuori dal gestionale, deve leggere i dati in modo standard invece che con un export su misura.
Cosa fa
Scambio dati clinici standard, bulk export.
Categoria: strumenti e altri sistemi sanitari — Analizzatori, imaging e altri programmi sanitari, senza ribattere i dati.
Cosa serve
- Un server FHIR R4 raggiungibile, di controparte o del laboratorio
- Accordo con la controparte su profili, codifiche e perimetro dei dati
- Base giuridica definita per lo scambio dei dati clinici
Come funziona
Il gestionale dialoga con il server FHIR configurato usando il token del laboratorio, letto solo lato server.
Le chiamate dal browser non portano mai il token: passano da un proxy autenticato che controlla ruolo e permessi e verifica che l’indirizzo appartenga al server configurato.
Le risorse cliniche vengono scambiate nel formato standard, così il destinatario non deve adattarsi al modello dati del gestionale.
Per i grandi volumi il gestionale può avviare una richiesta di export massivo sul server configurato; il pacchetto risultante si recupera dal server di destinazione.
Per le applicazioni di terze parti esiste un percorso di autorizzazione con codice e verifica a prova di intercettazione: l’app riceve un token a scadenza, revocabile in qualsiasi momento dal gestionale.
Quando serve
Quando un ospedale o una rete clinica chiede i dati in formato standard.
Quando serve alimentare un progetto di ricerca o un sistema regionale senza scrivere un connettore dedicato.
Limiti
Oggi il gestionale è la parte che scrive e legge verso un server FHIR esterno. Non espone un proprio archivio FHIR interrogabile dall’esterno: chi deve leggere i dati lo fa dal server configurato.
Il profilo delle risorse e le codifiche vanno concordati con la controparte: FHIR definisce la forma, non i contenuti attesi da ogni progetto.
Senza token configurato le funzioni rispondono con un errore di configurazione e non viene trasferito nulla.
La vecchia forma della variabile esposta al browser va rimossa: il segreto deve restare solo lato server.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `FHIR_R4_TOKEN` — token del laboratorio, solo lato server
- `NEXT_PUBLIC_FHIR_R4_URL` — indirizzo base del server FHIR
- Concorda con la controparte indirizzo del server, profili e modalità di autenticazione.
- Imposta `FHIR_R4_TOKEN` come variabile solo server e rimuovi l’eventuale forma esposta al browser.
- Valorizza `NEXT_PUBLIC_FHIR_R4_URL` con l’indirizzo base.
- Rifai il deploy e verifica che le schermate FHIR risultino configurate.
- Esegui uno scambio di prova su un caso reale e confronta i contenuti con la controparte.
Domande frequenti
Il token lo fornisce il fornitore del software?
No. È rilasciato al laboratorio dal gestore del server FHIR con cui si dialoga.
Cosa succede senza configurazione?
Le funzioni FHIR rispondono con un errore esplicito e nessun dato viene trasferito.
I dati escono dal mio server?
Solo verso la controparte che hai configurato, con il perimetro concordato. Non esistono destinazioni predefinite.
Moduli che la usano
FHIR R4 lavora insieme a questi moduli di LabBox.
Vuoi vedere FHIR R4 collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.