Meddelandestrukturer för händelser
I den här artikeln får du lära dig mer om händelsernas meddelandestrukturer, obligatoriska och icke-efterfrågade element och se exempel på händelsermeddelandenyttolaster.
Viktigt!
Händelser stöder för närvarande följande åtgärder:
FhirResourceCreated – händelsen som genereras efter att en FHIR-resurs har skapats.
FhirResourceUpdated – händelsen som genereras efter att en FHIR-resurs har uppdaterats.
FhirResourceDeleted – händelsen som genereras efter att en FHIR-resurs har tagits bort mjukt.
DicomImageCreated – händelsen som genereras när en DICOM-avbildning har skapats.
DicomImageDeleted – händelsen som genereras efter att en DICOM-avbildning har tagits bort.
DicomImageUpdated – händelsen som genereras när en DICOM-avbildning uppdateras.
Mer information om borttagningstyperna för FHIR-tjänsten finns i REST API-funktioner i FHIR-tjänsten i Azure Health Data Services
Meddelandestruktur för FHIR-händelser
| Namn | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
topic |
string | Ja | Ämnet är Azure-resurs-ID för din Azure Health Data Services-arbetsyta. |
subject |
sträng | Ja | URI (Uniform Resource Identifier) för FHIR-resursen som ändrades. Kunden kan komma åt resursen med ämnet med https:// schema. Kunden bör använda dataVersion eller data.resourceVersionId för att besöka specifik dataversion om den här händelsen. |
eventType |
string(enum) | Ja | Typ av ändring för FHIR-resursen. |
eventTime |
string(datetime) | Ja | UTC-tiden när FHIR-resursändringen har checkats in. |
id |
sträng | Ja | Unik identifierare för händelsen. |
data |
objekt | Ja | Information om FHIR-resursändringshändelser. |
data.resourceType |
string(enum) | Ja | FHIR-resurstypen. |
data.resourceFhirAccount |
sträng | Ja | Tjänstnamnet för FHIR-kontot på Azure Health Data Services-arbetsytan. |
data.resourceFhirId |
sträng | Ja | Resurs-ID för FHIR-kontot. FHIR-tjänsten genererar slumpmässigt ID när en kund skapar resursen. Kunden kan också använda anpassat ID i skapande av FHIR-resurser. ID:t bör dock inte innehålla eller härleda någon PHI/PII-information. Det bör vara en systemmetadata, som inte är specifik för något personligt datainnehåll. |
data.resourceVersionId |
string(number) | Ja | Dataversionen av FHIR-resursen. |
dataVersion |
sträng | Nej | Samma som data.resourceVersionId. |
metadataVersion |
sträng | Nej | Schemaversionen av händelsens metadata. Detta definieras av Azure Event Grid och bör vara konstant för det mesta. |
FHIR-händelsemeddelandeexempel
FhirResourceSkapad händelse
{
"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-händelse
{
"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-händelse
{
"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"
}
Meddelandestruktur för DICOM-händelser
| Namn | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
topic |
string | Ja | Ämnet är Azure-resurs-ID för din Azure Health Data Services-arbetsyta. |
subject |
sträng | Ja | URI (Uniform Resource Identifier) för DICOM-avbildningen som ändrades. Kunden kan komma åt avbildningen med ämnet med https:// schema. Kunden bör använda dataVersion eller data.resourceVersionId för att besöka specifik dataversion om den här händelsen. |
eventType |
string(enum) | Ja | Typ av ändring på DICOM-avbildningen. |
eventTime |
string(datetime) | Ja | UTC-tiden då DICOM-avbildningsändringen checkades in. |
id |
sträng | Ja | Unik identifierare för händelsen. |
data |
objekt | Ja | Information om dicom-avbildningsändringar. |
data.partitionName |
sträng | Nej | Namn på datapartition. |
data.imageStudyInstanceUid |
sträng | Ja | Bildens UID för studieinstans. |
data.imageSeriesInstanceUid |
sträng | Ja | Avbildningens UID för serieinstans. |
data.imageSopInstanceUid |
sträng | Ja | Avbildningens UID för SOP-instans. |
data.serviceHostName |
sträng | Ja | Värdnamnet för DICOM-tjänsten där ändringen inträffade. |
data.sequenceNumber |
heltal | Ja | Sekvensnumret för ändringen i DICOM-tjänsten. Varje bild som skapas och tas bort har en unik sekvens i tjänsten. Det här talet korrelerar med sekvensnumret för DICOM-tjänstens ändringsflöde. Genom att köra frågor mot DICOM-tjänstens ändringsflöde med det här sekvensnumret får du den ändring som skapade händelsen. |
dataVersion |
sträng | Nej | Dataversionen av DICOM-avbildningen. |
metadataVersion |
sträng | Nej | Schemaversionen av händelsens metadata. Detta definieras av Azure Event Grid och bör vara konstant för det mesta. |
Exempel på DICOM-händelsermeddelande
DicomImageSkapad
{
"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"
}
Nästa steg
I den här artikeln har du lärt dig om händelsernas meddelandestrukturer.
Information om hur du distribuerar händelser med hjälp av Azure-portalen finns i
FHIR® är ett registrerat varumärke som tillhör Health Level Seven International, registrerat i U.S. Trademark Office och används med deras tillstånd.