Omnistudio 中的常见错误和解决方法

1. 以系统管理员身份登录。
2. 从“设置”中，查找并选择 Omnistudio。
3. 为您的组织启用 Omnistudio 权限。

如果您没有看到该选项，请确认贵组织拥有 Omnistudio 许可证。如果需要许可证，请联系您的 Salesforce 客户主管。

提示 在启用 Omnistudio 权限后，更改可能需要几分钟才能在整个组织中传播。如果您继续看到此错误，请尝试注销并重新登录。

• 尝试删除活动 Omniscript
• 尝试更新活动 Omniscript 的结构字段
• 尝试更改活动 Omniscript 的类型、子类型或语言

1. 从应用程序启动程序中，查找并选择全方位脚本。
2. 找到您想要修改或删除的 Omniscript。
3. 请注意当前版本，并警告用户即将到来的停用。
4. 取消选中启用复选框以禁用 Omniscript 并保存更改。
5. 现在，您可以进行所需的更改或删除 Omniscript。
6. 如果您进行了更改，您可以通过再次选中启用复选框来重新启用。

警告 禁用 Omniscript 会立即影响当前使用它的所有用户和进程。如果您需要保持服务连续性，请考虑创建一个新版本，而不是修改活动版本。

• 另一个具有相同类型、子类型和语言的 Omniscript 已经处于活动状态
• 在不停用上一个版本的情况下创建新版本
• 已创建多个版本并尝试激活多个版本

请确保您拥有编辑 Omniscript 记录并完成这些任务的权限。

1. 从应用程序启动程序中，查找并选择全方位脚本。
2. 使用筛选器或搜索类型和子类型匹配的 Omniscript。
3. 识别类型/子类型/语言相同的当前活动 Omniscript。
4. 查看这两个版本，以确定哪个版本应保持活动状态。
5. 打开您想要停用的 Omniscript。
6. 取消选中启用复选框，并保存更改。
7. 返回到新版本并激活它。

警告 在激活新版本之前，请在预览或 Sandbox 环境中彻底测试它。在您准备部署时，停用旧版本并立即激活新版本，以最大限度地减少停机时间。

• 类型字段为空或 null
• 子类型字段为空或 null
• 未选择语言字段
• 尝试保存新 Omniscript，而不填写所有必填字段

请确保您拥有编辑 Omniscript 记录并完成这些任务的权限。

1. 从应用程序启动程序中，查找并选择全方位脚本。
2. 在 Omniscript 属性面板中，找到类型字段。
3. 输入描述性类型名称，例如 CustomerOnboarding 或 ClaimSubmission。
4. 查找子类型字段，并输入特定子类型名称，例如住宅或商业。
5. 从下拉列表中选择语言。
6. 确保填写所有三个字段，并保存更改。
7. 返回到新版本并激活它。

提示 选择有意义的类型和子类型名称，以明确指示 Omniscript 的用途。这些值成为您在应用程序中引用 Omniscript 的方式的一部分，并且在创建后不容易更改。

• 类型或子类型字段包含空格
• 类型或子类型字段包含下划线
• 类型或子类型字段包含不支持的特殊字符：!@#$%^&*，以此类推
• 类型或子类型字段包含连字符或其他标点符号

1. 查看您的类型和子类型值。
2. 移除任何空格 - 使用 UpperCamelCase（或 PascalCase）。例如，CustomerOnboarding。
3. 删除任何下划线，并使用 UpperCamelCase（或 PascalCase）替换它们。
4. 删除任何特殊字符。
5. 请确保仅使用字母 (A-Z, a-z) 和数字 (0-9)。
6. 保存更改。

提示 将 PascalCase（也称为 UpperCamelCase）用于类型和子类型值。这提高了可读性，而不需要空格或下划线。

• 类型值太长。
• SubType 值太长。
• 组合类型 + 子类型 + 语言超出字符限制。

1. 查看错误消息，以查看允许的最大长度。
2. 缩短类型或子类型值。
3. 保存更改。

提示 必要时使用缩写。删除多余单词。使用较短的命名约定。

类型或子类型字段使用保留关键字。常见的受限关键字包括：in、out、exc、cb、kt、vt、v、x785f、x5f

按照错误消息中的建议，使用不同的值替换受限关键字。有关更多信息，请查看 Omnistudio 命名约定页面上的保留单词。

• 尝试将新元素添加到活动 Omniscript。
• 尝试修改活动 Omniscript 上的现有元素。
• 尝试从活动 Omniscript 中删除元素。
• Omniscript 已启用并正在使用。

请确保您拥有编辑 Omniscript 记录并完成这些任务的权限。

1. 验证 Omniscript 当前是否处于活动状态。
2. 考虑创建一个新版本，而不是修改活动版本。
3. 创建新版本：单击 Omniscript 上的复制。
4. 修改现有：通过取消选中启用复选框并保存更改来禁用。
5. 现在，您可以添加、更新或删除元素。
6. 测试您的更改。
7. 在准备使用时激活 Omniscript。

