아이템 및 코드 목록 가져오기

25R1& 이후

Studio에서 스터디를 설계할 때 CSV 템플릿을 가져와서 항목 및 코드 목록을 자동으로 생성할 수 있습니다. 스터디당 하나의 사례집 버전을 가져올 수 있습니다.

가져오는 방법

항목을 가져오려면

1. Studio에서 스터디로 이동합니다.
2. 스터디 오브젝트에서 항목을 클릭합니다.
3. 항목 가져오기를 선택합니다.
4. 가져오기 CSV 파일을 여기에 파일 끌어다 놓기(Drag and drop file here) 영역으로 끌어다 놓습니다. 이 영역을 클릭하여 파일을 업로드할 수도 있습니다.
5. 항목 가져오기 미리 보기 페이지가 나타납니다.

코드 목록을 가져오려면

1. 스터디 오브젝트에서 코드 목록을 클릭하고 코드 목록 가져오기를 선택합니다.
2. 가져오기 CSV 파일을 여기에 파일 끌어다 놓기(Drag and drop file here) 영역으로 끌어다 놓습니다. 이 영역을 클릭하여 파일을 업로드할 수도 있습니다.
3. 코드 목록 가져오기 미리 보기 페이지가 나타납니다.

취소를 클릭하여 가져오기를 중지합니다.

가져오기 섹션

가져오기 섹션에는 다음 정보가 표시됩니다.

• 파일 이름
• 파일 크기
• 행 수

가져오기 섹션에서 이 도움말 페이지에 대해 링크를 사용하여 CSV 템플릿에 빠르게 액세스할 수 있습니다(CSV 템플릿을 다운로드하려면 코드 목록 및 항목 섹션 참조).

결과 미리 보기 표

파일이 선택되면 자동으로 처리되고 검증됩니다. 하나 이상의 파일이 성공적으로 처리되면 결과 미리 보기 표가 표시됩니다. 이 표에는 다음 정보가 포함됩니다.

• 처리된 총 레코드 수
• 검증을 통과한 레코드 수
• 검증을 실패한 레코드 수
• 결과 표의 가져오기 상태 열
• 각 템플릿 열의 결과 열(열은 정렬할 수 없음)
• 페이지의 결과 수

세 가지 상태(오류, 경고 및 가져오기 준비 완료)를 기준으로 레코드를 필터링할 수 있습니다.

페이지의 탐색 옵션을 사용하여 다음 결과 페이지로 이동하거나 이전 결과 페이지로 돌아갈 수 있습니다. 특정 페이지 번호를 입력하면 해당 결과 페이지로 바로 이동하여 빠르게 액세스할 수도 있습니다.

항목 가져오기

가져오기에 성공하면 itemdefs 및 item_def_codelist_defs가 CDMS에서 다시 생성됩니다. Studio에서 itemdef를 볼 수 있습니다. Item_def_codelist_defs는 어드민 > 비즈니스 어드민에서만 액세스할 수 있습니다.

itemdefs CSV 파일에는 오류가 없어야 합니다. 문제는 Studio 외부 템플릿에서 수정한 다음 다시 가져올 수 있습니다. 항목을 성공적으로 가져오면 항목 섹션에 CSV 파일의 각 항목이 CSV에 정의된 속성과 일치하는 고유 항목으로 표시됩니다. 예를 들어 항목의 데이터 유형이 "시간"으로 설정되면 이 속성은 Studio에 반영됩니다.

itemdef가 시스템에 이미 있는 경우 다시 가져오려고 하면 오류가 발생할 수 있습니다. 기존 항목을 업데이트하려면 Studio에서 바로 변경합니다. CSV에 포함되지 않는 속성(예: 들여쓰기, 제어 항목 또는 점진적 표시)을 가져온 후 수동으로 업데이트해야 합니다.

아래 템플릿을 가져오기 파일로 사용합니다.

항목 가져오기 템플릿 다운로드

항목 필수 열

다음 열은 항목 가져오기 파일에서 필수입니다.

열	선택
Item Name	텍스트
외부 ID	텍스트
레이블	텍스트
Item Type	텍스트, Veeva 값. 옵션: EDC, 상태, 헤더, 읽기 전용, 파생됨
Data Type	텍스트, Veeva 값. 옵션: 텍스트, 날짜, 날짜/시간, 시간, 불린, URL, 코드 목록, 레이블, 숫자, 단위
코드 목록 정의	텍스트. 기존 코드 목록 정의와 일치해야 합니다. *데이터 형식이 코드 목록과 같은 경우 필수.
단위 정의	텍스트. 기존 코드 단위 목록 항목 정의와 일치해야 합니다. *데이터 형식이 단위와 같은 경우 필수.

다음은 열은 선택 사항입니다.

열	선택
선택	텍스트

