如何通过SugarCRM 6.5 REST API v4.1更新联系人主邮箱地址

我之前在使用SugarCRM 6.5的v4.1 REST API时，也踩过这个更新主邮箱的坑！你直接用set_entry修改email1字段没用，是因为SugarCRM的邮箱系统采用了关联式存储设计——联系人的邮箱实际存在email_addresses表中，通过email_addr_bean_rel关联表和联系人绑定，email1只是一个虚拟字段，用来展示标记为primary_address的邮箱地址。

正确的做法是通过操作邮箱关联关系来更新主邮箱，具体步骤如下：

1. 创建或获取目标邮箱地址的ID #

如果新邮箱还没在系统中存在，先调用set_entry创建一条邮箱记录：

{
  "method": "set_entry",
  "input_type": "JSON",
  "response_type": "JSON",
  "rest_data": {
    "session": "你的会话ID",
    "module_name": "EmailAddresses",
    "name_value_list": [
      {"name": "email_address", "value": "new-primary-email@example.com"},
      {"name": "invalid_email", "value": 0},
      {"name": "opt_out", "value": 0}
    ]
  }
}

请求成功后会返回新邮箱的id，把这个ID记下来。如果邮箱已经存在，可以用get_entry_list查询email_addresses表获取它的ID。

2. 取消原主邮箱的标记 #

首先需要找到联系人当前主邮箱的关联记录ID，调用get_relationships接口查询：

{
  "method": "get_relationships",
  "input_type": "JSON",
  "response_type": "JSON",
  "rest_data": {
    "session": "你的会话ID",
    "module_name": "Contacts",
    "module_id": "要更新的联系人ID",
    "link_field_name": "email_addresses",
    "related_module_query": "email_addr_bean_rel.primary_address = 1",
    "related_fields": ["id"],
    "related_module_link_name_to_fields_array": []
  }
}

拿到返回的关联记录ID后，调用set_entry把它的primary_address设为0，取消主邮箱标记：

{
  "method": "set_entry",
  "input_type": "JSON",
  "response_type": "JSON",
  "rest_data": {
    "session": "你的会话ID",
    "module_name": "EmailAddrBeanRel",
    "name_value_list": [
      {"name": "id", "value": "原关联记录ID"},
      {"name": "primary_address", "value": 0}
    ]
  }
}

3. 关联新邮箱并标记为主邮箱 #

最后调用set_relationship把新邮箱和联系人绑定，并设置为新的主邮箱：

{
  "method": "set_relationship",
  "input_type": "JSON",
  "response_type": "JSON",
  "rest_data": {
    "session": "你的会话ID",
    "module_name": "Contacts",
    "module_id": "要更新的联系人ID",
    "link_field_name": "email_addresses",
    "related_ids": ["新邮箱的ID"],
    "name_value_list": [
      {"name": "primary_address", "value": 1},
      {"name": "address_type", "value": "primary"}
    ],
    "delete": 0
  }
}

验证结果 #

完成上述步骤后，调用get_entry接口获取联系人记录，检查email1字段是否已经更新为新的邮箱地址。

核心要点就是：不要直接修改email1这个虚拟字段，而是通过操作邮箱关联表的primary_address标记来切换主邮箱。

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