I dati delle cartelle cliniche vengono archiviati nel formato HL7 FHIR.
Medical Records supporta le seguenti versioni di Fast Health Interoperable Resources (FHIR):
Tipi di risorse mediche
FHIR è costituito da un insieme di componenti modulari chiamati risorse. Il set supportato di risorse FHIR e le categorie corrispondenti si basano approssimativamente sulle sezioni del riepilogo internazionale del paziente.
Queste risorse sono mappate alle categorie di dati in Connessione Salute, denominate tipi di risorse mediche nell'API. Le risorse Observation vengono mappate in base a contenuti come i codici e i nomi degli identificatori logici di osservazione (LOINC) e le categorie FHIR.
Le osservazioni che non appartengono a nessuna di queste categorie non vengono scritte in Connessione Salute.
| Tipo di risorsa medica di Connessione Salute | Risorsa o risorse FHIR | Dichiarazione delle autorizzazioni di Connessione Salute |
|---|---|---|
| Allergie | AllergyIntolerance |
android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
|
| Patologie | Condizione |
android.permission.health.READ_MEDICAL_DATA_CONDITIONS
|
| Laboratorio |
Osservazione
|
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
|
| Farmaci | Medication, MedicationRequest, MedicationStatement |
android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
|
| Dettagli personali | Paziente |
android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
|
| Dati del medico | Professionista, PractitionerRole |
android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
|
| Gravidanza |
Osservazione
|
android.permission.health.READ_MEDICAL_DATA_PREGNANCY
|
| Interventi | Procedura |
android.permission.health.READ_MEDICAL_DATA_PROCEDURES
|
| Stile di vita |
Osservazione
|
android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
|
| Vaccini | Immunizzazione |
android.permission.health.READ_MEDICAL_DATA_VACCINES
|
| Visite | Incontro, Luogo, Organizzazione |
android.permission.health.READ_MEDICAL_DATA_VISITS
|
| Parametri vitali |
Osservazione
|
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS
|
Risorse per i pazienti
Al momento, Connessione Salute è pensata per archiviare i dati delle cartelle cliniche di una sola persona. Pertanto, tutte le risorse FHIR scritte devono appartenere alla stessa persona.
Non è raro che in un sistema esistano più risorse FHIR Patient per un singolo individuo. È preferibile che le app riconcilino i dati e scrivano una singola risorsa Paziente in Connessione Salute. Tuttavia, questa impostazione non viene applicata per adattarsi alle diverse strutture organizzative che potrebbero esistere.
Convalida dei dati
Le API per le cartelle cliniche accettano risorse FHIR valide dalle versioni supportate e Connessione Salute esegue alcune convalide per verificare che la specifica FHIR per ogni versione supportata sia rispettata.
I controlli di convalida contrassegnati come In arrivo non sono ancora applicati, ma lo saranno in una release futura. Ti consigliamo di sviluppare in base a tutti i controlli di convalida elencati per mantenere la compatibilità con le versioni future.
| Livello | Controllo di convalida | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| JSON valido | I dati sono conformi al formato JSON. | ||||||||
| FHIR supportato | La versione FHIR dichiarata dall'applicazione di scrittura è supportata. Le seguenti versioni di FHIR sono supportate da Connessione Salute:
|
||||||||
| FHIR supportato | Il tipo di risorsa FHIR registrato nell'istanza della risorsa è supportato. I seguenti tipi di risorse FHIR sono supportati da Connessione Salute:
|
||||||||
| ID risorsa univoco | La risorsa ha un campo ID con un valore che soddisfa i requisiti dell'espressione regolare. | ||||||||
| ID risorsa univoco | La risorsa non condivide un ID con un'altra risorsa FHIR dello stesso tipo di risorsa dello stesso MedicalDataSource. |
||||||||
| Regole aziendali | Non include una risorsa FHIR contenuta. Le risorse contenute sono risorse FHIR nidificate all'interno di una risorsa "padre". Vengono utilizzate quando la risorsa padre deve fare riferimento a un'altra risorsa, ma il sistema non dispone di informazioni sufficienti per crearla come risorsa autonoma con esistenza indipendente. | ||||||||
| FHIR di base valido | I campi di primo livello nel JSON FHIR esistono nella specifica FHIR per il tipo di risorsa specificato. | ||||||||
| FHIR di base valido | I campi di primo livello non hanno valori null JSON. | ||||||||
| FHIR di base valido | Tutti i campi obbligatori di primo livello sono presenti. | ||||||||
| FHIR di base valido | I campi di primo livello definiti come
elementi ripetuti in FHIR hanno un
tipo di dati JSON array. |
||||||||
| FHIR di base valido | I campi di primo livello (inclusi gli elementi all'interno dei array JSON)
definiti come
tipi complessi in FHIR hanno un
tipo di dati object JSON. |
||||||||
| FHIR di base valido | I campi di primo livello (inclusi gli elementi all'interno dei array JSON)
definiti come
tipi primitivi in FHIR hanno il
tipo di dati JSON corretto.
|
||||||||
| FHIR di base valido | I campi di primo livello definiti come tipi primitivi in FHIR soddisfano i requisiti delle espressioni regolari. Disponibile a breve | ||||||||
| FHIR di base valido | Le estensioni ai tipi primitivi
esistono nella specifica FHIR e hanno un tipo di dati JSON object. |
||||||||
| FHIR di base valido | Per i
campi a scelta
(fieldname[x]) viene registrato un solo campo. Ad esempio,
effectiveDateTime e effectivePeriod non possono
essere entrambi presenti nella stessa istanza di risorsa. |
||||||||
| FHIR di base valido | I tipi di dati complessi contengono campi e tipi di dati che corrispondono alla specifica FHIR. Disponibile a breve | ||||||||
| FHIR di base valido | Gli elementi backbone (e gli elementi all'interno di tipi complessi) contengono campi e tipi di dati che corrispondono alla specifica FHIR. Disponibile a breve | ||||||||
| FHIR di base valido | Elemento Estensioni
I campi value[x] sono di un tipo valido e contengono contenuti
in base a quel tipo di dati.
Gli elementi di estensione possono essere inclusi in qualsiasi risorsa per rappresentare
informazioni aggiuntive non incluse nella specifica di base. Contengono un campo
url che rimanda alla definizione dell'estensione e un campo
value[x] che contiene il valore dell'estensione.
value[x] deve provenire da un elenco prestabilito di tipi di dati accettati.
Disponibile a breve |
Dati FHIR trasformati
Alcune app trasformano i dati FHIR per soddisfare i propri requisiti. Ad esempio:
- Unione dei dati provenienti da origini diverse (in genere API FHIR).
- Mappatura dei codici in terminologie globali (ad esempio SNOMED, LOINC, ICD) e standardizzazione delle unità.
- Consolidamento e deduplicazione dei dati.
- Correggere la formattazione o altri problemi relativi alla qualità dei dati.
- Filtrare i record in base a regole aziendali specifiche dell'app.
I dati FHIR non trasformati e trasformati possono essere scritti in Connessione Salute, a condizione che siano conformi alla specifica FHIR R4. Ti consigliamo di scrivere i dati trasformati, se possibile. Tuttavia, tieni presente le seguenti considerazioni:
- Le app con casi d'uso limitati potrebbero filtrare un numero significativo di record da cui altre app dell'ecosistema potrebbero creare valore per gli utenti. In queste situazioni, potrebbe essere utile scrivere il FHIR non trasformato che è più completo. Tuttavia, assicurati di informare gli utenti che questo set di dati più ampio viene condiviso.
- Se unisci dati provenienti da origini diverse, puoi scrivere i dati
in un unico
MedicalDataSourcein Connessione Salute. Devi anche assegnare un nuovo ID a ogni risorsa per evitare conflitti e aggiornare i riferimenti alle risorse in modo che puntino ai nuovi ID. - L'unione di dati provenienti da più origini in un unico
MedicalDataSourcepuò oscurare l'origine dei dati. Poiché spesso è utile per i consumatori di dati comprendere la provenienza dei dati, ti consigliamo di compilare il campometa.sourceper ogni risorsa con l'origine originale del record (in genere un URL di base FHIR).