코드 목록 가져오기

가져오기가 완료되면 codelistdefs, codelistitemdefs 및 codelist_def_codelist_item_defs가 CDMS에서 다시 생성됩니다. Studio에서 codelistdefs 및 codelistitemdefs를 볼 수 있습니다. Codelist_def_codelist_item_defs는 어드민 > 비즈니스 어드민에만 표시됩니다.

codelistdefs CSV 파일에는 오류가 없어야 합니다. 문제는 Studio 외부 템플릿에서 수정한 다음 다시 가져올 수 있습니다. 코드 목록을 성공적으로 가져오면 코드 목록 섹션에 각 코드 목록이 코드 목록에 할당된 항목을 포함하는 개별 고유 항목으로 표시됩니다. 가져온 각 항목의 속성은 CSV에 정의된 속성과 일치하므로 템플릿의 "항목 1"에 대해 코드 = "1"인 경우 Studio와 동일하게 표시됩니다.

가져오는 codelistdef가 이미 있는 경우 오류가 나타납니다. 기존 코드 목록을 업데이트하려면 Studio에서 바로 변경합니다.

아래 템플릿을 가져오기 파일로 사용합니다.

코드 목록 가져오기 템플릿 다운로드

코드 목록 필수 열

다음 열은 코드 목록 가져오기 파일에서 필수입니다.

열	Data Type
코드 목록 이름	텍스트(최대 128자)
코드 목록 외부 ID	텍스트(최대 128자)
코드 목록 설명	선택
코드 목록 항목 순서	번호(0~9,999)
코드 목록 항목 코드	텍스트(최대 100자)
코드 목록 항목 레이블	텍스트(최대 1,500자)
숨김	불린(예/아니요)

다음은 열은 선택 사항입니다.

열	Data Type
코드 목록 설명	텍스트(최대 256자)
코드 목록 항목 설명	텍스트(최대 255자)

숨겨진 값은 대소문자를 구분합니다.

코드 목록을 식별하기 위해 별도의 행을 추가할 필요가 없습니다.

형식 지정

순차적 순서 번호와 허용된 필드 문자는 가져오기 이후에도 검증됩니다.

코드 목록의 경우 순서 번호가 시퀀스를 벗어나면 시스템은 마지막 유효한 번호에 따라 자동으로 재할당합니다. 예를 들어 코드 목록의 항목 세 개가 1, 10, 3으로 번호가 매겨진 경우 10은 3에 재할당되고 3은 2가 됩니다.

필드의 경우 다음 문자만 허용됩니다.

• a-z, A-Z
• 0-9
• 하이픈(-)
• 단일 밑줄(_)

행에 잘못된 문자가 있으면 해당 레코드에 오류 메시지가 나타납니다.

기본값

기본값이 템플릿에 포함되지 않는 필수 속성에 자동으로 입력됩니다. Studio에서 이 값을 업데이트할 수 있습니다. 모든 항목 정의는 불린 데이터 유형을 제외하고 기본적으로 필수로 설정됩니다. 코드 목록 또는 단위 데이터 유형이 있는 항목은 기존 코드 목록 또는 단위 정의를 참조하여 성공적으로 내보내야 합니다. 행이 존재하지 않는 오브젝트를 참조하는 경우 오류가 발생하고 파일을 가져올 수 없습니다. 이 문제를 해결하려면 먼저 누락된 코드 목록 또는 단위 정의를 가져오거나 파일에서 참조를 제거합니다.

검증 오류

아래 표에는 가능한 검증 오류와 이에 대한 설명이 나와 있습니다.

오류(Error)	선택
가져오기 파일에서 [누락된 열 이름] 열이 누락되었습니다.	CSV 파일은 처리할 수 없습니다. 예를 들어 잘못된 파일이 선택되었습니다.
가져오기 파일에서 [쉼표로 구분된 누락된 열 헤더 목록] 열 헤더가 누락되었습니다.	열이 누락되었습니다.
[쉼표로 구분된 누락된 열 헤더 목록] 필수	필수 값이 누락되었습니다.
[쉼표로 구분된 초과 열 헤더 목록]의 값이 문자 수 제한을 초과합니다.	해당 값의 문자 수는 각 텍스트 필드의 제한 문자 수보다 많습니다.
[열 이름] 값 [열 값]이(가) 잘못되었습니다.	이 값이 해당 선택 목록, 불린 또는 번호 필드에서 허용되지 않습니다.
목록의 순서 번호가 고유하지 않습니다.	특정 코드 목록의 순서 번호가 고유하지 않습니다.
파일의 중복 입력	두 개 이상의 행은 동일한 항목 이름(항목 가져오기의 경우) 또는 코드 목록 이름 + 코드 목록 항목 레이블(코드 목록 가져오기의 경우)을 공유합니다.