Sdílet prostřednictvím

Struktury zpráv událostí

  • Článek

V tomto článku se dozvíte o strukturách zpráv událostí, požadovaných a nepožadovaných prvcích a podívejte se na ukázky datových částí zpráv událostí.

Důležité

Události aktuálně podporují tyto operace:

  • FhirResourceCreated – událost vygenerovaná po úspěšném vytvoření prostředku FHIR.

  • FhirResourceUpdated – událost vygenerovaná po úspěšné aktualizaci prostředku FHIR.

  • FhirResourceDeleted – událost vygenerovaná po úspěšném odstranění prostředku FHIR.

  • DicomImageCreated – událost vygenerovaná po úspěšném vytvoření image DICOM.

  • DicomImageDeleted – událost vygenerovaná po úspěšném odstranění image DICOM.

  • DicomImageUpdated – událost vygenerovaná po úspěšné aktualizaci image DICOM.

Další informace o typech odstranění služby FHIR najdete v tématu Možnosti rozhraní REST API ve službě FHIR ve službě Azure Health Data Services.

Struktura zpráv událostí FHIR

Name Type Požadováno Popis
topic string Ano Toto téma je ID prostředku Azure vašeho pracovního prostoru Azure Health Data Services.
subject string Ano Identifikátor URI (Uniform Resource Identifier) prostředku FHIR, který byl změněn. Zákazník má přístup k prostředku s předmětem se schématem https://. Zákazník by měl použít dataVersion nebo data.resourceVersionId k návštěvě konkrétní datové verze týkající se této události.
eventType string(výčet) Ano Typ změny prostředku FHIR.
eventTime string(datetime) Ano Čas UTC, kdy se potvrdí změna prostředku FHIR.
id string Ano Jedinečný identifikátor události.
data objekt Ano Podrobnosti o události změny prostředku FHIR
data.resourceType string(výčet) Ano Typ prostředku FHIR.
data.resourceFhirAccount string Ano Název služby účtu FHIR v pracovním prostoru Azure Health Data Services.
data.resourceFhirId string Ano ID prostředku účtu FHIR. Služba FHIR náhodně vygeneruje ID, když zákazník prostředek vytvoří. Zákazník může také použít přizpůsobené ID při vytváření prostředků FHIR; id by však nemělo obsahovat ani odvodit žádné informace PHI/PII. Mělo by se jednat o systémová metadata, která nejsou specifická pro žádný obsah osobních údajů.
data.resourceVersionId string(číslo) Ano Datová verze prostředku FHIR.
dataVersion string No Stejné jako data.resourceVersionId.
metadataVersion string No Verze schématu metadat události. Tato hodnota je definována službou Azure Event Grid a měla by být ve většině případů konstantní.

Ukázky zpráv událostí FHIR

FhirResourceCreated – událost

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

Událost 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"
}

FhirResourceDeleted – událost

{
  "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 zpráv událostí DICOM

Name Type Požadováno Popis
topic string Ano Toto téma je ID prostředku Azure vašeho pracovního prostoru Azure Health Data Services.
subject string Ano Identifikátor URI (Uniform Resource Identifier) obrázku DICOM, který byl změněn. Zákazník má přístup k obrázku s předmětem se schématem https://. Zákazník by měl použít dataVersion nebo data.resourceVersionId k návštěvě konkrétní datové verze týkající se této události.
eventType string(výčet) Ano Typ změny na imagi DICOM.
eventTime string(datetime) Ano Čas UTC, kdy byla potvrzena změna obrázku DICOM.
id string Ano Jedinečný identifikátor události.
data objekt Ano Podrobnosti události změny obrázku DICOM
data.partitionName string No Název datového oddílu
data.imageStudyInstanceUid string Ano Identifikátor UID instance studie image.
data.imageSeriesInstanceUid string Ano UID instance řady image.
data.imageSopInstanceUid string Ano Identifikátor UID instance SOP image.
data.serviceHostName string Ano Název hostitele služby DICOM, kde došlo ke změně.
data.sequenceNumber int Ano Pořadové číslo změny ve službě DICOM. Každé vytvoření a odstranění image má v rámci služby jedinečnou sekvenci. Toto číslo koreluje s pořadovým číslem kanálu změn služby DICOM. Dotazování kanálu změn služby DICOM pomocí tohoto pořadového čísla vám poskytne změnu, která vytvořila tuto událost.
dataVersion string No Datová verze image DICOM.
metadataVersion string No Verze schématu metadat události. Tato hodnota je definována službou Azure Event Grid a měla by být ve většině případů konstantní.

Ukázky zpráv událostí 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"
}

Další kroky

V tomto článku jste se dozvěděli o strukturách zpráv událostí.

Informace o nasazení událostí pomocí webu Azure Portal najdete v tématu

Nasazení událostí pomocí webu Azure Portal

FHIR® je registrovaná ochranná známka úrovně Health Level Seven International registrovaná v Úřadu pro ochranné známky USA a používá se s jejich svolením.