CDB 배포 관리

임상 프로그래머는 임상 시험 기간 동안 데이터 매니저를 위해 목록, 검사 및 보기를 지속적으로 업데이트합니다. CDB의 배포 기능을 사용하면 조직은 검토, 승인 및 배포를 통해 해당 변경 사항을 추적할 수 있습니다.

승인된 사용자 정의 목록, 검사 및 보기를 TST 환경에서 프로덕션 환경으로 배포할 수 있습니다. TST 환경에서 각 개체를 검토하고 승인됨으로 표시하여 배포 준비가 완료된 것으로 식별할 수 있습니다. 각 개체에는 다운로드 가능한 승인 로그가 있으며, 이 승인 로그는 승인 워크플로를 통해 해당 개체의 진행 상황을 추적합니다. 개체가 승인되면 배포 패키지에 추가하여 프로덕션에 배포하고 TST에서 프로덕션으로 배포할 수 있습니다.

사전 구성 요소

기능 활성화

21R3 릴리스(2021년 12월) 이전에 생성된 스터디의 경우 CDB 워크벤치의 TST 환경에서 해당 기능을 활성화해야 합니다. 세부 사항은 아래에서 참조하십시오.

21R3 릴리스 이후에 생성된 스터디의 경우 이 기능은 자동으로 활성화됩니다.

TST 환경에 대한 스터디 목록의 배포 활성화됨(Deploy Enabled) 열에서 스터디에 대해 해당 기능이 활성화되어 있는지 확인할 수 있습니다. 워크벤치에 활성화됨(Enabled) 아이콘(rocket_launch)이 표시되면 기능이 활성화된 것입니다.

필요한 권한

표준 CDMS Super User(CDMS 슈퍼 사용자) 스터디 역할을 보유한 사용자는 기본적으로 아래 설명된 작업을 수행할 수 있습니다. 표준 CDMS Lead Data Manager(CDMS 책임 데이터 매니저) 및 CDMS Data Manager(CDMS 데이터 매니저) 역할을 보유한 사용자는 아래에 설명된 승인 워크플로 기능을 수행할 수 있습니다. 조직에서 사용자 정의 스터디 역할을 사용하는 경우, 역할에서 다음 권한을 부여해야 합니다.

유형(Type) 권한 레이블 컨트롤
표준 탭 워크벤치(Workbench) 탭

워크벤치 탭을 통해 데이터 워크벤치 애플리케이션에 액세스하고 이를 사용할 수 있는 권한
기능적 권한 배포 관리

EDC 툴에서 스터디 환경을 생성 및 관리하고 스터디를 배포, 툴(Tools) > 시스템 툴(System Tools)에서 Vault 수준 구성을 관리하고 배포, CDB에서 목록, 확인 및 보기를 관리하고 배포할 수 있는 기능
기능적 권한

21R3 및 이전 릴리스 배포 활성화&

21R3 릴리스(2021년 12월) 이전에 스터디가 생성된 경우 스터디에 대한 배포 기능을 활성화해야 합니다. 21R3 릴리스 이후에 스터디가 생성된 경우 이 기능은 스터디에 대해 자동으로 활성화됩니다.

워크벤치에는 스터디(Study) 목록에 배포 활성화됨(Deployment Enabled) 열이 포함되어 있습니다. 이 열에 배포(Deployment) 아이콘(rocket_launch)이 표시되면 스터디에서 기능이 활성화된 것입니다. 워크벤치는 TST 환경에 대해서만 해당 열을 표시합니다.

