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.