创建和管理连接

使用连接对象，您可以在本地、Vault 之间或使用外部应用程序创建集成。如果希望发送 Spark 消息，您还必须将此连接附加到一个队列中。

访问连接管理

从管理 > 连接中查看和管理连接。您必须拥有一个能够授予应用程序：管理连接权限的安全配置文件，才能访问此标签页。

如何创建连接对象

要创建新的连接：

  1. 从连接页面中，单击创建。
  2. 选择一个连接类型（Vault 到 Vault、外部或本地）。
  3. 为此连接输入一个名称。
  4. 为此连接输入一个 API 名称。只允许使用小写字母、字母数字字符和字符之间的下划线 (_)。
  5. 执行此操作之后，字段将因连接类型而异。请参阅以下连接类型的每个相应节段。

Vault 到 Vault 连接

只有名称和 API 名称是必填字段。此连接类型的所有其余字段都是可选的。

  1. 输入一个远程 Vault ID。此 ID 是您要与其交换消息的 Vault 的 ID。如果此字段具有一个值，则只有此 Vault ID 能够上传连接文件，而且无需使用任何批准工作流。如果忽略此字段，批准工作流将在上传此连接时开始。
  2. 为此连接输入一个描述。
  3. 选择一个已授权的连接用户。如果远程 Vault 需要访问此 Vault 中的信息，它将通过此用户执行这一操作。
  4. 在远程 Vault 详细信息下方，您可以输入有关远程 Vault 的信息。与描述字段类似，这些字段也只供您个人参考。建立连接之后，这些字段中会自动填充相关信息。
  5. 单击保存。此连接记录现在处于待处理状态。要使此连接进入活动状态，您需要建立此连接。

外部连接

当配置要从 Vault 检索数据的外部连接时，建议使用连接授权和已授权的连接用户选项。

如果您的 Vault 配置了 Vault 令牌和自定义令牌，您可以在 URL 中使用它们。在 Vault 开发人员门户中了解更多信息。

连接授权将存储外部系统的用户名和密码，并且可以在消息标题中发送，以便在外部系统上进行身份验证。必须在外部系统上处理用户名和密码，并在外部系统上进行身份验证。

已授权的连接用户可用于生成一个 SessionID，可以将此 ID 发送到外部系统并用于后续 API 回调，以便从 Vault 检索数据。建议生成 SessionID，并在消息中发送此 ID。

  1. 为此外部连接输入一个 URL。此 URL 必须采用一种包含 https:// 的有效 HTTPS 格式。只允许使用标准 HTTPS 端口，例如不允许使用 https://veeva.com:8443。
  2. 可选：为此外部连接选择一个授权记录。如果外部连接需要访问此 Vault 中的数据，它将通过此连接授权记录执行这一操作。如果不存在此记录，您可以创建一个。
  3. 可选：为此连接输入一个描述。
  4. 可选：为此连接添加一个已授权的连接用户。如果外部应用程序需要访问此 Vault 中的信息，它将通过此用户执行这一操作。如果未设置此用户，外部应用程序将无法为您的 Vault 创建会话令牌。
  5. 单击保存。创建的连接记录处于活动状态，而且可以立即使用。

本地连接

只有名称和 API 名称是必填字段。此连接类型的其余字段是可选的。

  1. 为此连接输入一个描述。
  2. 为此连接添加一个已授权的连接用户。如果您的 Vault 需要访问要求使用用户凭证的信息，它将通过此用户执行这一操作。如果未设置此用户，您将无法访问要求使用用户凭证的信息，例如 API 调用。
  3. 单击保存。

如何建立 Vault 到 Vault 连接

要在两个 Vault 之间建立连接：

  1. 在源 Vault 中，创建或导航到一个 Vault 到 Vault 连接记录。
  2. 从操作菜单中，选择下载连接文件。
  3. 阅读下载连接文件对话框之后，单击下载。
  4. 在目标 Vault 中，导航到管理 > 连接。
  5. 从操作菜单中，选择从文件连接。
  6. 单击选择，然后选择要上传的连接文件。
  7. 单击继续。
  8. 如果连接文件中包含一个远程 Vault ID，则表明现在已建立此连接。两个连接记录现在都处于活动状态。
  9. 可选：如果连接文件中不含远程 Vault ID，批准工作流会同时在两个 Vault 中开始。导航到连接记录，然后单击完成。
  10. 可选：在出现的对话框中，选择批准连接。连接记录现在处于已批准状态。当两个 Vault 都批准连接之后，两个记录都将进入活动状态，并建立连接。