스터디의 TST 환경이 포함된 워크벤치 인스턴스에서 이 기능을 활성화합니다.

  1. 스터디의 TST 환경이 포함된 Vault에 로그인합니다.
  2. 워크벤치(Workbench) 탭을 클릭하여 CDB 애플리케이션을 엽니다.
  3. 스터디(Studies) 페이지의 목록에서 스터디를 찾습니다.
  4. 스터디(Study) 위로 마우스를 가져가면 스터디(Study) 메뉴()가 표시됩니다.
  5. 스터디(Study) 메뉴에서 배포(Deployment)를 선택합니다. 그러면 배포 활성화(Enable Deployment) 페이지가 열립니다.
  6. 계속을 클릭합니다.
  7. 목록 및 보기의 마스터 세트로 사용할 스터디 인스턴스(Study Instance)(환경)를 선택합니다. 워크벤치는 스터디의 모든 TST 환경에서 해당 목록 및 보기를 생성하여 선택한 마스터 세트에 없는 목록 또는 보기를 제거합니다.
  8. 활성화(Enable)를 클릭합니다.

배포 액세스

스터디(Study)를 선택한 후 탐색 창(Navigation Drawer)()에서 배포(Deployment) 영역으로 이동하거나 스터디(Studies) 페이지의 스터디(Study) 메뉴()에서 이동할 수 있습니다.

배포(Deployment) 탭에는 세 개의 하위 탭이 있습니다.

  • 승인된 목록(Approved Listings): 이 하위 탭에는 승인됨 상태의 모든 목록 및 검사가 나열됩니다.
  • 계층 승인된 보기(Approved Views): 이 하위 탭에는 승인됨 상태의 모든 보기가 나열됩니다.
  • watch_later 패키지(Packages): 이 하위 탭에는 배포된 패키지가 나열됩니다.

승인 상태

승인됨 상태에 있는 목록과 보기만 배포할 수 있습니다. 다음과 같은 세 가지 승인 상태가 있습니다.

상태(Status) 선택 배지
초안 목록, 검사 또는 보기가 아직 승인되지 않았습니다. 새 목록 또는 보기의 시작 상태입니다.
승인 준비 완료 이 목록, 검사 또는 보기는 검토되었으며 승인할 준비가 되었습니다.
승인됨 이 목록, 검사 또는 보기는 승인되었으며 배포할 준비가 되었습니다.

초안 상태로 돌아가기: 사용자가 목록, 검사 또는 보기에 대한 변경 사항을 저장하면 워크벤치는 이를 초안 상태로 되돌립니다. 목록, 검사 또는 보기가 배포된 경우 초안 상태로 되돌릴 수 있는 유일한 방법은 변경 사항을 저장하는 것입니다.

승인 워크플로

배포하려면 해당 개체가 승인됨 상태여야 합니다. 개체는 초안 상태에서 시작되며, 사용자는 상태(Status) 메뉴에서 개체를 승인 준비 완료 및 승인됨 상태로 이동할 수 있습니다. 개체를 다른 상태에서 원하는 상태로 이동할 수 있습니다. 현재 릴리스에는 강제로 적용되는 상태 순서가 없습니다. 권장되는 워크플로는 개발이 완료되면 개체를 초안에서 승인 준비 완료로 이동한 다음, 검토가 완료되고 배포할 준비가 되면 승인 준비 완료에서 승인됨으로 이동하는 것입니다.

초안에서 승인 준비 완료로 개체를 이동하는 방법은 다음과 같습니다.

  1. 승인 준비 완료 상태로 이동하는 목록(Listing), 검사(Check) 또는 보기(View)로 이동합니다.
  2. 상태(Status) 메뉴에서 승인 준비 완료(Ready for Approval)를 선택합니다.
  3. 선택 사항: 이유(Reason)를 입력합니다.
  4. 저장을 클릭합니다.

승인 준비 완료에서 승인됨으로 개체를 이동하는 방법은 다음과 같습니다.

  1. 승인됨 상태로 이동하려는 목록(Listing), 검사(Check) 또는 보기(View)로 이동합니다.
  2. 상태(Status) 메뉴에서 승인됨(Approved)을 선택합니다.
  3. 선택 사항: 이유(Reason)를 입력합니다.
  4. 저장을 클릭합니다.

승인됨에서 초안으로 개체를 이동하는 방법은 다음과 같습니다.

  1. 초안 상태로 되돌리려는 목록(Listing), 검사(Check) 또는 보기(View)로 이동합니다.
  2. 상태(Status) 메뉴에서 초안(Draft)을 선택합니다.
  3. 선택 사항: 이유(Reason)를 입력합니다.
  4. 저장을 클릭합니다.

