Поделиться через

Структуры сообщений о событиях

  • Статья

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

Внимание

События в настоящее время поддерживают следующие операции:

  • FhirResourceCreated — событие, созданное после успешного создания ресурса FHIR.

  • FhirResourceUpdated — событие, созданное после успешного обновления ресурса FHIR.

  • FhirResourceDeleted — событие, созданное после успешного удаления ресурса FHIR.

  • DicomImageCreated — событие, созданное после успешного создания образа DICOM.

  • DicomImageDeleted — событие, созданное после успешного удаления образа DICOM.

  • DicomImageUpdated — событие, созданное после успешного обновления образа DICOM.

Дополнительные сведения о типах удаления служб FHIR см . в статье о возможностях REST API в службе FHIR в Службах данных Работоспособности Azure

Структура сообщений о событиях FHIR

Имя. Type Обязательно Описание
topic string Да Этот раздел — это идентификатор ресурса Azure рабочей области Служб данных Azure Health.
subject строка Да Универсальный идентификатор ресурса (URI) измененного ресурса FHIR. Клиент может получить доступ к ресурсу с субъектом с помощью схемы https://. Клиент должен использовать dataVersion или data.resourceVersionId, чтобы посетить определенную версию данных относительно этого события.
eventType string(enum) Да Тип изменения ресурса FHIR.
eventTime string(datetime) Да Время UTC при фиксации изменения ресурса FHIR.
id строка Да Уникальный идентификатор события.
data объект Да Сведения о событии изменения ресурса FHIR.
data.resourceType string(enum) Да Тип ресурса FHIR.
data.resourceFhirAccount строка Да Имя службы учетной записи FHIR в рабочей области Служб данных Работоспособности Azure.
data.resourceFhirId строка Да Идентификатор ресурса учетной записи FHIR. Служба FHIR случайно создает идентификатор при создании ресурса клиентом. Клиент также может использовать настраиваемый идентификатор в создании ресурсов FHIR; однако идентификатор не должен включать или выводить какие-либо сведения PHI/PII. Это должны быть системные метаданные, не относящиеся к содержимому персональных данных.
data.resourceVersionId string(number) Да Версия данных ресурса FHIR.
dataVersion строка Нет Эквивалентно data.resourceVersionId.
metadataVersion строка Нет Версия схемы для метаданных события. Это определяется Сетка событий Azure и должно быть константой больше всего времени.

Примеры сообщений о событиях FHIR

Событие FhirResourceCreated

{
  "id": "e4c7f556-d72c-e7f7-1069-1e82ac76ab41",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 1
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceCreated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:14:04.5613214Z"
}

Событие FhirResourceUpdated

{
  "id": "634bd421-8467-f23c-b8cb-f6a31e41c32a",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 2
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceUpdated",
  "dataVersion": "2",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:29:12.0618739Z"
}

Событие FhirResourceDeleted

{
  "id": "ef289b93-3159-b833-3a44-dc6b86ed1a8a",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 3
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceDeleted",
  "dataVersion": "3",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:31:58.5175837Z"
}

Структура сообщений событий DICOM

Имя. Type Обязательно Описание
topic string Да Этот раздел — это идентификатор ресурса Azure рабочей области Служб данных Azure Health.
subject строка Да Универсальный идентификатор ресурса (URI) измененного образа DICOM. Клиент может получить доступ к изображению с темой с помощью схемы https://. Клиент должен использовать dataVersion или data.resourceVersionId, чтобы посетить определенную версию данных относительно этого события.
eventType string(enum) Да Тип изменения образа DICOM.
eventTime string(datetime) Да Время в формате UTC, когда было зафиксировано изменение образа DICOM.
id строка Да Уникальный идентификатор события.
data объект Да Сведения о событии изменения образа DICOM.
data.partitionName строка Нет Имя секции данных.
data.imageStudyInstanceUid строка Да Пользовательский интерфейс экземпляра исследования изображения.
data.imageSeriesInstanceUid строка Да Идентификатор пользовательского интерфейса экземпляра ряда изображения.
data.imageSopInstanceUid строка Да Идентификатор пользовательского интерфейса экземпляра SOP изображения.
data.serviceHostName строка Да Имя узла службы DICOM, в которой произошло изменение.
data.sequenceNumber INT Да Порядковый номер изменения в службе DICOM. Каждое создание и удаление образа имеют уникальную последовательность в службе. Это число коррелирует с порядковым номером канала изменений службы DICOM. Запрос канала изменений службы DICOM с этим порядковым номером дает изменения, созданные этим событием.
dataVersion строка Нет Версия данных образа DICOM.
metadataVersion строка Нет Версия схемы для метаданных события. Это определяется Сетка событий Azure и должно быть константой больше всего времени.

Примеры сообщений о событиях DICOM

DicomImageCreated

{
  "id": "d621839d-958b-4142-a638-bb966b4f7dfd",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 1
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageCreated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2022-09-15T01:14:04.5613214Z"
}

DicomImageDeleted

{
  "id": "eac1c1a0-ffa8-4b28-97cc-1d8b9a0a6021",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 2
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageDeleted",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2022-09-15T01:16:07.5692209Z"
}

DicomImageUpdated

{
  "id": "83cb0f51-af41-e58c-3c6c-46344b349bc5",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 2
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageUpdated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2023-06-09T16:55:44.7197137Z"
}

Следующие шаги

В этой статье вы узнали о структурах сообщений о событиях.

Сведения о развертывании событий с помощью портал Azure см. в статье

Развертывание событий с помощью портал Azure

FHIR® является зарегистрированным товарным знаком уровня здравоохранения Seven International, зарегистрированным в Офисе товарных знаков США и используется с их разрешением.