커스텀 리스팅 생성

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

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

리스팅 액세스

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

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

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

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

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

사용자 정의 리스팅 생성

워크벤치에서 스터디로 이동합니다.
새로 생성(Create New) 메뉴에서 리스팅(Listing)을 선택합니다.
사용 가능한 속성(Available Properties)에서 선택한 속성(Selected Properties)으로 속성(Properties)을 끌어다 놓아 리스팅에 추가합니다. 속성 그룹을 끌어오거나 확장(Expand)을 클릭하여 개별 속성을 선택할 수 있습니다.
제거(Remove)()를 클릭하여 리스팅에서 속성을 제거합니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 아이템(Items)을 클릭합니다.
사용 가능한 속성(Available Properties)에서 선택한 속성(Selected Properties)으로 폼(Forms)을 끌어다 놓아 리스팅에 추가합니다. 전체 폼(Form)을 끌어오거나 확장(Expand)을 클릭하여 해당 폼에서 개별 아이템(Items)을 선택할 수 있습니다.
제거(Remove)()를 클릭하여 리스팅에서 아이템을 제거합니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 배열(Arrange)을 클릭합니다.
속성, 폼 및 아이템을 끌어다 놓아 재정렬합니다.
리스팅에 보기를 추가하려면 보기(Views)를 클릭하고 7~9단계를 반복합니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 행(Rows)을 클릭합니다.
행 구조(Row Structure)를 선택합니다.
- 대상자별(By Subject): 이 옵션은 스터디 일정과 관계없이 대상자에 대한 단일 행에 여러 이벤트의 데이터를 표시하려고 시도하며, 이벤트에서 대상자가 일치하는 모든 데이터를 표시합니다. 이벤트 날짜 또는 이벤트 이름과 같은 선택한 일정 관련 필드는 리스팅에서 null로 설정됩니다.
- 일정별(By Schedule): 이 옵션은 서로 다른 이벤트의 폼 데이터를 별도의 행에 표시합니다. 일정 관련 필드가 필요한 경우 이 옵션을 사용하는 것이 좋습니다. 모든 코어 리스팅에 대한 기본 옵션입니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 열(Columns)을 클릭합니다.
열 구조(Column Structure)를 선택합니다.
- 확장형(나란히)(Wide (Side by Side)): 이 옵션을 사용하면 각 열이 하나의 고유한 아이템 또는 아이템 속성을 나타냅니다.
- 스택형(연합)(Stacked (Union)): 이 옵션을 사용하면 각 열에 여러 아이템 또는 아이템 속성이 함께 누적될 수 있으며, 사용자가 열당 최대 5개의 아이템 및/또는 아이템 속성을 포함시킬 수 있습니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 별칭(Aliases)을 클릭합니다.
기본값이 아닌 헤더를 사용하려는 모든 열에 대해 열 별칭(Column Alias)을 입력합니다.
왼쪽 리스팅 빌더(Listing Builder) 메뉴에서 정렬 및 필터링(Sort & Filter)을 클릭합니다.
정렬 및 필터링(Sort & Filter) 메뉴를 사용하여 모든 열에 정렬 순서와 필터를 적용할 수 있습니다.
선택 사항: 미리 보기(Preview)를 클릭하여 리스팅을 미리 봅니다. 그러면 새 창에서 리스팅 미리 보기가 열립니다.
검증 및 저장(Validate and Save)을 클릭합니다.
리스팅 제목(Title)을 입력합니다. 이 제목은 스터디 내에서 고유해야 합니다.
리스팅에서 범주(Category)를 선택합니다.
선택 사항: 새 범주를 생성하려면 범주 필드의 텍스트를 지우고 범주 이름을 입력합니다. 동일한 이름의 범주가 아직 없는 경우 Enter를 누르거나 드롭다운에서 범주 추가(Add Category)를 선택합니다.
선택 사항: 기본적으로 리스팅은 비공개이므로 사용자만 볼 수 있습니다. 공개 리스팅을 생성하려면 리스팅 액세스(Listing Access)에 대해 공개(Public)를 선택합니다. 공개 리스팅은 워크벤치와 스터디에 접근할 수 있는 모든 사용자가 볼 수 있습니다. 그렇지 않으면 이 설정을 비공개(Private)로 둡니다.
선택 사항: 이 리스팅을 검토할 수 있도록 하려면 검토(Review) 활성화됨(Enabled)을 선택합니다. 그렇지 않으면 검토를 비활성화됨으로 설정하여 일반 공개 또는 비공개 리스팅을 생성합니다.
설명(Description)을 입력합니다.
저장을 클릭합니다. 워크벤치는 사용자 정의 리스팅을 저장하고 엽니다.

