短信通知

## 短信通知
### 短信环境配置：
注意：目前是配置在application.yml文件，后续会更改，若发现无法使用，请及时查看文档更改

华为：
```
zhc:
  #短信模块
  sms:
    #服务类型，默认为zhc
    service: huaWei
    #短信域名，必填，例：http(s)://服务器的域名[:端口]
    huawei_host:
    #短信地址，必填
    huawei_path:
    #APP_Key，必填
    huawei_key:
    #APP_Secret，必填
    huawei_secret:
    #国内短信签名通道号或国际/港澳台短信通道号，必填
    huawei_sender:
    #模板ID，必填
    huawei_tmpid:
    #签名名称，必填
    huawei_signature:
    #选填，短信状态报告接收地址,推荐使用域名,为空或者不填表示不接收状态报告，若不需要，该项不配置即可
    huawei_scback:

```

阿里云官方：
```
zhc:
  #短信模块
  sms:
    #服务类型，默认为zhc
    service: aliyun
    #访问ID，默认为空
    access_id:
    #访问密钥，默认为空
    access_secret:
    #端点(一般不会变，默认为：dysmsapi.aliyuncs.com)
    endpoint:
    #签名
    sign_name:
    #模板编码
    template_code：
    #模板参数
    template_param：

```

阿里云第三方：
```
zhc:
  #短信模块
  sms:
    #服务类型，默认为zhc
    service: zhc
    #验证码格式，默认为空 ，例：【海创云】验证码：%s，5分钟内有效！
    captcha_fmt:
    #短信域名，必填，例：http(s)://服务器的域名[:端口]
    app_host:
    #短信地址，必填
    app_url:
    #短信密钥，必填
    app_code:

```

### 流程短信通知操作步骤：

------------

1.新建短信groovy业务逻辑，如图：

![](/media/202405/2024-05-07_162700_887804.png)

2.编写groovy逻辑
```groovy

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.zhc.eap.model.entity.groovy.Entity;
import com.zhc.eap.service.IJavaService;
import com.zhc.eap.util.MD5Util;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import com.zhc.eap.funclib.*;
import com.system.util.SystemLogsHelper;
import com.zhc.eap.util.ExceptionUtil;
import org.slf4j.Logger
import org.slf4j.LoggerFactory
import com.zhc.eap.model.entity.IWebEntity;
import com.zhc.eap.context.SpringContextUtils;
import com.zhc.eap.service.sms.SmsService;
import com.zhc.eap.service.Impl.FlowDataHandle

class DuanXinFaSong {
    private Logger logger = LoggerFactory.getLogger("DuanXinFaSong.groovy")

//logger.info("日志信息"); 输日志
    //com.zhc.eap.util.ExceptionUtil.throwMessage(entityCo.get("controlDesc")); 抛异常
    //event-placeholder

/**
     * 获取数据集列表案例：
     * JSONArray array = (JSONArray) map.get("mainParams")
     * List<Map<String, Object>> list = FlowDataHandle.getInstance().query(array)
     * 
     * 获取单号：map.get("fordernumber")
     */

public void sendMsg(Map<String, Object> map){

//1.获取短信通知类
        SmsService smsService = SpringContextUtils.getBean(SmsService.class);

//2.获取接收者用户信息
        List<Map<String, String>> usrInfo = map.get("usrInfo");

//3.循环遍历发送短信
        for (Map<String, String> item : usrInfo) {
            //获取接收者手机号码
            String fmbphone = item.get("fmbphone");

//发送内容，注意：这里只是简单举例，具体发送内容请自行定义模板，模板内容在第三方供应商注册
            String context = "你有一条任务待处理，流程名称："+map.get("fpdisplayname")+",环节名称："+map.get("fdisplayname");

//使用系统工具类发送短信
            smsService.sendSms(fmbphone,context);

//若不想使用系统工具类发送，可以自定义调用第三方接口发送
        }
    }

}

```

------------

**注意：此处拷贝《方法》和《导入包》即可，类名之类的每个groovy不同，因此不要一股脑全部拷贝**

------------

3.流程配置，可以配置全局通知，也可以配置环节通知，具体以需求为准，如图：

![](/media/202405/2024-05-07_162822_978521.png)