Struktury komunikatów zdarzeń

  • Artykuł

W tym artykule dowiesz się więcej o strukturach komunikatów zdarzeń, wymaganych i nienależących do potrzeb oraz zobacz przykłady ładunków komunikatów zdarzeń.

Ważne

Zdarzenia obecnie obsługują następujące operacje:

  • FhirResourceCreated — zdarzenie emitowane po pomyślnym utworzeniu zasobu FHIR.

  • FhirResourceUpdated — zdarzenie emitowane po pomyślnym zaktualizowaniu zasobu FHIR.

  • FhirResourceDeleted — zdarzenie emitowane po pomyślnym usunięciu zasobu FHIR.

  • DicomImageCreated — zdarzenie emitowane po pomyślnym utworzeniu obrazu DICOM.

  • DicomImageDeleted — zdarzenie emitowane po pomyślnym usunięciu obrazu DICOM.

  • DicomImageUpdated — zdarzenie emitowane po pomyślnym zaktualizowaniu obrazu DICOM.

Aby uzyskać więcej informacji na temat typów usuwania usługi FHIR, zobacz funkcje interfejsu API REST FHIR dla usługi Azure Health Data Services FHIR

Struktura komunikatów zdarzeń FHIR

Nazwa Typ Wymagane Opis
topic ciąg Tak Tematem jest identyfikator zasobu platformy Azure w obszarze roboczym usługi Azure Health Data Services.
subject ciąg Tak Identyfikator URI (Uniform Resource Identifier) zasobu FHIR, który został zmieniony. Klient może uzyskać dostęp do zasobu za pomocą tematu za pomocą schematu https://. Klient powinien użyć parametru dataVersion lub data.resourceVersionId, aby odwiedzić określoną wersję danych dotyczącą tego zdarzenia.
eventType string(wyliczenie) Tak Typ zmiany zasobu FHIR.
eventTime string(datetime) Tak Godzina UTC zatwierdzenia zmiany zasobu FHIR.
id ciąg Tak Unikatowy identyfikator zdarzenia.
data object Tak Szczegóły zdarzenia zmiany zasobu FHIR.
data.resourceType string(wyliczenie) Tak Typ zasobu FHIR.
data.resourceFhirAccount ciąg Tak Nazwa usługi konta FHIR w obszarze roboczym usługi Azure Health Data Services.
data.resourceFhirId ciąg Tak Identyfikator zasobu konta FHIR. Usługa FHIR losowo generuje identyfikator, gdy klient tworzy zasób. Klient może również użyć niestandardowego identyfikatora podczas tworzenia zasobów FHIR; jednak identyfikator nie powinien zawierać ani wnioskować żadnych informacji o phi/PII. Powinny to być metadane systemowe, które nie są specyficzne dla żadnej zawartości danych osobowych.
data.resourceVersionId string(number) Tak Wersja danych zasobu FHIR.
dataVersion ciąg Nie Tak samo jak data.resourceVersionId.
metadataVersion ciąg Nie Wersja schematu metadanych zdarzenia. Jest to definiowane przez Azure Event Grid i powinno być stałe przez większość czasu.

Przykłady komunikatów o zdarzeniach FHIR

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

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

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

Struktura komunikatów zdarzeń DICOM

Nazwa Typ Wymagane Opis
topic ciąg Tak Tematem jest identyfikator zasobu platformy Azure w obszarze roboczym usługi Azure Health Data Services.
subject ciąg Tak Identyfikator URI (Uniform Resource Identifier) obrazu DICOM, który został zmieniony. Klient może uzyskać dostęp do obrazu za pomocą tematu za pomocą schematu https://. Klient powinien użyć parametru dataVersion lub data.resourceVersionId, aby odwiedzić określoną wersję danych dotyczącą tego zdarzenia.
eventType string(wyliczenie) Tak Typ zmiany na obrazie DICOM.
eventTime string(datetime) Tak Godzina UTC zatwierdzenia zmiany obrazu DICOM.
id ciąg Tak Unikatowy identyfikator zdarzenia.
data object Tak Szczegóły zdarzenia zmiany obrazu DICOM.
data.partitionName ciąg Nie Nazwa partycji danych.
data.imageStudyInstanceUid ciąg Tak Identyfikator UID wystąpienia badania obrazu.
data.imageSeriesInstanceUid ciąg Tak Identyfikator UID wystąpienia serii obrazu.
data.imageSopInstanceUid ciąg Tak Identyfikator UID wystąpienia sop obrazu.
data.serviceHostName ciąg Tak Nazwa hosta usługi DICOM, w której nastąpiła zmiana.
data.sequenceNumber int Tak Numer sekwencji zmiany w usłudze DICOM. Każde tworzenie i usuwanie obrazu ma unikatową sekwencję w usłudze. Ta liczba jest skorelowana z numerem sekwencji zestawienia zmian usługi DICOM. Wykonywanie zapytań dotyczących zestawienia zmian usługi DICOM za pomocą tego numeru sekwencji powoduje zmianę, która utworzyła to zdarzenie.
dataVersion ciąg Nie Wersja danych obrazu DICOM.
metadataVersion ciąg Nie Wersja schematu metadanych zdarzenia. Jest to definiowane przez Azure Event Grid i powinno być stałe przez większość czasu.

Przykłady komunikatów o zdarzeniach 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"
}

Następne kroki

W tym artykule przedstawiono struktury komunikatów zdarzeń.

Aby dowiedzieć się, jak wdrażać zdarzenia przy użyciu Azure Portal, zobacz

Wdrażanie zdarzeń przy użyciu Azure Portal

FHIR® jest zastrzeżonym znakiem towarowym Health Level Seven International, zarejestrowanym w Amerykańskim Biurze Znaków Towarowych i jest używany z ich pozwoleniem.