Por lo general, el SDK de Health Connect para Jetpack se usa para simplificar la integración uniendo las APIs de Health Connect, pero la PHR aún no está disponible en Jetpack, por lo que se deben usar las APIs subyacentes del framework de Android.
Como estas APIs aún están en desarrollo, aún existen algunas limitaciones y algunos componentes no están disponibles por completo.
- La Política de Play para el acceso a la PHR aún está en desarrollo, y es posible que las apps deban cumplir con requisitos adicionales para poder lanzarse en Play Store.
- Algunas funciones, como las APIs basadas en registros de cambios, aún no se desarrollaron para las APIs de PHR.
Si prefieres integrar la PHR en tu app con Jetpack, te sugerimos que esperes hasta que la PHR esté disponible en Jetpack y, mientras tanto, aprendas sobre ella con estos materiales.
MedicalDataSource
Los registros médicos almacenados en Health Connect se organizan en un MedicalDataSource. Esto permite separar los registros médicos de la misma persona que provienen de diferentes fuentes, como APIs o sistemas de atención médica.
Si todos los registros provienen de la misma fuente, una app de escritura solo necesita crear un MedicalDataSource. Si los registros provienen de varias fuentes, una app puede crear un solo MedicalDataSource si se concilian esos datos y todos los registros tienen una combinación única de tipo de recurso y ID de recurso de FHIR.
De lo contrario, se debe crear un MedicalDataSource para cada fuente de datos.
Todos los registros médicos deben estar asociados con un MedicalDataSource, por lo que se debe crear antes de escribir los recursos.
Propiedades de MedicalDataSource:
- Nombre visible (obligatorio): Es el nombre visible para el usuario de la fuente de datos, que se identifica de forma única por app de escritura.
URI base de FHIR (obligatorio): Para los datos que provienen de un servidor de FHIR, esta debe ser la URL base de FHIR (por ejemplo,
https://example.com/fhir/). Si una app genera los datos sin una URL de FHIR, este debe ser un URI único y comprensible que defina la app (por ejemplo,myapp://..) y que apunte a la fuente de los datos.A modo de ejemplo, si una app cliente admite un vínculo directo de app, este vínculo directo se puede usar como el URI base de FHIR. La longitud máxima del URI es de 2,000 caracteres.
Nombre del paquete (se propaga automáticamente): Es la app que escribe los datos.
Versión de FHIR (obligatoria): Es la versión de FHIR. Se admiten las versiones 4.0.1 y 4.3.0.
Se pueden asociar varias fuentes de datos con la misma URL base de FHIR.
Dentro de una fuente de datos, todos los registros médicos deben tener una combinación única de tipo de recurso de FHIR y ID de recurso de FHIR.
MedicalResource
MedicalResource representa un recurso de FHIR almacenado en Health Connect.
Propiedades de MedicalResource:
- DataSourceId (obligatorio): Es la fuente de datos como se describe para un
MedicalDataSource. - Versión de FHIR (obligatoria): Es la versión de FHIR. Se admiten las versiones 4.0.1 y 4.3.0.
- Recurso de FHIR (obligatorio): Es la instancia del recurso de FHIR codificado en JSON.
- Tipo de recurso médico (se completa automáticamente): Es la categoría del recurso para el usuario, que se asigna a los permisos para el usuario.
- Se completa en el momento de la inserción y Health Connect lo obtiene automáticamente.
- El conjunto inicial de tipos se describió antes.