Structures des messages d’événements
Dans cet article, découvrez les structures de message d’événements, les éléments obligatoires et non requis, et consultez des exemples de charges utiles de message d’événements.
Important
Les événements prennent actuellement en charge les opérations suivantes :
FhirResourceCreated : événement émis après la création d’une ressource FHIR.
FhirResourceUpdated : événement émis après la mise à jour réussie 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 d’une image DICOM.
DicomImageUpdated : événement émis après la mise à jour d’une image DICOM.
Pour plus d’informations sur les types de suppression du service FHIR, consultez Fonctionnalités de l’API REST FHIR pour le service FHIR Azure Health Data Services
Structure de message des événements FHIR
Nom | Type | Obligatoire | 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 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 la ressource FHIR. |
eventTime |
string(datetime) | Oui | Heure UTC à laquelle la ressource FHIR est 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 de 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 manière aléatoire l’ID lorsqu’un client crée la ressource. Le client peut également utiliser un ID personnalisé dans la création de ressources FHIR ; toutefois, l’ID ne doit pas inclure ou déduire des informations phi/PII. Il doit s’agir d’une métadonnées système, non spécifique à un 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 de message des événements DICOM
Nom | Type | Obligatoire | 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 séquentiel de la modification dans le service DICOM. Chaque création et suppression d’image a une séquence unique au sein du service. Ce nombre est corrélé 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. Celle-ci est définie par Azure Event Grid et doit être constante 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 des messages 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.