가져오기를 위한 키 매핑

EDC에서 스터디가 구성된 방식에 따라 타사 데이터가 데이터 파일의 스터디, 사이트, 대상자 또는 이벤트에 대해 EDC 값과 일치하지 않는 다른 값을 가질 수 있는 시나리오가 있습니다. 데이터 공급업체가 데이터를 수정하도록 하면 비용이 많이 들거나 불가능할 수 있으므로 대신 CDB는 타사 데이터 로드에서 들어오는 값을 기존 EDC 데이터에 매핑하는 기능을 지원합니다.

사전 구성 요소

필요한 권한

표준 CDMS Super User(CDMS 슈퍼 사용자) 스터디 역할을 보유한 사용자는 기본적으로 아래 설명된 작업을 수행할 수 있습니다. 조직에서 사용자 정의 스터디 역할을 사용하는 경우, 역할에서 다음 권한(%)을 부여해야 합니다.

유형(Type)	권한 레이블	컨트롤
표준 탭	워크벤치(Workbench) 탭	워크벤치 탭을 통해 데이터 워크벤치 애플리케이션에 액세스하고 이를 사용할 수 있는 권한
기능적 권한	가져오기 보기	가져오기 페이지에 액세스할 수 있는 기능
기능적 권한	키 매핑 관리	가져오기를 위한 키 매핑을 만들고 관리할 수 있는 기능

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

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

매핑 유형

키 매핑에는 스터디, 사이트, 대상자 및 이벤트의 네 가지 유형 또는 레벨이 있습니다. 워크벤치에는 키 매핑 템플릿 유형에 따라 ZIP 파일에 추가 데이터가 포함되어 있습니다. 각 키 매핑 유형에 대한 추가 데이터는 다음과 같습니다.

스터디: 스터디 이름과 스터디의 외부 ID를 나열하는 CSV 파일
사이트: 스터디 환경의 모든 사이트에 대한 사이트 번호와 사이트 이름을 나열하는 CSV 파일
대상자: 스터디의 모든 대상자를 나열하는 CSV 파일
이벤트:
- EDC의 마지막 내보내기를 기반으로 모든 이벤트 정의를 나열하는 CSV 파일
- EDC의 마지막 내보내기를 기반으로 모든 이벤트 그룹 정의를 나열하는 CSV 파일

키 맵은 원본/키 매핑 레벨에서 스터디에 대해 정의되므로 원본당 최대 4개의 서로 다른 키 매핑을 가질 수 있습니다. 지정된 원본 및 레벨 조합에 대한 모든 업데이트는 동일한 원본 및 레벨 조합에 대한 기존 매핑을 대체합니다.

키 매핑 액세스

CDB의 가져오기(Import) 영역에서 키 매핑에 액세스할 수 있습니다. 탐색 창(Navigation Drawer)()에서 가져오기(Import) 영역으로 이동하거나 스터디(Study)를 선택한 후 스터디(Studies) 페이지의 스터디(Study) 메뉴()에서 이동할 수 있습니다.

가져오기(Import) 영역에 들어갔으면 헤더에서 vpn_key 키 매핑(Key Mappings)을 클릭하여 하위 탭을 엽니다.

열

가져오기(Import) > vpn_key 키 매핑(Key Mapping)에 표시되는 열은 다음과 같습니다.

열	선택
원본(Source)	키 매핑에 대한 원본 이름
키 매핑 유형	키 매핑의 유형(레벨)
상태(Status)	매핑 파일 업로드 상태. 가능한 상태는 보류 중, 완료 및 오류입니다.
업로드됨	매핑 파일이 업로드된 날짜 및 시간(UTC)

매핑 파일 생성

템플릿을 다운로드하는 방법은 다음과 같습니다.

가져오기(Import) > vpn_key 키 매핑(Key Mapping)으로 이동합니다.
키 맵 템플릿(Key Map Template)을 클릭합니다.
템플릿(Template)을 선택합니다.

스터디

스터디 매핑을 생성하는 방법은 다음과 같습니다.

매핑 유형(Mapping Type)에는 일치시키려는 값에 따라 "name" 또는 "external_id"를 입력합니다.
스터디(Study)에는 워크벤치에 있는 스터디 이름 또는 외부 ID(Study_Definitions.csv 파일에 나열됨)를 입력합니다.
들어오는 값(Incoming Value)에는 가져오기 패키지에 있는 스터디 값을 입력합니다.

