配置 RIM 和 PromoMats Vault 的连接

同时使用 RIM Submissions Vault 和 PromoMats Vault 的组织可利用 Spark Messaging 框架来创建标准的 Vault 至 Vault 连接。此连接跨多个 Vault 传输申请、提交和合规数据包信息，并自动创建和更新交叉链接文档。

RIM 和 PromoMats Vault 的连接组件

下列组件支持标准 Vault 至 Vault RIM 和 PromoMats 连接。

连接

以下连接记录可从管理 > 连接访问。

• 在您的 PromoMats Vault 中可实现 RIM 至 PromoMats 的连接 (promomats_to_rim__v)
• 在您的 RIM Submissions Vault 中可实现 RIM 至 PromoMats 连接 (rim_to_promomats_connection__v)

使用该连接之前，您仍需建立 Vault 至 Vault 的连接。

集成与集成点

集成和集成点对象可让 Vault 管理消息队列并定义连接从一个 Vault 中将哪些文档和数据映射到其他 Vault。这些记录均为只读记录，Vault 用来管理连接和跟踪任何连接错误。

RIM 至 PromoMats 连接记录包括以下默认集成记录以及您的 Submissions Vault 中的标准集成点记录：

RIM 至 PromoMats 的连接记录包括以下默认集成记录以及您的 PromoMats Vault 中的标准集成点记录：

集成规则

为了支持 RIM 和 PromoMats 的连接，可能需要转换源 Vault 数据模型的数据以适应目标 Vault 的数据模型。您可使用 Spark 集成规则以纳入用于在两个 Vault 间映射对象和文档字段的可配置规则。

查询对象规则

该连接还支持以下 RIM 集成规则的查询对象规则：

• 宣传联系人 (promotional_contact__v)
• 合规性数据包 (compliance_package__v)
• 合规性数据包文档 (compliance_package_documents__v)

队列

该功能包括四 (4) 个标准消息处理队列：两 (2) 个在您的 RIM Vault 中，另外两 (2) 个在您的 PromoMats Vault 中。您可通过路径管理 > 连接 > Spark 队列来访问和管理这些队列。

您的 RIM Vault 中有：

• PromoMats 至 RIM 入站队列 (promomats_to_rim_inbound_queue__v)
• RIM 至 PromoMats 出站队列 (rim_to_promomats_outbound_queue__v)

在您的 PromoMats Vault 中，您拥有：

• RIM 至 PromoMats 入站队列 (rim_to_promomats_inbound_queue__v)
• PromoMats 至 RIM 出站队列 (promomats_to_rim_outbound_queue__v)

用户异常对象

Vault 包含用户异常消息对象及其子级对象和用户异常项，以帮助您追踪和解决 RIM 和 PromoMats Vault 的连接中发生的任何错误。如果集成的某个终端无法处理接收的消息，Vault 将创建用户异常消息记录以收集失败数据。Vault 还将为入站 Vault 中相关集成点记录中的各个失败项目创建单独的用户异常项记录。

您可以在管理 > 连接 > 用户异常信息中查看和管理这些信息。如果您希望特定用户或组在 Vault 创建用户异常消息记录时收到通知，您必须为用户异常消息创建自定义生命周期并配置通知入口操作。

用户异常消息表示您需要更新您的配置。您更新配置以后，Vault 将在下一次连接运行时尝试解决任何错误。您还可选择重新运行集成操作来运行连接并解决错误。

标准文档类型组

以下文档类型组记录可用于支持此连接：

• 在您的 PromoMats Vault 中可实现 RIM 至 PromoMats 的连接
• 在您的 RIM Vault 中可实现 RIM 至 PromoMats 连接

Vault 使用此类文档类型组确定从一个 Vault 向其他 Vault 发送哪些文档类型。当组内某个文档进入稳定状态时，Vault 将发送 Spark 消息以在连接 vault 中创建交叉链接文档并更新文档字段，以体现源 vault 中对文档进行的更改。您还必须配置文档类型引用查询，以便将源 Vault 中的文档类型映射到目标 Vault 中的文档类型，以使 Vault 能够传输文档。默认情况下，这些文档类型组处于非活动状态下。

