使用连接对象,您可以在本地、Vault 之间或使用外部应用程序创建集成。如果希望发送 Spark 消息,您还必须将此连接附加到一个队列中。
注意:已知问题:即使更改类型选项出现在用于连接的操作菜单中,此功能也不受支持。您无法更改现有连接的连接类型。
访问连接管理
从管理 > 连接中查看和管理连接。您必须拥有一个能够授予应用程序:管理连接权限的安全配置文件,才能访问此标签页。
如何创建连接对象
要创建新的连接:
- 从连接页面中,单击创建。
- 选择一个连接类型(Vault 到 Vault、外部或本地)。
- 为此连接输入一个名称。
- 为此连接输入一个 API 名称。只允许使用小写字母、字母数字字符和字符之间的下划线 (_)。
- 执行此操作之后,字段将因连接类型而异。请参阅以下连接类型的每个相应节段。
Vault 到 Vault 连接
只有名称和 API 名称是必填字段。此连接类型的所有其余字段都是可选的。
- 输入一个远程 Vault ID。此 ID 是您要与其交换消息的 Vault 的 ID。如果此字段具有一个值,则只有此 Vault ID 能够上传连接文件,而且无需使用任何批准工作流。如果忽略此字段,批准工作流将在上传此连接时开始。
- 为此连接输入一个描述。
- 选择一个已授权的连接用户。如果远程 Vault 需要访问此 Vault 中的信息,它将通过此用户执行这一操作。
- 在远程 Vault 详细信息下方,您可以输入有关远程 Vault 的信息。与描述字段类似,这些字段也只供您个人参考。建立连接之后,这些字段中会自动填充相关信息。
- 单击保存。此连接记录现在处于待处理状态。要使此连接进入活动状态,您需要建立此连接。
外部连接
当配置要从 Vault 检索数据的外部连接时,建议使用连接授权和已授权的连接用户选项。
如果您的 Vault 配置了 Vault 令牌和自定义令牌,您可以在 URL 中使用它们。在 Vault 开发人员门户中了解更多信息。
连接授权将存储外部系统的用户名和密码,并且可以在消息标题中发送,以便在外部系统上进行身份验证。必须在外部系统上处理用户名和密码,并在外部系统上进行身份验证。
已授权的连接用户可用于生成一个 SessionID
,可以将此 ID 发送到外部系统并用于后续 API 回调,以便从 Vault 检索数据。建议生成 SessionID
,并在消息中发送此 ID。
- 为此外部连接输入一个 URL。此 URL 必须采用一种包含
https://
的有效 HTTPS 格式。只允许使用标准 HTTPS 端口,例如不允许使用https://veeva.com:8443
。 - 可选:为此外部连接选择一个授权记录。如果外部连接需要访问此 Vault 中的数据,它将通过此连接授权记录执行这一操作。如果不存在此记录,您可以创建一个。
- 可选:为此连接输入一个描述。
- 可选:为此连接添加一个已授权的连接用户。如果外部应用程序需要访问此 Vault 中的信息,它将通过此用户执行这一操作。如果未设置此用户,外部应用程序将无法为您的 Vault 创建会话令牌。
- 单击保存。创建的连接记录处于活动状态,而且可以立即使用。
本地连接
只有名称和 API 名称是必填字段。此连接类型的其余字段是可选的。
- 为此连接输入一个描述。
- 为此连接添加一个已授权的连接用户。如果您的 Vault 需要访问要求使用用户凭证的信息,它将通过此用户执行这一操作。如果未设置此用户,您将无法访问要求使用用户凭证的信息,例如 API 调用。
- 单击保存。
如何建立 Vault 到 Vault 连接
要在两个 Vault 之间建立连接:
- 在源 Vault 中,创建或导航到一个 Vault 到 Vault 连接记录。
- 从操作菜单中,选择下载连接文件。
- 阅读下载连接文件对话框之后,单击下载。
- 在目标 Vault 中,导航到管理 > 连接。
- 从操作菜单中,选择从文件连接。
- 单击选择,然后选择要上传的连接文件。
- 单击继续。
- 如果连接文件中包含一个远程 Vault ID,则表明现在已建立此连接。两个连接记录现在都处于活动状态。
- 可选:如果连接文件中不含远程 Vault ID,批准工作流会同时在两个 Vault 中开始。导航到连接记录,然后单击完成。
- 可选:在出现的对话框中,选择批准连接。连接记录现在处于已批准状态。当两个 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 消息传递签名证书:
- 创建或导航到一个连接记录。
- 从操作菜单中,选择管理签名证书。
- 从管理签名证书对话框中,选中适用的证书旁边的复选框。如果当前证书是唯一可用的证书,此证书将是只读的,您可以下载此证书或者取消这一操作。如果有两个证书可用,则表明您处于滚动更新期。如果可能,请使用新的证书。请参阅 Vault SSL 证书,以了解更多信息。
- 可选:要下载证书,单击适用的证书旁边的下载图标。
- 单击保存,以激活所选的证书并使其可用于 Spark 消息传递。
如何删除连接
要删除一个连接,请从操作菜单中选择删除。请注意,您无法删除被一个队列引用的连接。此外,您也无法删除系统管理的标准连接,但可以将它们重新连接到另一个 Vault。
如果删除了一个已经建立的 Vault 到 Vault 连接,远程 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,并批准连接。
要重新建立此连接:
- 在源 Vault 中,导航到管理 > 连接。源 Vault 是发起连接请求的那个 Vault。
- 找到要重新建立的 Vault 到 Vault 连接。
- 如果连接记录处于活动状态,请打开操作菜单并选择将连接设置为“待处理”。
- 阅读将连接设置为“待处理”对话框之后,选择继续。
- 可选:如果知道目标 Vault 的 ID,请在远程 Vault ID 字段中输入此 ID。目标 Vault 是您的源 Vault 要连接到的那个 Vault。如果将此字段留空,建立此连接时需要完成批准工作流。
- 从操作菜单中,选择下载连接文件。
- 阅读下载连接文件对话框之后,单击下载。
- 在目标 Vault 中,导航到管理 > 连接。目标 Vault 是接受连接请求的那个 Vault。
- 找到要重新建立的 Vault 到 Vault 连接。
- 从操作菜单中,选择从文件连接。
- 单击选择,然后选择从源 Vault 下载的连接文件。
- 单击继续。
- 如果连接文件中包含一个远程 Vault ID,则表明现在已重新建立此连接。两个连接记录现在都处于活动状态。
- 如果连接文件中不含远程 Vault ID,批准工作流会同时在两个 Vault 中开始。分别在源 Vault 和目标 Vault 中导航到连接记录详细信息页面,然后单击完成。
在出现的对话框中,选择批准连接。连接记录现在处于已批准状态。当两个 Vault 都批准连接之后,两个记录都将进入活动状态,并重新建立连接。
相关管理员权限
上传不含 远程 Vault ID 的 Vault 到 Vault 连接文件时,会启动一个批准工作流,因此此用户必须拥有工作流:启动权限。