가능한 각 키 값 쌍에 대해 추가 행을 생성합니다.

아래 표는 Study_mapping_keys.csv 예시 파일입니다.

매핑 유형	스터디	들어오는 값
name	Cholecap	Cholecap_Protocol1

사이트(Site)

사이트매핑을 생성하는 방법은 다음과 같습니다.

매핑 유형(Mapping Type)에는 일치시키려는 값에 따라 "name" 또는 "number"를 입력합니다.
Site(사이트)에는 워크벤치에 있는 사이트 이름 또는 스터디 사이트 번호(매핑 유형 선택에 따라 다름)(Sites.csv 파일에 나열됨)를 입력합니다.
들어오는 값(Incoming Value)에는 가져오기 패키지에 있는 사이트 값을 입력합니다.

가능한 각 키 값 쌍에 대해 추가 행을 생성합니다.

아래 표는 Site_mapping_keys.csv 예시 파일입니다.

매핑 유형	사이트(Site)	들어오는 값
name	Pleasanton General Hospital West	PGH-W
name	Pleasanton General Hospital East	PGH-E

대상자

대상자 매핑을 생성하는 방법은 다음과 같습니다.

대상자(Subject)에는 워크벤치에 있는 대상자 ID를 입력합니다.
들어오는 값(Incoming Value)에는 가져오기 패키지에 있는 대상자 ID를 입력합니다.

가능한 각 키 값 쌍에 대해 추가 행을 생성합니다.

아래 표는 Subject_mapping_keys.csv 예시 파일입니다.

대상자	들어오는 값
0101-10001	101-10001
0101-10002	101-10002
0101-10003	101-10003
0102-10001	102-10001
0102-10002	102-10002

이벤트

이벤트 매핑을 생성하는 방법은 다음과 같습니다.

매핑 유형(Mapping Type)에는 일치시키려는 값에 따라 "name" 또는 "external_id"를 입력합니다.
이벤트(Event)에는 워크벤치에 있는 이벤트 이름 또는 외부 ID를 입력합니다.
이벤트 시퀀스(Event Sequence)에는 워크벤치에 있는 시퀀스 번호를 입력합니다.
들어오는 값(Incoming Value)에는 가져오기 패키지에 있는 이벤트를 입력합니다.

가능한 각 키 값 쌍에 대해 추가 행을 생성합니다.

아래 표는 Event_mapping_keys.csv 예시 파일입니다.

매핑 유형	이벤트	방문 시퀀스	들어오는 값
name	Visit_1	1	Visit_1
name	Visit_2	1	Visit_2
name	Visit_3	1	Visit_3
name	Visit_1	2	Visit_4
name	Visit_2	2	Visit_5
name	Visit_3	2	Visit_6

매핑 가져오기

키 매핑 파일을 가져오는 방법은 다음과 같습니다.

가져오기(Import) > vpn_key 키 매핑(Key Mapping)으로 이동합니다.
매핑 가져오기(Import Mapping)를 클릭합니다.
원본(Source)을 선택합니다.
키 유형(Key Type)을 선택합니다.
파일을 파일(CSV) 선택(Choose a File (CSV)) 영역으로 끌어다 놓습니다.
가져오기를 클릭합니다.

상태 가져오기

워크벤치는 다음 세 가지 상태를 사용하여 키 매핑 가져오기를 추적합니다.

상태(Status)	선택
보류 중(Pending)	가져오기가 완료되지 않았습니다.
완료(Complete)	가져오기가 완료되었습니다.
오류(Error)	하나 이상의 오류로 인해 가져오기가 완료되지 않았습니다.

오류

가져오는 동안 오류가 발생한 경우 오류(Errors) 패널에서 해당 오류를 볼 수 있습니다.

스터디

아래 표에는 스터디 키 매핑에서 발생 가능한 오류가 나열되어 있습니다.