实际提交日期

将合规数据包成功提交至网关后，您需要将实际提交日期添加至 Submissions Vault 中合规数据包的申请记录中。该值会自动添加至提交记录和 eCTD 活页夹以及 PromoMats 中的相应文档中。填充实际提交日期字段后，Vault 会将 eCTD 活页夹切换至已提交稳定状态。

配置您的 Vault 以实现连接

您必须在 Submissions Vault 中完成以下步骤才能启用标准连接：

1. 在两个 Vault 中启用交叉链接。参见下文关于该操作的详细信息。
2. 为集成范围内的受控字段定义引用查找并将其加载至您的 Vault 中。请参阅下方的配置引用查找相关详细信息。
3. 查看每个字段规则。请参阅下方的该步骤相关详细信息。
4. 生成缺失的全局 ID。请参阅下方的该步骤相关详细信息。
5. 查看最近成功运行字段。
6. 查看申请人和申请记录。请参阅下方的该步骤相关详细信息。

正在启用交叉链接

交叉链接文档可实现从 Vault 中使用相同域内其他 Vault 中的内容。为了实现连接以便横跨 RIM 和 PromoMats Vault 创建文档，您需要在两个 Vault 中启用交叉链接。您还需要启用排除源文档叠加图和排除源文档签名页设置。

配置引用查询

引用查询是由集成规则引用的配置组件，可让您将源 Vault 中的字段值间接映射至目标对象或文档。当您配置 RIM 和 PromoMats 的连接时，您需要为集成范围内的受控字段添加引用查找。我们建议创建 CSV 映射文件并将其加载至您的 Vault 中，以创建引用查询。

例如，为使 Vault 从一个 Vault 向其他 Vault 传输文档，您需要创建文档类型引用，以将源文档类型映射至目标文档类型。参见关于创建和管理 SDK 引用查询的详细说明。

查看字段规则

您必须查看针对 RIM 和 PromoMats 连接器的每个集成规则的字段规则。若要如此，请导航至管理 > 连接 > 集成规则，选择一个集成规则，然后单击字段规则。

确保：

• 目标对象或文档上的每个必填字段都存在字段规则
• 所有集成规则相关字段默认值均使用 RIM UUID 值

如果标签 > 标签-美国文档类型上的标签类别字段为必填项，您需要将以下字段规则添加至 PromoMats 合规数据包文档 (compliance_package_documents__v) 集成规则中：

• 目标对象：文档
• 目标文档字段：标签类别
• 标签：标签类别
• 名称：标签类别

您可根据需要设置字段默认值。

生成全局 ID

RIM 和 PromoMats 的连接依赖全局 ID 来填充目标 Vault 中的链接字段。如果最后一次更新记录的时间在 19R3 版本发布之前，则全局 ID 字段可能不会得到填充。如果有个记录缺少全局 ID，请联系 Veeva 支持团队，并请求他们基于您的 RIM Vault 中的申请和组织对象以及您的 PromoMats Vault 中的联系人对象生成全局 ID 值。

为避免重复记录，您必须确保现有记录上的链接字段是使用源 Vault 的全局 ID 填充的。在您的 RIM Vault 中，联系人对象是作为集成的一部分创建的。必须根据需要审查和更新任何现有的宣传标签和广告联系人。

如要更新现有记录：

1. 在您的 PromoMats Vault 中，导航至联系人的相关记录。
2. 备份全局 ID 值。您可能首先需要编辑对象页面布局。
3. 在您的 RIM Vault 中，导航至联系人。
4. 单击编辑并在链接字段中输入全局 ID。
5. 单击保存。
6. 针对两个 Vault 中存在的所有联系人重复步骤 1-5。
7. 在您的 RIM Vault 中，导航至申请和申请人或组织的相关记录。
8. 备份全局 ID 值。您可能首先需要编辑对象页面布局。
9. 在您的 PromoMats Vault 中，导航至联系人。
10. 单击编辑并在链接字段中输入全局 ID。
11. 单击保存。

