PHR - API framework Android

L'SDK Health Connect Jetpack viene in genere utilizzato per semplificare l'integrazione incapsulando le API Health Connect, ma la PHR non è ancora disponibile in Jetpack, pertanto è necessario utilizzare le API del framework Android sottostanti.

Poiché queste API sono ancora in fase di sviluppo, esistono ancora alcune limitazioni e alcuni componenti non sono completamente disponibili.

  • Le norme di Google Play per l'accesso alle RP sono ancora in fase di sviluppo e le app potrebbero dover soddisfare requisiti aggiuntivi prima di poter essere rilasciate sul Play Store.
  • Alcune funzionalità, come le API basate sui log delle modifiche, non sono ancora state sviluppate per le API PHR.

Se preferisci integrare la RP in app utilizzando Jetpack, ti consigliamo di attendere finché la RP non sarà disponibile in Jetpack e nel frattempo di scoprire di più sulla RP utilizzando questi materiali.

MedicalDataSource

Le cartelle cliniche memorizzate in Connessione Salute sono organizzate in un MedicalDataSource. In questo modo è possibile separare i record medici della stessa persona provenienti da fonti diverse, come API o sistemi sanitari.

Se tutti i record provengono dalla stessa origine, un'app di scrittura deve creare solo un MedicalDataSource. Se i record provengono da più origini, un'app può comunque creare un singolo MedicalDataSource se i dati vengono riconciliati e tutti i record hanno una combinazione univoca di tipo di risorsa FHIR e ID risorsa FHIR. In caso contrario, deve essere creato un MedicalDataSource per ogni origine dati.

Tutti i record medici devono essere associati a un MedicalDataSource, pertanto questo deve essere creato prima di scrivere le risorse.

Proprietà di MedicalDataSource:

  • Nome visualizzato (obbligatorio): il nome visualizzato per l'utente dell'origine dati, identificato in modo univoco per ogni app di scrittura.

  • URI base FHIR (obbligatorio) - Per i dati provenienti da un server FHIR, deve essere l'URL base FHIR (ad esempio https://example.com/fhir/). Se i dati vengono generati da un'app senza un URL FHIR, deve essere un URI univoco e comprensibile definito dall'app (ad esempio myapp://..) che rimandi all'origine dei dati.

    Ad esempio, se un'app client supporta un link diretto dell'app, questo link diretto potrebbe essere utilizzato come URI base FHIR. La lunghezza massima dell'URI è di 2000 caratteri.

  • Nome del pacchetto (compilato automaticamente): l'app che scrive i dati.

  • Versione FHIR (obbligatoria): la versione FHIR. Sono supportate le versioni 4.0.1 e 4.3.0.

  • Allo stesso URL base FHIR possono essere associate più origini dati.

  • All'interno di un'origine dati, tutti i record medici devono avere una combinazione univoca di tipo di risorsa FHIR e ID risorsa FHIR.

MedicalResource

MedicalResource rappresenta una risorsa FHIR memorizzata in Connessione Salute.

Proprietà di MedicalResource:

  • DataSourceId (obbligatorio) - L'origine dati descritta per un MedicalDataSource.
  • Versione FHIR (obbligatoria): la versione FHIR. Sono supportate le versioni 4.0.1 e 4.3.0.
  • Risorsa FHIR (obbligatoria) L'istanza della risorsa FHIR con codifica JSON.
  • Tipo di risorsa sanitaria (compilato automaticamente): la categoria della risorsa rivolta agli utenti, associata alle autorizzazioni rivolte agli utenti.
    • Viene compilato al momento dell'inserimento e dedotto automaticamente da Health Connect.
    • L'insieme iniziale di tipi è descritto in precedenza.