如何用JOLT正确转换含accepts_marketing与email_marketing_consent的JSON？

需求场景 #

处理JSON格式转换时，需兼容以下两种输入情况：

• 输入同时存在accepts_marketing和email_marketing_consent字段
• 输入仅包含上述两个字段中的一个

最终要求输出的optin_newsletter始终为布尔值（true/false），其中email_marketing_consent.state的subscribed对应true，not_subscribed对应false。

输入输出示例 #

输入JSON #

{
  "email": "john.calvert@nm.com",
  "first_name": "John",
  "accepts_marketing": false,
  "email_marketing_consent": {
    "state": "not_subscribed",
    "opt_in_level": "single_opt_in",
    "consent_updated_at": null
  }
}

预期输出 #

{
  "optin_newsletter": false,
  "email": "john.calvert@nm.com",
  "first_name": "John"
}

当前JOLT规则及问题 #

当前转换规则 #

[
  {
    "operation": "shift",
    "spec": {
      "accepts_marketing": "optin_newsletter",
      "email_marketing_consent": {
        "state": {
          "subscribed": {
            "#true": "optin_newsletter"
          },
          "*": {
            "#false": "optin_newsletter"
          }
        }
      },
      "email": "email",
      "first_name": "first_name"
    }
  },
  {
    "operation": "modify-overwrite-beta",
    "spec": {
      "subscribed": "=toBoolean"
    }
  }
]

存在问题 #

1. 双字段共存时，optin_newsletter输出为数组[false, "false"]，而非单个布尔值
2. 单字段场景下，存在类型不一致或转换错误的可能

解决方案：修改后的JOLT规则 #

核心思路是设置字段优先级（示例中优先使用email_marketing_consent的值，若不存在则 fallback 到accepts_marketing），同时统一转换为布尔值，处理数组情况：

[
  {
    "operation": "shift",
    "spec": {
      // 低优先级：先映射accepts_marketing的原始值
      "accepts_marketing": "optin_newsletter",
      // 高优先级：再映射email_marketing_consent的转换值
      "email_marketing_consent": {
        "state": {
          "subscribed": { "#true": "optin_newsletter" },
          "*": { "#false": "optin_newsletter" }
        }
      },
      "email": "email",
      "first_name": "first_name"
    }
  },
  {
    "operation": "modify-overwrite-beta",
    "spec": {
      "optin_newsletter": [
        // 若为数组，取最后一个元素（高优先级字段的值）
        "=lastElement",
        // 统一转换为布尔值，确保类型一致
        "=toBoolean"
      ]
    }
  }
]

规则说明 #

1. Shift操作优先级控制：
   • 先处理低优先级的accepts_marketing，再处理高优先级的email_marketing_consent
   • 双字段共存时，Shift会生成包含两个值的数组，高优先级值排在数组末尾
2. Modify操作统一处理：
   • 用lastElement提取数组中的高优先级值，单字段场景下直接返回原值
   • 用toBoolean统一转换为布尔类型，解决字符串与布尔值混合的问题

验证场景 #

1. 双字段共存：输入如示例，转换后optin_newsletter为布尔值false
2. 仅存在accepts_marketing：输入{"accepts_marketing": true, "email": "test@test.com"}，输出{"optin_newsletter": true, "email": "test@test.com"}
3. 仅存在email_marketing_consent：输入{"email_marketing_consent": {"state": "subscribed"}, "first_name": "Jane"}，输出{"optin_newsletter": true, "first_name": "Jane"}

优先级调整说明 #

若需将accepts_marketing设为高优先级，只需交换Shift中两个字段的处理顺序，Modify阶段逻辑保持不变即可。

内容的提问来源于stack exchange，提问作者user28241181