메시지	설명	해상도
하나 이상의 필수 열 헤더 "매핑 유형", "스터디" 및 "들어오는 값"이 누락되었습니다.	매핑 CSV 파일에 필수 열 중 하나가 누락되었거나 CSV 파일에 잘못된 레이블이 있는 헤더가 있습니다.	정확한 레이블이 있는 "매핑 유형", "스터디" 및 "들어오는 값" 열을 포함하도록 CSV 파일을 업데이트합니다.
파일에 "매핑 유형", "스터디" 및 "들어오는 값" 옆에 있는 열이 포함되어 있습니다.	매핑 CSV에는 매핑 유형, 스터디 및 들어오는 값이라는 세 개의 열만 있어야 합니다.	매핑 유형, 스터디 및 들어오는 값 이외의 모든 열을 제거합니다.
파일에 잘못된 "매핑 유형" 값이 포함되어 있습니다. 값은 "External_ID" 또는 "Name"이어야 합니다.	매핑 유형 열에 잘못된 값이 포함되어 있습니다.	매핑 유형 열의 값을 업데이트하여 "External_ID" 또는 "Name"만 사용하도록 합니다.
파일에 혼합된 "매핑 유형" 값이 포함되어 있습니다. 값은 모두 "External_ID" 또는 "Name"이어야 합니다.	키 매핑 파일당 하나의 매핑 유형만 사용할 수 있습니다.	매핑 유형에 둘 다 사용하는 대신 External_ID 또는 Name만 사용하도록 매핑을 업데이트합니다.
파일에 레코드가 포함되어 있지 않습니다.	매핑 파일에 매핑 행이 없습니다.	파일에 매핑을 입력합니다.
파일에 "들어오는 값"이 동일한 여러 행이 포함되어 있습니다.	매핑 파일에 들어오는 값에 대해 동일한 값을 가진 행이 하나 이상 포함되어 있습니다.	중복된 행을 제거하거나 들어오는 값 열을 업데이트하여 중복된 행이 없도록 합니다.

사이트(Site)

아래 표에는 사이트 키 매핑에서 발생 가능한 오류가 나열되어 있습니다.

메시지	설명	해상도
하나 이상의 필수 열 헤더 "매핑 유형", "사이트" 및 "들어오는 값"이 누락되었습니다.	매핑 CSV 파일에 필수 열 중 하나가 누락되었거나 CSV 파일에 잘못된 레이블이 있는 헤더가 있습니다.	정확한 레이블이 있는 "매핑 유형", "사이트" 및 "들어오는 값" 열을 포함하도록 CSV 파일을 업데이트합니다.
파일에 "매핑 유형", "사이트" 및 "들어오는 값" 옆에 있는 열이 포함되어 있습니다.	매핑 CSV에는 매핑 유형, 사이트 및 들어오는 값이라는 세 개의 열만 있어야 합니다.	매핑 유형, 사이트 및 들어오는 값 이외의 모든 열을 제거합니다.
파일에 잘못된 "매핑 유형" 값이 포함되어 있습니다. 값은 "Name" 또는 "Number"여야 합니다.	매핑 유형 열에 잘못된 값이 포함되어 있습니다.	매핑 유형 열의 값을 업데이트하여 "Name" 또는 "Number"만 사용하도록 합니다.
파일에 혼합된 "매핑 유형" 값이 포함되어 있습니다. 값은 모두 "Name" 또는 "Number"여야 합니다.	키 매핑 파일당 하나의 매핑 유형만 사용할 수 있습니다.	매핑 유형에 둘 다 사용하는 대신 Number 또는 Name만 사용하도록 매핑을 업데이트합니다.
파일에 레코드가 포함되어 있지 않습니다.	매핑 파일에 매핑 행이 없습니다.	파일에 매핑을 입력합니다.
파일에 "들어오는 값"이 동일한 여러 행이 포함되어 있습니다.	매핑 파일에 들어오는 값에 대해 동일한 값을 가진 행이 하나 이상 포함되어 있습니다.	중복된 행을 제거하거나 들어오는 값 열을 업데이트하여 중복된 행이 없도록 합니다.

대상자

아래 표에는 대상자 키 매핑에서 발생 가능한 오류가 나열되어 있습니다.

메시지	설명	해상도
하나 이상의 필수 열 헤더 "대상자" 및 "들어오는 값"이 누락되었습니다.	매핑 CSV 파일에 필수 열 중 하나가 누락되었거나 CSV 파일에 잘못된 레이블이 있는 헤더가 있습니다.	정확한 레이블이 있는 "대상자" 및 "들어오는 값" 열을 포함하도록 CSV 파일을 업데이트합니다.
파일에 "대상자" 및 "들어오는 값" 옆에 있는 열이 포함되어 있습니다.	매핑 CSV에는 대상자와 들어오는 값이라는 두 개의 열만 있어야 합니다.	대상자 및 들어오는 값 이외의 모든 열을 제거합니다.
파일에 레코드가 포함되어 있지 않습니다.	매핑 파일에 매핑 행이 없습니다.	파일에 매핑을 입력합니다.
파일에 "들어오는 값"이 동일한 여러 행이 포함되어 있습니다.	매핑 파일에 들어오는 값에 대해 동일한 값을 가진 행이 하나 이상 포함되어 있습니다.	중복된 행을 제거하거나 들어오는 값 열을 업데이트하여 중복된 행이 없도록 합니다.

