리스팅 빌더로 리스팅, 체크 및 뷰 생성

목록 빌더를 사용하면 CQL을 통해 생성하는 대신 UI 인터페이스에서 목록, 검사 및 보기를 생성할 수 있습니다. 이 방법은 세 개체 모두에서 동일합니다.

목록, 검사 또는 보기 생성

목록, 검사 또는 보기를 생성하는 방법은 다음과 같습니다.

1. 워크벤치(Workbench) 탭으로 이동합니다.
2. 스터디(Studies) 리스팅에서 스터디(Study)를 클릭하여 엽니다.

3. 위쪽 탐색 모음에 있는 새로 생성(Create New) 메뉴에서 목록(Listing), 검사(Check), 보기(View) 중에서 생성하려는 개체를 선택합니다.

4. 그러면 리스팅 빌더가 열립니다. 이 페이지의 지침에 따라 표시할 데이터를 선택하고, 리스팅의 구조를 정의하고, 표시 옵션을 구성합니다.

표시할 속성 및 아이템 선택&

목록 생성의 첫 번째 단계는 표시할 속성과 항목을 선택하는 것입니다.

전체 속성 목록은 CQL 참조를 참조하십시오.

속성은 스터디(Study)와 아이템(Items)이라는 두 그룹으로 나뉩니다. 스터디 속성은 운영 프로젝션 요소(@HDR 속성)와 폼 또는 항목 그룹 속성(@Form 및 @ItemGroup)입니다. 아이템은 개별 폼의 데이터 수집 아이템입니다. 코드 목록 항목은 코딩된 값과 디코딩된 값을 모두 표시할 수 있습니다.

속성을 추가하는 방법

사용 가능한 속성(Available Properties)에서 선택한 속성(Selected Properties)으로 속성을 끌어다 놓아 리스팅에 추가합니다. 이후 단계에서 이러한 속성을 다시 정렬할 수 있습니다. 속성을 추가하면CDB의 목록 빌더 탐색(Listing Builder Navigation)에 추가된 속성 개수가 표시됩니다.

스터디 속성은 스터디, 사이트, 대상자, 방문 그룹, 방문, 폼, 아이템 그룹 등 개체별로 그룹화됩니다. 개체(Object)를 끌어와 모든 속성을 추가하거나, 개체를 클릭하여 확장하고 개별 속성을 끌어올 수 있습니다.

리스팅에는 특정 스터디 속성이 자동으로 포함됩니다. 이러한 기본값은 관리자가 코어 데이터 목록 구성 설정에서 정의합니다.

아이템 속성은 폼 및 보기별로 그룹화됩니다. 폼(Form)을 끌어다 놓아 모든 항목을 추가할 수 있고 보기(View)를 끌어다 놓아 모든 열을 추가할 수 있습니다. 속성 검색(Search for properties)을 사용하여 개별 아이템을 검색하고 선택할 수도 있습니다.

속성 검색(Search for properties) 필드에 아이템의 이름을 입력합니다. CDB에서 입력과 동시에 검색합니다.

폼(Forms)이 선택된 항목을 검색하면 CDB에서 폼의 항목을 검색합니다. 보기(Views)가 선택된 항목을 검색하면 CDB에서 보기의 항목을 검색합니다. 동일한 항목이 여러 위치에서 사용되는 경우 CDB는 검색 결과에 항목에 대한 항목 그룹도 표시합니다.

아이템을 추가한 후에는 선택한 속성(Selected Properties) 영역에서 아이템을 확장하여 추가 옵션을 표시할 수 있습니다. 이렇게 하면 아이템의 데이터 형식(예: 추가 날짜 형식 또는 작업 세부 사항)에 따라 아이템에 대한 추가 열이 추가됩니다. 특정 열은 기본적으로 포함됩니다. 이러한 기본값은 관리자가 코어 데이터 목록 구성 설정에서 정의합니다. 아래 예시에서 CDB에는 aestart 항목에 대한 대치 날짜(Imputed Date) 및 SDTM 날짜(SDTM Date) 모두에 대한 열이 포함됩니다.

속성을 제거하는 방법

선택한 속성(Selected Properties) 영역에서 제거(Remove)()를 클릭하여 속성을 제거할 수 있습니다.

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

마지막 업데이트: 23R3

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

리스팅의 구조 정의

구조(Structure) 단계에서는 행과 열에 대한 구조적 옵션을 정의할 수 있습니다.

행 구조

행 구조를 선택하면 데이터를 스터디 일정에 종속적으로 또는 독립적으로 정렬할지 여부를 선택할 수 있습니다. 두 가지 옵션을 사용할 수 있습니다.

• 대상자별(By Subject): 이 옵션은 스터디 일정과 관계없이 대상자에 대한 단일 행에 여러 방문의 데이터를 표시하려고 시도하며, 방문에서 대상자가 일치하는 모든 데이터를 표시합니다. 방문 날짜(Event Date) 또는 방문 이름(Event Name)과 같은 선택한 일정 관련 필드는 리스팅에서 null로 설정됩니다.
• 일정별(By Schedule): 이 옵션은 서로 다른 방문의 폼 데이터를 별도의 행에 표시합니다. 일정 관련 필드가 필요한 경우 이 옵션을 사용하는 것이 좋습니다. 모든 코어 리스팅에 대한 기본 옵션입니다.

