Напишите медицинские данные

Данное руководство совместимо с версией Health Connect 1.1.0-beta02 .

Для записи медицинских данных с помощью раздела «Медицинские записи» в Health Connect выполните следующие действия:

  1. Проверьте доступность функции.
  2. Запросить права на запись
  3. Создайте источник данных ( MedicalDataSource ).
  4. Напишите медицинский справочник ( MedicalResource ).

Доступность функций

Чтобы определить, поддерживает ли устройство пользователя функцию «Медицинские записи» в Health Connect, проверьте наличие параметра FEATURE_PERSONAL_HEALTH_RECORD на клиентском устройстве:

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_PERSONAL_HEALTH_RECORD
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
} else {
  // Feature isn't available
}
Для получения более подробной информации см. раздел «Проверка доступности функции» .

Необходимые разрешения

Запись медицинских данных защищена следующим разрешением:

  • android.permission.health.WRITE_MEDICAL_DATA

Укажите эти разрешения в консоли Play для вашего приложения, а также в манифесте вашего приложения:

<application>
  <uses-permission
android:name="android.permission.health.WRITE_MEDICAL_DATA" />
</application>

Вы несёте ответственность за предоставление всех необходимых разрешений, которые вы собираетесь использовать на своих устройствах и в приложениях. Также вам следует убедиться, что каждое разрешение было предоставлено пользователем до начала использования.

Запросить у пользователя разрешения

После создания экземпляра клиента ваше приложение должно запросить у пользователя разрешения. Пользователи должны иметь возможность предоставлять или отклонять разрешения в любое время.

Для этого создайте набор разрешений для необходимых типов данных. Убедитесь, что разрешения в этом наборе сначала объявлены в вашем Android-манифесте.

// Create a set of permissions for required data types
import androidx.health.connect.client.permission.HealthPermission.Companion.PERMISSION_WRITE_MEDICAL_DATA

val PERMISSIONS =
    setOf(
       PERMISSION_WRITE_MEDICAL_DATA
)

Используйте getGrantedPermissions , чтобы проверить, предоставлены ли вашему приложению уже необходимые разрешения. Если нет, используйте createRequestPermissionResultContract для запроса этих разрешений. После этого отобразится экран разрешений Health Connect.

// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()

val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions successfully granted
  } else {
    // Lack of required permissions
  }
}

suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
  val granted = healthConnectClient.permissionController.getGrantedPermissions()
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions already granted; proceed with inserting or reading data
  } else {
    requestPermissions.launch(PERMISSIONS)
  }
}

Поскольку пользователи могут предоставлять или отзывать разрешения в любое время, ваше приложение должно проверять наличие разрешений каждый раз перед их использованием и обрабатывать сценарии, в которых разрешение утрачивается.

Источники данных

В Health Connect объект MedicalDataSource представляет собой источник данных, доступный пользователю, например, медицинскую организацию, больницу или API.

Медицинские записи, хранящиеся в Health Connect, организованы в MedicalDataSource . Это позволяет разделять медицинские записи одного и того же человека, поступающие из разных источников, таких как API или системы здравоохранения.

При создании записей MedicalDataSource следует учитывать следующее:

  • Если все записи поступают из одного источника, создайте один MedicalDataSource .
  • Если записи поступают из нескольких источников, вы можете создать единый MedicalDataSource если:
    • Данные согласованы.
    • Все записи имеют уникальную комбинацию типа ресурса FHIR и идентификатора ресурса FHIR. В рамках MedicalDataSource может существовать только одна запись типа ресурса FHIR с любым идентификатором ресурса FHIR.
  • В противном случае, чтобы предотвратить дублирование идентификаторов, создайте объект MedicalDataSource для каждого источника данных.

Все медицинские записи должны быть связаны с MedicalDataSource , поэтому его необходимо создать до записи ресурсов.