승인 로그

워크벤치는 목록 또는 보기의 승인 상태에 대한 변경 로그를 유지합니다. 이 로그는 목록, 검사 또는 보기에서 CSV로 다운로드할 수 있습니다. CSV 파일 이름은 "승인 로그 <스터디> <목록/검사/보기 제목> <생성 날짜/시간>.csv"입니다.

승인 로그를 다운로드하는 방법은 다음과 같습니다.

  1. 승인 로그를 다운로드하려는 목록(Listing), 검사(Check) 또는 보기(View)로 이동합니다.
  2. 목록(Listing), 검사(Check) 또는 보기(View) 메뉴()에서 승인 로그(Approval Logs)를 선택합니다.
  3. 워크벤치에서 CSV 파일을 생성합니다. 해당 파일을 다운로드하여 선택한 CSV 뷰어에서 검토합니다.

승인 로그에는 각 상태 변경에 대한 다음 정보가 포함됩니다.

열 선택
Vault ID 목록 또는 보기가 포함된 Vault의 Vault ID
스터디 이름 스터디의 이름
개체 ID 목록 또는 보기의 고유한 개체 ID
유형(Type) 개체의 유형:
  • LISTING
  • CHECK
  • VIEW
원본(Source) 개체와 연결된 원본
개체 이름 개체의 제목 속성 값
개체 짧은 이름 개체의 짧은 제목 속성 값
범주(Category) 개체의 범주 속성 값
선택 개체의 설명 속성 값
목표(Objective) 개체의 목표 속성 값
CQL 구문 개체에 대한 CQL 문
생성자(Created By) 개체를 생성한 사용자의 이름
생성 날짜(Created On) 개체가 원래 생성된 날짜 및 시간
최종 수정인 개체를 마지막으로 수정한 사용자의 이름
최종 수정 날짜 개체가 마지막으로 수정된 날짜 및 시간
마지막 수정 위치 개체가 마지막으로 수정된 스터디 인스턴스(환경)의 이름
현재 상태 이 변경의 일부로 개체가 이동된 상태:
  • DRAFT
  • READY_FOR_APPROVAL
  • APPROVED
전환자 상태를 변경한 사용자의 이름
전환 날짜 상태 변경이 발생한 날짜 및 시간
전환 코멘트 상태 변경에 대해 제공된 이유

승인 로그 보기: 승인 로그에는 목록, 검사 또는 보기에 대한 CQL 문이 포함된 CQL 구문 열이 포함되어 있습니다. Microsoft Excel™의 열 문자 제한은 32,767자입니다. CQL 문이 32,767자보다 길면 Excel™에서 값을 자릅니다. Veeva는 해당 문자 제한이 없는 뷰어에서 승인 로그 CSV를 볼 것을 권장합니다.

배포하는 방법

목록/검사와 보기를 별도의 패키지에 배포합니다. 승인됨 상태의 목록/검사 또는 보기가 하나 이상 있으면 보기/검사 또는 보기의 배포 패키지를 생성하고 프로덕션에 배포할 수 있습니다.

배포 실패: 배포에 실패하는 경우 Veeva 서비스에 문의하여 문제 해결에 도움을 받으십시오.

목록 및 검사&

목록 및 검사를 배포하는 방법은 다음과 같습니다.

  1. 스터디의 배포(Deployments) 탭으로 이동합니다.
  2. 승인된 목록(Approved Listings) 하위 탭에서 배포하려는 목록(Listings) 및 검사(Checks)를 선택합니다.
  3. 선택 사항: 현재 페이지의 모든 목록 및 검사를 선택하려면 모두 선택(Select All) 확인란을 선택합니다(최대 25개).
  4. 배포(Deploy) rocket_launch를 클릭합니다.
  5. 선택 사항: 이유(Reason)를 입력합니다.
  6. 확인 대화 상자에서 배포(Deploy)를 클릭합니다.
  7. 워크벤치가 배포 작업을 시작합니다. 배포(Deployment) > watch_later 패키지(Packages)에서 진행 상황을 확인할 수 있습니다.

