“更新插入对象”活动

使用该活动在 ServiceMax 中更新现有对象或创建新对象。

关于此任务

该活动使用外部标识(通常为外键)来确定要在 ServiceMax 中更新现有对象还是创建新对象。

虽然 Salesforce.com API 将其在单次更新插入调用中可创建的对象数限制为 200 个,但是 Cast Iron® ServiceMax 连接器没有这样的限制。您可以使用更新插入对象活动来创建数目不受限制的对象。

要使用更新插入对象活动:

过程

  1. 活动选项卡中,打开 ServiceMax 目录,以找到更新插入对象活动。
  2. 将该活动添加到编排中。活动的核对表摘要会显示在编排下方。
  3. 选择 ServiceMax 端点。有关创建或编辑 ServiceMax 端点的指示信息,请参阅创建或编辑 ServiceMax 端点
  4. 通过选择 ServiceMax 对象类型和对象字段首选项来配置活动。
    注: 您只能选择 Integration Appliance 可以更新或创建并至少包含一个外部标识字段的对象类型。选择该对象类型时,Studio 会在“配置”窗格的外部标识字段中显示对其定义的外部标识。您不能编辑外部标识列表中列出的标识。 所选的外部标识成为必填字段,您无法从对象字段首选项表清除此字段。 如果只有一个外部标识可用,那么 Studio 会自动在对象字段首选项表中选中此字段。
  5. 指定活动的重试超时参数。
  6. 映射活动的输入。
  7. 映射活动的输出。

结果

映射“更新插入对象”活动的输入

  1. 核对表中,选择映射输入objects 元素会显示在“至活动”面板中。
  2. 右键单击缺省节点,然后选择显示可选参数以显示此活动的可选输入参数:
    • AssignmentRuleHeader
    • MruHeader
    • EmailHeader
    • CallOptions
    • connection
    • sessionInfo
  3. 单击选择输入... 并为映射选择输入变量。有关创建变量的指示信息,请参阅创建变量
  4. 如果适合,将输入参数映射到变量。有关映射的指示信息,请参阅创建映射

该活动支持以下可选输入参数:

  • AssignmentRuleHeader
  • EmailHeader
  • MruHeader

可选可空字段元素具有以下行为:

  • 如果 ServiceMax 服务器未提供字段值,那么 Integration Appliance 不会更新可选字段。
  • 如果在 nillable 字段中将 xsi:nil 属性设置为 true,那么 Integration Appliance 会在更新期间将该字段设置为空。
    注: 将字段设置为空字符串,不会将字段设置为空。

映射“更新插入对象”活动的输出

  1. 核对表中,选择映射输出upsertResults 元素会显示在“自活动”面板中。
  2. 单击选择输出... 并为映射选择输出变量。有关创建变量的指示信息,请参阅创建变量
  3. 适当地将输出参数映射到变量。有关映射的指示信息,请参阅创建映射