警告 建议您为重大更改创建新版本，而不是停用和修改活动版本。这允许您在部署前进行彻底测试，并在出现问题时提供简单的回滚选项。

• 同一 Omniscript 中的另一个元素具有相同的名称。
• 不同步骤中元素之间的名称冲突。
• 元素已复制，名称未更改。

1. 查看 Omniscript 中的所有元素。
2. 识别名称冲突的元素。
3. 决定哪个元素应保留名称。
4. 使用唯一名称重命名其他元素。
5. 考虑使用前缀来表示步骤或部分，例如 step1_firstName、step2_firstName。
6. 更新引用重命名元素的任何公式或数据映射，并保存更改。

• Omniscript 来自受管软件包，您无权修改或删除它。
• 尝试从软件包命名空间外部更新封装的 Omniscript。

1. 验证 Omniscript 是否来自受管软件包。
2. 如果您需要自定义 Omniscript，请改为复制它。
3. 使用您自己的 Type/SubType/Language 组合重命名复制的版本。
4. 对复制的版本进行所需的修改，保存并激活 Omniscript。
5. 更新引用重命名元素的任何公式或数据映射，并保存更改。

提示 如果您需要更改封装组件，请联系软件包提供商或您的 Salesforce 管理员。它们可以提供配置选项或扩展点，不需要直接修改封装的 Omniscript。

• Omniscript 可重复使用。
• Omniscript 包含 Omniscript 元素（嵌入 Omniscript）。
• 尝试在添加嵌入的 Omniscript 后使 Omniscript 可重用

1. 决定此 Omniscript 是可重用还是包含嵌入的 Omniscript。
2. 选项 1：保持可重用 - 删除所有嵌入的 Omniscript 元素
3. 选项 2：允许嵌入：取消选中可重用复选框。
4. 如果您要删除嵌入的 Omniscript，请考虑使用集成程序。您可以将逻辑重构为可以从 Omniscript 调用的集成程序。

提示 将集成程序用于共享业务逻辑，而不是嵌套可重复使用的 Omniscript。这创建了更干净的架构，并避免了 Omniscript 依赖性的复杂性。

• 另一个具有相同名称的 Flexcard 已经处于活动状态。
• 尝试激活新版本而不停用旧版本。

1. 搜索具有相同名称字段的 Flexcard。
2. 查看它们，以确定哪些应保持活动状态。
3. 打开要取消激活的 Flexcard。
4. 取消选中启用复选框以禁用 FlexCard 并保存更改。

警告 禁用 Flexcard 会立即影响当前使用它的所有用户和进程。如果您需要保持服务连续性，请考虑创建一个新版本，而不是修改活动版本。

1. 验证 Flexcard 是否来自受管软件包。
2. 如果您需要将其停用，而不是删除。
3. 为此，打开 Flexcard 并取消选中启用复选框。
4. 如果您需要 Flexcard 的自定义版本，请改为复制它。

提示 如果您需要更改封装组件，请联系软件包提供商或您的 Salesforce 管理员。它们可以提供配置选项或扩展点，不需要直接修改封装的 Flexcard。

• 子 Flexcard 名称的名称拼写错误。
• 子 Flexcard 存在，但未启用。
• 子 Flexcard 已删除。
• 子 Flexcard 位于不同的命名空间中。

1. 从应用程序启动程序中，查找并选择从错误消息中记下子 Flexcard 名称。
2. 按名称搜索子 Flexcard。
3. 如果找到但不活动，请将其激活。
4. 如果未找到，请验证名称是否正确。
5. 如果名称不正确，请更新父 Flexcard 配置。
6. 在父 Flexcard 中，查找子 Flexcard 引用。
7. 更正名称，以匹配现有的有效 Flexcard，并保存父 Flexcard。

备注 子 Flexcard 必须激活，父 Flexcard 才能引用它们。首先创建并测试子 Flexcard，然后配置父 Flexcard 来使用它们。

• Omniscript 的类型/子类型/语言不正确。
• Omniscript 存在，但未启用。
• Omniscript 已删除。
• Omniscript 的类型/子类型/语言已更改。

1. 请注意错误消息中的类型、子类型和语言。
2. 搜索具有匹配类型和子类型的 Omniscript。
3. 验证语言是否匹配。
4. 如果找到但无效，激活 Omniscript。
5. 如果未找到，请验证正确的 Type/SubType/Language 值。
6. 返回 Flexcard，并使用正确值更新 Omniscript 引用。
7. 保存更改。

提示 在激活 Flexcard 之前，请确保引用的 Omniscript 处于活动状态。如果您同时部署两者，请先激活 Omniscript。

• 数据映射器的名称拼写错误。
• 数据映射器存在，但未处于活动状态。
• 数据映射器已删除。
• 数据映射器的名称已更改。

