用户指南 取消(C)

适用于 Salesforce 的 Acrobat Sign:故障诊断指南

您是否无法从 Salesforce 发送协议?数据映射是否无法更新 Salesforce 字段?

适用于 Salesforce 的 Adobe Acrobat Sign:故障诊断指南旨在帮助您解决从 Salesforce 发送协议、数据映射或自动状态更新时出现的问题。了解如何:

解决数据映射失败

在签署 Acrobat Sign 协议后或在协议工作流程的指定阶段,Acrobat Sign 数据映射会更新 Salesforce 对象。每个数据映射都是提前设置的,其中包含数据映射规则。每个数据映射规则都定义了数据源和必须要更新的目标 Salesforce 字段。有关详细信息,请参阅 Salesforce 数据映射

如果数据映射无法更新 Salesforce 字段,请执行以下故障诊断步骤以识别并修复问题:

使用数据映射和合并映射发送协议:示例场景

示例用户:

John Smith

示例用例:

John 想执行以下操作:

  • 使用协议模板从名为“Demo 1”的自定义对象发送协议,
  • 从与“Demo 1”对象关联的另一个名为“Demo 2”的自定义对象中提取信息并将信息推送到协议,以及
  • 签署协议后,将信息推送到“Demo 2”对象记录。 

 完成用例的步骤:

  1. 在 Acrobat Sign“协议”对象上,为“Demo 1”对象创建一个查找字段。
  2. 在“Demo 1”对象上,为“Demo 2”对象创建一个查找字段。
    您不能从相关列表提取信息,也不能将信息推送到相关列表。
  3. 按如下方式创建数据映射模板:
    1. 提供一个唯一的模板名称。
    2. 字段映射下,选择所选对象,然后从下拉菜单中选择 Demo 1
    3. 从加载的第二个下拉列表中,选择 Demo 2 ID
    4. 在加载的第三个下拉列表中,将其保留为“无”,然后选择选择
    5. 对于“要更新哪个 Salesforce 字段?”,请选择需要更新的字段名称。 
    6. 要完成数据映射设置,请按照“映射和模板指南”中使用数据映射将签名者数据和文件推送到 Salesforce 记录一节中的步骤进行操作。
  4. 按如下方式创建合并映射模板:
    1. 提供一个唯一的模板名称。
    2. 选择添加字段映射
    3. 源值下,选择所选对象,然后从下拉菜单中选择 Demo 1
    4. 从加载的第二个下拉列表中,选择 Demo 2 ID
    5. 从加载的下一个下拉列表中,选择包含您需要提取的值对应的字段名称,然后选择完成
    6. 要完成合并映射设置,请按照映射和模板指南使用合并映射生成包含 Salesforce 数据的文档一节进行操作。
  5. 按照创建模板工作流程下的步骤创建协议模板。
  6. 在上述步骤创建的协议模板中,确保合并映射和数据映射模板包含在“数据映射”部分中。
  7. 在协议模板的模板详细信息部分中,选择 Salesforce 对象作为 Demo 1
  8. 选择将数据映射到协议字段,然后在显示的对话框中,执行以下操作:
    1. 选择从对象中选择选项。
    2. 源类型下,选择 Demo 1 ID
    3. 目标协议字段下,从查找字段中选择 Demo 1 对象。
    4. 选择保存
  9. 在协议模板上,选择保存
    此时会创建一个链接到“Demo 1”对象的协议模板,并启用了合并映射和数据映射。
  10. 打开“Demo 1”对象记录,并选择  > 编辑页面。然后,从左侧面板上的“自定义管理”部分,拖放 AgreementPanel,并选择保存
  11. 选择激活并根据需要分配记录页面。出于测试目的,请选择“指定为组织默认值”,这将向所有用户公开显示“AgreementPanel”。
  12. 选择下一步,然后选择保存
  13. 导航至“Demo 1”对象记录并刷新页面。此时应显示您添加的“AgreementPanel”面板。
  14. 选择发送协议以供签名。此时会显示您创建的协议模板。
  15. 选择此协议模板,然后按照屏幕上的步骤发送协议。验证协议是否包含来自“Demo 2”的合并数据。 
  16. 签署协议。此时会显示根据协议中的值进行更新的“Demo 2”记录。 

解决从 Salesforce 发送协议时出现的故障