예를 들어 리스팅에 방문 1(성별 아이템) 및 방문 2(테스트 결과)라는 두 방문의 아이템이 포함되어 있습니다. 행 구조에 대해 대상자별(By Subject)을 선택하면 리스팅에는 대상자당 하나의 행이 있으며, 각 아이템은 해당 방문의 값이 채워진 리스팅의 열로 표시됩니다. 행 구조에 대해 일정별(By Schedule)을 선택하면 CDB에서 스터디 일정에 두 개의 이벤트가 있는 것으로 간주하고 각 이벤트에 대한 행을 생성합니다. 이벤트에 항목이 포함되지 않은 행의 경우 CDB의 해당 항목 열의 값은 null("-")이 됩니다.

열 구조

열 구조를 정의하면 예를 들어 서로 다른 원본의 데이터를 누적 열로 결합하여 더 좁고 읽기 쉬운 리스팅을 만들 수 있습니다. 두 가지 옵션을 사용할 수 있습니다.

• 확장형(나란히)(Wide (Side by Side)): 이 옵션을 사용하면 각 열이 하나의 고유한 아이템 또는 아이템 속성을 나타냅니다.
• 스택형(연합)(Stacked (Union)): 이 옵션을 사용하면 각 열에 여러 아이템 또는 아이템 속성이 함께 누적될 수 있으며, 사용자가 열당 최대 5개의 아이템 및/또는 아이템 속성을 포함시킬 수 있습니다. 항목 이름의 여러 인스턴스가 표시되는 경우 항목 그룹 이름이 괄호 안에 표시됩니다.

스택 생성

행 구조에 대해 스택형(연합)(Stacked (Union)을 선택하면 여러 항목 또는 항목 속성을 함께 누적할 수 있습니다.

1. 열 구조(Column Structure)에서 스택형(연합)(Stacked (Union))을 선택합니다.
2. 누적할 열(Columns)을 선택합니다. 이러한 열은 동일한 데이터 형식을 사용해야 합니다.
3. 선택 사항: 스택에 행을 추가하려면 스택(Stack)을 클릭합니다. 행을 제거하려면 삭제(Delete)를 클릭합니다.

최대 5개의 스택을 포함할 수 있습니다.

목록 빌더: 목록 구조 설정

마지막 업데이트: 23R3

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

표시 옵션 구성

구성 가능한 표시 옵션에는 별칭(Aliases), 배열(Arrange), 정렬 및 필터링(Sort & Filter)과 같이 세 가지가 있습니다.

별칭(Aliases)

별칭(열 헤더)은 별칭(Aliases) 단계에서 정의할 수 있습니다. 이는 CQL에서 AS를 사용하는 것과 동일합니다. 이름을 바꾸려는 각 열에 대해 열 별칭(Column Alias)의 값을 입력합니다. 기본적으로 누적 열은 맨 위 아이템의 이름을 사용하므로 전체 스택을 설명하는 별칭을 사용하는 것이 좋습니다.

배열(Arrange)

배열 단계에서 열과 스택을 재정렬할 수 있습니다. 열과 스택을 원하는 순서로 끌어다 놓습니다. 상단으로 이동(Move to Top), 위로 이동(Move Up), 아래로 이동(Move Down) 및 하단으로 이동(Move to Bottom) 버튼을 사용하여 열과 스택을 원하는 위치로 이동할 수도 있습니다.

정렬 및 필터링(Sort & Filter)

정렬 방법

여러 열을 기준으로 목록을 정렬할 수 있습니다.

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

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

필터링 방법

열에 필터를 적용하여 반환되는 데이터를 제한할 수 있습니다. 이는 AND 필터입니다.

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

1. 확인을 클릭합니다.

열에서 필터를 초기화(제거)하려면 정렬 및 필터링& 메뉴를 열고 조건(Condition)을 확장한 다음 지우기(Clear)를 클릭합니다.

리스팅 미리 보기

저장하기 전에 리스팅을 미리 보고 구성을 확인할 수 있습니다. 미리 보기(Preview)를 클릭합니다. 그러면 새 창에서 스터디의 기록이 최대 25개까지 포함된 미리 보기 리스팅이 열립니다.

리스팅을 변경하는 동안 이 미리 보기 창을 열어 둘 수 있습니다. 변경 사항으로 미리 보기를 업데이트하려면 미리 보기 창에서 새로 고침(Refresh)을 클릭합니다.

검증 및 저장&

리스팅 구성을 완료했으면 검증 및 저장(Validate and Save)를 클릭합니다. 먼저 CDB에서 목록, 검사 또는 보기에 오류가 있는지 확인합니다. 오류가 없는 경우 CDB에서 목록 속성을 정의하고 저장할 수 있는 대화 상자를 엽니다.

워크벤치는 검증 오류가 포함된 각 단계에 대해 목록 빌더 탐색(Listing Builder Navigation)에 경고(Warning) 아이콘을 표시합니다. 아이콘 위로 마우스를 가져가면 오류 메시지를 볼 수 있습니다.

목록 빌더: 검증

마지막 업데이트: 23R3

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

리스팅 빌더를 통해 수정하는 방법

저장 후에도 목록 빌더를 사용하여 목록, 검사 및 보기를 수정할 수 있습니다. 이렇게 하려면 목록, 검사 또는 보기로 이동하여 수정(Modify)을 클릭합니다.