Freigeben über

Nachrichtenstrukturen von Ereignissen

  • Artikel

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

Schnellstart: Bereitstellen von Ereignissen mit dem Azure-Portal

FHIR® ist eine eingetragene Marke von Health Level Seven International, eingetragen im U.S. Trademark Office und wird mit deren Genehmigung verwendet.