如果您无法从 Salesforce 发送协议,请执行以下故障诊断步骤:

  1. 确保您使用的是受支持的 Adobe Acrobat Sign 版本。请参阅支持的版本

  2. 确保您具有作为发件人所需的权限。
    请参阅如何向用户授予所需的访问权限。除了指南中提到的对象和字段之外,发件人还必须有权访问工作流程中使用的其他 Salesforce 对象。

  3. 检查 Salesforce 中的“协议”对象或其他 Acrobat Sign 对象是否具有自定义设置,例如触发器、工作流程或规则。如果有,请禁用所有自定义设置并发送测试协议以查看协议是否能够通过。
    如果在禁用自定义设置后成功发送协议,则请参阅我们的开发人员指南以获取指导。

    注意:

    我们不支持对自定义项进行故障诊断。

  4. 使用以下方法之一确定发送协议时收到的错误类型:

    • 在 Salesforce 中打开受影响的协议记录,并检查是否有带有错误消息的红色横幅。 此错误应指出根本原因。
    • 检查“协议通知”对象上的“错误消息”字段。
    • 要通过 Developer Console 进行检查并执行以下 SOQL 查询:

    从 echosign_dev1__Agreement_Notification__c 中

    选择 echosign_dev1__Error_Message__c,其中

    echosign_dev1__Agreement__c = ‘<enter agreement id>

  5. 请参阅下表,了解错误和解决步骤:

    错误

    解决办法

    在 x-api-user 标头中提供的用户 ID 或电子邮件地址无效
    或者

    您没有有效的 Adobe Acrobat Sign 用户帐户

    这些错误表明发件人没有有效的 Acrobat Sign 许可证。要排除故障:

    1. 选中协议记录上的发件人记录字段,以确定协议的发件人。
      如果在 Salesforce 中找不到发件人记录字段中的用户,Acrobat Sign 包将使用创建者字段作为协议的“发件人”。
    2. 导航至 Salesforce 中发件人的用户详细信息页面,并确保电子邮件地址字段具有有效的电子邮件地址和有效的 Sign 企业许可证。要检查电子邮件地址是否具有有效的 Sign 企业许可证,请执行以下操作:
      1. 使用管理员凭据登录到 Acrobat Sign
      2. 导航至帐户 > 用户,然后查看电子邮件地址。
      3. 用户应处于“活动”状态。未处于“活动”状态的用户无法发送协议。如果用户未处于“活动”状态,请参阅如何添加和管理用户,并参阅“电子邮件正在使用中,但用户未处于‘活动’状态”一节下的步骤。
      4. 如果使用发件人名义 (SOB),请通过选中协议对象上的发件人名义字段来验证电子邮件地址。通过登录 Acrobat Sign,确保此用户的电子邮件地址具有有效的 Sign 许可证。确保在 SOB 用户的用户详细信息页面上启用了允许作为其他用户发送字段。默认情况下,该字段可能不会显示在“用户”对象页面布局中。
    3. 按照上述步骤 2 所述验证用户权限。 请参阅 如何向用户授予必需的访问权限

    文件格式不受支持

    当您要发送以请求签名的文档的格式不受支持时,会出现此错误。

    请参阅 Acrobat Sign 系统要求中的支持的文档格式一节,以检查支持将哪些格式的文件上传到 Acrobat Sign。

    在签名按钮中使用了不正确的对象 ID

     当发件人名义按钮的模板 ID 或对象的主 ID 无效时,会出现此错误。

    我们建议您输入正确的对象 ID,然后重新尝试该过程。

解决自动状态更新时出现的故障

