커스텀 리스팅 생성

워크벤치는 데이터 목록을 사용하여 스터디 전반에 걸쳐 복잡한 임상 데이터 레포트를 생성합니다. CQL 쿼리를 생성하여 검토하려는 임상 데이터를 반환하고, 결과를 보고, 해당 쿼리를 사용자 정의 목록으로 저장할 수 있습니다. 사용자 정의 목록에 범주를 할당하여 조직의 비즈니스 관행에 따라 범주를 분류할 수도 있습니다. 조직의 다른 사용자와 목록을 공유하거나 비공개 목록으로 표시하도록 선택할 수 있습니다.

가용성: 임상 데이터베이스(CDB)는 CDB 라이선스 보유자만 사용할 수 있습니다. 자세한 내용은 Veeva 서비스 담당자에게 문의하십시오.

목록 액세스

먼저 스터디(Studies) 페이지에서 스터디를 선택합니다. 그런 다음, 탐색 창(Navigation Drawer)() 또는 스터디(Study) 메뉴에서 목록(Listings) 페이지를 엽니다.

탐색 창(Navigation Drawer)의 목록 스터디(Study) 메뉴의 목록

워크벤치는 스터디 목록을 네 그룹으로 나눕니다. 특정 그룹의 리스팅을 보려면 해당 탭을 클릭하여 엽니다.

목록(Listing) 탭

  • playlist_add_check 검토(Review): 검토 활성화됨인 사용자 정의 목록입니다. 해당 목록을 통해 수신 데이터를 검토하고 문제를 식별할 수 있습니다. 데이터 검토에 대해 자세히 알아보십시오.
  • 코어(Core): 워크벤치는 시스템으로 가져올 때 스터디의 각 폼에 대한 코어 목록을 자동으로 생성합니다.
  • public 공개(Public): 검토가 활성화되지 않은 모든 사용자 정의 목록으로, 사용자에게 보기 권한이 있습니다. 여기에는 공개로 표시된 사용자 본인의 리스팅과 스터디에 참여한 다른 사용자의 공개 리스팅이 포함됩니다. 워크벤치는 검토(Review) 그룹에서 검토가 활성화된 사용자 정의 목록을 표시합니다.
  • lock_outline 비공개: 사용자 본인이 직접 생성하고 비공개로 표시한 모든 커스텀 리스팅입니다.

리스팅의 제목(Title)을 클릭하여 엽니다.

목록 제목(Title)을 클릭하여 열기

내보내기(Export) > 정의(Definitions)에서 내보내기 목록(시스템 목록 포함)에 액세스할 수 있습니다.

