쿼리 정보

Vault CDMS는 쿼리를 사용하여 누락되거나, 범위를 벗어났거나, 의심스러운 입력 데이터(데이터 아이템방문 날짜)에 대한 쿼리를 추적합니다. 클리니컬 리포팅에서는 쿼리 목록에서 이러한 쿼리를 검토하거나 코어 또는 커스텀 리스팅의 개별 아이템방문 날짜에 대해 검토할 수 있습니다.

Vault EDC에는 시스템 쿼리 및 수동 쿼리와 같이 두 가지 유형의 쿼리가 있습니다. Vault는 사용자가 입력한 데이터에 대해 체크를 실행하고 데이터가 스터디 디자인 중에 정의된 사양을 충족하지 않는 경우 쿼리를 생성하는 방식으로 시스템 쿼리를 생성합니다. 예를 들어 Vault에서는 입력한 날짜가 특정 범위를 벗어날 때 시스템 쿼리를 생성합니다. 수동 쿼리는 모니터(CRA), 데이터 매니저 또는 임상 코더가 생성한 쿼리입니다.

필수 구성 요소

CDMS Lead Data Manager(CDMS 책임 데이터 매니저)CDMS Data Manager(CDMS 데이터 매니저) 표준 스터디 역할을 보유한 사용자는 자동으로 아래에 설명된 동작을 수행할 수 있습니다. 조직에서 사용자 정의 스터디 역할을 사용하는 경우, 역할에서 아래 표에 나열된 권한을 부여해야 합니다.

유형(Type) 권한 레이블 컨트롤
표준 탭 Clinical Reporting 탭

Clinical Reporting 탭을 통해 EDC 클리니컬 리포팅에 액세스할 수 있습니다. EDC 클리니컬 리포팅은 프로덕션 환경에서만 사용할 수 있습니다.

기능적 권한
기능적 권한 사례집 보기

대상자 사례집에 대한 정보를 볼 수 있는 기능(레포트, 대시보드 및 CDB)

기능적 권한 API 액세스

Vault CDMS API에 액세스하고 이를 사용할 수 있는 기능(CDB를 사용하기 위해서도 이 권한 필요)

스터디에 제한된 데이터가 포함되어 있는 경우 제한된 데이터 액세스 권한이 있어야 해당 데이터를 볼 수 있습니다.

스터디 역할에 대해 자세히 알아보십시오.


클리니컬 리포팅에서 EDC 쿼리 보기

클리니컬 리포팅에서 쿼리를 보려면 스터디를 선택한 다음 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)을 사용하여 쿼리(Queries) 페이지로 이동합니다. 그러면 코어(Core) 탭의 쿼리 페이지가 열립니다. 기본적으로 클리니컬 리포팅에는 다음과 같은 쿼리 목록 세트가 포함됩니다.

  • 종결된 쿼리: 스터디에서 종결됨 상태의 모든 EDC 쿼리를 나열합니다.
  • 오픈 쿼리: 스터디에서 오픈 또는 답변됨 상태의 모든 EDC 쿼리를 나열합니다.
  • 쿼리 메시지: 스터디에서 모든 EDC 쿼리를 나열합니다.

현재 릴리스에서는 클리니컬 리포팅을 사용하여 쿼리 정보에 대한 커스텀 리스팅을 생성할 수 없습니다. 이러한 이유로 쿼리 > 공개(Public) 또는 쿼리 > 비공개(Private)에는 리스팅이 표시되지 않습니다.

쿼리 목록을 열려면 해당 리스팅의 제목을 클릭합니다.

쿼리 세부 사항

쿼리 목록에 들어왔으면 행을 클릭하여 해당 쿼리에 대한 쿼리 세부 사항(Query Details) 패널을 볼 수 있습니다. 쿼리 세부 사항 패널에는 다음과 같은 정보가 포함되어 있습니다.

  • 대상자 ID
  • 방문 날짜
  • 모든 쿼리 메시지
  • EDC에서 쿼리를 볼 수 있는 링크

패널을 닫으려면 닫기(Close)()를 클릭합니다. 쿼리 세부 사항 패널의 위쪽 가장자리를 끌어서 크기를 조정할 수 있습니다.

메시지 기록을 새로 고치려면 새로 고침(Refresh) 버튼을 클릭합니다.

쿼리 &목록 정렬 및 필터링

쿼리 목록을 정렬하고 필터링할 수 있습니다.