1. 请注意错误消息中的数据映射器名称。
2. 按名称搜索数据映射器。
3. 如果找到但不活动，请将其激活。
4. 如果未找到，请验证名称是否正确。
5. 返回到 Flexcard，使用正确名称更新数据映射器引用，并保存更改。

提示 在激活引用它们的 Flexcard 之前，激活数据映射器。独立测试数据映射器，以确保它返回预期的数据结构。

• 集成程序的名称不正确。
• 数据映射器存在，但未处于活动状态。
• 数据映射器已删除。
• 您正在使用错误的命名格式（应使用 Type_SubType 格式）。

1. 请注意错误消息中的集成程序名称。
2. 搜索集成程序。
3. 请确认它是否存在，并记下其类型和子类型。
4. 如果找到但不活动，请将其激活。
5. 返回到 Flexcard。
6. 使用以下格式更新集成程序引用：Type_SubType，并保存更改。

警告 使用 OmniProcessKey 引用集成程序，它遵循 Type_SubType 格式。请确保您在配置 Flexcard 时使用正确的格式。

• 尝试重命名现有 Flexcard。
• 尝试更改现有 Flexcard 的作者。
• UniqueName 由其他组件使用，无法更改。

1. 如果您需要不同的名称或作者，请复制 Flexcard。
2. 找到您的 Flexcard 并复制它。
3. 输入新名称或作者。
4. 对复制的版本进行任何其他必要的更改，并激活新的 Flexcard。
5. 更新引用旧 Flexcard 的任何组件，以使用新组件。
6. 更新所有引用后，停用旧 Flexcard。

• 集成程序名称以 FileBased 开头。
• 集成程序类型从基于文件开始。
• 集成程序子类型以 FileBased 开头。

1. 打开集成程序。
2. 检查名称、类型和子类型字段。
3. 如果 FileBased 开头，请选择不同的前缀。
4. 请考虑使用前缀，例如文件、文档、数据或您的组织名称。
5. 更新容易出错的字段，并保存更改。

• JSON 输入模式的嵌套对象深度超过 10 个级别。
• JSON 输出模式的嵌套对象深度超过 10 个级别。

1. 查看 JSON 模式结构。
2. 识别深度嵌套的部分。
3. 通过减少嵌套级别来平展结构。
4. 考虑将深度嵌套数据移到单独的集成程序。
5. 使用对象更扁平的数组，而不是深度嵌套的层次结构。
6. 重组以保持嵌套在 10 个级别以下。
7. 保存更新的模式。

集成程序 JSON 模式在整个结构中最多有 500 个密钥的限制。这包括所有嵌套级别的所有密钥。尤其是：

• JSON 输入模式包含总共 500 多个密钥。
• JSON 输出模式包含总共 500 多个密钥。
• 该模式包括多个嵌套对象的大量字段。

1. 查看 JSON 模式。
2. 计算所有级别的密钥总数。
3. 识别密钥过多的部分。
4. 考虑将集成程序拆分为多个较小的程序。
5. 删除未使用或冗余的密钥。
6. 使用数组表示重复结构，而不是编号密钥。
7. 将相关字段合并为子对象。
8. 保存优化的模式。

提示 如果您合法需要超过 500 个密钥，请考虑将流程分为多个可以链接在一起的集成程序。

• 选定 sObject 不支持数据映射器操作。
• 选定的 sObject 是不支持查询的系统对象。
• 选定的 sObject 没有必要的 API 支持来使用数据映射器。

1. 查看您选择作为输入类型的 sObject，并查看 Salesforce 帮助，了解支持的对象。
2. 请考虑使用支持的不同相关对象。
3. 如果您需要来自不支持对象的数据，请改用带有自定义 Apex 的集成程序。
4. 使用支持的对象更新数据映射器配置，并保存更改。

备注 支持大多数标准和自定义对象。如果您遇到不支持的对象，请考虑是否可以重组数据流，以使用支持的替代方案。

• OmniAnalytics for Omnistudio 未启用。
• 您的组织尚未为 OmniAnalytics 配置。

1. 以系统管理员身份登录，从“设置”中，搜索全方位设置或全方位交互配置。
2. 找到 OmniAnalytics for Core 设置，并将其启用。
3. 保存您的更改，并等待几分钟更改生效。
4. 测试 Analytics 跟踪是否有效。

备注 请确认 Decision Explainer 配置正确。

• ID 不是有效的 Salesforce ID 格式，有 15 或 18 个字符。
• ID 不属于 OmniTrackingComponentDef 对象。
• 跟踪组件定义已删除。
• ID 为空或格式错误。

1. 验证您正在使用的组件定义 ID。
2. 导航到设置 > Omnistudio > Analytics 跟踪，并找到正确的跟踪组件定义。
3. 从记录中复制正确的 ID。
4. 使用正确的 ID 更新您的代码或配置。
5. 如果删除定义，请创建新的跟踪组件定义。请参阅创建跟踪小组和添加组件进行跟踪。
6. 再次测试跟踪。

备注 请确认 Decision Explainer 配置正确。