사용자 정의 목록 생성

  1. 워크벤치에서 스터디로 이동합니다.
  2. 새로 생성(Create New) 메뉴에서 목록(Listing)을 선택합니다.
  3. 사용 가능한 속성(Available Properties)에서 선택한 속성(Selected Properties)으로 속성(Properties)을 끌어다 놓아 목록에 추가합니다. 속성 그룹을 끌어오거나 확장(Expand)을 클릭하여 개별 속성을 선택할 수 있습니다.
  4. 제거(Remove)()를 클릭하여 목록에서 속성을 제거합니다.
  5. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 항목(Items)을 클릭합니다.
  6. 사용 가능한 속성(Available Properties)에서 선택한 속성(Selected Properties)으로 폼(Forms)을 끌어다 놓아 목록에 추가합니다. 전체 폼(Form)을 끌어오거나 확장(Expand)을 클릭하여 해당 폼에서 개별 항목(Items)을 선택할 수 있습니다.
  7. 제거(Remove)()를 클릭하여 목록에서 항목을 제거합니다.
  8. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 배열(Arrange)을 클릭합니다.
  9. 속성, 폼 및 항목을 끌어다 놓아 재정렬합니다.
  10. 목록에 보기를 추가하려면 보기(Views)를 클릭하고 7~9단계를 반복합니다.
  11. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 행(Rows)을 클릭합니다.
  12. 행 구조(Row Structure)를 선택합니다.
    • 대상자별(By Subject): 이 옵션은 스터디 일정과 관계없이 대상자에 대한 단일 행에 여러 방문의 데이터를 표시하려고 시도하며, 방문에서 대상자가 일치하는 모든 데이터를 표시합니다. 이벤트 날짜 또는 이벤트 이름과 같은 선택한 일정 관련 필드는 목록에서 null로 설정됩니다.
    • 일정별(By Schedule): 이 옵션은 서로 다른 이벤트의 폼 데이터를 별도의 행에 표시합니다. 일정 관련 필드가 필요한 경우 이 옵션을 사용하는 것이 좋습니다. 모든 코어 리스팅에 대한 기본 옵션입니다.
  13. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 열(Columns)을 클릭합니다.
  14. 열 구조(Column Structure)를 선택합니다.
    • 확장형(나란히)(Wide (Side by Side)): 이 옵션을 사용하면 각 열이 하나의 고유한 항목 또는 항목 속성을 나타냅니다.
    • 스택형(연합)(Stacked (Union)): 이 옵션을 사용하면 각 열에 여러 아이템 또는 아이템 속성이 함께 누적될 수 있으며, 사용자가 열당 최대 5개의 아이템 및/또는 아이템 속성을 포함시킬 수 있습니다.
  15. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 별칭(Aliases)을 클릭합니다.
  16. 기본값이 아닌 헤더를 사용하려는 모든 열에 대해 열 별칭(Column Alias)을 입력합니다.
  17. 왼쪽 목록 빌더(Listing Builder) 메뉴에서 정렬 및 필터링(Sort & Filter)을 클릭합니다.
  18. 정렬 및 필터링(Sort & Filter) 메뉴를 사용하여 모든 열에 정렬 순서와 필터를 적용할 수 있습니다.
  19. 선택 사항: 미리 보기(Preview)를 클릭하여 목록을 미리 봅니다. 그러면 새 창에서 목록 미리 보기가 열립니다.
  20. 검증 및 저장(Validate and Save)을 클릭합니다.
  21. 목록 제목(Title)을 입력합니다. 이 제목은 스터디 내에서 고유해야 합니다.

  22. 목록에서 범주(Category)를 선택합니다. 범주 추가(Add Category) 옵션

  23. 선택 사항: 새 범주를 생성하려면 범주 필드의 텍스트를 지우고 범주 이름을 입력합니다. 동일한 이름의 범주가 아직 없는 경우 Enter를 누르거나 드롭다운에서 범주 추가(Add Category)를 선택합니다.

  24. 선택 사항: 기본적으로 목록은 비공개이므로 사용자만 볼 수 있습니다. 공개 목록을 생성하려면 목록 액세스(Listing Access)에 대해 공개(Public)를 선택합니다. 공개 목록은 워크벤치와 스터디에 액세스할 수 있는 모든 사용자가 볼 수 있습니다. 그렇지 않으면 이 설정을 비공개(Private)로 둡니다. 목록 액세스에 대해 공개(Public) 또는 비공개(Private) 선택

  25. 선택 사항: 이 목록을 검토할 수 있도록 하려면 검토(Review) 활성화됨(Enabled)을 선택합니다. 그렇지 않으면 검토를 비활성화됨으로 설정하여 일반 공개 또는 비공개 목록을 생성합니다.
  26. 설명(Description)을 입력합니다.
  27. 저장을 클릭합니다. 워크벤치는 사용자 정의 목록을 저장하고 엽니다.

목록 빌더: 항목 및 속성 선택

마지막 업데이트: 23R3

이 비디오에서는 목록 빌더에서 목록, 확인 또는 보기를 생성할 때 항목 및 속성을 선택하는 방법을 보여 줍니다.

목록 빌더: 목록 구조 설정

마지막 업데이트: 23R3

이 비디오에서는 목록 빌더에서 목록 구조를 설정하는 방법을 보여 줍니다.

목록 빌더: 검증

마지막 업데이트: 23R3

이 비디오에서는 목록 빌더의 검증을 검토합니다.