管理现有连接

根据连接类型，可以对现有的连接使用多个管理选项。

详细信息

详细信息和远程 Vault 详细信息节段中包含有关此连接的信息。大多数这样的字段都是可编辑的。但更改 API 名称可能破坏与此连接之间的现有集成。

工作流时间表

Vault 到 Vault 连接对象记录必须完成批准工作流，此连接才会进入已批准生命周期状态。批准之后，此节段将包含有关批准的只读信息，例如完成批准任务的时间和用户。

对于外部和本地连接，此节段为空，因为不需要进行批准。

集成

Vault 到 Vault 连接可以具有多个相关的集成。您可以将状态分别设置为活动或非活动，以打开或关闭集成。

从此节段中，您还可以创建自定义集成。请了解有关用于 Vault 到 Vault 连接的集成的更多信息。

引用查找

引用查找功能允许您使用一个查找，间接从 VQL 查询中将远程 Vault 中的一个字段值设置到源 Vault 中。例如，您可以表明源 Vault 中的 country__v 值“U.S.”等于远程 Vault 中的“United States”。

请了解有关如何创建用于 Vault 到 Vault 连接的引用查找的更多信息。

管理签名证书

Vault 使用签名证书对所有出站 Spark 消息进行签名。所有 Vault 都使用同一个签名证书，此证书每年续订一次。新的证书发布之后，Vault 会自动更新所有连接以使用新的证书，并提前向客户告知即将发生的证书滚动更新。在滚动更新期内，上一个证书仍然可用。在此期间，您可以根据需要在新证书与以前的证书之间切换。一旦滚动更新期结束，新的证书将成为连接上唯一处于活动状态的证书。

Vault 会立即对连接使用所选的签名证书，以便对通过连接发送的所有出站 Spark 消息进行签名。

要管理 Spark 消息传递签名证书：

  1. 创建或导航到一个连接记录。
  2. 从操作菜单中，选择管理签名证书。
  3. 从管理签名证书对话框中，选中适用的证书旁边的复选框。如果当前证书是唯一可用的证书，此证书将是只读的，您可以下载此证书或者取消这一操作。如果有两个证书可用，则表明您处于滚动更新期。如果可能，请使用新的证书。请参阅 Vault SSL 证书，以了解更多信息。
  4. 可选：要下载证书，单击适用的证书旁边的下载图标。
  5. 单击保存，以激活所选的证书并使其可用于 Spark 消息传递。

如何删除连接

要删除一个连接，请从操作菜单中选择删除。请注意，您无法删除被一个队列引用的连接。此外，您也无法删除系统管理的标准连接，但可以将它们重新连接到另一个 Vault。

如果删除了一个已经建立的 Vault 到 Vault 连接，远程 Vault 中的连接记录将进入已断开连接状态。

标准 Vault 连接

可以在 Vault 应用程序之间建立系统管理的标准连接，以支持特定的业务流程。

Quality 到 RIM：更改控制和变体管理

Quality QMS Vault 与 RIM Registrations Vault 之间的这种 Vault 连接可在两个应用程序之间自动共享数据，以支持更改控制启动、监管评估和结束。请参阅有关 Quality 到 RIM Vault 的连接的详细信息。

RIM 至 Clinical Operations

Clinical Operations eTMF Vault 与 RIM Submissions Vault 之间的 Vault 连接可自动在两个应用程序之间共享数据，为产品、研究和机构数据和文档的自动传输提供支持。请参阅有关 RIM 至 Clinical Operations Vault 的连接的详细信息。

Clinical Operations 至 CDMS

