配置 Omnistudio 数据映射器加载

通过指定对象类型和筛选器，配置数据映射器加载。要增强数据映射器加载的性能，您可以定义公式，添加要写入数据的字段，并配置其他属性。

1. 从应用程序启动程序中，查找并选择数据映射器。
2. 选择要配置的数据映射器加载。
3. 单击对象，并添加数据映射器加载对象：
   • 要添加对象，请单击 +。如果您在受管软件包上使用设计器，请单击添加对象。
   • 从加载对象列表中，搜索并选择对象。
4. 单击公式，添加公式，并为数据映射器加载定义公式。请参阅在 Omnistudio 数据映射器中使用公式。
   1. 要添加公式块，请单击 +。如果您在受管软件包上使用设计器，请单击添加公式。
   2. 在公式字段中，输入所需的逻辑。
   3. 在公式结果路径字段中，指定要存储公式结果的 JSON 节点。
   4. 如果您出于测试目的使用此数据映射器，请禁用公式。单击，然后单击禁用。如果您在受管软件包上使用设计器，请选中禁用复选框。
5. 单击映射，然后单击创建映射。如果您在受管软件包上使用设计器，请单击字段，然后单击 +。

   您也可以使用快速匹配选项快速匹配输入字段与输出对象字段。您可以使用配对选项手动匹配字段，也可以使用自动匹配选项自动匹配字段。

   1. 配置这些映射设置：
      • 输入 JSON 路径：JSON 节点的密钥，其中包含您想要写入 Salesforce 的数据。
      • 域对象：您要映射的 Salesforce 对象。
      • 域对象字段：您要更新的 Salesforce 对象中的字段。在包含 JSON 数据的字段中，您不能单独映射 JSON 节点。字符串化所有具有值的 JSON 节点，以确保不会丢失 JSON 数据。例如：

        "JsonField": "{\"JsonNode1\":\"Text\", \"JsonNode2\":100, \"JsonNode3\":true}"

        如果您正在更新多个 Salesforce 对象，设计器会为每个目标对象的映射显示单独的选项卡。请参阅多个相关对象加载（链接映射）。

      • 添加键值对：这些映射设置将值复制到指定为密钥的顶级 JSON 节点。
   2. 要控制映射的执行方式，您可以配置这些可选设置。如果您在受管软件包上使用设计器，请单击全部，并配置这些设置：
      • 输出数据类型：必须与目标字段的数据类型兼容。输出数据类型设置必须与 Salesforce 中的目标字段兼容。如果您配置不兼容的类型，加载操作可能会失败。有关有效输出类型的列表，请参见Omnistudio 数据映射器输出数据类型。
      • 默认值：如果数据映射器输出 JSON 中的字段为空，则加载的值。要为 null 的字符串字段指定空字符串，请输入一对双引号 ("")。如果启用需要更新插入，则省略。
      • 已禁用：阻止加载字段。
      • 更新插入密钥：指定该字段是正在加载的 Salesforce 对象的密钥。数据映射器使用该值来确定它是更新现有记录还是插入新记录。如果为多个字段映射启用了更新插入属性，结果将是多字段更新插入密钥。数据映射器使用此密钥检查对象的唯一值，以确定是否创建或更新对象。请勿使用 ID 作为更新插入密钥。如果输入包含 ID，数据映射器会更新记录。如果输入不包含 ID，数据映射器会创建记录。
      • 需要更新插入：如果此字段为空，将阻止更新对象记录。
      • 查找：使用字段值查询指定的 Salesforce 数据，并将结果写入输出字段。
   3. 保存更改。如果要添加更多映射，请单击保存并新建。如果您在受管软件包上使用设计器，请单击 +。
6. 要配置其他属性，单击选项并配置这些属性：
   • 忽略错误：即使出现错误，也要执行数据映射器，只跳过出现错误的步骤。当您知道记录将在有限数据的情况下失败，并且未来的步骤不依赖于以前的步骤时，此选项非常有用。
   • 回滚错误：如果出现错误，请勿创建或更新 sObject。有关更多信息,请查看Apex交易和交易控制。
   • 使用分配规则：将分配规则用于包含用户分配字段的 sObject，例如个案。有关更多信息，请查看设置分配规则。未经身份验证的来宾用户无法触发分配规则。如果在个案分配规则中配置电子邮件，选中此选项会在分配个案时自动向用户发送电子邮件。
   • 覆盖所有空输入的目标：如果输入没有值，请将相应的输出值设置为 NULL。
   • 成功删除：当输入类型 ‌ 是 sObject 时，使用此选项在成功批量加载数据后自动删除批量记录。
   • 是默认界面：当输入类型 ‌ 是 sObject 时，将此数据映射器指定为指定接口对象的默认捆绑包。

• 为数据映射器加载创建界面对象
  提供外部数据，例如 CSV 文件，作为数据映射器加载的输入。外部数据可以导入到界面对象中，这是使用数据导入工具的自定义 Salesforce 对象。然后，使用数据映射器加载将字段从自定义对象映射到目标 Salesforce 记录。当您将数据加载到 Salesforce 自定义对象时，它会触发调用数据映射器加载的 Apex 触发器。数据映射器从界面对象获取数据，并将结果数据写入其他 Salesforce 记录对象。
• 多个相关对象加载（链接映射）
  将数据加载到对象序列时，您可以将数据直接从一个对象传播到另一个相关对象。例如，您可以使用 Omnistudio 数据映射器加载来支持为该客户创建客户和联系人的 Omniscript。