上次成功运行字段

在每个入站集成记录上，上次成功运行字段存储上次无错误运行集成的日期和时间。Vault 将使用该日期查询自集成上次成功运行以来的变更。

您可通过以下方式使用上次成功运行字段：

• 如果您不希望 Vault 传输已有对象记录或已有稳定状态文档作为交叉链接文档，您可将该字段设置为您要激活连接的日期和时间。
• 如果您需要重新运行集成记录中的每个集成点，您可清空上次成功运行字段。某个 Vault 中的操作下次启用连接时，Vault 将再次处理该集成点范围内的全部文档或对象记录。

激活 RIM 至 PromoMats Vault 的连接时，将每个处于活动状态的集成上的上次成功运行字段设置为您希望传输开始的日期和时间。如果您未在上次成功运行字段中设置值，Vault 将传输所有相关记录和文档。

审查申请人和申请记录

作为配置过程的一部分，您必须更新 PromoMats Vault 中的申请人和申请记录。当使用 RIM 和 PromoMats 的连接向 FDA 提交您的合规数据包时，Vault 必须使用由该连接链接的申请人和申请记录。如果您的 PromoMats 和 RIM Vault 中存在相匹配的申请人或申请记录（以往创建的记录），您必须根据 RIM 中的记录备份全局 ID，并将其添加至 PromoMats 中的链接字段中。此操作可确保两个 Vault 中的记录匹配。如果您的 PromoMats Vault 中的任何申请人或申请记录在您的 RIM Vault 中并无匹配记录，则您必须避免将这些记录纳入连接使用的合规数据包中。

接下来，您必须确认所有预先存在且处于任何非稳定或过期状态的 eCTD 活页夹是否如上所述包含链接至您的 RIM Vault 的申请人和申请记录。如果您的活页夹处于提交就绪状态，请更新活页夹并将其切换至修订并重新提交状态。然后，更新申请人和申请记录并将其切换至提交就绪状态。

配置 RIM 以实现连接

您必须在 RIM Vault 中完成以下步骤才能启用标准连接：

1. 验证将文档与 EDL 项目匹配作业是否处于活动状态。
2. 可选操作：确保已配置内容计划。仅当您计划将内容计划作为提交过程的一部分使用时方需配置这些计划。
3. 确保存在用于受控词汇表的 Vault RIM UUID。参见下文关于该操作的详细信息。
4. 导航到管理 > 配置 > 对象 > 送审 > 对象类型。将相关合规数据包 ID 字段添加至列出的每个对象类型中。
5. 导航至管理 > 配置 > 对象 > 内容计划 > 对象类型。将匹配文档字段添加至每个对象类型中。
6. 编辑宣传材料文档类型和字段。请参阅下方的该步骤相关详细信息。
7. 将主要版本号字段更新为可编辑。参见下文关于该操作的详细信息。
8. 更新内容计划和内容计划项对象生命周期。请参阅下方的该步骤相关详细信息。
9. 修改内容计划模板约束。请参阅下方的该步骤相关详细信息。
10. 可选操作：更新材料 ID 字段。请参阅下方的该步骤相关详细信息。

用于受控词汇表的 Vault RIM UUID

Veeva 为许多受控词汇表提供标准值。为了识别这些值，Vault 为 Veeva 提供的每个受控词汇表记录分配一个 RIM UUID 值。RIM 至 PromoMats 的连接要求正确配置 Vault RIM UUID 值。如果您没有用于受控词汇表记录的 Vault RIM UUID 值，请联系支持团队。

编辑宣传材料文档类型和字段

文档类型必须与内容计划模板相对齐，以确保文档均仅匹配一次。如要让文档类型与内容计划模板相对齐，您必须按如下方式配置文档类型：

