다음을 통해 공유

DICOM 서비스 API v2 변경 내용

  • 아티클

이 참조 가이드에서는 DICOM® 서비스의 V2 API 변경 내용에 대한 요약을 제공합니다. v2의 전체 기능 집합을 보려면 DICOM 규칙 문 v2를 참조하세요.

v2의 변경 내용 요약

Store

선택적 특성의 관대한 유효성 검사

이전 버전에서는 필수 또는 검색 가능한 특성이 유효성 검사에 실패하면 스토어 요청이 실패합니다. v2부터는 필요한 특성이 유효성 검사에 실패한 경우에만 요청이 실패합니다.

API에서 필요하지 않은 특성의 유효성 검사에 실패하면 파일이 응답에 경고와 함께 저장됩니다. 경고로 인해 HTTP 반환 코드 202 Accepted 가 생성되고 응답 페이로드에 태그(0008, 1196)가 WarningReason 포함됩니다.

인스턴스당 실패한 각 특성에 대한 경고가 제공됩니다. 시퀀스에 유효성 검사에 실패한 특성이 포함되어 있거나 단일 특성에 여러 문제가 있는 경우 첫 번째 실패한 특성 이유만 기록됩니다.

유효성 검사에 실패하는 선택적 특성에 대한 몇 가지 주목할 만한 동작이 있습니다.

  • 유효성 검사에 실패한 특성을 검색하면 여기에 언급된 몇 가지 방법 중 하나로 값이 수정되면 study/series/instance가 반환됩니다.
  • WADO /metadata 엔드포인트를 통해 메타데이터를 검색할 때 특성이 반환되지 않습니다.

스터디/시리즈/인스턴스를 검색하면 해당 특성의 유효성 검사에 실패한 경우에도 원래 특성이 있는 원래 이진 파일이 항상 반환됩니다.

특성이 null로 패딩된 경우 검색 가능한 경우 특성이 인덱싱되고 dicom+json 메타데이터에 있는 것처럼 저장됩니다. 유효성 검사 경고가 제공되지 않습니다.

Retrieve

단일 프레임 검색 지원

단일 프레임 검색은 다음 Accept 헤더를 추가하여 지원됩니다.

  • application/octet-stream; transfer-syntax=*

유효성 검사 경고가 있는 확장 쿼리 태그에 대한 검색 결과가 불완전할 수 있습니다.

v1 API에서 v2에 대해 계속했습니다. 기존 인스턴스 중 하나 이상에 인덱싱할 수 없는 태그 값이 있기 때문에 확장 쿼리 태그에 오류가 있는 경우 설명서에 설명된 대로 확장 쿼리 태그가 포함된 후속 검색 쿼리가 반환 erroneous-dicom-attributes 됩니다. 그러나 STOW-RS의 유효성 검사 경고가 있는 태그(특성이라고도 함)는 이 헤더에 포함되지 않습니다 . 저장소 요청으로 인해 인스턴스가 저장될 때 검색 가능한 특성에 대한 유효성 검사 경고가 발생하는 경우 해당 특성은 저장된 인스턴스를 검색하는 데 사용되지 않을 수 있습니다. 그러나 유효성 검사에 실패한 검색 가능한 특성 은 실패한 후 저장된 동일한 연구/계열의 인스턴스에서 값을 덮어쓰거나 값이 이전 인스턴스에 의해 이미 올바르게 저장된 경우 결과를 반환할 수 있습니다. 특성 값을 덮어쓰지 않으면 검색 결과가 생성되지 않습니다.

특성은 다음과 같은 방법으로 수정할 수 있습니다.

  • 저장된 인스턴스를 삭제하고 수정된 데이터를 사용하여 새 인스턴스 업로드
  • 수정된 데이터를 사용하여 동일한 연구/시리즈에서 새 인스턴스 업로드

기본적으로 반환되는 연구, 계열 및 인스턴스 특성 수가 줄어듭니다.

성능 향상을 위해 기본적으로 반환되는 특성 집합이 감소되었습니다. 검색 응답 설명서의 자세한 목록을 참조하세요.

기본 태그에 새로 추가된 특성입니다.

태그 수준 태그 특성 이름
연구 (0008, 1030) StudyDescription
계열 (0008, 1090) ManufacturerModelName

기본 태그에서 제거된 특성입니다.

태그 수준 태그 특성 이름
연구 (0008, 0005) SpecificCharacterSet
연구 (0008, 0030) StudyTime
연구 (0008, 0056) InstanceAvailability
연구 (0008, 0201) TimezoneOffsetFromUTC
연구 (0010, 0040) PatientSex
연구 (0020, 0010) StudyID
계열 (0008, 0005) SpecificCharacterSet
계열 (0008, 0201) TimezoneOffsetFromUTC
계열 (0008, 103E) SeriesDescription
계열 (0040, 0245) PerformedProcedureStepStartTime
계열 (0040, 0275) RequestAttributesSequence
인스턴스 (0008, 0005) SpecificCharacterSet
인스턴스 (0008, 0016) SOPClassUID
인스턴스 (0008, 0056) InstanceAvailability
인스턴스 (0008, 0201) TimezoneOffsetFromUTC
인스턴스 (0020, 0013) InstanceNumber
인스턴스 (0028, 0010) 행
인스턴스 (0028, 0011) 열
인스턴스 (0028, 0100) BitsAllocated
인스턴스 (0028, 0008) NumberOfFrames

제거된 모든 태그는 추가 태그의 일부이며 , 이 태그는 .을 includefield = all사용하여 쿼리할 때 반환됩니다.

패딩을 사용하거나 사용하지 않고 Null 패딩 특성을 검색할 수 있습니다.

null 패딩을 사용하여 특성을 저장한 경우 URI 인코딩에서 null 패딩을 사용하거나 사용하지 않고 검색할 수 있습니다. 검색된 결과는 null 패딩을 사용 또는 사용하지 않고 저장된 특성에 대한 것입니다.

작업

completed 상태가 succeeded

Microsoft의 REST API 지침completed에 맞게 상태 이름이 .로 succeeded변경되었습니다.

변경 피드

변경 피드가 이제 시간 범위를 허용합니다.

변경 피드 API는 이제 결과 범위를 지정하는 데 도움이 되는 선택적 startTime 매개 변수와 endTime 매개 변수를 허용합니다. 기존 offset 및 limit 매개 변수를 사용하여 시간 범위 내의 변경 내용을 계속 페이지를 매길 수 있습니다. 오프셋은 및 에 의해 startTime endTime정의된 시간 창을 기준으로 합니다. 예를 들어 2023년 7월 24일 오전 09:00 UTC부터 다섯 번째 변경 피드 항목은 쿼리 문자열 ?startTime=2023-07-24T09:00:00Z&offset=5을 사용합니다.

v2의 경우 성능을 향상시키기 위해 항상 시간 범위를 포함하는 것이 좋습니다.

참고 항목

DICOM®은 의료 정보의 디지털 통신과 관련된 표준 간행물에 대한 미국 전기공업회의 등록 상표입니다.