이름, 범주 및 원본 변경&: CDB는 이름, 범주 및 원본을 사용하여 고유한 목록을 식별합니다. 이름, 범주 또는 원본이 변경되어 목록이 업데이트되면 CDB는 배포 시 해당 목록을 새 목록으로 간주하므로 프로덕션에서 이전 버전을 삭제해야 합니다.

보기

보기를 배포하는 방법은 다음과 같습니다.

  1. 스터디의 배포(Deployments) 탭으로 이동합니다.
  2. 승인된 보기(Approved Views) 계층 하위 탭에서 배포하려는 보기(Views)를 선택합니다.
  3. 선택 사항: 현재 페이지의 모든 보기를 선택하려면 모두 선택(Select All) 확인란을 선택합니다(최대 25개).
  4. 배포(Deploy) rocket_launch를 클릭합니다.
  5. 선택 사항: 이유(Reason)를 입력합니다.
  6. 확인 대화 상자에서 배포(Deploy)를 클릭합니다.
  7. 워크벤치가 배포 작업을 시작합니다. 배포(Deployment) > watch_later 패키지(Packages)에서 진행 상황을 확인할 수 있습니다.

배포 패키지 및 로그&

배포(Deployment) > watch_later 패키지(Packages)에서 모든 배포 패키지 및 관련 배포 로그를 검토할 수 있습니다.

워크벤치에서는 각 배포 패키지에 대해 다음 정보를 표시합니다.

열 선택
이름 배포 패키지 의 이름(현재 릴리스에서는 항상 "Deploy"임) 및 배포가 발생한 날짜 및 시간.
실행자 배포를 시작한 사용자의 이름과 배포를 시작한 날짜 및 시간. 이 값 위로 마우스를 가져가면 배포에 대해 제공된 이유(제공된 경우)를 표시할 수 있습니다.
현재 상태 배포 작업 상태와 이 배포 패키지에 포함된 목록 또는 보기 수

배포 상태

배포 작업은 다음 상태를 거쳐 이동합니다.

상태(Status) 선택 표시
대기열에 포함 배포가 현재 작업 대기열에 있습니다. 다른 작업이 완료되면 워크벤치에서 해당 배포를 시작합니다.
진행 중 배포가 현재 진행 중입니다.
배포됨 배포에 성공했습니다.
오류(Error) 배포 작업에 실패했습니다. Veeva 서비스 담당자에게 문의하여 도움을 받으십시오.

배포 패키지 다운로드

배포 패키지를 다운로드하는 방법은 다음과 같습니다.

  1. 스터디에 대한 배포(Deployment) > watch_later 패키지(Packages)로 이동합니다.
  2. 목록에서 다운로드하려는 배포 패키지를 찾습니다.
  3. 패키지의 패키지(Package) 메뉴에서 패키지 다운로드(Download Package)를 선택합니다.
  4. 워크벤치에서 패키지에 대한 ZIP 파일을 생성합니다. 완료되면 워크벤치의 화면 맨 아래쪽에 토스트 알림이 표시됩니다. 을 클릭하여 다운로드합니다.

배포 모범 사례

배포 모범 사례는 다음과 같습니다.

  • 스터디에서 배포를 활성화하기 전에 각 TST 인스턴스에 대한 개체 요약 로그를 다운로드합니다. 이렇게 하면 실수로 잘못된 TST 인스턴스를 마스터로 선택할 경우에 대비해서 해당 개체에 대한 레코드를 갖게 됩니다.
  • 배포하기 직전에 프로덕션 환경에서 개체 요약 로그를 다운로드합니다.
  • 검토 목록에 대한 CQL을 변경하면 모든 검토 진행 상황이 지워집니다. 따라서 검토 목록에 변경 사항을 배포할 때 프로덕션 환경에서 목록의 CSV를 다운로드합니다.