1. 将宣传材料文档类型字段添加至法规 > 宣传材料文档类型。
2. 在法规 > 宣传材料文档类型下添加附注标签类型。
3. 在法规 > 宣传材料文档类型下添加附注材料类型。
4. 在法规 > 宣传材料文档类型下添加附注引用类型。
5. 在法规 > 宣传材料文档类型下添加清洁材料。

编辑主要版本文档字段

主要版本文档字段必须可编辑，以确保 RIM 至 PromoMats Vault 的连接正常工作。如要确保该字段可编辑，请导航至管理 > 配置 > 文档字段 > 基础文档 > 主要版本号 > 安全覆盖。单击编辑，选择申请所有者和可编辑，然后单击保存。将主要版本号字段调整为可编辑的同时，还会更新次要版本号字段。

更新对象生命周期

作为连接配置的一部分，您需要将基线化状态类型添加至内容计划和内容计划项对象生命周期。如要添加状态类型，请导航至管理 > 配置 > 对象生命周期 > 内容计划生命周期，然后在状态类型下单击创建。将基线化选作状态类型和状态，然后单击保存。使用内容计划项生命周期重复此过程。

修改内容计划模板约束

作为配置的一部分，您必须查看任何宣传材料提交用内容计划模板约束。使用连接时，匹配文档后，所有无匹配文档的内容计划项和节段均处于非活动状态。Vault 不会激活这些项目。

更新材料 ID 字段

如果您已在 PromoMats Vault 中配置材料 ID 字段并希望在整个连接中使用该字段，则需要更新 RIM Vault 中的字段。联系 Veeva 支持团队以通过 MDL 更新 RIM 中的材料 ID 字段。

配置 PromoMats 以实现连接

您必须在 PromoMats Vault 中完成以下步骤，才能启用标准连接：

1. 启用 eCTD 合规数据包生成。请参阅配置 eCTD 合规数据包。
2. 更新必要的文档字段。请参阅下方的该步骤相关详细信息。
3. 添加 RIM 至 PromoMats 的连接文档类型组。请参阅下方的该步骤相关详细信息。
4. 更新提交就绪生命周期。请参阅下方的该步骤相关详细信息。
5. 删除提交就绪工作流中的最后提交步骤。

更新文档字段

作为配置的一部分，您必须将文档字段添加至多种文档类型：

1. 导航到管理 > 配置 > 文档字段。
2. 单击卫生当局表单。
3. 添加以下字段：
   • 主要提交
   • 实际提交日期
   • 提交注释
4. 单击 eCTD 提交就绪文档。
5. 添加步骤 3 中的字段。
6. 单击 eCTD 提交就绪文档 > 提交就绪备份 > 附注标签。
7. 添加以下字段：
   • 材料类型
   • 专业人士/读者
   • 宣传材料文档类型
   • 宣传材料文档编号
8. 单击附注引用并添加步骤 7 中的字段。
9. 单击附注材料并添加步骤 7 中的字段。
10. 单击清洁材料并添加步骤 7 中的字段。

如果您计划将任何其他文档类型纳入活页夹，则必须往这些文档类型中额外添加字段。

添加文档类型组

您必须将 RIM 至 PromoMats 的连接文档类型组添加到 eCTD 提交就绪文档和卫生局表单文档类型中。如果您计划将任何其他文档类型包含到活页夹中，则还必须将 RIM 至 PromoMats 的连接文档类型组添加到这些类型中。

更新提交就绪生命周期

作为配置过程的一部分，您必须更新提交就绪生命周期：

1. 导航至管理 > 配置 > 文档生命周期。
2. 选择提交就绪生命周期。
3. 单击状态选项卡，然后单击提交就绪。
4. 单击入口操作，然后单击编辑。
5. 选择执行（有条件）。
6. 添加以下入口操作：如果活页夹等于“是”，则触发“发送卫生当局就绪状态”。
7. 单击保存。

连接限制

请参阅标准 Vault 至 Vault 连接限制以获得影响 RIM 和 PromoMats 连接的限制列表。

相关权限

您需要系统管理员安全配置文件及以下权限，以设置标准 RIM 和 PromoMats 连接：