如何将Salesforce中所有联系人电话号码统一修改为纯数字格式

是否需要创建Batch Apex #

根据存量联系人数据规模判断，不需要默认开发Batch Apex：

• 存量联系人总数小于10000条：不需要单独开发Batch Apex类，直接通过开发者控制台的匿名Apex脚本即可一次性完成存量数据清洗
• 存量联系人总数大于等于10000条：必须使用Batch Apex实现。Salesforce单同步事务存在DML操作10000行的 governor limit限制，Batch Apex会自动将全量数据拆分为多批独立事务执行，不会触发上限报错。

核心格式化逻辑 #

所有场景下的号码格式化逻辑统一，通过正则移除字符串中所有非数字字符即可，对应处理逻辑：

// 输入带分隔符的号码，返回纯数字格式
private String formatPhone(String rawPhone) {
    if (String.isBlank(rawPhone)) return rawPhone;
    return rawPhone.replaceAll('[^0-9]', '');
}

该逻辑可以覆盖括号、横杠、空格、加号等所有非数字分隔符，直接匹配(123) 456-7891转1234567891的需求。

存量数据处理实现 #

小数据量场景（<10000条） #

1. 先通过数据导出功能备份所有联系人的Id、Phone字段，留作回滚依据
2. 打开开发者控制台，进入Debug > Open Execute Anonymous Window，粘贴以下脚本执行即可：

List<Contact> needUpdate = new List<Contact>();
for (Contact con : [SELECT Id, Phone FROM Contact WHERE Phone != null LIMIT 10000]) {
    String formatted = con.Phone.replaceAll('[^0-9]', '');
    if (con.Phone != formatted) {
        con.Phone = formatted;
        needUpdate.add(con);
    }
}
if (!needUpdate.isEmpty()) {
    update needUpdate;
}

执行后可以在设置的批量数据加载作业里查看执行结果，确认失败条数。

大数据量场景（≥10000条） #

1. 新建Batch Apex类，代码如下：

public class BatchContactPhoneFormatter implements Database.Batchable<sObject> {
    public Database.QueryLocator start(Database.BatchableContext bc) {
        // 查询所有存在电话号码的联系人
        return Database.getQueryLocator([SELECT Id, Phone FROM Contact WHERE Phone != null]);
    }

    public void execute(Database.BatchableContext bc, List<Contact> batchScope) {
        List<Contact> needUpdate = new List<Contact>();
        for (Contact con : batchScope) {
            String formatted = con.Phone.replaceAll('[^0-9]', '');
            if (con.Phone != formatted) {
                con.Phone = formatted;
                needUpdate.add(con);
            }
        }
        if (!needUpdate.isEmpty()) Database.update(needUpdate, false);
    }

    public void finish(Database.BatchableContext bc) {
        // 可选：执行完成后给管理员发邮件通知
        AsyncApexJob job = [SELECT Id, Status, NumberOfErrors, JobItemsProcessed FROM AsyncApexJob WHERE Id = :bc.getJobId()];
        Messaging.SingleEmailMessage notify = new Messaging.SingleEmailMessage();
        notify.setToAddresses(new List<String>{'你的管理员邮箱地址'});
        notify.setSubject('联系人电话号码格式化批处理执行完成');
        notify.setPlainTextBody('处理总条数：' + job.JobItemsProcessed + '，失败条数：' + job.NumberOfErrors);
        Messaging.sendEmail(new List<Messaging.SingleEmailMessage>{notify});
    }
}

2. 在匿名执行窗口运行以下代码启动批处理：

// 第二个参数是每批处理的记录数，可根据org内触发器/流程的负载在1-2000之间调整
Database.executeBatch(new BatchContactPhoneFormatter(), 200);

新增/编辑数据自动格式化配置 #

存量数据清洗完成后，需要配置前置规则保证后续写入的号码自动格式化，二选一即可：

• Apex触发器方案（性能稳定，适合有代码开发能力的场景）
  在Contact对象上创建before insert、before update事件的触发器，逻辑如下：

trigger ContactBeforeHandler on Contact (before insert, before update) {
    for (Contact con : Trigger.new) {
        if (String.isNotBlank(con.Phone)) {
            con.Phone = con.Phone.replaceAll('[^0-9]', '');
        }
    }
}

如果org内已经存在Contact对象的同事件触发器，直接把格式化逻辑合并到现有触发器即可，不要创建多个同对象同事件的触发器。

• 记录触发流方案（无代码，适合管理员配置场景）
  新建Contact对象的记录触发流，触发时机选「创建或编辑记录时，满足条件就运行」，条件设置为Phone 不等于 null，添加公式变量通过正则替换移除Phone字段的非数字字符，再添加更新记录动作将Phone字段赋值为格式化后的值，激活流即可生效。

注意事项 #

• 如果业务中电话号码需要保留分机号标识（如x、ext等字符），需要调整正则规则，当前逻辑会将非数字字符全部移除
• 批处理执行尽量避开业务高峰期，减少对正常业务操作的资源占用
• 所有数据修改操作前必须做全量备份，避免规则配置错误导致数据丢失

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