Свойства MedicalDataSource :

  • Отображаемое имя (обязательно) — отображаемое пользователю имя источника данных, уникально идентифицируемое для каждого приложения для ввода данных.

  • Базовый URI FHIR (обязательно) — для данных, поступающих с сервера FHIR, это должен быть базовый URL FHIR (например, https://example.com/fhir/ ). К одному и тому же базовому URL FHIR может быть привязано несколько источников данных.

    Если данные генерируются приложением без URL-адреса FHIR, это должен быть уникальный и понятный URI, определенный приложением (например, myapp://.. ), указывающий на источник данных.

    Например, если клиентское приложение поддерживает глубокие ссылки , эта глубокая ссылка может использоваться в качестве базового URI FHIR. Максимальная длина URI составляет 2000 символов.

  • Название пакета (заполняется автоматически) - приложение, записывающее данные.

  • Версия FHIR (обязательно) - Версия FHIR. Должна быть поддерживаемой версией .

Создайте запись в MedicalDataSource.

Создайте запись для каждой медицинской организации или учреждения, с которым связано ваше приложение.

// Create a `MedicalDataSource`
// Note that `displayName` must be unique across `MedicalDataSource`s
// Each `MedicalDataSource` is assigned an `id` by the system on creation
val medicalDataSource: MedicalDataSource =
    healthConnectClient.createMedicalDataSource(
        CreateMedicalDataSourceRequest(
            fhirBaseUri = Uri.parse("https://fhir.com/oauth/api/FHIR/R4/"),
            displayName = "Test Data Source",
            fhirVersion = FhirVersion(4, 0, 1)
        )
    )

Удаление записи из MedicalDataSource

В предыдущем примере система возвращает id при создании записи. Если вам нужно удалить запись MedicalDataSource , укажите тот же id :

// Delete the `MedicalDataSource` that has the specified `id`
healthConnectClient.deleteMedicalDataSourceWithData(medicalDataSource.id)

Медицинские ресурсы

В Health Connect объект MedicalResource представляет собой ресурс FHIR (содержащий медицинскую карту) вместе с метаданными.

Свойства MedicalResource :

  • DataSourceId (обязательно) - Источник данных, как описано для MedicalDataSource .
  • Версия FHIR (обязательно) - Версия FHIR. Должна быть поддерживаемой версией .
  • Ресурс FHIR (обязательно) Экземпляр ресурса FHIR в формате JSON.
  • Тип медицинского ресурса (заполняется автоматически) — категория ресурса, доступная пользователю , которая сопоставляется с правами доступа пользователя.

Подготовка ресурсов FHIR в формате JSON

Перед записью медицинских ресурсов в Health Connect подготовьте записи ресурсов FHIR в формате JSON. Сохраните каждый JSON-файл в отдельной переменной для последующей вставки в качестве медицинского ресурса.

Если вам нужна помощь с форматом FHIR JSON, обратитесь к примерам данных, предоставленным организацией HL7 .

Вставить или обновить записи медицинских ресурсов

Используйте UpsertMedicalResourceRequest для вставки новых или обновления существующих записей MedicalResource для MedicalDataSource :

// Insert `MedicalResource`s into the `MedicalDataSource`
val medicalResources: List<MedicalResource> =
    healthConnectClient.upsertMedicalResources(
        listOf(
            UpsertMedicalResourceRequest(
                medicalDataSource.id,
                medicalDataSource.fhirVersion,
                medicationJsonToInsert // a valid FHIR json string
            )
        )
    )

// Update `MedicalResource`s in the `MedicalDataSource`
val updatedMedicalResources: List<MedicalResource> =
    healthConnectClient.upsertMedicalResources(
        listOf(
            UpsertMedicalResourceRequest(
                medicalDataSource.id,
                medicalDataSource.fhirVersion,
                // a valid FHIR json string
                // if this resource has the same type and ID as in `medicationJsonToInsert`,
                // this `upsertMedicalResources()` call will update the previously inserted
                // `MedicalResource`
                updatedMedicationJsonToInsert
            )
        )
    )

Пример ресурса FHIR

В предыдущем примере переменная medicationJsonToInsert представляла собой допустимую строку JSON в формате FHIR.

Вот пример того, как может выглядеть этот JSON, используя AllergyIntolerance в качестве типа ресурса FHIR, который будет соответствовать типу медицинского ресурса FHIR_RESOURCE_TYPE_ALLERGY_INTOLERANCE в медицинских записях:

{
  "resourceType": "AllergyIntolerance",
  "id": "allergyintolerance-1",
  "criticality": "high",
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "91936005",
        "display": "Penicillin allergy"
      }
    ],
    "text": "Penicillin allergy"
  },
  "recordedDate": "2020-10-09T14:58:00+00:00",
   "asserter": {
    "reference": "Patient/patient-1"
  },
  "lastOccurrence": "2020-10-09",
  "patient": {
    "reference": "Patient/patient-1",
    "display": "B., Alex"
  }
  ...
}

Удаление записи MedicalResource

Записи MedicalResource могут быть удалены по идентификатору:

// Delete `MedicalResource`s matching the specified `dataSourceId`, `type` and `fhirResourceId`
healthConnectClient.deleteMedicalResources(
    medicalResources.map { medicalResource: MedicalResource ->
        MedicalResourceId(
            dataSourceId = medicalDataSource.id,
            fhirResourceType = medicalResource.id.fhirResourceType,
            fhirResourceId = medicalResource.id.fhirResourceId
        )
    }
)

Или же их можно удалить с помощью medicalResourceType : 

// Delete all `MedicalResource`s that are in any pair of provided `dataSourceIds` and
// `medicalResourceTypes`
healthConnectClient.deleteMedicalResources(
    DeleteMedicalResourcesRequest(
        dataSourceIds = setOf(medicalDataSource.id),
        medicalResourceTypes = setOf(MEDICAL_RESOURCE_TYPE_MEDICATIONS)
    )
)
Назад
Формат данных
Далее
Читать медицинские данные