리스팅 빌더: 아이템 및 속성 선택

마지막 업데이트: 23R3

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

리스팅 빌더: 리스팅 구조 설정

마지막 업데이트: 23R3

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

리스팅 빌더: 검증

마지막 업데이트: 23R3

이 비디오에서는 리스팅 빌더의 검증을 검토합니다.

CQL을 사용하여 사용자 정의 리스팅 생성

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

워크벤치에서 스터디로 이동합니다.
스터디(Study) 메뉴 또는 탐색 창(Navigation Drawer)()에서 리스팅(Listings) 페이지를 엽니다.
시작할 코어 리스팅 또는 기존 사용자 정의 리스팅을 선택합니다.
해당 리스팅의 제목(Title)을 클릭하여 엽니다.
CQL 편집기(CQL Editor)를 클릭합니다.
CQL 쿼리를 편집하여 리스팅에 원하는 데이터를 표시합니다.
적용(Apply)을 클릭합니다.
리스팅을 검토합니다. 필요한 경우 CQL 쿼리를 다시 편집하고 리스팅에 표시된 데이터에 만족할 때까지 다시 적용합니다.
리스팅 메뉴(Listing Menu)에서 다른 이름으로 저장(Save As)을 선택합니다.
리스팅 제목(Title)을 입력합니다. 이 제목은 스터디 내에서 고유해야 합니다.
리스팅에서 범주(Category)를 선택합니다.
선택 사항: 새 범주를 생성하려면 범주 필드의 텍스트를 지우고 범주 이름을 입력합니다. 동일한 이름의 범주가 아직 없는 경우 Enter를 누르거나 드롭다운에서 범주 추가(Add Category)를 선택합니다.
선택 사항: 기본적으로 리스팅은 비공개이므로 사용자만 볼 수 있습니다. 공개 리스팅을 생성하려면 리스팅 액세스(Listing Access)에 대해 공개(Public)를 선택합니다. 공개 리스팅은 워크벤치와 스터디에 접근할 수 있는 모든 사용자가 볼 수 있습니다. 그렇지 않으면 이 설정을 비공개(Private)로 둡니다.
선택 사항: 이 리스팅을 검토할 수 있도록 하려면 검토(Review) 활성화됨(Enabled)을 선택합니다. 그렇지 않으면 검토를 비활성화됨으로 설정하여 일반 공개 또는 비공개 리스팅을 생성합니다.
설명(Description)을 입력합니다.
저장을 클릭합니다. 워크벤치는 사용자 정의 리스팅을 저장하고 엽니다.

스터디에 단일 리스팅 복사

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

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

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

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

사용자 정의 리스팅 편집

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

리스팅 빌더에서 리스팅을 수정하는 방법은 다음과 같습니다.

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

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

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

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

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

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

리스팅 빌더: 리스팅 수정

마지막 업데이트: 23R3

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

사용자 정의 리스팅 삭제

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

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

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

화살표()를 클릭하여 리스팅(Listing) 메뉴를 엽니다.
리스팅 삭제(Delete Listing)를 선택합니다.

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

예시 사용자 정의 리스팅

아래 예시는 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"로 지정합니다.

리스팅 정의를 다운로드하는 방법은 다음과 같습니다.

다운로드하려는 리스팅을 엽니다.
리스팅(Listing)() 메뉴에서 정의 다운로드(Download Definition)를 선택합니다.
파일을 다운로드하고 원하는 텍스트 편집기에서 엽니다.

스터디에 단일 리스팅 복사

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

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

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

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

폼 변경 로그

리스팅에 대한 폼 변경 로그를 다운로드하여 참조되는 폼에 대한 기록 변경 사항을 검토할 수 있습니다.

폼 변경 로그를 다운로드하는 방법은 다음과 같습니다.

검토하려는 리스팅으로 이동합니다.
리스팅(Listing) 메뉴()에서 폼 변경 로그(Form Change Log)를 선택합니다.
워크벤치에서 로그 파일을 생성하는 작업을 시작합니다. 완료되면 워크벤치는 화면 왼쪽 아래에 로그를 다운로드할 수 있는 링크가 포함된 알림을 표시합니다. 이 링크를 클릭하여 다운로드할 수 있습니다.