共用方式為

事件訊息結構

  • 發行項

在本文中，瞭解事件訊息結構、必要和非必要專案，並查看事件訊息承載的範例。

重要

事件目前支援下列作業：

  • FhirResourceCreated - 成功建立 FHIR 資源之後發出的事件。

  • FhirResourceUpdated - 成功更新 FHIR 資源之後發出的事件。

  • FhirResourceDeleted - 成功刪除 FHIR 資源之後發出的事件。

  • DicomImageCreated - 成功建立 DICOM 映像之後發出的事件。

  • DicomImageDeleted - 成功刪除 DICOM 映像之後發出的事件。

  • DicomImageUpdated - 成功更新 DICOM 映像之後發出的事件。

如需 FHIR 服務刪除類型的詳細資訊，請參閱 Azure Health Data Services 中 FHIR 服務的 REST API 功能

FHIR 事件訊息結構

名稱 類型​​ 必要 描述
topic string Yes 本主題是 Azure Health Data Services 工作區的 Azure 資源識別符。
subject 字串 Yes 已變更之 FHIR 資源的統一資源識別碼 （URI）。 客戶可以使用 https:// 配置來存取具有主體的資源。 客戶應該使用 dataVersion 或 data.resourceVersionId 來瀏覽有關此事件的特定數據版本。
eventType string（enum） Yes FHIR 資源上的變更類型。
eventTime string（datetime） Yes FHIR 資源變更認可時的 UTC 時間。
id 字串 Yes 事件的唯一識別碼。
data object Yes FHIR 資源變更事件詳細數據。
data.resourceType string（enum） Yes FHIR 資源類型。
data.resourceFhirAccount 字串 Yes Azure Health Data Services 工作區中的 FHIR 帳戶服務名稱。
data.resourceFhirId 字串 Yes FHIR 帳戶的資源標識碼。 FHIR 服務會在客戶建立資源時隨機產生標識碼。 客戶也可以在 FHIR 資源建立中使用自定義標識符;不過，標識元不應包含或推斷任何 PHI/PII 資訊。 它應該是系統元數據，而不是任何個人資料內容特有的。
data.resourceVersionId string（number） Yes FHIR 資源的數據版本。
dataVersion 字串 No 與 data.resourceVersionId 相同。
metadataVersion 字串 No 事件中繼資料的結構描述版本。 這是由 Azure 事件方格 所定義，而且大部分時間都應該是固定的。

FHIR 事件訊息範例

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

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 事件

{
  "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 事件訊息結構

名稱 類型​​ 必要 描述
topic string Yes 本主題是 Azure Health Data Services 工作區的 Azure 資源識別符。
subject 字串 Yes 已變更之 DICOM 映像的統一資源識別碼 （URI）。 客戶可以使用 https:// 配置來存取具有主旨的影像。 客戶應該使用 dataVersion 或 data.resourceVersionId 來瀏覽有關此事件的特定數據版本。
eventType string（enum） Yes DICOM 映像上的變更類型。
eventTime string（datetime） Yes 認可 DICOM 映像變更的 UTC 時間。
id 字串 Yes 事件的唯一識別碼。
data object Yes DICOM 映像變更事件詳細數據。
data.partitionName 字串 No 數據分割名稱。
data.imageStudyInstanceUid 字串 Yes 影像的研究實例 UID。
data.imageSeriesInstanceUid 字串 Yes 影像的數列實例 UID。
data.imageSopInstanceUid 字串 Yes 映像的 SOP 實例 UID。
data.serviceHostName 字串 Yes 發生變更之 DICOM 服務的主機名。
data.sequenceNumber int Yes DICOM 服務中變更的序號。 每個映像建立和刪除在服務內都有唯一的順序。 此數位會與 DICOM 服務的變更摘要序號相互關聯。 使用這個序號查詢 DICOM 服務變更摘要可讓您進行建立此事件的變更。
dataVersion 字串 No DICOM 映射的數據版本。
metadataVersion 字串 No 事件中繼資料的結構描述版本。 這是由 Azure 事件方格 所定義，而且大部分時間都應該是固定的。

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

下一步

在本文中，您已瞭解事件訊息結構。

若要瞭解如何使用 Azure 入口網站 部署事件，請參閱

使用 Azure 入口網站部署事件

FHIR® 是 Health Level Seven International 在美國商標局註冊的註冊商標，依其權限使用。