열에 이미 정렬 또는 필터가 적용된 경우 클리니컬 리포팅에 정렬(Sort) 아이콘(오름차순의 경우 , 내림차순의 경우 )과 필터(Filter) 아이콘(filter_list)이 표시됩니다. 열 헤더에서 이를 클릭하여 정렬 또는 필터를 편집할 수 있습니다. 아직 정렬 및 필터가 없는 열을 정렬하고 필터링할 수도 있습니다.

정렬 방법

쿼리 목록을 정렬하는 방법은 다음과 같습니다.

  1. 정렬 기준으로 사용할 열의 열 헤더를 찾습니다.
  2. 해당 열에서 마우스를 가져가면 정렬 및 필터링& 버튼이 표시됩니다.
  3. 정렬 및 필터링(Sort & Filter)(filter_list)을 클릭하여 정렬 메뉴를 엽니다.
  4. 정렬 기준(Sort by)을 클릭하여 확장합니다.
  5. 오름차순(Ascending) 또는 내림차순(Descending)을 선택합니다.
  6. 확인(OK)을 클릭합니다.

열에 이미 정렬 순서가 적용된 경우 워크벤치에 정렬 아이콘(오름차순의 경우 , 내림차순의 경우 )이 표시됩니다. 열 헤더에서 이를 클릭하여 정렬 순서를 변경하거나 제거할 수 있습니다.

정렬 순서를 초기화(제거)하려면 정렬 및 필터링& 메뉴를 열고 초기화(Reset)를 클릭합니다.

필터링 방법

쿼리 목록을 필터링하는 방법은 다음과 같습니다.

  1. 정렬 기준으로 사용할 열을 찾습니다.
  2. 해당 열에서 마우스를 가져가면 정렬 및 필터링 &버튼이 표시됩니다.
  3. 정렬 및 필터링(Sort & Filter)(filter_list)을 클릭합니다.
  4. 조건(Condition)을 클릭하여 확장합니다.
  5. 연산자(Operator)를 선택합니다. 워크벤치에서 입력된 값(Value)과 선택한 연산자(Operator)를 사용하여 열 내의 값을 비교합니다.
  6. 필요한 경우 비교 값을 입력합니다. 함수가 아닌 정적 값만 사용할 수 있습니다. 날짜의 경우 YYYY-MM-DD 형식을 사용하거나 달력 선택기로 날짜를 선택합니다.
  7. 확인(OK)을 클릭합니다.

필터를 지우려면(제거) 정렬 및 필터링 &메뉴를 열고 지우기(Clear)를 클릭합니다.

리스팅 열 숨기기

열 숨기기 옵션을 사용하여 리스팅에서 열을 제거하지 않고 필요에 따라 열을 숨기거나 표시할 수 있습니다.

이 설정은 열을 숨김 해제할 때까지 개체와 스터디 전체에서 유지됩니다.

CDB는 숨겨진 열을 주황색 점선으로 나타냅니다. CDB는 숨겨진 열의 각 세트(모두 숨겨져 있으며 나란히 있는 열)에 대해 하나의 점선을 표시합니다.

열을 숨기는 방법은 다음과 같습니다.

  1. 리스팅으로 이동합니다.
  2. 열 헤더(Column Header) 위로 마우스를 가져가면 &정렬 및 필터링 메뉴(filter_list)가 표시됩니다.
  3. 열 숨기기(Hide Column)를 클릭합니다.

  4. CDB에서 열을 숨깁니다. 숨겨진 열은 주황색 점선으로 표시됩니다. 숨겨진 열을 모두 표시하려면 열 숨김 해제(Unhide Columns)를 클릭합니다.

셀 세부 사항(Cell Details) 패널의 쿼리

셀 세부 사항 패널의 리스팅에서 개별 쿼리를 검토할 수도 있습니다. 셀 세부 사항 패널을 열려면 리스팅 결과에서 보려는 셀(Cell)을 클릭합니다. 리스팅에서 쿼리는 장식 아이콘으로 표시됩니다.

패널을 닫으려면 닫기()를 클릭하거나 을 한 번 더 클릭합니다. 셀 세부 사항 패널의 위쪽 가장자리를 끌어서 크기를 조정할 수 있습니다.

셀 세부 사항 패널에는 Vault EDC에서 폼과 해당 쿼리를 검토할 수 있는 링크도 포함되어 있습니다.

쿼리 상태

Vault CDMS의 쿼리에는 오픈, 답변됨종결됨과 같이 3가지 상태가 있습니다. 이러한 상태는 실시한 동작과 쿼리에서 아직 발생해야 하는 동작을 나타냅니다.

