Loading
数据校正的限制

数据校正的限制

在配置模板之前,请查看数据校正令牌命名、模板格式、支持的功能和编辑功能的限制。这些限制会影响令牌行为、记录更新和模板兼容性。

一般 DT 令牌规则和限制

  • 数据校正不支持:
    • DT 令牌名称中的特殊字符。
    • DT 令牌的数据转换。
    • RTB、HYP 和 IMG DT 令牌。
    • 子句中的 DT 令牌,包括标记子句。您可以在部分中创建 DT 令牌。
    • DT 令牌放置在页眉或页脚中。
    • DT 令牌放置在部分或条款标题和标题中。
  • 数据校正支持:
    • 当部分及其字段标记使用 DT_ 前缀时,重复行项目标记。
    • 使用 DT_ 前缀时,相关对象字段的嵌套 DT 令牌深度可达一个级别。
    • 文档中最多有 1,000 个 DT 令牌和 2,000 个 DT 行项目令牌。
  • DT 令牌行为和文档影响:
    • 需要您在 tokenMap 中定义顶级 DT 令牌。
    • 仅识别包含 DT_ 前缀的 DT 令牌。
    • 删除下载文档中包含 DT 令牌值的行可能会删除关联的内容边界。
    • 为变量 DT 令牌和行项目 DT 令牌使用唯一令牌名称。这确保了数据校正可以正确区分和协调每种令牌类型。
    • 在您从 Microsoft 365 加载项签入文档后,数据校正面板将被禁用。

行项目标记要求

  • 对于处理行项目的数据校正,在行项目部分的主节点和字段标记名称上使用 DT_ 前缀。
  • 不要将行项目放在部分中;在模板中使用专用的重复行项目区域。
  • 对于映射到文档中多个表的行项目,保持一致的 DT_ 前缀令牌命名。
  • 在所有相关行项目中共同计算行项目的同步状态。

嵌套和相关对象标记

  • DT 嵌套令牌仅支持相关对象的一个级别。不支持更深的嵌套引用。
  • 数据校正仅针对一对一映射协调嵌套对象字段;对于一对多关系,使用行项目。

模板兼容性

  • 文档模板仅适用于文档生成 2.0,并需要高级文档生成 API 版本类型。
  • 在文档生成期间合并数据校正令牌数据仅适用于 Salesforce Contracts。
  • 仅支持 DOCX 模板。PPTX 和 PDF 文件不兼容。
  • 文档模板的目录中不支持 DT 令牌。
  • 避免从其他组织或不同的合同对象导入包含 DT 字段的文档。DT 令牌引用从中生成的合同对象,或在 Omnistudio 数据映射器或上下文服务的 ObjectId 字段中指定的对象。

数据源兼容性

  • 当数据通过数据映射器来源并使用格式转换时,不支持自定义日期格式。仅支持默认日期格式。
  • 数据校正使用数据库值来获取值,而无需中间格式化。文档格式化不会影响调和值。
  • 对于数字字段,例如数字、百分比和货币,小数位数超过字段定义的值会显示验证警告,但可以保存在文档中,而不会舍入。

编辑和格式化

  • 生成的文档中的 DT 令牌值被锁定,只能通过 Microsoft 365 Word 加载项中的编辑值选项进行编辑。
  • 日期类型 DT 令牌支持显示格式更改(例如,YYYY/MM/DD 或 MM/DD/YYYY)。默认格式是 YYYY-MM-DD。
  • 在通过编辑值选项更新 DT 令牌值之前,审阅者必须接受或拒绝现有文档更改。

访问权限要求

  • 自动编号字段不支持更新记录功能。
  • DT 令牌引用的任何字段都需要字段级安全性读取和编辑访问权限,以便进行协调和记录更新。
  • 当浏览器隐私设置“浏览器隐私”在“隐私和安全”下自定义配置时,合作伙伴社区用户只能在 Firefox 和 Safari 中打开 Microsoft 365 加载项中的文档。如果没有此配置,则不支持加载项访问权限。用户还必须拥有字段级安全性 (FLS) 访问权限,才能使用 Microsoft 365 的数据校正。如果没有所需的访问权限,则不支持签到和更新操作。

指南(非限制)

  • 您无法从“编辑值”窗口中编辑锁定的字段。使用窗口中的复制选项将记录值同步到文档值中。
  • 在启动更新字段之前,执行提取值,以确保所有令牌状态反映最新的 Salesforce 数据。
  • 如果 DT 令牌引用了不可编辑的字段,请在启动更新记录之前为该字段执行重新提取值。
  • 在协调之前,您可以将单个 DT 令牌从数据校正面板中删除。
  • 当获取值或更新字段在记录 ID 的字段上遇到验证错误时,数据校正不会更新该记录 ID 的任何字段。
  • 当满足以下条件时,DT 令牌格式保留在生成的文档中:
    • 格式化必须应用于整个令牌,从 {{ 到 }}。
    • 整个令牌的格式必须统一。您不能用一种方式格式化标记的一部分,用不同方式格式化另一部分,例如,一半粗体一半斜体。
    • 仅支持以下格式化选项:粗体、斜体、下划线、字体(字体)和字体大小。可以根据需要添加其他格式化选项。
    • 您可以通过 Microsoft 365 Word 加载项中的编辑值选项编辑 DT 令牌值,即使令牌应用了格式化。
 
正在加载
Salesforce Help | Article