CQL을 사용하여 사용자 정의 목록 생성

CQL 편집기를 사용하여 사용자 정의 목록을 생성하는 방법은 다음과 같습니다.

  1. 워크벤치에서 스터디로 이동합니다.
  2. 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)()에서 목록(Listings) 페이지를 엽니다.
  3. 시작할 코어 목록 또는 기존 사용자 정의 목록을 선택합니다.
  4. 해당 목록의 제목(Title)을 클릭하여 엽니다.
  5. CQL 편집기(CQL Editor)를 클릭합니다.
  6. CQL 쿼리를 편집하여 목록에 원하는 데이터를 표시합니다.
  7. 적용(Apply)을 클릭합니다.
  8. 목록을 검토합니다. 필요한 경우 CQL 쿼리를 다시 편집하고 목록에 표시된 데이터에 만족할 때까지 다시 적용합니다.

  9. 목록 메뉴(Listing Menu)에서 다른 이름으로 저장(Save As)을 선택합니다. 다른 이름으로 저장(Save As) 메뉴 옵션

  10. 목록 제목(Title)을 입력합니다. 이 제목은 스터디 내에서 고유해야 합니다.
  11. 목록에서 범주(Category)를 선택합니다.

  12. 선택 사항: 새 범주를 생성하려면 범주 필드의 텍스트를 지우고 범주 이름을 입력합니다. 동일한 이름의 범주가 아직 없는 경우 Enter를 누르거나 드롭다운에서 범주 추가(Add Category)를 선택합니다. 범주 추가(Add Category) 옵션

  13. 선택 사항: 기본적으로 목록은 비공개이므로 사용자만 볼 수 있습니다. 공개 목록을 생성하려면 목록 액세스(Listing Access)에 대해 공개(Public)를 선택합니다. 공개 목록은 워크벤치와 스터디에 액세스할 수 있는 모든 사용자가 볼 수 있습니다. 그렇지 않으면 이 설정을 비공개(Private)로 둡니다. 목록 액세스에 대해 공개(Public) 또는 비공개(Private) 선택

  14. 선택 사항: 이 목록을 검토할 수 있도록 하려면 검토(Review) 활성화됨(Enabled)을 선택합니다. 그렇지 않으면 검토를 비활성화됨으로 설정하여 일반 공개 또는 비공개 목록을 생성합니다.
  15. 설명(Description)을 입력합니다.
  16. 저장을 클릭합니다. 워크벤치는 사용자 정의 목록을 저장하고 엽니다.

스터디에 단일 리스팅 복사

단일 리스팅 정의를 다른 스터디로 복사할 수 있습니다.

리스팅을 복사하는 방법은 다음과 같습니다.

  1. 복사하려는 리스팅을 엽니다.

  2. 리스팅() 메뉴에서 복사 대상(Copy to)을 선택합니다.

  3. 스터디로 복사(Copy to Study) 대화 상자에서 스터디(Study)를 선택합니다.
  4. 복사(Copy)를 클릭합니다.
  5. 다른 이름으로 리스팅 저장(Save Listing As) 대화 상자에서 필요에 따라 속성을 수정합니다.
  6. 저장(Save)을 클릭합니다.

두 스터디 간에 스터디 디자인 차이가 있는 경우 CDB에서 목록을 잘못된 것으로 표시할 수 있습니다. 모든 오류가 해결되고 목록이 유효한 상태가 될 때까지 CQL 편집기 또는 목록 빌더를 사용하여 목록을 수정하십시오.

사용자 정의 목록 편집

목록 빌더에서 목록을 생성한 경우 목록 빌더를 사용하거나 CQL 편집기에서 해당 CQL 문을 수정하여 편집할 수 있습니다. 그렇지 않으면 목록의 CQL 또는 해당 속성만 편집할 수 있습니다.