이벤트

아래 표에는 이벤트 키 매핑에서 발생 가능한 오류가 나열되어 있습니다.

메시지	설명	해상도
하나 이상의 필수 열 헤더 "매핑 유형", "이벤트", "이벤트 시퀀스" 및 "들어오는 값"이 누락되었습니다.	매핑 CSV 파일에 필수 열 중 하나가 누락되었거나 CSV 파일에 잘못된 레이블이 있는 헤더가 있습니다.	정확한 레이블이 있는 "매핑 유형", "이벤트", "이벤트 시퀀스" 및 "들어오는 값" 열을 포함하도록 CSV 파일을 업데이트합니다.
파일에 "매핑 유형", "이벤트", "이벤트 시퀀스" 및 "들어오는 값" 옆에 있는 열이 포함되어 있습니다.	매핑 CSV에는 매핑 유형, 이벤트, 이벤트 시퀀스 및 들어오는 값이라는 네 개의 열만 있어야 합니다.	매핑 유형, 이벤트, 이벤트 시퀀스 및 들어오는 값 이외의 모든 열을 제거합니다.
파일에 잘못된 "매핑 유형" 값이 포함되어 있습니다. 값은 "External_ID" 또는 "Name"이어야 합니다.	매핑 유형 열에 잘못된 값이 포함되어 있습니다.	매핑 유형 열의 값을 업데이트하여 "Name" 또는 "External_ID"만 사용하도록 합니다.
파일에 혼합된 "매핑 유형" 값이 포함되어 있습니다. 값은 모두 "External_ID" 또는 "Name"이어야 합니다.	키 매핑 파일당 하나의 매핑 유형만 사용할 수 있습니다.	매핑 유형에 둘 다 사용하는 대신 External_ID 또는 Name만 사용하도록 매핑을 업데이트합니다.
파일에 잘못된 "이벤트 시퀀스" 값이 포함되어 있습니다. 값은 0보다 큰 정수여야 합니다.	이벤트 시퀀스 열에는 0보다 큰 정수가 필요합니다.	이벤트 시퀀스 열을 업데이트하여 0보다 큰 정수만 포함하도록 합니다.
파일에 레코드가 포함되어 있지 않습니다.	매핑 파일에 매핑 행이 없습니다.	파일에 매핑을 입력합니다.
파일에 "들어오는 값"이 동일한 여러 행이 포함되어 있습니다.	매핑 파일에 들어오는 값에 대해 동일한 값을 가진 행이 하나 이상 포함되어 있습니다.	중복된 행을 제거하거나 들어오는 값 열을 업데이트하여 중복된 행이 없도록 합니다.

매핑 파일 다운로드

현재 매핑 파일을 다운로드할 수 있습니다. 매핑 파일을 다운로드하는 방법은 다음과 같습니다.

가져오기(Import) > vpn_key 키 매핑(Key Mapping)으로 이동합니다.
목록에서 다운로드하려는 키 매핑(Key Mapping)을 찾습니다.
매핑(Mapping) 메뉴()에서 매핑 다운로드(Download Mapping)를 선택합니다.

매핑 삭제

매핑을 삭제할 수 있습니다. 매핑을 삭제하면 향후 패키지에서 해당 키를 사용하여 가져올 수 없습니다.

키 매핑을 삭제하는 방법은 다음과 같습니다.

가져오기(Import) > vpn_key 키 매핑(Key Mapping)으로 이동합니다.
목록에서 삭제하려는 키 매핑(Key Mapping)을 찾습니다.
매핑(Mapping) 메뉴()에서 매핑 삭제(Delete Mapping)를 선택합니다.
선택 사항: 확인 대화 상자에서 다시 표시 안 함(Do not show this again)을 선택하여 향후 삭제 시 확인이 필요하지 않도록 합니다.
확인을 클릭합니다.