Udostępnij za pośrednictwem

Struktury komunikatów zdarzeń

  • Artykuł

W tym artykule dowiesz się więcej o strukturach komunikatów zdarzeń, wymaganych i niewymaganych elementach 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 w usłudze FHIR w usługach Azure Health Data Services

Struktura komunikatów zdarzeń FHIR

Nazwisko Type Wymagania opis
topic string Tak Tematem jest identyfikator zasobu platformy Azure obszaru roboczego usługi Azure Health Data Services.
subject string Tak Identyfikator URI (Uniform Resource Identifier) zasobu FHIR, który został zmieniony. Klient może uzyskać dostęp do zasobu za pomocą tematu ze schematem 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 string Tak Unikatowy identyfikator zdarzenia.
data obiekt Tak Szczegóły zdarzenia zmiany zasobu FHIR.
data.resourceType string(wyliczenie) Tak Typ zasobu FHIR.
data.resourceFhirAccount string Tak Nazwa usługi konta FHIR w obszarze roboczym usług Azure Health Data Services.
data.resourceFhirId string 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 string Nie Tak samo jak data.resourceVersionId.
metadataVersion string Nie Wersja schematu metadanych zdarzenia. Jest to definiowane przez usługę 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

Nazwisko Type Wymagania opis
topic string Tak Tematem jest identyfikator zasobu platformy Azure obszaru roboczego usługi Azure Health Data Services.
subject string Tak Identyfikator URI (Uniform Resource Identifier) obrazu DICOM, który został zmieniony. Klient może uzyskać dostęp do obrazu za pomocą tematu ze schematem 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 string Tak Unikatowy identyfikator zdarzenia.
data obiekt Tak Szczegóły zdarzenia zmiany obrazu DICOM.
data.partitionName string Nie Nazwa partycji danych.
data.imageStudyInstanceUid string Tak Identyfikator UID wystąpienia badania obrazu.
data.imageSeriesInstanceUid string Tak Identyfikator UID wystąpienia serii obrazu.
data.imageSopInstanceUid string Tak Identyfikator UID wystąpienia SOP obrazu.
data.serviceHostName string 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 przy użyciu tego numeru sekwencji powoduje zmianę, która utworzyła to zdarzenie.
dataVersion string Nie Wersja danych obrazu DICOM.
metadataVersion string Nie Wersja schematu metadanych zdarzenia. Jest to definiowane przez usługę Azure Event Grid i powinno być stałe przez większość czasu.

Przykłady komunikatów zdarzeń 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 witryny Azure Portal, zobacz

Wdrażanie zdarzeń przy użyciu witryny Azure Portal

FHIR® jest zastrzeżonym znakiem towarowym Health Level Seven International, zarejestrowanym w U.S. Trademark Office i jest używany z ich uprawnieniami.