목록 빌더에서 목록을 수정하는 방법은 다음과 같습니다.

  1. 워크벤치에서 스터디로 이동합니다.
  2. 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)에서 목록(Listings) 페이지를 엽니다.
  3. 편집하려는 목록을 찾습니다.
  4. 목록의 제목(Title)을 클릭하여 엽니다.
  5. 수정(Modify)을 클릭합니다.
  6. 원하는 대로 변경합니다.
  7. 선택 사항: 미리 보기(Preview)를 클릭하여 목록을 미리 봅니다. 그러면 새 창에서 목록 미리 보기가 열립니다.
  8. 검증 및 저장(Validate and Save)을 클릭합니다.

사용자 정의 목록의 CQL 쿼리를 편집하는 방법은 다음과 같습니다.

  1. 워크벤치에서 스터디로 이동합니다.
  2. 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)에서 목록(Listings) 페이지를 엽니다.
  3. 편집하려는 목록을 찾습니다.
  4. 목록의 제목(Title)을 클릭하여 엽니다.
  5. CQL 편집기(CQL Editor)를 클릭합니다.
  6. CQL 쿼리를 편집합니다.
  7. 목록(Listings) 메뉴에서 저장(Save)을 선택합니다.

사용자 정의 목록의 속성을 편집하는 방법은 다음과 같습니다.

  1. 워크벤치에서 스터디로 이동합니다.
  2. 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)에서 목록(Listings) 페이지를 엽니다.
  3. 편집하려는 목록을 찾습니다.
  4. 목록의 제목(Title)을 클릭하여 엽니다.
  5. 화살표()를 클릭하여 목록(Listing) 메뉴를 엽니다.
  6. 속성(Properties)을 선택합니다.
  7. 속성(Properties) 대화 상자에서 편집(Edit)을 클릭합니다.
  8. 원하는 대로 변경합니다.
  9. 저장을 클릭합니다.

잘못된 목록: 잘못된 목록의 속성은 편집할 수 없습니다. 속성을 편집하려면 목록의 CQL 문을 업데이트하여 유효하게 만드십시오.

목록 빌더: 목록 수정

마지막 업데이트: 23R3

이 비디오에서는 목록 빌더를 사용하여 기존 목록을 수정하는 방법을 보여 줍니다.

사용자 정의 목록 삭제

생성한 사용자 정의 목록을 삭제할 수 있습니다. 코어 목록 또는 다른 사용자가 생성한 사용자 정의 목록은 삭제할수 없습니다.

사용자 정의 목록을 삭제하는 방법은 다음과 같습니다.

  1. 워크벤치에서 스터디로 이동합니다.
  2. 스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)()에서 목록(Listings) 페이지를 엽니다.
  3. 삭제하려는 목록을 찾습니다.
  4. 해당 목록의 제목(Title) 위로 마우스를 가져가면 목록 메뉴(Listing Menu)가 표시됩니다.

목록(Listing) 메뉴

  1. 화살표()를 클릭하여 목록(Listing) 메뉴를 엽니다.
  2. 목록 삭제(Delete Listing)를 선택합니다.

목록 삭제(Delete Listing) 메뉴 옵션

  1. 워크벤치에서 사용자 정의 목록이 삭제됩니다. 목록이 해당 범주에 있는 유일한 목록인 경우 워크벤치는 범주도 삭제합니다.

예시 사용자 정의 목록

아래 예시는 Verteo Pharma의 Deetoza 스터디에 대한 사용자 정의 목록입니다.

이 예시에서는 가상 스터디인 Deetoza를 사용합니다. 자체 스터디에서 예시를 다시 생성하려면 항목, 항목 그룹, 폼 및 이벤트에 대한 참조를 업데이트하여 자체 스터디에 있는 정의를 가리키도록 합니다.

예시: 투여량

아래 예시 목록은 "투여량"입니다. 이 목록은 투여 폼의 실제 투여량, 단위, 경로 및 빈도 항목을 보여 줍니다. Deetoza 스터디에서는 각 치료 방문 이벤트에 대해 하나의 투여 폼 정의를 재사용하기 때문에 목록에는 이벤트 이름과 이벤트 날짜도 표시됩니다. 즉, 목록에는 각 대상자가 완료한 각 치료 방문에 대한 행이 포함되어 있습니다.

