Эта страница переведена с помощью Cloud Translation API.

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

Это руководство совместимо с Health Connect версии 1.1.0-beta02 .

Чтобы записать медицинские данные с помощью Medical Records в Health Connect, выполните следующие действия:

Проверить наличие функции
Запросить разрешения на запись
Создать источник данных ( MedicalDataSource )
Напишите медицинский ресурс ( 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 Console для вашего приложения, а также в манифесте вашего приложения:

<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)
  }
}

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

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

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

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

Если все записи происходят из одного источника, приложению для написания текстов достаточно создать только один MedicalDataSource . Если записи происходят из нескольких источников, приложение всё равно может создать один 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)

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

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

Свойства MedicalResource :

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

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

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

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

Вставить или обновить записи MedicalResource

Используйте 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 представляла собой допустимую строку FHIR JSON.

Вот пример того, как может выглядеть этот 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)
    )
)