Nachrichtenstrukturen von Ereignissen
In diesem Artikel erfahren Sie mehr über die Ereignisnachrichtenstrukturen, erforderliche und nicht angeforderte Elemente und finden Sie beispiele für Ereignisnachrichtennutzlasten.
Wichtig
Ereignisse unterstützen derzeit diese Vorgänge:
FhirResourceCreated – Das Ereignis, das ausgegeben wird, nachdem eine FHIR-Ressource erfolgreich erstellt wurde.
FhirResourceUpdated – Das Ereignis, das ausgegeben wird, nachdem eine FHIR-Ressource erfolgreich aktualisiert wurde.
FhirResourceDeleted – Das Ereignis, das ausgegeben wird, nachdem eine FHIR-Ressource erfolgreich gelöscht wurde.
DicomImageCreated – Das Ereignis, das nach erfolgreicher Erstellung eines DICOM-Images ausgegeben wird.
DicomImageDeleted – Das Ereignis, das ausgegeben wird, nachdem ein DICOM-Image erfolgreich gelöscht wurde.
DicomImageUpdated – Das Ereignis, das ausgegeben wird, nachdem ein DICOM-Image erfolgreich aktualisiert wurde.
Weitere Informationen zu den Löschtypen des FHIR-Diensts finden Sie unter REST-API-Funktionen im FHIR-Dienst in Azure Health Data Services
Nachrichtenstruktur für FHIR-Ereignisse
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
topic |
Zeichenfolge | Ja | Das Thema ist die Azure-Ressourcen-ID Ihres Azure Health Data Services-Arbeitsbereichs. |
subject |
Zeichenfolge | Ja | Der URI (Uniform Resource Identifier) der geänderten FHIR-Ressource. Der Kunde kann mit https:// Schema auf die Ressource mit dem Betreff zugreifen. Der Kunde sollte die dataVersion oder data.resourceVersionId verwenden, um bestimmte Datenversion zu diesem Ereignis zu besuchen. |
eventType |
string(enum) | Ja | Der Typ der Änderung für die FHIR-Ressource. |
eventTime |
string(datetime) | Ja | Die UTC-Zeit, zu der die FHIR-Ressourcenänderung zugesichert wurde. |
id |
Zeichenfolge | Ja | Eindeutiger Bezeichner für das Ereignis. |
data |
Objekt | Ja | Details des FHIR-Ressourcenänderungsereignisses. |
data.resourceType |
string(enum) | Ja | Der FHIR-Ressourcentyp. |
data.resourceFhirAccount |
Zeichenfolge | Ja | Der Dienstname des FHIR-Kontos im Azure Health Data Services-Arbeitsbereich. |
data.resourceFhirId |
Zeichenfolge | Ja | Die Ressourcen-ID des FHIR-Kontos. Der FHIR-Dienst generiert zufällig die ID, wenn ein Kunde die Ressource erstellt. Der Kunde kann auch benutzerdefinierte ID in der FHIR-Ressourcenerstellung verwenden; Die ID sollte jedoch keine PHI/PII-Informationen enthalten oder ableiten. Es sollte sich um eine Systemmetadaten, nicht spezifisch für personenbezogene Dateninhalte, sein. |
data.resourceVersionId |
string(number) | Ja | Die Datenversion der FHIR-Ressource. |
dataVersion |
Zeichenfolge | No | Wie in data.resourceVersionId. |
metadataVersion |
Zeichenfolge | Nein | Die Schemaversion der Ereignismetadaten. Dies wird von Azure Event Grid definiert und sollte die meiste Zeit konstant sein. |
Nachrichtenbeispiele für FHIR-Ereignisse
FhirResourceCreated-Ereignis
{
"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-Ereignis
{
"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-Ereignis
{
"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"
}
DICOM-Ereignisnachrichtenstruktur
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
topic |
Zeichenfolge | Ja | Das Thema ist die Azure-Ressourcen-ID Ihres Azure Health Data Services-Arbeitsbereichs. |
subject |
Zeichenfolge | Ja | Der URI (Uniform Resource Identifier) des geänderten DICOM-Bilds. Der Kunde kann mit https:// Schema auf das Bild mit dem Betreff zugreifen. Der Kunde sollte die dataVersion oder data.resourceVersionId verwenden, um bestimmte Datenversion zu diesem Ereignis zu besuchen. |
eventType |
string(enum) | Ja | Der Typ der Änderung für das DICOM-Image. |
eventTime |
string(datetime) | Ja | Die UTC-Zeit, zu der die DICOM-Bildänderung übernommen wurde. |
id |
Zeichenfolge | Ja | Eindeutiger Bezeichner für das Ereignis. |
data |
Objekt | Ja | DETAILS des DICOM-Bildänderungsereignisses. |
data.partitionName |
Zeichenfolge | No | Datenpartitionsname. |
data.imageStudyInstanceUid |
Zeichenfolge | Ja | Die Uid der Studieninstanz des Bilds. |
data.imageSeriesInstanceUid |
Zeichenfolge | Ja | Die Serieninstanz-UID des Bilds. |
data.imageSopInstanceUid |
Zeichenfolge | Ja | Die SOP-Instanz-UID des Bilds. |
data.serviceHostName |
Zeichenfolge | Ja | Der Hostname des DICOM-Diensts, in dem die Änderung aufgetreten ist. |
data.sequenceNumber |
int | Ja | Die Sequenznummer der Änderung im DICOM-Dienst. Jede Bilderstellung und -löschung verfügt über eine eindeutige Sequenz innerhalb des Diensts. Diese Zahl korreliert mit der Sequenznummer des Änderungsfeeds des DICOM-Diensts. Durch Abfragen des DICOM-Dienständerungsfeeds mit dieser Sequenznummer erhalten Sie die Änderung, die dieses Ereignis erstellt hat. |
dataVersion |
Zeichenfolge | No | Die Datenversion des DICOM-Images. |
metadataVersion |
Zeichenfolge | Nein | Die Schemaversion der Ereignismetadaten. Dies wird von Azure Event Grid definiert und sollte die meiste Zeit konstant sein. |
DICOM-Ereignismeldungsbeispiele
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"
}
Nächste Schritte
In diesem Artikel haben Sie mehr über die Ereignisnachrichtenstrukturen erfahren.
Informationen zum Bereitstellen von Ereignissen mithilfe des Azure-Portal finden Sie unter
FHIR® ist eine eingetragene Marke von Health Level Seven International, eingetragen im U.S. Trademark Office und wird mit deren Genehmigung verwendet.