이 목록에서는 제출됨 상태가 아닌 폼 또는 발생하지 않음으로 표시된 이벤트 내의 폼이 제외됩니다.

이 예시 목록은 분석 범주에 있습니다. Verteo Pharma는 분석에 사용되는 모든 목록을 이 범주로 분류합니다.

투여량 사용자 정의 목록

투여량 사용자 정의 목록은 다음 CQL 쿼리를 사용합니다.

select @HDR.Subject, @HDR.Event.Name as Event, @HDR.Event.Date, dosing.start_date_and_time as Start_DateTime, dosing.stop_date_and_time as Stop_DateTime, dosing.actual_dose as Actual_Dose, dosing.dose_units as Units, dosing.dose_route as Route, dosing.dose_frequency as Frequency from EDC.Dosing where @Form.Status = 'submitted__v' or @HDR.Event.Status IN ('did_not_occur__v')

이 쿼리는 별칭(as)을 사용하여 열 이름을 줄입니다. CQL 참조에서 별칭에 대해 자세히 알아보십시오.

예시: 대상자 성별 레포트

아래 예시 목록은 "대상자 성별 레포트"입니다. 이 목록은 인구 통계 폼의 대상자 성별(subject_gender) 항목을 기반으로 성별에 따른 대상자 비율을 보여 줍니다. 쿼리는 Round() 및 Count() 함수와 산술 연산자를 사용하여 각 성별을 구성하는 총 대상자 수의 비율을 계산합니다.

이 대상자 성별 레포트 목록은 레포트 범주를 사용합니다. Verteo Pharma는 보고를 위한 모든 목록을 이 범주로 분류합니다.

이 목록에서는 인구 통계 폼이 제출됨 상태가 아니거나 발생하지 않음으로 표시된 스크리닝 이벤트 내의 대상자가 제외됩니다.

대상자 성별 레포트 목록

대상자 성별 레포트 사용자 정의 목록은 다음 CQL 쿼리를 사용합니다.

select `subject_gender` as Gender, Count(@HDR.Subject.Name) as CNT, (Round(Count(@HDR.Subject.Name)/(Select Count(@HDR.Subject.Name) from EDC.demographics ttl_subj)*100,2)) as Percentage from EDC.demographics where @Form.Status = 'submitted__v' or @HDR.Event.Status in ('did_not_occur__v') group by `subject_gender` order by Percentage desc

목록 정의 다운로드

목록 정의(CQL 문)를 텍스트(.txt) 파일로 다운로드할 수 있습니다. CDB는 파일 이름을 "Vault ID-스터디 ID <목록 이름> 정의 날짜/시간.txt"로 지정합니다.

목록 정의를 다운로드하는 방법은 다음과 같습니다.

  1. 다운로드하려는 목록을 엽니다.

  2. 목록(Listing)() 메뉴에서 정의 다운로드(Download Definition)를 선택합니다.

  3. 파일을 다운로드하고 원하는 텍스트 편집기에서 엽니다.

스터디에 단일 리스팅 복사

단일 리스팅 정의를 다른 스터디로 복사할 수 있습니다.

리스팅을 복사하는 방법은 다음과 같습니다.

  1. 복사하려는 리스팅을 엽니다.

  2. 리스팅() 메뉴에서 복사 대상(Copy to)을 선택합니다.

  3. 스터디로 복사(Copy to Study) 대화 상자에서 스터디(Study)를 선택합니다.
  4. 복사(Copy)를 클릭합니다.
  5. 다른 이름으로 리스팅 저장(Save Listing As) 대화 상자에서 필요에 따라 속성을 수정합니다.
  6. 저장(Save)을 클릭합니다.

두 스터디 간에 스터디 디자인 차이가 있는 경우 CDB에서 목록을 잘못된 것으로 표시할 수 있습니다. 모든 오류가 해결되고 목록이 유효한 상태가 될 때까지 CQL 편집기 또는 목록 빌더를 사용하여 CQL 문을 수정하십시오.