这种 Spark Messaging 连接允许在 Clinical Operations CTMS Vault 与 CDMS EDC Vault 之间交换研究、研究国家/地区和机构，并在 CTMS Vault 与 EDC Vault 之间交换受试者、受试者访视和访视定义。

RIM 和 PromoMats

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

Veeva CRM 至 MedComms

Veeva CRM 与 MedComms Vault 之间的这一 Vault 连接会自动在两个应用程序之间共享数据，并支持自动将 CRM 中的医疗查询记录传输到 MedComms，并将 MedComms 中的医疗查询状态更新到 CRM。请参阅 Veeva CRM 至 MedComms Vault 的连接，以了解详细信息。

连接 MedComms 的网络

此连接允许 MedComms 从 Veeva OpenData 获得可靠的 HCP 联系人信息，以便在回复医疗查询时使用。

Vault 到 Vault 标准连接限制

当配置任何 Vault 到 Vault 标准连接时，可能在以下情况下出现错误：

  • 如果用户删除了此连接的任一端正在使用的记录，Vault 将停止以更新所连接的记录，但不发送任何通知。
  • 如果用户手动在此连接的任一端使用的记录上更新了其中一个 ID 字段，Vault 可能无法处理 Spark 消息和更新所连接的记录。
  • 如果此连接的任一端上的配置更改可能影响集成，例如对字段或选项列表进行的更改，Vault 可能无法处理 Spark 消息和更新所连接的记录。

连接和沙盒 Vault

当创建或刷新一个沙盒 Vault 时，会将所有处于活动状态的外部连接（URL 中有令牌的除外）设置为非活动状态，并将所有处于活动状态的 Vault 到 Vault 连接设置为待处理状态。本地连接依然保持活动状态。

URL 中有令牌的外部连接将在新建或刷新的沙盒中保留 URL 值和父 Vault 的活动或不活动状态。

要使外部连接再次进入活动状态，您必须重新输入连接 URL。要使 Vault 到 Vault 连接再次进入活动状态，您必须按照如下所述重新建立连接。

重新建立 Vault 到 Vault 连接

在沙盒创建或刷新过程中，会将所有处于活动状态的 Vault 到 Vault 连接设置为待处理状态。远程 Vault 中的相应连接依然保持活动状态。

要重新建立 Vault 到 Vault 连接，您必须从源 Vault 中重新下载连接文件、将此连接文件重新上传到目标 Vault，并批准连接。

要重新建立此连接：

  1. 在源 Vault 中，导航到管理 > 连接。源 Vault 是发起连接请求的那个 Vault。
  2. 找到要重新建立的 Vault 到 Vault 连接。
  3. 如果连接记录处于活动状态，请打开操作菜单并选择将连接设置为“待处理”。
  4. 阅读将连接设置为“待处理”对话框之后，选择继续。
  5. 可选：如果知道目标 Vault 的 ID，请在远程 Vault ID 字段中输入此 ID。目标 Vault 是您的源 Vault 要连接到的那个 Vault。如果将此字段留空，建立此连接时需要完成批准工作流。
  6. 从操作菜单中，选择下载连接文件。
  7. 阅读下载连接文件对话框之后，单击下载。
  8. 在目标 Vault 中，导航到管理 > 连接。目标 Vault 是接受连接请求的那个 Vault。
  9. 找到要重新建立的 Vault 到 Vault 连接。
  10. 从操作菜单中，选择从文件连接。
  11. 单击选择，然后选择从源 Vault 下载的连接文件。
  12. 单击继续。
  13. 如果连接文件中包含一个远程 Vault ID，则表明现在已重新建立此连接。两个连接记录现在都处于活动状态。
  14. 如果连接文件中不含远程 Vault ID，批准工作流会同时在两个 Vault 中开始。分别在源 Vault 和目标 Vault 中导航到连接记录详细信息页面，然后单击完成。

在出现的对话框中，选择批准连接。连接记录现在处于已批准状态。当两个 Vault 都批准连接之后，两个记录都将进入活动状态，并重新建立连接。

上传不含 远程 Vault ID 的 Vault 到 Vault 连接文件时，会启动一个批准工作流，因此此用户必须拥有工作流：启动权限。