在 Salesforce Lightning 页面中，导航至 Adobe Acrobat Sign 管理员选项卡。
上次更新日期：
2024年10月16日
您是否无法从 Salesforce 发送协议？ 数据映射是否无法更新 Salesforce 字段？
适用于 Salesforce 的 Adobe Acrobat Sign：故障诊断指南旨在帮助您解决从 Salesforce 发送协议、数据映射或自动状态更新时出现的问题。 了解如何：
在签署 Acrobat Sign 协议后或在协议工作流程的指定阶段，Acrobat Sign 数据映射会更新 Salesforce 对象。 每个数据映射都是提前设置的，其中包含数据映射规则。 每个数据映射规则都定义了数据源和必须要更新的目标 Salesforce 字段。 有关详细信息，请参阅 Salesforce 数据映射。
如果数据映射无法更新 Salesforce 字段，请执行以下故障诊断步骤以识别并修复问题：
具体操作如下：
确保自动状态更新用户（通常是用于设置集成的 Sign 帐户管理员）以及发件人有权访问您尝试通过数据映射更新的对象。
要查看字段值，您可以将该字段添加到协议列表视图、使用 Developer Console 或 Workbench。
数据映射错误字段存储数据映射中出现的错误。 您可以检查该字段的值，方法是使用该开发人员控制台或通过Workbench将该字段添加到“协议”列表视图。 下面列出了常见错误和相应的解决步骤：
| 错误 | 无法映射数据字段：System.DmlException 更新失败。 第 0 行出现 ID 为 00ZxxqwertasdmjVUAR 的第一个异常；第一个错误：STRING_TOO_LONG，所有者标题：数据值太大：Adobe Acrobat Sign Adobe inc（最大长度=20）：[Owner_Title__c] (echosign_dev1) 165 |
解决办法： 此错误意味着已更新文档表单字段中的数据超过了您尝试更新的 Salesforce 字段的大小限制。 要解决此问题，请执行以下操作：
|
|
| 错误 |
尝试映射到相关对象引用，但该对象未在协议中进行设置：<您要更新的 Salesforce 对象上字段的 API 名称> |
解决办法： 此错误意味着未在协议对象和您尝试更新的 Salesforce 对象之间建立连接。 请参阅上面的步骤 4。 |
|
| 错误 |
无法映射数据字段：System.NullPointerException 尝试取消引用空对象 (echosign_dev1) 656 |
解决办法 此错误表示数据映射失败，因为它无法访问所需的对象。 执行以下步骤可解决上述问题：
|
示例用户：
John Smith
示例用例：
John 想执行以下操作：
- 使用协议模板从名为“Demo 1”的自定义对象发送协议，
- 从与“Demo 1”对象关联的另一个名为“Demo 2”的自定义对象中提取信息并将信息推送到协议，以及
- 签署协议后，将信息推送到“Demo 2”对象记录。
完成用例的步骤：
- 在 Acrobat Sign“协议”对象上，为“Demo 1”对象创建一个查找字段。
- 在"Demo 1"对象上，为"Demo 2"对象创建查找字段。
\n您无法从相关列表提取信息或将信息推送到相关列表。 - 按如下方式创建数据映射模板：
- 提供一个唯一的模板名称。
- 在字段映射下，选择所选对象，然后从下拉菜单中选择 Demo 1。
- 从加载的第二个下拉列表中，选择 Demo 2 ID。
- 在加载的第三个下拉列表中，将其保留为“无”，然后选择选择。
- 对于“要更新哪个 Salesforce 字段？”，请选择需要更新的字段名称。
- 要完成数据映射设置，请按照“映射和模板指南”中使用数据映射将签名者数据和文件推送到 Salesforce 记录一节中的步骤进行操作。
- 按如下方式创建合并映射模板：
- 提供一个唯一的模板名称。
- 选择添加字段映射。
- 在源值下，选择所选对象，然后从下拉菜单中选择 Demo 1。
- 从加载的第二个下拉列表中，选择 Demo 2 ID。
- 从加载的下一个下拉列表中，选择包含您需要提取的值对应的字段名称，然后选择完成。
- 要完成合并映射设置，请按照映射和模板指南中使用合并映射生成包含 Salesforce 数据的文档一节进行操作。
- 按照创建模板工作流程下的步骤创建协议模板。
- 在上述步骤创建的协议模板中，确保合并映射和数据映射模板包含在“数据映射”部分中。
- 在协议模板的模板详细信息部分中，选择 Salesforce 对象作为 Demo 1。
- 选择将数据映射到协议字段，然后在显示的对话框中，执行以下操作：
- 选择从对象中选择选项。
- 在源类型下，选择 Demo 1 ID。
- 在目标协议字段下，从查找字段中选择 Demo 1 对象。
- 选择保存。
- 在协议模板上，选择保存。
\n这会创建一个关联到"Demo 1"对象的协议模板，并启用合并映射和数据映射。 - 打开“Demo 1”对象记录，并选择
> 编辑页面。 然后，从左侧面板上的“自定义管理”部分，拖放 AgreementPanel，并选择保存。 - 选择激活并根据需要分配记录页面。 出于测试目的，请选择“指定为组织默认值”，这将向所有用户公开显示“AgreementPanel”。
- 选择下一步，然后选择保存。
- 导航至“Demo 1”对象记录并刷新页面。 此时应显示您添加的“AgreementPanel”面板。
- 选择发送协议以供签名。 此时会显示您创建的协议模板。
- 选择此协议模板，然后按照屏幕上的步骤发送协议。 验证协议是否包含来自“Demo 2”的合并数据。
- 签署协议。 此时会显示根据协议中的值进行更新的“Demo 2”记录。
如果您无法从 Salesforce 发送协议，请执行以下故障诊断步骤：
确保您使用的是受支持的 Adobe Acrobat Sign 版本。 请参阅支持的版本。
确保您作为发送者具有所需的权限。
\n请参阅 如何向用户授予必需的访问权限的 除了指南中提到的对象和字段之外，发件人还必须有权访问工作流程中使用的其他 Salesforce 对象。
检查 Salesforce 中的“协议”对象或其他 Acrobat Sign 对象是否具有自定义设置，例如触发器、工作流程或规则。 如果是，请禁用所有自定义设置并发送测试协议，查看是否能够通过。
\n如果禁用自定义设置后协议成功发送，请参阅我们的开发人员指南以获取指导。
\n
注释
我们不支持对自定义项进行故障诊断。
请参阅下表，了解错误和解决步骤：
|
错误 |
解决办法 |
|---|---|
|
在 x-api-user 标头中提供的用户 ID 或电子邮件地址无效 您没有有效的 Adobe Acrobat Sign 用户帐户 |
这些错误表明发件人没有有效的 Acrobat Sign 许可证。 要排除故障：
|
|
文件格式不受支持 |
当您要发送以请求签名的文档的格式不受支持时，会出现此错误。 请参阅 Acrobat Sign 系统要求中的支持的文档格式一节，以检查支持将哪些格式的文件上传到 Acrobat Sign。 |
|
在签名按钮中使用了不正确的对象 ID |
当发件人名义按钮的模板 ID 或对象的主 ID 无效时，会出现此错误。 我们建议您输入正确的对象 ID，然后重新尝试该过程。 |
如果协议未更新为正确状态，请执行以下故障诊断步骤：
验证是否已实施适用于 Salesforce 的 Adobe Acrobat Sign：安装指南中提到的先决条件和安装后配置（必需）
如果未看到此消息，请执行以下步骤：
- 退出登录，然后再以系统管理员身份重新登录。
- 转到 Adobe Acrobat Sign 管理员 > 启用自动状态更新，然后选择启用。
- 在出现的“允许访问 Acrobat Sign”对话框中，执行以下操作：
- 请记下对话框底部的电子邮件地址。
- 确保此电子邮件地址具有有效的 Sign 许可证，并且是 Salesforce 的系统管理员。
- 确保为用户分配了“Adobe Sign 集成用户”权限集。
- 选择允许。
此时应显示以下消息：“已为该组织启用自动状态更新”。
在“协议通知”对象上，选中错误消息字段。 要查看字段中的值，请在 Developer Console 上执行以下 SOQL 查询：
从 echosign_dev1__Agreement_Notification__c 中选择 ID、echosign_dev1__Agreement_Event_Type__c、echosign_dev1__Agreement_Status__c、echosign_dev1__Document_Key__c、echosign_dev1__Error_Message__c、echosign_dev1__Notification_Type__c、echosign_dev1__Status__c，其中 echosign_dev1__Agreement__c='<agreementId>'
如果协议是在 Salesforce 环境之外创建的推送协议，请确保按照适用于 Salesforce 的 Adobe Acrobat Sign：大型文档和推送协议服务指南进行操作。
检查 Salesforce 中的“协议”对象或其他 Acrobat Sign 对象是否具有自定义设置，例如触发器、工作流程或规则。
如果有，请禁用所有自定义设置，并按照常规步骤发送测试协议，然后查看协议是否能够通过。 协议状态应从“草稿”更改为“已发出进行签名”。
如果在禁用自定义设置后，协议状态更改为“已发出进行签名”，则请参阅我们的开发人员指南以获取指导。
如果状态未更新，请直接从“协议”选项卡发送禁用自定义设置的测试协议，然后查看协议是否能够通过。 如果状态仍未更改，请检查上述步骤 1 和 2。
注释
我们不支持对自定义项进行故障诊断。
| Acrobat Sign 对象 | ||
|---|---|---|
| 添加文件附件 | 文件映射 | 将数据映射到协议字段中 |
| 添加表单字段模板 | 表单字段导入 | 合并映射 |
| 添加收件人 | 表单字段子映射 | 互斥 |
| 协议 | 表单字段子映射条目 | 对象映射 |
| 协议事件 | 表单字段映射 | 收件人 |
| 协议模板 | 表单字段映射条目 | 已签名协议 |
| 数据映射 | 组映射 | 触发器 |
| 字段映射 | 库模板 | 用户同步结果 |
| 协议类型 | ||
现在，所有组织都默认启用了 Salesforce 的增强域，这不会影响适用于 Salesforce 的 Acrobat Sign 包。 但是，如果客户在为其站点配置了大型文件下载和推送协议，那么在启用其增强域后，就会遇到问题，从而导致站点URL发生更改并且协议终止。
为确保协议顺畅运行，客户需要更新大文件下载的自定义设置，以反映更新的站点 URL。
要更新推送协议回调 URL，客户必须联系支持人员并提供所需信息。 有关详细信息，请参阅为您的 Acrobat Sign 帐户配置个人服务。
适用于 Salesforce 的 Adobe Acrobat Sign 允许您在将“潜在客户”选择作为收件人类型时搜索并将潜在客户添加为协议收件人。 但是，如果政府云用户创建潜在客户、联系人或用户，但无法使用搜索字段找到他们，则 Saleforce 组织管理员可执行以下解决步骤：
- 转至设置 > 对象管理器，然后搜索潜在客户。
- 在左侧面板中，选择字段和关系。
- 对于所有必填字段（如姓名、电子邮件、移动电话等），检查用户可访问性。 具体操作如下：
- 选择想要检查的任何字段。 例如，选择移动电话。
- 对于想要启用字段访问权限的所有用户，选择可见复选框。
- 选择保存。
如果执行完上述故障诊断步骤后仍未解决问题，请联系支持人员并向我们提供以下详细信息：
- 问题描述
- 用于设置集成的 Acrobat Sign 帐户管理员的电子邮件地址
- 用于启用自动状态更新的 Acrobat Sign 帐户管理员的电子邮件地址：
- Salesforce 中安装的 Acrobat Sign 程序包版本
- Salesforce 组织 ID
- 受影响协议的 Salesforce 记录 ID
- 受影响用户的电子邮件地址
- 问题是一直重复出现、间歇性出现还是只出现过一次？
- 最近出现的日期：<提供上次出现问题的日期/时间/时区>
- 重现问题的步骤
- 预期行为：<描述执行步骤时预期出现的行为>
- 故障诊断说明：<提供迄今为止根据本文档完成的故障诊断的详细信息>
