设计库集合

21R1 及以后版本

从库中，库管员可以创建一种称为集合的新研究类型。通过集合，组织可以管理一组独立于其他研究的标准。研究设计者可以被授予对集合的查看访问权限，但他们没有编辑权限。

在研究创建期间，研究设计者现在可以从库集合或现有研究中复制。从库中复制时，Vault 不包含任何随机化配置。

集合使用部署进行版本控制，带注释的 PDF、SDS 和比较报告可用于集合，就像用于常规研究一样。

先决条件

默认情况下，具有 CDMS Librarian（CDMS 库管员）研究角色的用户可以执行下述操作。如果贵组织使用自定义研究角色，则你的角色必须授予以下权限：

类型	权限标签	控制
“标准”选项卡	库（Library）选项卡	能够访问库选项卡
功能权限	查看库	能够通过“工作室（Studio）”>“库（Library）”查看库集合及其设计
功能权限	设计库	能够通过“工作室”>“库”为集合创建研究设计定义和研究计划

如果您的“研究”包含受限数据，您必须具有“受限数据访问（Restricted Data Access）”权限才能查看该数据。

了解有关“研究角色”的更多信息。

访问集合

你可以从工作室中的库子选项卡访问集合。在顶部导航栏中，单击工作室，然后单击库。

如何创建集合

要创建新集合，请执行以下操作：

导航到工作室 > 库。
单击 + 新建集合（New Collection）。
输入集合的名称（Name）。
选择要与你的集合关联的组织（Organization）。你可以根据需要选择 + 新建组织（New Organization）来创建新的组织。
可选：输入外部 ID（External ID）。
可选：要以另一个研究的副本形式创建此研究：
1. 为复制研究设计（Copy Study Design）选择从另一项研究中（From Another Study）或从库中（From Library）。如果选择从另一项研究中，你可以选择要复制的研究，如果选择从库中，你可以选择要复制的集合。
2. 选择源 Vault（Source Vault）。
3. 选择源研究（Source Study）。
4. 选择研究环境（Study Environment）。
5. 可选：选中忽略导入病例手册版本（Ignore import casebook version）复选框以忽略源研究的版本并将副本导入为版本 1。请注意，如果你选择了模板类型的 Vault 作为源 Vault，则此选项不可用。
可选：选择要在其中创建环境的环境。这些环境是 Vault 或沙盒，你将在其中放置集合的用户验收测试、培训和生产环境。如果你在此处未选择 Vault，则 Vault 仅会创建一个开发环境，部署管理员可以稍后根据需要创建其他环境。
点击 Create（创建）。
在新建研究（New Study）确认对话框中，单击创建（Create）。Vault 会开始一项作业，为你选择的所有环境创建研究主程序、开发用的研究环境 和其他研究环境。根据你的选择，此作业可能需要几分钟时间。

库报告

你可以创建 Vault 级报告，其中显示定义、其密钥、定义的来源以及发生更改的版本。此报告的目标是让你能够识别哪些对象来自库中，以及这些对象在从库中复制后是否被更改。该报告使用一种 Vault 生成的 GUID（全局唯一标识符），即跨 Vault 唯一 ID（CVUID）来标识源版本 和发生更改的版本。

该报告包括表单、条目组、条目、代码列表、单位和规则。当定义对研究来说是新定义时，Vault 会通过从另一项研究中复制或手动创建来创建记录。当记录在该版本中发生更改时，Vault 会更新记录。如果定义是随着新版本创建的，但未更改，则它将反映新版本。

请注意，你只能在 DEV 环境中运行库报告。

在此版本中，报告不会将更改汇总到表单级别，因此，如果需要进一步的洞察来了解偏离，库可能需要利用研究的 SDS 来识别所有受影响的表单。

要创建库报告，请执行以下操作：

导航到工作室（Studio）> 库（Library）中的集合。
从操作（Actions）菜单中，选择库报告（Library Report）。
可选：选择创建为 CSV（Create as CSV） 而不是 Excel 以将库报告创建为 CSV 文件。如果未选择，则 Vault 会将报告创建为 Excel 文件（.xlsx）。如果定义历史记录 对象中的记录超过 800,000 条，则 Vault 会自动使用此格式。
点击 Create（创建）。
Vault 开始生成库报告。完成后，Vault 会发送一封电子邮件，其中包含下载报告的链接。
点击关闭（Close）。

报告列

库报告 在报告（Report）工作表中包含以下列：

