LookupRecord

LookupRecord 利用 Lynxus RecordPath 领域专用语言（DSL），让用户指定 Record 中应更新哪些字段 （取决于 Record Update Strategy）。Record 会使用所提供的 Lookup Service 返回的值进行更新。

Record Update Strategy - Use Property

在这种情况下，用户应在 Processor 配置中添加 Lookup Service 形成查询坐标所需的用户自定义属性， 属性名应与 Lookup Service 所期望的名称匹配。

使用 "Result RecordPath" 属性所配置路径求值得到的字段，就是会被 Lookup Service 返回值更新的字段。

假设有一个包含以下键值对的 Simple Key Value Lookup Service：

FR => France CA => Canada

假设输入是以下包含三条记录的 JSON：

[
  {
    "country": null,
    "code": "FR"
  },
  {
    "country": null,
    "code": "CA"
  },
  {
    "country": null,
    "code": "JP"
  }
]

Processor 的 "Record Update Strategy" 配置为 "Use Property"，"Result RecordPath" 配置为 "/country"，并添加了一个名为 "key"（该 Lookup Service 所要求的）的用户自定义属性，值为 "/code"。

触发时，Processor 会查找 "/code" 路径对应的值，并把该值用作 Lookup Service 的 "key"。 Lookup Service 返回的值将用于更新 "/country" 对应的值。对于上述示例，会产生：

[
  {
    "country": "France",
    "code": "FR"
  },
  {
    "country": "Canada",
    "code": "CA"
  },
  {
    "country": null,
    "code": "JP"
  }
]

Record Update Strategy - Replace Existing Values

使用此策略时，"Result Record Path" 属性会被忽略，且配置的 Lookup Service 必须是单键简单查询 服务。对于每个用户自定义属性，记录路径对应字段中的值会被用作 Lookup Service 的键，并被 Lookup Service 返回的值替换。可以配置多个动态属性，在一次执行中更新多个字段。此策略只支持 简单类型的替换（字符串、整数等）。

由于此策略支持原地替换，因此可以对数组内的字段使用 Record Path。

假设有一个包含以下键值对的 Simple Key Value Lookup Service：

FR => France CA => Canada fr => French en => English

假设输入是以下包含两条记录的 JSON：

[
  {
    "locales": [
      {
        "region": "FR",
        "language": "fr"
      },
      {
        "region": "US",
        "language": "en"
      }
    ]
  },
  {
    "locales": [
      {
        "region": "CA",
        "language": "fr"
      },
      {
        "region": "JP",
        "language": "ja"
      }
    ]
  }
]

Processor 的 "Record Update Strategy" 配置为 "Replace Existing Values"，并添加了两个 用户自定义属性："region" => "/locales[*]/region" 和 "language" => "/locales[*]/language"。

触发时，Processor 会遍历用户自定义属性。首先，它会查找 "/locales[*]/region" 对应的字段， 对于记录中的每个值，该值会被用作 Lookup Service 的键，并被 Lookup Service 返回的结果替换。 示例：第一个 region 是 "FR"，该键在 Lookup Service 中对应值 "France"，因此记录中的 "FR" 被替换为 "France"。对于上述示例，会产生：

[
  {
    "locales": [
      {
        "region": "France",
        "language": "French"
      },
      {
        "region": "US",
        "language": "English"
      }
    ]
  },
  {
    "locales": [
      {
        "region": "Canada",
        "language": "French"
      },
      {
        "region": "JP",
        "language": "ja"
      }
    ]
  }
]