创建 Adobe Acrobat Sign 集成的 Vault 系统帐户用户。
上次更新日期：
2024年7月3日
- Adobe Acrobat Sign 集成
- 新增功能
- 产品版本和生命周期
- Acrobat Sign for Salesforce
- Acrobat Sign for Microsoft
- Acrobat Sign for Microsoft 365
- 适用于 Outlook 的 Acrobat Sign
- 适用于 Word/PowerPoint 的 Acrobat Sign
- 适用于 Teams 的 Acrobat Sign
- 适用于 Microsoft PowerApps 和 Power Automate 的 Acrobat Sign
- 适用于 Microsoft Search 的 Acrobat Sign 连接器
- 适用于 Microsoft Dynamics 的 Acrobat Sign
- 适用于 Microsoft SharePoint 的 Acrobat Sign
- Acrobat Sign for Microsoft 365
- Acrobat Sign for ServiceNow
- 适用于 HR ServiceNow 的 Acrobat Sign
- 适用于 SAP SuccessFactors 的 Acrobat Sign
- 适用于 Workday 的 Acrobat Sign
- 适用于 NetSuite 的 Acrobat Sign
- 适用于 SugarCRM 的 Acrobat Sign
- 适用于 VeevaVault 的 Acrobat Sign
- 适用于 Coupa BSM Suite 的 Acrobat Sign
- Acrobat Sign 开发人员文档
概述
本文档介绍如何将 Adobe Acrobat Sign 与 Veeva Vault 平台集成。Veeva Vault 是一个针对生命科学而构建的企业内容管理 (ECM) 平台。“Vault”是一个内容和数据存储库，通常用于监管机构备案、研究报告、拨款申请、总承包等。一个企业可以有多个“Vault”，但必须单独维护。
完成集成的高级步骤如下：
- 在 Adobe Acrobat Sign 中激活您的管理帐户（仅限新客户）。
- 创建对象以跟踪 Vault 中协议生命周期的历史记录。
- 创建新的安全性配置文件。
- 在 Adobe Acrobat Sign 中配置一个组，以包含 Veeva Vault 集成用户。
- 创建文档字段和呈现类型。
- 配置 Web 操作并更新文档生命周期。
- 创建文档类型用户和用户角色设置。
- 使用中间件将 Veeva Vault 连接到 Adobe Acrobat Sign。
注意:
Adobe Sign 管理员必须在 Adobe Acrobat Sign 中执行 Adobe Acrobat Sign 设置步骤。
配置 Veeva Vault
要配置 Veeva Vault 以便与 Adobe Acrobat Sign 集成，您必须执行下列步骤。
要配置适用于 Vault 的 Adobe Acrobat Sign，需要创建一个名称为 Adobe Sign 管理员组的新组。此组用于为 Adobe Acrobat Sign 相关字段设置文档字段级别的安全性，默认情况下，其中应包括 Adobe Sign 集成配置文件。
部署包，然后按照以下步骤操作。部署包后，包将创建：
- 自定义对象：签名对象、签名者对象、签名事件对象、进程锁定者对象
- 签名对象页面布局
- 签名事件对象页面布局
- 签名者对象页面布局
- 进程锁定者对象页面布局
- Adobe Sign 集成任务日志对象页面布局
- Adobe Sign 呈现类型
- 原始呈现类型
- Shared field signature__c
- Adobe Sign Web 操作
- 取消 Adobe Sign Web 操作
- Adobe Sign 管理员操作权限集
- Adobe Sign 集成配置文件安全性配置文件
- 应用程序角色 Adobe Sign 管理员角色
- 文档类型组“Adobe Sign 文档”
- Adobe Sign 集成任务日志对象
签名对象
创建签名对象以存储与协议相关的信息。签名对象是一个数据库，其中包含以下特定字段下的信息：
| 字段 | 标签 | 类型 | 说明 |
|---|---|---|---|
| external_id__c | 协议 ID | 字符串 (100) | 保留 Adobe Acrobat Sign 的唯一协议 ID |
| file_hash__c | 哈希文件 | 字符串 (50) | 保留已发送到 Adobe Acrobat Sign 的文件对应的 md5 校验和 |
| name__v | 名称 | 字符串 (128) | 保留协议名称 |
| sender__c | 发件人 | 对象（用户） | 保留对已创建协议的 Vault 用户的引用 |
| signature_status__c | 签名状态 | 字符串 (75) | 保留协议在 Adobe Acrobat Sign 中的状态 |
| signature_type__c | 签名类型 | 字符串 (20) | 保留协议在 Adobe Acrobat Sign 中的签名类型（书面或电子签名） |
| start_date__c | 开始日期 | 日期时间 | 发送协议以请求签名的日期 |
| cancellation_date__c | 取消日期 | 日期时间 | 保留取消协议的日期。 |
| completion_date__c | 完成日期 | 日期时间 | 保留协议完成的日期。 |
| viewable_rendition_used__c | 使用的可视呈现 | 布尔 | 指示是否已发送可视呈现以供签名的标志。（默认情况下为 true） |
| plugin_version__c | 插件版本 | 文本 (10) | 您可以使用该选项在部署新版本 4.0 之前正确处理创建的所有协议。 注意：部署 4.0 自定义 Web 应用程序版本后，每次创建签名记录时，此字段将设置为 4.0。 |
| external_environment__c | 外部环境 | 文本 (20) | 保留创建协议时使用的 Adobe Sign 环境名称。 |
签名者对象
创建签名者对象以存储与协议参与者相关的信息。它包含以下特定字段下的信息：
| 字段 | 标签 | 类型 | 说明 |
|---|---|---|---|
| email__c | 电子邮件 | 字符串 (120) | 保留 Adobe Acrobat Sign 的唯一协议 ID |
| external_id__c | 参与者 ID | 字符串 (80) | 保留 Adobe Acrobat Sign 唯一参与者的标识符 |
| name__v | 名称 | 字符串 (128) | 保留 Adobe Acrobat Sign 参与者的姓名 |
| order__c | 订单 | 数字 | 保留 Adobe Acrobat Sign 协议参与者的序号 |
| role__c | 角色 | 字符串 (30) | 保留 Adobe Acrobat Sign 协议参与者的角色 |
| signature__c | 签名 | 对象（签名） | 保留对签名父记录的引用 |
| signature_status__c | 签名状态 | 字符串 (100) | 保留 Adobe Acrobat Sign 协议参与者的状态 |
| user__c | 用户 | 对象（用户） | 如果参与者是 Vault 用户，则保留对签名者用户记录的引用 |
签名事件对象
创建签名事件对象以存储与协议事件相关的信息。它包含以下特定字段下的信息：
| 字段 | 标签 | 类型 | 说明 |
|---|---|---|---|
| acting_user_email__c | 代理用户电子邮件 | 字符串 | 保留执行特定操作而导致事件生成的 Adobe Acrobat Sign 用户的电子邮件 |
| acting_user_name__c | 代理用户名 | 字符串 | 保留执行特定操作而导致事件生成的 Adobe Acrobat Sign 用户名 |
| description__c | 说明 | 字符串 | 保留 Adobe Acrobat Sign 事件的描述 |
| event_date__c | 事件日期 | 日期时间 | 保留 Adobe Acrobat Sign 事件的日期和时间 |
| event_type__c | 事件类型 | 字符串 | 保留 Adobe Acrobat Sign 事件的类型 |
| name__v | 名称 | 字符串 | 自动生成的事件名称 |
| participant_comment__c | 参与者注释 | 字符串 | 保留 Adobe Acrobat Sign 参与者的注释（如果有） |
| participant_email__c | 参与者电子邮件 | 字符串 | 保留 Adobe Acrobat Sign 参与者的电子邮件 |
| participant_role__c | 参与人角色 | 字符串 | 保留 Adobe Acrobat Sign 参与者的角色 |
| signature__c | 签名 | 对象（签名） | 保留对签名父记录的引用 |
| external_id__c | 外部 ID | 文本 (200) | 保留 Adobe Sign 生成的协议事件标识符。 |
进程锁定者对象
创建进程锁定者对象以锁定 Adobe Acrobat Sign 集成进程。它不需要任何自定义字段。
Adobe Sign 集成任务日志对象
创建 Adobe Sign 集成任务日志 (as_int_task_log__c)。它是用于跟踪 AgreementsEventsSynchronizerJob 和 AgreementsEventsProcessingJob 执行情况的高容量对象。
AgreementsEventsSynchronizerJob：此任务可确保 Adobe Sign 中所有缺失的协议事件作为活动签名事件在 Vault 中创建，以供过去 N 天内 Vault 中创建的所有签名使用。
AgreementsEventsProcessingJob：此任务可确保根据事件类型处理具有活动签名事件记录的所有文档。
| 字段 | 标签 | 类型 | 说明 |
|---|---|---|---|
| start_date__c | 开始日期 | 日期时间 | 任务开始日期 |
| end_date__c | 结束日期 | 日期时间 | 任务结束日期 |
| task_status__c | 任务状态 | 选择列表 | 保留任务状态： 已完成 (task_completed__c) 已完成但有错误 (task_completed_with_errors__c) 失败 (task_failed__c) |
| task_type__c | 任务类型 | 选择列表 | 保留任务类型： 协议事件同步 (agreements_events_synchronization__c) 协议事件处理 (agreements_events_processing__c) |
| messages__c | 消息 | 长 (32000) | 保留任务消息 |
“签名”、“签名者”、“签名事件”、“进程锁定者”和“任务日志”对象均作为部署包的一部分提供，默认情况下，已启用“审核此对象的数据更改”属性。
注意：通过启用“审核数据更改”设置，您可以更改审核日志中 Vault 捕获对象记录数据。默认情况下，此设置处于禁用状态。启用此设置并创建记录后，您将无法再禁用该设置。如果此设置禁用且存在记录，则只有 Vault 所有者才能更新该设置。
显示签名对象的参与者和历史记录
签名对象作为部署包的一部分提供，其中包含签名详细信息页面布局。页面布局中包含“参与者”和“历史记录”部分。
- 参与者部分具有“相关对象”分区，该分区已如下图所示进行配置。
- 您可以编辑显示参与者的列，如下所示。
- 历史记录部分具有“相关对象”分区，该分区已如下图所示进行配置。
- 您可以编辑显示历史记录的列，如下所示。
查看 Adobe Acrobat Sign 文档的参与者和审核历史记录
要查看 Adobe Acrobat Sign 文档的参与者和审核历史记录，请选择文档中“Adobe 签名”部分中的链接。
- 打开的页面上将显示 Adobe Acrobat Sign 文档的参与者和历史记录，如下所示。
- 查看签名的审核记录，如下所示。
在步骤 2 中成功部署包将创建 Adobe Sign 集成配置文件。将 Adobe Sign 集成配置文件分配给系统帐户，并由集成在调用 Vault API 时使用。此配置文件允许具有以下权限：
- Vault API
- 阅读、创建、编辑和删除：“签名”、“签名者”、“签名事件”和“进程锁定者”对象
您必须通过将包含的安全性配置文件设置为 Adobe Sign 集成配置文件来更新 Adobe Sign 管理员组（在步骤 1 中创建），如下图所示。
部署 Adobe Acrobat Sign 包时，系统会创建一个名为“Adobe Sign 文档”的文档类型组记录。
您必须为符合 Adobe Acrobat Sign 流程条件的所有文档分类添加此文档类型组。由于文档类型组属性不会从类型继承到子类型，也不会从子类型继承到分类级别，因此必须为符合 Adobe Acrobat Sign 条件的每个文档分类设置该属性。
注意：如果“用户角色设置”对象不包含引用“文档类型组”对象的字段，则必须添加该字段。为此，请转到对象 > 用户角色设置 > 字段，然后完成所需的步骤，如下图所示。
正确配置生命周期后，系统应确保 DAC 为符合 Adobe Acrobat Sign 流程条件的所有文档添加 Adobe Sign 管理员用户。为此，请创建相应的“用户角色设置”记录，其中指定：
- 文档类型组为 Adobe Sign 文档
- 应用程序角色为 Adobe Sign 管理员角色
- 集成用户
部署包将创建以下建立集成所需的新共享文档字段：
- 签名 (signature__c)
要设置文档字段，请执行以下操作：
“禁用 Vault 叠加”(disable_vault_overlays__v) 是一个现有的共享字段。或者，该字段可以具有特定的安全性，仅允许 Adobe Sign 管理员组的成员更新其中的值。
Vault 集成使用名为 Adobe Sign Rendition (adobe_sign_rendition__c) 的新呈现类型将已签名 PDF 文档上传到 Adobe Acrobat Sign。您必须为每种符合 Adobe Acrobat 签名条件的文档类型声明 Adobe Sign 呈现类型。
Vault 集成使用名为原始呈现 (original_rendition__c) 的新呈现类型作为呈现的名称，如果将签名文档作为可视呈现导入，则该呈现将用于存储原始可视呈现。
您必须为每种符合 Adobe Acrobat 签名条件的文档类型声明原始呈现。
或者，Vault 可以采用新的呈现类型 Adobe 审核记录呈现 (adobe_audit_trail_rendition__c)，Vault 集成使用该呈现类型来存储 Adobe 审核记录报告。
按照以下步骤设置 Adobe 审核记录呈现：
当用户选择具有上述设置的数字签名协议时，系统会显示一条消息（如下所示），指示 Adobe Acrobat Sign 正在使用 PDF 产品组合将已数字签名的 PDF 和审核记录报告组合在一起。
要查看文档内容以及数字签名和审核记录，请勿在管理 UI 以进行数字签名中选择“将审核报告附加到已签名的呈现”以及“显示 Acrobat Sign 呈现”。
您可以使用 Adobe 审核记录呈现下载 Adobe 审核记录，或将其作为单独的呈现进行查看。
Adobe Acrobat Sign 和 Vault 集成要求您创建和配置以下两个 Web 操作：
创建 Adobe Sign：这会创建或显示 Adobe Acrobat Sign 协议。
类型：文档
目标：在 Vault 内显示
凭据：通过 Post 消息启用 Post 会话凭据
URL：https://api.na1.adobesign.com/api/gateway/veevavaultintsvc/partner/agreement?docId=${Document.id}&majVer=${Document.major_version_number__v}&minVer=${Document.minor_version_number__v}&vaultid=${Vault.id}&useWaitPage=true
- 取消 Adobe Sign：这会取消 Adobe Acrobat Sign 中的现有协议，并将文档状态恢复为初始状态。
类型：文档
目标：在 Vault 内显示
凭据：通过 Post 消息启用 Post 会话凭据
URL：https://api.na1.adobesign.com/api/gateway/veevavaultintsvc/partner/agreement/cancel?docId=${Document.id}&majVer=${Document.major_version_number__v}&minVer=${Document.minor_version_number__v}&vaultid=${Vault.id}&useWaitPage=true
对于符合 Adobe 签名条件的每种文档类型，您必须通过添加新的生命周期角色和状态来更新相应的文档生命周期。
Adobe Acrobat Sign 协议生命周期包括以下状态：
- 草稿
- “创作”或 DOCUMENTS_NOT_YET_PROCESSED
- OUT_FOR_SIGNATURE 或 OUT_FOR_APPROVAL
- “已签名”或“已审批”
- CANCELLED
- EXPIRED
要更新文档生命周期，请执行以下步骤：
-
将用户操作添加到下列状态中。
将 Vault 文档发送到 Adobe Acrobat Sign 时，其状态应该对应于协议所处的状态。为此，请在符合 Adobe 签名条件的文档所使用的每个生命周期中添加以下状态：
- Adobe 签名（审阅）之前：这是状态的占位符名称，文档可以从该状态发送到 Adobe Acrobat Sign。根据文档类型，可以将其设为“草稿”状态或“已审阅”状态。可以根据客户要求自定义文档状态标签。在 Adobe 签名状态之前，必须定义以下两个用户操作：
- 将文档状态更改为 Adobe Sign 草稿状态的操作。对于任何生命周期的所有文档类型，此用户操作的名称必须相同。
- 调用 Web 操作“Adobe Sign”的操作。此状态必须具有一定的安全性，允许 Adobe Sign 管理员角色执行以下操作：查看文档、查看内容、编辑字段、编辑关系、下载源、管理可视呈现以及更改状态。
- 通过在 Adobe Sign 草稿中默认设置为“隐藏”并且仅针对 Adobe Sign 管理员角色执行，可以修改已审阅状态的原子安全性。
注意：如果 Adobe Sign 管理员角色不属于原子安全性：用户操作，则通过选择编辑 > 角色覆盖来添加 Adobe Sign 管理员角色。接下来，为已审阅状态的文档添加 Adobe Sign 管理员角色。
- Adobe Sign 草稿：这是状态的占位符名称，表示文档已上传至 Adobe Acrobat Sign，且其协议处于“草稿”状态。这是一种必需状态。此状态必须定义以下五个用户操作：
- 将文档状态更改为 Adobe Sign 创作状态的操作。对于任何生命周期的所有文档类型，此用户操作的名称必须相同。
- 将文档状态更改为 正在进行 Adobe 签名状态的操作。对于任何生命周期的所有文档类型，此用户操作的名称必须相同。
- 将文档状态更改为 Adobe Sign 已取消状态的操作。对于任何生命周期的所有文档类型，此用户操作的名称必须相同。
- 调用 Web 操作 Adobe Sign 的操作。
- 调用 Web 操作取消 Adobe Sign 的操作。此状态必须具有一定的安全性，允许 Adobe Sign 管理员角色执行以下操作：查看文档、查看内容、编辑字段、编辑关系、下载源、管理可视呈现以及更改状态。
- 修改 Adobe Sign 草稿状态的原子安全性：Adobe Sign 已取消、Adobe Sign 创作、正在进行 Adobe 签名操作必须仅对 Adobe Sign 管理员角色可见
注意：如果 Adobe Sign 管理员角色不属于原子安全：用户操作，请通过选择编辑 > 角色覆盖来添加 Adobe Sign 管理员角色。接下来，为 Adobe Sign 草稿状态的文档添加 Adobe Sign 管理员角色。
Adobe Sign 创作：这是状态的占位符名称，表示文档已上传到 Adobe Acrobat Sign，且其协议处于“创作”或 DOCUMENTS_NOT_YET_PROCESSED 状态。这是一种必需状态。此状态必须定义以下四个用户操作：
- 将文档状态更改为“Adobe Sign 已取消”状态的操作。无论文档的生命周期如何，针对所有文档类型设置的用户操作名称都必须相同。
- 将文档状态更改为“正在进行 Adobe 签名”状态的操作。无论文档的生命周期如何，针对所有文档类型设置的用户操作名称都必须相同。
- 调用 Web 操作“Adobe Sign”的操作
- 调用 Web 操作“取消 Adobe Sign”的操作。此状态必须具有一定的安全性，允许 Adobe Sign 管理员角色执行以下操作：查看文档、查看内容、编辑字段、编辑关系、下载源、管理可视呈现以及更改状态。
- 修改 Adobe Sign 创作状态的原子安全性：Adobe Sign 已取消和正在进行 Adobe 签名操作必须仅对 Adobe Sign 管理员角色可见
注意：如果 Adobe Sign 管理员角色不属于原子安全：用户操作，请通过选择编辑 > 角色覆盖来添加 Adobe Sign 管理员角色。接下来，为 Adobe Sign 创作状态的文档添加 Adobe Sign 管理员角色。
- 正在进行 Adobe 签名：这是状态的占位符名称，表示文档已上传至 Adobe Acrobat Sign，且其协议已发送给参与者（OUT_FOR_SIGNATURE 或 OUT_FOR_APPROVAL 状态）。这是一种必需状态。此状态必须定义以下五个用户操作：
- 将文档状态更改为“Adobe Sign 已取消”状态的操作。此操作的目标状态可以是任何客户要求的状态，可根据不同文档类型设置不同状态。无论文档的生命周期如何，针对所有文档类型设置的用户操作名称都必须相同。
- 将文档状态更改为“Adobe Sign 已拒绝”状态的操作。此操作的目标状态可以是任何客户要求的状态，可根据不同文档类型设置不同状态。无论文档的生命周期如何，针对所有文档类型设置的用户操作名称都必须相同。
- 将文档状态更改为“Adobe 已签名”状态的操作。此操作的目标状态可以是任何客户要求的状态，可根据不同文档类型设置不同状态。但是，无论文档的生命周期如何，针对所有文档类型设置的用户操作名称都必须相同。
- 调用 Web 操作 Adobe Sign 的操作。
- 调用 Web 操作取消 Adobe Sign 的操作。此状态必须具有一定的安全性，允许 Adobe Sign 管理员角色执行以下操作：查看文档、查看内容、编辑字段、编辑关系、下载源、管理可视呈现以及更改状态。
- 修改正在进行 Adobe 签名状态的原子安全性：Adobe Sign 已取消、Adobe Sign 已拒绝和 Adobe 已签名操作必须仅对 Adobe Sign 管理员角色可见
注意：如果 Adobe Sign 管理员角色不属于原子安全：用户操作，请通过选择编辑 > 角色覆盖来添加 Adobe Sign 管理员角色。接下来，为正在进行 Adobe 签名状态的文档添加 Adobe Sign 管理员角色。
- Adobe 已签名（已审批）：这是状态的占位符名称，表示文档已上传至 Adobe Acrobat Sign，且其协议已完成（处于“已签名”或“已审批”状态）。这是一种必须状态，可以是现有的生命周期状态，例如“已审批”。
此状态不需要用户操作。它必须具有一定的安全性，允许 Adobe Sign 管理员角色执行以下操作：查看文档、查看内容和编辑字段。
下图说明了 Adobe Acrobat Sign 协议和 Vault 文档状态之间的映射，其中“Adobe 签名之前”状态为“草稿”。
- Adobe 签名（审阅）之前：这是状态的占位符名称，文档可以从该状态发送到 Adobe Acrobat Sign。根据文档类型，可以将其设为“草稿”状态或“已审阅”状态。可以根据客户要求自定义文档状态标签。在 Adobe 签名状态之前，必须定义以下两个用户操作：
您必须为处于“生命周期状态”的每个用户角色设置相应的权限，如下图所示。
使用中间件将 Veeva Vault 连接到 Adobe Acrobat Sign
完成 Veeva Vault 和 Adobe Acrobat Sign 管理员帐户的设置后，管理员必须使用中间件在两个帐户之间建立连接。Veeva Vault 和 Adobe Acrobat Sign 帐户之间的连接由 Adobe Acrobat Sign 身份发起，然后用于存储 Veeva Vault 身份。
为了确保系统的安全性和稳定性，管理员必须使用专门的 Veeva Vault 系统/服务/实用程序帐户，例如 adobe.for.veeva@xyz.com，而不是个人用户帐户，例如 bob.smith@xyz.com。
Adobe Acrobat Sign 帐户管理员必须按照以下步骤使用中间件将 Veeva Vault 连接到 Adobe Acrobat Sign：