상태 의미
오픈(Open) 오픈은 쿼리가 대응되지 않았음을 나타냅니다. 새로 생성한 모든 쿼리에 할당되는 상태입니다.
답변됨(Answered) 답변됨은 쿼리가 답변되었음을 나타냅니다. 예를 들어 사이트에서 쿼리된 값이 범위를 벗어났다는 이유를 명시하여 답변했습니다.
종결됨(Closed) 종결됨은 쿼리에 추가 동작이나 논의가 필요하지 않음을 나타냅니다. CRA 또는 데이터 매니저는 필요한 경우 Vault EDC에서 종결된 쿼리를 다시 열 수 있습니다.

EDC와 쿼리 상태 동기화

Vault는 클리니컬 리포팅의 쿼리 세부 사항 패널에서 쿼리를 보기 위해 클릭할 때마다 EDC와 일치하도록 쿼리의 쿼리 상태를 업데이트합니다. 또한 Vault는 쿼리를 업데이트하고 가져오는 동안 EDC에서 새로 생성된 쿼리를 가져옵니다.

클리니컬 리포팅에 오픈 쿼리가 있고 Vault EDC 사용자가 쿼리 세부 사항 패널에서 해당 쿼리를 마지막으로 본 이후(다음 가져오기 실행 전) 쿼리에 응답한 경우, 애플리케이션에서 해당 쿼리의 세부 사항을 볼 때 클리니컬 리포팅은 쿼리의 상태를 답변됨으로 업데이트합니다.

시스템 쿼리

Vault CDMS는 검사를 실행하고 정의된 범위를 벗어난 아이템 값에 대해 시스템 쿼리를 생성합니다. 이 범위는 스터디 디자인 중에 정의됩니다.

다음 시스템 쿼리 유형은 자동으로 정의됩니다.

  • 필수(Required): 스터디 설계자는 아이템 정의를 생성할 때 필드를 필수로 표시하도록 선택할 수 있습니다. 폼을 제출할 때 이 입력란을 비워 두면 Vault에서 시스템 쿼리("이 입력란은 필수입니다.")를 생성합니다.
  • 범위(Range): 스터디 설계자는 아이템 정의를 생성할 때 필드 값의 범위를 정의할 수 있습니다. 입력한 값이 해당 범위를 벗어나면 Vault에서 시스템 쿼리("값이 범위를 벗어났습니다.")를 생성합니다. 이 쿼리 유형은 날짜가 아닌 숫자 값에만 해당됩니다.
  • 미래 날짜(Future Date): 스터디 설계자는 아이템 정의를 생성할 때 미래 날짜를 허용하지 않을 수 있습니다. 사용자가 미래 날짜를 입력하면 Vault에서 시스템 쿼리(미래 날짜는 허용되지 않음)를 생성합니다.
  • 미래 날짜(Future Date)(방문 날짜): 스터디 설계자는 방문 정의를 생성할 때 미래 날짜가 허용되지 않음을 나타낼 수 있습니다. 그런 다음 Vault에서 현재 날짜보다 늦은 방문 날짜에 대해 시스템 쿼리를 생성할 수 있습니다.
  • 기간 벗어남(Out of Window)(방문 날짜): 스터디 설계자는 방문 정의를 생성할 때 방문에 대해 허용되는 기간을 생성할 수 있습니다. 구성된 경우 Vault에서 방문 날짜가 이 기간을 벗어날 때마다 시스템 쿼리를 생성할 수 있습니다.

Vault CDMS는 비활성화된 아이템에 대한 쿼리를 생성하지 않습니다.

스터디 설계자는 Studio에서 추가 데이터 검증 규칙을 정의할 수 있습니다. 이러한 규칙에 따라 Vault CDMS에서 추가 시스템 생성 쿼리를 생성할 수 있습니다.

쿼리 내보내기

스터디의 모든 오픈 또는 종결된 쿼리를 문서화 및 외부 검토를 위해 CSV 파일로 내보낼 수 있습니다. CSV 파일에는 쿼리 목록과 동일한 열이 포함되어 있으며, 리스팅에 적용하는 모든 정렬 또는 필터는 내보낸 리스팅에도 적용됩니다.

쿼리를 내보내는 방법은 다음과 같습니다.

  1. 스터디쿼리 페이지로 이동합니다.
  2. 내보낼 쿼리 목록의 제목을 클릭합니다.
  3. 쿼리() 메뉴에서 CSV 생성(Generate CSV)을 선택합니다.

  4. CSV가 성공적으로 생성됨(CSV generated successfully) 알림에서 CSV 생성됨(CSV generated)을 클릭하여 CSV 파일을 다운로드합니다. 생성된 CSV를 다운로드할 수 있는 링크