Delen via

Berichtstructuren voor gebeurtenissen

  • Artikel

In dit artikel vindt u informatie over de structuur van gebeurtenissenberichten, vereiste en niet-vereiste elementen en bekijkt u voorbeelden van nettoladingen van gebeurtenissenberichten.

Belangrijk

Gebeurtenissen ondersteunen momenteel deze bewerkingen:

  • FhirResourceCreated : de gebeurtenis die wordt verzonden nadat een FHIR-resource is gemaakt.

  • FhirResourceUpdated : de gebeurtenis die wordt verzonden nadat een FHIR-resource is bijgewerkt.

  • FhirResourceDeleted : de gebeurtenis die wordt verzonden nadat een FHIR-resource voorlopig is verwijderd.

  • DicomImageCreated : de gebeurtenis die wordt verzonden nadat een DICOM-installatiekopie is gemaakt.

  • DicomImageDeleted : de gebeurtenis die wordt verzonden nadat een DICOM-installatiekopie is verwijderd.

  • DicomImageUpdated : de gebeurtenis die wordt verzonden nadat een DICOM-installatiekopie is bijgewerkt.

Zie REST API-mogelijkheden in de FHIR-service in Azure Health Data Services voor meer informatie over de verwijderingstypen van de FHIR-service

Berichtstructuur FHIR-gebeurtenissen

Name Type Vereist Beschrijving
topic string Ja Het onderwerp is de Azure-resource-id van uw Azure Health Data Services-werkruimte.
subject tekenreeks Ja De URI (Uniform Resource Identifier) van de FHIR-resource die is gewijzigd. De klant heeft toegang tot de resource met het onderwerp met https:// schema. De klant moet de dataVersion of data.resourceVersionId gebruiken om een specifieke gegevensversie met betrekking tot deze gebeurtenis te bezoeken.
eventType string(enum) Ja Het type wijziging in de FHIR-resource.
eventTime tekenreeks(datum/tijd) Ja De UTC-tijd waarop de FHIR-resource is gewijzigd.
id tekenreeks Ja Unieke id voor de gebeurtenis.
data object Ja Gebeurtenisdetails van FHIR-resourcewijziging.
data.resourceType string(enum) Ja Het FHIR-resourcetype.
data.resourceFhirAccount tekenreeks Ja De servicenaam van het FHIR-account in de Azure Health Data Services-werkruimte.
data.resourceFhirId tekenreeks Ja De resource-id van het FHIR-account. De FHIR-service genereert de id willekeurig wanneer een klant de resource maakt. De klant kan ook aangepaste id gebruiken bij het maken van FHIR-resources; de id mag echter geen PHI/PII-gegevens bevatten of afleiden. Het moet een systeemmetagegevens zijn, niet specifiek voor persoonlijke gegevens.
data.resourceVersionId tekenreeks(getal) Ja De gegevensversie van de FHIR-resource.
dataVersion tekenreeks Nee Hetzelfde als data.resourceVersionId.
metadataVersion tekenreeks Nee De schemaversie van de metagegevens van de gebeurtenis. Dit wordt gedefinieerd door Azure Event Grid en moet de meeste tijd constant zijn.

Voorbeelden van FHIR-gebeurtenissen

FhirResourceCreated-gebeurtenis

{
  "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-gebeurtenis

{
  "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-gebeurtenis

{
  "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"
}

Berichtstructuur DICOM-gebeurtenissen

Name Type Vereist Beschrijving
topic string Ja Het onderwerp is de Azure-resource-id van uw Azure Health Data Services-werkruimte.
subject tekenreeks Ja De URI (Uniform Resource Identifier) van de DICOM-installatiekopieën die zijn gewijzigd. De klant heeft toegang tot de afbeelding met het onderwerp met https:// schema. De klant moet de dataVersion of data.resourceVersionId gebruiken om een specifieke gegevensversie met betrekking tot deze gebeurtenis te bezoeken.
eventType string(enum) Ja Het type wijziging op de DICOM-installatiekopie.
eventTime tekenreeks(datum/tijd) Ja De UTC-tijd waarop de DICOM-installatiekopieën zijn gewijzigd.
id tekenreeks Ja Unieke id voor de gebeurtenis.
data object Ja Gebeurtenisdetails van DICOM-installatiekopieën wijzigen.
data.partitionName tekenreeks Nee Naam van gegevenspartitie.
data.imageStudyInstanceUid tekenreeks Ja De UID van het onderzoekexemplaren van de afbeelding.
data.imageSeriesInstanceUid tekenreeks Ja De UID van de serieinstantie van de afbeelding.
data.imageSopInstanceUid tekenreeks Ja De UID van de SOP-instantie van de installatiekopieën.
data.serviceHostName tekenreeks Ja De hostnaam van de DICOM-service waar de wijziging is opgetreden.
data.sequenceNumber int Ja Het volgnummer van de wijziging in de DICOM-service. Elke installatiekopie die wordt gemaakt en verwijderd, heeft een unieke reeks binnen de service. Dit getal correleert met het volgnummer van de wijzigingenfeed van de DICOM-service. Als u een query uitvoert op de DICOM-servicewijzigingsfeed met dit volgnummer, krijgt u de wijziging die deze gebeurtenis heeft gemaakt.
dataVersion tekenreeks Nee De gegevensversie van de DICOM-installatiekopieën.
metadataVersion tekenreeks Nee De schemaversie van de metagegevens van de gebeurtenis. Dit wordt gedefinieerd door Azure Event Grid en moet de meeste tijd constant zijn.

Voorbeelden van DICOM-gebeurtenissen

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"
}

Volgende stappen

In dit artikel hebt u geleerd over de berichtstructuren voor gebeurtenissen.

Zie Voor meer informatie over het implementeren van gebeurtenissen met behulp van Azure Portal

Gebeurtenissen implementeren met behulp van Azure Portal

FHIR® is een geregistreerd handelsmerk van Health Level Seven International, geregistreerd in het Amerikaanse handelsmerkbureau en wordt gebruikt met hun toestemming.