Pub/Sub 알림

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

개요

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

  • dicomStores.dicomWeb.studies.storeInstances 메서드를 사용하여 DICOM 스토어에 DICOM 인스턴스를 저장합니다.
  • dicomStores.import 메서드를 사용하여 DICOM 인스턴스를 DICOM 스토어로 가져옵니다.
  • FHIR 리소스가 FHIR 저장소에서 생성, 패치, 업데이트 또는 삭제된 경우. 하지만 FHIR 리소스를 Cloud Storage에서 가져올 때 알림이 전송되지 않습니다.
  • HL7v2 메시지가 HL7v2 저장소에서 수집되거나 생성된 경우

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

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

DICOM 알림

DICOM 데이터로 Pub/Sub 알림을 사용하는 방법에 관한 자세한 내용은 DICOM Pub/Sub 알림을 참고하세요.

FHIR 알림

FHIR 데이터로 Pub/Sub 알림을 사용하는 방법에 관한 자세한 내용은 FHIR Pub/Sub 알림을 참고하세요.

HL7v2 알림

다음 다이어그램은 HL7v2 메시지가 수집되거나 생성될 때 발생하는 알림의 흐름을 보여줍니다.

hl7v2_pubsub

  1. Cloud Healthcare API는 관리 시스템에서 HL7v2 메시지를 수집합니다.
  2. 메시지는 HL7v2 저장소에 저장됩니다.
  3. HL7v2 저장소는 Pub/Sub 메시지를 만들어 HL7v2 메시지와 일치하는 필터가 있는 저장소의 Pub/Sub 주제로 보냅니다.
  4. Pub/Sub는 Pub/Sub 메시지를 주제의 구독으로 전달합니다.
  5. 구독자는 구독에서 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 값이 포함되어 있지 않습니다.

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 메시지의 유형입니다.

다음 단계