如果协议未更新为正确状态,请执行以下故障诊断步骤:

  1. 验证是否已实施适用于 Salesforce 的 Adobe Acrobat Sign:安装指南中提到的先决条件和安装后配置(必需)

  2. 在 Salesforce Lightning 页面上,转到 Adobe Acrobat Sign 管理员 > 启用自动状态更新,并确保您看到以下消息“已为该组织启用自动状态更新”。

    salesforce-faq-status-update-enabled

    如果未看到此消息,请执行以下步骤:

    1. 退出登录,然后再以系统管理员身份重新登录。
    2. 转到 Adobe Acrobat Sign 管理员 > 启用自动状态更新,然后选择启用
    3. 在出现的“允许访问 Acrobat Sign”对话框中,执行以下操作:
      1. 请记下对话框底部的电子邮件地址。
      2. 确保此电子邮件地址具有有效的 Sign 许可证,并且是 Salesforce 的系统管理员。
      3. 确保为用户分配了“Adobe Sign 集成用户”权限集。 
      4. 选择允许

    此时应显示以下消息:“已为该组织启用自动状态更新”。

  3. 在“协议通知”对象上,选中错误消息字段。要查看字段中的值,请在 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>'

  4. 如果协议是在 Salesforce 环境之外创建的推送协议,请确保按照适用于 Salesforce 的 Adobe Acrobat Sign:大型文档和推送协议服务指南进行操作。

  5. 转到设置 > 自定义设置 > Adobe Sign 协议更新设置 > 管理 > 新建(或“编辑”)。在打开的页面中,确保已启用更新协议状态复选框(位于“默认组织级别值”下)。

  6. 转到协议选项卡,选择所有更新失败的协议,然后从右上角选择更新协议

    salesforce-faq-update-agreement

  7. 检查这些协议的状态是否得到更新。如果协议状态现在得以更新,请通过发送一份新测试协议来检查问题是否仍然出现。如果问题仍然出现,请继续执行以下故障诊断步骤。

    如果问题不再出现,则可能表示该问题是一次性问题,我们建议您当问题再次出现时参考此故障诊断指南。 

  8. 检查 Salesforce 中的“协议”对象或其他 Acrobat Sign 对象是否具有自定义设置,例如触发器、工作流程或规则。

    如果有,请禁用所有自定义设置,并按照常规步骤发送测试协议,然后查看协议是否能够通过。协议状态应从“草稿”更改为“已发出进行签名”。

    如果在禁用自定义设置后,协议状态更改为“已发出进行签名”,则请参阅我们的开发人员指南以获取指导。

    如果状态未更新,请直接从“协议”选项卡发送禁用自定义设置的测试协议,然后查看协议是否能够通过。如果状态仍未更改,请检查上述步骤 1 和 2。

    注意:

    我们不支持对自定义项进行故障诊断。

    Acrobat Sign 对象
    添加文件附件 文件映射 将数据映射到协议字段中
    添加表单字段模板 表单字段导入 合并映射
    添加收件人 表单字段子映射 互斥
    协议 表单字段子映射条目 对象映射
    协议事件 表单字段映射 收件人
    协议模板 表单字段映射条目 已签名协议
    数据映射 组映射 触发器
    字段映射 库模板 用户同步结果
    协议类型    

解决启用增强域后可能出现的问题

现在,所有组织都默认启用了 Salesforce 的增强域,这不会影响适用于 Salesforce 的 Acrobat Sign 包。 但是,如果客户在为其站点配置了大型文件下载和推送协议,那么在启用其增强域后,就会遇到问题,从而导致站点URL发生更改并且协议终止。

为确保协议顺畅运行,客户需要更新大文件下载的自定义设置,以反映更新的站点 URL。

要更新推送协议回调 URL,客户必须联系支持人员并提供所需信息。有关详细信息,请参阅为您的 Acrobat Sign 帐户配置个人服务

解决在政府云环境中搜索潜在客户的问题

适用于 Salesforce 的 Adobe Acrobat Sign 允许您在将“潜在客户”选择作为收件人类型时搜索并将潜在客户添加为协议收件人。但是,如果政府云用户创建潜在客户、联系人或用户,但无法使用搜索字段找到他们,则 Saleforce 组织管理员可执行以下解决步骤:

  1. 转至设置 > 对象管理器,然后搜索潜在客户
  2. 在左侧面板中,选择字段和关系
  3. 对于所有必填字段(如姓名、电子邮件、移动电话等),检查用户可访问性。具体操作如下:
    1. 选择想要检查的任何字段。例如,选择移动电话
    2. 对于想要启用字段访问权限的所有用户,选择可见复选框。
    3. 选择保存
在政府云上将协议从适用于 Salesforce 的 Acrobat Sign 发送给潜在客户

在政府云上将协议从适用于 Salesforce 的 Acrobat Sign 发送给潜在客户

联系支持人员

如果执行完上述故障诊断步骤后仍未解决问题,请联系支持人员并向我们提供以下详细信息:

  • 问题描述
  • 用于设置集成的 Acrobat Sign 帐户管理员的电子邮件地址
  • 用于启用自动状态更新的 Acrobat Sign 帐户管理员的电子邮件地址:
  • Salesforce 中安装的 Acrobat Sign 程序包版本
  • Salesforce 组织 ID
  • 受影响协议的 Salesforce 记录 ID
  • 受影响用户的电子邮件地址
  • 问题是一直重复出现、间歇性出现还是只出现过一次?
  • 最近出现的日期:<提供上次出现问题的日期/时间/时区>
  • 重现问题的步骤
  • 预期行为:<描述执行步骤时预期出现的行为>
  • 故障诊断说明:<提供迄今为止根据本文档完成的故障诊断的详细信息>

更快、更轻松地获得帮助

新用户?