Pub/Sub 알림

이 페이지에서는 Cloud Healthcare API 데이터 저장소에서 임상 이벤트가 발생할 때 Pub/Sub를 사용하여 알림을 수신하는 방법을 간략히 설명합니다. Pub/Sub 메시지 설정 및 사용 방법은 Pub/Sub 알림 구성을 참조하세요.

개요

다음과 같은 임상 이벤트가 발생하면 Pub/Sub을 사용하여 알림을 받을 수 있습니다.

  • DICOM 인스턴스가 DICOM 저장소에 저장된 경우
  • FHIR 리소스가 FHIR 저장소에서 생성, 업데이트 또는 삭제된 경우. 하지만 FHIR 리소스를 Cloud Storage에서 가져올 때 알림이 전송되지 않습니다.
  • HL7v2 메시지가 HL7v2 저장소에서 수집되거나 생성된 경우

각 이벤트에 대한 정보는 메시지 형식으로 해당 데이터 저장소의 Pub/Sub 주제에 추가됩니다.

이러한 메시지는 개인 정보를 포함하지 않습니다. 다음 항목만 포함됩니다.

  • 생성된 메시지의 프로젝트
  • 메시지 ID
  • FHIR 메시지에서 메시지를 유발한 resourceType 및 작업
  • HL7v2 메시지의 HL7v2 메시지 유형

프로젝트에 대한 권한이 충분한 경우 어떤 Pub/Sub 주제에도 메시지를 게시할 수 있습니다. Pub/Sub 주제로 메시지가 수신된 후에는 메시지를 모든 주제 구독자에게 전송합니다.

알림 형식

Pub/Sub 주제로 전송되는 알림은 다음 두 부분으로 구성됩니다.

  • 속성: 이벤트를 설명하는 키:값 쌍의 조합입니다.
  • 데이터: 관련 FHIR 리소스, DICOM 인스턴스, HL7v2 메시지에 대한 식별자를 포함하는 문자열입니다.

DICOM 인스턴스 데이터

DICOM 인스턴스가 DICOM 저장소에 저장되면 다음 식별자가 Pub/Sub 메시지의 data 필드에 항상 포함됩니다.

projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID

저장된 DICOM 인스턴스의 알림에는 attribute 값이 포함되어 있지 않습니다.

FHIR 리소스 데이터 및 속성

FHIR 리소스의 변경사항에는 항상 Pub/Sub 메시지의 data 필드에 있는 다음 식별자가 포함됩니다.

projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/resources/RESOURCE_TYPE/RESOURCE_ID

다음 키:값 쌍 집합이 항상 메시지의 attributes 필드에 포함됩니다.

속성 이름 가능한 값 설명
action
  • CreateResource
  • UpdateResource
  • DeleteResource
CreateResource 방금 발생한 이벤트의 유형
resourceType 모든 FHIR 리소스 유형 Patient 수정된 리소스 유형

HL7v2 메시지 데이터 및 속성

HL7v2 메시지가 생성되거나 HL7v2 저장소에 수집될 때는 다음 식별자가 Pub/Sub 메시지의 data 필드에 항상 포함됩니다.

projects/PROJECT_ID/locations/us-central1/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID

다음 키-값 쌍 집합은 항상 Pub/Sub 메시지의 attributes 필드에 포함됩니다.

속성 이름 가능한 값 설명
msgType 모든 HL7v2 메시지 유형 ADT 생성되거나 수집된 HL7v2 메시지의 유형입니다.

다음 단계