Estructuras de mensajes de eventos

  • Artículo

En este artículo, obtenga información sobre las estructuras de mensajes de eventos, los elementos requeridos y no solicitados y vea ejemplos de cargas de mensajes de eventos.

Importante

Actualmente, los eventos admiten estas operaciones:

  • FhirResourceCreated : el evento emitido después de que se cree correctamente un recurso de FHIR.

  • FhirResourceUpdated : el evento emitido después de que un recurso de FHIR se actualice correctamente.

  • FhirResourceDeleted : el evento emitido después de que un recurso de FHIR se elimine correctamente correctamente.

  • DicomImageCreated : el evento emitido después de crear correctamente una imagen DICOM.

  • DicomImageDeleted : el evento emitido después de que una imagen DICOM se elimine correctamente.

  • DicomImageUpdated : el evento emitido después de que una imagen DICOM se actualice correctamente.

Para más información sobre los tipos de eliminación del servicio FHIR, consulte Funcionalidades de la API REST en el servicio FHIR en Azure Health Data Services.

Estructura de mensajes de eventos de FHIR

Nombre Type Obligatorio Description
topic string Sí El tema es el identificador de recurso de Azure del área de trabajo de Azure Health Data Services.
subject string Sí Identificador uniforme de recursos (URI) del recurso de FHIR que se cambió. El cliente puede acceder al recurso con el asunto con https:// esquema. El cliente debe usar dataVersion o data.resourceVersionId para visitar la versión de datos específica con respecto a este evento.
eventType string(enum) Sí Tipo de cambio en el recurso de FHIR.
eventTime string(datetime) Sí Hora UTC en la que se confirma el cambio de recurso de FHIR.
id string Sí Identificador único para el evento
data objeto Sí Detalles del evento de cambio de recursos de FHIR.
data.resourceType string(enum) Sí Tipo de recurso FHIR.
data.resourceFhirAccount string Sí Nombre de servicio de la cuenta de FHIR en el área de trabajo de Azure Health Data Services.
data.resourceFhirId string Sí Identificador de recurso de la cuenta de FHIR. El servicio FHIR genera aleatoriamente el identificador cuando un cliente crea el recurso. El cliente también puede usar el identificador personalizado en la creación de recursos de FHIR; sin embargo, el identificador no debe incluir ni deducir ninguna información de PHI/PII. Debe ser un metadato del sistema, no específico de ningún contenido de datos personales.
data.resourceVersionId string(number) Sí Versión de datos del recurso de FHIR.
dataVersion string No Igual que data.resourceVersionId.
metadataVersion string No Versión del esquema de los metadatos del evento. Esto se define mediante Azure Event Grid y debe ser constante la mayor parte del tiempo.

Ejemplos de mensajes de eventos de FHIR

evento 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"
}

evento 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"
}

evento 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"
}

Estructura de mensajes de eventos DICOM

Nombre Type Obligatorio Description
topic string Sí El tema es el identificador de recurso de Azure del área de trabajo de Azure Health Data Services.
subject string Sí Identificador uniforme de recursos (URI) de la imagen DICOM que se cambió. El cliente puede acceder a la imagen con el asunto con https:// esquema. El cliente debe usar dataVersion o data.resourceVersionId para visitar la versión de datos específica con respecto a este evento.
eventType string(enum) Sí Tipo de cambio en la imagen DICOM.
eventTime string(datetime) Sí Hora UTC en la que se confirmó el cambio de imagen DICOM.
id string Sí Identificador único para el evento
data objeto Sí Detalles del evento de cambio de imagen DICOM.
data.partitionName string No Nombre de la partición de datos.
data.imageStudyInstanceUid string Sí UID de la instancia de estudio de la imagen.
data.imageSeriesInstanceUid string Sí UID de la instancia de la serie de la imagen.
data.imageSopInstanceUid string Sí UID de instancia SOP de la imagen.
data.serviceHostName string Sí Nombre de host del servicio DICOM donde se produjo el cambio.
data.sequenceNumber int Sí Número de secuencia del cambio en el servicio DICOM. Cada creación y eliminación de imágenes tiene una secuencia única dentro del servicio. Este número se correlaciona con el número de secuencia de la fuente de cambios del servicio DICOM. Consultar la fuente de cambios del servicio DICOM con este número de secuencia proporciona el cambio que creó este evento.
dataVersion string No Versión de datos de la imagen DICOM.
metadataVersion string No Versión del esquema de los metadatos del evento. Esto se define mediante Azure Event Grid y debe ser constante la mayor parte del tiempo.

Ejemplos de mensajes de eventos 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"
}

Pasos siguientes

En este artículo, ha obtenido información sobre las estructuras de mensajes de eventos.

Para obtener información sobre cómo implementar eventos mediante Azure Portal, consulte

Implementación de eventos mediante Azure Portal

FHIR® es una marca registrada de Health Level Seven International, registrada en la Oficina de Patentes y Marcas Registradas de Estados Unidos, y se usa con su permiso.