列名称	描述	用途
定义研究名称（Definition Study Name）	对象的研究名称	确定哪个研究使用该对象。这可在查找特定研究时用作筛选器。
定义名称（Definition Name）	对象的名称	将库报告中的对象与差异报告、带注释的 PDF 或 SDS 中的对象进行匹配。
定义病例手册版本（Definition Casebook Version）	研究中对象的病例手册定义的版本	确定对象在其研究中的版本。在工作室、带注释的 PDF 或 SDS 中核对此值。
定义对象（Definition Object）	对象的类型（以此“对象”作为记录的对象）。可能的值包括： `event_group_def__v` `event_def__v` `form_def__v` `itemgroup_def__v` `item_def__v` `unit_def__v` `codelist_def__v` `codelist_item_def__v` `rule_def__v`	进行筛选以仅在报告中显示特定类型的对象。
定义 CDM 密钥（Definition CDM Key）	对象定义的 CDM 密钥。CDM 密钥是系统生成的 GUID，用于 ODM 导入（XML）。	在多个研究和集合中标识同一对象。
定义私钥（Definition Private Key）	对象定义的私钥。私钥是系统生成的 GUID，供 Vault 用于标识规则的对象。	在多个研究和集合中标识同一对象。
定义跨 Vault 唯一 ID	对象定义的跨 Vault 唯一 ID（CVUID）。CVUID 对研究和版本上下文中的对象进行唯一标识。它包含三（3）个部分：Vault ID、研究 ID 和对象 ID。多个版本中的同一对象将具有相同的 Vault 和研究 ID，但具有不同的对象 ID。	标识不同研究、集合和版本中的对象。你可以使用它来查找对象的来源，因为源密钥和发生更改的版本中都使用此键。
源研究名称（Origin Study Name）	对象的源跨 Vault 唯一 ID。如果此列与定义研究名称相同，则此对象源自当前研究或集合。	标识对象的原始研究或集合。将此列与发生更改的版本和操作列一起使用，以检查何时与原始对象存在偏差。
源研究类型（Origin Study Type）	对象源自的研究的类型。可能的值包括 `Study` 和 `Collection`。如果对象是从尚未转换为集合的库研究中复制的，则返回 `study`。	筛选或汇总研究中的新对象以及从集合中复制的对象。在数据透视表中用于按源研究类型汇总对象。
源密钥（Origin Key）	这是原始对象源的 CVUID。如果“源密钥”和“定义跨 Vault 唯一 ID”相同，则这是第一次创建此对象。如果这些源密钥和定义 CVUID 不同，则此对象并非源自该研究或集合，可以通过在定义 CVUID 中查找此源密钥来找到原始对象。	通过查找定义跨 Vault 唯一 ID 来识别原始对象。通过差异报告或在工作室或 SDS 中手动检查对象来检查源和目标之间的差异。
发生更改的版本（Changed In Version）	此列包含一个 CVUID，将与对象发生更改时的“定义跨 Vault 唯一 ID”相对应。如果在 v2 的对象中发生更改，则此列将包含该 v2 版本的定义 CVUID。此列将在版本之间和复制时复制，以便用户可以追溯随时间推移的更改。	使用“发生更改的版本”来追溯每个版本的更改（通过匹配“定义跨 Vault 唯一 ID”），从而识别随时间推移的更改。或者通过“已更新”操作以按更改汇总或筛选对象。
操作	此项列出了对记录发生的操作，它们决定了记录的创建或更改方式。可能的值包括：已创建：对象已作为新对象、ODM 导入或通过研究副本创建已删除（Deleted）：对象已从研究中删除。对象已复制（复制）（Object Copied (Copy)）：对象是通过对象复制功能创建的，并且选中了“发生冲突时创建副本（Create a Copy on Conflict）”选项。已复制对象（对象）（Object Copied (Object)）：对象的创建方式是通过“属性（Properties）”面板进行复制。对象已复制（重复使用）（Object Copied (Reuse)）：对象是通过对象复制功能创建的，并且选中了“发生冲突时使用现有对象（Use Existing Object on Conflict）”选项。已复制对象（更新）（Object Copied (Update)）：对象是通过对象复制功能更新或创建的，并且选中了“重复使用和更新”（Reuse and Update）选项。已更新（Updated）：对象已修改。版本已创建（Version Created）：对象在版本控制后被修改。	了解与库存在偏差的地方。识别对象是如何进入研究的以排查问题。
上次修改日期	这是最后一个人或流程创建或修改记录的日期。	按日期筛选所做的更改。
上次修改者	这是创建或修改该记录的最后一个人或流程的名称。	标识更改了记录的用户或流程。

21R1 之前研究的文库报告

Vault 不会为现有研究创建沿袭记录。这些记录只能从发布点开始创建。如有需要，组织可以与 Veeva 服务合作，为现有研究撒播库沿袭记录，但这只有在将现有研究转换为库集合时才能实现。对于这些撒播的记录，Vault 会为已转换研究的每个版本创建一个更改。在撒播期间，用户将无法在集合中创建或编辑定义。