Partage via


Structures des messages d’événements

Dans cet article, découvrez les structures de messages d’événements, les éléments requis et non requis, et consultez des exemples de charges utiles de message d’événements.

Important

Les événements prennent actuellement en charge ces opérations :

  • FhirResourceCreated : événement émis après la création d’une ressource FHIR.

  • FhirResourceUpdated : événement émis après la mise à jour d’une ressource FHIR.

  • FhirResourceDeleted : événement émis après la suppression réversible d’une ressource FHIR.

  • DicomImageCreated : événement émis après la création d’une image DICOM.

  • DicomImageDeleted : événement émis après la suppression réussie d’une image DICOM.

  • DicomImageUpdated : événement émis après la mise à jour réussie d’une image DICOM.

Pour plus d’informations sur les types de suppression de service FHIR, consultez les fonctionnalités de l’API REST dans le service FHIR dans Azure Health Data Services

Structure des messages d’événements FHIR

Nom Type Requise Description
topic string Oui La rubrique est l’ID de ressource Azure de votre espace de travail Azure Health Data Services.
subject string Oui URI (Uniform Resource Identifier) de la ressource FHIR qui a été modifiée. Le client peut accéder à la ressource avec l’objet avec https:// schéma. Le client doit utiliser dataVersion ou data.resourceVersionId pour visiter une version de données spécifique concernant cet événement.
eventType string(enum) Oui Type de modification sur la ressource FHIR.
eventTime string(datetime) Oui Heure UTC lors de la modification de la ressource FHIR validée.
id string Oui Identificateur unique de l’événement.
data object Oui Détails de l’événement de modification de ressource FHIR.
data.resourceType string(enum) Oui Type de ressource FHIR.
data.resourceFhirAccount string Oui Nom du service du compte FHIR dans l’espace de travail Azure Health Data Services.
data.resourceFhirId string Oui ID de ressource du compte FHIR. Le service FHIR génère de façon aléatoire l’ID lorsqu’un client crée la ressource. Le client peut également utiliser l’ID personnalisé dans la création de ressources FHIR ; toutefois, l’ID ne doit pas inclure ni déduire d’informations PHI/PII. Il doit s’agir d’une métadonnées système, non spécifique à tout contenu de données personnelles.
data.resourceVersionId string(number) Oui Version de données de la ressource FHIR.
dataVersion string Non Comme pour data.resourceVersionId.
metadataVersion string No Version du schéma des métadonnées d’événement. Cela est défini par Azure Event Grid et doit être constant la plupart du temps.

Exemples de messages d’événements FHIR

Événement 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"
}

Événement 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"
}

Événement 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"
}

Structure des messages d’événements DICOM

Nom Type Requise Description
topic string Oui La rubrique est l’ID de ressource Azure de votre espace de travail Azure Health Data Services.
subject string Oui URI (Uniform Resource Identifier) de l’image DICOM qui a été modifiée. Le client peut accéder à l’image avec le sujet avec https:// schéma. Le client doit utiliser dataVersion ou data.resourceVersionId pour visiter une version de données spécifique concernant cet événement.
eventType string(enum) Oui Type de modification sur l’image DICOM.
eventTime string(datetime) Oui Heure UTC à laquelle la modification de l’image DICOM a été validée.
id string Oui Identificateur unique de l’événement.
data object Oui Détails de l’événement de modification d’image DICOM.
data.partitionName string Non Nom de la partition de données.
data.imageStudyInstanceUid string Oui UID de l’instance d’étude de l’image.
data.imageSeriesInstanceUid string Oui UID de l’instance de série de l’image.
data.imageSopInstanceUid string Oui UID de l’instance SOP de l’image.
data.serviceHostName string Oui Nom d’hôte du service DICOM où la modification s’est produite.
data.sequenceNumber int Oui Numéro de séquence du changement dans le service DICOM. Chaque création et suppression d’images ont une séquence unique au sein du service. Ce nombre correspond au numéro de séquence du flux de modification du service DICOM. L’interrogation du flux de modification du service DICOM avec ce numéro de séquence vous donne la modification qui a créé cet événement.
dataVersion string Non Version de données de l’image DICOM.
metadataVersion string No Version du schéma des métadonnées d’événement. Cela est défini par Azure Event Grid et doit être constant la plupart du temps.

Exemples de messages d’événements 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"
}

Étapes suivantes

Dans cet article, vous avez découvert les structures de message d’événements.

Pour savoir comment déployer des événements à l’aide de la Portail Azure, consultez

FHIR® est une marque déposée de la Health Level Seven International, enregistrée auprès de l’U.S. Trademark Office et utilisée avec leur autorisation.